Proposition : Script d'Audit Complet de la Stack

Date : 12/01/2026 13:47 Status : IMPLEMENTEE Objectif : Detecter toutes les incoherences entre Realite / Dashboard / Documentation

Principe

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   REALITE   │     │  DASHBOARD  │     │    DOCS     │
│  (systemes) │     │ (JSON/HTML) │     │ (CLAUDE.md) │
└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
       │                   │                   │
       └───────────────────┼───────────────────┘
                           │
                    ┌──────▼──────┐
                    │   AUDIT.SH  │
                    │  Compare 3  │
                    │   sources   │
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │   RAPPORT   │
                    │  Ecarts +   │
                    │  Severite   │
                    └─────────────┘

Structure du script

/stock_8to/33800-stack/monitoring/
├── audit.sh              # Script principal
├── audit.d/              # Modules par categorie
│   ├── 01-servers.sh     # IPs, ping, status
│   ├── 02-zfs.sh         # Pools, usage, scrub
│   ├── 03-docker.sh      # Containers, ports, images
│   ├── 04-services.sh    # Endpoints, health
│   ├── 05-nginx.sh       # Configs vs containers actifs
│   ├── 06-crons.sh       # Schedules, derniers runs
│   ├── 07-nfs.sh         # Montages, IPs reseau
│   ├── 08-docs.sh        # Coherence CLAUDE.md/STATUS.md
│   └── 09-secrets.sh     # Fichiers env, coherence PROD/DEV
└── audit-report.json     # Sortie structuree

Categorisation des checks

1. SERVERS (01-servers.sh)

2. ZFS (02-zfs.sh)

3. DOCKER (03-docker.sh)

4. SERVICES (04-services.sh)

5. NGINX (05-nginx.sh)

Check special : Pour chaque site nginx, verifier que le target (IP:PORT) correspond a un container actif.

6. CRONS (06-crons.sh)

7. NFS (07-nfs.sh)

8. DOCS (08-docs.sh)

9. SECRETS (09-secrets.sh)

Format de sortie

audit-report.json

{
  "timestamp": "2026-01-12T14:00:00Z",
  "summary": {
    "total_checks": 150,
    "passed": 140,
    "failed": 10,
    "by_severity": {
      "critical": 2,
      "warning": 5,
      "info": 3
    }
  },
  "failures": [
    {
      "id": "servers.pve.ip",
      "category": "servers",
      "severity": "warning",
      "description": "IP PVE dans JSON ne correspond pas",
      "expected": "192.168.1.4",
      "actual_reality": "192.168.1.4 192.168.1.10 10.10.10.10",
      "actual_json": "192.168.1.10",
      "actual_doc": "192.168.1.4 (+ .10 alias)",
      "fix_suggestion": "Mettre a jour collect.sh pour utiliser IP principale"
    },
    {
      "id": "nginx.site.n8n",
      "category": "nginx",
      "severity": "critical",
      "description": "Site nginx pointe vers container inexistant",
      "expected": "Container actif sur port 7676",
      "actual_reality": "Aucun container sur ce port",
      "actual_json": "target: 192.168.1.51:7676",
      "actual_doc": "-",
      "fix_suggestion": "Supprimer config nginx ou deployer container"
    }
  ]
}

Rapport console (resume)

================================================================================
                        AUDIT STACK 33800 - 12/01/2026 14:00
================================================================================

SERVERS ............................................. [8/9 OK] 1 WARNING
ZFS ................................................. [5/5 OK]
DOCKER .............................................. [24/26 OK] 2 CRITICAL
SERVICES ............................................ [10/10 OK]
NGINX ............................................... [33/46 OK] 13 WARNING
CRONS ............................................... [4/4 OK]
NFS ................................................. [6/6 OK]
DOCS ................................................ [15/18 OK] 3 INFO
SECRETS ............................................. [2/2 OK]

--------------------------------------------------------------------------------
CRITICAL (2)
--------------------------------------------------------------------------------
[DOCKER] supabase_dev status=error mais DB ok - verifier collect.sh
[NGINX] n8n.33800.nowhere84.com -> 192.168.1.51:7676 (container inexistant)

--------------------------------------------------------------------------------
WARNING (14)
--------------------------------------------------------------------------------
[SERVERS] pve.ip=192.168.1.10 dans JSON, realite=192.168.1.4 (principal)
[NGINX] 13 configs pointent vers containers inexistants (voir liste)
...

--------------------------------------------------------------------------------
INFO (3)
--------------------------------------------------------------------------------
[DOCS] GitLab version: realite=18.7.0, doc=18.6.2
...

================================================================================
Details: /stock_8to/33800-stack/monitoring/audit-report.json
================================================================================

Execution

# Audit complet
/stock_8to/33800-stack/monitoring/audit.sh

# Audit une categorie
/stock_8to/33800-stack/monitoring/audit.sh --only servers

# Audit avec fix automatique (si possible)
/stock_8to/33800-stack/monitoring/audit.sh --fix

# Audit silencieux (juste JSON)
/stock_8to/33800-stack/monitoring/audit.sh --json-only

Integration

1. Cron optionnel : Executer audit.sh apres collect.sh pour alerter si ecarts
2. Page dashboard : audit.html avec derniers resultats
3. Notification : Alert si CRITICAL detecte

Estimation effort

Total estime : 7-9h

Questions avant implementation

1. Severite : Comment classer ? Ma proposition :

   • CRITICAL = service down ou config cassee
   • WARNING = incoherence affichage mais service OK
   • INFO = doc pas a jour

2. Fix auto : Quels ecarts corriger automatiquement ?

   • MAJ STATUS.md ? (oui)
   • MAJ CLAUDE.md ? (non, validation manuelle)
   • Supprimer configs nginx orphelines ? (non, validation manuelle)

3. Frequence : Audit a chaque collect.sh ou manuel seulement ?

Validation requise

• [ ] Structure OK
• [ ] Checks couvrent tout
• [ ] Severites OK
• [ ] Questions repondues