summaryrefslogtreecommitdiff
path: root/SCHEMA_CENTRAL.md
diff options
context:
space:
mode:
authorertopogo <erwin.t.pombett@gmail.com>2026-02-20 19:36:00 +0100
committerertopogo <erwin.t.pombett@gmail.com>2026-02-20 19:36:00 +0100
commitb713be161431729305701f80b3b6f53d2f07f62a (patch)
tree820d055331f38e6edda2c1ee160a6611560fbf7c /SCHEMA_CENTRAL.md
Initial commit: schemas infrastructure Arauco avec serveur web
Diffstat (limited to 'SCHEMA_CENTRAL.md')
-rw-r--r--SCHEMA_CENTRAL.md154
1 files changed, 154 insertions, 0 deletions
diff --git a/SCHEMA_CENTRAL.md b/SCHEMA_CENTRAL.md
new file mode 100644
index 0000000..0325774
--- /dev/null
+++ b/SCHEMA_CENTRAL.md
@@ -0,0 +1,154 @@
+# Schema Central - Infrastructure Araucaria
+
+> Derniere mise a jour : 2026-02-19
+> Domaine : arauco.online | Reseau : 192.168.99.0/24
+
+## Vue d'ensemble
+
+```mermaid
+flowchart TB
+ subgraph external ["Acces Externe"]
+ ddns["DDNS Namecheap<br/>arauco.online"]
+ router["Routeur Swisscom<br/>Gateway 192.168.99.1"]
+ end
+
+ subgraph lan ["Reseau LAN 192.168.99.0/24"]
+
+ subgraph araucaria ["araucaria - Hote KVM<br/>eth0/br0: .50 | eth1: .51"]
+ dnsmasq["dnsmasq :53<br/>DNS local"]
+ kvm["KVM / virsh<br/>libvirt"]
+ ssh_host["SSH :1220"]
+ lvm["LVM vgarauco0<br/>5.31 TB total"]
+ end
+
+ subgraph chillka ["chillka - .55<br/>2 vCPU | 2 GB RAM | 500 GB"]
+ gitea["Gitea :3000<br/>git.arauco.online"]
+ samba["Samba :139/445"]
+ http_chillka["HTTP :80"]
+ end
+
+ subgraph npagnun ["npagnun - .35<br/>2 vCPU | 8 GB RAM | 200 GB"]
+ keycloak["Keycloak :8080/8443<br/>keycloak.arauco.local"]
+ kc_mgmt["KC Management :9000"]
+ pg_kc["PostgreSQL 15<br/>:5432 interne"]
+ end
+
+ subgraph huitral ["huitral - .22<br/>2 vCPU | 8 GB RAM | 300 GB"]
+ ha_h["Home Assistant<br/>reseau host"]
+ medusa_be["Medusa Backend :9000"]
+ medusa_sf["Medusa Storefront :8000"]
+ redis_h["Redis :6379"]
+ vikunja_h["Vikunja :3456"]
+ pg_vik["PostgreSQL 16<br/>:5432 interne"]
+ dertopogo["der-topogo :3000"]
+ nginx_test["nginx test :8080"]
+ end
+
+ subgraph lautaro ["lautaro - .108 - Raspberry Pi<br/>Non accessible"]
+ ha_l["Home Assistant :8123"]
+ end
+
+ subgraph dormant ["Volumes LVM dormants"]
+ lemolemo["lemolemo .33<br/>10 GB"]
+ toki["toki .44<br/>10 GB"]
+ copihue["copihue .11"]
+ huinca["huinca .66<br/>70 GB"]
+ kura["kura<br/>5 GB"]
+ end
+ end
+
+ ddns -->|"arauco.online"| router
+ router -->|"NAT 2222 -> :1220"| ssh_host
+ router --- lan
+
+ kvm -->|"virsh / br0"| chillka
+ kvm -->|"virsh / br0"| npagnun
+ kvm -->|"virsh / br0"| huitral
+ lvm -.->|"vgarauco0-*"| dormant
+
+ dnsmasq -.->|"DNS"| chillka
+ dnsmasq -.->|"DNS"| npagnun
+ dnsmasq -.->|"DNS"| huitral
+ dnsmasq -.->|"DNS"| lautaro
+
+ keycloak -->|"JDBC"| pg_kc
+ medusa_be --> redis_h
+ vikunja_h --> pg_vik
+```
+
+---
+
+## Index des schemas detailles
+
+### Reseau
+
+| Schema | Fichier | Description |
+|--------|---------|-------------|
+| Topologie reseau | [topologie_reseau.mmd](micro/reseau/topologie_reseau.mmd) | IPs, interfaces, DNS, routage, acces externe |
+
+### Machines virtuelles
+
+| Schema | Fichier | Description |
+|--------|---------|-------------|
+| araucaria (host) | [araucaria_host.mmd](micro/vms/araucaria_host.mmd) | Hote KVM, interfaces, LVM, services, VMs gerees |
+| npagnun | [npagnun.mmd](micro/vms/npagnun.mmd) | Ubuntu 24.04, Keycloak + PostgreSQL (Docker) |
+| huitral | [huitral.mmd](micro/vms/huitral.mmd) | Debian 12, Docker: Medusa, Vikunja, HA, der-topogo, nginx |
+| chillka | [chillka.mmd](micro/vms/chillka.mmd) | Gitea, Samba, HTTP, SSH |
+| lautaro | [lautaro.mmd](micro/vms/lautaro.mmd) | Raspberry Pi, Home Assistant (non accessible) |
+
+### IAM / Identite
+
+| Schema | Fichier | Description |
+|--------|---------|-------------|
+| Keycloak IAM | [keycloak_iam.mmd](micro/iam/keycloak_iam.mmd) | OIDC, realms, clients, RBAC, flux d'authentification |
+
+### Applications
+
+| Schema | Fichier | Description |
+|--------|---------|-------------|
+| Korradi.dev | [korradi_stack.mmd](micro/applications/korradi_stack.mmd) | Stack applicatif: Next.js, Fastify, Widget SDK, Traefik |
+
+---
+
+## Visualisation web
+
+Le serveur local permet de naviguer et visualiser tous les schemas dans le navigateur :
+
+```bash
+cd schemas/server
+npm install
+npm start
+# -> http://localhost:3030
+```
+
+---
+
+## Ajouter un nouveau schema
+
+1. Creer un fichier `.mmd` dans le sous-dossier appropriate (`micro/vms/`, `micro/iam/`, etc.)
+2. Le serveur web le detectera automatiquement (hot-reload)
+3. Mettre a jour ce fichier `SCHEMA_CENTRAL.md` pour ajouter une entree dans l'index
+
+### Convention de nommage
+
+- `micro/vms/<nom_vm>.mmd` pour une machine virtuelle
+- `micro/reseau/<sujet>.mmd` pour le reseau
+- `micro/iam/<sujet>.mmd` pour l'identite / acces
+- `micro/applications/<nom_app>.mmd` pour une application
+
+---
+
+## Donnees de reference
+
+| Machine | IP | RAM | Stockage LVM | Etat |
+|---------|-----|-----|-------------|------|
+| araucaria (host) | .50 (br0), .51 (eth1) | - | vgarauco0 5.31 TB | actif |
+| chillka | .55 | 2 GB | 500 GB | running |
+| npagnun | .35 | 8 GB | 200 GB (vol nudo) | running |
+| huitral | .22 | 8 GB | 300 GB | running |
+| lautaro | .108 | - | - | non accessible |
+| lemolemo | .33 | - | 10 GB | dormant |
+| toki | .44 | - | 10 GB | dormant |
+| copihue | .11 | - | - | dormant |
+| huinca | .66 | - | 70 GB | dormant |
+| kura | - | - | 5 GB | dormant |