Module:GeneralPortOperations

From MicrasWiki
Revision as of 01:43, 24 April 2025 by NewZimiaGov (talk | contribs)
Jump to navigationJump to search

Documentation for this module may be created at Module:GeneralPortOperations/doc

-- Module:GeneralPortDailyLog
local p = {}

-- Returns the current PSSC year and day of year
function p.getCurrentDate()
    local startDate = os.time({year = 1999, month = 8, day = 6})
    local secondsInDay = 86400
    local daysPerYear = 183
    local currentDate = os.time()
    local totalDaysElapsed = math.floor((currentDate - startDate) / secondsInDay)
    local yearFraction = totalDaysElapsed / daysPerYear
    local psscYear = math.floor(yearFraction)
    local dayOfYear = math.floor((yearFraction - psscYear) * daysPerYear) + 1
    return psscYear, dayOfYear
end

-- Utility: pick a random element
local function randomChoice(t)
    return t[math.random(#t)]
end

-- Home ports: flag (20px) + city name
local cities = {
    Vaeringheim      = "[[File:VaeringheimFlag.png|20px]] Vaeringheim",
    Somniumpolis     = "[[File:SomniumpolisFlag.png|20px]] Somniumpolis",
    Delphica         = "[[File:DelphicaFlag.png|20px]] Delphica",
    Ephyra           = "[[File:EphyraFlag.png|20px]] Ephyra",
    Norsolyra        = "[[File:NorsolyraFlag.png|20px]] Norsolyra",
    ["Skýrophos"]    = "[[File:SkyrophosFlag.png|20px]] Skýrophos",
    Riddersborg      = "[[File:RiddersborgFlag.png|20px]] Riddersborg",
    Ardclach         = "[[File:ArdclachFlag.png|20px]] Ardclach",
    Jogi             = "[[File:JogiFlag.png|20px]] Jogi",
    Sufriya          = "[[File:SufriyaFlag.png|20px]] Sufriya",
    ["Keybir-Aviv"]  = "[[File:KeybirAvivFlag.png|20px]] Keybir-Aviv",
    Aegirheim        = "[[File:AegirheimFlag.png|20px]] Aegirheim",
    Bjornopolis      = "[[File:BjornopolisFlag.png|20px]] Bjornopolis"
}

-- Cults for ritual vessels
local ritualCults = {
    "Ordo Solis Invicti", "Order of Aurora Mystica", "Harmony Sanctum", "Ignis Aeternum",
    "Celestial Harmony Sect", "Guild of Golden Shadows", "Azure Sentinel Sect", "Reverie Nebulous",
    "Eon Fellowship", "Order of the Umbral Oracle", "Mystery of the Verdant Embrace", "Conclave Illuminara",
    "Sanctum Vitalis", "Temple Alabaster", "Court of the Ironclad", "Accord Concordia",
    "Mystery of the Stygian Veil", "Sylvan Fellowship", "Mystery of Red Mirth", "Rex Catonis",
    "Sanctum Delphica", "Ordo Amicitia", "Temple Illuminata"
}

-- Divisions for military vessels
local militaryDivisions = {
    "Alpazkigz Division", "Odiferia Division", "Vaeringheim Division", "Haifa Division",
    "Jeseri Division", "Hatch Ministry Division", "New South Jangsong Division", "Haifan Bassaridia Division"
}

-- Cargo categories
local baseCargoCats = {'Agricultural', 'Mining/Manufacturing', 'Services'}
local extendedCats  = {'Agricultural', 'Mining/Manufacturing', 'Services', 'Unspecified'}

-- Companies for agricultural cargo
local agriCompanies = {
    "Gladeseed Farmers' Union", "Atterian Cattle Drivers", "Noctic Fleet", "Jogiani Merchants of Manwine",
    "Keepers of the Grove of Zoe Elm", "Sea-Elm Southern Meadery", "Plains of Jogi", "Ale of the Night Central Brewery",
    "Camel Herders of the Jangsong Province", "Anterran Imports and Services", "Merchant Guild of the Poppy Goddess",
    "Grand Cave Bee Meadery", "Cinammon Plains of Roue", "The Velvet Company", "Seamstresses of Rouge",
    "Salurian Temple of Sacred Horehound", "Bulhanu Ranchers' Association", "Suncliff Fisheries",
    "Ministers of Mistress Mugwort", "Blood Vineyards of the Far North", "Norsolyrian Wisp Rice Farmers Association",
    "Giid Lisea Ranching Import Company", "Bird Keepers of Saluria", "Hunters of the Giant Fanged Penguin",
    "Knights Castle Reindeer Herders", "Lindley Whaling Company"
}

-- Companies for mining/manufacturing cargo
local miningCompanies = {
    "Baratar Corporation", "Roving Wind Farm Corporation", "Thalassian Temples Granite Export Cooperative",
    "East Keltian Iron Company", "Mylecian Coal Ports", "Merchants of the Valley of Diamonds",
    "East Keltian Timber Company", "Onceanic Boot Company", "Commune of the Garganid Apostles",
    "Shï Collective", "Order of the Sphinx", "Market Hanavusu", "Somniant Stock Fund"
}

-- Companies for services cargo
local serviceCompanies = {
    "Lake Morovia Blockade Fund", "Court of the Dark Harpy", "Hatch Ministry",
    "Maritime Guild of the Cult of Maskmakers", "Ergonian Spy Agency", "Temple Bank of the Reformed Stripping Path",
    "Couriers of the Lizard Queen", "Temple University of Delphica", "La Sái Ebile",
    "Hellhound Breeders of Dragevik"
}

-- Choose operator based on vessel type & cargo
local function getOperator(vType, cargoType)
    if vType == "Ritual" then
        return randomChoice(ritualCults)
    elseif vType == "Military" then
        return randomChoice(militaryDivisions)
    elseif vType == "Privateer" then
        -- captain generation
        local cap = randomChoice({
            {first="Talvios", last="Karnis", nickname="Erebektos"},
            {first="Mirek", last="Davros", nickname="Zammarion"},
            {first="Ilion", last="Quoros"},
            {first="Sevon", last="Halek", nickname="Thamuthis"},
            {first="Caldris", last="Onir", nickname="Votharion"},
            {first="Loras", last="Tarnok"},
            {first="Vaelen", last="Koros"},
            {first="Daskos", last="Meyron", nickname="Orontion"},
            {first="Kyric", last="Fenros", nickname="Mekharsan"},
            {first="Omir", last="Thalos"},
            {first="Baryon", last="Syrek", nickname="Satharkon"},
            {first="Orien", last="Damar"},
            {first="Tharkos", last="Nyros", nickname="Vathmenos"},
            {first="Halion", last="Trevik"},
            {first="Kelvir", last="Raan", nickname="Nabarrion"},
            {first="Lethan", last="Kohr"},
            {first="Zarik", last="Tharn"},
            {first="Varas", last="Jorik", nickname="Tharnukhet"},
            {first="Yasrek", last="Tymon"},
            {first="Aethon", last="Morvek", nickname="Vathromen"},
            {first="Crivos", last="Elyen"},
            {first="Saran", last="Valic"},
            {first="Drevos", last="Helkan", nickname="Khamsuron"},
            {first="Nyros", last="Qalor"},
            {first="Talen", last="Vorric", nickname="Valkhoret"}
        })
        if cap.nickname and math.random()<0.25 then
            return string.format("Captain %s \"%s\" %s", cap.first, cap.nickname, cap.last)
        else
            return string.format("Captain %s %s", cap.first, cap.last)
        end
    elseif vType == "Cargo" then
        if cargoType == "Agricultural" then
            return randomChoice(agriCompanies)
        elseif cargoType == "Mining/Manufacturing" then
            return randomChoice(miningCompanies)
        elseif cargoType == "Services" then
            return randomChoice(serviceCompanies)
        end
    end
    return "Independent Consortium"
end

function p.generateShipTable()
    local vesselTypes = {'Cargo', 'Military', 'Ritual', 'Privateer'}
    local errorTypes  = {
        "Cargo Mislabeling", "Improper Documentation",
        "Surveillance Anomaly", "Inspection Failure",
        "Unregistered Ritual Cargo"
    }

    -- gather city keys for random assignment
    local cityKeys = {}
    for k in pairs(cities) do table.insert(cityKeys, k) end

    local year, day = p.getCurrentDate()
    local dateStr  = string.format("Day %d, Y.%d", day, year)

    -- build ship entries
    local ships = {}
    for i = 1, math.random(50, 80) do
        local h, m    = math.random(0,23), math.random(0,59)
        local vType   = randomChoice(vesselTypes)
        local cargo   = (vType=="Cargo")
                      and randomChoice(baseCargoCats)
                      or randomChoice(extendedCats)
        ships[#ships+1] = {
            date       = dateStr,
            time       = string.format("%02d:%02d", h, m),
            sort       = h*60 + m,
            vessel_id  = "VM-"..math.random(10000,99999),
            home_city  = cities[randomChoice(cityKeys)],
            type       = vType,
            operator   = getOperator(vType, cargo),
            berth      = math.random(1,124),
            teus       = math.random(100,1000),
            tonnage    = string.format("%.2f", math.random()*19000+1000),
            cargo_type = cargo,
            queue      = string.format("%.2f", math.random()*5.5+0.5),
            turnaround = string.format("%.2f", math.random()*32+4),
            error      = (math.random()<0.2) and randomChoice(errorTypes) or "None"
        }
    end

    table.sort(ships, function(a,b) return a.sort < b.sort end)

    -- build wikitext table
    local out = "{| class=\"wikitable sortable\"\n" ..
                "! Date !! Time !! Vessel ID !! Home City !! Type !! Owner/Operator !! Berth !! TEUs !! Tonnage !! Cargo Type !! Queue (hrs) !! Turnaround (hrs) !! Error"
    for _, s in ipairs(ships) do
        out = out .. string.format(
            "\n|-\n| %s || %s || %s || %s || %s || %s || %d || %d || %s || %s || %s || %s",
            s.date, s.time, s.vessel_id, s.home_city, s.type, s.operator,
            s.berth, s.teus, s.tonnage, s.cargo_type, s.queue, s.turnaround
        )
        if s.error ~= "None" then
            out = out .. string.format(" || style=\"background-color:#fdd;\" | %s", s.error)
        else
            out = out .. " || None"
        end
    end

    out = out .. "\n|}\n\n'''Error Key:'''\n" ..
          "* '''Cargo Mislabeling:''' Mismatch between manifest and actual goods\n" ..
          "* '''Improper Documentation:''' Missing or outdated transit papers\n" ..
          "* '''Surveillance Anomaly:''' Unexpected heat or movement signature\n" ..
          "* '''Inspection Failure:''' Failed customs or hatch review\n" ..
          "* '''Unregistered Ritual Cargo:''' Religious items not pre-cleared by the Temple Bank\n"

    return out
end

function p.dailyReport()
    local y,d = p.getCurrentDate()
    local header = string.format("'''General Port of Lake Morovia: Operational Log – Day %d, Year %d PSSC'''\n", d, y)
    return header .. p.generateShipTable()
end

return p