Transcriptie 15 — platformsetup, eind-tot-eindproeven en releasebewijs #2523

Closed
opened 2026-10-22 19:55:52 +00:00 by brenno · 1 comment
Owner

Bovenliggend epic: #2508
Afhankelijk van: #2509, #2510, #2511, #2512, #2513, #2514, #2515, #2516, #2517, #2518, #2519, #2520, #2521, #2522, #2524, #2525, #2526, #2527, #2528, #2529, #2530, #2531, #2538, #2545, #2546, #2547, #2548

Gebruikersdoel

Op ieder geleverd platform kan ik zonder ontwikkelaarskennis vaststellen wat ik moet installeren of toestaan, een opname/transcript maken, problemen oplossen en mijn bestanden terugvinden.

Afhankelijkheid en werk

Na alle functionele tickets. Maak één onderhouden setupmatrix plus stapsgewijze gids voor macOS, Windows, Linux en web, vanuit de werkelijk geteste releasebundels; registreer die in OciDeck's documentatielezer en vertalingen. Noem Android/iOS alleen als niet-geleverde targets zolang er geen release voor bestaat.

  • Per platform: ondersteunde OS/browser/architectuur, installatie van model/runtime, downloadomvang en licentie, mic-/screenrechten, fysieke/virtuele bronkeuze, headset/Bluetooth, online-callgeluid, model-/geheugen-/schijfruimtegrens, opslag/backup/wissen, foutdiagnose en herstel.
  • Documenteer verschillen tussen gewone lokale opname en provider-/deelnemerstoestemming; geen claim dat OciDeck een Teams/Jitsi-client is of dat elk beschermd audiokanaal op te nemen valt.
  • Bouw een release-testmatrix met schone installatie en echte hardware: bestaand bestand, mic, online gespreksgeluid indien beschikbaar, live+final, cancel, afwijzing, bronverlies, volle schijf/quota, offline werken, heropenen/export/wissen, toegankelijkheid en geen ongevraagd netwerkverkeer.
  • Werk USER_GUIDE, SOURCE_MAP, ARCHITECTURE, PRIVACY, KNOWN_LIMITATIONS, SBOM/licenties, pakket-/web-CSP-controles en vertalingen bij. Run de repository-native pinned poorten, daarna platformrooktesten; controleer CI tot terminale status volgens de afgesproken PR-werkwijze.

Aanvulling: serverconfiguratie per platform

Documenteer voor macOS, Windows, Linux en web: eigen/externe HTTPS-server instellen, ondersteund API-contract en voorbeeldimplementatie, authenticatie, TLS, CORS/preflight, browser-LAN-rechten, bereikbaarheid, limieten/kosten, serverbewaring, stop/foutdiagnose en lokale versus serverprivacy. Test offline/lokaal, batchremote en live remote apart; controleer in browsernetwerkinspectie de werkelijke audiobestemming. Zie #2524 en #2525.

Voorbeeldsetup die de gids moet toetsen

Gebruik whisper.cpp whisper-server als mogelijke zelf gehoste batchimplementatie; documenteer dat directe publieke blootstelling zonder passende TLS/auth/CORS-laag niet de beoogde setup is. Een live-server vraagt een afzonderlijk bewezen protocol.

Aanvulling: in-app callproef

Test een echte meerdeelnemerscall vanuit OciDeck los van een call in een externe app: eigen/remote audio, mute, trackverlies, provideropnamebeleid, tab-/presentatiewissel, stoppen/leave, lokale en gekozen servertranscriptie. Documenteer welke adapters dit werkelijk ondersteunen; zie #2526.

Acceptatie

  • Elke positieve claim in de capability-matrix heeft een met OS/browser, model en releaseartefact benoemde echte proef; ontbrekende hardware staat als niet getest.
  • De gids loopt vanaf Uitbreidingen tot opgeslagen .md plus audio en bevat herstelstappen voor alle detectiefouten.
  • Nieuwe documentpagina's zijn volgens de docs-registratiepoort in de app vindbaar; alle zichtbare tekst is vertaald.
  • Geen releaseclaim zolang een verplicht platformpad onbewezen of stuk is; baseline- en featurefouten worden apart gerapporteerd.

Bronnen

OciDeck docs/BUILD.md, docs/KNOWN_LIMITATIONS.md, docs/PRIVACY.md, docs/SOURCE_MAP.md.

**Bovenliggend epic:** [#2508](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2508) **Afhankelijk van:** [#2509](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2509), [#2510](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2510), [#2511](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2511), [#2512](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2512), [#2513](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2513), [#2514](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2514), [#2515](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2515), [#2516](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2516), [#2517](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2517), [#2518](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2518), [#2519](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2519), [#2520](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2520), [#2521](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2521), [#2522](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2522), [#2524](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2524), [#2525](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2525), [#2526](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2526), [#2527](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2527), [#2528](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2528), [#2529](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2529), [#2530](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2530), [#2531](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2531), [#2538](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2538), [#2545](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2545), [#2546](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2546), [#2547](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2547), [#2548](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2548) ## Gebruikersdoel Op ieder geleverd platform kan ik zonder ontwikkelaarskennis vaststellen wat ik moet installeren of toestaan, een opname/transcript maken, problemen oplossen en mijn bestanden terugvinden. ## Afhankelijkheid en werk Na alle functionele tickets. Maak één onderhouden setupmatrix plus stapsgewijze gids voor macOS, Windows, Linux en web, vanuit de werkelijk geteste releasebundels; registreer die in OciDeck's documentatielezer en vertalingen. Noem Android/iOS alleen als niet-geleverde targets zolang er geen release voor bestaat. - Per platform: ondersteunde OS/browser/architectuur, installatie van model/runtime, downloadomvang en licentie, mic-/screenrechten, fysieke/virtuele bronkeuze, headset/Bluetooth, online-callgeluid, model-/geheugen-/schijfruimtegrens, opslag/backup/wissen, foutdiagnose en herstel. - Documenteer verschillen tussen gewone lokale opname en provider-/deelnemerstoestemming; geen claim dat OciDeck een Teams/Jitsi-client is of dat elk beschermd audiokanaal op te nemen valt. - Bouw een release-testmatrix met schone installatie en echte hardware: bestaand bestand, mic, online gespreksgeluid indien beschikbaar, live+final, cancel, afwijzing, bronverlies, volle schijf/quota, offline werken, heropenen/export/wissen, toegankelijkheid en geen ongevraagd netwerkverkeer. - Werk `USER_GUIDE`, `SOURCE_MAP`, `ARCHITECTURE`, `PRIVACY`, `KNOWN_LIMITATIONS`, SBOM/licenties, pakket-/web-CSP-controles en vertalingen bij. Run de repository-native pinned poorten, daarna platformrooktesten; controleer CI tot terminale status volgens de afgesproken PR-werkwijze. ## Aanvulling: serverconfiguratie per platform Documenteer voor macOS, Windows, Linux en web: eigen/externe HTTPS-server instellen, ondersteund API-contract en voorbeeldimplementatie, authenticatie, TLS, CORS/preflight, browser-LAN-rechten, bereikbaarheid, limieten/kosten, serverbewaring, stop/foutdiagnose en lokale versus serverprivacy. Test offline/lokaal, batchremote en live remote apart; controleer in browsernetwerkinspectie de werkelijke audiobestemming. Zie [#2524](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2524) en [#2525](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2525). ## Voorbeeldsetup die de gids moet toetsen Gebruik whisper.cpp `whisper-server` als mogelijke zelf gehoste batchimplementatie; documenteer dat directe publieke blootstelling zonder passende TLS/auth/CORS-laag niet de beoogde setup is. Een live-server vraagt een afzonderlijk bewezen protocol. ## Aanvulling: in-app callproef Test een echte meerdeelnemerscall vanuit OciDeck los van een call in een externe app: eigen/remote audio, mute, trackverlies, provideropnamebeleid, tab-/presentatiewissel, stoppen/leave, lokale en gekozen servertranscriptie. Documenteer welke adapters dit werkelijk ondersteunen; zie [#2526](https://pawprint.vigilis.online/LibreKAT/Ocideck/issues/2526). ## Acceptatie - [ ] Elke positieve claim in de capability-matrix heeft een met OS/browser, model en releaseartefact benoemde echte proef; ontbrekende hardware staat als niet getest. - [ ] De gids loopt vanaf Uitbreidingen tot opgeslagen `.md` plus audio en bevat herstelstappen voor alle detectiefouten. - [ ] Nieuwe documentpagina's zijn volgens de docs-registratiepoort in de app vindbaar; alle zichtbare tekst is vertaald. - [ ] Geen releaseclaim zolang een verplicht platformpad onbewezen of stuk is; baseline- en featurefouten worden apart gerapporteerd. ## Bronnen OciDeck `docs/BUILD.md`, `docs/KNOWN_LIMITATIONS.md`, `docs/PRIVACY.md`, `docs/SOURCE_MAP.md`.
Author
Owner

Geland via PR #2600 (merge 948bd15). Nueva doc de usuario docs/TRANSCRIPTION_SETUP.md (+ .nl revisada a mano) con: matriz de setup por plataforma (OS/arch/fuentes/permisos), catálogo de modelos con tamaño/licencia/SHA-256, configuración de servidor batch (whisper-server, POST /inference, tiers loopback/LAN/cloud con opt-ins, TLS+API-key+CORS, advertencia de exposición pública sin capa) y live (vosk-ws-1, testbed, consent por sesión, limitación del header API-key en browser), retención (7 días staging, mem: en web, sources.json) y diagnóstico tipado de fallos. Matriz de evidencia: solo lo probado se afirma (macOS+web calls #2541/#2544/#2545/#2548, WASM §4.6, Vosk testbed); Windows/Linux = código compartido sin prueba de hardware. Registrada en el lector de docs (pubspec + DocEntry + 31 idiomas), índices README/docs actualizados, TRANSCRIPTION.md §5.1 gana columna callaudio, KNOWN_LIMITATIONS documenta el estado de prueba del engine local. La proba de hardware Windows/Linux queda honestamente como pendiente — no hay máquina de prueba registrada.

Geland via PR #2600 (merge 948bd15). Nueva doc de usuario `docs/TRANSCRIPTION_SETUP.md` (+ .nl revisada a mano) con: matriz de setup por plataforma (OS/arch/fuentes/permisos), catálogo de modelos con tamaño/licencia/SHA-256, configuración de servidor batch (whisper-server, POST /inference, tiers loopback/LAN/cloud con opt-ins, TLS+API-key+CORS, advertencia de exposición pública sin capa) y live (vosk-ws-1, testbed, consent por sesión, limitación del header API-key en browser), retención (7 días staging, mem: en web, sources.json) y diagnóstico tipado de fallos. Matriz de evidencia: solo lo probado se afirma (macOS+web calls #2541/#2544/#2545/#2548, WASM §4.6, Vosk testbed); Windows/Linux = código compartido sin prueba de hardware. Registrada en el lector de docs (pubspec + DocEntry + 31 idiomas), índices README/docs actualizados, TRANSCRIPTION.md §5.1 gana columna callaudio, KNOWN_LIMITATIONS documenta el estado de prueba del engine local. La proba de hardware Windows/Linux queda honestamente como pendiente — no hay máquina de prueba registrada.
brenno 2026-10-27 01:39:29 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
LibreKAT/Ocideck#2523
No description provided.