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. |