Files
unionflow-server-api/unionflow/specs/000-unionflow-baseline/spec.md
dahoud b1957c1c81 feat(unionflow): ajout Spec-Kit, constitution, mission mutuelles
- 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
2026-02-27 14:41:07 +00:00

2.1 KiB

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

# Backend
cd unionflow-server-impl-quarkus && mvn clean verify

# Mobile
cd unionflow-mobile-apps && flutter pub get && flutter test