# 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`.