Plano seleccionado
Base del sitio
Un taller bilingüe, estático por defecto, con pequeñas islas interactivas y límites de servidor explícitos.
Objetivo de la experiencia
Cargar el portafolio rápidamente, mantener confiable su contenido y agregar infraestructura solo cuando la experiencia realmente la necesita.
Cómo funciona
- Ruta localizada
Next.js construye páginas dedicadas en inglés y español desde diccionarios tipados.
- Composición en servidor
Los Server Components ensamblan contenido del repositorio sin consultar un CMS en runtime.
- Islas interactivas
Clientes React enfocados controlan selección, juegos, tema y navegación.
- Límite confiable
Fastify controla secretos, partidas durables, llamadas de IA y entrega de recursos privados.
Por qué tomé estas decisiones
- Estático por defecto
- Elección
- Integrar el contenido del portafolio en páginas localizadas.
- Por qué
- La mayoría del contenido cambia con un despliegue; consultarlo en runtime agregaría latencia sin aportar valor.
- Tradeoff
- Las actualizaciones siguen el flujo del repositorio en lugar de un CMS para editores.
- Contenido bilingüe tipado
- Elección
- Dar a cada funcionalidad un contrato de diccionario en inglés y español.
- Por qué
- El compilador detecta estructuras faltantes y cada idioma conserva una redacción natural.
- Tradeoff
- Cada cambio público debe mantenerse en los dos idiomas.
- Servidor solo cuando se justifica
- Elección
- Mantener local el contenido estático y reservar Fastify para responsabilidades confiables.
- Por qué
- Secretos, persistencia, objetos privados y reglas autoritativas requieren servidor; una biografía no.
- Tradeoff
- El despliegue separa frontend, API, base de datos, worker y almacenamiento de objetos.
Tecnología en contexto
- Next.js 16
- Rutas localizadas estáticas y composición en servidor.
- React 19
- Límites pequeños de interacción en el cliente.
- TypeScript
- Contratos compartidos de contenido y comportamiento.
- CSS
- Layout responsivo, temas y movimiento reducido.
- Fastify
- Límite HTTP confiable para capacidades dinámicas.
- PostgreSQL + S3
- Estado durable y recursos raster privados.
Cómo se verifica
- La compilación de producción genera estáticamente las dos rutas localizadas.
- Los recorridos responsivos cubren escritorio, tablet y móvil.
- Las comprobaciones automáticas de accesibilidad se ejecutan en inglés y español.