Skip to content

Versionado — Mush2 ​

Todos los componentes usan Versionado Semántico (MAJOR.MINOR.PATCH).

Reglas SemVer ​

ComponenteMAJORMINORPATCH
FirmwareCambio incompatible en protocolo o hardwareNueva funcionalidad (sensor, actuador)Bugfix, optimización
BackendBreaking change en API RESTNuevo endpoint, nuevo modelo DBBugfix, parche seguridad
FrontendRediseño completo, breaking UINueva página, nuevo componenteBugfix, ajuste CSS
ProtocolCambio incompatible en tópicos/payloadsNuevo tópico, nuevo campo opcionalCorrección de especificación

Archivos VERSION ​

Cada componente mantiene su versión en un archivo VERSION:

backend/VERSION     → 0.1.0
frontend/VERSION    → 0.1.0
firmware/VERSION    → 0.1.0
docs/protocol/VERSION → 1.0.0

Matriz de Compatibilidad ​

FirmwareBackendProtocolEstado
0.1.x0.1.x1.0.xDesarrollo
1.0.x1.0.x1.0.xProducción (futuro)

El campo protocol en cada mensaje MQTT permite al backend validar compatibilidad en tiempo real.

Changelog ​

Cada componente mantiene su propio CHANGELOG.md:

firmware/CHANGELOG.md
backend/CHANGELOG.md
frontend/CHANGELOG.md
CHANGELOG.md (raíz — cambios del proyecto completo)

Formato: Keep a Changelog v1.1.0.

Mush2 — Sistema IoT de control ambiental