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.
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.
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.
Fragmentos de referencia. La configuración exacta depende de cada repositorio.
No inventamos lo que
ya está bien resuelto.
| Área | Estándar | Para qué |
|---|---|---|
| Código | Conventional Commits · SemVer 2.0 · EditorConfig | Historial legible y versiones predecibles. |
| APIs | OpenAPI 3.1 · RFC 9457 (Problem Details) | Contratos verificables y errores consistentes. |
| Seguridad | OWASP ASVS · OWASP Top 10 · OWASP Top 10 for LLM Apps | Controles de aplicación y de sistemas con IA. |
| Cadena de suministro | SBOM (CycloneDX / SPDX) · SLSA | Saber qué contiene cada entrega y de dónde viene. |
| Calidad | ISO/IEC 25010 | Modelo de referencia para atributos de calidad. |
| Accesibilidad | WCAG 2.2 AA | Interfaces usables por más personas. |
| Documentación | Diátaxis · ADR | Tutoriales, guías, referencia y explicación separados. |
| Datos personales | Ley 1581 de 2012 (Colombia) | Tratamiento de datos con finalidad y autorización. |
Construir una vez,
usar en todo el ecosistema.
Catálogo en construcción. Los componentes maduros pasan a código abierto.
Autenticación y roles
Inicio de sesión, MFA y permisos por rol para paneles administrativos.
Shell PWA
Base instalable y offline para hosting compartido. Este sitio está construido sobre ella.
Validadores colombianos
NIT con dígito de verificación, cédula y formatos locales.
Pagos
Integración con pasarela de pagos, conciliación y webhooks verificados.
Búsqueda semántica
Indexación y búsqueda por significado sobre contenido propio.
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.

