Documentación Arquitectónica con C4 y arc42 para Plataforma Logística
Visión general
De qué trata este proyecto.
Audita la arquitectura actual entrevistando a 5 tech leads (1 por dominio: pedidos, ruteo, almacén, facturación, integraciones). Modela los 4 niveles C4 en Structurizr DSL versionado en GitHub. Documenta con plantilla arc42: introducción y objetivos, restricciones, contexto, estrategia de solución, vista de bloques, vista de runtime, vista de despliegue, conceptos transversales (seguridad, observabilidad), decisiones arquitectónicas (10 ADRs), calidad, riesgos, glosario. Configura CI: Structurizr Lite genera diagramas en cada PR, arc42-asciidoc compila la documentación a HTML estático servido en intranet. Valida con 2 nuevas incorporaciones (cronometra orientación). Entrega: documentación completa, Structurizr DSL, CI configurado, validación de onboarding cronometrada.
El Briefing
Lo que harás y lo que demostrarás.
Producir documentación arquitectónica viva (C4 + arc42) para 45 servicios que reduzca el onboarding técnico de 4 semanas a menos de 1.
Earning criteria — what you'll demonstrate
- Aplicar el modelo C4 a una arquitectura real grande
- Estructurar documentación arquitectónica con arc42
- Configurar documentación como código que no se desactualiza
- Validar utilidad de documentación con usuarios reales (nuevos joiners)
Encaje académico
Dónde encaja esto en tus estudios.
Afina las mismas habilidades que tu titulación espera de ti.
Habilidades
Habilidades que demostrarás.
Cada una aparece en tu credencial verificada.
Carreras
Roles para los que esto te prepara.
Títulos reales. Puentes de habilidades reales. Elige el que más se acerque a tu trayectoria.
Trayectorias profesionales que esto construye
Roles canónicosArquitecto de Sistemas
Producir documentación arquitectónica viva con C4 + arc42 es el trabajo que distingue a un arquitecto que aporta valor diario de uno que solo dibuja diagramas decorativos.
Este proyecto afina
- c4-model
- arc42
- architecture-documentation