VQuant iOS / iPadOS 2.0 « VQuant Next » — architecture
État au 2026-11-20 (branche next, 2.0.0 build 2, non publiée). Application 100 % native (Swift 6, SwiftUI,
concurrence stricte complete), sans vue web. Cible iOS 18+, iPhone et iPad. Identifiants inchangés depuis 1.0 :
bundle ai.spboucher.vquant, extension ai.spboucher.vquant.widgets, groupe d'apps group.ai.spboucher.vquant,
domaine associé webcredentials:vquant.spboucher.ai, équipe 3YM54G49SN.
2.0 est une mise à niveau de 1.0, pas une réécriture : tout ce que 1.0 faisait reste en place (voir
IOS_FEATURE_PARITY.md, colonne « 1.0 → 2.0 »). Ce document décrit ce qui change.
1. Ce que devient VQuant
VQuant est d'abord l'agent de recherche quantitative autonome ; marchés, Quant Lab, portefeuilles et studio sont
des surfaces autour de lui. Tout calcul s'exécute sur le serveur (backend 6, contrat
vquant-next/docs/next/CONTRACT.md). L'appareil lance, suit, inspecte et reprend : il n'exécute jamais de Python.
Les seuls calculs faits sur l'appareil sont, comme en 1.0, des statistiques descriptives légères sur des observations
reçues (moyennes mobiles, RSI, drawdown, corrélations) et l'arithmétique qui transforme un résultat de moteur en
montant (VaR en % × valeur saisie, budget de risque ÷ VaR), formule affichée.
| Élément | 1.0 | 2.0 |
|---|---|---|
| Compte | chaque appareil pour soi (liste de suivi locale) | un compte synchronisé : objets /api/v2/objects, flux /api/v2/sync |
| Agent | 4 modes d'analyse, modèle par défaut | + recherche autonome (espace de travail, registre, contrôle de qualité), modèle au choix ou Auto, budget, jeu de données |
| Calculs | 6 moteurs | 19 moteurs (en-tête vquant-ios/2.0.0), schéma lab/1, progression, annulation |
| Données de marché | proxy FMP par symbole | couche de données /api/v2/data/* avec provenance et fraîcheur ; les routes 1.0 restent en repli |
| Notifications push | aucune (pas d'APNs côté serveur) | toujours aucune : notifications locales, y compris pour les demandes d'autorisation |
2. Vue d'ensemble
iPhone / iPad ── HTTPS ──▶ vquant.spboucher.ai ──▶ backend 6 (Node/Express, SQLite, moteurs Python isolés)
│ Bearer vqn_… · X-VQ-Client: vquant-ios/2.0.0 (2)
├─ APIClient (Core) ── routes 1.0 : /api/native, /api/fmp, /api/chat, /api/generations, /api/sessions, /api/workspace
└─ IOSVQTransport ──▶ VQuantKit ── /api/v2 : objects, sync (SSE), data, market, search, models, usage, projects,
│ reviews, research ; /api/quant (catalogue 19 moteurs, jobs, annulation)
└─ VQSyncEngine (acteur) ── réplique chiffrée dans le conteneur du groupe d'apps + file d'écritures durable
Widgets ◀─ instantané JSON (aucun réseau, aucun jeton, aucune clé de déchiffrement)3. Organisation du code
Core/ socle 1.0 sans interface, inchangé dans son rôle (compilé dans l'app et les widgets, paquet
SwiftPM VQuantCore, tests sur Mac). Ajouts additifs : mode `research`, `budget` / `projectId` du
corps de /api/chat, JSON brut de chaque événement de flux (`StreamItem.raw`).
../VQuantKit paquet partagé avec le client macOS (dépendance locale du projet) :
VQuantKit (moteur de synchro, modèles v6, Quant Lab, clients de recherche),
VQuantUI (jetons VQTokens, composants, LabResultView, vues de recherche), VQuantKitTesting.
VQuant/
App/ VQuantApp (scènes, commandes clavier), AppModel, Stores, AppSupport (sections, routes, routeur)
Next/ tout ce que 2.0 ajoute :
NextTransport adaptateur APIClient → VQTransport, chiffrement de la réplique
SyncCenter moteur de synchro de la personne connectée, collections observables, migration 1.0
NextServices magasins : terminal, modèles, Quant Lab, portefeuilles, studio ; ResearchHub (espaces, autorisations)
ResearchViews composition, cockpit d'étude, autorisations, étude conservée sur le serveur
TerminalViews vue des marchés, courbe des taux, calendrier, recherche universelle, états financiers
LabViews, QuickCalcViews catalogue, formulaires tactiles, jobs, résultats, calculs rapides
StudioViews projets, notes, revues, export, consommation, état de la synchronisation et conflits
WorkspaceViews espaces de travail (arbre de disposition, séparateurs, panneaux)
ChartDrawing tracés ancrés au temps et au prix, poste de graphique
Features/, Charts/, Auth/, Platform/, DesignSystem/ écrans et services de 1.0, adaptés
VQuantWidgets/ quatre widgets (lient VQuantUI pour les jetons de couleur seulement)
CoreTests/, VQuantTests/ (dont NextTests), VQuantUITests/L'adaptateur de transport
IOSVQTransport remet à APIClient.urlRequest le chemin décodé (ce client encode lui-même le chemin) :
/api/v2/data/bars/^GSPC part bien en %5EGSPC (test symbolsWithACaretAreEncodedOnce, et appel réel dans
dataLayerThroughTheAdapter). Il transmet contentType (multipart pour le dépôt d'un jeu de données) et, sur un 401
x-vq-locked, déclenche le même chemin de déconnexion que 1.0.
4. Un compte, synchronisé
SyncCenter crée un VQSyncEngine par personne connectée :
- Réplique dans
group.ai.spboucher.vquant/sync/<personne>/, scellée en AES-256-GCM avec la clé du cache de 1.0 (Trousseau) par le crochetVQSyncCipherdu paquet, exclue des sauvegardes. Démarrée à la connexion (et au lancement hors ligne avec la dernière personne connue), effacée à la déconnexion et sur session morte, comme le cache. - Écritures : d'abord dans la file durable du moteur (affichées aussitôt), puis rejouées dans l'ordre. Hors ligne elles attendent ; l'état (« Synchronisé », « n modifications en attente », « Hors ligne », « Session fermée ») est visible sur l'accueil, dans la barre latérale de l'iPad et dans Plus › Synchronisation, avec la file et les conflits.
- Conflits (convention commune aux trois clients) : listes fusionnées par élément (symboles, positions, éléments de
projet, tracés) ; pour le reste, dernière écriture gagnante par champ (
granularity = .field) ; les espaces de travail restent en objet entier. Un conflit qui a écrasé du contenu apparaît dans l'écran de synchronisation avec les deux versions, « garder la mienne » ou « reprendre celle de l'autre appareil ». - Flux : le moteur ouvre
/api/v2/sync/stream, tire à chaquechange, et relaie leshint(analyses, sessions, calculs) qui rafraîchissent les listes. iOS ferme le flux en arrière-plan : au retour au premier plan un tour complet est fait.BGAppRefreshTaskfait un tour quand iOS l'accorde.
Migration des données de 1.0 (une fois, par personne)
| Donnée 1.0 | Devient | Détail |
|---|---|---|
Liste de suivi (watchlist.json du groupe d'apps) |
un objet watchlist d'identifiant fixe ios-watchlist |
Identifiant fixe : un deuxième appareil qui migre le même compte reçoit un 409 et le moteur fusionne (union des symboles) — ni perte ni doublon (tests à deux appareils). Le fichier est conservé en watchlist.migrated.json. |
| Portefeuille | objet portfolio/main |
Fait par le serveur (pont du contrat §1.4). L'app n'écrit plus /api/workspace/portfolio. La confirmation explicite avant écriture est conservée. |
| Annotations de graphique (PencilKit, par symbole) | tracés pencil de l'objet chart sym-<SYMBOLE> |
Non convertibles automatiquement : elles étaient liées à l'écran, sans la vue d'origine. Le poste de graphique les affiche en surimpression ; la personne choisit la période et le zoom où elles tombent juste, puis « Ancrer à cette vue » les convertit point par point en (temps, prix). Fichier gardé en .migrated. Sans ce geste, elles restent sur l'appareil. |
| Préférences | preference/default |
Synchronisés : mode et modèle par défaut, budget, paire de couleurs hausse/baisse. Non synchronisé : le thème clair/sombre (choix par appareil), et les réglages propres à l'appareil (actualisation, notifications, haptique). |
5. Recherche autonome
- Composition : question, mode (recherche autonome ou les quatre modes d'analyse), modèle du registre du serveur avec logo du fournisseur et « Auto », budget (coût, durée), projet, image, jeu de données depuis Fichiers (vérifié comme le fera le serveur, déposé dans l'espace de travail créé pour l'étude, puis profilé : carte d'inspection).
- Suivi :
RunController(1.0) suit le flux de la génération et le rejoue après coupure ; chaque événement brut alimente aussi leVQResearchSessionStoredu paquet.StudyCockpitprésente Rapport · Activité · Code · Expériences · Figures · Fichiers avec les vues de recherche partagées : sélecteur segmenté sur iPhone, rapport + inspecteur redimensionnable sur iPad. - Reprise : une étude lancée sur le Mac ou le web apparaît dans « Sur le serveur » (flux rejouable) et dans « Études autonomes » (espace de travail lu par REST, conservé pour la lecture hors ligne).
- Autorisations : carte proéminente (accueil, espace de recherche, étude) et notification locale avec « Autoriser » / « Refuser ». Sans APNs, la notification n'est émise que lorsque l'appareil apprend la demande : flux ouvert, relève toutes les 6 s pendant qu'une étude tourne, actualisation en arrière-plan accordée par iOS.
6. iPhone et iPad
- iPhone : cinq onglets (Accueil, Marchés, Recherche, Portefeuilles, Plus). L'accueil est centré sur l'agent.
- iPad :
NavigationSplitViewà trois colonnes par destination (barre latérale, liste, détail) pour Recherche, Marchés, Quant Lab, Portefeuilles, Studio, Espaces de travail, Bibliothèque ; deux colonnes ailleurs. Toute destination s'ouvre dans sa propre fenêtre (WindowGroup(for: Route.self)). Raccourcis clavier pour chaque destination et commande principale (menus Fichier, Aller à, Recherche, Marchés, Quant Lab, Présentation), visibles dans le panneau ⌘. Glisser-déposer : symboles (listes, graphique, composition, panneaux), fichiers vers la composition, figures et exports par Quick Look. - Espaces de travail : l'arbre
layoutd'un objetworkspaceest rendu parLayoutNodeView(lignes et colonnes imbriquées, séparateurs déplaçables, tailles enregistrées en pourcentages comme le web) ; panneaux natifs : graphique, liste de suivi, cotation, états financiers, recherche, Quant Lab, portefeuille, note. Les autres types (news,options,macro…) sont conservés et signalés comme sans rendu natif. En fenêtre étroite (< 620 pt) les panneaux s'empilent.
7. Graphiques
Le rendu Canvas de 1.0 est conservé. Les barres viennent de /api/v2/data/bars (provenance affichée : fournisseur,
ajustement réellement appliqué, observations, séances manquantes) ; si la route est injoignable, la route 1.0 répond.
Une barre quotidienne de la couche de données est datée 00:00 UTC de sa séance ; l'app l'affiche à la date de séance
en heure de New York, et un point de tracé garde l'horodatage du serveur (ChartTime). Les tracés (ligne de tendance,
horizontale, rectangle, Fibonacci, note, mesure — mêmes types que le web — et tracé libre pencil) sont dans l'objet
chart du symbole (sym-<SYMBOLE>, convention du web). « Demander à l'agent » envoie le symbole, l'intervalle, les
dates exactes de la fenêtre visible, les indicateurs affichés et les niveaux tracés.
8. Design
Identité « VQuant Next » par les jetons VQTokens (générés depuis le dépôt web) : Theme n'est plus qu'une table de
correspondance vers eux. Titres en New York, interface en SF, nombres en SF Mono à chiffres tabulaires, filets,
surfaces papier, verre laissé aux barres du système. L'accent Ember (#FF6A1A) ne sert qu'en aplat (action
primaire, marque de l'agent) avec une encre sombre ; tout texte d'accent utilise accentText (l'audit de 1.0
avait mesuré 2,9:1 pour l'orange de marque sur fond clair). Vocabulaire de fraîcheur du contrat : jamais « en
direct » (interrogé, différé, clôture, historique, estimé).
9. Limites connues
Voir IOS_TEST_PLAN.md §7 (ce qui n'a jamais été vérifié sur un appareil) et IOS_FEATURE_PARITY.md. En bref : pas
de push, pas de Live Activities, dépôt de jeux de données en mémoire (pas de session d'arrière-plan : gros fichiers à
éviter sur réseau cellulaire), formules LaTeX rendues lisibles mais non composées, panneaux d'espace de travail
news / options / macro / risk / table / notebook sans rendu natif.