Wiki dev appwin

Bienvenue sur la documentation d'ingénierie d'appwin : ce qui se passe sous le capot de chaque système, pourquoi c'est construit comme ça, et les pièges connus. Elle sert trois publics : garder la trace de ce qu'on construit, onboarder les nouveaux devs, et donner du contexte de qualité à l'IA.

Ces pages sont vivantes : écrites avant de développer une feature quand c'est possible, mises à jour dans les mêmes PR que le code qu'elles décrivent. Le contenu vit dans docs/wiki/ du monorepo - ce site n'en est que la vitrine.

Règles d'écriture

• La langue du code : les noms utilisés ici sont ceux qu'on greppe dans le repo, pas le jargon historique des ADR.
• Pédagogique mais simple : chaque page part de « ce que ça fait en une phrase », puis le flux nominal en schéma, puis les détails et les pièges.
• Des schémas (Mermaid) partout où un dessin dit plus qu'un paragraphe.
• En français ; les chemins de fichiers sont réels et vérifiés à l'écriture ; une page par système, moins de 500 lignes.

Sections

• SDK : l'architecture d'ensemble, puis une page par produit - Analytics, Attribution, et les autres au fur et à mesure.
• Attribution (serveur) : la chaîne SKAN et les connecteurs régies.

Les autres pans (ingestion ClickHouse, jobs BullMQ, RLS, facturation, déploiement, realtime...) seront documentés section par section.