EdisonJwa
6d094f3dbe
New controlled document docs/verification/ipad-p0-acceptance.md
extends iOS P0 coverage to iPad. The build artefact is identical
to iPhone — `TARGETED_DEVICE_FAMILY = "1,2"` in
ios/Runner.xcodeproj/project.pbxproj is the Universal family, so
the same Runner.app installs on iPad with the same personal-team
provisioning profile.
15-row checklist mirrors ios-p0-acceptance.md TC-1..TC-12 and adds
three iPad-specific rows:
TC-13 wide-mode landscape layout — iPad in landscape is well
above the 840 dp LayoutBuilder breakpoint shipped in
apps/chanora_flutter/lib/main.dart, so the connected view
splits into a 320 dp left column (banner + Voice Bar) plus
an expanding channel tree. Portrait rotation collapses
back to the stacked iPhone layout. Long channel-name pills
still ellipsize per the earlier voice_bar.dart fix.
TC-14 Split View / Slide Over no-crash — Apple iPad multitasking
is intentionally unsupported in P0. UIApplicationSupports\
MultipleScenes stays false. This row asserts the app does
not crash when iPadOS tries to host it in Split View; the
actual multi-scene wiring is P1.
TC-15 AirPlay 2 audio route — verifies AVAudioSession routing
honours an AirPlay 2 destination picked via Control
Center, and routes back cleanly when iPad is reselected.
docs/governance/document-index.md
Bumped to 0.9.9 with the change-history row noting the iPad
acceptance doc. No spec items added; DEC-025 was originally
iPhone-only for the mobile target and this row formally
extends P0 coverage to iPad within the same iOS toolchain.
python3 tools/validate_docs.py: clean (pre-existing 35-filename
[FAIL] retained, unchanged).
94 lines
6.6 KiB
Markdown
94 lines
6.6 KiB
Markdown
# Document Index
|
|
|
|
**Document type:** Configuration / Documentation Control
|
|
**Version:** 0.9.9
|
|
**Status:** Baseline Candidate
|
|
**Language:** English
|
|
**Product:** Chanora
|
|
**Repo path:** `docs/governance/document-index.md`
|
|
|
|
---
|
|
|
|
## 1. Purpose
|
|
|
|
This document lists the normalized latest files included in the Chanora repository documentation package.
|
|
|
|
## 2. Current Baseline Candidate Files
|
|
|
|
| File | Status |
|
|
|---|---|
|
|
| `docs/architecture/sad.md` | Baseline Candidate |
|
|
| `docs/architecture/sdd.md` | Baseline Candidate |
|
|
| `docs/architecture/sysdes.md` | Baseline Candidate |
|
|
| `docs/architecture/desktop-ptt-architecture.md` | Baseline Candidate |
|
|
| `docs/governance/baseline-approval-record.md` | Baseline Candidate |
|
|
| `docs/governance/baseline-candidate-validation-report.md` | Baseline Candidate |
|
|
| `docs/governance/decision-impact-assessment.md` | Baseline Candidate |
|
|
| `docs/governance/document-naming-convention.md` | Baseline Candidate |
|
|
| `docs/governance/document-review-report.md` | Baseline Candidate |
|
|
| `docs/governance/git-commit-message-convention.md` | Baseline Candidate |
|
|
| `docs/governance/path-migration-map.md` | Baseline Candidate |
|
|
| `docs/governance/product-decision-register.md` | Baseline Candidate |
|
|
| `docs/governance/repo-format-validation-report.md` | Baseline Candidate |
|
|
| `docs/governance/traceability-matrix.md` | Baseline Candidate |
|
|
| `docs/i18n/localization-architecture.md` | Baseline Candidate |
|
|
| `docs/legal/trademark-and-attribution-review.md` | Baseline Candidate |
|
|
| `docs/privacy/privacy-policy.md` | Baseline Candidate |
|
|
| `docs/references/aspice-swe2-swe3-integration-note.md` | Baseline Candidate |
|
|
| `docs/references/external-references.md` | Baseline Candidate |
|
|
| `docs/release/platform-release-policy.md` | Baseline Candidate |
|
|
| `docs/release/release-readiness-go-nogo-record.md` | Baseline Candidate |
|
|
| `docs/requirements/srs.md` | Baseline Candidate |
|
|
| `docs/requirements/sysrs.md` | Baseline Candidate |
|
|
| `docs/security/dependency-and-supply-chain-report.md` | Baseline Candidate |
|
|
| `docs/security/diagnostic-redaction-audit-report.md` | Baseline Candidate |
|
|
| `docs/security/secure-storage-audit-report.md` | Baseline Candidate |
|
|
| `docs/security/security-privacy-legal-guideline.md` | Baseline Candidate |
|
|
| `docs/security/threat-model.md` | Baseline Candidate |
|
|
| `docs/ui-ux/adaptive-layout-platform-guide.md` | Baseline Candidate |
|
|
| `docs/ui-ux/material3-component-catalog.md` | Baseline Candidate |
|
|
| `docs/ui-ux/material3-design-tokens.md` | Baseline Candidate |
|
|
| `docs/ui-ux/material3-guideline.md` | Baseline Candidate |
|
|
| `docs/verification/swe4-unit-verification-plan.md` | Baseline Candidate |
|
|
| `docs/verification/swe5-software-integration-verification-plan.md` | Baseline Candidate |
|
|
| `docs/verification/swe6-software-verification-plan.md` | Baseline Candidate |
|
|
| `docs/verification/sys4-system-integration-verification-plan.md` | Baseline Candidate |
|
|
| `docs/verification/verification-master-plan.md` | Baseline Candidate |
|
|
|
|
## 3. Core Engineering Hierarchy
|
|
|
|
```text
|
|
SysRS -> SysDes -> SRS -> SAD -> SDD
|
|
```
|
|
|
|
## 4. Verification Work Product Mapping
|
|
|
|
```text
|
|
SDD -> SWE.4
|
|
SAD + SDD -> SWE.5
|
|
SRS -> SWE.6
|
|
SysDes -> SYS.4
|
|
```
|
|
|
|
## 5. Repo File Naming Rules
|
|
|
|
| Rule | Decision |
|
|
|---|---|
|
|
| Product prefix in file names | Not used under `docs/` |
|
|
| Case style | lowercase kebab-case |
|
|
| Version in file name | Not used |
|
|
| Version location | Inside document metadata |
|
|
| Release package version | Used in ZIP/package name |
|
|
|
|
## 6. Change History
|
|
|
|
| Version | Date | Description |
|
|
|---|---|---|
|
|
| 0.9.2 | 2026-05-14 | Converted documentation package to repository-oriented docs folder structure and updated internal filename references. |
|
|
| 0.9.3 | 2026-05-15 | Added `docs/architecture/desktop-ptt-architecture.md` to the controlled document set. |
|
|
| 0.9.5 | 2026-05-15 | Bumped controlled-set version to 0.9.5 for the v1 audio + PTT lifecycle refactor: SysRS-303..304, SysDes-149..151, SRS-204..207, SAD-081..083, SDD-094..097, and two new governance decisions DEC-029 (Flutter global-hotkey packages rejected for PTT) and DEC-030 (Voice Activity Detection deferred to P1). No controlled files added or removed; existing files updated in place under strict layered sourcing. |
|
|
| 0.9.6 | 2026-05-16 | Added DEC-031 (missed-key-up watchdog disabled on P0; redesign deferred to P1) and new controlled document `docs/verification/windows-p0-acceptance.md` carrying the 15-row human-must acceptance plan for the v1.0.0-rc.8 Windows ship. No spec items added; DEC-028 retained as historical context, superseded by DEC-031 for the v1 ship. |
|
|
| 0.9.7 | 2026-05-16 | Added controlled document `docs/verification/linux-p0-acceptance.md` carrying the 15-row human-must acceptance plan for the v1.0.0-rc.8 Linux (GNOME on Wayland) ship. Auto-test sign-off rows filled from the Arch host `100.74.219.114` verification pass: `cargo check --workspace --release` clean, `cargo test --workspace --lib` 78 / 0 / 1, `cargo test -p chanora_audio --test linux_portal_smoke -- --ignored` 1 / 0, `cargo test -p chanora_audio --test ptt_privacy` 1 / 0. No spec items added; the existing SDD-086 GNOME-Wayland portal backend is what this document signs off. |
|
|
| 0.9.8 | 2026-05-16 | Added controlled documents `docs/verification/macos-p0-acceptance.md` (15-row checklist for Apple Silicon macOS, SDD-085 CGEventTap backend now fully live with IOHIDCheckAccess + CGEventTapCreate + per-1.5s permission watcher) and `docs/verification/ios-p0-acceptance.md` (12-row checklist for physical iPhone via the free Apple Personal Team, SDD-094..097 audio lifecycle, AVAudioSession `.playAndRecord/.voiceChat` configured Swift-side in AppDelegate). The macOS PTT backend descriptor advertises L2/L3 only when Input Monitoring is granted, otherwise L0Focused per SRS-198 honest capability advertising. iOS PTT is L0Focused by design (DEC-025 explicitly does not pursue a global PTT analogue on iOS). No new spec items. |
|
|
| 0.9.9 | 2026-05-16 | Added controlled document `docs/verification/ipad-p0-acceptance.md` carrying the 15-row checklist for iPad P0 sign-off (same TS-3.3 reach, three iPad-specific rows: wide-mode landscape layout under the existing 840 dp LayoutBuilder breakpoint, Split View / Slide Over no-crash assertion since `UIApplicationSupportsMultipleScenes` stays `false` in P0, and AirPlay 2 audio routing). The iPad build artefact is the **same** `Runner.app` produced for iPhone — `TARGETED_DEVICE_FAMILY = "1,2"` in `ios/Runner.xcodeproj/project.pbxproj` is the Universal family. DEC-025 was originally iPhone-only for the mobile target; this row formally extends P0 coverage to iPad (still within the same iOS toolchain, no new Rust or Flutter code). No spec items added. |
|