SPB Git

Repository Public

ops.md 10.0 KB

# Parité — alertes, notifications, état du système, recherche

Référence web : apps/web/src/screens/{Alerts,Monitor,Research}.tsx, apps/web/src/alerts.ts. Serveur : services/api/src/alerts/*, monitor/*, research/* (branche v11). Colonne « iOS » = ce que fait cette version de l'app, pas une intention.

Capacité Web iOS (cette version) Réalité du serveur Limites
Centre d'alertes Liste par jour, filtres gravité + groupe, non lues, « tout marquer lu », clic = lu + ouverture du sujet, « plus » (limite croissante) AlertsHomeView : liste par jour, formulation du catalogue (FR/EN), gravité = icône + mot + couleur, filtre par groupe et « non lues » (requêtes serveur), heure, lu / non lu, marquer une / toutes lues (l'état affiché est relu du serveur), détail avec tous les paramètres et lien vers la section native, tirer pour actualiser, pagination before. iPad : liste + détail. Hors ligne : dernière page synchronisée, datée, actions désactivées. GET /alerts (limit, before, severity, group, unread), GET /alerts/unread, POST /alerts/read. Une alerte = un type + des paramètres ; la phrase est rendue par le client. Pas de filtre par gravité côté iOS (le serveur l'accepte ; non exposé). Les motifs (reason) sont affichés tels que servis : le web en traduit certains (reasonTexts.ts), pas l'app. Le lien ouvre la SECTION (Activité, Agents, Contrats à terme, Sécurité, Échanger pour un plan, État du système), pas l'objet précis (agent, plan). Avec « masquer les soldes », liste et détail utilisent la formulation sans montant.
Compteur de non lues Flux SSE /alerts/stream + sondage 60 s ; pastille d'icône PWA AlertCenter : sondage de /alerts/unread toutes les 60 s quand l'app est active et connectée (arrêt en arrière-plan, à la déconnexion, en consultation hors ligne) ; cloche de l'accueil avec nombre et gravité la plus haute ; pastille d'icône = nombre de non lues (si notifications autorisées). Compteurs unread, critical, lastId. Pas de SSE (non disponible par le transport partagé) : jusqu'à 60 s de retard dans l'app ouverte. Tant que le serveur n'a pas répondu, la cloche n'affiche aucun nombre (pas un zéro).
Réglages par type Interrupteur par type, types fixes verrouillés AlertSettingsScreen : un interrupteur par type listé par le serveur ; type fixe = « Toujours active » + raison ; un type sans état servi n'a pas d'interrupteur. Chaque changement affiche la réponse du serveur. GET/PUT /alerts/settings ; un type désactivé ne crée plus de ligne d'alerte ; type inconnu ou fixe → bad_request. Lecture seule hors ligne (instantané daté).
Heures calmes, plafond, seuils Éditables Heures calmes (interrupteur, début, fin), plafond par heure, neuf seuils : éditables, bornés aux plages du serveur ; fuseau horaire et unknownOrderSec affichés en lecture seule. Appliqués par le répartiteur du serveur à SES canaux (push web, webhook). Sans appareil web ni webhook, le serveur marque inapp et n'évalue ni heures calmes ni plafond. Les notifications locales iOS ne respectent heures calmes / plafond que lorsque le serveur a marqué la ligne quiet / capped. Avec un compte sans appareil web ni webhook, seules les réglages iOS (Concentration, etc.) retiennent une notification. Fuseau non éditable dans l'app.
Push Web Push (VAPID) : abonnement par navigateur, test, liste des appareils Aucune inscription push. Notifications LOCALES (NotificationService) : une par NOUVELLE ligne d'alerte renvoyée par le serveur, pour : transfert / échange / pont confirmé ou échoué, ordre exécuté (agent, dérivés réels), liquidation réelle, limite de perte / arrêt / alerte de marge, refus du signataire, agent arrêté, état du signataire et coupe-circuit. Texte = formulation « écran verrouillé » du catalogue (ni montant ni adresse). Critique → timeSensitive, jamais critical. Au plus une fois par appareil (dernier identifiant vu en UserDefaults). Toucher → centre d'alertes. Aucune voie APNs : POST /push/subscriptions n'accepte que les services push des navigateurs. Aucune notification tant que l'app ne tourne pas, sauf par le rafraîchissement en arrière-plan, que iOS déclenche quand il veut (voir plus bas). Pas de type « forte variation du portefeuille » dans le catalogue du serveur : rien n'est notifié pour cela. Les exécutions et liquidations PAPIER restent dans l'app. timeSensitive exige la capacité « Time Sensitive Notifications » dans les entitlements (à ajouter par le lead ; sans elle iOS la traite comme une notification normale). La liste des appareils web et le test push web ne sont pas exposés dans l'app. Premier contact sur un appareil : l'historique existant n'est pas notifié. Lignes de plus d'une heure : jamais notifiées.
Webhook URL, secret (généré, affiché une fois), détails, exemple, activation, test Identique : URL https validée, secret « défini / non défini », génération / remplacement (confirmation) avec affichage UNIQUE en mémoire de l'écran, copie dans un presse-papiers local à l'appareil expirant en 60 s, exemple d'appel tel que servi, activation, appel de test avec le résultat du récepteur. POST /alerts/webhook/secret (réponse = seule occasion de voir le secret), POST /alerts/webhook/test (6/min). Le test appelle le récepteur ; il ne crée aucune ligne d'alerte (le serveur n'a pas de route « alerte de test » qui écrit en base). Le secret n'est ni mis en cache ni journalisé ; il disparaît en quittant l'écran.
État du système Monitor.tsx : santé, capital, PnL, exposition, capacités SystemStateView : santé (signataire, connecteurs, tâches de fond, audit, sauvegarde, disque, bac à sable, versions), capacités / verrous (avec le nom des variables manquantes), capital (cinq sommes séparées, aucun total général), PnL (réel / simulé séparés), exposition (réel / simulé séparés), statistiques du flux de cotations. Chaque bloc porte sa nature (OBSERVÉ PAR LE SERVEUR / ESTIMATION) et sa date ; un chiffre absent s'affiche « indisponible », un état non mesuré « non mesuré ». GET /monitor/{health,capital,pnl,exposure}, GET /stream/stats. Lecture seule. Hors ligne : dernier instantané daté par bloc. Montants en USD tels que servis (pas convertis). Les compteurs détaillés du hub et des sources mesurées (hub, metered) ne sont pas affichés.
Tâches de recherche Statut, liste, création, journal (SSE), annulation ResearchHomeView : statut de l'exécuteur tel que servi, liste, création (mission, agent ou « aucun », marché, symboles, intervalle, capital virtuel, cinq budgets — aucun champ pré-rempli, validation aux plages du schéma), page de tâche avec journal relevé toutes les 3 s (log(after:)), annulation (l'état affiché est la réponse du serveur). iPad : liste + tâche. Hors ligne : liste et tâches déjà ouvertes, datées. /research/status, /research/jobs, /research/jobs/:id, /cancel, /log. Création non idempotente. Journal par sondage (pas de SSE). Le choix des outils de l'agent n'est pas exposé (valeur par défaut du serveur). Le web pré-remplit les budgets ; l'app non (règle 5). Après une réponse perdue à la création, l'app demande de vérifier la liste avant de renvoyer. Le journal n'est pas conservé hors ligne. L'approbation de la stratégie soumise n'est pas ici (module Agents).
Étiquetage des résultats Sépare « écrit par l'agent » et « mesuré par le serveur » Une section par partie, chacune sous son en-tête avec la pastille de ResearchProvenance : DONNÉES OBSERVÉES / ESTIMATION / SIMULATION / ANALYSE GÉNÉRÉE + auteur. Le rapport du serveur est scindé : backtests (simulation), statistiques (estimation), comparaison « affirmé par l'agent » / « mesuré par le serveur » en deux colonnes jamais fusionnées. Courbe de valeur du backtest en Swift Charts, étiquetée simulation. Texte de l'agent en Markdown limité, liens rendus inertes (URL affichée en texte). Pied fixe : « Aucune projection n'est une garantie de résultat. » Pas de champ nature : l'étiquette vient de la STRUCTURE (un objet = un auteur), portée par ResearchProvenance du Core. Le rendu d'un résultat soumis n'a pas pu être vérifié sur la pile jetable (aucun exécuteur de recherche n'y tourne) : logique couverte par tests unitaires, rendu vérifié sur un jeu d'essai de test seulement. Les blocs détaillés du rapport de laboratoire sont affichés en lignes brutes étiquetées.
Rafraîchissement en arrière-plan Service worker (push uniquement) BGAppRefreshTask ai.spboucher.spwallet.ios.refresh : s'il existe un jeton de session, UNE passe (compteurs → nouvelles lignes → notifications, puis portefeuille → instantané des widgets), budget 25 s, arrêt à l'expiration, se reprogramme (au plus tôt 30 min) ; déconnecté : aucune requête ; un 401 arrête la passe sans rien effacer. Session : 30 min d'inactivité, 12 h au plus. iOS décide si et quand la tâche tourne (usage de l'app, batterie, économie d'énergie, réglage « Actualisation en arrière-plan ») ; jamais après un balayage hors du sélecteur d'apps. Dès que la session a expiré côté serveur (30 min sans requête), la passe s'arrête : en pratique, pas de notification en arrière-plan au-delà de cette fenêtre. Ne jamais compter dessus pour une alerte urgente. Non vérifiable sur simulateur au-delà des tests unitaires de la passe.
Widgets : champs d'alerte — AlertCenter.widgetFields() → unreadAlerts (nil tant que le serveur n'a pas répondu) et criticalAlert (titre du catalogue de la plus récente alerte critique non lue : ni montant ni adresse), écrits dans WidgetSnapshot à chaque changement. — Valeurs à la date de l'instantané ; mises à jour quand l'app tourne ou lors d'un rafraîchissement en arrière-plan.
Files main
Menu

Theme