matau/inspecteur-mes-demarches repository overview

⁠Inspecteur Mes-Démarches

Inspecteur Mes-Démarches est un système automatisé de validation et de traitement des dossiers pour la plateforme gouvernementale mes-démarches.gov.pf de la Polynésie française. L'application effectue des contrôles automatiques, des calculs et des tâches de workflow sur les dossiers soumis par les utilisateurs.

⁠Fonctionnalités principales

• Validation automatique des dossiers et de leurs pièces jointes
• Calculs automatisés (montants, taxes, subventions)
• Gestion des workflows (acceptation, refus, instruction)
• Intégration de paiement via PayZen
• Génération de documents Excel et publipostage
• Intégration Baserow pour la gestion de données
• Traitement spécialisé par ministère/direction

⁠Technologies

• Ruby 3.1.2
• Rails 7.0.4
• PostgreSQL 16.9
• Docker pour le déploiement

⁠Développement

⁠Prérequis

• Ruby 3.1.2
• PostgreSQL 16.9
• Bundle

⁠Installation

# Cloner le projet
git clone <repository-url>
cd inspecteur-mes-demarches

# Installer les dépendances
bundle install

# Configurer la base de données
rails db:create db:migrate db:seed

# Lancer l'application
rails server
# ou avec webpack dev server
bin/dev

⁠Tests

# Tous les tests
bundle exec rspec

# Test spécifique
bundle exec rspec spec/path/to/file_spec.rb

# Test à une ligne précise
bundle exec rspec spec/path/to/file_spec.rb:LINE_NUMBER

⁠Linting

# Tous les linters
bundle exec rake lint

# Rubocop uniquement
bundle exec rubocop --parallel

# SCSS linter
bundle exec scss-lint app/assets/stylesheets/

⁠Jobs

# Programmer les tâches cron
rails jobs:schedule

# Afficher le planning
rails jobs:display_schedule

# Lancer le worker
rails jobs:work

⁠Tâches disponibles

Les tâches suivantes sont organisées par catégorie et héritent de la classe InspectorTask :

⁠Gestion des dossiers

⁠Validation et contrôles

⁠DAF (Direction des Affaires Foncières)

⁠Santé

⁠CIS (Formation)

⁠DESETI (Services sociaux)

⁠DJS (Jeunesse et Sports)

⁠PayZen (Paiements)

⁠Calculs

⁠Excel

⁠Actions et utilitaires

⁠Intégration

⁠Configuration

⁠Variables d'environnement

Créer un fichier .env avec les variables suivantes :

ROOT=chemin vers le répertoire contenant le .env
IMAGE=matau/imd
TAG=latest

DB_DATABASE=Nom de la base à créer
DB_HOST=db
DB_USERNAME=postgres
DB_PASSWORD=mot_de_passe

PORT=3000

# Paramètres GraphQL
GRAPHQL_HOST=https://www.mes-demarches.gov.pf
GRAPHQL_BEARER=Token Mes-Démarches permettant l'accès aux démarches

# Accès CPS pour les numéros DN
API_CPS_USERNAME=
API_CPS_PASSWORD=
API_CPS_CLIENT_ID=
API_CPS_CLIENT_SECRET=

# Baserow (optionnel)
BASEROW_URL=https://baserow.mes-demarches.gov.pf
BASEROW_API_TOKEN=your_token
BASEROW_TOKEN_TABLE=table_id

⁠Fichier de configuration

Placer le fichier auto-instructeur.yml dans le répertoire /storage pour définir la liste des contrôles à effectuer.

⁠Architecture

L'application est organisée autour de deux concepts principaux :

1. FieldChecker : Classes de validation et traitement des champs de formulaire
2. InspectorTask : Tâches automatisées sur les dossiers

Les tâches sont organisées par ministère/direction (DAF, Santé, CIS, DESETI, DJS) et par type de fonctionnalité (validation, calculs, paiements, etc.).

⁠Contribution

1. Créer une branche feature
2. Implémenter les modifications avec tests
3. Vérifier le linting : bundle exec rake lint
4. Soumettre une pull request

⁠Licence

Ce projet est développé pour l'administration de la Polynésie française.