Aides Simplifiées est une plateforme permettant de simuler son éligibilité à plusieurs aides financières. Ce projet repose sur AdonisJS, Inertia.js, Vue.js et le système de design de l'État français (DSFR).
Nous maintenons une documentation détaillée dans le dossier docs/. Voici les points d'entrée principaux :
- 🗺️ Architecture globale : Vue d'ensemble, stack technique et cartographie du projet. À lire en premier.
- 🏗️ Infrastructure : Déploiement, Docker et environnements.
- 🧪 Tests & Qualité : Stratégie de tests (Japa, Vitest, Playwright, RGAA).
- Business Features : Simulateurs, Aides
- Technique : Base de données, Services, Architecture Vue
- Intégrations : Publicodes, Démarches Simplifiées
- Node.js v22.21.1
- PNPM v10+ (gestionnaire de paquets)
- Docker (pour la base de données et les services tiers)
-
Cloner et installer
git clone <url-du-repo> cd aides-simplifiees-app pnpm install
-
Configurer l'environnement
cp .env.template .env # configurer les variables dans .env selon vos besoins # voir docs/technical/infrastructure.md pour les détails
-
Démarrer l'infrastructure
make dev
Lance PostgreSQL, OpenFisca et LexImpact via Docker.
-
Initialiser la base de données (la première fois seulement)
node ace migration:run --force node ace db:seed
-
Lancer le serveur
pnpm dev
Accédez à l'application sur http://localhost:3333.
Voir toutes les commandes avec make help.
| Action | Commande | Description |
|---|---|---|
| Infra | make dev |
Lance les conteneurs Docker nécessaires |
| Dev | pnpm dev |
Lance le serveur Adonis + Vite |
| Tests | pnpm test |
Lance tous les tests (Unit, E2E) |
| Lint | pnpm lint |
Vérifie le style du code |
| Format | pnpm format |
Formate le code |
| DB Shell | make db-shell |
Accès SQL direct à la base de données |