# Database — Nimmerworld

PostgreSQL (`phoebe-{env}`) and ChromaDB (`iris-{env}`) schema content for nimmerworld.

## Schema architecture

nimmerworld claims tables prefixed `nimmerworld_*` in shared `phoebe-{env}` instances. See [`../conventions/development-conventions.md`](../conventions/development-conventions.md#database-conventions) for the per-domain table allocation overview.

## Sub-structure (planned)

```
database/
├── README.md                     # this file
├── schemas/
│   ├── phoebe/                   # PostgreSQL DDL per architectural domain
│   │   ├── runtime-engine/       # zones, slot-occupancy, emergent_signals, gesture-alignment
│   │   ├── identity-and-personhood/  # NPC trait-vectors, mods, mod-slots, mind-pool
│   │   ├── political-register/   # district_reports, imperial_*, memorialist_true_ledger
│   │   ├── narrative-composition/  # event_canon_summaries, world_canon, district_canon
│   │   └── inference-and-memory/ # player-LoRA backups, sharing-consent, base-model versions
│   └── iris/                     # ChromaDB collections for memory-vector storage
└── migrations/                   # schema-evolution migration scripts
```

## Status

⏳ **Stub** — [`../schemas/findings.md`](../schemas/findings.md) holds the v0.4 DDL drafts that will be progressively split per-domain into this directory as implementation begins.

> **Platform database conventions:** [`../../nimmerverse.eachpath.local/database/`](../../nimmerverse.eachpath.local/database/) (overview, schema patterns).

---

**Version:** 0.1 | **Created:** 2026-04-26 | **Updated:** 2026-04-26