Table des matières
architecture : L’architecture comme documentation modifiable
Ce dépôt archivé conserve un diagramme d’infrastructure domestique dans plusieurs formats. Son architecture est celle d’un flux documentaire: des sources modifiables produisent des schémas consultables sans application en cours d’exécution.
- Langages
- 1Répartition du code
- Composants documentés
- 2Explorer les modules
- Documents source
- 1Lire les instructions
Langages du dépôtHTML 100%1
Parts calculées à partir des octets GitHub Linguist.
| Langage | % | Octets |
|---|---|---|
| HTML | 704 499 |
1. Aperçu
1.1. Pourquoi il existe
Schémas d’infrastructure domestique conservés en sources PlantUML et draw.io, avec des exports HTML et image.
1.2. Cas d’usage
Consulter un instantané d’infrastructure archivé ou modifier ses sources pour documenter un homelab.
2. Cas d’utilisation
Diagrammes C4 PlantUML et draw.io d’un homelab : Cloudflare, un VPS OVH, des hyperviseurs, un NAS et leurs services.
- Voir le schéma draw.io v1
- LecteurMoteurs de rendu
architecture.drawio.html intègre le XML draw.io dans le visualiseur diagrams.net, avec zoom, calques et visionneuse ; le README le présente comme la v1.
- Générer le diagramme C4 v2
- LecteurMoteurs de rendu
architecture.plantuml inclut C4_Deployment et les icônes Font Awesome, OSA et Office ; le lien v2 du README est un rendu encodé sur le serveur PlantUML.
- Suivre les accès externes
- Lecteur
Les lignes Rel montrent l’utilisateur qui passe par Cloudflare en HTTPS, Cloudflare qui renvoie vers le VPS OVH, le VPS qui joint les réseaux domestique et personnel par WireGuard, et l’admin qui passe par Teleport en SSH.
- Inventorier VM et conteneurs
- Lecteur
Les nœuds listent les hôtes XCP-ng, Proxmox et Windows, un NAS QNAP avec sa pile média, et des VM comme Talos (Portainer, AI News Tracker, Freqtrade), Home Assistant et Caddy avec Prometheus et Grafana, chacun avec CPU, RAM et disque.
- Modifier et réexporter
- Mainteneur du schémaMoteurs de rendu
Le mainteneur modifie architecture.plantuml ou architecture.drawio et exporte une image comme home architecture.png.
2.1. Scénario : Suivre une requête web jusqu’au homelab
- Ouvrir architecture.plantuml, ou le lien v2 du README.md rendu par le serveur PlantUML.
- Partir de la personne User, qui joint Cloudflare (CDN et proxy inverse) en HTTPS.
- Suivre Cloudflare jusqu’au VPS OVH, qui exécute Caddy, Teleport et Uptime Kuma.
- Suivre le lien WireGuard du VPS vers le Personal Network et son hôte Proxmox.
- Voir la VM Caddy router le trafic vers AI News Tracker, Marketwatch, Portainer, Plex et Jellyfin.
Fichiers consultésREADME.mdarchitecture.plantumlarchitecture.drawio.htmlarchitecture.drawio
3. Démarrage
Ces commandes viennent de la documentation du dépôt. Elles n’ont pas été exécutées pendant cette revue.
4. Références du dépôt
Le dépôt ne fournit pas de guide détaillé pour ces étapes. Commencez par le README et les fichiers commentés ci-dessus.
5. Fonctions et composants 2
- Sources modifiables
- La racine contient une source PlantUML et un document draw.io. Il s’agit de deux représentations distinctes. Leur présence ne signifie pas que l’une est automatiquement produite à partir de l’autre.
- Vues publiées
- Les fichiers PNG et HTML permettent de consulter le schéma. Le README dirige vers ces représentations. Le dépôt décrit l’infrastructure, sans déployer ni surveiller les services représentés.
6. Architecture
Ouvrez un composant pour suivre ses connexions, ou explorez le diagramme complet.
Source PlantUML
- Vers Rendu PlantUML
Rendu PlantUML
- Depuis Source PlantUML
- Vers Image du schéma
Image du schéma
- Depuis Rendu PlantUML
Source draw.io
- Vers Export HTML et PNG
Export HTML et PNG
- Depuis Source draw.io
Mermaid Diagramme interactif
Vue générale des composants et des échanges vérifiés dans le dépôt.
flowchart LR
n0["Source PlantUML"]
n1["Rendu PlantUML"]
n2["Image du schéma"]
n3["Source draw.io"]
n4["Export HTML et PNG"]
n0 --> n1
n1 --> n2
n3 --> n4
Version texte du diagramme
- Source PlantUML → Rendu PlantUML
- Rendu PlantUML → Image du schéma
- Source draw.io → Export HTML et PNG
Suivre un parcours dans le code
Choisissez d’abord le format modifiable, puis comparez son rendu à l’image exportée. Conserver les sources évite qu’une capture d’écran devienne la seule description restante du système.
7. Dossier technique
Établi à partir du code au commit a511b1a (1 fichiers). Chaque élément vient d’une correspondance de motif dans le code: ouvrez le fichier lié avant de vous y fier.
7.1. Couches et modules
Les dossiers sont classés par couche selon leur nom, de l’interface utilisateur jusqu’à l’accès aux données. Comme le classement repose sur les noms seulement, le diagramme ne dit rien des appels entre couches.
Mermaid Vue en couches
flowchart TB
subgraph L_presentation["Présentation"]
direction TB
presentation_0["(root)<br/>1 fichier"]
end
| Module | Couche | Fichiers | Types | Extensions |
|---|---|---|---|---|
(root) | Présentation | 1 | 0 | .html |
7.2. Modèle C4
Du contexte du système aux déclarations du code. Chaque niveau conserve les limites des sources disponibles.
UML 1 · Contexte du système
La vue C4 la plus large : qui utilise le projet et sur quels systèmes et stockages externes il s’appuie. Rendu avec uml-mcp.
Source PlantUML
@startuml
!include <C4/C4_Context>
LAYOUT_LEFT_RIGHT()
System(SYS, "architecture", "Ce dépôt archivé conserve un diagramme d’infrastructure domestique da…")
@enduml
Niveau 2: les sources disponibles ne permettent pas de tracer cette vue.
UML 3 · Composants et couches
Modules regroupés par couche du code. Les limites indiquent l’organisation, sans affirmer une isolation à l’exécution ni des appels. Rendu avec uml-mcp.
Source PlantUML
@startuml
!include <C4/C4_Component>
LAYOUT_TOP_DOWN()
System_Boundary(SYS, "architecture") {
Boundary(L0, "Présentation", "layer") {
Component(M0_0, "(root)", "HTML", "1 fichiers")
}
}
@enduml
Niveau 4: les sources disponibles ne permettent pas de tracer cette vue.
7.3. Pipeline CI/CD
Aucun pipeline CI/CD dans le dépôt. Le code se construit et se lance à la main, comme décrit plus haut.
7.4. Déploiement
Mermaid Schéma de déploiement
flowchart LR
repo[("Dépôt GitHub")]
local["Poste local"]
repo -->|"cloner et lancer"| local
Le dépôt ne contient ni Dockerfile, ni fichier Compose, ni configuration d’hébergement : le code s’exécute sur le poste qui le clone.
Les sources disponibles ne documentent pas les autres sections.
8. Référence
1 / 1 fichiers admissibles lus (7 dans l’arbre); 0 trop volumineux, 0 échec de lecture et 0 diagnostic de syntaxe.
Ce que couvre l’analyse
Les dossiers connus de dépendances et de compilation, les fichiers d’identifiants et les binaires sont exclus. La collecte couvre les README, les manifestes reconnus et les fichiers source pris en charge.
Les statistiques Linguist couvrent l’ensemble du dépôt et peuvent inclure d’autres langages.
10. Fichiers à lire 3
11. Glossaire
Dépôt
Les fichiers source, la configuration et l’historique versionné d’un projet.
README
Le document d’entrée du dépôt, qui présente généralement son rôle et son installation.
Dépendance
Une bibliothèque, un outil ou un service nécessaire à la compilation ou à l’exécution d’un composant.
Interface en ligne de commande
Une interface textuelle où les commandes et arguments choisissent les opérations. Les codes de retour permettent aux scripts de détecter un succès ou un échec.
Intégration continue
Des vérifications automatiques lors des changements de source, comme la compilation, les tests et l’analyse statique. Elles ne couvrent que ce qu’elles vérifient.
Mermaid
Un langage de diagrammes textuel. Les nœuds et liens décrivent un modèle ; le diagramme n’exécute pas le projet.
GPU
Un processeur conçu pour les calculs parallèles, dont le rendu graphique et de nombreuses opérations numériques.
12. Références
- antoinebou12. (2026, 5 novembre). architecture. [Software repository] github.com.
- antoinebou12. (2026, 5 novembre). architecture: README. [Repository documentation] github.com.
- antoinebou12. (2026, 5 novembre). README.md. [Source file] github.com.
- antoinebou12. (2026, 5 novembre). architecture.plantuml. [Source file] github.com.
- antoinebou12. (2026, 5 novembre). architecture.drawio. [Source file] github.com.
- Boucher, A. (2026, 23 octobre). architecture : L’architecture comme documentation modifiable. [Project article] antoineboucher.info.
Les sources sans date de publication indiquent la date de leur dernière vérification, le 5 novembre 2026. Les liens des fichiers conservent la révision inspectée lorsqu’elle est disponible.