Reblochon

Todo app au nom de fromage. Projet fun, démonstratif, rien d'autre.

Ce dépôt n'est pas un produit. Pas de feuille de route, pas de support, pas d'engagement de maintenance. Le code est là pour montrer un petit stack complet (API, base, UI) et pour s'amuser avec le nom.

Ce que la démo couvre, sans prétention : tableaux, vue du jour, commentaires, whiteboard, invitations.

Stack : FastAPI + PostgreSQL, React (Vite) + pnpm, UI basée sur 000h.

Démo

Reblochon.mp4

Prérequis

• Docker Desktop (PostgreSQL)
• Python 3.13+ et uv
• Node.js 22+ et pnpm 10+

Lancer en local

cp .env.example .env
cp api/.env.example api/.env
make install
make up
make migrate
make api    # http://127.0.0.1:8000
make web    # http://127.0.0.1:5173

Si tu migres depuis une ancienne base courtests, recrée le volume Postgres une fois :

docker compose down -v
make up
make migrate

Puis pointe DATABASE_URL dans api/.env vers les identifiants reblochon de .env.example.

Stack complète (Docker)

cp .env.example .env   # mets un vrai JWT_SECRET
make up-all            # db + api + web (profil full)

• API : http://localhost:8000
• Web : http://localhost:8080

Qualité

make lint      # ruff + oxlint + prettier check
make format    # ruff format + prettier
make test      # pytest API
make ci        # lint + tests + typecheck + build web

Hooks locaux (après make install) :

cd api && uv run pre-commit install

La CI GitHub Actions rejoue les mêmes checks (service Postgres pour les tests API).

Layout

• api/app/ — routers, schemas, services, repositories, db, security
• api/tests/ — unit + integration pytest
• web/ — React 19, TanStack Query + Router, i18n FR (défaut) / EN
• docs/demo.mp4 — capture de la démo
• SPECS.md — contrats de comportement pour les tests
• ARCHITECTURE.md — découpage et runtime

Première session

1. Inscription sur /register (une équipe par défaut et un board Général sont créés)
2. Changer ou créer une équipe depuis le sélecteur ; suppression réservée au owner, page Team
3. Board ou vue du jour ; une tâche ouvre détail, liens, commentaires et le whiteboard Excalidraw

Licence

MIT. Voir LICENSE.