petitspas/docs/00_INDEX.md

📚 Index de la Documentation - PtitsPas App

Bienvenue dans la documentation complète de l'application PtitsPas.

Ce fichier sert d'index pour naviguer dans toute la documentation du projet.

📖 Table des matières

📋 Cahier des Charges

• 01 - Cahier des Charges - Cahier des charges complet du projet P'titsPas (V1.3 - 24/11/2025)

Architecture & Infrastructure

• 02 - Architecture - Vue d'ensemble de l'architecture mono-repo et multi-conteneurs
• 03 - Déploiement - Guide complet de déploiement et configuration CI/CD

Planification

• 04 - Roadmap Générale - Roadmap complète du projet (Phases 1 à 5+)

Développement

• 10 - Database Schema - Schéma de la base de données et modèles
• 11 - API Documentation - Documentation complète des endpoints REST
• 14 - Note backend config setup - Setup configuration
• 92 - Note backend gestionnaires - Gestionnaires
• 99 - Règles de codage - Conventions de code

Workflows Fonctionnels

• 20 - Workflow Création de Compte - Workflow complet de création et validation des comptes utilisateurs
• 21 - Configuration Système - Configuration on-premise dynamique
• 22 - Documents Légaux - Gestion CGU/Privacy avec versioning

Juridique (sources & technique)

• Dossier juridique - Index : CGU/CGC en Markdown, export PDF, lien vers la doc technique n°22

Projet & suivi (Gitea / tickets)

• 23 - Liste des Tickets - 61 tickets Phase 1 détaillés
• 24 - Décisions Projet - Décisions architecturales et fonctionnelles
• 25 - Backlog Phase 2 - Fonctionnalités techniques reportées
• 28 - Évolution famille et responsables - Modèle dossier/famille, recompositions, v1.0.0 vs post-1.0.0
• 26 - API Gitea - Procédure d'utilisation de l'API Gitea (issues, PR, branches, labels)
• 27 - Briefing frontend - Accès Git, priorités, scripts Gitea (token)

Archive & convention de nommage

• Dossier archive - Fichiers sans NN_ déplacés (temporaires, obsolètes) ; règles de rangement et suppression
• Pointeur : PROCEDURE-API-GITEA.md → voir 26

Exceptions de nommage (racine docs/)

Fichiers sans préfixe numérique encore à la racine par héritage ou références outils (.cursorrules, etc.) — à renommer en NN_ quand possible :

• CHARTE_GRAPHIQUE.md
• EVOLUTIONS_CDC.md — écarts CDC / app ; voir aussi 28 - Évolution famille
• SuperNounou_Cahier_Des_Charges_Complet_V1.1.md
• SuperNounou_SSS-001.md

Administration (À créer)

• 30 - Guide d'administration - Gestion des utilisateurs, accès PgAdmin, logs
• 31 - Troubleshooting - Résolution des problèmes courants

Frontend (À créer)

• 40 - Frontend Flutter - Structure de l'application mobile/web

Audit & Analyse

• 90 - Audit du projet YNOV - Analyse complète du code étudiant et fonctionnalités

🚀 Quick Start

# Cloner le projet
git clone ssh://gitea-jmartin/jmartin/app.git ptitspas-app

# Lancer l'environnement de développement
cd ptitspas-app
docker compose up -d

# Accéder aux services
Frontend: https://app.ptits-pas.fr
API: https://app.ptits-pas.fr/api
PgAdmin: https://app.ptits-pas.fr/pgadmin

🔗 Liens utiles

• Gitea : https://git.ptits-pas.fr
• Production : https://app.ptits-pas.fr
• Mail : https://mail.ptits-pas.fr

📝 Maintenance

Cette documentation est maintenue par Julien Martin (julien.martin@ptits-pas.fr).

Dernière mise à jour : Juin 2026