Pla original

Mon, 01 Jan 0001 00:00:00 +0000

Document de planificació prèvia al codi que va originar aquest repositori. Es conserva íntegre com a referència de context i de “per què” de les decisions. Les decisions d’arquitectura vinculants viuen a AGENTS.md i als ADRs; l’estat real d’implementació viu a ROADMAP.md. Si aquest document i el ROADMAP.md discrepen, el ROADMAP.md mana (és el que es manté al dia).

Decisions ja preses respecte a la secció 6 d’aquest document (veure AGENTS.md/ADRs):

Frontend: React + TypeScript (Vite, PWA).

BD: PostgreSQL i SQLite suportats des del dia 1.

Nom/paquet: Fanel (the family organizer panel), paquet dev.agiro.fanel. UI per defecte en català, amb castellà com a segon idioma.

Multi-household des del model inicial.

Proveïdor d’IA per defecte: cap actiu per defecte, configurable (Ollama/OpenAI/Anthropic).

1. Què fa la POC (i què n’aprenem)

Mòdul	POC	Què cal per a la versió real
Menú	Graella dia × (esmorzar, dinar, berenar, sopar), text lliure	Setmanes reals (dates, no “Dilluns” genèric), receptes reutilitzables, generació de compra a partir del menú
Calendari	Llista d’esdeveniments amb data + títol + qui l’ha afegit	Hora, recurrència, per membre, sincronització CalDAV/ICS
Compra	Ítems amb `done`, “buida comprats”	Quantitats, categories/passadissos, múltiples llistes, mode botiga offline
Tasques	Text + assignat (Mamà/Papà/Nens) + `done`	Membres reals, recurrència, rotació, gamificació opcional
Identitat	`prompt('¿Cómo te llamas?')` local	Llar (household) + membres + login real però senzill (família, no empresa)
Persistència	`window.storage` clau-valor JSON	BD relacional, esdeveniments de domini, API estable

Conclusions: el model de dades és petit però totes les funcions es creuen (menú → compra, tasques → calendari, receptes → compra). L’arquitectura ha de facilitar aquestes interaccions sense acoblar els mòduls.

Full de ruta on Fanel

Pla original

1. Què fa la POC (i què n’aprenem)