Backlog : Refactoring collect.sh / generate.sh

Date ajout : 08/01/2026 Priorite : MOYENNE Origine : Suggestion utilisateur Statut : TERMINE Date fin : 11/01/2026

Probleme

Les fichiers collect.sh et generate.sh deviennent tres volumineux :

• collect.sh : ~1100+ lignes
• generate.sh : ~5500+ lignes

Cela rend la maintenance difficile et ne permet pas de collecter/generer partiellement.

Solution proposee

Decoupage par machine/section

/stock_8to/33800-stack/monitoring/
├── collect.sh              # Script principal (orchestrateur)
├── collect.d/              # Modules de collecte
│   ├── _common.sh          # Fonctions partagees (ssh_cmd, etc.)
│   ├── pve.sh              # Collecte PVE
│   ├── proxmox1.sh         # Collecte Proxmox1
│   ├── prod-portainer.sh   # Collecte prod-portainer
│   ├── gitlab.sh           # Collecte GitLab
│   ├── nginx.sh            # Collecte nginx
│   └── zfs.sh              # Collecte ZFS/pools
│
├── generate.sh             # Script principal (orchestrateur)
├── generate.d/             # Modules de generation
│   ├── _common.sh          # Fonctions partagees (HTML, CSS)
│   ├── index.sh            # Page principale
│   ├── crons.sh            # Page crons
│   ├── nginx.sh            # Page nginx
│   ├── raidz.sh            # Page RAIDZ (nouveau)
│   └── ...

Avantages

1. Modularite : Chaque machine/page dans son fichier
2. Maintenance : Plus facile a debugger
3. Collecte partielle : ./collect.d/gitlab.sh seul si besoin
4. Tests : Tester une section sans tout relancer
5. Parallelisation : Collecter plusieurs machines en parallele

Usage cible

# Full collect (actuel)
./collect.sh

# Collect partiel
./collect.sh --only=gitlab,nginx

# Generate partiel
./generate.sh --only=crons,index

Estimation effort

• Refactoring collect.sh : ~2-3h
• Refactoring generate.sh : ~4-5h
• Tests et validation : ~1-2h

Notes

A faire quand le systeme actuel est stable et que les nouvelles pages (RAIDZ, etc.) sont implementees.

REALISATION (11/01/2026)

collect.d/ - 8 modules machines

• _common.sh, 01-pve.sh, 02-proxmox1.sh, 03-prod-portainer.sh
• 04-dev-portainer.sh, 05-gitlab.sh, 06-nginx.sh, 07-jellyfin.sh, 08-win11.sh

generate.d/ - 11 modules pages

• _common.sh, 01-index.sh, 02-alerts.sh, 03-doc.sh, 04-secrets.sh
• 05-endpoints.sh, 06-montages.sh, 07-nginx.sh, 08-crons.sh
• 12-raidz.sh, 13-models.sh

Resultats

• generate.sh : 6223 → 4788 lignes (-23%)
• Chargement conditionnel avec fallback
• Tests standalone pour chaque module

Documentation

Voir /home/gouroubleu/tasks/11-01-2026-20-30-needfinder-dashboard-refactoring.md