State 005 Learning Guide
Position In Learning Graph
- Previous state(s): 004-containerized-compose-runtime
- Dotted-line parent(s): none
- Next state(s): 006-messaging-nats-replacement
Convergence Metadata
- Convergence state:
no - Convergence level:
none - Lineage role:
canonical - Nearest previous convergence:
none - Nearest next convergence:
none
Rendered Code
- Generated branch: code/generated-state-005-postgres-database-replacement
- Authoring branch (spec source): main
Code Comparison With Previous State
- Compare against
004-containerized-compose-runtime: code/generated-state-004-containerized-compose-runtime...code/generated-state-005-postgres-database-replacement
Plain-English Code Delta
- Added: PostgreSQL runtime initialization pack (
postgres-init/initialSchema.sql) for deterministic baseline schema and seed data. - Added: Postgres-specific smoke checks (readiness + baseline data presence).
- Changed: Runtime database engine changes from H2 server process to PostgreSQL container.
- Changed: Service datasource wiring for:
- Changed:
account-service - Changed:
position-service - Changed:
trade-processor - Changed: Account sequence ID generation query changes to PostgreSQL sequence syntax.
Run This State
./scripts/start-state-005-postgres-database-replacement-generated.sh
Canonical Spec Links
- State spec pack: /specs/postgres-database-replacement
- Architecture: /specs/postgres-database-replacement/system/architecture
- Flows / topology: /specs/postgres-database-replacement/system/runtime-topology
- Research: link
- Data model: link
- Quickstart: link
- State ADR: link