Tunnel GMAO - Backend API

API backend pour Tunnel GMAO, solution open-source de gestion de maintenance industrielle.

🎯 Philosophie

Ce backend suit les principes du projet Tunnel GMAO :

• L'action est l'unité de travail réel : temps, complexité et pièces sont tracés au niveau des actions, pas des interventions
• Terrain first : l'API reflète la réalité du travail terrain sans imposer de méthode
• Sobriété : pas de complexité inutile, pas d'ERP déguisé, juste ce qui est nécessaire
• Traçabilité fiable : enregistrer ce qui se passe réellement, sans bureaucratie excessive

📋 Responsabilités

Cette API fournit les données pour l'interface Tunnel GMAO :

• Équipements : liste, état, statistiques d'interventions
• Interventions : gestion du cycle de vie, statuts, priorités
• Actions : traçabilité du travail réel (temps, complexité, pièces)
• Demandes d'achat : suivi des demandes et de leurs statuts (qualification, références fournisseurs, commandes)
• Catalogue stock : navigation par familles/sous-familles avec informations de caractérisation
• Templates de pièces : caractérisation structurée des pièces avec versionnement (v1.4.0)
• Statistiques : vue d'ensemble des interventions par type et statut

Nouveauté v3.1.0 : Authentification par clé d'API pour les intégrations machine-to-machine (serveur MCP, scripts d'automatisation). Rôle MCP dédié avec accès lecture seule, géré via l'interface admin.

Nouveauté v3.0.0 : Système d'authentification souverain Tunnel — plus de dépendance à Directus pour les utilisateurs terrain.

🎯 Pour qui ?

PME industrielles avec 10 à 100 machines et équipes de maintenance de 1 à 10 personnes qui veulent structurer leur maintenance sans logiciel lourd et coûteux.

� Démarrage

Option 1 : Docker (Recommandé)

# Démarrer tous les services (PostgreSQL + Directus + API)
docker-compose up -d

# Accès
# API: http://localhost:8000/docs
# Directus: http://localhost:8055 (admin@tunnel.local / admin)

Option 2 : Local (Python 3.12)

# Windows
.\run.bat

# Linux/Mac
./run.sh

# Accès
# API: http://localhost:8000/docs

Note : En local, PostgreSQL et Directus doivent être démarrés séparément ou via Docker.

Configuration CORS

En production, définissez CORS_ORIGINS pour autoriser les origines frontend qui doivent appeler l'API:

CORS_ORIGINS=http://192.168.1.54:5173,http://localhost:5173,http://127.0.0.1:5173

Chaque origine doit être complète (scheme://host:port) et séparée par une virgule.

�📄 Licence

AGPL-3.0 - Conformément au projet Tunnel GMAO

• Le code est libre d'utilisation
• Les modifications doivent être redistribuées sous la même licence
• Les données appartiennent à l'entreprise qui les génère
• Aucune collecte ou transmission de données vers l'extérieur

Voir LICENSE pour le texte complet.