Alternly 🗓️

Calendrier de garde partagée pour parents séparés, pensé pour la France : rythmes de garde (semaine/semaine, 2-2-3, un week-end sur deux, personnalisé), vacances scolaires officielles par zone A/B/C avec partage années paires/impaires, jours fériés et fêtes, exceptions ponctuelles, partage entre les deux parents, notifications in-app et abonnement iCal (Google/Apple Calendar).

Monolithe : un backend FastAPI sert l'API (/api/*) et le frontend React buildé.

Architecture

backend/   FastAPI + SQLAlchemy (Python 3.13) — moteur de garde pur et testé
frontend/  React 18 + Vite + TypeScript + FullCalendar
docs/      spec de design et plan d'implémentation

Données publiques intégrées (avec cache en base) :

• Vacances scolaires : dataset fr-en-calendrier-scolaire (data.education.gouv.fr)
• Jours fériés : calendrier.api.gouv.fr

Démarrage

1. Backend

cd backend
python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt   # prod : requirements.txt
cp .env.example .env        # puis renseigner DATABASE_URL et SECRET_KEY
.venv/bin/uvicorn app.main:app --port 8000

Sans .env, l'app démarre en mode dev sur SQLite (backend/coparent.db).

PostgreSQL (alwaysdata) — dans backend/.env :

DATABASE_URL=postgresql+psycopg://user:[email protected]/dbname
SECRET_KEY=<64 caractères aléatoires>

Hors SQLite, l'app refuse de démarrer si la SECRET_KEY est absente, connue ou fait moins de 32 caractères. Exploitation (Railway, alwaysdata, Vercel, Paddle, Resend, Sentry, cron, sauvegardes) : voir docs/ops.md.

2. Frontend

cd frontend
npm install
npm run build      # produit frontend/dist, servi automatiquement par FastAPI

Ensuite ouvrir http://localhost:8000 — l'app complète tourne sur ce seul port.

Développement front avec rechargement à chaud

cd frontend && npm run dev    # Vite sur :5173, proxy /api → :8000

Tests

cd backend && .venv/bin/python -m pytest tests/ -q

Tests hermétiques (APIs publiques simulées, aucun appel réseau), dont la partie critique : bascules années paires/impaires des vacances, périodes à cheval sur deux années (Noël), coupe en moitiés paires/impaires, fêtes des mères/pères (y compris le décalage Pentecôte), priorités exception > fête > vacances > rythme, isolation entre foyers, flux invitation, iCal, comptes (reset/changement de mot de passe, révocation, export RGPD), limitation de débit, demandes de changement entre parents et journal d'audit.

Points de conception

• On stocke les règles, pas les occurrences : le moteur (backend/app/services/custody_engine.py) est une fonction pure qui résout n'importe quelle plage de dates à la volée. Les exceptions ponctuelles sont une surcouche, jamais une mutation du planning.
• Les périodes de vacances du dataset officiel sont converties en bornes incluses Europe/Paris ; l'été est reconstruit à partir du marqueur « Début des Vacances d'Été » et de la rentrée de l'année scolaire suivante.
• Un seul foyer par utilisateur, deux parents max, invitation par lien signé à expiration.
• RGPD : minimisation (prénom de l'enfant seulement, anniversaire optionnel), hébergement UE visé, lien iCal révocable.

Périmètre actuel (MVP) et suite

Inclus : calendrier + moteur FR complet, partage 2 parents, exceptions, iCal, notifications in-app. V1 prévue (voir dossier de cadrage) : dépenses partagées, messagerie horodatée, export PDF, PWA/app mobile (paiement : Paddle, en place).