Full de ruta

Cada fase acaba amb una versió desplegable. Les decisions d’arquitectura estan a adr/ i resumides a AGENTS.md.

Origen: POC “Panel familiar” (menú setmanal 7 dies × 4 àpats, calendari, compra, tasques amb assignat, selector “qui sóc”). Pla d’arquitectura complet previ al codi: PLA-ORIGINAL.md (aquest ROADMAP.md és la font de veritat sobre l’estat real; el pla original és context).

Estat

Fase 0 — Fonaments

• Repositori, AGENTS.md, ROADMAP, ADRs 0001–0007
• Maven multi-mòdul: frontend (Vite build → static/) + backend (Spring Boot 4, Java 25)
• Spring Modulith amb els paquets de mòdul definits i ApplicationModules.verify() al CI
• JPA + Flyway; perfils postgres i sqlite; tests amb els dos motors
• Mòdul household real: Household, Member, REST /api/v1/households
• Spring Security bàsica (Basic auth des d’env), CORS configurable, SPA fallback
• Frontend React + TS + PWA + i18n (ca/es) amb esquelet de 4 pestanyes i pàgina de households
• Dockerfile multi-stage (una imatge, multi-arch) + docker-compose (Postgres i SQLite)
• GitHub Actions: verify + lint + imatge a GHCR
• Fet quan: docker compose up → login → SPA servida des del JAR → crear una llar. ✅

Fase 1 — Paritat amb la POC

• menu: MealPlan per setmana ISO real, MealSlot (esmorzar/dinar/berenar/sopar) amb text lliure
• shopping: llista per defecte, ítems amb done, “buida comprats”
• calendar: esdeveniments amb data (+hora opcional), agrupats per dia, addedBy
• chores: tasques amb assignat (membre) i done
• Membres reals amb color; selector “qui sóc” i mode tauleta (dispositiu compartit, canvi de membre amb PIN) — WhoAmI i HouseholdProvider ja muntats a App.tsx
• Autenticació: usuari/contrasenya per adults + token d’API per a clients — només hi ha un usuari admin global (Basic auth) i un token d’API per a clients; falta un model d’usuari per adult
• SSE /api/v1/events per a actualització en temps real entre dispositius — connectat des de App.tsx via useHouseholdEvents
• Export / import JSON de tota la llar — GET /api/v1/households/{id}/export i POST /api/v1/households/import (mòdul export)
• UI de les 4 pestanyes en català i castellà — Menu, Shopping, Calendar, Chores enrutades i amb claus i18n completes
• Afegir UI per al calendari, buscar i evaluar llibreries com https://www.untitledui.com/react/components/calendars i evaluarla com a adopció general — vegeu ADR 0008: es descarta Untitled UI (de pagament, requereix Tailwind) i qualsevol llibreria de components general; s’adopta el nucli MIT de FullCalendar (@fullcalendar/react 6.1.x) només per a Calendar.tsx, amb vistes mes/setmana/llista i locales ca/es
• Fet quan: la família substitueix la POC. Pendent només l’autenticació per adult individual.

Fase 2 — Valor de domini

• recipes: receptes amb ingredients (nom, quantitat, unitat, categoria), racions, etiquetes — CRUD a /api/v1/households/{id}/recipes
• Menú ↔ receptes; generació de la compra des del menú via esdeveniment MealPlanned — MealSlot.recipeId opcional; menu publica MealPlanned (@ApplicationModuleListener a shopping.domain.MealPlanListener) que afegeix els ingredients a la llista per defecte sense duplicar-ne el nom
• Compra: categories/passadissos, múltiples llistes, ítems recurrents, quantitats — el model ja admet category/unit/quantity a recipes, però ShoppingItem encara és només name+done; falta portar-ho a shopping
• Recurrència (RRULE) en calendari i tasques; rotació de tasques entre membres
• notifications: web push per recordatoris de tasques i esdeveniments
• PWA offline real per la llista de la compra (cache + cua de sincronització)
• UI de recipes al frontend (llistat/creació de receptes, selector de recepta al Menu) — pàgina Recipes.tsx i pestanya nova; Menu.tsx permet triar una recepta per àpat (a més del text lliure)

Fase 3 — IA i MCP

• assistant: tools @Tool sobre les APIs públiques dels mòduls (afegir a la compra, planificar àpat, llistar esdeveniments, assignar tasca…)
• ChatClient amb memòria JDBC; proveïdor per configuració (Ollama / OpenAI / Anthropic), cap actiu per defecte
• Xat a la UI (“planifica’m la setmana”, “què falta pel sopar de dijous?”)
• Servidor MCP a /mcp (Streamable HTTP) exposant tools, resources (menú, llista) i prompts; tokens per household amb àmbits
• automation: regles programades (proposta de menú el diumenge, recordatori de compra el divendres) reactives a esdeveniments
• Importació ICS / CalDAV (lectura)

Fase 4 — Clients Android i escriptori

• Client TypeScript generat des d’OpenAPI, compartit per web / Capacitor / Tauri
• Capacitor → APK Android (push natiu, compartir text a la llista, widget bàsic)
• Tauri → escriptori Linux / Windows / macOS
• (Opcional) client Kotlin generat si es fa app nativa

Fase 5 — Maduresa

• MCP client: Home Assistant, calendaris externs, supermercats
• RAG sobre receptes (pgvector) si aporta valor
• OIDC (Authelia/Authentik/Google), més idiomes, accessibilitat, mètriques, backups programats

Riscos vigilats