SYSTEMS

Prescriptive subsystem specifications. Each doc here describes the target design of a single subsystem: the algorithm, the state machine, the chain of operations triggered by an event, the invariants the system must hold, and the failure modes it has to handle.

How SYSTEMS differs from the other sections

Section	Question it answers
DATA_MODELS/	What columns and relationships exist?
FEATURES/	What does the player experience and what is the implementation status?
ARCHITECTURE/	What services, processes, networks, and deployments make up the system?
OPERATIONS/	What are the running pieces (UIs, AI assistant, infra) and how are they operated?
SYSTEMS/	When event X happens, what is the chain of operations? What state changes? What invariants hold? What are the failure modes?

Conventions

• Each system doc is prescriptive — written in present tense, describing the target design ("the resolver applies damage in this order…"), not the current code state.
• Source-map tables list the target locations for the responsible code.
• Cross-links use repo-relative paths (e.g. ../DATA_MODELS/combat.md).
• Implementation status (drift from these specs, known bugs, partial coverage) is tracked inline in the matching FEATURES/ file using ✅ / 🚧 / 📐 / 🐛 markers — never here.

Index

System	One-liner
turn-regeneration.md	Lazy turn-pool refill driven by elapsed time, ARIA multiplier, and rank cap.
combat-resolver.md	Phased combat pipeline: initiation, drone screen, ship-vs-ship, cleanup, post-combat hooks.
fleet-coordination.md	Fleet state machine, formation modifiers, morale/supply tick, role-based combat contribution.
market-pricing.md	Supply/demand pricing, transaction settlement, market-history snapshots, price-alert evaluation.
realtime-bus.md	WebSocket event bus: auth handshake, room model, presence, broadcast/unicast, reconnection.
sector-presence.md	Sector occupancy tracking, encounter rolls on entry, tunnel events, broadcast on join/leave.
galaxy-generation.md	Pipeline from galaxy metadata down to seeded sectors, stations, planets, and warp graph.
bang-import-pipeline.md	End-to-end translator from sw2102-bang Universe JSON into the gameserver multi-region schema.
central-nexus-districts.md	10-district overlay for Central Nexus: sector ranges, security/development/traffic profiles, characteristics.
aria-dialogue.md	ARIA conversation flow: sanitization, intent, multilingual routing, tool invocation, audit.
trade-dna-evolution.md	ARIA trading-pattern evolutionary loop: fitness, mutation, generations, selection.
first-login.md	First-login state machine for ship claim, dialogue evaluation, and Player record creation.
regional-governance.md	Election scheduling, policy proposal/voting/enactment, treaty negotiation.
genesis-deploy.md	Genesis-device pre-flight, formation timer, planet creation, failure modes.
planetary-production-tick.md	Per-tick planet production: colonist consumption, resource generation, citadel multipliers.
bounty-and-reputation.md	Personal-reputation deltas, automatic system bounties, bounty placement, collection-on-kill.