Files
GameTime/docs/qa-gate-243-device-runbooks.md
Blomios d4df3822b7 docs(qa-261): ajoute documents conformité et scripts QA pour release Android
- Ajoute privacy-policy-v1.md et release-compliance-checklist.md
- Ajoute documents QA gates #238-#243
- Ajoute scripts de validation repo-only et device runbooks
- Prépare checklists exécutables avant upload Play fermé

Ticket #261
2026-08-28 23:11:16 +02:00

106 lines
2.4 KiB
Markdown

# QA Gate #243 — Runbooks manuels device
## But
Standardiser les validations device non encore raisonnablement automatisables, avec des scripts réexécutables de collecte d'artefacts et un déroulé manuel stable.
Périmètre couvert :
- Health Connect téléphone Android
- watch companion téléphone + Wear
- import/export réel sur téléphone
## Références officielles
### Health Connect
Préparer la collecte :
```bash
./tool/qa_device_health_connect.sh start
```
Finaliser la collecte :
```bash
./tool/qa_device_health_connect.sh stop <artifact_dir>
```
### Watch companion
Préparer la collecte :
```bash
WATCH_SERIAL=<watch-adb-serial> ./tool/qa_device_watch_companion.sh start
```
Finaliser la collecte :
```bash
WATCH_SERIAL=<watch-adb-serial> ./tool/qa_device_watch_companion.sh stop <artifact_dir>
```
### Import / export réel
Préparer la collecte :
```bash
./tool/qa_device_import_export_real.sh start
```
Finaliser la collecte :
```bash
./tool/qa_device_import_export_real.sh stop <artifact_dir>
```
## Pré-requis communs
- `adb` disponible dans le `PATH`
- appareil téléphone connecté et autorisé
- pour la montre : `WATCH_SERIAL` renseigné et montre visible via `adb devices -l`
- build GameTime fraîche installée sur le ou les appareils sous test
## Artefacts attendus
Chaque script crée un dossier sous :
```bash
.ideai/artifacts/qa-device/
```
Le dossier produit doit contenir au minimum :
- `adb-devices.txt`
- fingerprint build device
- `logcat.txt` téléphone et/ou montre
- `steps.md` avec le scénario manuel joué
- `package-dumpsys-before.txt` et `package-dumpsys-after.txt` quand applicable
## Verdict attendu par runbook
### Health Connect
- ouverture propre du flux permission ou fallback réglages
- retour propre dans GameTime
- état UI cohérent avant/après
- export fin de séance vérifiable si exercé
### Watch companion
- projection de séance visible sur montre
- actions montre répercutées sur téléphone
- métriques montre lisibles, dont les pas si disponibles
- clôture de séance cohérente côté téléphone et montre
### Import / export réel
- export de fichier réussi
- réimport `merge` cohérent
- réimport `replaceAll` cohérent sur dataset jetable
- refus attendu si une séance active bloque l'import
## Limite actuelle au 22 août 2026
Ces runbooks rendent `#243` matérialisable et rejouable, mais la clôture QA device reste dépendante de la disponibilité réelle d'un appareil `adb`.