SPB Git

Repository Public

IOS_API_MAPPING.md 12.2 KB 196 lines markdown

1<!--2VQuant iOS3File: docs/IOS_API_MAPPING.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->78# Correspondance API — routes réelles du backend et leur usage dans l'app910État 2.0 (2026-11-20). Deux clients dans l'app :1112- `Core/Networking/VQuantAPI.swift` — les routes de **1.0** (v5.8.0), toujours servies par le backend 6 (ajouts13  seulement) ; réponses de référence dans `CoreTests/Fixtures/`.14- `VQuantKit` (paquet partagé, à travers `VQuant/Next/NextTransport.swift`) — les routes **`/api/v2`** du backend 6 et15  le catalogue étendu de `/api/quant`. Contrat : `vquant-next/docs/next/CONTRACT.md`. Vérifié contre le backend de16  test figé `M2U64:5058` (`NextLiveTests`, tests d'interface).1718Chaque requête porte `X-VQ-Client: vquant-ios/2.0.0 (2)` : cet en-tête ouvre les 19 moteurs et le statut `cancelled`19(un en-tête 1.x ne reçoit que les six moteurs de 1.0 — vérifié par `theNextHeaderUnlocksTheLabEngines`). Aucune route20n'a été inventée. Les sections « 1.0 » ci-dessous restent exactes ; les changements d'usage sont notés.2122## Backend 6 — ce que 2.0 consomme2324### Synchronisation (CONTRACT §1)2526| Route | Par | Écran |27|---|---|---|28| `GET /api/v2/sync/changes?since=` | `VQSyncEngine.pull` | démarrage, retour au premier plan, tirer pour actualiser, actualisation en arrière-plan |29| `GET /api/v2/sync/stream` (SSE : `hello`, `change`, `hint`) | `VQSyncEngine.start` | état de synchronisation ; les `hint` rafraîchissent analyses, conversations, calculs |30| `PUT /api/v2/objects/:kind/:id` `{data, baseRev}` | `VQSyncEngine.flush` (file durable) | toute modification d'un objet ; 409 → fusion |31| `DELETE /api/v2/objects/:kind/:id?baseRev=` | idem | suppression d'une liste, d'un portefeuille, d'un projet, d'une note, d'un espace |3233Objets utilisés : `watchlist` (Marchés, Accueil, widget), `portfolio` (`main` = celui de l'agent), `chart`34(`sym-<SYMBOLE>` : tracés), `project`, `note`, `review` (lecture seule, écrit par le serveur), `workspace`,35`preference` (`default`). Non utilisés : `…/versions` (historique des révisions — pas d'écran).3637### Modèles et consommation (§2)3839| Route | Fonction du paquet | Écran |40|---|---|---|41| `GET /api/v2/models` | `ModelStore.refresh` | sélecteur de modèle (fournisseurs, logos, Auto), Réglages |42| `GET /api/v2/usage?days=30` | `ModelStore.refreshUsage` | Plus › Consommation et coûts |43| événements `model_routed`, `budget`, `provenance`, `done.usage` du flux | `VQGenerationEvent` | en-tête de l'étude, provenance des données |4445Non utilisées : `GET /api/v2/models/route` (aperçu du routage), `GET /api/v2/generations/:id/trace` (la chronologie46vient du flux et de l'espace de travail).4748### Couche de données et terminal (§3)4950| Route | Fonction | Écran |51|---|---|---|52| `GET /api/v2/market/overview` | `TerminalStore.refreshOverview` | Accueil (indices), Terminal (sections, courbe des taux, calendrier) |53| `GET /api/v2/data/quotes?symbols=` (≤ 60) | `MarketStore.refreshQuotes` | toutes les cotations (liste, portefeuilles, panneaux) ; repli sur `/api/fmp/quote/:symbol` |54| `GET /api/v2/data/bars/:symbol?interval=&from=` | `MarketStore.bars` | graphiques, historique de portefeuille ; repli sur `/api/fmp/chart/*` |55| `GET /api/v2/data/statements/:symbol?period=&limit=` | `TerminalStore.statements` | États financiers (fiche d'actif, panneau) |56| `GET /api/v2/search?q=` | `TerminalStore.search` | recherche universelle (⌘K) |57| `GET /api/v2/data/health` | `TerminalStore.refreshHealth` | Terminal › Fournisseurs de données |5859### Quant Lab (§4)6061| Route | Fonction | Écran |62|---|---|---|63| `GET /api/quant/tools` (19 outils, `category`, `resultSchema`, groupes, types `date` / `text` / `json`) | `LabStore.refreshCatalog` | catalogue par catégorie, formulaires |64| `POST /api/quant/jobs` `{tool, params, projectId?}` | `LabStore.start` | formulaire, calculs rapides, analyse de portefeuille |65| `GET /api/quant/jobs`, `GET /api/quant/jobs/:id` | `LabStore.refreshJobs`, `.job` | liste (progression), résultat |66| `POST /api/quant/jobs/:id/cancel` | `LabStore.cancel` | bouton Annuler (moteurs `lab/1`) |67| `DELETE /api/quant/jobs/:id` | `LabStore.delete` | balayage |6869### Studio (§5) et recherche autonome (§9)7071| Route | Fonction | Écran |72|---|---|---|73| `GET /api/v2/projects/:id/bundle` | `StudioStore.bundle` | projet (titres et états résolus des éléments) |74| `POST /api/v2/projects/:id/export` + `GET /api/download/:filename` | `StudioStore.export` | export PDF / Markdown / LaTeX / ZIP, Quick Look, partage |75| `POST /api/v2/reviews` | `StudioStore.review` | revue automatisée d'une analyse, d'un calcul, d'une note |76| `POST /api/chat` avec `mode: "research"`, `model`, `budget`, `projectId` | `ResearchStore.start` | composition |77| `GET /api/v2/research/sessions`, `GET …/:id` | `ResearchHub` | études autonomes, étude conservée |78| `POST /api/v2/research/sessions` | `ResearchHub.createSession` | création de l'espace avant le premier message (dépôt d'un jeu de données) |79| `POST …/:id/upload` (multipart), `GET …/:id/inspect?path=` | `ResearchHub.upload`, `.inspect` | jeu de données et sa carte d'inspection |80| `GET …/:id/file?path=` (texte ou octets) | `ResearchHub.textFile`, `.fileData` | code, journaux, figures, fichiers (copie chiffrée pour le hors-ligne) |81| `GET /api/v2/research/runs/:id`, `POST …/cancel` | vues du paquet | exécutions longues |82| `GET /api/v2/research/approvals?status=pending`, `POST …/:id` | `ResearchHub.refreshApprovals`, `.answer` | carte d'autorisation, actions de notification |83| `GET /api/v2/research/sandbox` | `ResearchHub.refreshSandbox` | limite de dépôt, état du bac à sable |8485Événements de flux ajoutés par le backend 6 et lus par le réducteur partagé : `research_workspace`, `dataset`,86`research_file`, `code_execution`, `package_install`, `research_run`, `experiment`, `research_note`, `figure_lint`,87`approval_request`, `approval_resolved`, `quality_gate`.8889Non utilisées en 2.0 : `POST /api/v2/projects/:id/run` (la composition passe par `/api/chat` avec `projectId`, même90effet), mémoire v2 (`/api/v2/memory*` — l'écran Agent garde les routes 1.0), `GET /api/v2/audit`.9192---9394# Routes de 1.0 (toujours utilisées, sauf mention)9596Source : `vquant.git` v5.8.0 (`server/native.ts`, `server/routes.ts`, `server/routes/*.ts`).9798## Session et appareils99100| Route | Fonction | Écran |101|---|---|---|102| `POST /api/native/login/options`, `…/login/verify` | `PasskeyService.signIn` | Connexion |103| `POST /api/native/register/options`, `…/register/verify` | `PasskeyService.enrol` | Connexion › lien d'invitation |104| `POST /api/native/reauth/options`, `…/reauth/verify` | `PasskeyService.reauthenticate` | Avant révocation |105| `GET /api/native/session` | `session()` | Lancement, diagnostic |106| `POST /api/native/logout` | `logout()` | Réglages › Se déconnecter |107| `GET /api/native/devices` | `devices()` | Réglages › Appareils |108| `DELETE /api/native/devices/:id` | `revokeDevice` | idem |109| `DELETE /api/native/passkeys/:ref` | `revokePasskey` | idem |110| `GET /api/me` | `me()` | tests |111| `GET /api/health` | `health()` | Diagnostic |112113## Données de marché (proxy FMP)114115| Route | Fonction | Écran |116|---|---|---|117| `GET /api/fmp/indices` | `indices()` | Accueil, Marchés, widgets |118| `GET /api/fmp/quote/:symbol` | `quote()` | repli quand `/api/v2/data/quotes` échoue |119| `GET /api/fmp/gainers` · `losers` · `actives` | `movers()` | Marchés |120| `GET /api/fmp/market-hours` | `marketHours()` | Marchés, calcul de la fraîcheur |121| `GET /api/fmp/search?q=&limit=` | `search()` | Recherche de symbole |122| `GET /api/fmp/chart/full/:symbol?from=&to=` | `bars()` (quotidien) | Graphique 3M → Max |123| `GET /api/fmp/chart/intraday/:symbol?interval=&from=&to=` | `bars()` (5 min, 15 min, 1 h) | Graphique 1J, 5J, 1M |124| `GET /api/fmp/company-profile/:symbol` | `profile()` | Fiche › Société |125| `GET /api/fmp/financial-news/:symbol` | `news()` | Fiche › Actualités |126| `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 (tableau générique : tous les champs renvoyés, aucun inventé) |127128Non utilisées : `stock-quote` (doublon de `quote`), `historical-price` et `chart/light` (couvertes par `chart/full`),129`intraday` (couverte par `chart/intraday`), `price-target`, `esg-score`.130131## Analyses (tâches serveur)132133| Route | Fonction | Écran |134|---|---|---|135| `POST /api/chat` `{query, history, sessionId?, mode, imageData?, imageMimeType?}` → SSE | `startAnalysis` | Composition |136| `GET /api/generations` | `generations()` | Recherche, Accueil, widget, Raccourci |137| `GET /api/generations/:id/stream?from=N` → SSE | `streamGeneration` | Suivi en direct, reprise |138| `POST /api/generations/:id/cancel` | `cancelGeneration` | Bouton Arrêter |139140Événements SSE décodés (`AnalysisEvent`) : `job`, `status`, `text`, `thinking`, `plan`, `tool_start`,141`tool_complete`, `tool_error`, `tool_result`, `python_code`, `custom_python_figures`, `agent_start`, `agent_tool`,142`agent_done`, `sources`, `followups`, `error`, `done`. `tools` et `workspace` sont ignorés sciemment ; tout autre type143est conservé et signalé dans l'écran de suivi. Le champ `model` n'est pas envoyé : le serveur applique son modèle par144défaut (la liste des modèles n'est exposée par aucune route en production).145146Limites appliquées par le serveur et restituées telles quelles : 4 analyses simultanées par personne (429), une par147conversation (409), rejeu 20 minutes après la fin, liste 24 heures. Un redémarrage du serveur interrompt les analyses148en cours.149150## Conversations et rapports151152| Route | Fonction | Écran |153|---|---|---|154| `GET /api/sessions[?q=]` | `conversations()` | Recherche › Historique |155| `GET /api/sessions/:id` | `conversation()` | Conversation |156| `PATCH /api/sessions/:id` `{title}` / `{pinned}` | `renameConversation`, `pinConversation` | balayage |157| `DELETE /api/sessions/:id` | `deleteConversation` | balayage + confirmation |158| `GET /api/shared-reports`, `GET /api/share/:shareId` | `sharedReports`, `sharedReport` | Bibliothèque |159| `POST /api/generate-pdf` `{question, answer}` | `pdf()` | Conversation › PDF |160| `GET /figures/…`, `/plots/…` | `file()` | Figures des rapports |161162Non utilisées : `POST /api/share`, `POST /api/generate-docx`, `POST /api/convert-to-slides`,163`POST /api/speech-to-text`, `GET /api/download/:filename`, `/api/admin/*`, `/api/analytics/*`.164165## Calculs quantitatifs (moteurs Python du serveur)166167| Route | Fonction | Écran |168|---|---|---|169| `GET /api/quant/tools` | `quantTools()` | Calculs, formulaire |170| `POST /api/quant/jobs` `{tool, params}` → 202 | `startQuantJob` | Formulaire |171| `GET /api/quant/jobs` | `quantJobs()` | Calculs, Accueil, Raccourci |172| `GET /api/quant/jobs/:id` | `quantJob()` | Résultat (paramètres, code, résultat) |173| `DELETE /api/quant/jobs/:id` | `deleteQuantJob` | balayage |174175Moteurs au 2026-11-18 : `garch`, `var`, `monte_carlo`, `options`, `portfolio_optimization`, `risk_metrics`. Il n'existe176pas de route d'annulation ; au plus 3 calculs simultanés par personne. Le formulaire est construit depuis `params`177(type, défaut, bornes, choix) ; le serveur revalide et renvoie les paramètres effectivement appliqués.178179## Espace de travail180181| Route | Fonction | Écran |182|---|---|---|183| `GET /api/workspace` | `workspace()` | Portefeuille, Agent, Accueil |184| `PUT /api/workspace/portfolio/:symbol` `{quantity, costBasis?, note?}` | `upsertPosition` | Portefeuille |185| `DELETE /api/workspace/portfolio/:symbol` | `removePosition` | Portefeuille |186| `POST /api/workspace/memories`, `DELETE …/:id` | `addMemory`, `deleteMemory` | Agent › Mémoire |187| `POST /api/workspace/watches`, `PATCH …/:id`, `DELETE …/:id`, `POST …/:id/run` | `createWatch`, `updateWatch`, `deleteWatch`, `runWatch` | Agent › Veilles |1881892.0 : `PUT` / `DELETE /api/workspace/portfolio/:symbol` ne sont plus appelées (les positions sont écrites dans l'objet190`portfolio`), `GET /api/workspace` sert encore la mémoire et les veilles.191192## Ce qui n'existe pas côté serveur193194Flux WebSocket de cotations, ordres ou courtage, **push APNs** (toutes les notifications sont locales), sessions web195par appareil.196
Files main
Menu

Theme