🚆 Ferrovia Panel - Administration Régionale

Bienvenue sur le Ferrovia Panel, l'interface d'administration centralisée dédiée à la gestion des exploitations ferroviaires régionales. Cette application React permet de piloter l'intégralité du système d'information voyageurs, des plans de transport, et de la communication interne.

---

🛠️ Technologies Utilisées

• Frontend : React 19 (Create React App)
• UI Kit : SNCF Web Components (WCS)
• Backend / Base de données : Supabase (PostgreSQL, Auth, RPC)
• Déploiement ciblé : Vercel / Netlify

---

🚀 Installation & Démarrage

1. Prérequis

• Node.js (version 18 ou supérieure recommandée)
• NPM (ou Yarn)
• Une instance Supabase active avec la base de données Ferrovia configurée.

2. Cloner et installer

git clone <votre-depot-ferrovia-panel>
cd ferrovia-panel
npm install

3. Configuration de l'environnement

Créez un fichier .env.local à la racine du projet et renseignez vos clés d'API Supabase :

REACT_APP_SUPABASE_URL=https://votre-projet.supabase.co
REACT_APP_SUPABASE_ANON_KEY=votre_cle_anonyme_publique

Note : Si vous utilisez le mode de développement local de test (Mock Login), définissez REACT_APP_ENABLE_MOCK_LOGIN=true.

4. Démarrage en environnement de développement

npm start

L'application sera accessible sur http://localhost:3000.

---

📦 Déploiement en Production

Le projet a été nettoyé et optimisé pour le déploiement. Pour générer les fichiers statiques de production :

npm run build

Le dossier build/ généré peut être déployé sur n'importe quel hébergeur statique (Vercel, Netlify, serveurs Nginx, etc.).

---

🗺️ Tour d'horizon des Fonctionnalités

Le panel est structuré autour de grands modules accessibles via la barre de navigation latérale et le menu régional, soumis à un contrôle d'accès (RBAC) précis :

🚉 1. Exploitation & Transport

• Gestion des Gares : Création, modification, détails des services (guichets, PMR), et gestion des correspondances intermodales (bus, tram, etc.).
• Quais & Voies : Paramétrage des règles de voies, et attribution en temps réel des quais d'arrivée/départ.
• Matériel Roulant : Catalogue des types de trains (TER, TGV, etc.) et composition dynamique des rames (voitures, motrices).
• Horaires & Circulations :
  • Édition des plans de transport.
  • Gestion calendaire complexe (Jours de circulation, jours fériés, périodes personnalisées).
  • Gestion des substitutions de matériel.
  • Importation GTFS (module expérimental).

⚠️ 2. Perturbations & Travaux

• Centre des Perturbations : Déclaration d'incidents, gestion des modifications de parcours et des retards.
• Gestion des Travaux : Programmation des fenêtres de travaux de maintenance avec recalcul automatique de l'impact sur les circulations et attributions de cars de substitution.

📢 3. Information Voyageurs & CMS

• Info Trafic : Diffusion d'alertes en temps réel sur les canaux voyageurs.
• Actualités & Événements : Rédaction d'articles et mise en avant de manifestations régionales.
• Menu Régional & Pages : Éditeur de contenu dynamique permettant de personnaliser des pages vitrines par région.

🔊 4. SIV (Annonces Sonores)

• Banque de mots : Gestion et stockage des fichiers audios pré-enregistrés.
• Templates d'Annonces : Création de séquences sonores dynamiques.
• Génération & Diffusion : Paramétrage des annonces enregistrées (synthèse vocale ou assemblages) et déclenchement ciblé en gare.

💶 5. Commercial

• Tarification : Gestion des grilles tarifaires régionales (prix plancher, prix par kilomètre, âge maximum).

💬 6. Collaboration Interne

• Messagerie : Chat interne permettant aux agents de communiquer en temps réel.
• Notifications : Centre d'alertes système pour suivre les opérations asynchrones.

⚙️ 7. Administration

• Gestion des Utilisateurs : Création de profils (administrateurs, agents, etc.), gestion des accès par module.
• Paramètres : Configuration globale de la plateforme ferroviaire.

---

🔒 Sécurité

• Toute communication backend est opérée via le client Supabase.
• Les identifiants de session expirés sont gérés (credentials: 'omit').
• RLS (Row Level Security) est implémenté en base de données pour protéger l'intégrité des opérations (les droits d'accès sont définis dans le schéma PostgreSQL de Ferrovia).