petitspas/database/README.md
Julien Martin d32d956b0e feat(dashboard-admin): connect admin dashboard to real API data (Ticket #92)
- Frontend:
  - Create UserService to handle user-related API calls (gestionnaires, parents, AMs, admins)
  - Update AdminDashboardScreen to use dynamic widgets
  - Implement dynamic management widgets:
    - GestionnaireManagementWidget
    - ParentManagementWidget
    - AssistanteMaternelleManagementWidget
    - AdminManagementWidget
  - Add data models: ParentModel, AssistanteMaternelleModel
  - Update AppUser model
  - Update ApiConfig

- Backend:
  - Update controllers (Parents, AMs, Gestionnaires, Users) to allow ADMINISTRATEUR role to list users
  - Fix: Activate endpoint GET /gestionnaires (import GestionnairesModule in UserModule)

- Docs:
  - Add note about backend fix for Gestionnaires module
  - Update .cursorrules to forbid worktrees

- Seed:
  - Add test data seed script (reset-and-seed-db.sh)

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-17 22:17:51 +01:00

2.4 KiB
Raw Blame History

PtitsPas Ynov - Base de Données

Ce projet contient la base de données pour l'application PtitsPas, avec scripts de migration, import de données, documentation et configuration Docker.


Prérequis


Structure du projet

  • migrations/ : scripts SQL pour la création et l'import de la base
  • bdd/data_test/ : fichiers CSV pour l'import de données de test
  • docs/ : documentation métier et technique
  • seed/ : scripts de seed
  • tests/ : tests SQL
  • docker-compose.dev.yml : configuration Docker pour le développement

Lancer la base de données en local

Dans le terminal, depuis le dossier du projet:

docker compose -f docker-compose.dev.yml up -d

Pour arrêter et supprimer les volumes:

docker compose -f docker-compose.dev.yml down -v

Réinitialiser la BDD et charger les données de test (dashboard admin)

Depuis la racine du projet (ptitspas-app, où se trouve docker-compose.yml) :

./scripts/reset-and-seed-db.sh

Ce script : arrête les conteneurs, supprime le volume Postgres, redémarre la base (le schéma est recréé via BDD.sql), puis exécute database/seed/03_seed_test_data.sql. Tu obtiens un super_admin (admin@ptits-pas.fr) plus 9 comptes de test (1 admin, 1 gestionnaire, 2 AM, 5 parents) avec mot de passe : password. Idéal pour développer le ticket #92 (dashboard admin).

Importation automatique des données de test

Les données de test (CSV) sont automatiquement importées dans la base au démarrage du conteneur Docker grâce aux scripts présents dans le dossier migrations/.

Il n'est pas nécessaire de lancer manuellement le script d'import.


Accéder à pgAdmin4

Via Docker (local)

Ouvre ton navigateur sur:

http://localhost:8081

Email : admin@ptits-pas.fr Mot de passe : admin123

Mot de passse pour se connecter au server local : admin123

Conseils et bonnes pratiques

  • Vérifie la cohérence des identifiants dans les CSV avant import
  • Pour modifier la structure, utilise les scripts de migration dans migrations/
  • Pour ajouter des scripts d'automatisation, crée un dossier scripts/
  • Documente les étapes spécifiques dans le README ou dans docs/

Contact

Pour toute question ou contribution, consulte la documentation ou contacte l'équipe PtitsPas.