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 du dépôtHTML 100%1
Parts calculées à partir des octets GitHub Linguist.
| Langage | % | Octets |
|---|---|---|
| HTML | 704 499 |
Aperçu
Pourquoi il existe
Schémas d’infrastructure domestique conservés en sources PlantUML et draw.io, avec des exports HTML et image.
Cas d’usage
Consulter un instantané d’infrastructure archivé ou modifier ses sources pour documenter un homelab.
Démarrage
Ces commandes viennent de la documentation du dépôt. Elles n’ont pas été exécutées pendant cette revue.
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.
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.
Architecture
Les composants et leurs liens restent lisibles en texte. Le diagramme ajoute une vue interactive.
- Source PlantUML
- Rendu PlantUML
- Image du schéma
- Source draw.io
- Export HTML et PNG
Liens vérifiés dans le dépôt.
Mermaid Diagramme interactif (chargement à l’ouverture)
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.
Structure des fichiers
La carte montre les fichiers inspectés et leur organisation.
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.
Carte des fichiers
flowchart TD
root["architecture"]
f0["README.md"]
root --> f0