Desenvolupament web
Una web base per reutilitzar: Astro, FastAPI i un dashboard propi
El meu primer projecte en Astro, després d'anys amb WordPress: una base ben plantejada per als propers projectes.
El primer projecte en Astro
Fins ara he treballat amb WordPress: allà muntava les webs dels meus projectes i les dels clients. Aquest és el primer projecte que comence de zero amb Astro, i no és un capritxo tècnic: és una investigació. Vull comprovar sobre el terreny com és treballar amb aquestes eines — Astro, FastAPI, PostgreSQL, agents d’IA — abans de comprometre-m’hi.
Per què una base
Emprenec projectes web sovint i sempre acabo repetint el mateix: web pública, panell d’administració, autenticació, desplegament. Aquesta vegada he decidit fer-ho una vegada i fer-ho bé: una base propia, sòlida i pensada per reutilitzar en els propers projectes.
El punt de partida
Ahir vaig muntar la primera versió: Astro amb el framework Lumos, FastAPI i SQLite. Funcionava, però aviat he vist que es quedaria curt per allò que vull: diversos usuaris, cerca vectorial, integració de IA i agents. Aquest matí he començat una refactorització profunda, abans d’afegir funcionalitats noves.
Cap a on va
La base ja ha donat el tom: PostgreSQL amb pgvector, migracions amb Alembic, tot dockeritzat, autenticació JWT amb rotació de refresh tokens i el backend separat en serveis i repositoris. El dashboard es migra pantalla a pantalla, i la primera illa de React ja és en marxa amb la taula d’articles.
Abans de tocar res visual he documentat el sistema de disseny del panell: shell fosc, àrea de treball clara, tipografia Inter i índig per a les dades. Cada pantalla nova té els criteris escrits; no s’han d’inventar a mes que arriben.
Com ho documentaré
Dins del repositori hi ha un dev-journal on van quedant els hitos, les decisions, els errors i les solucions. A partir d’ara, aquestes notes explicaran el procés des de fora: què es va decidir, per què, què va fallar i com es va resoldre. També són part de la investigació: si la base funciona, aquí quedarà escrit per què; si no, també.
La regla del projecte: no afegir complexitat innecessària. Tot el que entra, entra amb una raó.