Commerce Tracking - Introduction
Bienvenue dans la documentation du système Commerce Tracking, une solution complète de suivi du commerce transfrontalier développée avec une architecture microservices moderne.
🎯 Vue d'ensemble
Commerce Tracking est un système de gestion des flux commerciaux transfrontaliers qui permet :
- Collecte digitalisée des données commerciales
- Validation multi-niveaux des informations
- Suivi en temps réel des transactions
- Génération de rapports et statistiques
- Gestion des acteurs du commerce
🏗️ Architecture
Le système utilise une architecture microservices avec :
- API Gateway : Point d'entrée unique (NestJS)
- Microservices NATS : Communication asynchrone
- Base de données : PostgreSQL avec TypeORM
- Cache : Système de cache intelligent
- Authentification : JWT avec rôles hiérarchiques
🚀 Services disponibles
| Service | Port | Description |
|---|---|---|
| Gateway API | 3005 | Point d'entrée HTTP principal |
| Auth Service | NATS | Authentification et autorisation |
| Admin Service | NATS | Administration système |
| TradeFlow Service | NATS | Gestion des flux commerciaux |
| Model Service | NATS | Gestion des modèles de données |
| MySQL Database | 3340 | Base de données principale |
| Adminer | 8080 | Interface d'administration DB |
📋 Prérequis
- Docker et Docker Compose
- Node.js 18+ (pour le développement)
- Git (pour le clonage du projet)
🎯 Objectifs du système
✅ Déploiement modulaire - Services indépendants
✅ Scalabilité horizontale - Cluster NATS haute disponibilité
✅ Sécurité renforcée - Authentification JWT + rôles
✅ Performance optimisée - Cache intelligent
✅ Monitoring complet - Logs et métriques détaillés
📚 Navigation de la documentation
Cette documentation est organisée en sections principales :
- 🚀 Déploiement - Guide complet de déploiement Docker
- 🏗️ Architecture - Architecture système et microservices
- 📚 API Reference - Documentation des APIs
- 🔧 Configuration - Variables d'environnement
- 🧪 Tests & Qualité - Guide de test
- 🔍 Monitoring - Surveillance et logs
- 🛠️ Maintenance - Maintenance système
🚀 Démarrage rapide
Pour commencer rapidement avec Commerce Tracking :
# 1. Cloner le projet
git clone <repository-url>
cd commerce-tracking
# 2. Démarrer l'infrastructure
docker-compose -f db-docker-compose.yml -f nats-docker-compose.yml up -d
# 3. Démarrer les services
docker-compose -f auth-docker-compose.yml up -d
docker-compose -f admin-docker-compose.yml up -d
docker-compose -f tradeflow-docker-compose.yml up -d
docker-compose -f model-docker-compose.yml up -d
# 4. Démarrer le Gateway
docker-compose -f gateway-docker-compose.yml up -d
🌐 Accès aux services
- API Gateway : http://localhost:3005
- Adminer (DB) : http://localhost:8080
- Health Check : http://localhost:3005/health
📞 Support
Pour toute question ou assistance :
- 📧 Email : support@ofr.gov
- 📖 Documentation : Cette documentation complète
- 🐛 Issues : GitHub Issues du projet
Dernière mise à jour : Janvier 2025
Version : 1.0
Équipe : Office de Régulation (OFR)