EdisonJwa
61798e5bdf
- windows-p0-acceptance.md: bump auto-test row to reflect current Windows test count (126/0/1 — was 124/0/2 before the two new start_flips_armed_to_l2 tests landed). - document-index.md: new 0.9.6 row marking DEC-031 (missed-key-up watchdog disabled on P0) and the controlled status of docs/verification/windows-p0-acceptance.md.
247 lines
12 KiB
Markdown
247 lines
12 KiB
Markdown
# Windows P0 acceptance — human-must test cases (v1.0.0-rc.8)
|
||
|
||
This document captures the human-side verification pass for the
|
||
Windows P0 ship of Chanora. Automated tests (cargo + flutter
|
||
analyze + windows-smoke.cmd) sign off the mechanical side; this
|
||
checklist signs off the user-experience side. A failure on any
|
||
row blocks the rc.8 tag.
|
||
|
||
Source: this checklist supersedes the inline plan in the
|
||
conversation that produced the v1.0.0-rc.8 baseline. The auto-test
|
||
sign-off lives in this document's "Auto-test sign-off" section.
|
||
|
||
|
||
## 0. Pre-flight
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 0.1 | RDP into `100.84.219.45` as `admin` / `jkorisno1` | Desktop visible |
|
||
| 0.2 | Wipe stale install: delete `%LOCALAPPDATA%\app.chanora\` and `%APPDATA%\app.chanora\` if they exist | First-launch from clean state |
|
||
| 0.3 | Launch `C:\Users\admin\chanora\apps\chanora_flutter\build\windows\x64\runner\Release\chanora_flutter.exe` | Window opens, no crash |
|
||
| 0.4 | Open About / version label | Shows **`v1.0.0-rc.8`** (not rc.1) |
|
||
| 0.5 | Open `C:\Users\admin\AppData\Local\app.chanora\chanora_flutter\logs\chanora.log` | Contains `bridge initialised`, `log file path …`, `identity store initialised`, `bookmark store initialised`. File size <1 MB. |
|
||
|
||
|
||
## TC-1: Connect + identity persistence (DEC-006, SRS-201)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 1.1 | Enter `cn.teamspeak.app` (or your own test server), nickname, blank password | "Connect" button enabled |
|
||
| 1.2 | Click Connect | Server snapshot appears: channel tree on left, client list visible |
|
||
| 1.3 | Note the connected server name + the channel tree | Tree is sorted (parents above children); no duplicate roots |
|
||
| 1.4 | Disconnect, reconnect with the same nickname | Server-visible UID is the same as previous session (identity persisted) |
|
||
| 1.5 | Disconnect | Returns to connect form, no error |
|
||
|
||
|
||
## TC-2: Voice channel join (SRS-204, SDD-094)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 2.1 | After connecting, observe the UI | **No "Start audio" button anywhere** |
|
||
| 2.2 | Click a non-default voice channel in the tree | Voice Bar widget appears at top |
|
||
| 2.3 | Voice Bar shows: channel-name pill on left, speaker-mute + mic-mute on right, mode badge ("PTT"), capability badge — expected `L2GlobalHoldToTalk (raw-input)` or `L3GlobalWithMouseButtons (raw-input)` after a successful Raw Input register | All five visible; capability NOT `L0Focused` on this Win 11 host |
|
||
| 2.4 | Tap a different voice channel | Voice Bar's channel-name pill updates to the new channel; other clients see us move |
|
||
| 2.5 | There is **no** "Leave voice" button | TS3 model: you are always in *some* channel |
|
||
|
||
|
||
## TC-3: PTT mode press / release (SDD-088, SDD-096, SAD-083)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 3.1 | In a voice channel, click the gear "Voice settings" | Dialog opens with three mode radio rows (PTT selected, Voice activity disabled "Coming soon"), bind-key button, release-tail slider at 200 ms |
|
||
| 3.2 | Click "Bind PTT key", press Space, observe Captured value, click Save | "Captured: **Space**" (not blank); after Save the Voice Bar's PTT line reads **"PTT: Space"** + release tail value |
|
||
| 3.3 | Press and hold Space, watch the stats line | Within ~100 ms: **"Mic on"** appears; level meter goes active |
|
||
| 3.4 | Release Space | After ~200 ms: **"Mic off"** appears; level meter returns to idle |
|
||
| 3.5 | Repeat 3.3–3.4 ten times rapidly | Each press toggles Mic on/off; no stuck-on state |
|
||
| 3.6 | Hold Space for 60 seconds continuously while saying something | **Mic stays on the entire time** (watchdog is disabled per DEC-031; no mid-sentence cut-off) |
|
||
| 3.7 | Alt-tab to another application, press Space (no mouse focus on chanora) | Mic on toggles even though chanora is not focused (verifies L2/L3 global path); other clients hear you |
|
||
|
||
|
||
## TC-4: Release tail (SDD-096, SRS-206)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 4.1 | Open Voice settings, slide release tail to 0 ms, save | Slider shows "0 ms" |
|
||
| 4.2 | Hold Space briefly then release | "Mic off" appears within ~100 ms of release |
|
||
| 4.3 | Set release tail to 500 ms, save | Slider shows "500 ms" |
|
||
| 4.4 | Hold Space briefly then release | "Mic on" persists for ~500 ms after release, then "Mic off" |
|
||
| 4.5 | Set release tail back to 200 ms | Slider shows "200 ms" |
|
||
|
||
|
||
## TC-5: Continuous mode (SAD-083, SRS-205, regression: DEC-031)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 5.1 | Open Voice settings → select "Continuous" radio → Save | Mode badge reads "Continuous"; **no "PTT: …" line**; **no release-tail line**; **no capability badge** (all PTT-only surfaces hidden) |
|
||
| 5.2 | Observe the stats line | "Mic on" immediately and **stays on** indefinitely |
|
||
| 5.3 | Wait 60 seconds continuously | **Mic stays on** the whole time (the old bug — watchdog disabling Continuous after 30 s — must not reproduce) |
|
||
| 5.4 | Switch back to PTT mode | Mode badge reads "PTT: Space"; PTT-only lines reappear; Mic off (no key held) |
|
||
|
||
|
||
## TC-6: Mic mute toggle (SRS-207, regression: log spam)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 6.1 | In Continuous mode, click the mic-mute icon | Icon toggles to crossed-out; Mic shows off immediately |
|
||
| 6.2 | Have a second client check our status | Other client sees a microphone-off icon next to your nickname |
|
||
| 6.3 | Wait 30 seconds while muted, then check log file size | `chanora.log` stays <500 KB (no "Sending audio while muted" flood) |
|
||
| 6.4 | Click mic-mute again to unmute | Icon clears; Mic returns to on |
|
||
| 6.5 | In PTT mode with key held, click mic-mute | Mic immediately goes off mid-press; key release is ignored as long as muted |
|
||
| 6.6 | Unmute, key still held | Mic returns to on |
|
||
|
||
|
||
## TC-7: Speaker mute (server-broadcast)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 7.1 | Have a second client talk to you | You hear them |
|
||
| 7.2 | Click speaker-mute (headset icon) | Icon toggles; their voice is silent |
|
||
| 7.3 | Other client checks our status | They see a headset-off icon next to our nickname |
|
||
| 7.4 | Click speaker-mute again | Voice returns |
|
||
|
||
|
||
## TC-8: Binding persistence across restart (SDD-095)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 8.1 | Bind PTT to F10 → Save | Voice Bar shows "PTT: F10" |
|
||
| 8.2 | Close the app entirely | Window dismissed |
|
||
| 8.3 | Relaunch | Connect form appears |
|
||
| 8.4 | Connect + join a voice channel | Voice Bar shows **"PTT: F10"** (binding survived restart) |
|
||
| 8.5 | Press F10 | Mic on |
|
||
|
||
|
||
## TC-9: Binding before voice-join (SDD-094 follow-up)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 9.1 | Wipe storage again (steps 0.2) | Clean state |
|
||
| 9.2 | Launch, connect, but do not join a voice channel yet | Channel tree visible |
|
||
| 9.3 | Open Voice settings, bind a key, Save | No `audio not started` error |
|
||
| 9.4 | Join a voice channel | Voice Bar reflects the binding |
|
||
|
||
|
||
## TC-10: No-permission channel rejection (issue 3 from rc.7 review)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 10.1 | Identify a channel where your account lacks join permission | Server tree shows it as locked or similar |
|
||
| 10.2 | Tap it | After ~1.5 s, **red error banner** appears: "channel move rejected by server (no permission, wrong password, or channel full)" |
|
||
| 10.3 | Voice Bar's channel-name pill does **not** update | We did NOT join the channel locally |
|
||
| 10.4 | Other clients confirm we are NOT in the requested channel | Server-side reality matches the error banner |
|
||
|
||
|
||
## TC-11: Reconnect (real disconnect, not transient blip)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 11.1 | Connect, join a voice channel | Voice Bar visible |
|
||
| 11.2 | Force a hard disconnect (server-side kick, firewall block, or `nm-cli con down` on Linux RDP host) | UI shows red "Connection lost" banner with a spinning indicator and reconnect attempt counter |
|
||
| 11.3 | Restore network | Reconnect succeeds; voice channel rejoined automatically; banner disappears |
|
||
|
||
|
||
## TC-12: Diagnostic export + privacy (DEC-027)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 12.1 | Trigger a settings change (e.g. toggle mode) | Activity in log |
|
||
| 12.2 | Trigger the diagnostic export (if a button exists) or copy `%LOCALAPPDATA%\app.chanora\chanora_flutter\logs\chanora.log` | Multi-line text |
|
||
| 12.3 | Read it — privacy invariant | Contains `capability_level`, `backend_id`, `bound_input_class` (`keyboard` / `mouse-side-button`); **does NOT** contain any `vk`, `scan_code`, `keysym`, the actual key label, or any timing sequence of presses |
|
||
| 12.4 | File size at end of session | <5 MB (rotation: previous session is at `chanora.log.1`; the one before at `chanora.log.2`) |
|
||
|
||
|
||
## TC-13: PTT bind dialog labels (regression)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 13.1 | Open binding dialog | Initial state: "Captured: " is blank or shows a placeholder |
|
||
| 13.2 | Press Space | "Captured: **Space**" (not blank — the rc.7 regression) |
|
||
| 13.3 | Press Enter | "Captured: Enter" |
|
||
| 13.4 | Press Tab | "Captured: Tab" |
|
||
| 13.5 | Press A | "Captured: A" |
|
||
| 13.6 | Press F12 | "Captured: F12" |
|
||
| 13.7 | Press Shift alone | Captured field unchanged (modifier-only press ignored) |
|
||
| 13.8 | Press a mouse side button (Mouse4 / Back) | "Captured: mouse-side-button:8" |
|
||
|
||
|
||
## TC-14: Capability badge gating
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 14.1 | In PTT mode | Capability badge visible (`L2GlobalHoldToTalk (raw-input)` or similar) |
|
||
| 14.2 | Switch to Continuous mode | **Capability badge disappears** (no info-icon, no level label) |
|
||
| 14.3 | Switch to "Voice activity (coming soon)" | Cannot select (disabled); confirms the radio row is non-interactive |
|
||
|
||
|
||
## TC-15: Indicator label (regression)
|
||
|
||
| # | Step | Expected |
|
||
|---|---|---|
|
||
| 15.1 | In any mode, look at the stats line | Reads "Mic on" / "Mic off" (mode-neutral); **not** "PTT on" / "PTT off" |
|
||
|
||
|
||
## Auto-test sign-off
|
||
|
||
These rows do not require human interaction. The values are filled
|
||
in from CI / local invocation.
|
||
|
||
| Layer | Result on Linux | Result on Korean Win 11 |
|
||
|---|---|---|
|
||
| `cargo check --workspace` | clean | clean |
|
||
| `cargo test --workspace --lib` | 80 / 0 / 3 | 126 / 0 / 1 |
|
||
| `flutter analyze` | clean (6 pre-existing Radio.groupValue infos) | n/a |
|
||
| `python3 tools/validate_docs.py` | strict layered sourcing OK; pre-existing 35-filename warning | n/a |
|
||
| `tools/windows-smoke.cmd` | n/a | exit 0 |
|
||
|
||
The Windows host runs 44 more tests than Linux because of the
|
||
`#[cfg(target_os = "windows")]`-gated PTT-backend, dispatcher, and
|
||
full-chain tests in `crates/chanora_audio/src/ptt_backends/windows.rs`
|
||
and `core/chanora_core/src/ptt.rs::windows_full_chain_tests`.
|
||
|
||
|
||
## Sign-off form
|
||
|
||
```
|
||
chanora v1.0.0-rc.8 — Windows P0 acceptance
|
||
Host: Korean Win 11 (HP LAPTOP-37KAQO05, ko-KR locale)
|
||
Tester: ______________________
|
||
Date: ______________________
|
||
Build: chanora_flutter.exe @ ______________________
|
||
chanora_bridge.dll @ ______________________
|
||
data\app.so @ ______________________
|
||
|
||
TC-1 Connect + identity persistence [ pass / fail ] notes:
|
||
TC-2 Voice channel join [ pass / fail ] notes:
|
||
TC-3 PTT press / release [ pass / fail ] notes:
|
||
TC-4 Release tail [ pass / fail ] notes:
|
||
TC-5 Continuous mode [ pass / fail ] notes:
|
||
TC-6 Mic mute [ pass / fail ] notes:
|
||
TC-7 Speaker mute [ pass / fail ] notes:
|
||
TC-8 Binding persistence across restart [ pass / fail ] notes:
|
||
TC-9 Binding before voice-join [ pass / fail ] notes:
|
||
TC-10 No-permission channel rejection [ pass / fail ] notes:
|
||
TC-11 Reconnect [ pass / fail ] notes:
|
||
TC-12 Diagnostic export + privacy [ pass / fail ] notes:
|
||
TC-13 PTT bind dialog labels [ pass / fail ] notes:
|
||
TC-14 Capability badge gating [ pass / fail ] notes:
|
||
TC-15 Indicator label [ pass / fail ] notes:
|
||
|
||
Overall result: [ rc.8 PASS / rc.8 FAIL ]
|
||
Sign: ______________________
|
||
```
|
||
|
||
|
||
## Known gaps (not blockers)
|
||
|
||
- **macOS / iOS / Linux** P0 acceptance is NOT covered here; this
|
||
document is Windows-only. Tagging rc.8 ships Linux from a separate
|
||
pass and remains Windows-gated for macOS / iOS / Android.
|
||
- **VAD** (`TransmitMode::VoiceActivity`) is intentionally disabled
|
||
per DEC-030 (deferred to P1). UI shows it as a "Coming soon" radio
|
||
row.
|
||
- **Missed-key-up watchdog** is disabled on P0 per DEC-031 (long PTT
|
||
speech would have been cut off at 30 s). P1 reintroduces a
|
||
redesigned variant.
|
||
- **Audio level meter** is binary (`pttActive` only). Real RMS meter
|
||
is a P1 follow-up.
|