📘 Architecture & Documentation

🎯 Objectif

MES-FGAM est un Manufacturing Execution System (MES) dédié à l'atelier peinture de Figeac Aéro. Il assure le suivi en temps réel de la production, la traçabilité complète des opérations de peinture, et la gestion des fiches techniques de préparation peinture.

📋 Fonctions principales

• Lancement de lots (GROF) — Création de groupements d'OFs avec sélection de cabine et type de peinture
• Suivi poste par poste — Progression step-by-step à travers 16 étapes (Prépa → Peinture → Désolvatation → Étuve × 4 passes)
• Préparation labo peinture — Consultation des fiches techniques avec checkpoints par OF
• Supervision en temps réel — Vue globale de tous les GROFs actifs avec état courant
• Traçabilité & export PDF — Archives des lots terminés avec formulaire FORM-589
• Gestion des accès — Matrice de permissions configurable par rôle

🏗️ Stack technologique

📁 Structure des fichiers

MES-FGAM/
├── server.js                 # Serveur Express (API + fichiers statiques)
├── package.json              # Dépendances Node.js
├── paint_data.js             # Catalogue peintures source (152 fiches)
├── Dockerfile                # Image Node.js 20 Alpine
├── docker-compose.yml        # Orchestration PostgreSQL + App
├── .env                      # Variables d'env (DB, JWT — non versionné)
│
├── db/
│   ├── schema.sql            # Schéma des 6 tables
│   ├── pool.js               # Pool de connexion PostgreSQL
│   ├── init.js               # Initialisation du schéma au démarrage
│   └── seed.js               # Import peintures + users + permissions
│
├── middleware/
│   └── auth.js               # Vérification JWT + contrôle de rôle
│
├── routes/
│   ├── auth.js               # Authentification + permissions
│   ├── grofs.js              # CRUD lots de production
│   └── paints.js             # Catalogue peintures
│
└── public/                   # Fichiers servis en statique
    ├── index.html            # Portail principal + login
    ├── lancement.html        # Création de GROFs
    ├── poste_prepa.html      # Préparation (masquage, ponçage)
    ├── labo_peinture.html    # Fiches techniques labo
    ├── poste_cabine.html     # Application peinture + désolvatation
    ├── poste_etuve.html      # Étuvage + suivi T°C
    ├── supervision_live.html # Vue temps réel
    ├── tracabilite.html      # Archives + FORM-589
    ├── admin_access.html     # Gestion permissions
    ├── architecture.html     # Cette page
    └── js/api.js             # Module API partagé (fetch + JWT)

🔄 Flux principal

Chaque pièce aéronautique suit un cycle de peinture en 4 passes, chacune composée de 4 sous-étapes :

📦 Qu'est-ce qu'un GROF ?

Un GROF (GROupement de Fabrication) est un lot de production regroupant plusieurs OFs (Ordres de Fabrication) assignés à une même cabine de peinture. Chaque GROF :

• Est identifié par un code unique (ex: G847291)
• Est assigné à une cabine (SAIMA 1, SAIMA 2 ou SAIMA 3)
• Contient 1 à N ordres de fabrication (OFs)
• Progresse à travers 16 étapes séquentielles
• Passe par 3 statuts : EN COURS → TERMINÉ ou ANNULÉ

🏠 Portail (index.html)

• Login — Code opérateur + mot de passe. Token JWT stocké en sessionStorage
• Menu — Cartes de navigation filtrées par les permissions du rôle
• Liens admin — Visibles uniquement pour le rôle admin

➕ Lancement de Lots (lancement.html)

• Sélection de cabine — SAIMA 1, SAIMA 2 ou SAIMA 3
• Ajout d'OFs — Numéro d'OF, recherche dans le catalogue peintures (auto-complete)
• Champs par OF — Numéro OF, fournisseur, type/couleur peinture, type (P/F/V), quantité (g), n° fiche
• Création GROF — Génère un ID unique G + 6 chiffres, statut initial EN COURS, step 0

🔧 Poste Préparation (poste_prepa.html)

• Steps affichés — 0 (Alignement F1), 4 (Retournement F2), 8 (Prépa Fin F1), 12 (Prépa Fin F2)
• Action — Bouton « Valider » pour avancer au step suivant
• Log — Enregistre l'opérateur, l'horodatage et les éventuelles notes

🧪 Prépa Labo Peinture (labo_peinture.html)

• Vue par cabine — Onglets SAIMA 1/2/3 avec compteurs de GROFs en attente
• Fiches techniques — Clic sur un OF pour afficher la fiche de préparation peinture complète (proportions, durcisseur, diluant, durée de vie, conditions d'application)
• Checkpoint — Cocher chaque OF pour confirmer la préparation
• Envoi en peinture — Bouton actif uniquement quand tous les OFs sont cochés. Passe le GROF en paintReady = true

🎨 Poste Peinture (poste_cabine.html)

• Steps peinture — 1 (Prim F1), 5 (Prim F2), 9 (Fin F1), 13 (Fin F2)
• Steps désolvatation — 2 (Desol Prim F1), 6 (Desol Prim F2), 10 (Desol Fin F1), 14 (Desol Fin F2)
• Timer Flash-Off — Démarre automatiquement après validation de la peinture
• Saisie — Température (°C), Hygrométrie (%), Notes libres

🔥 Poste Étuve (poste_etuve.html)

• Steps — 3 (Étuve Prim F1), 7 (Étuve Prim F2), 11 (Étuve Fin F1), 15 (Étuve Fin F2)
• Saisie — Température, durée de cuisson, humidité
• Fin de gamme — Le step 15 termine le GROF → statut TERMINÉ

📊 Supervision Live (supervision_live.html)

• Vue synthétique — Tous les GROFs EN COURS avec step courant et cabine
• Couleurs — Indicateurs visuels par type d'étape
• Reset — Bouton admin uniquement pour réinitialiser toute la production

📄 Traçabilité & Archives (tracabilite.html)

• Historique — Liste des GROFs terminés avec détails complets
• Logs — Timeline de chaque étape (opérateur, heure, durée, T°C, humidité)
• Export FORM-589 — Impression PDF de la fiche de traçabilité conforme au formulaire qualité

⚙️ Gestion des Accès (admin_access.html)

• Matrice checkbox — Rôles (colonnes) × Écrans (lignes)
• Admin only — Seul le rôle admin peut modifier les permissions
• Effet immédiat — Les changements s'appliquent au prochain chargement de page

👥 Les 5 rôles

🔐 Utilisateurs par défaut

📐 Schéma relationnel — 6 tables

Table users

Table screen_permissions

Table paints — Catalogue peintures (152 fiches)

Table grofs — Lots de production

Table grof_ofs — OFs rattachés à un GROF

Table grof_logs — Journal de traçabilité

🔑 Authentification (/api/auth)

📦 GROFs (/api/grofs)

🎨 Peintures (/api/paints)

❤️ Santé

🔒 Mécanisme JWT

• Login — POST /api/auth/login → retourne un token JWT signé
• Durée — Token valide 12 heures, stocké en sessionStorage
• Transfert — Header Authorization: Bearer <token> sur chaque requête API
• Expiration — L'API retourne 401, le frontend redirige vers le login

🔑 Mot de passe

• Hashés avec bcrypt (10 rounds de salage)
• Jamais stockés en clair dans la base
• Comparaison sécurisée via bcrypt.compare()

🛡️ RBAC (contrôle d'accès par rôle)

• Côté API — Middleware requireRole('admin') pour les routes sensibles
• Côté Frontend — MES_API.checkAccess('screenName') à l'ouverture de chaque page
• Portail — Cartes masquées pour les écrans non autorisés via getPermissions()

🐳 Docker Compose

# Démarrer l'application
docker compose up -d --build

# Seed la base de données
docker compose exec app node db/seed.js

# Voir les logs
docker compose logs -f app

# Redémarrer
docker compose restart app

📍 Infrastructure VPS