Julien Martin ca98821b3e Merge develop into master (squash): ticket #102 NIR harmonisation
- Backend: DTO NIR 15 car 2A/2B, validation format+clé, warning cohérence
- BDD: nir_chiffre NOT NULL, migration pour bases existantes
- Seeds: 02 nir_chiffre, 03 Marie 2A / Fatima 99
- Frontend: nir_utils, nir_text_field, formulaire pro, mock inscription AM

Made-with: Cursor
2026-02-26 13:55:42 +01:00
..

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.