English is the language of most repository docs. Chinese overviews: root README.zh.md, architecture analysis architecture/current-architecture.zh.md.
| Area | Description |
|---|---|
| architecture/ | Runtime: processes, dual DB, shards, record / calc |
| modules/ | Code layout by domain package |
| roadmap.md | Not in this version (import pack, plugins, graph, ENUM, RBAC, …) |
| ops/production-checklist.md | Production deploy checklist (Phase-1) |
| Doc | Description |
|---|---|
| architecture/current-architecture.zh.md | 当前架构分析（中文）：拓扑、双库、record/calc、事件、命名与取舍（不含 RBAC） |
| architecture/system.md | Current system: processes, dual DB, pgx tenancy, record/calc, Playground |
| architecture/analysis.md | Layers, data flow, trade-offs |
| architecture/tenant-isolation.md | Isolation: tenant, data_dsn, record_store |
| architecture/virtual-records.md | Tenant shards, unified record table, indexes (record evolved from virtual_records) |
| architecture/record-calc.md | record.data jsonb + link_ref + calc_queue |