Files

T

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

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).

2026-05-14 21:02:16 +08:00

5.7 KiB

Raw Blame History

Documentation Path Migration Map

Document type: Configuration / Migration Map
Version: 0.9.3
Status: Baseline Candidate
Language: English
Product: Chanora
Repo path: docs/governance/path-migration-map.md

1. Purpose

This document maps the previous package-style filenames to the new repository documentation paths.

2. Migration Map

Previous package filename	New repo path
`CHANORA_SAD_ASPICE_SWE2_Software_Architecture_Description_v0.9.2.md`	`docs/architecture/sad.md`
`CHANORA_SDD_ASPICE_SWE3_Software_Detailed_Design_v0.9.2.md`	`docs/architecture/sdd.md`
`CHANORA_SYSDES_ASPICE_SYS3_System_Architectural_Design_v0.9.2.md`	`docs/architecture/sysdes.md`
`CHANORA_CFG_Baseline_Approval_Record_v0.9.2.md`	`docs/governance/baseline-approval-record.md`
`CHANORA_CFG_Baseline_Candidate_Validation_Report_v0.9.2.md`	`docs/governance/baseline-candidate-validation-report.md`
`CHANORA_CFG_Decision_Impact_Assessment_v0.9.2.md`	`docs/governance/decision-impact-assessment.md`
`CHANORA_CFG_Document_Index_v0.9.2.md`	`docs/governance/document-index.md`
`CHANORA_CFG_Document_Naming_Convention_v0.9.2.md`	`docs/governance/document-naming-convention.md`
`CHANORA_CFG_Document_Review_Report_v0.9.2.md`	`docs/governance/document-review-report.md`
`CHANORA_CFG_Git_Commit_Message_Convention_v0.9.2.md`	`docs/governance/git-commit-message-convention.md`
`CHANORA_CFG_Product_Decision_Register_v0.9.2.md`	`docs/governance/product-decision-register.md`
`CHANORA_CFG_Traceability_Matrix_v0.9.2.md`	`docs/governance/traceability-matrix.md`
`CHANORA_I18N_Localization_Architecture_v0.9.2.md`	`docs/i18n/localization-architecture.md`
`CHANORA_LEGAL_Trademark_And_Attribution_Review_v0.9.2.md`	`docs/legal/trademark-and-attribution-review.md`
`CHANORA_PRIV_Privacy_Policy_v0.9.2.md`	`docs/privacy/privacy-policy.md`
`CHANORA_REFS_ASPICE_SWE2_SWE3_Integration_Note_v0.9.2.md`	`docs/references/aspice-swe2-swe3-integration-note.md`
`CHANORA_CFG_External_References_v0.9.2.md`	`docs/references/external-references.md`
`CHANORA_REL_Platform_Release_Policy_v0.9.2.md`	`docs/release/platform-release-policy.md`
`CHANORA_REL_Release_Readiness_Go_NoGo_Record_v0.9.2.md`	`docs/release/release-readiness-go-nogo-record.md`
`CHANORA_SRS_ASPICE_SWE1_Software_Requirements_Specification_v0.9.2.md`	`docs/requirements/srs.md`
`CHANORA_SYSRS_System_Requirements_Specification_v0.9.2.md`	`docs/requirements/sysrs.md`
`CHANORA_SEC_Dependency_And_Supply_Chain_Report_v0.9.2.md`	`docs/security/dependency-and-supply-chain-report.md`
`CHANORA_SEC_Diagnostic_Redaction_Audit_Report_v0.9.2.md`	`docs/security/diagnostic-redaction-audit-report.md`
`CHANORA_SEC_Secure_Storage_Audit_Report_v0.9.2.md`	`docs/security/secure-storage-audit-report.md`
`CHANORA_SEC_Security_Privacy_Legal_Guideline_v0.9.2.md`	`docs/security/security-privacy-legal-guideline.md`
`CHANORA_SEC_Threat_Model_v0.9.2.md`	`docs/security/threat-model.md`
`CHANORA_UIUX_Adaptive_Layout_Platform_Guide_v0.9.2.md`	`docs/ui-ux/adaptive-layout-platform-guide.md`
`CHANORA_UIUX_Material3_Component_Catalog_v0.9.2.md`	`docs/ui-ux/material3-component-catalog.md`
`CHANORA_UIUX_Material3_Design_Tokens_v0.9.2.md`	`docs/ui-ux/material3-design-tokens.md`
`CHANORA_UIUX_Material3_Guideline_v0.9.2.md`	`docs/ui-ux/material3-guideline.md`
`CHANORA_VER_ASPICE_SWE4_Unit_Verification_Plan_v0.9.2.md`	`docs/verification/swe4-unit-verification-plan.md`
`CHANORA_VER_ASPICE_SWE5_Software_Integration_Verification_Plan_v0.9.2.md`	`docs/verification/swe5-software-integration-verification-plan.md`
`CHANORA_VER_ASPICE_SWE6_Software_Verification_Plan_v0.9.2.md`	`docs/verification/swe6-software-verification-plan.md`
`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. 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`.

5.7 KiB Raw Blame History