Guía técnica / Fundamentos
Diseña tu primera arquitectura estática
El objetivo es poder explicar qué hace cada componente antes de añadir servicios.
El problema
Quieres publicar guías técnicas. El lector necesita páginas claras y rápidas; el autor necesita revisar cambios y corregir errores sin editar HTML a mano.
Para este primer diseño no necesitas cuentas de lectores, una base de datos ni contenido personalizado. Esas capacidades pueden incorporarse si aparece una necesidad concreta.
Cuatro responsabilidades
- Contenido: archivos Markdown que contienen el conocimiento.
- Control de versiones: un repositorio Git conserva cambios y permite revisarlos.
- Construcción: Astro convierte las fuentes en HTML, CSS y los recursos necesarios.
- Publicación: una plataforma como Cloudflare Pages sirve esos archivos mediante HTTPS.
Autor → Markdown → Revisión en Git → Construcción → Archivos estáticos → LectorLa construcción ocurre al publicar una versión. El lector recibe archivos ya generados; no hace falta ejecutar un modelo de IA ni consultar una base de datos por cada visita.
Define los límites
- El repositorio almacena fuentes y configuración, nunca secretos.
- CI comprueba que las fuentes permiten construir el sitio.
- La publicación de producción utiliza una versión revisada de
main. - El dominio identifica el sitio; no decide dónde se guarda el código.
Explica el costo de la decisión
Un sitio estático reduce la operación, pero requiere una reconstrucción para publicar cambios. No ofrece por sí mismo sesiones de usuario ni consultas personalizadas. Para una biblioteca inicial de guías, esta restricción puede ser adecuada.
El plan gratuito del proveedor tiene límites. Revisa su uso antes de ampliar la arquitectura y considera la renovación anual del dominio por separado.
Comprueba el resultado
- La construcción finaliza sin errores.
- Existe un
index.htmlen el directorio de salida. - Los enlaces internos llevan a páginas reales.
- La página funciona en una pantalla pequeña y con navegación por teclado.
- El dominio sirve la versión prevista por HTTPS.
Practica con tu propio diseño
Dibuja los cuatro componentes e identifica su entrada y su salida. Después, responde: ¿qué cambia si necesitas publicar cien guías? ¿Y si necesitas que cada lector guarde su progreso?
La primera pregunta puede resolverse manteniendo una arquitectura estática. La segunda introduce estado y requiere una decisión adicional. Documenta esa diferencia antes de seleccionar una herramienta.