Consolidate spatial docs into universe model

This commit is contained in:
2026-04-06 21:29:49 -04:00
parent 74b8bf4116
commit fdcf83ccec
15 changed files with 129 additions and 652 deletions

View File

@@ -14,7 +14,7 @@ The data model should support:
- module-based capability
- population and workforce
- claimable construction sites
- local-space combat
- localspace combat
- scalable replication and future sharding
## Core Principles
@@ -39,8 +39,8 @@ Recommended global ID families:
- `factionId`
- `commanderId`
- `systemId`
- `nodeId`
- `bubbleId`
- `anchorId`
- `localspaceId`
- `stationId`
- `shipId`
- `moduleId`
@@ -58,8 +58,8 @@ The intended core entities are:
1. `Faction`
2. `Commander`
3. `System`
4. `Node`
5. `LocalBubble`
4. `Anchor`
5. `Localspace`
6. `Station`
7. `Ship`
8. `ModuleInstance`
@@ -108,7 +108,6 @@ Recommended commander kinds:
- `station`
- `ship`
- `fleet`
- `sector`
- `task-group`
## System
@@ -124,40 +123,37 @@ Suggested fields:
- `nodeIds`
- `faction influence later`
## Node
## Anchor
A node is a meaningful location in system space that owns a local bubble.
An anchor is a meaningful location in a system that owns a localspace.
Suggested fields:
- `nodeId`
- `anchorId`
- `systemId`
- `kind`
- `systemPosition`
- `bubbleId`
- `parentNodeId?`
- `localspaceId`
- `parentAnchorId?`
- `orbital metadata?`
- `occupyingStructureId?`
- `constructionIds?`
Recommended node kinds:
Recommended anchor kinds:
- `star`
- `planet`
- `moon`
- `lagrange-point`
- `station`
- `gate`
- `resource-site`
- `structure`
- `resource-node`
## LocalBubble
## Localspace
A local bubble is the tactical simulation context attached to one node.
A localspace is the tactical simulation context attached to one anchor.
Suggested fields:
- `bubbleId`
- `nodeId`
- `localspaceId`
- `anchorId`
- `systemId`
- `radius`
- `occupantShipIds`
@@ -168,16 +164,16 @@ Suggested fields:
## Station
A station is a structure attached to a Lagrange-point node.
A station is a constructed structure that lives inside one localspace.
Suggested fields:
- `stationId`
- `ownerFactionId`
- `commanderId?`
- `nodeId`
- `anchorId`
- `systemId`
- `bubbleId`
- `localspaceId`
- `moduleIds`
- `inventory`
- `population`
@@ -231,7 +227,7 @@ Recommended host kinds:
## Claim
A claim is a vulnerable object placed at a Lagrange point before construction.
A claim is a vulnerable object placed at a valid construction anchor before construction.
Suggested fields:
@@ -239,8 +235,8 @@ Suggested fields:
- `ownerFactionId`
- `commanderId?`
- `systemId`
- `nodeId`
- `bubbleId`
- `anchorId`
- `localspaceId`
- `placedAt`
- `activatesAt`
- `state`
@@ -261,8 +257,8 @@ Suggested fields:
- `constructionSiteId`
- `ownerFactionId`
- `nodeId`
- `bubbleId`
- `anchorId`
- `localspaceId`
- `targetKind`
- `targetDefinitionId`
- `requiredItems`
@@ -354,12 +350,12 @@ Recommended ship spatial state fields:
- `spaceLayer`
- `currentSystemId`
- `currentNodeId?`
- `currentBubbleId?`
- `currentAnchorId?`
- `currentLocalspaceId?`
- `localPosition?`
- `systemPosition?`
- `movementRegime`
- `destinationNodeId?`
- `destinationAnchorId?`
- `transitState?`
Recommended space layers:
@@ -367,7 +363,7 @@ Recommended space layers:
- `universe-space`
- `galaxy-space`
- `system-space`
- `local-space`
- `localspace`
Recommended movement regimes:
@@ -466,7 +462,7 @@ The following rules should remain true unless deliberately revised:
## Relationship To Other Documents
- [SPACES.md](/home/jbourdon/repos/space-game/docs/SPACES.md)
- [UNIVERSE-MODEL.md](/home/jbourdon/repos/space-game/docs/UNIVERSE-MODEL.md)
- defines the layered world structure
- [COMMANDERS.md](/home/jbourdon/repos/space-game/docs/COMMANDERS.md)