Repository Public
1<!--2VQuant iOS3File: README.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7<div align="center">89<img src="docs/brand/logo.svg" alt="VQuant logo" width="560">1011<br><br>1213<img src="docs/brand/icon.png" alt="VQuant icon" width="112" height="112">1415# VQuant pour iPhone et iPad1617**Client natif (Swift 6, SwiftUI, iOS 18+) de [vquant.spboucher.ai](https://vquant.spboucher.ai) : marchés et graphiques interactifs, analyses de l'agent suivies en direct, calculs quantitatifs exécutés sur le serveur, portefeuille, mémoire et veilles. Aucune vue web, aucune dépendance tierce. Même compte et mêmes clés d'accès que le site.**1819**Author: [Simon-Pierre Boucher](https://www.spboucher.ai)**2021[](https://vquant.spboucher.ai)222324252627282930313233343536373839404142[](https://git.spboucher.ai/vquant-ios/commits)43[](https://git.spboucher.ai/vquant-ios/commits)44[](https://git.spboucher.ai/vquant-ios/insights)45[](https://git.spboucher.ai/vquant-ios)46[](https://git.spboucher.ai/vquant-ios/insights)47[](https://git.spboucher.ai/vquant-ios)48[](https://git.spboucher.ai/vquant-ios/branches)49[](https://git.spboucher.ai/vquant-ios/tags)50[](https://git.spboucher.ai/vquant-ios)515253545556575859606162636465666768697071</div>7273---7475## Sommaire7677- [Aperçu](#-aperçu)78- [Fonctions](#-fonctions)79- [Architecture](#-architecture)80- [Pile technique](#-pile-technique)81- [Arborescence du dépôt](#-arborescence-du-dépôt)82- [Construire et tester](#-construire-et-tester)83- [Configuration](#-configuration)84- [API consommée](#-api-consommée)85- [Écrans](#-écrans)86- [Données locales et hors ligne](#-données-locales-et-hors-ligne)87- [Sécurité et authentification](#-sécurité-et-authentification)88- [Tests](#-tests)89- [Accessibilité et performance](#-accessibilité-et-performance)90- [Publication](#-publication)91- [Parité web, macOS, iPhone, iPad](#-parité-web-macos-iphone-ipad)92- [Points à connaître et pièges](#-points-à-connaître-et-pièges)93- [Limites connues et reste à valider](#-limites-connues-et-reste-à-valider)94- [Auteur](#-auteur)95- [Licence](#-licence)9697---9899## 🆕 2.0 « VQuant Next » (branche `next`, non publiée)100101VQuant devient d'abord **l'agent de recherche quantitative autonome** ; marchés, Quant Lab, portefeuilles et studio102sont des surfaces autour de lui. 2.0 est une mise à niveau de 1.0 — tout ce que 1.0 faisait reste en place — pour le103backend 6 et avec le paquet partagé [`VQuantKit`](../VQuantKit) (dépendance locale, aussi utilisée par le client macOS).104105| Domaine | Ce que 2.0 apporte |106|---|---|107| Un compte, synchronisé | Listes de suivi, portefeuilles (`main` = celui de l'agent), tracés de graphique, projets, notes, espaces de travail et préférences sont des objets du compte : réplique chiffrée sur l'appareil, file d'écritures hors ligne, fusion des conflits, état visible. La liste de suivi locale de 1.0 est migrée une fois, sans perte ni doublon. |108| Recherche autonome | Mode recherche, jeu de données depuis Fichiers avec carte d'inspection, budget, modèle du registre du serveur (logos, Auto), vue d'étude Rapport · Activité · Code · Expériences · Figures · Fichiers, demandes d'autorisation (carte + notification locale avec Autoriser / Refuser), reprise d'une étude lancée sur le Mac ou le web. |109| Terminal | Vue des marchés par section avec pastilles de fraîcheur, courbe des taux, calendrier économique, recherche universelle, états financiers avec ratios, croissance et formules. |110| Quant Lab | 19 moteurs par catégorie, formulaires tactiles générés depuis la description du serveur (listes natives pour les paramètres JSON), progression, annulation, résultats `lab/1` ; calculs rapides (option, VaR, taille de position). |111| Portefeuilles et Studio | Plusieurs portefeuilles, analyse et **proposition** de rééquilibrage par les moteurs ; projets, hypothèses, notes, revues automatisées, export. |112| iPad | Trois colonnes par destination, cockpit de recherche avec inspecteur, espaces de travail à séparateurs déplaçables, tracés au Pencil ancrés au temps et au prix, raccourcis clavier, glisser-déposer, Quick Look, fenêtres multiples. |113| Identité | Jetons `VQTokens` : titres en New York, nombres en SF Mono, filets, accent Ember réservé aux aplats. |114115Ce qui n'est **pas** fait ou jamais vérifié sur un appareil : [`docs/IOS_TEST_PLAN.md`](docs/IOS_TEST_PLAN.md) §7.116Les sections ci-dessous décrivent 1.0 et restent valables sauf mention ; l'architecture, les routes et la parité de1172.0 sont dans `docs/`.118119---120121## 📖 Aperçu122123**VQuant pour iPhone et iPad** est l'interface mobile native de [vquant.spboucher.ai](https://vquant.spboucher.ai) :124application 100 % native (Swift 6, SwiftUI, concurrence stricte `complete`), sans vue web, sans dépendance tierce125(2.0 : une seule dépendance, le paquet maison `VQuantKit`).126Elle partage le compte, les clés d'accès, l'historique, la mémoire, le portefeuille et les veilles du site.127128Trois règles gouvernent l'app :129130- **Aucune donnée fabriquée.** Chaque nombre affiché vient d'une réponse du serveur ou d'un calcul descriptif documenté131 sur ces réponses. Une valeur manquante s'affiche « — », jamais 0. Un échec s'affiche comme un échec.132- **Provenance visible.** Tout chargement renvoie `Loaded<T>` (réseau ou copie locale, avec l'heure) ; l'interface affiche133 un badge Interrogé / Différé / Clôture / Copie locale / Indisponible (`DataFreshness.classify`) ou, pour les données134 de la couche de données du backend 6, la pastille de provenance du serveur (jamais « en direct » : il n'y a pas de flux).135- **Le serveur calcule.** L'appareil ne fait que des statistiques descriptives légères sur les observations reçues136 (moyennes mobiles, RSI, MACD, Bollinger, drawdown, corrélations). Les modèles restent côté serveur.137138| | |139|---|---|140| Identifiants | `ai.spboucher.vquant` (le même que le client macOS), extension `ai.spboucher.vquant.widgets`, groupe d'apps `group.ai.spboucher.vquant`, équipe `3YM54G49SN` |141| Cible | iOS / iPadOS 18.0 et plus, iPhone + iPad |142| Version | **2.0.0 (2) sur la branche `next`, non publiée** ; 1.0.0 (1) sur TestFlight depuis le 2026-11-18 (build `VALID`, test interne) |143| Fiche App Store Connect | `6836574364` (SKU `vquant-ios-001`, fr-CA) |144| Langue | français |145| Code | 58 fichiers Swift, environ 17 700 lignes (dont `VQuant/Next/`, 11 fichiers, environ 5 100 lignes) ; plus le paquet partagé `VQuantKit` |146147### Documentation du dépôt148149| Fichier | Contenu |150|---|---|151| [`docs/IOS_ARCHITECTURE.md`](docs/IOS_ARCHITECTURE.md) | ce qu'est réellement le backend, organisation du code, iPhone / iPad, cycle de vie |152| [`docs/IOS_AUTHENTICATION.md`](docs/IOS_AUTHENTICATION.md) | clés d'accès, sessions d'appareil, Trousseau, verrou biométrique |153| [`docs/IOS_API_MAPPING.md`](docs/IOS_API_MAPPING.md) | chaque route du serveur et l'écran qui l'utilise |154| [`docs/IOS_FEATURE_PARITY.md`](docs/IOS_FEATURE_PARITY.md) | matrice Web / macOS / iPhone / iPad |155| [`docs/IOS_TEST_PLAN.md`](docs/IOS_TEST_PLAN.md) | tests, résultats mesurés, ce qui reste à valider sur appareil |156157### Famille VQuant158159| Dépôt | Rôle | Plateforme |160|---|---|---|161| [vquant](https://git.spboucher.ai/vquant) | Backend (Node / Express, SQLite, moteurs Python) + site web, `vquant.spboucher.ai` | web |162| [vquant-macos](https://git.spboucher.ai/vquant-macos) | Client natif macOS | macOS |163| **[vquant-ios](https://git.spboucher.ai/vquant-ios)** | **Client natif iPhone et iPad (ce dépôt)** | iOS / iPadOS |164165### Ce qu'est réellement VQuant166167Le cahier des charges décrivait un écosystème générique (« Pyrus », WebSocket, courtage). L'inspection du dépôt168`vquant` (v5.8.0) donne ceci, et l'app s'y conforme :169170| Élément du cahier des charges | Réalité du backend | Conséquence dans l'app |171|---|---|---|172| « Pyrus » | N'existe pas. Les calculs lourds sont les **moteurs Python** du serveur, exposés par `/api/quant/*` (GARCH, VaR, Monte Carlo, options, optimisation, métriques de risque). | L'espace « Calculs » pilote ces moteurs : formulaire généré depuis la description du serveur, tâches persistantes, résultats avec paramètres et code. |173| Recherche / agents IA | Agent d'analyse (`POST /api/chat`) exécuté comme **tâche serveur** (`/api/generations`), flux SSE rejouable. | Onglet Recherche : lancement, suivi en direct, reprise après coupure, historique, rapports rendus en natif. |174| Flux WebSocket de marché | Aucun. Données FMP via un proxy REST (`/api/fmp/*`). | Interrogation périodique, adaptée à l'état du marché et de la batterie. |175| Portefeuille, ordres, courtage | Positions **déclaratives** (`/api/workspace/portfolio`). Aucun ordre, aucun courtier. | Portefeuille valorisé avec les cours réels ; aucune interface d'ordre. |176| Notifications push (APNs) | Le serveur n'a aucune intégration APNs. | Notifications **locales**, émises quand l'app constate la fin d'une tâche. |177178---179180## ✨ Fonctions181182### Marchés183184- Indices, cotations, hausses / baisses / titres actifs du jour, heures de marché.185- **Recherche de symbole** et **liste de suivi** (locale à l'appareil, partagée avec les widgets).186- Fiche d'actif : société, actualités, **12 tableaux de fondamentaux** (compte de résultat, bilan, flux de trésorerie,187 indicateurs clés, ratios, estimations d'analystes, surprises de résultats, dividendes, détenteurs institutionnels,188 transactions d'initiés, révisions de recommandations, objectif de cours) — tableau générique : tous les champs189 renvoyés, aucun inventé.190191### Graphiques192193- `PriceChartView` dessine dans un `Canvas` SwiftUI : seule la fenêtre visible est tracée, au plus une marque par pixel194 horizontal.195- 4 types : chandeliers, OHLC, ligne, aire. Périodes 1J, 5J, 1M (5 min, 15 min, 1 h) et 3M → Max (quotidien).196- Superpositions : MM 20, MM 50, MM 200, MME 21, Bollinger 20·2. Panneaux : volume, RSI 14, MACD 12·26·9.197- Pincer, glisser, réticule ; plein écran en paysage ; export image et CSV ; annotations (PencilKit).198- Quand la période contient plus de barres que de pixels, le graphique trace des agrégats OHLC **exacts**199 (`Indicators.aggregate`) et l'écrit (« Agrégé ×N pour l'affichage »). Aucune interpolation, aucun lissage.200201### Recherche (agent d'analyse)202203- Lancer une analyse (4 modes), avec image jointe depuis la photothèque.204- **Suivi en direct** par SSE : plan, outils, sous-analystes, chronologie repliable ; arrêt ; **reprise après coupure** à205 l'index du dernier événement reçu.206- Rapports rendus en natif : Markdown, tableaux, figures, marqueurs ; sources, données et code (piste d'audit complète) ;207 questions de suivi.208- Historique : recherche, épingler, renommer, supprimer ; bibliothèque des rapports partagés ; export PDF (mis en page209 par le serveur).210211### Calculs quantitatifs212213- 6 moteurs du serveur : `garch`, `var`, `monte_carlo`, `options`, `portfolio_optimization`, `risk_metrics`.214- Formulaire construit depuis la description des paramètres (type, défaut, bornes, choix) ; le serveur revalide et215 renvoie les paramètres effectivement appliqués.216- Tâches persistantes ; résultat avec paramètres, code et graphiques (Swift Charts).217218### Portefeuille et agent219220- Portefeuille déclaratif (confirmation explicite avant écriture), valorisation, répartition, corrélations, drawdown ;221 tableau triable des positions sur iPad (`Table`).222- Mémoire de l'agent ; veilles planifiées (exécutées par le serveur).223224### Intégration au système225226| Fonction | Détail |227|---|---|228| Widgets (WidgetKit) | 4 : marchés (`MarketsWidget`), liste de suivi (`WatchlistWidget`), actif favori (`FavouriteAssetWidget`), tâches (`JobsWidget`) — ils lisent un instantané déposé par l'app, sans réseau ni jeton |229| Siri / Raccourcis (App Intents) | « État des calculs », « Ouvre ma liste de suivi », « Ouvre la recherche », « Voir un actif » |230| Spotlight | actifs consultés (`ai.spboucher.vquant.asset`) |231| Liens profonds `vquant://` | `asset`, `conversation`, `analysis`, `quant`, `research`, `portfolio`, `markets` |232| Notifications locales | fin d'une tâche suivie par l'appareil |233| Arrière-plan | `BGAppRefreshTask` (`ai.spboucher.vquant.refresh`) : relève les tâches, notifie, met à jour les widgets |234| Verrou | Face ID / Touch ID, délai réglable, contenu masqué dans le sélecteur d'apps |235236### iPhone et iPad237238- **iPhone** : `TabView` à cinq onglets (Accueil, Marchés, Recherche, Portefeuille, Plus), un `NavigationStack` par239 onglet, feuilles pour la composition et l'édition, graphique plein écran en paysage.240- **iPad** : `NavigationSplitView` (barre latérale à trois groupes), fiche d'actif en deux colonnes (graphique et analyse241 à gauche, inspecteur à droite), tableau triable des positions, fenêtres multiples (`WindowGroup(for: String.self)`,242 Stage Manager et écran externe par le système), survol au trackpad sur le graphique, annotations au Pencil.243- Le choix se fait sur la classe de taille horizontale : un iPad en Slide Over étroit reçoit l'interface iPhone.244245| Raccourci (iPad) | Action |246|---|---|247| <kbd>⌘</kbd><kbd>N</kbd> | Nouvelle analyse |248| <kbd>⌘</kbd><kbd>K</kbd> | Rechercher un actif |249| <kbd>⌘</kbd><kbd>R</kbd> | Actualiser |250| <kbd>⌘</kbd><kbd>1</kbd> … <kbd>⌘</kbd><kbd>8</kbd> | Sections |251252**Différences d'interface voulues.** Le site ouvre sur la conversation ; l'iPhone ouvre sur un tableau de bord (marchés,253portefeuille, tâches en cours, liste de suivi, analyses récentes). Une conversation web devient une liste de tâches et de254rapports ; chaque rapport est un écran. Sur le site les calculs passent par l'agent ; l'app offre un formulaire par255moteur, sans coût de modèle. Sur iPad : inspecteur latéral, tableau, fenêtres — la même fonction avec plus de densité,256pas un iPhone étiré.257258---259260## 🧭 Architecture261262```mermaid263flowchart TB264 subgraph Device["iPhone / iPad"]265 subgraph AppProc["App VQuant"]266 UI["Features (SwiftUI)<br/>Home, Markets, Research, Quant, Portfolio, Agent, Settings"]267 CH["Charts<br/>Canvas · Swift Charts · PencilKit"]268 MODEL["AppModel + Stores (@Observable)"]269 AUTH["Auth<br/>PasskeyService · AppLock · Keychain"]270 PLAT["Platform<br/>notifications, BackgroundTasks, Spotlight, App Intents"]271 end272 subgraph CoreLib["Core (paquet VQuantCore)"]273 API["APIClient + VQuantAPI<br/>Bearer, erreurs typées, SSE"]274 STR["SSEParser · AnalysisRun (réducteur pur)"]275 CACHE["DiskCache (acteur)<br/>AES-256-GCM"]276 Q["Indicators · PortfolioMath · ChartViewport"]277 end278 SNAP[("instantané JSON<br/>conteneur du groupe d'apps")]279 W["VQuantWidgets<br/>4 widgets, aucun réseau"]280 end281 subgraph Cluster["MacLustr"]282 TUN["MacLustr Tunnel<br/>Caddy + WireGuard"]283 BE["vquant · Node / Express · SQLite<br/>M2U64:5000"]284 PY["moteurs Python<br/>/api/quant/*"]285 FMP["FMP (proxy /api/fmp/*)"]286 end287 UI --> MODEL --> API288 UI --> CH --> Q289 MODEL --> STR290 MODEL --> CACHE291 MODEL --> AUTH292 MODEL --> PLAT293 MODEL --> SNAP --> W294 API -- "HTTPS · Bearer · SSE" --> TUN --> BE295 BE --> PY296 BE --> FMP297```298299Réseau, décodage JSON, lecture SSE, chiffrement du cache et décodage d'images se font hors de l'acteur principal300(`APIClient` est `Sendable`, `DiskCache` et `FigureStore` sont des acteurs).301302### Une analyse suivie en direct, avec reprise303304```mermaid305sequenceDiagram306 autonumber307 participant A as App (Recherche)308 participant S as vquant309 A->>S: POST /api/chat {query, history, mode}310 S-->>A: SSE job (identifiant de la tâche serveur)311 S-->>A: SSE status · plan · tool_start · tool_complete · agent_start · text…312 Note over A,S: passage en arrière-plan ou coupure — la tâche continue sur le serveur313 A->>S: GET /api/generations/:id/stream?from=N314 S-->>A: SSE (rejeu à partir de l'événement N, sans doublon)315 S-->>A: SSE sources · followups · done316 A->>A: AnalysisRun (réducteur) → rapport rendu en natif317```318319### Opération sensible et vérification fraîche320321```mermaid322sequenceDiagram323 autonumber324 participant A as App (Réglages › Appareils)325 participant S as vquant326 A->>S: DELETE /api/native/devices/:id327 S-->>A: 403 reauth_required328 A->>S: POST /api/native/reauth/options329 S-->>A: défi330 A->>A: assertion de clé d'accès (Face ID)331 A->>S: POST /api/native/reauth/verify332 S-->>A: ok, valable 5 minutes333 A->>S: DELETE /api/native/devices/:id (rejoué)334 S-->>A: session révoquée335```336337### Cycle de vie338339- Passage en arrière-plan : arrêt des interrogations et des flux SSE ; les tâches continuent sur le serveur.340- Retour au premier plan : verrou biométrique selon le délai choisi, vérification de la session, reprise des flux à341 partir du dernier événement reçu (`?from=N`), rafraîchissement.342- Notifications locales seulement. Sans APNs côté serveur, une fin de tâche peut n'être annoncée qu'à la prochaine343 actualisation ou ouverture. L'app le dit dans Réglages › Notifications.344- Live Activities : non implémentées. Sans jetons push, une activité figerait dès la suspension de l'app et afficherait345 un état périmé comme s'il était actuel.346- Metal n'a pas été retenu pour les graphiques : avec le fenêtrage, le coût par image est borné par la largeur de347 l'écran, pas par la longueur de la série.348349---350351## 🧰 Pile technique352353| Couche | Technologie | Version | Rôle |354|---|---|---|---|355| Langage | Swift | 6.0, `SWIFT_STRICT_CONCURRENCY: complete` | tout le code |356| Interface | SwiftUI | système | tous les écrans, aucune vue web |357| Cible | iOS / iPadOS | 18.0 et plus, familles `1,2` | iPhone + iPad ; ni Catalyst, ni « Designed for iPad » sur Mac, ni visionOS |358| Graphique des prix | SwiftUI `Canvas` | système | chandeliers, OHLC, ligne, aire |359| Graphiques analytiques | Swift Charts | système | résultats de calculs, portefeuille |360| Annotations | PencilKit | système | calque d'annotations |361| Widgets | WidgetKit + App Intents | système | 4 widgets |362| Authentification | AuthenticationServices | système | clés d'accès WebAuthn |363| Verrou | LocalAuthentication | système | biométrie puis code de l'appareil |364| Chiffrement | CryptoKit | système | cache AES-256-GCM |365| Arrière-plan | BackgroundTasks | système | `BGAppRefreshTask` |366| Paquet | Swift Package Manager | tools 6.0 ; iOS 18, macOS 15 | `VQuantCore` (`Core/`) pour les tests sur Mac |367| Projet | XcodeGen | `project.yml` | génère `VQuant.xcodeproj` (non versionné) |368| Outils | Xcode | 27.2 ; simulateurs iOS 26.5 | build et tests |369| Tests | Swift Testing + XCTest / XCUITest | — | socle, app hébergée, interface, mesures |370371---372373## 📁 Arborescence du dépôt374375```376vquant-ios/377├── project.yml XcodeGen : app (iPhone + iPad), extension de widgets, tests unitaires, tests d'interface378├── Package.swift paquet VQuantCore (Core/ + CoreTests/)379├── Core/ (13) socle sans interface (Foundation, CryptoKit) — compilé dans l'app et les widgets380│ ├── Models/ Market, Research (conversations, tâches, espace de travail, appareils, calculs), JSONValue381│ ├── Networking/ APIClient (Bearer, erreurs typées, SSE), VQuantAPI (une fonction par route réelle)382│ ├── Streaming/ SSEParser, AnalysisEvent, AnalysisRun (réducteur pur, rejouable)383│ ├── Cache/ DiskCache (AES-256-GCM), CachedFetcher (réseau d'abord), DataFreshness384│ ├── Quant/ Indicators, PortfolioMath, QuantResult, ChartViewport385│ ├── Markdown/ MarkdownParser, ReportText (figures, marqueurs, CSV)386│ └── Stores/ WatchlistFile, WidgetSnapshot, SharedContainer387├── VQuant/ (26)388│ ├── App/ (4) VQuantApp (scènes), AppModel (racine de composition), Stores (@Observable), AppSupport389│ ├── Auth/ (4) Keychain, PasskeyService, AppLock, SignInView390│ ├── DesignSystem/ (2) Theme (palette Onyx, formats), Components391│ ├── Charts/ (5) PriceChartView + PriceChartScene (Canvas), AnalyticsCharts (Swift Charts), ChartAnnotationLayer (PencilKit), ChartTypes392│ ├── Features/ (9) Home, Markets (+ AssetView), Research (+ ReportViews), Quant, Portfolio, Agent, Settings393│ ├── Platform/ (2) notifications locales, BackgroundTasks, Spotlight, App Intents394│ └── Resources/ Info.plist, droits, PrivacyInfo, Assets.xcassets (icône 1024 px)395├── VQuantWidgets/ (1) quatre widgets (WidgetKit + App Intents)396├── CoreTests/ (2) tests du socle + Fixtures/ (20 réponses réelles du backend, tronquées)397├── VQuantTests/ (2) tests hébergés dans l'app + mesures de performance398├── VQuantUITests/ (1) tests d'interface399├── Scripts/ build.sh, test-live.sh, release.sh, asc.py, make-icon.swift, ExportOptions.plist400└── docs/ IOS_ARCHITECTURE, IOS_AUTHENTICATION, IOS_API_MAPPING, IOS_FEATURE_PARITY, IOS_TEST_PLAN, brand/401```402403Lignes Swift : Core 2 592 · VQuant 6 785 (App 1 238, Auth 519, Charts 1 388, DesignSystem 384, Features 2 972,404Platform 284) · VQuantWidgets 297 · CoreTests 640 · VQuantTests 469 · VQuantUITests 375.405406`Scripts/make-icon.swift` dessine l'icône (l'étincelle VQuant sur fond Onyx) en PNG de 1024 px.407408---409410## 🚀 Construire et tester411412```bash413Scripts/build.sh generate # projet Xcode (xcodegen) + Info-Debug.plist414Scripts/build.sh core # tests du socle sur le Mac (swift test)415Scripts/build.sh debug # build simulateur « VQuant iPhone »416Scripts/build.sh release # build Release pour simulateur générique, sans signature417Scripts/test-live.sh test # tests unitaires hébergés + backend de test (tunnel vers M2U64:5058)418Scripts/shot.sh <nom> [vquant://…] [--dark] [--pad] # capture d'un écran pour relecture visuelle419Scripts/test-live.sh uitest # tests d'interface iPhone ; VQUANT_SIM="VQuant iPad" pour l'iPad420Scripts/release.sh archive # archive Release signée (compte Apple de Xcode)421Scripts/release.sh export # IPA App Store Connect ; puis validate ; upload seulement sur demande422Scripts/release.sh device <nom> # build de développement installé sur un appareil branché423```424425- Simulateurs dédiés, créés au besoin par `build.sh` : « VQuant iPhone » (iPhone 17 Pro) et « VQuant iPad »426 (iPad Pro 13 pouces M5).427- Le backend de test est le backend 6 figé sur `M2U64:~/dev/vquant-next-api` (port **5058**, copie des données de428 production avec toutes les routes `/api/v2`). **Les tests n'écrivent jamais sur la production** et n'y créent que des429 objets préfixés `ios-test-` (liste, portefeuille, projet, espace de travail, graphiques `ios-test-sym-…`).430- `VQUANTKIT=<dossier> Scripts/build.sh generate` construit contre une copie figée du paquet partagé (il est modifié431 par d'autres sessions) ; le `project.yml` versionné pointe toujours sur `../VQuantKit`.432- `Scripts/test-live.sh tunnel` ouvre le tunnel ; `Scripts/test-live.sh token` renouvelle le jeton de test (session433 d'appareil créée dans la base de la copie ; le script du serveur refuse de tourner dans le dossier de production).434- L'analyse réelle de bout en bout (coût d'API) ne tourne qu'avec `TEST_RUNNER_VQUANT_LIVE_ANALYSIS=1` ; l'étude435 autonome réelle (modèle `claude-sonnet-5-5`, plafond 3 USD) avec `TEST_RUNNER_VQUANT_LIVE_RESEARCH=1`.436- La sortie de `xcodebuild` est filtrée ; journaux complets dans `build/logs/`, captures dans `build/shots/<simulateur>/`.437438---439440## 🔧 Configuration441442Aucune clé d'API, aucun secret dans le dépôt ni dans le binaire. Noms seulement :443444| Nom | Où | Rôle |445|---|---|---|446| `VQuantBaseURL` | `Info.plist` | origine du backend (production : `https://vquant.spboucher.ai`) |447| `VQUANT_SIM` | `Scripts/build.sh` | simulateur utilisé |448| `VQUANT_BASE_URL`, `VQUANT_TEST_TOKEN` | environnement du lanceur de tests (préfixe `TEST_RUNNER_`) | adresse et jeton de la copie de test |449| `VQUANT_UITEST` | environnement (XCUITest) | lance l'app en mode test d'interface |450| `VQUANT_LIVE_ANALYSIS` | environnement (préfixe `TEST_RUNNER_`) | active le test optionnel d'analyse réelle |451| `ASC_KEY_ID`, `ASC_ISSUER_ID` | `Scripts/release.sh` | clé d'API App Store Connect (fichier `.p8` hors dépôt) |452453`Info-Debug.plist` = `Info.plist` + réseau local autorisé (copie de test par tunnel SSH) ; généré par454`Scripts/build.sh generate`, non versionné. Réglages du bundle : schéma d'URL `vquant`, domaine associé455`webcredentials:vquant.spboucher.ai`, tâche d'arrière-plan `ai.spboucher.vquant.refresh`, mode `fetch`.456457---458459## 🔌 API consommée460461Source : `vquant` v5.8.0, vérifié contre la copie de test. Client : `Core/Networking/VQuantAPI.swift`. **Aucune route462n'a été inventée** ; les réponses de référence sont dans `CoreTests/Fixtures/`. Détail route par route et écran par463écran : [`docs/IOS_API_MAPPING.md`](docs/IOS_API_MAPPING.md).464465<details>466<summary><b>Session et appareils (13)</b></summary>467468| Route | Fonction | Écran |469|---|---|---|470| `POST /api/native/login/options`, `…/login/verify` | `PasskeyService.signIn` | Connexion |471| `POST /api/native/register/options`, `…/register/verify` | `PasskeyService.enrol` | Connexion › lien d'invitation |472| `POST /api/native/reauth/options`, `…/reauth/verify` | `PasskeyService.reauthenticate` | Avant révocation |473| `GET /api/native/session` | `session()` | Lancement, diagnostic |474| `POST /api/native/logout` | `logout()` | Réglages › Se déconnecter |475| `GET /api/native/devices` | `devices()` | Réglages › Appareils |476| `DELETE /api/native/devices/:id` | `revokeDevice` | idem |477| `DELETE /api/native/passkeys/:ref` | `revokePasskey` | idem |478| `GET /api/me` | `me()` | tests |479| `GET /api/health` | `health()` | Diagnostic |480481</details>482483<details>484<summary><b>Données de marché — proxy FMP (23)</b></summary>485486| Route | Fonction | Écran |487|---|---|---|488| `GET /api/fmp/indices` | `indices()` | Accueil, Marchés, widgets |489| `GET /api/fmp/quote/:symbol` | `quote()` | Fiche d'actif, liste de suivi, portefeuille |490| `GET /api/fmp/gainers` · `losers` · `actives` | `movers()` | Marchés |491| `GET /api/fmp/market-hours` | `marketHours()` | Marchés, calcul de la fraîcheur |492| `GET /api/fmp/search?q=&limit=` | `search()` | Recherche de symbole |493| `GET /api/fmp/chart/full/:symbol?from=&to=` | `bars()` (quotidien) | Graphique 3M → Max |494| `GET /api/fmp/chart/intraday/:symbol?interval=&from=&to=` | `bars()` (5 min, 15 min, 1 h) | Graphique 1J, 5J, 1M |495| `GET /api/fmp/company-profile/:symbol` | `profile()` | Fiche › Société |496| `GET /api/fmp/financial-news/:symbol` | `news()` | Fiche › Actualités |497| `GET /api/fmp/{income-statement, balance-sheet, cash-flow, key-metrics, financial-ratios, analyst-estimates, earnings-surprises, dividend-history, institutional-holders, insider-trading, upgrades-downgrades, price-target-summary}/:symbol` | `fundamentals()` | Fiche › Fondamentaux |498499Non utilisées : `stock-quote` (doublon de `quote`), `historical-price` et `chart/light` (couvertes par `chart/full`),500`intraday` (couverte par `chart/intraday`), `price-target`, `esg-score`.501502</details>503504<details>505<summary><b>Analyses, conversations et rapports (12)</b></summary>506507| Route | Fonction | Écran |508|---|---|---|509| `POST /api/chat` `{query, history, sessionId?, mode, imageData?, imageMimeType?}` → SSE | `startAnalysis` | Composition |510| `GET /api/generations` | `generations()` | Recherche, Accueil, widget, Raccourci |511| `GET /api/generations/:id/stream?from=N` → SSE | `streamGeneration` | Suivi en direct, reprise |512| `POST /api/generations/:id/cancel` | `cancelGeneration` | Bouton Arrêter |513| `GET /api/sessions[?q=]` | `conversations()` | Recherche › Historique |514| `GET /api/sessions/:id` | `conversation()` | Conversation |515| `PATCH /api/sessions/:id` `{title}` / `{pinned}` | `renameConversation`, `pinConversation` | balayage |516| `DELETE /api/sessions/:id` | `deleteConversation` | balayage + confirmation |517| `GET /api/shared-reports`, `GET /api/share/:shareId` | `sharedReports`, `sharedReport` | Bibliothèque |518| `POST /api/generate-pdf` `{question, answer}` | `pdf()` | Conversation › PDF |519| `GET /figures/…`, `/plots/…` | `file()` | Figures des rapports |520521Non utilisées : `POST /api/share`, `POST /api/generate-docx`, `POST /api/convert-to-slides`,522`POST /api/speech-to-text`, `GET /api/download/:filename`, `/api/admin/*`, `/api/analytics/*`.523524</details>525526<details>527<summary><b>Calculs quantitatifs (5) et espace de travail (9)</b></summary>528529| Route | Fonction | Écran |530|---|---|---|531| `GET /api/quant/tools` | `quantTools()` | Calculs, formulaire |532| `POST /api/quant/jobs` `{tool, params}` → 202 | `startQuantJob` | Formulaire |533| `GET /api/quant/jobs` | `quantJobs()` | Calculs, Accueil, Raccourci |534| `GET /api/quant/jobs/:id` | `quantJob()` | Résultat (paramètres, code, résultat) |535| `DELETE /api/quant/jobs/:id` | `deleteQuantJob` | balayage |536| `GET /api/workspace` | `workspace()` | Portefeuille, Agent, Accueil |537| `PUT /api/workspace/portfolio/:symbol` `{quantity, costBasis?, note?}` | `upsertPosition` | Portefeuille |538| `DELETE /api/workspace/portfolio/:symbol` | `removePosition` | Portefeuille |539| `POST /api/workspace/memories`, `DELETE …/:id` | `addMemory`, `deleteMemory` | Agent › Mémoire |540| `POST /api/workspace/watches`, `PATCH …/:id`, `DELETE …/:id`, `POST …/:id/run` | `createWatch`, `updateWatch`, `deleteWatch`, `runWatch` | Agent › Veilles |541542</details>543544**Événements SSE décodés (`AnalysisEvent`, 18)** : `job`, `status`, `text`, `thinking`, `plan`, `tool_start`,545`tool_complete`, `tool_error`, `tool_result`, `python_code`, `custom_python_figures`, `agent_start`, `agent_tool`,546`agent_done`, `sources`, `followups`, `error`, `done`. `tools` et `workspace` sont ignorés sciemment ; tout autre type est547conservé et signalé dans l'écran de suivi. Le champ `model` n'est pas envoyé : le serveur applique son modèle par défaut.548549**Limites appliquées par le serveur**, restituées telles quelles : 4 analyses simultanées par personne (429), une par550conversation (409), rejeu 20 minutes après la fin, liste 24 heures ; au plus 3 calculs simultanés par personne, pas de551route d'annulation d'un calcul. Un redémarrage du serveur interrompt les analyses en cours.552553**Ce qui n'existe pas côté serveur** : liste de suivi (locale à l'appareil), flux WebSocket, ordres ou courtage, push554APNs, liste des modèles, sessions web par appareil.555556---557558## 📱 Écrans559560Sections de la navigation (`VQuant/App/AppSupport.swift`) : Accueil, Marchés, Recherche, Portefeuille, Plus sur iPhone ;561la barre latérale de l'iPad ajoute Calculs, Agent, Bibliothèque et Réglages.562563| Écran | Fichier | Contenu |564|---|---|---|565| Connexion | `VQuant/Auth/SignInView.swift` | clé d'accès, lien d'invitation à coller |566| Accueil | `VQuant/Features/Home/HomeView.swift` | marchés, portefeuille, tâches en cours, liste de suivi, analyses récentes |567| Marchés | `VQuant/Features/Markets/MarketsView.swift` | indices, mouvements du jour, recherche de symbole |568| Fiche d'actif | `VQuant/Features/Markets/AssetView.swift` | graphique, société, actualités, fondamentaux |569| Recherche | `VQuant/Features/Research/ResearchView.swift`, `ReportViews.swift` | composition, suivi en direct, historique, rapports, bibliothèque |570| Calculs | `VQuant/Features/Quant/QuantViews.swift` | moteurs, formulaire, tâches, résultats |571| Portefeuille | `VQuant/Features/Portfolio/PortfolioView.swift` | positions, valorisation, répartition, corrélations |572| Agent | `VQuant/Features/Agent/AgentView.swift` | mémoire, veilles |573| Réglages | `VQuant/Features/Settings/SettingsView.swift` | clés d'accès et appareils autorisés, verrou, notifications, diagnostic |574575---576577## 💾 Données locales et hors ligne578579Il n'y a pas de base de données locale : le serveur est la source de vérité.580581| Donnée | Où | Protection |582|---|---|---|583| Jeton de session d'appareil | Trousseau | `AfterFirstUnlockThisDeviceOnly`, non synchronisé |584| Clé du cache (256 bits aléatoires) | Trousseau | mêmes attributs |585| Cache des réponses consultées | `DiskCache` | AES-256-GCM (l'heure d'enregistrement est authentifiée), Data Protection, exclu des sauvegardes |586| Liste de suivi | `WatchlistFile`, conteneur du groupe d'apps | locale à l'appareil, partagée avec les widgets |587| Instantané des widgets | `WidgetSnapshot`, conteneur du groupe d'apps | JSON sans identifiant |588589**Hors ligne.** Ce qui a été consulté reste lisible (cours, graphiques, conversations, résultats de calculs, figures),590chiffré sur l'appareil et marqué « Copie locale » avec sa date. Toute action qui modifie le compte ou lance un travail591demande le serveur : les boutons sont désactivés hors ligne et **rien n'est mis en file d'attente**. `CachedFetcher`592essaie le réseau d'abord et ne retombe sur la copie locale que sur un échec de transport.593594---595596## 🔒 Sécurité et authentification597598Le serveur ne fait confiance qu'à une **clé d'accès WebAuthn**. Face ID / Touch ID n'authentifient jamais auprès du599serveur : ils autorisent l'appareil à utiliser la clé privée et, séparément, déverrouillent l'app en local. Il n'y a ni600mot de passe, ni seconde base de comptes. Détail : [`docs/IOS_AUTHENTICATION.md`](docs/IOS_AUTHENTICATION.md).601602| Couche | Mécanisme | Vérifié par |603|---|---|---|604| Identité | Clé d'accès, `AuthenticationServices` (clé de sécurité acceptée aussi) | Serveur (`@simplewebauthn/server`, vérification de l'utilisateur exigée) |605| Session | Jeton d'appareil opaque (`Authorization: Bearer`), Trousseau | Serveur (empreinte SHA-256, révocable, 90 jours d'inactivité) |606| Opérations sensibles | Nouvelle assertion de clé d'accès (`/api/native/reauth/*`), valable 5 minutes | Serveur |607| Verrou de l'app | `LocalAuthentication` (`deviceOwnerAuthentication` : biométrie, puis code de l'appareil) | Appareil seulement |608609- **Partie de confiance** : `vquant.spboucher.ai`, la même que le site. Une clé d'accès créée sur le site et synchronisée610 par le Trousseau iCloud est proposée telle quelle par iOS.611- **Enrôlement** d'un appareil sans clé : lien d'invitation à usage unique (`npm run access:invite invite <personne>` sur612 le serveur). L'app accepte le lien collé (`/setup/<jeton>`) ou le jeton seul ; 410 si le lien a expiré ou déjà servi.613- **Contrat natif** : chaque requête porte `X-VQ-Client: vquant-ios/<version> (<build>)` et aucun en-tête `Origin` (le614 pont natif refuse les navigateurs).615- **Appareils autorisés** : révoquer une autre session ou supprimer une clé répond 403 `reauth_required` sans vérification616 récente ; l'app déclenche la cérémonie puis rejoue l'opération. La dernière clé ne peut pas être supprimée (409).617- **Verrou biométrique** : activé par défaut après la première connexion (si l'appareil a un code), réglable —618 immédiatement, 1, 5 ou 15 minutes. L'activer comme le désactiver exige de réussir la vérification. Sans code619 configuré, le verrou est indisponible et l'app le dit.620- **Widgets** : aucun identifiant, aucun réseau.621- Personnes, historique, mémoire, portefeuille et veilles sont cloisonnés par personne, côté serveur.622623| Événement | Comportement |624|---|---|625| Déconnexion volontaire | Révocation serveur, puis effacement : jeton, clé du cache, cache, préférence de verrou, instantané des widgets, index Spotlight. |626| 401 avec `x-vq-locked: 1` (session révoquée ailleurs, 90 jours d'inactivité, rotation de la clé d'accès du serveur) | Même effacement, retour à l'écran de connexion avec l'explication. |627| 401 sans cet en-tête (assertion refusée) | La session reste valide ; l'erreur est affichée. |628| Hors ligne au lancement | La session est conservée, non vérifiée ; l'app ouvre ses copies locales. La première requête aboutie la confirme ou la ferme. |629630| Autorisation | Texte affiché |631|---|---|632| Face ID | « VQuant utilise Face ID pour déverrouiller l'application et confirmer les opérations sensibles sur cet appareil. » |633| Appareil photo | « VQuant utilise l'appareil photo uniquement pour lire le code QR d'un lien d'invitation. » |634635---636637## 🧪 Tests638639Résultats du 2026-11-18 (Xcode 27.2, simulateurs iOS 26.5), lus dans les journaux de `build/logs/` ; rien n'est estimé.640Plan complet et couverture par exigence : [`docs/IOS_TEST_PLAN.md`](docs/IOS_TEST_PLAN.md).641642| Suite | Commande | Tests | Résultat | Ce qu'elle couvre |643|---|---|---|---|---|644| Socle (Mac) | `Scripts/build.sh core` | 55 | 55 / 55 | décodage des réponses réelles, SSE et réducteur, indicateurs, portefeuille, cache chiffré, fraîcheur, liste de suivi, client HTTP, fenêtre du graphique |645| App (hébergée, simulateur) | `Scripts/test-live.sh test` | 29 + 4 mesures | 29 / 29 | verrou biométrique, invitation, liens profonds, formulaires de calcul, détection de fin de tâche, résumé Raccourcis, reprise de flux, rendu des graphiques, backend réel |646| Interface iPhone | `Scripts/test-live.sh uitest` | 14 (+1 optionnel) | 14 / 14 | parcours de bout en bout avec données réelles |647| Interface iPad | `VQUANT_SIM="VQuant iPad" Scripts/test-live.sh uitest` | 14 (+1 optionnel) | 14 / 14 | mêmes parcours en disposition à colonnes |648649| Environnement | Usage | Écritures |650|---|---|---|651| Fixtures (`CoreTests/Fixtures/`, 20 fichiers) | réponses réelles du backend, tronquées, capturées le 2026-11-18 | aucune |652| Copie de test `M2U64:~/dev/vquant-native` (port 5056, tunnel SSH) | tests « backend réel » et tests d'interface | oui, dans la copie seulement |653| Production `vquant.spboucher.ai` | trois requêtes de lecture sans session (fichier d'association, accueil du client iOS par le pont natif) | aucune |654655Les doublures (`URLProtocol`) ne servent qu'aux tests unitaires isolés ; l'application livrée n'en contient aucune.656657<details>658<summary><b>Les 15 tests d'interface — <code>VQuantUITests/VQuantUITests.swift</code></b></summary>659660`testSignedOutScreenOffersPasskeyAndInvitation` · `testDashboardShowsRealMarketData` ·661`testAssetChartRangesFullScreenAndFundamentals` · `testSearchFindsAndFollowsASymbol` ·662`testQuantComputationRunsOnTheServer` · `testQuantValidationErrorIsShown` · `testPortfolioPositionLifecycle` ·663`testResearchHistoryOpensAStoredReport` · `testLiveAnalysisStreamsFromTheServer` (optionnel, coût d'API) ·664`testSettingsDevicesAndDiagnostics` · `testUnreachableServerIsReportedNotFaked` ·665`testLargestAccessibilityTextSizeStaysUsable` · `testAccessibilityAudit` · `testLaunchPerformance` ·666`testRotationKeepsTheSelectedScreen`667668Le test optionnel a été exécuté une fois sur iPhone le 2026-11-18 : réussi en 22,8 s (tâche créée, flux suivi, rapport669rendu, questions de suivi affichées).670671</details>672673<details>674<summary><b>Couverture par exigence</b></summary>675676| Exigence | Tests |677|---|---|678| Authentification, session | `LiveBackendTests.sessionAndAccount`, `revokedOrUnknownTokenIsRefused`, `ClientTests.revokedSessionSignsOutLocally`, `errorMapping` |679| Clés d'accès | `AppLogicTests.passkeyAssertionShape`, `invitationParsing`, UI `testSignedOutScreenOffersPasskeyAndInvitation` |680| Face ID / Touch ID | `AppLockTests` (4) : activation et désactivation exigent la vérification, délai de grâce, annulation, remise à zéro |681| Opérations sensibles | `LiveBackendTests.sensitiveOperationsRequireFreshPasskeyVerification` |682| Révocation d'appareil | 401 `x-vq-locked` → effacement local ; liste des appareils (UI `testSettingsDevicesAndDiagnostics`) |683| Pannes réseau | `CacheTests.fetcherFallsBackOnlyOnTransportFailure`, UI `testUnreachableServerIsReportedNotFaked` |684| Reprise de flux | `RunControllerTests` (4), `StreamTests.replayAfterReconnectionDoesNotDuplicate` |685| Décodage | `DecodingTests` (12) sur réponses réelles |686| Rendu des graphiques | `ChartTests` (3) : image en clair et en sombre, 12 000 barres dans les quatre types ; `ChartViewportTests` (13) |687| Calculs de portefeuille | `QuantTests.portfolioTotals`, `portfolioHistoryKeepsOnlyCommonDates` ; UI `testPortfolioPositionLifecycle` |688| Soumission et résultat d'un calcul | `LiveBackendTests.quantJobLifecycle`, `quantValidationErrorsComeFromTheServer` ; UI `testQuantComputationRunsOnTheServer`, `testQuantValidationErrorIsShown` |689| Cache hors ligne | `CacheTests` (chiffrement constaté sur disque, altération rejetée, clé étrangère rejetée) |690| Notifications | `AppLogicTests.backgroundCompletionDetection` (seules les tâches suivies par l'appareil sont annoncées) |691| Rotation | `testRotationKeepsTheSelectedScreen`, rotation du graphique plein écran |692| Dynamic Type | `testLargestAccessibilityTextSizeStaysUsable` (taille Accessibilité XL) |693| Garde-fous d'écriture | confirmation explicite avant d'enregistrer une position, soumission refusée jamais rejouée (`refusedSubmissionIsNotRetried`), symbole inconnu refusé (`unknownSymbolIsAnErrorNotAZero`) |694| Aucune donnée fabriquée | `quoteWithoutPriceIsRejectedNotZeroed`, `portfolioTotals` (positions sans cours exclues et signalées), `testUnreachableServerIsReportedNotFaked` |695696</details>697698---699700## ♿ Accessibilité et performance701702**Accessibilité.** `testAccessibilityAudit` exécute `performAccessibilityAudit` d'Apple (description des éléments,703contraste, zones tactiles, traits, texte tronqué) sur Accueil, Marchés, fiche d'actif, Recherche et Portefeuille.704705- Premier passage : 59 constats. Corrigés : orange d'accent trop clair sur fond clair (2,9:1 → 5,2:1, teinte dédiée au706 mode clair), verts, rouges et gris secondaires renforcés, zones tactiles du graphique portées à 44 pt, badges marqués707 comme texte statique, noms d'indices sur plusieurs lignes, ligne d'analyse qui s'empile aux grandes tailles.708- Sur iPad, 7 constats de plus, corrigés (en-têtes de la barre latérale, lien du site de la société).709- État final : **0 constat bloquant** sur iPhone comme sur iPad. Des constats restent consignés sans faire échouer le710 test, avec leur motif dans la pièce jointe `accessibility-findings` (38 sur iPhone, 33 sur iPad) : contraste mesuré à711 travers le flou des barres du système ou la barre latérale translucide, styles système, texte tronqué aux plus grandes712 tailles sur des lignes volontairement uniques. Ce classement est un jugement écrit dans le test, à revoir lors du713 passage VoiceOver sur appareil.714- La direction d'une variation n'est jamais portée par la couleur seule (signe et flèche). Chaque graphique est un715 élément d'accessibilité avec un résumé en français.716717**Performance** (mesures XCTest, simulateur, build Debug) :718719| Mesure | Résultat |720|---|---|721| Lancement à froid jusqu'à la première image (`XCTApplicationLaunchMetric`, 3 itérations) | iPhone 0,90 s · iPad 1,00 s |722| Une image complète du graphique, 12 000 barres quotidiennes, 5 indicateurs, 3 panneaux, encodage PNG compris | 35 ms |723| Six indicateurs sur 12 000 clôtures | 44 ms |724| Analyse Markdown d'un rapport de 60 sections | 5 ms |725| Cache : 10 × (chiffrer, écrire, lire, déchiffrer 1 Mo) | 15 ms |726| Taille de l'IPA de distribution | 3,8 Mo |727728Ces chiffres viennent d'un simulateur sur Mac, en configuration Debug : ils situent des ordres de grandeur et servent729de garde-fou contre les régressions. Ils ne disent rien de l'énergie, de la mémoire ni de la fluidité sur un iPhone.730**Instruments n'a pas été exécuté** : il faut un appareil physique.731732---733734## 📦 Publication735736Distribution **TestFlight** (App Store Connect). Une app iOS est signée et provisionnée ; il n'y a pas d'étape de737notarisation.738739```bash740# incrémenter CURRENT_PROJECT_VERSION dans project.yml, puis :741Scripts/release.sh archive # archive Release, signature automatique (compte Apple de Xcode), affiche identité et droits742Scripts/release.sh export # IPA (Scripts/ExportOptions.plist) → dist/export/VQuant.ipa743Scripts/release.sh validate # validation par Apple744Scripts/release.sh upload # envoi à TestFlight — seulement sur demande : c'est une action tournée vers l'extérieur745```746747| Élément | Valeur |748|---|---|749| Équipe | `3YM54G49SN` |750| Signature | automatique ; l'archive est signée avec le compte Apple de Xcode (requis par le groupe d'apps) |751| Fiche | **VQuant**, `6836574364`, SKU `vquant-ios-001`, fr-CA |752| État | 1.0.0 (1) : archive et IPA « Apple Distribution » produites, `codesign --verify --deep --strict` réussi, validation « VERIFY SUCCEEDED », build `VALID` sur TestFlight en test interne (2026-11-18) |753754Le backend ne se déploie pas depuis ce dépôt : il vit dans [vquant](https://git.spboucher.ai/vquant), sur le nœud M2U64755(port 5000, orchestrateur `mld`, PM2), exposé par le MacLustr Tunnel (Caddy + WireGuard) sous `vquant.spboucher.ai`.756757---758759## 📊 Parité web, macOS, iPhone, iPad760761✅ disponible · ◐ partiel · — absent · n/v non vérifié. La colonne macOS décrit un projet qui était **en construction762par une autre session** au moment de l'inspection : ses fonctions sont « n/v ». Vérifié : **T** test automatisé contre763le backend de test, **U** test d'interface, **M** observé à la main sur simulateur, **—** non vérifié sur appareil.764Source : [`docs/IOS_FEATURE_PARITY.md`](docs/IOS_FEATURE_PARITY.md).765766<details>767<summary><b>Matrice complète</b></summary>768769| Fonction | Web | macOS | iPhone | iPad | Vérifié | Remarque |770|---|---|---|---|---|---|---|771| Connexion par clé d'accès | ✅ | n/v | ✅ | ✅ | T (forme des messages) ; cérémonie réelle — | même partie de confiance, mêmes clés |772| Enrôlement par lien d'invitation | ✅ | n/v | ✅ | ✅ | U (validation du lien) ; cérémonie — | lien à coller (pas d'`applinks`) |773| Verrou Face ID / Touch ID | — | n/v | ✅ | ✅ | T (logique) ; matériel — | propre aux apps |774| Appareils autorisés, révocation | — (CLI serveur) | n/v | ✅ | ✅ | T, U | vérification fraîche exigée par le serveur |775| Lancer une analyse (4 modes) | ✅ | n/v | ✅ | ✅ | T (flux simulé), U optionnel (réel) | modèle par défaut du serveur |776| Choix du modèle | ✅ | n/v | — | — | | aucune route n'expose la liste en production |777| Image jointe à une question | ✅ | n/v | ✅ | ✅ | M | photothèque |778| Dictée (transcription serveur) | ✅ | n/v | — | — | | dictée du clavier iOS à la place |779| Suivi en direct, reprise après coupure | ✅ | n/v | ✅ | ✅ | T | reprise à l'index du dernier événement |780| Arrêter une analyse | ✅ | n/v | ✅ | ✅ | M | |781| Plan, outils, sous-analystes | ✅ | n/v | ✅ | ✅ | T | chronologie repliable |782| Rapport : Markdown, tableaux, figures, marqueurs | ✅ | n/v | ✅ | ✅ | T, U | rendu natif, pas de vue web |783| Formules LaTeX | ✅ | n/v | ◐ | ◐ | | affichées en texte à chasse fixe |784| Sources, données et code du rapport | ✅ | n/v | ✅ | ✅ | T | piste d'audit complète |785| Questions de suivi | ✅ | n/v | ✅ | ✅ | T | |786| Historique : recherche, épingler, renommer, supprimer | ✅ | n/v | ✅ | ✅ | T, U | |787| Export PDF (mis en page par le serveur) | ✅ | n/v | ✅ | ✅ | M | |788| Export DOCX, diapositives Beamer | ✅ | n/v | — | — | | non porté |789| Partager un rapport (lien public) | ✅ | n/v | — | — | | partage système du texte à la place |790| Bibliothèque de rapports partagés | ✅ | n/v | ✅ | ✅ | T | |791| Mémoire de l'agent | ✅ | n/v | ✅ | ✅ | T | |792| Veilles planifiées | ✅ | n/v | ✅ | ✅ | M | exécutées par le serveur |793| Portefeuille déclaratif | ✅ | n/v | ✅ | ✅ | T, U | confirmation explicite avant écriture |794| Valorisation, répartition, corrélations, drawdown | — | n/v | ✅ | ✅ | T (calculs), U | calculs descriptifs sur l'appareil |795| Tableau triable des positions | — | n/v | — | ✅ | U | `Table` iPad |796| Indices, cotations, mouvements du jour | ◐ (bandeau) | n/v | ✅ | ✅ | T, U | |797| Recherche de symbole | — | n/v | ✅ | ✅ | T, U | route ajoutée pour les clients natifs |798| Graphique interactif (chandeliers, OHLC, ligne, aire) | — | n/v | ✅ | ✅ | T (rendu), U | pincer, glisser, réticule |799| Indicateurs (SMA, EMA, Bollinger, RSI, MACD, volume) | — | n/v | ✅ | ✅ | T | |800| Plein écran paysage, export image et CSV | — | n/v | ✅ | ✅ | U (plein écran, rotation) ; export M | |801| Annotations Apple Pencil | — | n/v | ◐ (doigt) | ✅ | — | ancrées à l'écran, pas au prix |802| Fondamentaux (12 tableaux) | — (via l'agent) | n/v | ✅ | ✅ | T, U | |803| Actualités | — (via l'agent) | n/v | ✅ | ✅ | T | |804| Liste de suivi | — | n/v | ✅ | ✅ | T, U | locale à l'appareil |805| Calculs quantitatifs directs (6 moteurs) | — (via l'agent) | n/v | ✅ | ✅ | T, U | `/api/quant/*` |806| Fenêtres multiples, raccourcis clavier | n/a | n/v | — | ✅ | M (compilation) ; usage — | |807| Widgets (marchés, suivi, favori, analyses) | n/a | n/v | ✅ | ✅ | M (compilation) ; écran d'accueil — | |808| Siri / Raccourcis / Spotlight | n/a | n/v | ✅ | ✅ | T (résumé parlé) ; Siri — | |809| Notifications de fin de tâche | — | n/v | ◐ | ◐ | T (détection) | locales, pas de push |810| Lecture hors ligne | — | n/v | ✅ | ✅ | T, U (serveur injoignable) | copies chiffrées |811| Thème clair / sombre, Dynamic Type, VoiceOver | ◐ | n/v | ✅ | ✅ | U (taille XL) ; VoiceOver — | |812| Console d'administration, statistiques d'usage | ✅ | n/v | — | — | | hors périmètre mobile |813| Ordres, courtage | — | — | — | — | | n'existe nulle part dans VQuant |814815</details>816817---818819## 🩺 Points à connaître et pièges820821- **Identifiant partagé** : `ai.spboucher.vquant` est aussi celui du client macOS ; c'est celui que publie le fichier822 `apple-app-site-association` du serveur. Le changer casse les clés d'accès.823- **Le serveur n'appartient pas à ce dépôt** : il relève du dépôt [vquant](https://git.spboucher.ai/vquant) sur son824 nœud et de la session du client macOS. Toute évolution d'API passe par là (règle « remote-first »). Rien n'a été ajouté825 au serveur par ce projet ; la branche `native-clients` du backend (`GET /api/config`, script de jeton de test) n'est826 pas fusionnée et l'app n'en dépend pas.827- **Groupe d'apps** : l'archive doit être signée avec le compte Apple de Xcode (`-allowProvisioningUpdates` seul).828- **Numéro de build** : incrémenter `CURRENT_PROJECT_VERSION` dans `project.yml` avant chaque envoi.829- **Pas d'`applinks`** dans le fichier d'association : un lien d'invitation touché dans Safari ouvre le site, pas l'app ;830 il faut le coller.831- **Association de domaine** : le fichier est mis en cache par le CDN d'Apple ; la première connexion peut échouer832 quelques minutes après l'installation (message explicite dans l'app).833- **401 à deux sens** : avec `x-vq-locked: 1` la session est morte (effacement local) ; sans cet en-tête, seule la834 cérémonie est refusée et la session reste valide.835- **Copie de test injoignable** : `test-live.sh` l'annonce et renvoie à `M2U64:~/dev/vquant-native/run-test-copy.sh`.836- **Simulateurs** : deux fois le simulateur a refusé de lancer le processus de test837 (`FBSOpenApplicationServiceErrorDomain`) pendant que cinq simulateurs d'autres projets tournaient ; relancer la suite.838- **Orange de marque** : #FF6A1A ne fait que 2,9:1 sur fond clair ; `Theme` utilise une teinte dédiée au mode clair.839- **Fichiers générés** : `VQuant.xcodeproj` et `Info-Debug.plist` ne sont pas versionnés → `Scripts/build.sh generate`.840841---842843## 🚧 Limites connues et reste à valider844845### Non porté (reste sur le web)846847Choix du modèle, dictée par transcription serveur, export DOCX et diapositives Beamer, partage d'un rapport par lien848public, console d'administration et statistiques d'usage. Formules LaTeX : affichées en texte à chasse fixe.849Live Activities et notifications push : non implémentées (pas d'APNs côté serveur). Annotations : ancrées à l'écran, pas850au prix.851852### À valider sur un appareil physique853854Aucun iPhone ni iPad n'était branché au Mac pendant ce travail.8558561. Connexion par clé d'accès réelle (domaine associé, feuille système, Face ID), enrôlement par invitation, vérification857 fraîche avant une révocation.8582. Verrou Face ID / Touch ID matériel, masquage dans le sélecteur d'apps.8593. Gestes du graphique au doigt (pincer, glisser, appui long), survol au trackpad, Apple Pencil.8604. Widgets sur l'écran d'accueil et l'écran verrouillé, Raccourcis et Siri, Spotlight.8615. Actualisation en arrière-plan et notification de fin de tâche (dépend d'iOS).8626. Mode avion (le test automatisé simule un serveur injoignable, pas la coupure de la radio).8637. Fenêtres multiples, Stage Manager, écran externe, raccourcis clavier matériels.8648. Profilage Instruments.8659. Passage complet à VoiceOver par une personne.86610. Installation du build sur du matériel (le build est sur TestFlight ; rien n'a encore été installé sur un appareil).867868---869870## 👤 Auteur871872<div align="center">873<img src="docs/brand/icon.png" width="64" height="64" alt="">874<br>875876**Simon-Pierre Boucher** — conception, développement, exploitation877<br>878[www.spboucher.ai](https://www.spboucher.ai) · [git.spboucher.ai](https://git.spboucher.ai) · contact@spboucher.ai879880</div>881882---883884## 📄 Licence885886Logiciel privé. Tous droits réservés © 2026 Simon-Pierre Boucher.887