petitspas/frontend/README.md
Julien Martin 9cb4162165 feat: Intégration du frontend Flutter depuis YNOV
- Framework: Flutter web
- Pages: Login, inscription, dashboards
- Services: API client, authentification, gestion d'état
- Intégration avec backend NestJS
- Dockerfile pour déploiement web
2025-11-24 15:44:15 +01:00

70 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# petitspas
A new Flutter project.
## Getting Started
This project is a starting point for a Flutter application.
A few resources to get you started if this is your first Flutter project:
- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
### Workflow Git
Le projet suit un **Git Flow simplifié** avec 3 branches principales :
- `main` : version stable et déployée en production
- `develop` : version intégrée et testée avant passage en production
- `feature/*`, `fix/*`, `hotfix/*` : branches spécifiques au développement
**Cycle standard :**
```bash
# Création dune feature
git checkout develop
git checkout -b feature/FRONT-021-zone-enfants
# Développement
git add .
git commit -m "FRONT-021: Widget zone enfants"
git push origin feature/FRONT-021-zone-enfants
# Pull Request => vers develop
# Merge → suppression de la branche
Voir CONTRIBUTING.md pour les conventions détaillées.
```
### Structure du projet Flutter
Le projet suit une architecture modulaire MVC simplifiée compatible avec Provider (ou Riverpod léger).
```plaintext
lib/
├── main.dart # Point dentrée
├── routes/ # go_router ou auto_route
├── models/ # Classes de données (User, Parent, Enfant, etc.)
├── services/ # Requêtes HTTP, AuthService, StorageService
├── utils/ # Helpers, validateurs, formatteurs
├── widgets/ # Composants UI réutilisables
├── screens/ # Pages par grande fonctionnalité
│ ├── auth/ # Connexion, inscription, mot de passe oublié
│ ├── registration/ # Création parent / assistante maternelle
│ ├── dashboard/ # Tableau de bord parent / AM / gestionnaire
│ ├── profile/ # Gestion des infos utilisateur
│ └── children/ # Fiches enfants
```
### Architecture choisie
🟩 Type : MVC Modulaire avec Provider (ou Riverpod léger)
Avantages :
- Simple à prendre en main
- Rapide à structurer
- Permet la séparation des features
- Adaptée à un projet Flutter Web PWA