escandell.

Desarrollo web

Escandell Web V2 — Portfolio

Portfolio personal con Astro y gestor de proyectos propio con API REST y generacion de imagenes IA.

Estado
En produccion
Rol
Arquitecto y desarrollador principal

Context

El portfolio personal necesitaba una renovacion completa. El objetivo era crear un web moderno con Astro que sirviera como vitrina de proyectos, con un gestor propio que permitiera crear contenido facilmente, generar covers con IA y que los agentes Hermes gestionen contenidos autonomamente.

Que hace

  • Gestor de proyectos con API REST completa
  • Generacion de imagenes de portada con IA (MiniMax)
  • MCP endpoint para agentes Hermes
  • Build automatizado del web Astro
  • Soporte bilingue catalan-castellano

Dificultades principales

  • Disenar una API REST con concurrencia segura (If-Match con revision hash)
  • Integrar generacion de imagenes IA coherentes
  • MCP seguro pero flexible para agentes
  • Astro content collections con schemas Zod estrictos

Soluciones

  • API REST con If-Match/ETag para concurrencia segura
  • Integracion con MiniMax via endpoint interno
  • MCP endpoint con control de escritura separado
  • Schemas Zod con categorias, projectType y visual definidos

Aprendizajes

  • Astro content collections son potentes pero necesitan schemas bien definidos
  • If-Match/ETag es esencial para edicion concurrente
  • Un gestor propio da flexibilidad que un CMS generico no ofrece