- Move ASPICE docs to chanoraapp/docs submodule at docs/ - Move development docs to dev-docs/ (superpowers, offline-knowledge, impl-mapping) - Add AGENTS.md with project conventions for AI agents - Add impl-mapping.md (SAD component → source file mapping) - Archive completed plans to dev-docs/superpowers/plans/_archived/ - Remove AGENTS.md from .gitignore (now tracked)
41 lines
2.7 KiB
Markdown
41 lines
2.7 KiB
Markdown
# SAD Component → Source File Mapping
|
|
|
|
**Purpose:** Developer convenience mapping from ASPICE architecture components to source file locations. This is NOT an ASPICE document — it's a lookup for developers.
|
|
|
|
## Component Mapping
|
|
|
|
| SAD Component | Source Location |
|
|
|---|---|
|
|
| Flutter app shell | `apps/chanora_flutter/lib/main.dart`, services, widgets |
|
|
| Flutter service layer | `apps/chanora_flutter/lib/services/` |
|
|
| Flutter widget layer | `apps/chanora_flutter/lib/widgets/` |
|
|
| Bridge layer | `crates/chanora_bridge/src/api.rs`, `apps/chanora_flutter/lib/src/rust/` |
|
|
| Rust core | `core/chanora_core/src/lib.rs`, `events.rs`, `network_diagnostics.rs`, `ptt.rs` |
|
|
| Protocol adapter | `crates/chanora_protocol/src/` |
|
|
| State sync | `crates/chanora_state/src/lib.rs`, `channel_join.rs` |
|
|
| Audio subsystem | `crates/chanora_audio/src/` |
|
|
| Storage | `crates/chanora_storage/src/lib.rs` |
|
|
| Diagnostics | `crates/chanora_diagnostics/src/lib.rs` |
|
|
| Resolution and prefetch | `crates/chanora_resolver/src/lib.rs`, `crates/chanora_prefetch/src/lib.rs`, `prefetch_debouncer.dart` |
|
|
| Build and release hooks | `.github/workflows/`, `tools/`, platform project files |
|
|
|
|
## SDD Module Mapping
|
|
|
|
| SDD Module | Source Location |
|
|
|---|---|
|
|
| SDD-MOD-001 Flutter app bootstrap | `apps/chanora_flutter/lib/services/app_bootstrap.dart`, `main.dart` |
|
|
| SDD-MOD-002 Connect UI | `apps/chanora_flutter/lib/widgets/connect_widgets.dart` |
|
|
| SDD-MOD-003 Snapshot and channel UI | `snapshot_view.dart`, `snapshot_state_mapper.dart`, `channel_spacer.dart` |
|
|
| SDD-MOD-004 Chat UI | `chat_views.dart`, `bbcode_text.dart` |
|
|
| SDD-MOD-005 Voice UI | `voice_bar.dart`, `voice_compact.dart`, `voice_settings*.dart`, `voice_level_meter.dart`, `ptt_capability_badge.dart` |
|
|
| SDD-MOD-006 Platform services | `android_permissions_service.dart`, `ios_permissions_service.dart`, `audio_lifecycle_service.dart`, `back_intent_*`, `link_trust_service.dart` |
|
|
| SDD-MOD-007 Bridge API | `crates/chanora_bridge/src/api.rs`, generated Dart/Rust bridge files |
|
|
| SDD-MOD-008 Rust core supervisor | `core/chanora_core/src/lib.rs`, `events.rs`, `network_diagnostics.rs`, `ptt.rs` |
|
|
| SDD-MOD-009 Protocol adapter | `crates/chanora_protocol/src/` |
|
|
| SDD-MOD-010 State sync | `crates/chanora_state/src/lib.rs`, `channel_join.rs` |
|
|
| SDD-MOD-011 Audio subsystem | `crates/chanora_audio/src/` |
|
|
| SDD-MOD-012 Storage | `crates/chanora_storage/src/lib.rs` |
|
|
| SDD-MOD-013 Diagnostics | `crates/chanora_diagnostics/src/lib.rs` |
|
|
| SDD-MOD-014 Resolution and prefetch | `crates/chanora_resolver/src/lib.rs`, `crates/chanora_prefetch/src/lib.rs`, `prefetch_debouncer.dart` |
|
|
| SDD-MOD-015 Build and release hooks | `.github/workflows/`, `tools/`, platform project files |
|