Desarrollo web
Diari del projecte: per on vaig
Fase 2 en marxa: estat del projecte i com continuaré documentant-lo aquí.
2 min de lectura
On som
El projecte va per la fase 2 de 9. Resum ràpid del camí recorregut:
- Fase 0 — Fonaments. Servidor de desenvolupament amb Docker (contenidors aïllats): app Next.js + Payload —el gestor de continguts—, 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 (canvis controlats de la base de dades), rols d'usuari i dades d'exemple.
- Fase 2 — Frontend. En marxa: design system (els components visuals), home, article, agenda, escapades, establiments, entrevistes, consells, llistats amb filtres, revistes amb visor Calameo, pàgina de serveis i SEO (sitemap, robots, dades estructurades). Ve d'una Auditoria abans de tocar res i de cinc propostes comparades (Del prototip al disseny validat).
Els entrebancs del camí
No tot ha anat rodó, i és el més interessant del diari. Algunes batalles recents:
- Docker Compose i les variables d'entorn: un healthcheck —la prova de vida— 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 (finestra incrustada; SAMEORIGIN: només mateix domini). Solució: URL canònica amb el paràmetre correcte.
- Hidració de React —el JavaScript pren el control de la pàgina—: un
- Tipat estricte de TypeScript amb Payload: queries adaptades 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 de 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.