Solution FinTech Publique complète pour la digitalisation de la collecte des taxes de place de marché, comprenant une application mobile pour les agents de collecte et un tableau de bord web pour le Trésor Public.
- Framework: Spring Boot 3.5.0 avec Java 17
- Base de données: PostgreSQL avec JPA/Hibernate
- Sécurité: Spring Security avec JWT et Keycloak
- Documentation: OpenAPI/Swagger
- Validation: Hibernate Validator
- Mapping: MapStruct
- Framework: Vue.js 3 avec Composition API
- Build Tool: Vite
- UI: TailwindCSS
- State Management: Pinia
- HTTP Client: Axios
- Framework: Flutter
- State Management: Provider
- Local Storage: Hive pour le mode hors-ligne
- GPS: Geolocator
- QR Code: mobile_scanner
- Transaction: Acte de collecte effectué par un agent sur le terrain. Chaque transaction génère un reçu unique avec hash de sécurité. C'est l'unité atomique d'encaissement (un agent, un contribuable, un montant, un mode de paiement, GPS).
- TaxeCollect: Taxe due par un contribuable de manière périodique (mensuelle, annuelle). Une taxe peut être partiellement payée via plusieurs transactions. TaxeCollect représente l'obligation fiscale, Transaction représente l'acte de paiement.
Relation: Une
Transactionpeut être rattachée à uneTaxeCollect(paiement d'une échéance) ou être un encaissement spontané (sans taxe préalable).
- Agents: Gestion des agents avec zones géographiques
- Contribuables: Informations des contribuables avec QR codes
- Transactions: Collecte de taxes avec hash de sécurité
- Clôture de caisse: Validation journalière des encaissements
- QR Codes: Génération et scan des codes contribuables
- Audit: Traçabilité complète avec timestamps
POST /api/transactions- Créer une transactionGET /api/transactions/{id}- Détails transactionGET /api/transactions/receipt/{numeroRecu}- Recherche par reçuGET /api/transactions/agent/{agentId}- Transactions par agentPUT /api/transactions/{id}/sync- Synchronisation hors-ligneGET /api/transactions/{id}/verify- Vérification hash
POST /api/cloture-caisse/initier- Initier clôture journalièrePOST /api/cloture-caisse/{id}/soumettre- Soumettre déclarationPOST /api/cloture-caisse/{id}/valider- Validation TrésorPOST /api/cloture-caisse/{id}/rejeter- Rejet TrésorPOST /api/cloture-caisse/{id}/confirmer-depot- Confirmation dépôt
- Scan QR Code: Intégration avec mobile_scanner
- Recherche Manuel: Recherche de contribuables par nom/téléphone
- Sélection Paiement: Espèces ou Mobile Money
- Validation GPS: Capture automatique des coordonnées
- Mode Hors-ligne: Stockage SQLite avec synchronisation auto
- Génération Reçu: Numéro unique format TAX-YYYYMMDD-XXXX
- ApiService: Gestion des appels API et synchronisation
- GPSService: Géolocalisation haute précision
- Stockage Local: Hive pour transactions hors-ligne
- JWT tokens avec expiration
- Rôles: AGENT, TRESOR, ADMIN, SUPERVISEUR
- Validation par zone géographique
- Hash SHA-256 pour chaque transaction
- Numéros de reçu uniques et infalsifiables
- Traçabilité GPS pour prévenir la fraude
- Chiffrement local des données
- Synchronisation sécurisée au retour réseau
- File d'attente avec priorité
- Java 17+
- Node.js 16+
- PostgreSQL 15+
- Docker (optionnel)
- Frontend: http://localhost:3000
- Backend API: http://localhost:9090
- Base de données: localhost:5440
- Keycloak: http://localhost:8080
# Cloner le projet
git clone <repository-url>
cd taxcollect
# Démarrer PostgreSQL avec Docker
docker-compose up -d postgres
# Compiler et démarrer l'application
./mvnw spring-boot:runcd verdentax
flutter pub get
flutter run- Swagger UI:
http://localhost:9090/swagger-ui.html - OpenAPI JSON:
http://localhost:9090/v3/api-docs
- Agent se connecte avec ses identifiants
- Scan QR Code du contribuable OU recherche manuelle
- Saisie du montant et sélection mode paiement
- Validation GPS automatique
- Génération reçu avec hash unique
- Stockage local si hors-ligne
- Détection automatique du retour réseau
- Synchronisation des transactions en attente
- Mise à jour des statuts en temps réel
- Agent initie la clôture journalière
- Calcul automatique des totaux par mode paiement
- Déclaration du montant en main
- Soumission pour validation Trésor
- Validation après vérification du dépôt bancaire
- Vue temps réel des collectes
- Statistiques par agent et zone
- Export PDF/Excel des bordereaux
- Gestion des validations
-- Agents et zones
agent (id, nom, prenom, email, telephone)
zone_collecte (id, nom, quartier_id)
agent_zone (agent_id, zone_id)
-- Contribuables et QR codes
contribuable (id, nom, prenom, telephone, email, adresse, latitude, longitude, zone_id)
qr_code_contribuable (id, code_qr, contribuable_id, date_generation, actif)
-- Transactions
transaction (id, numero_recu, montant, contribuable_id, agent_id, zone_id,
mode_paiement, statut, reference_paiement, hash_transaction,
latitude, longitude, adresse_collecte, offline, date_creation)
-- Clôture de caisse
cloture_caisse (id, agent_id, date_cloture, montant_total_espece,
montant_total_mobile_money, montant_total, montant_declare,
montant_depose, reference_depot_banque, statut,
commentaire_agent, commentaire_tresor, date_validation_tresor,
valide_par_id, nombre_transactions)./mvnw testcd verdentax
flutter test# Copier .env.example vers .env et remplir les valeurs
cp .env.example .env
# Build et déploiement complet (PostgreSQL, LDAP, Keycloak, Backend, Frontend)
docker-compose up -d- Ne jamais committer de mots de passe ou secrets dans le dépôt
- Tous les secrets sont passés via des variables d'environnement (voir
.env.example) - Le fichier
.envest ignoré par git - En production, utiliser un gestionnaire de secrets (Vault, AWS Secrets Manager, etc.)
- Backend: Serveur d'application avec PostgreSQL
- Mobile: Build APK/IPA pour distribution
- Frontend: Build statique sur serveur web
- Application logs avec SLF4J
- Métriques avec Prometheus
- Health checks Spring Boot Actuator
- Connection pooling PostgreSQL
- Cache Redis pour les données fréquemment accédées
- Optimisation des requêtes JPA
- ARCHITECTURE.md - Architecture détaillée
- API Documentation - Swagger UI
- Database Schema - Diagramme entité-relation
- Support technique: [support@taxcollect.gov]
- Documentation: [docs.taxcollect.gov]
Développé avec ❤️ pour la digitalisation des services publics