Arquitectura

IZ-KnowledgeBase usa una arquitectura de sitio estático basada en Astro Starlight. El contenido se escribe en Markdown/MDX y se organiza dentro de src/content/docs. Astro compila el sitio a archivos estáticos dentro de dist, listos para publicarse en Cloudflare Pages u otro hosting estático.

Modelo conceptual

Markdown / MDX
      |
      v
Astro Content Collections
      |
      v
Starlight
      |
      v
Build estático
      |
      v
Cloudflare Pages / Hosting estático

Componentes

Componente	Responsabilidad	Archivo / carpeta
Astro	Motor de build y servidor local.	package.json, astro.config.mjs
Starlight	Tema/documentation framework.	@astrojs/starlight
Content collections	Carga y validación de documentos.	src/content.config.ts
Documentación	Contenido técnico y operativo.	src/content/docs/
Assets	Logo e imágenes estáticas.	src/assets/ y assets por documento
Estilos	Identidad visual Interzone.	src/styles/custom.css
Build estático	Salida publicable.	dist/

Estructura documental

src/content/docs/
├── estandares/
├── proyectos/
├── clientes/
├── guias/
├── inventario/
└── ideas/

La navegación principal se configura en astro.config.mjs y usa autogenerate por directorio. Esto permite que nuevos documentos aparezcan automáticamente dentro de su sección si se ubican en la carpeta correcta.

Flujo de publicación

Editar Markdown
      |
      v
npm run build
      |
      v
Generar dist/
      |
      v
Subir a Cloudflare Pages
      |
      v
Validar sitio publicado

Decisiones arquitectónicas

Decisión	Criterio
Sitio estático	Reduce complejidad operativa y no requiere backend propio.
Markdown/MDX	Facilita edición, versionado y revisión documental.
Starlight	Provee navegación, búsqueda, sidebar, TOC y layout de documentación.
Sidebar autogenerado	Evita editar navegación manualmente por cada archivo nuevo.
Plantillas por tipo de activo	Mantiene documentación homogénea entre proyectos y clientes.
CSS personalizado	Aplica identidad Interzone sin reemplazar el layout base.

Límites de la arquitectura

Tema	Estado
Backend propio	No aplica.
Base de datos	No aplica.
Autenticación interna	No implementada en la aplicación; depende del hosting si se requiere privacidad.
Edición web colaborativa	No implementada. La edición se realiza sobre archivos del proyecto.
Workflow editorial	Pendiente de formalizar.