edison/chanora
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(governance): record product scaffolding paths (DEC-022)

Browse Source 
Updates two documents to reflect the workspace + Flutter app
scaffold landed in the previous commit.

path-migration-map.md v0.9.2 -> v0.9.3:
  Adds §3 Implementation Path Layout. Lists each subsystem's
  canonical crate path alongside its SAD / SysDes / DEC authority.
  Notes that the Flutter app is owned by Flutter tooling and is
  not a Cargo workspace member.

CHANGELOG entry under [Unreleased]:
  - Documents the seven new Cargo workspace members and the
    invariants pinned at the workspace level.
  - Documents the Flutter app scaffold, the DEC-004 minSdk = 28
    override, and the DEC-015 English + Simplified Chinese ARB
    catalogue (with the ADR-008 server-content reaffirmation).
  - Records the empirical verification (cargo check + cargo test
    + flutter analyze + flutter test all clean).
This commit is contained in:
EdisonJwa
2026-05-14 21:02:16 +08:00
parent 974dda9601
commit e0f34009d9
2 changed files with 80 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/governance/path-migration-map.md
+26 -2
View File
@@ -1,7 +1,7 @@
# Documentation Path Migration Map
**Document type:** Configuration / Migration Map
**Version:** 0.9.2
**Version:** 0.9.3
**Status:** Baseline Candidate
**Language:** English
**Product:** Chanora
@@ -53,8 +53,32 @@ This document maps the previous package-style filenames to the new repository do
| `CHANORA_VER_ASPICE_SYS4_System_Integration_Verification_Plan_v0.9.2.md` | `docs/verification/sys4-system-integration-verification-plan.md` |
| `CHANORA_VER_Master_Plan_v0.9.2.md` | `docs/verification/verification-master-plan.md` |
## 3. Change History
## 3. Implementation Path Layout (DEC-022)
The canonical implementation directory layout was adopted as DEC-022
(register v0.9.5) and matches the README's sketch + SAD §7.2 module
decomposition. Implementation paths are listed here for traceability
alongside the documentation paths above.
| Logical role | Repo path | Authority |
|---|---|---|
| Flutter application | `apps/chanora_flutter/` | SAD §7.1, DEC-022 |
| Rust orchestration / top-level API | `core/chanora_core/` | SAD §7.2 |
| Protocol adapter (tsclientlib isolation) | `crates/chanora_protocol/` | SAD §7.2, SAD-067, SysDes-011/029 |
| State synchronisation | `crates/chanora_state/` | SAD §7.2 |
| Audio subsystem | `crates/chanora_audio/` | SAD §7.2, DEC-011, DEC-011.1 |
| Storage (non-secret DB + platform secure store) | `crates/chanora_storage/` | SAD §7.2, SAD-067, DEC-013, DEC-013.1, DEC-013.2 |
| Diagnostics (logs, redaction, export) | `crates/chanora_diagnostics/` | SAD §7.2, DEC-016, DEC-017 |
| Typed Flutter/Rust bridge | `crates/chanora_bridge/` | SAD §7.2, DEC-014, SDD-079, SAD-068 |
The Cargo workspace is declared at the repository root (`Cargo.toml`).
The Flutter application is **not** a Cargo workspace member; it is
owned by Flutter / Gradle / Xcode tooling and listed under the
workspace's `exclude` array along with the `poc/` spike directories.
## 4. Change History
| Version | Date | Description |
|---|---|---|
| 0.9.2 | 2026-05-14 | Initial migration map from package filenames to repo docs paths. |
| 0.9.3 | 2026-05-14 | Added §3 Implementation Path Layout recording the DEC-022 directory adoption (apps/, core/, crates/) as the workspace was first scaffolded on `product/scaffold-v0`. |