3 Commits

Author	SHA1	Message	Date
Siavash Sameni	a5c00fe5cb	docs: add BRANCH-desktop-audio-rewrite.md and update ARCH/ADMIN/USER_GUIDE ... Documents the feat/desktop-audio-rewrite branch story end-to-end: - Purpose: shared codebase with android-rewrite via Tauri, platform- specific audio backends via target-dep sections + feature flags - Audio backend matrix: CPAL baseline + macOS VPIO + Windows WASAPI AudioCategory_Communications - Recent work: desktop direct calling feature with history dedup, macOS VPIO integration, Windows cross-compile via cargo-xwin, the libopus/clang-cl vendored audiopus_sys fix, icon.ico generation, and the WASAPI communications capture backend (task #24) - Build pipelines: native cargo on macOS/Linux, Docker on SepehrHomeserverdk for Windows, Hetzner Cloud alternative - Testing procedures for direct calling parity and Windows AEC A/B - Known quirks: vendor path relative, cargo-xwin override.cmake clobber, WebView2 runtime prerequisite, 2024 edition unsafe lint warnings Also appends shared-doc sections (identical on both branches): - ARCHITECTURE.md: "Audio Backend Architecture (Platform Matrix)" - ADMINISTRATION.md: "Build Pipelines" - USER_GUIDE.md: "Direct 1:1 Calling" and "Windows AEC Variants" Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-10 15:20:21 +04:00
Siavash Sameni	54a4d91f3e	docs: add --event-log, --version-check, and federation troubleshooting to admin guide ... Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-09 04:43:37 +04:00
Siavash Sameni	d9b2e0fd53	docs: comprehensive documentation — design, architecture, admin, user guide ... 4 files, 2,511 lines covering the entire WarzonePhone project: DESIGN.md (591 lines): system overview, codec system (9 variants), FEC (RaptorQ), transport (QUIC/quinn), security (Ed25519/X25519/ ChaCha20/HKDF/BIP39/TOFU), federation (global rooms), jitter buffer. Mermaid diagrams for audio pipelines and crate dependencies. ARCHITECTURE.md (874 lines): 15 mermaid diagrams — system overview, encode/decode pipelines, relay SFU, federation topology/protocol, signal handshake, client architectures (desktop/android/CLI), wire format tables (MediaHeader/MiniHeader/QualityReport), project tree. ADMINISTRATION.md (587 lines): relay deployment (binary/Docker/systemd), complete TOML config reference, CLI flags table, federation setup (peers/trusted/global_rooms), 3 example configs, Prometheus metrics, auth, identity persistence, 12-item troubleshooting guide. USER_GUIDE.md (459 lines): all clients — desktop (settings, quality slider, key warning, shortcuts), Android (8-level quality slider, server management, identity backup), CLI (flags table, 8 usage patterns). Identity system, quality profiles when-to-use guide. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-08 08:21:13 +04:00