feat: rework modules, items and fuel

2026-03-17 03:32:37 -04:00
parent ec1116e1ce
commit 3234b628ea
45 changed files with 4882 additions and 6052 deletions
--- a/apps/backend/Simulation/Model/ShipRuntimeModels.cs
+++ b/apps/backend/Simulation/Model/ShipRuntimeModels.cs
@@ -4,63 +4,62 @@ namespace SpaceGame.Simulation.Api.Simulation;

 public sealed class ShipRuntime
 {
-    public required string Id { get; init; }
-    public required string SystemId { get; set; }
-    public required ShipDefinition Definition { get; init; }
-    public required string FactionId { get; init; }
-    public required Vector3 Position { get; set; }
-    public required Vector3 TargetPosition { get; set; }
-    public required ShipSpatialStateRuntime SpatialState { get; set; }
-    public Vector3 Velocity { get; set; } = Vector3.Zero;
-    public ShipState State { get; set; } = ShipState.Idle;
-    public ShipOrderRuntime? Order { get; set; }
-    public required DefaultBehaviorRuntime DefaultBehavior { get; set; }
-    public required ControllerTaskRuntime ControllerTask { get; set; }
-    public float ActionTimer { get; set; }
-    public Dictionary<string, float> Inventory { get; } = new(StringComparer.Ordinal);
-    public float WorkerPopulation { get; set; }
-    public float EnergyStored { get; set; }
-    public string? DockedStationId { get; set; }
-    public int? AssignedDockingPadIndex { get; set; }
-    public string? CommanderId { get; set; }
-    public string? PolicySetId { get; set; }
-    public float Health { get; set; }
-    public string? TrackedActionKey { get; set; }
-    public float TrackedActionTotal { get; set; }
-    public List<string> History { get; } = [];
-    public string LastSignature { get; set; } = string.Empty;
-    public string LastDeltaSignature { get; set; } = string.Empty;
+  public required string Id { get; init; }
+  public required string SystemId { get; set; }
+  public required ShipDefinition Definition { get; init; }
+  public required string FactionId { get; init; }
+  public required Vector3 Position { get; set; }
+  public required Vector3 TargetPosition { get; set; }
+  public required ShipSpatialStateRuntime SpatialState { get; set; }
+  public Vector3 Velocity { get; set; } = Vector3.Zero;
+  public ShipState State { get; set; } = ShipState.Idle;
+  public ShipOrderRuntime? Order { get; set; }
+  public required DefaultBehaviorRuntime DefaultBehavior { get; set; }
+  public required ControllerTaskRuntime ControllerTask { get; set; }
+  public float ActionTimer { get; set; }
+  public Dictionary<string, float> Inventory { get; } = new(StringComparer.Ordinal);
+  public float WorkerPopulation { get; set; }
+  public string DockedStationId { get; set; }
+  public int? AssignedDockingPadIndex { get; set; }
+  public string? CommanderId { get; set; }
+  public string? PolicySetId { get; set; }
+  public float Health { get; set; }
+  public string? TrackedActionKey { get; set; }
+  public float TrackedActionTotal { get; set; }
+  public List<string> History { get; } = [];
+  public string LastSignature { get; set; } = string.Empty;
+  public string LastDeltaSignature { get; set; } = string.Empty;
 }

 public sealed class ShipOrderRuntime
 {
-    public required string Kind { get; init; }
-    public OrderStatus Status { get; set; } = OrderStatus.Accepted;
-    public required string DestinationSystemId { get; init; }
-    public required Vector3 DestinationPosition { get; init; }
+  public required string Kind { get; init; }
+  public OrderStatus Status { get; set; } = OrderStatus.Accepted;
+  public required string DestinationSystemId { get; init; }
+  public required Vector3 DestinationPosition { get; init; }
 }

 public sealed class DefaultBehaviorRuntime
 {
-    public required string Kind { get; set; }
-    public string? AreaSystemId { get; set; }
-    public string? StationId { get; set; }
-    public string? RefineryId { get; set; }
-    public string? NodeId { get; set; }
-    public string? ModuleId { get; set; }
-    public string? Phase { get; set; }
-    public List<Vector3> PatrolPoints { get; set; } = [];
-    public int PatrolIndex { get; set; }
+  public required string Kind { get; set; }
+  public string? AreaSystemId { get; set; }
+  public string? StationId { get; set; }
+  public string? RefineryId { get; set; }
+  public string? NodeId { get; set; }
+  public string? ModuleId { get; set; }
+  public string? Phase { get; set; }
+  public List<Vector3> PatrolPoints { get; set; } = [];
+  public int PatrolIndex { get; set; }
 }

 public sealed class ControllerTaskRuntime
 {
-    public required ControllerTaskKind Kind { get; set; }
-    public WorkStatus Status { get; set; } = WorkStatus.Pending;
-    public string? CommanderId { get; set; }
-    public string? TargetEntityId { get; set; }
-    public string? TargetSystemId { get; set; }
-    public string? TargetNodeId { get; set; }
-    public Vector3? TargetPosition { get; set; }
-    public float Threshold { get; set; }
+  public required ControllerTaskKind Kind { get; set; }
+  public WorkStatus Status { get; set; } = WorkStatus.Pending;
+  public string? CommanderId { get; set; }
+  public string? TargetEntityId { get; set; }
+  public string? TargetSystemId { get; set; }
+  public string? TargetNodeId { get; set; }
+  public Vector3? TargetPosition { get; set; }
+  public float Threshold { get; set; }
 }
--- a/apps/backend/Simulation/Model/SimulationKinds.cs
+++ b/apps/backend/Simulation/Model/SimulationKinds.cs
@@ -2,243 +2,237 @@ namespace SpaceGame.Simulation.Api.Simulation;

 public enum SpatialNodeKind
 {
-    Star,
-    Planet,
-    Moon,
-    LagrangePoint,
-    Station,
-    ResourceSite,
+  Star,
+  Planet,
+  Moon,
+  LagrangePoint,
+  Station,
+  ResourceSite,
 }

 public enum WorkStatus
 {
-    Pending,
-    Active,
-    Completed,
+  Pending,
+  Active,
+  Completed,
 }

 public enum OrderStatus
 {
-    Queued,
-    Accepted,
-    Completed,
+  Queued,
+  Accepted,
+  Completed,
 }

 public enum ShipState
 {
-    Idle,
-    Arriving,
-    CapacitorStarved,
-    LocalFlight,
-    SpoolingWarp,
-    Warping,
-    SpoolingFtl,
-    Ftl,
-    CargoFull,
-    MiningApproach,
-    Mining,
-    NodeDepleted,
-    AwaitingDock,
-    DockingApproach,
-    Docking,
-    Docked,
-    Transferring,
-    Loading,
-    Unloading,
-    Refueling,
-    WaitingMaterials,
-    ConstructionBlocked,
-    Constructing,
-    DeliveringConstruction,
-    Blocked,
-    Undocking,
+  Idle,
+  Arriving,
+  LocalFlight,
+  SpoolingWarp,
+  Warping,
+  SpoolingFtl,
+  Ftl,
+  CargoFull,
+  MiningApproach,
+  Mining,
+  NodeDepleted,
+  AwaitingDock,
+  DockingApproach,
+  Docking,
+  Docked,
+  Transferring,
+  Loading,
+  Unloading,
+  WaitingMaterials,
+  ConstructionBlocked,
+  Constructing,
+  DeliveringConstruction,
+  Blocked,
+  Undocking,
 }

 public enum ControllerTaskKind
 {
-    Idle,
-    Travel,
-    Extract,
-    Dock,
-    Load,
-    Unload,
-    Refuel,
-    DeliverConstruction,
-    BuildConstructionSite,
-    LoadWorkers,
-    UnloadWorkers,
-    ConstructModule,
-    Undock,
+  Idle,
+  Travel,
+  Extract,
+  Dock,
+  Load,
+  Unload,
+  DeliverConstruction,
+  BuildConstructionSite,
+  LoadWorkers,
+  UnloadWorkers,
+  ConstructModule,
+  Undock,
 }

 public static class SpaceLayerKinds
 {
-    public const string UniverseSpace = "universe-space";
-    public const string GalaxySpace = "galaxy-space";
-    public const string SystemSpace = "system-space";
-    public const string LocalSpace = "local-space";
+  public const string UniverseSpace = "universe-space";
+  public const string GalaxySpace = "galaxy-space";
+  public const string SystemSpace = "system-space";
+  public const string LocalSpace = "local-space";
 }

 public static class MovementRegimeKinds
 {
-    public const string LocalFlight = "local-flight";
-    public const string Warp = "warp";
-    public const string StargateTransit = "stargate-transit";
-    public const string FtlTransit = "ftl-transit";
+  public const string LocalFlight = "local-flight";
+  public const string Warp = "warp";
+  public const string StargateTransit = "stargate-transit";
+  public const string FtlTransit = "ftl-transit";
 }

 public static class CommanderKind
 {
-    public const string Faction = "faction";
-    public const string Station = "station";
-    public const string Ship = "ship";
-    public const string Fleet = "fleet";
-    public const string Sector = "sector";
-    public const string TaskGroup = "task-group";
+  public const string Faction = "faction";
+  public const string Station = "station";
+  public const string Ship = "ship";
+  public const string Fleet = "fleet";
+  public const string Sector = "sector";
+  public const string TaskGroup = "task-group";
 }

 public static class ShipTaskKinds
 {
-    public const string Idle = "idle";
-    public const string LocalMove = "local-move";
-    public const string WarpToNode = "warp-to-node";
-    public const string UseStargate = "use-stargate";
-    public const string UseFtl = "use-ftl";
-    public const string Dock = "dock";
-    public const string Undock = "undock";
-    public const string LoadCargo = "load-cargo";
-    public const string UnloadCargo = "unload-cargo";
-    public const string LoadWorkers = "load-workers";
-    public const string UnloadWorkers = "unload-workers";
-    public const string MineNode = "mine-node";
-    public const string HarvestGas = "harvest-gas";
-    public const string DeliverToStation = "deliver-to-station";
-    public const string ClaimLagrangePoint = "claim-lagrange-point";
-    public const string BuildConstructionSite = "build-construction-site";
-    public const string EscortTarget = "escort-target";
-    public const string AttackTarget = "attack-target";
-    public const string DefendBubble = "defend-bubble";
-    public const string Retreat = "retreat";
-    public const string HoldPosition = "hold-position";
+  public const string Idle = "idle";
+  public const string LocalMove = "local-move";
+  public const string WarpToNode = "warp-to-node";
+  public const string UseStargate = "use-stargate";
+  public const string UseFtl = "use-ftl";
+  public const string Dock = "dock";
+  public const string Undock = "undock";
+  public const string LoadCargo = "load-cargo";
+  public const string UnloadCargo = "unload-cargo";
+  public const string LoadWorkers = "load-workers";
+  public const string UnloadWorkers = "unload-workers";
+  public const string MineNode = "mine-node";
+  public const string HarvestGas = "harvest-gas";
+  public const string DeliverToStation = "deliver-to-station";
+  public const string ClaimLagrangePoint = "claim-lagrange-point";
+  public const string BuildConstructionSite = "build-construction-site";
+  public const string EscortTarget = "escort-target";
+  public const string AttackTarget = "attack-target";
+  public const string DefendBubble = "defend-bubble";
+  public const string Retreat = "retreat";
+  public const string HoldPosition = "hold-position";
 }

 public static class ShipOrderKinds
 {
-    public const string DirectMove = "direct-move";
-    public const string TravelToNode = "travel-to-node";
-    public const string DockAtStation = "dock-at-station";
-    public const string DeliverCargo = "deliver-cargo";
-    public const string BuildAtSite = "build-at-site";
-    public const string AttackTarget = "attack-target";
-    public const string HoldPosition = "hold-position";
+  public const string DirectMove = "direct-move";
+  public const string TravelToNode = "travel-to-node";
+  public const string DockAtStation = "dock-at-station";
+  public const string DeliverCargo = "deliver-cargo";
+  public const string BuildAtSite = "build-at-site";
+  public const string AttackTarget = "attack-target";
+  public const string HoldPosition = "hold-position";
 }

 public static class ClaimStateKinds
 {
-    public const string Placed = "placed";
-    public const string Activating = "activating";
-    public const string Active = "active";
-    public const string Destroyed = "destroyed";
+  public const string Placed = "placed";
+  public const string Activating = "activating";
+  public const string Active = "active";
+  public const string Destroyed = "destroyed";
 }

 public static class ConstructionSiteStateKinds
 {
-    public const string Planned = "planned";
-    public const string Active = "active";
-    public const string Paused = "paused";
-    public const string Completed = "completed";
-    public const string Destroyed = "destroyed";
+  public const string Planned = "planned";
+  public const string Active = "active";
+  public const string Paused = "paused";
+  public const string Completed = "completed";
+  public const string Destroyed = "destroyed";
 }

 public static class MarketOrderKinds
 {
-    public const string Buy = "buy";
-    public const string Sell = "sell";
+  public const string Buy = "buy";
+  public const string Sell = "sell";
 }

 public static class MarketOrderStateKinds
 {
-    public const string Open = "open";
-    public const string PartiallyFilled = "partially-filled";
-    public const string Filled = "filled";
-    public const string Cancelled = "cancelled";
+  public const string Open = "open";
+  public const string PartiallyFilled = "partially-filled";
+  public const string Filled = "filled";
+  public const string Cancelled = "cancelled";
 }

 public static class SimulationEnumMappings
 {
-    public static string ToContractValue(this SpatialNodeKind kind) => kind switch
-    {
-        SpatialNodeKind.Star => "star",
-        SpatialNodeKind.Planet => "planet",
-        SpatialNodeKind.Moon => "moon",
-        SpatialNodeKind.LagrangePoint => "lagrange-point",
-        SpatialNodeKind.Station => "station",
-        SpatialNodeKind.ResourceSite => "resource-site",
-        _ => throw new ArgumentOutOfRangeException(nameof(kind), kind, null),
-    };
+  public static string ToContractValue(this SpatialNodeKind kind) => kind switch
+  {
+    SpatialNodeKind.Star => "star",
+    SpatialNodeKind.Planet => "planet",
+    SpatialNodeKind.Moon => "moon",
+    SpatialNodeKind.LagrangePoint => "lagrange-point",
+    SpatialNodeKind.Station => "station",
+    SpatialNodeKind.ResourceSite => "resource-site",
+    _ => throw new ArgumentOutOfRangeException(nameof(kind), kind, null),
+  };

-    public static string ToContractValue(this WorkStatus status) => status switch
-    {
-        WorkStatus.Pending => "pending",
-        WorkStatus.Active => "active",
-        WorkStatus.Completed => "completed",
-        _ => throw new ArgumentOutOfRangeException(nameof(status), status, null),
-    };
+  public static string ToContractValue(this WorkStatus status) => status switch
+  {
+    WorkStatus.Pending => "pending",
+    WorkStatus.Active => "active",
+    WorkStatus.Completed => "completed",
+    _ => throw new ArgumentOutOfRangeException(nameof(status), status, null),
+  };

-    public static string ToContractValue(this OrderStatus status) => status switch
-    {
-        OrderStatus.Queued => "queued",
-        OrderStatus.Accepted => "accepted",
-        OrderStatus.Completed => "completed",
-        _ => throw new ArgumentOutOfRangeException(nameof(status), status, null),
-    };
+  public static string ToContractValue(this OrderStatus status) => status switch
+  {
+    OrderStatus.Queued => "queued",
+    OrderStatus.Accepted => "accepted",
+    OrderStatus.Completed => "completed",
+    _ => throw new ArgumentOutOfRangeException(nameof(status), status, null),
+  };

-    public static string ToContractValue(this ShipState state) => state switch
-    {
-        ShipState.Idle => "idle",
-        ShipState.Arriving => "arriving",
-        ShipState.CapacitorStarved => "capacitor-starved",
-        ShipState.LocalFlight => "local-flight",
-        ShipState.SpoolingWarp => "spooling-warp",
-        ShipState.Warping => "warping",
-        ShipState.SpoolingFtl => "spooling-ftl",
-        ShipState.Ftl => "ftl",
-        ShipState.CargoFull => "cargo-full",
-        ShipState.MiningApproach => "mining-approach",
-        ShipState.Mining => "mining",
-        ShipState.NodeDepleted => "node-depleted",
-        ShipState.AwaitingDock => "awaiting-dock",
-        ShipState.DockingApproach => "docking-approach",
-        ShipState.Docking => "docking",
-        ShipState.Docked => "docked",
-        ShipState.Transferring => "transferring",
-        ShipState.Loading => "loading",
-        ShipState.Unloading => "unloading",
-        ShipState.Refueling => "refueling",
-        ShipState.WaitingMaterials => "waiting-materials",
-        ShipState.ConstructionBlocked => "construction-blocked",
-        ShipState.Constructing => "constructing",
-        ShipState.DeliveringConstruction => "delivering-construction",
-        ShipState.Blocked => "blocked",
-        ShipState.Undocking => "undocking",
-        _ => throw new ArgumentOutOfRangeException(nameof(state), state, null),
-    };
+  public static string ToContractValue(this ShipState state) => state switch
+  {
+    ShipState.Idle => "idle",
+    ShipState.Arriving => "arriving",
+    ShipState.LocalFlight => "local-flight",
+    ShipState.SpoolingWarp => "spooling-warp",
+    ShipState.Warping => "warping",
+    ShipState.SpoolingFtl => "spooling-ftl",
+    ShipState.Ftl => "ftl",
+    ShipState.CargoFull => "cargo-full",
+    ShipState.MiningApproach => "mining-approach",
+    ShipState.Mining => "mining",
+    ShipState.NodeDepleted => "node-depleted",
+    ShipState.AwaitingDock => "awaiting-dock",
+    ShipState.DockingApproach => "docking-approach",
+    ShipState.Docking => "docking",
+    ShipState.Docked => "docked",
+    ShipState.Transferring => "transferring",
+    ShipState.Loading => "loading",
+    ShipState.Unloading => "unloading",
+    ShipState.WaitingMaterials => "waiting-materials",
+    ShipState.ConstructionBlocked => "construction-blocked",
+    ShipState.Constructing => "constructing",
+    ShipState.DeliveringConstruction => "delivering-construction",
+    ShipState.Blocked => "blocked",
+    ShipState.Undocking => "undocking",
+    _ => throw new ArgumentOutOfRangeException(nameof(state), state, null),
+  };

-    public static string ToContractValue(this ControllerTaskKind kind) => kind switch
-    {
-        ControllerTaskKind.Idle => "idle",
-        ControllerTaskKind.Travel => "travel",
-        ControllerTaskKind.Extract => "extract",
-        ControllerTaskKind.Dock => "dock",
-        ControllerTaskKind.Load => "load",
-        ControllerTaskKind.Unload => "unload",
-        ControllerTaskKind.Refuel => "refuel",
-        ControllerTaskKind.DeliverConstruction => "deliver-construction",
-        ControllerTaskKind.BuildConstructionSite => "build-construction-site",
-        ControllerTaskKind.LoadWorkers => "load-workers",
-        ControllerTaskKind.UnloadWorkers => "unload-workers",
-        ControllerTaskKind.ConstructModule => "construct-module",
-        ControllerTaskKind.Undock => "undock",
-        _ => throw new ArgumentOutOfRangeException(nameof(kind), kind, null),
-    };
+  public static string ToContractValue(this ControllerTaskKind kind) => kind switch
+  {
+    ControllerTaskKind.Idle => "idle",
+    ControllerTaskKind.Travel => "travel",
+    ControllerTaskKind.Extract => "extract",
+    ControllerTaskKind.Dock => "dock",
+    ControllerTaskKind.Load => "load",
+    ControllerTaskKind.Unload => "unload",
+    ControllerTaskKind.DeliverConstruction => "deliver-construction",
+    ControllerTaskKind.BuildConstructionSite => "build-construction-site",
+    ControllerTaskKind.LoadWorkers => "load-workers",
+    ControllerTaskKind.UnloadWorkers => "unload-workers",
+    ControllerTaskKind.ConstructModule => "construct-module",
+    ControllerTaskKind.Undock => "undock",
+    _ => throw new ArgumentOutOfRangeException(nameof(kind), kind, null),
+  };
 }
--- a/apps/backend/Simulation/Model/SimulationWorld.cs
+++ b/apps/backend/Simulation/Model/SimulationWorld.cs
@@ -21,6 +21,7 @@ public sealed class SimulationWorld
    public required List<PolicySetRuntime> Policies { get; init; }
    public required Dictionary<string, ShipDefinition> ShipDefinitions { get; init; }
    public required Dictionary<string, ItemDefinition> ItemDefinitions { get; init; }
+    public required Dictionary<string, ModuleDefinition> ModuleDefinitions { get; init; }
    public required Dictionary<string, ModuleRecipeDefinition> ModuleRecipes { get; init; }
    public required Dictionary<string, RecipeDefinition> Recipes { get; init; }
    public int TickIntervalMs { get; init; } = 200;
--- a/apps/backend/Simulation/Model/StationRuntimeModels.cs
+++ b/apps/backend/Simulation/Model/StationRuntimeModels.cs
@@ -1,40 +1,49 @@
-using SpaceGame.Simulation.Api.Data;
-
 namespace SpaceGame.Simulation.Api.Simulation;

 public sealed class StationRuntime
 {
-    public required string Id { get; init; }
-    public required string SystemId { get; init; }
-    public required ConstructibleDefinition Definition { get; init; }
-    public required Vector3 Position { get; set; }
-    public required string FactionId { get; init; }
-    public string? NodeId { get; set; }
-    public string? BubbleId { get; set; }
-    public string? AnchorNodeId { get; set; }
-    public string? CommanderId { get; set; }
-    public string? PolicySetId { get; set; }
-    public List<string> InstalledModules { get; } = [];
-    public Dictionary<string, float> Inventory { get; } = new(StringComparer.Ordinal);
-    public Dictionary<string, float> ProductionLaneTimers { get; } = new(StringComparer.Ordinal);
-    public Dictionary<int, string> DockingPadAssignments { get; } = new();
-    public HashSet<string> MarketOrderIds { get; } = new(StringComparer.Ordinal);
-    public float EnergyStored { get; set; }
-    public float Population { get; set; }
-    public float PopulationCapacity { get; set; }
-    public float WorkforceRequired { get; set; }
-    public float WorkforceEffectiveRatio { get; set; } = 0.1f;
-    public float PopulationGrowthProgress { get; set; }
-    public float ShipProductionProgressSeconds { get; set; }
-    public HashSet<string> DockedShipIds { get; } = [];
-    public ModuleConstructionRuntime? ActiveConstruction { get; set; }
-    public string LastDeltaSignature { get; set; } = string.Empty;
+  public required string Id { get; init; }
+  public required string SystemId { get; init; }
+  public required string Label { get; set; }
+  public string Category { get; set; } = "station";
+  public string Color { get; set; } = "#8df0d2";
+  public required Vector3 Position { get; set; }
+  public float Radius { get; set; } = 24f;
+  public required string FactionId { get; init; }
+  public string? NodeId { get; set; }
+  public string? BubbleId { get; set; }
+  public string? AnchorNodeId { get; set; }
+  public string? CommanderId { get; set; }
+  public string? PolicySetId { get; set; }
+  public List<StationModuleRuntime> Modules { get; } = [];
+  public IEnumerable<string> InstalledModules => Modules.Select((module) => module.ModuleId);
+  public Dictionary<string, float> Inventory { get; } = new(StringComparer.Ordinal);
+  public Dictionary<string, float> ProductionLaneTimers { get; } = new(StringComparer.Ordinal);
+  public Dictionary<int, string> DockingPadAssignments { get; } = new();
+  public HashSet<string> MarketOrderIds { get; } = new(StringComparer.Ordinal);
+  public float Population { get; set; }
+  public float PopulationCapacity { get; set; }
+  public float WorkforceRequired { get; set; }
+  public float WorkforceEffectiveRatio { get; set; } = 0.1f;
+  public float PopulationGrowthProgress { get; set; }
+  public float ShipProductionProgressSeconds { get; set; }
+  public HashSet<string> DockedShipIds { get; } = [];
+  public ModuleConstructionRuntime? ActiveConstruction { get; set; }
+  public string LastDeltaSignature { get; set; } = string.Empty;
+}
+
+public sealed class StationModuleRuntime
+{
+  public required string Id { get; init; }
+  public required string ModuleId { get; init; }
+  public float Health { get; set; }
+  public float MaxHealth { get; set; }
 }

 public sealed class ModuleConstructionRuntime
 {
-    public required string ModuleId { get; init; }
-    public float ProgressSeconds { get; set; }
-    public float RequiredSeconds { get; init; }
-    public string AssignedConstructorShipId { get; set; } = string.Empty;
+  public required string ModuleId { get; init; }
+  public float ProgressSeconds { get; set; }
+  public float RequiredSeconds { get; init; }
+  public string AssignedConstructorShipId { get; set; } = string.Empty;
 }