b1957c1c81
- Config Spec-Kit pour Spec-Driven Development - CONSTITUTION.md + .specify/memory/constitution.md - Commandes Cursor /speckit.*, règles projet - Mission: associations + mutuelles d'épargne et de financement - .gitignore: versionner config spec-kit unionflow Made-with: Cursor
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# Spécification de base: UnionFlow - Projet existant (Brownfield)
|
|
|
|
**Feature Branch**: `000-unionflow-baseline`
|
|
**Created**: 2026-02-27
|
|
**Status**: Baseline documentant l'état actuel
|
|
**Type**: Brownfield / Documentation
|
|
|
|
## Contexte
|
|
|
|
Ce document capture l'état actuel du projet UnionFlow pour le Spec-Driven Development. UnionFlow est une plateforme de gestion d'associations, clubs et organisations à but non lucratif, et de **gestion des mutuelles d'épargne et de financement**.
|
|
|
|
## Architecture actuelle
|
|
|
|
### Modules
|
|
|
|
| Module | Technologie | Rôle |
|
|
|--------|-------------|------|
|
|
| **unionflow-server-api** | Java 17, Maven | DTOs, enums, contrats API (sans dépendances runtime) |
|
|
| **unionflow-server-impl-quarkus** | Quarkus 3.15.1, Panache | Backend REST, JPA, Keycloak |
|
|
| **unionflow-client-quarkus-primefaces-freya** | Quarkus, PrimeFaces | Client web admin |
|
|
| **unionflow-mobile-apps** | Flutter 3.x | Application mobile (Android/iOS) |
|
|
|
|
### Principes clés (cf. CONSTITUTION.md)
|
|
|
|
- **DDD strict**: Resources → Services → Repositories
|
|
- **API/Impl separation**: unionflow-server-api pur, sans Quarkus/JPA
|
|
- **Keycloak**: Authentification OAuth2/OIDC
|
|
- **PostgreSQL** (prod), **H2** (dev/test)
|
|
- **100% JaCoCo** sur le backend
|
|
- **Flyway** pour les migrations
|
|
|
|
### Répertoires importants
|
|
|
|
```
|
|
unionflow/
|
|
├── unionflow-server-api/ # API pure
|
|
├── unionflow-server-impl-quarkus/ # Implémentation
|
|
├── unionflow-client-quarkus-primefaces-freya/
|
|
├── unionflow-mobile-apps/ # Flutter
|
|
├── .specify/ # Spec-Kit
|
|
├── specs/ # Spécifications features
|
|
└── CONSTITUTION.md # Principes projet
|
|
```
|
|
|
|
## Workflow Spec-Kit pour nouvelles features
|
|
|
|
1. **Branche feature**: `001-nom-court`, `002-autre-feature`, etc.
|
|
2. **Specs**: `specs/001-nom-court/spec.md`, `plan.md`, `tasks.md`
|
|
3. **Commandes Cursor**: `/speckit.specify`, `/speckit.plan`, `/speckit.tasks`, `/speckit.implement`
|
|
|
|
## Commandes utiles
|
|
|
|
```powershell
|
|
# Backend
|
|
cd unionflow-server-impl-quarkus && mvn clean verify
|
|
|
|
# Mobile
|
|
cd unionflow-mobile-apps && flutter pub get && flutter test
|
|
```
|