Projet EIR - Système de Gestion des IMEI

Système avec API traduite en français, système de permissions granulaires, et interface de gestion intuitive.

Caractéristiques Principales

• API en français : Tous les endpoints, messages et erreurs sont traduits
• Système de permissions granulaires avec valeurs françaises cohérentes en base de données
• Support multilingue : Français (par défaut), Anglais, Arabe avec traduction dynamique
• Interface de gestion intuitive avec scripts automatisés et menu interactif
• Architecture Docker pour un déploiement simplifié sur tous les environnements
• Documentation interactive Swagger en français
• Base de données PostgreSQL universelle compatible avec tous les clouds
• Système d'audit complet pour traçabilité et conformité réglementaire
• Validation IMEI avancée avec base de données TAC intégrée et algorithme Luhn
• Système de notifications email/SMS automatisé avec planificateur
• Gestion multi-protocoles (REST, SS7, Diameter) pour intégration réseau
• Import/Export en lot avec mapping de colonnes flexible
• Robustesse production avec gestion d'erreurs gracieuse
• Déploiement universel compatible avec Render, Heroku, AWS, Google Cloud, Azure

Démarrage Rapide

Option 1 : Script de Gestion Interactif (Recommandé)

git clone https://github.com/Mohamedsalem00/eir-project.git
cd eir-project
./scripts/manage-eir.sh

Option 2 : Démarrage Manuel Docker

docker compose up --build -d

L'application sera accessible sur :

• Interface API : http://localhost:8000
• Documentation : http://localhost:8000/docs
• Santé système : http://localhost:8000/verification-etat

Documentation API

La liste complète des points d'accès (endpoints) est disponible dans le document dédié : Consulter la documentation des endpoints

Architecture du Projet

eir-project/
├── backend/                 # API FastAPI en français
├── frontend/                # Interface utilisateur Next.js
├── scripts/                 # Suite complète de gestion
├── docs/                    # Documentation
├── data/                    # Fichiers de données et scripts d'import
├── docker-compose.yml       # Configuration multi-services
└── Makefile                 # Raccourcis de commandes

Base de Données

Structure Principale

Le système utilise PostgreSQL avec un schéma optimisé pour la performance et la traçabilité.

Fonctions de Validation IMEI

• valider_imei_avec_tac(VARCHAR) : Validation complète IMEI avec base TAC et algorithme Luhn
• valider_luhn(VARCHAR) : Validation algorithme Luhn
• extraire_tac_depuis_imei(VARCHAR) : Extraction code TAC depuis numéro IMEI

Fonctions de Synchronisation TAC

• sync_osmocom_csv() : Synchronisation automatique depuis API CSV Osmocom
• sync_osmocom_json() : Synchronisation depuis API JSON Osmocom

Comptes de Test Disponibles

• Administrateur : eirrproject@gmail.com / admin123
• Utilisateur standard : sidis9828@gmail.com / admin123
• Opérateur Orange : devvmrr@gmail.com / admin123
• Opérateur Inwi : inwi@eir.ma / admin123

Configuration

Le système est configurable via des variables d'environnement. Un exemple complet est disponible dans le guide de configuration.

Monitoring et Logs

Les logs sont consultables via l'option 8 du script manage-eir.sh ou via docker compose logs -f.

Support et Documentation

• Guide de Documentation - Index complet
• Guide des Tests - Validation du système
• Scripts de Gestion - Administration
• Diagrammes UML - Architecture système

---

Objectif : Fournir un système EIR complet, en français et prêt pour la production avec une interface de gestion intuitive, un système de permissions granulaires, et une robustesse éprouvée.