# Versiones oficiales · Roustix Documentation Suite

**Fuente única de verdad** para versiones de cada manual y de la suite.

## Versión del software

| Producto | Versión actual | Fuente canónica | Changelog | Tag Git |
|---|---:|---|---|---|
| **Aplicación Flask** | **v1.0.10** | [`app/version.py`](../app/version.py) | [`CHANGELOG.md`](../CHANGELOG.md) | `v1.0.0` *(pendiente de publicar)* |
| **Suite documental** | **v1.22.5** | Este archivo | [changelog.md](changelog.md) | `docs-vX.Y` |

La aplicación y la documentación son productos versionados de forma
independiente. Flujo de release del software: [APP_VERSIONING.md](APP_VERSIONING.md).

**Suite actual:** **v1.22.5** (Sprint 22 completo · API pública y Webhooks)
**Últimos tags:** `docs-v1.0` · `docs-foundation-1.0` (recomendado)

---

## Suite agregada

| Versión | Fecha | Tag Git | Notas |
|---------|-------|---------|-------|
| **v1.22.5** | 2026-07-22 | *(pendiente)* | **Cierre Sprint 22** · guía integradores, colección, auditoría ✅ |
| **v1.22.4** | 2026-07-22 | *(pendiente)* | **Seguridad y observabilidad** · entitlements, HMAC, stats ✅ |
| **v1.22.3** | 2026-07-22 | *(pendiente)* | **Webhooks** · outbox, HMAC, reintentos y catálogo de eventos ✅ |
| **v1.22.2** | 2026-07-22 | *(pendiente)* | **API pública Maintenance** · recursos v1, idempotencia y contrato ✅ |
| **v1.22.1** | 2026-07-22 | *(pendiente)* | **API pública** · credenciales técnicas, scopes y auditoría |
| **v1.22.0** | 2026-07-21 | *(pendiente)* | **API pública y Webhooks** · diseño y contrato Sprint 22.0 |
| **v1.21.0** | 2026-07-21 | *(pendiente)* | **Asset Health** · puntaje explicable, confianza e historial |
| **v1.20.0** | 2026-07-21 | *(pendiente)* | **Maintenance Automation** · reglas, acciones e idempotencia |
| **v1.19.5** | 2026-07-21 | *(pendiente)* | **Maintenance Execution** · medidores, lecturas y cierre Sprint 19 |
| **v1.19.4** | 2026-07-21 | *(pendiente)* | **Maintenance Execution** · bitácora contextual y adjuntos |
| **v1.19.3** | 2026-07-21 | *(pendiente)* | **Maintenance Execution** · evidencia, conformidad, firma y revisión |
| **v1.19.2** | 2026-07-21 | *(pendiente)* | **Maintenance Execution** · Sprint 19.2 checklist de OT |
| **v1.19.1** | 2026-07-21 | *(pendiente)* | **Maintenance Execution** · Sprint 19.1 catálogo versionado |
| **v1.19.0** | 2026-07-21 | *(pendiente)* | **Maintenance Execution** · Sprint 19.0 diseño y contratos |
| **v1.18.0** | 2026-07-14 | *(pendiente)* | **Security & Identity** · Sprint 18 cerrado |
| **v1.17.0** | 2026-07-11 | *(pendiente)* | **Purchasing** · Sprint 16.0–16.5 completo |
| **v1.16.0** | 2026-07-11 | *(pendiente)* | **Purchasing** · Sprint 16.0 diseño, contratos y migración |
| **v1.15.0** | 2026-07-10 | *(pendiente)* | **MRL v1.1.0** · Sprint 15.0 MRL Foundation (docs) |
| **v1.14.0** | 2026-07-10 | *(pendiente)* | **MDO v1.0.0** · Sprint 13 finalizado |
| **v1.13.0** | 2026-07-10 | *(pendiente)* | MDO v0.7.0 · Sprint 13 en curso |
| **v1.12.0** | 2026-07-10 | *(pendiente)* | MKT v1.0.0 · Sprint 12 finalizado |
| **v1.11.0** | 2026-07-10 | *(pendiente)* | MKT v0.9.0 · Sprint 12 en curso |
| **v1.10.0** | 2026-07-10 | *(pendiente)* | **MCM v1.0.0** · Sprint 11 finalizado |
| **v1.9.0** | 2026-07-10 | *(pendiente)* | MCM v1.1 · Sprint 11 en curso |
| **v1.8.0** | 2026-07-10 | *(pendiente)* | MRG v1.0 · Sprint 10 completo |
| **v1.7.0** | 2026-07-10 | *(pendiente)* | MRG v0.1 · Sprint 10 iniciado |
| **v1.6.0** | 2026-07-10 | *(pendiente)* | MSD v1.0 · Sprint 9 completo |
| **v1.5.1** | 2026-07-10 | *(pendiente)* | MSD v0.2 · Developer Portal |
| **v1.5** | 2026-07-10 | *(pendiente)* | MSD v0.1 · Sprint 9 iniciado |
| **v1.4.1** | 2026-07-10 | *(pendiente)* | MAG v1.0.12 · Sprint 8 completo |
| **v1.4** | 2026-07-10 | *(pendiente)* | MAG v1.0 · Sprint 8 |
| **v1.3.1** | 2026-07-10 | *(pendiente)* | MRL v1.0.1 · complementos 11–13 |
| **v1.3** | 2026-07-10 | *(pendiente)* | MRL v1.0 · Sprint 7 |
| **v1.2** | 2026-07-10 | — | Docs como producto |
| **v1.1** | 2026-07-10 | — | MPA · suite 01–10 |
| **v1.0** | 2026-07-10 | `docs-v1.0` | MBB · MDL · MUX · MCM |
| **Fundación 1.0** | 2026-07-10 | `docs-foundation-1.0` | + MPA v1.0 congelado |

Changelog: [changelog.md](changelog.md)

---

## Manuales · Registro oficial

| # | Código | Manual | Versión | Estado | Changelog | URL |
|---|--------|--------|---------|--------|-----------|-----|
| 01 | MBB | Brand Book | **v2.0** | ✔ Congelado | [brandbook/changelog.md](brandbook/changelog.md) | [/brandbook/](http://127.0.0.1:5000/brandbook/) |
| 02 | MDL | Design Language | **v1.0** | ✔ Congelado | [mdl/changelog.md](mdl/changelog.md) | [/mdl/](http://127.0.0.1:5000/mdl/) |
| 03 | MUX | User Experience | **v1.2** | ✔ Congelado | [mux/changelog.md](mux/changelog.md) | [/mux/](http://127.0.0.1:5000/mux/) |
| 04 | MCM | Commercial Manual | **v1.0.0** | ✅ Sprint 11 | [mcm/changelog.md](mcm/changelog.md) | [/mcm/](http://127.0.0.1:5000/mcm/) |
| 12 | MKT | Sales Enablement & Marketing | **v1.0.0** | ✅ Sprint 12 | [mkt/changelog.md](mkt/changelog.md) | [/mkt/](http://127.0.0.1:5000/mkt/) |
| 13 | MDO | Documentation Operations | **v1.0.0** | ✅ Sprint 13 | [mdo/changelog.md](mdo/changelog.md) | [/mdo/](http://127.0.0.1:5000/mdo/) |
| 05 | MPA | Platform Architecture | **v1.0** | ✔ Congelado | [mpa/changelog.md](mpa/changelog.md) | [/mpa/](http://127.0.0.1:5000/mpa/) |
| 06 | MRL | Report Language | **v1.1.0** | 🚧 Sprint 15.0 | [mrl/changelog.md](mrl/changelog.md) | [/mrl/](http://127.0.0.1:5000/mrl/) |
| 07 | MAG | API Guide | **v1.0.12** | ✅ MAG v1.0 | [mag/changelog.md](mag/changelog.md) | [/mag/](http://127.0.0.1:5000/mag/) |
| 08 | SDK | SDK & Developer Portal (MSD) | **v1.0.0** | ✅ Sprint 9 | [msd/changelog.md](msd/changelog.md) | [/msd/](http://127.0.0.1:5000/msd/) |
| 11 | MRG | Roustix Reference Guide | **v1.0.0** | ✅ Sprint 10 | [mrg/changelog.md](mrg/changelog.md) | [/mrg/](http://127.0.0.1:5000/mrg/) |
| 09 | — | Developer Docs | — | 🟡 En curso | — | [developer/README.md](developer/README.md) |
| 10 | — | Release Notes | — | Activo | [release-notes/](release-notes/) | [release-notes/README.md](release-notes/README.md) |

**Leyenda:** ✔ Congelado · 🟡 En desarrollo · 📋 Planificado

---

## Semver por manual

| Bump | Cuándo | Ejemplo |
|------|--------|---------|
| **MAJOR** `v2.0` | Reestructura, cambio de posicionamiento | MBB v2.0 (separación MDL) |
| **MINOR** `v1.1` | Capítulo nuevo, sección amplia | MPA v1.0 → v1.1 (nuevo capítulo) |
| **PATCH** `v1.0.1` | Typo, enlace, aclaración menor | MPA v1.0.1 (refino MPA-01) |

---

## Semver de la suite

| Bump | Cuándo | Ejemplo |
|------|--------|---------|
| **Suite v1.0** | Primera edición oficial congelada | `docs-v1.0` |
| **Suite v1.1** | Nuevo manual mayor (MPA) o reorg estructural | Sprint 6 |
| **Suite v2.0** | Cambio de arquitectura documental completa | Futuro |

---

## Al actualizar una versión

1. Editar **este archivo** (`VERSIONS.md`)
2. Entrada en `{manual}/changelog.md`
3. Si afecta la suite → [changelog.md](changelog.md)
4. Bump en README del manual + catálogo HTML si existe
5. Release interno → tag `docs-vX.Y`

→ Política completa: [VERSIONING.md](VERSIONING.md)