SPB Git

Repository Public

IOS_API_MAPPING.md 12.2 KB

# Correspondance API — routes réelles du backend et leur usage dans l'app

État 2.0 (2026-11-20). Deux clients dans l'app :

  • Core/Networking/VQuantAPI.swift — les routes de 1.0 (v5.8.0), toujours servies par le backend 6 (ajouts seulement) ; réponses de référence dans CoreTests/Fixtures/.
  • VQuantKit (paquet partagé, à travers VQuant/Next/NextTransport.swift) — les routes /api/v2 du backend 6 et le catalogue étendu de /api/quant. Contrat : vquant-next/docs/next/CONTRACT.md. Vérifié contre le backend de test figé M2U64:5058 (NextLiveTests, tests d'interface).

Chaque requête porte X-VQ-Client: vquant-ios/2.0.0 (2) : cet en-tête ouvre les 19 moteurs et le statut cancelled (un en-tête 1.x ne reçoit que les six moteurs de 1.0 — vérifié par theNextHeaderUnlocksTheLabEngines). Aucune route n'a été inventée. Les sections « 1.0 » ci-dessous restent exactes ; les changements d'usage sont notés.

# Backend 6 — ce que 2.0 consomme

# Synchronisation (CONTRACT §1)

Route Par Écran
GET /api/v2/sync/changes?since= VQSyncEngine.pull démarrage, retour au premier plan, tirer pour actualiser, actualisation en arrière-plan
GET /api/v2/sync/stream (SSE : hello, change, hint) VQSyncEngine.start état de synchronisation ; les hint rafraîchissent analyses, conversations, calculs
PUT /api/v2/objects/:kind/:id {data, baseRev} VQSyncEngine.flush (file durable) toute modification d'un objet ; 409 → fusion
DELETE /api/v2/objects/:kind/:id?baseRev= idem suppression d'une liste, d'un portefeuille, d'un projet, d'une note, d'un espace

Objets utilisés : watchlist (Marchés, Accueil, widget), portfolio (main = celui de l'agent), chart (sym-<SYMBOLE> : tracés), project, note, review (lecture seule, écrit par le serveur), workspace, preference (default). Non utilisés : …/versions (historique des révisions — pas d'écran).

# Modèles et consommation (§2)

Route Fonction du paquet Écran
GET /api/v2/models ModelStore.refresh sélecteur de modèle (fournisseurs, logos, Auto), Réglages
GET /api/v2/usage?days=30 ModelStore.refreshUsage Plus › Consommation et coûts
événements model_routed, budget, provenance, done.usage du flux VQGenerationEvent en-tête de l'étude, provenance des données

Non utilisées : GET /api/v2/models/route (aperçu du routage), GET /api/v2/generations/:id/trace (la chronologie vient du flux et de l'espace de travail).

# Couche de données et terminal (§3)

Route Fonction Écran
GET /api/v2/market/overview TerminalStore.refreshOverview Accueil (indices), Terminal (sections, courbe des taux, calendrier)
GET /api/v2/data/quotes?symbols= (≤ 60) MarketStore.refreshQuotes toutes les cotations (liste, portefeuilles, panneaux) ; repli sur /api/fmp/quote/:symbol
GET /api/v2/data/bars/:symbol?interval=&from= MarketStore.bars graphiques, historique de portefeuille ; repli sur /api/fmp/chart/*
GET /api/v2/data/statements/:symbol?period=&limit= TerminalStore.statements États financiers (fiche d'actif, panneau)
GET /api/v2/search?q= TerminalStore.search recherche universelle (⌘K)
GET /api/v2/data/health TerminalStore.refreshHealth Terminal › Fournisseurs de données

# Quant Lab (§4)

Route Fonction Écran
GET /api/quant/tools (19 outils, category, resultSchema, groupes, types date / text / json) LabStore.refreshCatalog catalogue par catégorie, formulaires
POST /api/quant/jobs {tool, params, projectId?} LabStore.start formulaire, calculs rapides, analyse de portefeuille
GET /api/quant/jobs, GET /api/quant/jobs/:id LabStore.refreshJobs, .job liste (progression), résultat
POST /api/quant/jobs/:id/cancel LabStore.cancel bouton Annuler (moteurs lab/1)
DELETE /api/quant/jobs/:id LabStore.delete balayage

# Studio (§5) et recherche autonome (§9)

Route Fonction Écran
GET /api/v2/projects/:id/bundle StudioStore.bundle projet (titres et états résolus des éléments)
POST /api/v2/projects/:id/export + GET /api/download/:filename StudioStore.export export PDF / Markdown / LaTeX / ZIP, Quick Look, partage
POST /api/v2/reviews StudioStore.review revue automatisée d'une analyse, d'un calcul, d'une note
POST /api/chat avec mode: "research", model, budget, projectId ResearchStore.start composition
GET /api/v2/research/sessions, GET …/:id ResearchHub études autonomes, étude conservée
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)
POST …/:id/upload (multipart), GET …/:id/inspect?path= ResearchHub.upload, .inspect jeu de données et sa carte d'inspection
GET …/:id/file?path= (texte ou octets) ResearchHub.textFile, .fileData code, journaux, figures, fichiers (copie chiffrée pour le hors-ligne)
GET /api/v2/research/runs/:id, POST …/cancel vues du paquet exécutions longues
GET /api/v2/research/approvals?status=pending, POST …/:id ResearchHub.refreshApprovals, .answer carte d'autorisation, actions de notification
GET /api/v2/research/sandbox ResearchHub.refreshSandbox limite de dépôt, état du bac à sable

Événements de flux ajoutés par le backend 6 et lus par le réducteur partagé : research_workspace, dataset, research_file, code_execution, package_install, research_run, experiment, research_note, figure_lint, approval_request, approval_resolved, quality_gate.

Non utilisées en 2.0 : POST /api/v2/projects/:id/run (la composition passe par /api/chat avec projectId, même effet), mémoire v2 (/api/v2/memory* — l'écran Agent garde les routes 1.0), GET /api/v2/audit.


# Routes de 1.0 (toujours utilisées, sauf mention)

Source : vquant.git v5.8.0 (server/native.ts, server/routes.ts, server/routes/*.ts).

# Session et appareils

Route Fonction Écran
POST /api/native/login/options, …/login/verify PasskeyService.signIn Connexion
POST /api/native/register/options, …/register/verify PasskeyService.enrol Connexion › lien d'invitation
POST /api/native/reauth/options, …/reauth/verify PasskeyService.reauthenticate Avant révocation
GET /api/native/session session() Lancement, diagnostic
POST /api/native/logout logout() Réglages › Se déconnecter
GET /api/native/devices devices() Réglages › Appareils
DELETE /api/native/devices/:id revokeDevice idem
DELETE /api/native/passkeys/:ref revokePasskey idem
GET /api/me me() tests
GET /api/health health() Diagnostic

# Données de marché (proxy FMP)

Route Fonction Écran
GET /api/fmp/indices indices() Accueil, Marchés, widgets
GET /api/fmp/quote/:symbol quote() repli quand /api/v2/data/quotes échoue
GET /api/fmp/gainers · losers · actives movers() Marchés
GET /api/fmp/market-hours marketHours() Marchés, calcul de la fraîcheur
GET /api/fmp/search?q=&limit= search() Recherche de symbole
GET /api/fmp/chart/full/:symbol?from=&to= bars() (quotidien) Graphique 3M → Max
GET /api/fmp/chart/intraday/:symbol?interval=&from=&to= bars() (5 min, 15 min, 1 h) Graphique 1J, 5J, 1M
GET /api/fmp/company-profile/:symbol profile() Fiche › Société
GET /api/fmp/financial-news/:symbol news() Fiche › Actualités
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é)

Non utilisées : stock-quote (doublon de quote), historical-price et chart/light (couvertes par chart/full), intraday (couverte par chart/intraday), price-target, esg-score.

# Analyses (tâches serveur)

Route Fonction Écran
POST /api/chat {query, history, sessionId?, mode, imageData?, imageMimeType?} → SSE startAnalysis Composition
GET /api/generations generations() Recherche, Accueil, widget, Raccourci
GET /api/generations/:id/stream?from=N → SSE streamGeneration Suivi en direct, reprise
POST /api/generations/:id/cancel cancelGeneration Bouton Arrêter

Événements SSE décodés (AnalysisEvent) : job, status, text, thinking, plan, tool_start, tool_complete, tool_error, tool_result, python_code, custom_python_figures, agent_start, agent_tool, agent_done, sources, followups, error, done. tools et workspace sont ignorés sciemment ; tout autre type est conservé et signalé dans l'écran de suivi. Le champ model n'est pas envoyé : le serveur applique son modèle par défaut (la liste des modèles n'est exposée par aucune route en production).

Limites appliquées par le serveur et restituées telles quelles : 4 analyses simultanées par personne (429), une par conversation (409), rejeu 20 minutes après la fin, liste 24 heures. Un redémarrage du serveur interrompt les analyses en cours.

# Conversations et rapports

Route Fonction Écran
GET /api/sessions[?q=] conversations() Recherche › Historique
GET /api/sessions/:id conversation() Conversation
PATCH /api/sessions/:id {title} / {pinned} renameConversation, pinConversation balayage
DELETE /api/sessions/:id deleteConversation balayage + confirmation
GET /api/shared-reports, GET /api/share/:shareId sharedReports, sharedReport Bibliothèque
POST /api/generate-pdf {question, answer} pdf() Conversation › PDF
GET /figures/…, /plots/… file() Figures des rapports

Non utilisées : POST /api/share, POST /api/generate-docx, POST /api/convert-to-slides, POST /api/speech-to-text, GET /api/download/:filename, /api/admin/*, /api/analytics/*.

# Calculs quantitatifs (moteurs Python du serveur)

Route Fonction Écran
GET /api/quant/tools quantTools() Calculs, formulaire
POST /api/quant/jobs {tool, params} → 202 startQuantJob Formulaire
GET /api/quant/jobs quantJobs() Calculs, Accueil, Raccourci
GET /api/quant/jobs/:id quantJob() Résultat (paramètres, code, résultat)
DELETE /api/quant/jobs/:id deleteQuantJob balayage

Moteurs au 2026-11-18 : garch, var, monte_carlo, options, portfolio_optimization, risk_metrics. Il n'existe pas de route d'annulation ; au plus 3 calculs simultanés par personne. Le formulaire est construit depuis params (type, défaut, bornes, choix) ; le serveur revalide et renvoie les paramètres effectivement appliqués.

# Espace de travail

Route Fonction Écran
GET /api/workspace workspace() Portefeuille, Agent, Accueil
PUT /api/workspace/portfolio/:symbol {quantity, costBasis?, note?} upsertPosition Portefeuille
DELETE /api/workspace/portfolio/:symbol removePosition Portefeuille
POST /api/workspace/memories, DELETE …/:id addMemory, deleteMemory Agent › Mémoire
POST /api/workspace/watches, PATCH …/:id, DELETE …/:id, POST …/:id/run createWatch, updateWatch, deleteWatch, runWatch Agent › Veilles

2.0 : PUT / DELETE /api/workspace/portfolio/:symbol ne sont plus appelées (les positions sont écrites dans l'objet portfolio), GET /api/workspace sert encore la mémoire et les veilles.

# Ce qui n'existe pas côté serveur

Flux WebSocket de cotations, ordres ou courtage, push APNs (toutes les notifications sont locales), sessions web par appareil.

Files main
Menu

Theme