Diari del projecte: per on vaig

On som

El projecte va per la fase 2 de 9. Un resum ràpid de com s’hi ha arribat:

• Fase 0 — Fonaments. Servidor de desenvolupament amb Docker: app Next.js + Payload, PostgreSQL, MinIO per als media, Umami per a analítica i Uptime Kuma per a monitorització. Backups diaris automàtics.
• Fase 1 — Model de dades. Les 16 col·leccions de continguts (agenda, escapades, notícies, entrevistes, consells, establiments, revistes, publicitat…), migracions, rols d’usuari i dades d’exemple.
• Fase 2 — Frontend. En marxa: design system, home, article, agenda, escapades, establiments, entrevistes, consells, llistats amb filtres, revistes amb visor Calameo, pàgina de serveis i SEO (sitemap, robots, dades estructurades).

Els entrebancs del camí

No tot ha anat rodó, i és precisament el més interessant del diari. Algunes batalles recents:

• Docker Compose i les variables d’entorn: un healthcheck que llegia variables del host en lloc del contenidor, Umami que apuntava a la base de dades equivocada… vuit commits per deixar-ho net.
• Calameo: el visor de les revistes feia un redirect i després bloquejava l’iframe (SAMEORIGIN). Solució: URL canònica amb el paràmetre correcte.
• Hidració de React: un
• Tipat estricte de TypeScript amb Payload: queries que calia adaptar perquè el sistema de tipus i el CMS no parlaven el mateix idioma.

I a partir d’ara

Aquest diari s’anirà actualitzant sol: cada dia que hi hagi feina, hi haurà una entrada nova explicant què s’ha fet i què s’ha resolt. La idea és que el projecte quedi documentat pas a pas, amb els problemes reals inclosos.