Operations Flow

Campaign

The Campaign is the master clock for all activity. Set the campaign start date and the current session date (a real Gregorian calendar date) and advance it each session. Every date, installment, and PDF is derived from this clock.

A Campaign can span many Missions or just one. Use whichever scope fits your 2300AD table.

• Session date drives all form date limits and PDF "generated on" stamps.
• Assets linked to the campaign inherit its calendar for all date fields.
• Every update is logged as a session timeline entry with a JSON snapshot.
• The Campaign is the anchor for Running Costs, Trade Income, and Mortgage signings.
• All session dates are stored and displayed as real Gregorian calendar dates.

Trading Companies

Companies — patrons, banks, brokers, starport authorities — are shared across all campaigns. Register a trading house or banking institution once; reuse it in any contract without re-entering its Local Law jurisdiction data.

• Local Law data is automatically carried into Running Cost, Trade Income, and Mortgage PDFs.
• Company roles (Patron, Bank, Broker, Starport…) clarify counterparties in all contracts.
• Cross-campaign reuse keeps all signed documents consistent.

Crew

Crew status is a timeline. When assigned from the "unassigned" pool, the crew member is set to Active and stamped with the session date.

• Status: Active, On Leave, Retired, Missing (MIA), Deceased.
• Unassigned lists exclude MIA/Deceased by default.
• Detaching a crew from an asset clears Active/Leave/Retired dates and status.

Register Assets

Assets (Ship, Base, Team) are the core accounting units. Every asset automatically gains a Financial Account (Wallet) to store its Livres and link to the Ledger.

• Wallet Core: Assets cannot exist without a linked financial account. The system provisions one automatically if not specified.
• Ownership Bond: Financial Accounts tied to an asset can only be removed by decommissioning the asset itself.
• JIT Capacity: If an Asset lacks built-in cargo tons, the system prompts for it "Just-In-Time" during contract signing.
• Technical specs and crew hierarchies are anchored to this entity.

Asset Amendment

Signed assets change via Amendments. Link each amendment to a technical cost with a payment date; that date becomes the effective date of the amendment.

• Cost ref is mandatory and must have a payment date.
• Costs already used by other amendments are excluded.
• Amendments are recorded in the Asset PDF for audit.

Astrogation & Star Routes

Star Routes are built from real StarSystem waypoints on the Stutterwarp network and linked to a ship and campaign. The Astrogation HUD handles real-time Stutterwarp transits without page reloads.

• Light-Year Distances: Jump distances are calculated from real star catalog coordinates, driving accurate coil discharge tracking per leg.
• Real Transit Clock: Every Stutterwarp jump advances the campaign session clock by the actual transit time (leg distance ÷ ship efficiency), not a fixed interval.
• Live Map Redraw: The in-app 2D/3D map view redraws live at every jump — no external star-map link needed.

Ship Mortgage

Mortgages are signed using the campaign session date. Register the financing bank, rate, and insurance for each ship or base purchased on credit. Payments follow a 28-day billing cycle.

• The signing date, location, and bank are locked into the PDF for the ship's dossier.
• Smart Visibility: The financial account selector appears only after you pick the ship.
• Installments are tracked across the full 40-year mortgage term.

Trade Income

Record all incoming Livres: Freight proceeds, Passage fares, Trade sales, Patron payments. The system auto-splits deposits (at signing) from final balances (at delivery), keeping your ledger accurate throughout the voyage.

• Geographic Normalization: All signing locations are saved as a real StarSystem reference.
• Searchable Selects: The StarSystem is picked directly from the star catalog — no sector/hex lookup needed.
• System auto-splits Deposits (Signature Date) vs Balances (Payout Date).

Cargo Hold

The Cargo Hold tracks all non-financial assets (Trade, Loot, Items). It integrates directly with the Ledger for purchases and sales.

• Loot Protocol: Register salvage or loot by indicating its StarSystem of origin.
• Liquidation Engine: Converts cargo into Income (Livres), calculating legal profit/loss based on the sale location.
• Mass Tracking: Mail containers are tracked via `totalMass` ensuring accurate ship load.
• Inventory is filterable by asset and synced with the Tactical Cards.

Running Costs

Running Costs (Fuel, Life Support, Maintenance, Berthing, Crew Salaries…) are date-stamped. Every Livre spent is deducted on its Payment Date, keeping the ship's ledger accurate across billing cycles.

• Legacy Locations: Older cost records without a linked StarSystem still show their saved location text.
• XOR Validation prevents selecting an account AND typing a new one simultaneously.
• Line items feed the calculated amount field (read-only).

Annual Budget

The Annual Budget gives the Referee a fiscal overview for the year: it aggregates Trade Income, Running Costs, Crew Salaries, and Mortgage installments into a single balance strip.

• One budget per ship or base, covering a defined start/end date range.
• The timeline merges all payments across the billing cycles in the period.
• Use it to forecast whether the ship stays solvent before committing to the next Stutterwarp jump.