DAT — Document d'architecture technique

Ce document décrit l'architecture de la plateforme APAJH : ce qu'elle fait, de quoi elle est faite, comment elle est déployée et comment elle est protégée.

Pour qui : un architecte technique extérieur à l'équipe, un auditeur, une équipe d'exploitation qui reprend la plateforme. Il suppose le métier du logiciel connu, pas ce projet.

Il énonce des décisions et leurs raisons. Une contrainte qui a façonné la conception y figure ; un détail d'implémentation appartient au code et à references/.

Sections

La numérotation est un contrat : un lecteur extérieur cite « DAT § 04 ». Elle ne change pas, même si une section est réécrite.

§	Section	Ce qu'on y trouve
01	Contexte et périmètre	Le besoin, les acteurs, ce qui est dans le périmètre et ce qui n'y est pas
02	Architecture fonctionnelle	Les domaines métier, leurs règles structurantes, les flux
03	Architecture applicative	Le découpage en applications, les frontières, les choix de conception
04	Architecture technique	La stack, les douze services, les réseaux, les données persistées
05	Sécurité	Authentification, autorisation, exposition, données sensibles
06	Exploitation	Déploiement, intégration continue, sauvegardes, TLS, supervision
07	Annexes	Généré : services, variables d'environnement, routes de l'API, ordonnancement

État du projet

La plateforme est en phase MVP. Le socle technique est en place et déployé sur un environnement de développement ; les modèles du domaine bougent encore.

Cette section du document a une conséquence pratique pour un lecteur : ce qui est décrit ci-après est ce qui tourne, pas une cible. Les manques délibérés sont énoncés à leur place, dans la section où ils appartiendraient — chacun est aussi listé dans la section « Not built yet » d'AGENTS.md, qui est la liste de référence.

Deux documents à ne pas chercher ici

• Les versions effectivement installées et les licences des dépendances : Dépendances. Elles dépendent de l'image construite, pas du dépôt, et sont relevées séparément pour cette raison.
• La description détaillée des écrans du back-office : le guide d'administration.

Comment ce document est tenu à jour

L'annexe § 07 est générée par make docs à partir de docker-compose.yml, de .env.example, de la configuration des URL et de l'ordonnanceur. Elle ne se modifie pas à la main.

Les six sections rédigées sont tenues par la table de routage d'AGENTS.md : une décision qui contraint le travail futur — technologie, frontière, posture de sécurité — met à jour la section correspondante dans la même pull request. Deux règles sont vérifiées par make docs-check :

• chaque service de docker-compose.yml est situé dans le § 04 ;
• chaque variable de .env.example a un rôle en français, que l'annexe rend.