- 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)
2.7 KiB
2.7 KiB
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 |