Desarrollo web
Una web base para reutilizar: Astro, FastAPI y un dashboard propio
Mi primer proyecto en Astro, después de años con WordPress: una base bien planteada para los próximos proyectos.
El primer proyecto en Astro
Hasta ahora he trabajado con WordPress: allí montaba las webs de mis proyectos y las de mis clientes. Este es el primer proyecto que empiezo de cero con Astro, y no es un capricho técnico: es una investigación. Quiero comprobar sobre el terreno cómo es trabajar con estas herramientas — Astro, FastAPI, PostgreSQL, agentes de IA — antes de comprometerme con ellas.
Por qué una base
Emprendo proyectos web a menudo y siempre acabo repitiendo lo mismo: web pública, panel de administración, autenticación, despliegue. Esta vez he decidido hacerlo una vez y hacerlo bien: una base propia, sólida y pensada para reutilizar en los próximos proyectos.
El punto de partida
Ayer monté la primera versión: Astro con el framework Lumos, FastAPI y SQLite. Funcionaba, pero pronto he visto que se quedaría corto para lo que quiero: varios usuarios, búsqueda vectorial, integración de IA y agentes. Esta mañana he empezado una refactorización profunda, antes de añadir funcionalidades nuevas.
Hacia dónde va
La base ya ha dado el giro: PostgreSQL con pgvector, migraciones con Alembic, todo dockerizado, autenticación JWT con rotación de refresh tokens y el backend separado en servicios y repositorios. El dashboard se migra pantalla a pantalla, y la primera isla de React ya está en marcha con la tabla de artículos.
Antes de tocar nada visual he documentado el sistema de diseño del panel: shell oscuro, área de trabajo clara, tipografía Inter e índigo para los datos. Cada pantalla nueva tiene los criterios escritos; no hay que inventarlos a medida que llegan.
Cómo lo documentaré
Dentro del repositorio hay un dev-journal donde van quedando los hitos, las decisiones, los errores y las soluciones. A partir de ahora, estas notas explicarán el proceso desde fuera: qué se decidió, por qué, qué falló y cómo se resolvió. También son parte de la investigación: si la base funciona, aquí quedará escrito por qué; si no, también.
La regla del proyecto: no añadir complejidad innecesaria. Todo lo que entra, entra con una razón.