Engineering

Arquitectura, métodos
y estándares.

Cómo diseñamos, construimos y operamos software en AULAS LATAM: decisiones registradas, seguridad desde el diseño y componentes pensados para reutilizarse en todo el ecosistema.

6
Principios
5
Etapas DevSecOps
ADR
Decisiones registradas
Principios de arquitectura

Seis reglas que
no negociamos.

API primero

Diseñamos el contrato antes que la implementación (OpenAPI 3.1). Los errores siguen RFC 9457 y cada versión es explícita.

Seguridad desde el diseño

Modelado de amenazas en cada épica, controles basados en OWASP ASVS y mínimo privilegio en datos, servicios y agentes.

Modular y reutilizable

Componentes con límites claros, versionados con SemVer y documentados para que otro equipo pueda adoptarlos sin preguntar.

Observable por defecto

Logs estructurados, métricas y trazas (OpenTelemetry) desde el primer despliegue. Si no se puede medir, no se puede operar.

Documentación como código

La documentación vive junto al código, se revisa en los mismos pull requests y sigue el marco Diátaxis.

Accesible y rápido

Objetivo WCAG 2.2 nivel AA y presupuestos de rendimiento medidos con Core Web Vitals en dispositivos de gama media.

DevSecOps

Del commit a producción,
con seguridad en cada paso.

Las verificaciones se automatizan en integración continua. Lo que no pasa, no se despliega.

docs/adr/0007-autenticacion.md
# ADR-0007: Autenticación de la API Estado: Aceptado Contexto: API pública + panel administrativo Decisión: OAuth 2.0 + PKCE · tokens de vida corta Amenazas: STRIDE → spoofing, elevation of privilege Mitigación: MFA en roles administrativos Consecuencias: rotación automática de llaves

Fragmentos de referencia. La configuración exacta depende de cada repositorio.

Estándares de referencia

No inventamos lo que
ya está bien resuelto.

ÁreaEstándarPara qué
CódigoConventional Commits · SemVer 2.0 · EditorConfigHistorial legible y versiones predecibles.
APIsOpenAPI 3.1 · RFC 9457 (Problem Details)Contratos verificables y errores consistentes.
SeguridadOWASP ASVS · OWASP Top 10 · OWASP Top 10 for LLM AppsControles de aplicación y de sistemas con IA.
Cadena de suministroSBOM (CycloneDX / SPDX) · SLSASaber qué contiene cada entrega y de dónde viene.
CalidadISO/IEC 25010Modelo de referencia para atributos de calidad.
AccesibilidadWCAG 2.2 AAInterfaces usables por más personas.
DocumentaciónDiátaxis · ADRTutoriales, guías, referencia y explicación separados.
Datos personalesLey 1581 de 2012 (Colombia)Tratamiento de datos con finalidad y autorización.
Componentes reutilizables

Construir una vez,
usar en todo el ecosistema.

Catálogo en construcción. Los componentes maduros pasan a código abierto.

cmp/01En documentación

Autenticación y roles

Inicio de sesión, MFA y permisos por rol para paneles administrativos.

cmp/02En uso

Shell PWA

Base instalable y offline para hosting compartido. Este sitio está construido sobre ella.

cmp/03En preparación

Validadores colombianos

NIT con dígito de verificación, cédula y formatos locales.

cmp/04Interno

Pagos

Integración con pasarela de pagos, conciliación y webhooks verificados.

cmp/05Exploración

Búsqueda semántica

Indexación y búsqueda por significado sobre contenido propio.

cmp/06Interno

Notificaciones

Correo, WhatsApp y web push con plantillas y registro de envíos.

¿Quieres llevar estos
estándares a tu equipo?

Lee la documentación técnica pública o súmate como ingeniero a los proyectos de AULAS LATAM.