Architecture, methods
and standards.
How we design, build and run software at AULAS LATAM: recorded decisions, security by design and components built to be reused across the ecosystem.
Six rules
we don’t negotiate.
API first
We design the contract before the implementation (OpenAPI 3.1). Errors follow RFC 9457 and every version is explicit.
Security by design
Threat modeling for every epic, controls based on OWASP ASVS and least privilege across data, services and agents.
Modular and reusable
Components with clear boundaries, versioned with SemVer and documented so another team can adopt them without asking.
Observable by default
Structured logs, metrics and traces (OpenTelemetry) from the first deploy. If you can’t measure it, you can’t run it.
Docs as code
Documentation lives next to the code, is reviewed in the same pull requests and follows the Diátaxis framework.
Accessible and fast
WCAG 2.2 level AA target and performance budgets measured with Core Web Vitals on mid-range devices.
From commit to production,
with security at every step.
Checks are automated in continuous integration. What doesn’t pass doesn’t ship.
Reference snippets. Exact configuration depends on each repository.
We don’t reinvent
what is already solved.
| Area | Standard | Why |
|---|---|---|
| Code | Conventional Commits · SemVer 2.0 · EditorConfig | Readable history and predictable versions. |
| APIs | OpenAPI 3.1 · RFC 9457 (Problem Details) | Verifiable contracts and consistent errors. |
| Security | OWASP ASVS · OWASP Top 10 · OWASP Top 10 for LLM Apps | Controls for applications and AI systems. |
| Supply chain | SBOM (CycloneDX / SPDX) · SLSA | Know what each release contains and where it came from. |
| Quality | ISO/IEC 25010 | Reference model for quality attributes. |
| Accessibility | WCAG 2.2 AA | Interfaces usable by more people. |
| Documentation | Diátaxis · ADR | Tutorials, how-tos, reference and explanation kept apart. |
| Personal data | Law 1581 of 2012 (Colombia) | Data processing with purpose and consent. |
Build once,
use across the ecosystem.
Catalog under construction. Mature components move to open source.
Authentication & roles
Sign-in, MFA and role-based permissions for admin panels.
PWA shell
Installable, offline-ready base for shared hosting. This site is built on it.
Colombian validators
NIT with check digit, ID numbers and local formats.
Payments
Payment gateway integration, reconciliation and verified webhooks.
Semantic search
Indexing and meaning-based search over your own content.
Notifications
Email, WhatsApp and web push with templates and delivery logs.
Want to bring these
standards to your team?
Read the public technical documentation or join AULAS LATAM projects as an engineer.

