Task: Rewrite system model with layer blurbs and component tables
This page documents a task in the System model readability story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Transform `projects/modeling/system_model.org` from a flat component inventory into a readable architecture document. Add a narrative introduction, four layer blurbs, and table-based component inventories.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | System model readability |
| Now | Complete. |
| Waiting on | Nothing. |
| Next | None. |
| Last touched | 2026-05-26 |
Acceptance
- System model has a narrative intro explaining the four-layer architecture and dependency direction.
- Each layer has a 1–2 paragraph blurb describing its role and contents.
- Component inventories use tables (Component | Description | Depends On).
- Database Isolation section is preserved unchanged.
Plan
(Transient implementation strategy. Written when work starts;
distilled into the parent story's * Decisions and cleared when the
task closes. Plans do not outlive their task.)
Notes
PRs
| PR | Title |
|---|---|
| 862 | [doc] Rewrite system model with narrative, layer blurbs, and component tables |
Review
| # | Comment summary | File | Decision | Notes |
|---|---|---|---|---|
| 1 | Missing ores.service | system_model.org | Applied | Added with UUID 9CFAC175 (Infrastructure) |
| 2 | Missing ores.analytics, ores.storage | system_model.org | Applied | Added with original UUIDs (Domain) |
| 3 | Missing ores.shell | system_model.org | Applied | Added with UUID D0876A24 (Application) |
| 4 | Dependency order row in Foundation table | system_model.org | Applied | Moved outside table as standalone paragraph |
| 5 | ores.http.server lost ID link | system_model.org | Declined | New entry — no UUID exists in original |