Operations Flow

Campaign

The Campaign is the master clock for all activity. Set the starting Imperial year and the current session date (day/year in DDD/YYYY format) and advance it each session. Every date, installment, and PDF is derived from this clock.

A Campaign can span many Adventures or just one. Use whichever scope fits your Traveller table.

• Session date drives all form date limits and PDF "generated on" stamps.
• Assets linked to the campaign inherit its calendar for all day/year 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 Imperial dates are stored and displayed as DDD/YYYY.

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 credits 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 day/year of the amendment.

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

Astrogation & Jump Routes

Jump Routes are built from sector waypoints (Sector + Hex) and linked to a ship and campaign. The Astrogation HUD handles real-time Jump transits without page reloads.

• Parsec Distances: Jump distances are calculated from real Charted Space coordinates, driving accurate fuel consumption per leg.
• Jump Clock: Every Jump Transit automatically advances the campaign session clock by 7 days.
• TravellerMap Integration: Map links open TRAVELLERMAP.COM at the correct sector/hex for visual confirmation of the astrogation plot.

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 the Traveller 13-period Imperial year (one payment every 28 days).

• 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 Credits: Freight proceeds, Passage fares, Speculative Trade sales, Patron payments. The system auto-splits deposits (at signing) from final balances (at delivery), keeping your ledger accurate throughout the voyage.

• Normalizzazione Geografica: Tutte le posizioni (Signing Location) sono salvate nel formato standard `Sector // World`.
• Dependent Selects: La scelta del mondo è vincolata al settore tramite lookup OTU dinamico.
• 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: Permette la registrazione di bottino indicando settore e mondo di origine.
• Liquidation Engine: Converte merci in crediti (Income) calcolando profitto/perdita legale basata sulla posizione di vendita.
• Mass Tracking: Imperial Mail containers are tracked via `totalMass` ensuring accurate ship load.
• L'inventario è filtrabile per asset e sincronizzato con le Tactical Card.

Running Costs

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

• UWP Matching: Inizializzazione automatica delle label estese per dati legacy nel PRE_SET_DATA del form.
• 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 Imperial 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 Imperial start/end date range.
• The timeline merges all payments across the 13 Maintenance Periods of the year.
• Use it to forecast whether the ship stays solvent before committing to the next Jump.