Mémoire Claude - Infrastructure 33800

⚠️ RÈGLES OBLIGATOIRES (À RESPECTER EN PREMIER)

⚠️ LIRE ET APPLIQUER CES RÈGLES - PAS D'EXCUSE

Ces règles existent car Claude les a déjà violées. Si une règle est écrite ici, c'est qu'elle DOIT être respectée. Ne PAS ignorer ces règles puis s'excuser après. RELIRE ce fichier avant chaque action importante.

1. TOUJOURS proposer avant de faire → créer fichier .md dans /home/gouroubleu/propositions/
2. ATTENDRE validation de l'utilisateur avant d'exécuter
3. Documenter dans /home/gouroubleu/tasks/ avec mise à jour de l'avancement
4. Reporter dans /home/gouroubleu/backlog/ si nécessaire
5. Nommage fichiers : JJ-MM-AAAA-HH-MM-description.md
6. Code = GitLab → Tout code doit etre versionne sur GitLab AVANT deploiement
7. Services = Dashboard → Tout nouveau service doit etre ajoute au dashboard
8. Logs = Loki → Tout service doit envoyer ses logs vers Loki (voir section Logging)

⛔ INTERDICTIONS ABSOLUES (ajouté 18/01/2026, màj 20/01/2026)

1. JAMAIS de grep pour modifier des fichiers → Lire le fichier ENTIER avec Read avant d'éditer
2. JAMAIS de modifications en masse sans comprendre → Éditer ligne par ligne, une modif à la fois
3. Dashboard = O2switch UNIQUEMENT → URL: https://dashboard.nowhere84.com (PAS dashboard.33800)
4. generate.sh ne déploie PAS sur nginx → Il génère dans le repo et push vers O2switch, c'est TOUT
5. Pas de nav.js ou autres "améliorations" non demandées → Faire uniquement ce qui est demandé
6. JAMAIS remettre la faute sur les autres → Assumer mes erreurs, ne pas blâmer l'utilisateur ou le système
7. JAMAIS déployer manuellement → Push vers GitLab, la pipeline CI/CD build et deploy automatiquement
8. JAMAIS changer ce qui fonctionne → Ne modifier QUE ce qui est explicitement demandé
9. JAMAIS supprimer du code fonctionnel en "nettoyant" → Lire TOUT le bloc avant de supprimer, vérifier chaque ligne
10. Notification generate.sh OBLIGATOIRE → À la fin: nombre de pages + lien https://dashboard.nowhere84.com
11. JAMAIS de rm -rf sur des données → INTERDIT de supprimer des dossiers data/, db/, volumes/ ou toute donnée persistante
12. JAMAIS "réparer" en supprimant → Si un service ne démarre pas, DEMANDER à l'utilisateur, ne JAMAIS supprimer de données
13. JAMAIS d'action destructive sans validation EXPLICITE → Toute commande rm, drop, truncate, delete nécessite accord écrit
14. TOUJOURS git push après modification d'un projet GitLab → Même sans CI/CD, le code DOIT être versionné sur GitLab
15. APRÈS AUTOCOMPACT → RELIRE LA MÉMOIRE → Après une compaction de contexte, TOUJOURS relire CLAUDE.md et credentials.md AVANT de continuer. Les erreurs post-compaction viennent du manque de contexte.
16. 1 demande = 1 action → Ne PAS faire plusieurs appels API/tests quand l'utilisateur en demande un seul. Pas de "debug" avec des appels supplémentaires.
17. JAMAIS d'IP:port dans le code → Toujours utiliser les domaines HTTPS *.33800.nowhere84.com. Pi-hole split-DNS résout en local. Voir pihole-split-dns.md
18. Supabase GRANT obligatoire → Toute nouvelle table dans le schema connectors DOIT avoir GRANT ALL ... TO anon, authenticated, service_role. Sinon les requêtes échouent silencieusement.

🔧 Outils MCP Disponibles (UTILISER EN PRIORITÉ)

Config : ~/.claude/settings.json Server : /stock_8to/33800-stack/projects/mcp-claude-tools/server.py

Instances SSH préconfigurées

IMPORTANT : Préférer les outils MCP aux commandes bash quand possible. Ils sont authentifiés et intégrés.

📦 Projets GitLab sans CI/CD (push manuel obligatoire)

Ces projets n'ont PAS de pipeline automatique (0 pipeline sur GitLab). Après modification → git add + commit + push :

Vérifié le 16/02/2026 via GitLab API (source de vérité = GET /api/v4/projects/:id/pipelines) Les autres projets (needfinder, dashboard-33800, ulias-lib, qwikjs-lib, json-editor, user-bucket, user-bucket-m) ont tous des pipelines CI/CD actives.

Procedure de fin de tache (OBLIGATOIRE)

Avant de terminer une tache ou session :

• [ ] Git push tous les projets modifies vers GitLab
• [ ] Task : Creer/mettre a jour dans ~/tasks/
• [ ] STATUS.md : Mettre a jour avec actions effectuees
• [ ] Dashboard : Mettre a jour si services modifies (config.json + generate.sh)
• [ ] CLAUDE.md : Ajouter toute nouvelle info persistante (services, credentials, procedures)
• [ ] Propositions : Marquer le statut (VALIDEE/IMPLEMENTEE/REJETEE) de TOUTE proposition traitee dans la session

Rotation et maintenance (23/02/2026)

• STATUS.md : max 2 semaines actives, archiver le reste dans STATUS-archives/
• Propositions : TOUJOURS marquer le statut IMMEDIATEMENT apres validation/rejet de l'utilisateur. C'est le defaut de Claude, pas de l'utilisateur.
• Backlog : mettre a jour 00-INDEX-BACKLOG.md a chaque ajout/suppression d'item
• Tasks : fermer "EN COURS" IMMEDIATEMENT quand le travail est termine. Jamais laisser trainer.

📚 Système de Mémoire (3 niveaux)

Fichiers memory/ disponibles

Fichiers index/ (auto-générés par generate-claude-index.sh)

🌍 Fédération Multi-Stack (Vision)

┌─────────────────────────────────────────────────────────────────────────────┐
│                           FÉDÉRATION STACKS                                  │
│   ┌─────────────────┐                          ┌─────────────────┐          │
│   │     33800       │◄────── WireGuard ───────►│     86000       │          │
│   │   (Bordeaux)    │      IP à IP direct      │   (Poitiers)    │          │
│   │ 82.65.119.221   │      Freebox Ultra       │   IP publique   │          │
│   └─────────────────┘                          └─────────────────┘          │
│           │                                            │                    │
│           └──────────────► O2SWITCH ◄──────────────────┘                    │
│                         (backup/dashboard)                                  │
└─────────────────────────────────────────────────────────────────────────────┘

🌐 Architecture Réseau (résumé)

Détails complets : memory/architecture-reseau.md

🗄️ Architecture Stockage (résumé)

Détails complets : memory/architecture-stockage.md

📁 Structure 33800-STACK

/stock_8to/33800-stack/
├── docker/                    # Configuration Docker
│   ├── prod/                  # data-root Docker PROD
│   ├── dev/                   # data-root Docker DEV
│   ├── secrets/               # prod.env, dev.env
│   ├── shortcuts/             # Dockerfiles templates
│   └── stacks/                # Compose files
├── scripts/                   # Scripts d'automatisation
├── claude/                    # Historique Claude (persistant)
│   ├── propositions/
│   ├── tasks/
│   ├── backlog/
│   └── CLAUDE.md
├── monitoring/                # Dashboard monitoring
└── docs/                      # Documentation infra

🖥️ Machines principales

Détails complets : memory/vms-details.md

🔑 Credentials (accès rapide)

Credentials complets : memory/credentials.md

🤖 Workflow Claude

"Prendre connaissance de la stack" (OBLIGATOIRE quand demande)

Lire TOUS ces fichiers en parallele, SANS EXCEPTION :

1. Tous les fichiers memory/ :
   • memory/vms-details.md — Hyperviseurs (2 Proxmox!) et VMs
   • memory/architecture-reseau.md — Reseaux vmbr0/vmbr1
   • memory/architecture-stockage.md — Pools ZFS
   • memory/services-actifs.md — Stacks et services PROD
   • memory/docker.md — Config Docker, conf.gouroubleu.yml
   • memory/ci-cd.md — Pipelines, Smart-Deploy, Registry
   • memory/pihole-split-dns.md — Split-DNS, securite
   • memory/acces-reseau.md — IPs autorisees, nginx, VPN
   • memory/freebox.md — Freebox Ultra, API, port forwarding
   • memory/logging.md — Loki, Promtail, Grafana
   • memory/monitoring.md — Dashboard, crons
   • memory/credentials.md — Tous les credentials
   • memory/workflows.md — Commandes SSH, ZFS, deploiement
   • memory/scripts.md — Index scripts
   • memory/docs.md — Index documentation
   • memory/sujets-transverses.md — Conventions, ports, URLs
   • memory/claude-workflow.md — Propositions, tasks, backlog
   • memory/qwik-auth-pattern.md — Pattern Auth Qwik
2. STATUS.md — Contexte temps reel
3. backlog/00-INDEX-BACKLOG.md — Priorites

PAS de resume partiel. Lire TOUT puis resumer. Ne JAMAIS resumer a partir d'un seul fichier.

Au debut de chaque session (si pas de demande specifique)

1. Lire STATUS.md : /home/gouroubleu/STATUS.md contient le contexte temps reel
   • Services actifs et leur etat
   • Derniers incidents
   • Travaux en cours
2. Consulter les 3 derniers tasks : /home/gouroubleu/tasks/ (tries par date)
3. Verifier backlog prioritaire : Grep "HAUTE" ou "CRITIQUE" dans backlog/

Pendant une session

• MAJ STATUS.md apres actions majeures (deploiement, fix, etc.)
• Creer un task pour chaque travail significatif (> 15 min)
• Marquer TERMINE les tasks completees immediatement

En fin de session

• Mettre a jour STATUS.md avec :
  • Nouveaux services deployes
  • Travaux termines
  • Points d'attention
• Documenter dans tasks/ si travail significatif non documente
• Ajouter au backlog si travail non termine

Conventions fichiers

Symlinks Claude

📚 Références rapides