Adatmodell — áttekintés

A Craftingtable-nek nincs hagyományos adatbázisa — a kanonikus JSON-fájlok maguk a forrás, a SQLite csak egy bármikor eldobható index. A models/ írja le a tartalmat, a db/ azt, hogy ez hogyan él a lemezen és a keresőindexben.

A 18 logikai modell

Modell	Szint	DB-táblázat	Scope
project	Cross-cutting	nincs (memóriában)	✅ v1
business-case	L1	entities	✅ v1
user-story	L2	entities	✅ v1
screen	L3	entities	✅ v1
flow-node	L3 (canvas)	entities	⚠️ v1.1
structure-node	Structure	entities	✅ v1
schema-model	Schema	entities	✅ v1
schema-api	Schema	entities	⚠️ v1.1+
design-token	Design	nincs (nem indexelt)	✅ v1 (szűkített)
design-component	Design	entities	✅ v1 (szűkített)
skill	Skills	entities	✅ v1
work-package	Generate	saját tasks tábla	✅ v1
settings	Cross-cutting	nincs (nem indexelt)	✅ v1
license-entitlement	Cross-cutting	nincs (nem fájl)	✅ v1
snapshot	Cross-cutting	nincs (nem indexelt)	✅ v1
manifest	Cross-cutting	nincs (a forrás, amivel az index magát ellenőrzi)	✅ v1
entity-revision	—	saját entity_revisions tábla	✅ v1
full-export	—	nincs (a ZIP maga a tartalom)	✅ v1

Blueprint / Block / Part / Tweak — a blueprint/blueprint.go domain-csomagban él, blueprints/BP-*.json fájlokban; a fenti táblázat a schema/models/ doksi-készletét tükrözi, ami külön kezeli a Blueprint-réteget (lásd Blueprints).

Perzisztencia-réteg

• Kanonikus JSON + Markdown = SSoT (lásd A .craftingtable/ mappa).
• SQLite index = derivált, bármikor újraépíthető (lásd SQLite index).
• entity_revisions — entitás-szintű, git-független, timestampezett revíziótörténet, revert-lehetőséggel.