Eco Manager Wiki

Appearance

ADR-0002: Use Draft And Published Model Versions ​

Status ​

Accepted

Context ​

Runtime metadata controls API validation and frontend behavior. Editing live metadata directly would risk breaking production data and user workflows.

Decision ​

Model metadata will be edited in draft versions and activated through a publish workflow.

Runtime CRUD uses only the currently published model.

Published versions are immutable.

Consequences ​

Positive:

  • Safer model editing.
  • Validation before activation.
  • Audit-friendly history.
  • Rollback by re-publishing a previous compatible model.

Trade-offs:

  • More tables and service logic.
  • Publishing requires transaction and cache invalidation logic.