98b1cd0c89
Demandé par Sylvain : des widgets, puis « comment lier Siri à mon appli ». Constat avant de commencer : App Intents déclarés : 1 (LogDrinkIntent) AppShortcutsProvider : 0 -> Siri n'avait AUCUNE phrase à écouter Saisie depuis la montre : 0 -> complications d'affichage seulement Et la cause commune : `LogDrinkIntent` vivait dans `CoachQuickWidget.swift`, qui n'appartient qu'à l'extension widget iPhone. Ni l'app (d'où Siri découvre les raccourcis), ni la cible Watch ne pouvaient le voir. Ce qui est ajouté ------------------ - `CoachIntents.swift` — les intents, partagés entre les TROIS cibles. `LogDrinkIntent` y est déplacé (pas dupliqué : deux définitions du même symbole dans une cible qui compile les deux fichiers casseraient le build), plus `HydrationStatusIntent` et `TodaySessionIntent`. - `CoachAppShortcuts.swift` — 5 raccourcis, 16 phrases françaises. Cible App UNIQUEMENT : Apple attend un seul AppShortcutsProvider par application. - `CoachWatchHydration.swift` — widget Smart Stack de la montre : total du jour, jauge, et deux boutons +cl. Le geste se fait au poignet. Choix qui méritent d'être dits ------------------------------- ⛔ Pas de saisie des repas sur la montre. Pas de caméra, pas de scanner, pas de saisie de texte confortable : le bouton ne ferait que renvoyer vers l'iPhone. Tranché avec Sylvain. ⛔ Pas de volume libre dans les phrases Siri. Un intent paramétré oblige Siri à poser une question — plus long que de sortir le téléphone, et le raccourci perd sa raison d'être. Volumes fixés : 250 ml, 500 ml, café 60 ml. ⛔ Aucune borne en bpm dans les réponses vocales. `TodaySession` n'en porte pas (vérifié : sport, title, subtitle, done) et il ne faut pas en ajouter — une fourchette cardiaque annoncée par haut-parleur, hors de la recommandation du jour et de ses réserves, reviendrait à prescrire une intensité à un post-infarctus. Siri annonce QUOI ; l'app dit COMMENT. Deux boutons et pas trois sur la montre : sur 160 pt, un troisième descend les cibles sous le seuil tactile, pour un geste qu'on fait en marchant. ⚠️ RIEN DE CE CODE N'EST COMPILÉ --------------------------------- AppIntents, WidgetKit et SwiftUI sont absents de Swift pour Linux. Ce qui a été vérifié à la place, par lecture croisée des sources : que chaque symbole appelé existe, et qu'aucun n'est déclaré deux fois. Deux erreurs ont d'ailleurs été trouvées ainsi avant commit — `asOf()` ne rend pas un optionnel, et `TodaySession` n'a pas de `durationMin`. Les erreurs de type, de concurrence et d'API n'apparaîtront qu'au build. `docs/siri-et-widget-watch-runbook-mac.md` porte les étapes Xcode, le tableau de Target Membership, les cinq vérifications à faire sur l'appareil, et les trois questions que seul le build tranchera — dont celle-ci : une complication de cadran accepte-t-elle un bouton interactif, ou est-ce réservé à la Smart Stack ? Par prudence, le cadran n'est ici qu'un affichage. 91 tests Swift Linux au vert (non-régression CoachQuickLog / snapshot). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Coach Hypnotruck — Mobile (iOS + Android)
Wrapper natif mobile de coach.hypnotruck.ch basé sur Capacitor 8.
Le repo s'appelle historiquement
coach-ios; renommécoach-mobileà partir de l'ajout de la plateforme Android (2026-05-07). Le filenamecoach-ios.local.jsonest conservé pour ne pas casser les références dans le code Swift natif.
Architecture
- Backend : FastAPI + Jinja2 hébergé sur le VPS, accessible via
https://coach.hypnotruck.ch - Coque iOS : Capacitor 8 charge l'URL distante dans un WKWebView
- Coque Android : Capacitor 8 charge l'URL distante dans une WebView (Android 8.0+, API 26+ — requis par Health Connect)
- Plugins natifs : push notifications, local notifications, géolocalisation, HealthKit (iOS) / Health Connect (Android) via
@capgo/capacitor-health, splash, status bar, haptics
Le code web n'est pas embarqué — l'app pointe vers la prod via server.url dans capacitor.config.ts. Avantage : déploiement web = mise à jour instantanée de l'app sans review Apple/Google.
Bundle ID & nom
- Bundle ID :
ch.hypnotruck.coach - App Store name :
Coach Hypnotruck - Display name :
Coach Hypnotruck
Prérequis (sur le Mac mini)
- macOS 13+ (Ventura ou plus récent)
- Xcode 15+ (App Store, ~10 Go)
- Command Line Tools :
xcode-select --install - Homebrew +
brew install node cocoapods - Node 20 LTS (compatible avec Cap 8)
- Compte Apple Developer Program actif (99 USD/an)
- Apple ID
dev@hypnotruck.chconnecté dans Xcode → Settings → Accounts
Workflow build
1. Cloner le repo sur le Mac mini
git clone https://git.nexus.hypnotruck.ch/sylvain/coach-ios.git
cd coach-ios
npm install
1bis. Configurer le token d'auth (auto-login)
Le repo ne contient pas le token COACH_WEB_TOKEN (gitignored). Crée le fichier sur le Mac :
cp coach-ios.local.json.example coach-ios.local.json
# Édite coach-ios.local.json et remplace par la vraie valeur
# (visible dans ~/.config/infomaniak.env sur le VPS, ligne export COACH_WEB_TOKEN=)
L'app utilisera ce token pour se connecter automatiquement à coach.hypnotruck.ch/login?token=... au lancement.
2. Générer les icônes & splash
# iOS uniquement
npx @capacitor/assets generate --ios
# Android uniquement
npx @capacitor/assets generate --android
# Les deux
npx @capacitor/assets generate
Génère toutes les tailles requises depuis resources/icon.png (1024×1024) et resources/splash.png (2732×2732).
3. Ajouter la plateforme iOS (à faire UNE SEULE FOIS sur le Mac)
npx cap add ios
Cette commande crée le dossier ios/ avec le projet Xcode, qui sera ensuite committé.
4. Sync (à chaque changement de plugins ou config)
npx cap sync ios
5. Ouvrir dans Xcode
npx cap open ios
Dans Xcode :
- Sélectionner le projet App dans la navigation gauche
- Onglet Signing & Capabilities :
- Team : ton équipe Apple Developer
- Bundle Identifier :
ch.hypnotruck.coach - Cocher "Automatically manage signing"
- Ajouter les capabilities requises :
- HealthKit (lecture FC, pas, calories, VO2max)
- Push Notifications
- Background Modes → Remote notifications
- Onglet Info : ajouter les clés Privacy obligatoires (voir section ci-dessous)
6. Build sur simulateur / device
- Simulateur : choisir un iPhone dans la barre du haut → ⌘R
- Device physique : connecter iPhone par USB, sélectionner, ⌘R (la 1ère fois iOS demande de faire confiance au certificat dev dans Réglages → Général → VPN et gestion des appareils)
7. Upload TestFlight
- Xcode → Product → Archive
- Fenêtre Organizer s'ouvre → sélectionner l'archive → Distribute App → App Store Connect → Upload
- Sur App Store Connect : créer une nouvelle app (1ère fois), section TestFlight → ajouter testeurs (jusqu'à 100 internes sans review, 10 000 externes avec review légère)
Privacy keys requises (Info.plist)
Sans ces clés, iOS crashe à l'usage du plugin. À ajouter dans Xcode → onglet Info → Custom iOS Target Properties :
| Clé | Valeur (description affichée à l'utilisateur) |
|---|---|
NSHealthShareUsageDescription |
"Coach Hypnotruck lit vos données de santé (FC, pas, calories) pour adapter vos séances." |
NSHealthUpdateUsageDescription |
"Coach Hypnotruck enregistre vos séances dans Santé pour suivre votre progression." |
NSLocationWhenInUseUsageDescription |
"Coach Hypnotruck utilise votre position pour tracer vos sorties course et VTT." |
NSLocationAlwaysAndWhenInUseUsageDescription |
"Permet le suivi GPS pendant les sorties même app en arrière-plan." |
NSMotionUsageDescription |
"Coach Hypnotruck utilise les capteurs de mouvement pour mesurer votre activité." |
NSCameraUsageDescription |
"Coach Hypnotruck peut utiliser l'appareil photo pour scanner des codes-barres alimentaires." |
Anti-rejet App Store (Guideline 4.2)
Apple rejette les apps qui sont juste un wrapper webview sans valeur native. Pour passer review :
- ✅ Push notifications natives (rappel séances) — implémenté côté iOS via
@capacitor/push-notifications - ✅ HealthKit (lecture FC, pas, calories) — implémenté via
@capgo/capacitor-health - ✅ Géolocalisation native pour tracking sorties
- ✅ Local notifications (rappels hors-ligne)
- ✅ Haptics sur actions importantes
- ⏳ À implémenter côté web : appeler ces plugins via JS bridge depuis coach.hypnotruck.ch
Structure repo
coach-ios/
├── capacitor.config.ts # Config Capacitor (bundle ID, URL, plugins)
├── package.json # Deps Capacitor + plugins
├── www/ # Page de bootstrap (chargement, fallback)
│ └── index.html
├── resources/ # Source icônes & splash (1024×1024, 2732×2732)
│ ├── icon.png
│ └── splash.png
├── ios/ # Projet Xcode (généré par `cap add ios` sur Mac)
└── README.md
Mise à jour de l'app
| Type de modif | Action requise |
|---|---|
| Changement web (templates, CSS, routes) | Aucune — l'app charge la prod en direct |
| Ajout plugin Capacitor | npm install + npx cap sync + nouveau build TestFlight / Play Store |
| Changement icône / splash | npx @capacitor/assets generate + sync + nouveau build |
| Changement bundle ID, version, capabilities | Build + soumission Apple review / Play Console review |
TODO Phase 0
- Sur le Mac :
npx cap add ioset commit du dossierios/ - Configurer signing dans Xcode avec Apple ID
dev@hypnotruck.ch - Ajouter les Privacy keys dans Info.plist
- 1er build simulateur pour vérifier que la PWA charge bien
- 1er build device physique (iPhone perso)
- Upload TestFlight pour beta interne
- Préparer screenshots App Store (6.7" iPhone, min 3)
- Privacy policy URL (obligatoire avec HealthKit) — à héberger sur coach.hypnotruck.ch/privacy