home-automation/alembic_app/versions/20260822_15_meter_sources.py

"""add protocol-agnostic meter source, channel, and binding tables

Revision ID: 20260822_15_meter_sources
Revises: 20260625_14_meter_uuid
Create Date: 2026-08-22 00:00:00.000000

This revision is additive on upgrade.  It deliberately does not backfill
existing DSMR data; that adoption is a later, separately audited migration.
"""

from typing import Sequence, Union

import sqlalchemy as sa
from alembic import op


revision: str = "20260822_15_meter_sources"
down_revision: Union[str, None] = "20260625_14_meter_uuid"
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None


def upgrade() -> None:
    op.create_table(
        "meter_source",
        sa.Column("id", sa.Integer(), autoincrement=True, nullable=False),
        sa.Column("uuid", sa.String(length=36), nullable=False),
        sa.Column("name", sa.String(length=255), nullable=False),
        sa.Column("kind", sa.String(length=64), nullable=False),
        sa.Column("enabled", sa.Boolean(), nullable=False),
        sa.Column("config", sa.JSON(), nullable=False),
        sa.Column("status", sa.String(length=32), nullable=False),
        sa.Column("last_seen_at", sa.DateTime(timezone=True), nullable=True),
        sa.Column("last_error", sa.String(length=1024), nullable=True),
        sa.Column("created_at", sa.DateTime(timezone=True), nullable=False),
        sa.Column("updated_at", sa.DateTime(timezone=True), nullable=False),
        sa.PrimaryKeyConstraint("id"),
        sa.UniqueConstraint("uuid", name="uq_meter_source_uuid"),
    )
    op.create_index("ix_meter_source_kind_enabled", "meter_source", ["kind", "enabled"])

    op.create_table(
        "meter_source_channel",
        sa.Column("id", sa.Integer(), autoincrement=True, nullable=False),
        sa.Column("uuid", sa.String(length=36), nullable=False),
        sa.Column("source_id", sa.Integer(), nullable=False),
        sa.Column("channel_key", sa.String(length=128), nullable=False),
        sa.Column("label", sa.String(length=255), nullable=False),
        sa.Column("suggested_commodity", sa.String(length=32), nullable=True),
        sa.Column("unit", sa.String(length=32), nullable=False),
        sa.Column("device_type", sa.String(length=64), nullable=True),
        sa.Column("fingerprint", sa.String(length=64), nullable=True),
        sa.Column("latest_value", sa.Numeric(precision=20, scale=6), nullable=True),
        sa.Column("latest_at", sa.DateTime(timezone=True), nullable=True),
        sa.Column("latest_quality", sa.String(length=32), nullable=True),
        sa.Column("created_at", sa.DateTime(timezone=True), nullable=False),
        sa.Column("updated_at", sa.DateTime(timezone=True), nullable=False),
        sa.ForeignKeyConstraint(["source_id"], ["meter_source.id"], ondelete="RESTRICT"),
        sa.PrimaryKeyConstraint("id"),
        sa.UniqueConstraint("uuid", name="uq_meter_source_channel_uuid"),
        sa.UniqueConstraint("source_id", "channel_key", name="uq_meter_source_channel_source_key"),
    )
    op.create_index("ix_meter_source_channel_source_id", "meter_source_channel", ["source_id"])

    op.create_table(
        "meter_source_binding",
        sa.Column("id", sa.Integer(), autoincrement=True, nullable=False),
        sa.Column("uuid", sa.String(length=36), nullable=False),
        sa.Column("meter_id", sa.Integer(), nullable=False),
        sa.Column("channel_id", sa.Integer(), nullable=False),
        sa.Column("started_at", sa.DateTime(timezone=True), nullable=False),
        sa.Column("ended_at", sa.DateTime(timezone=True), nullable=True),
        sa.Column("created_at", sa.DateTime(timezone=True), nullable=False),
        sa.Column("updated_at", sa.DateTime(timezone=True), nullable=False),
        sa.ForeignKeyConstraint(["meter_id"], ["meter.id"], ondelete="RESTRICT"),
        sa.ForeignKeyConstraint(
            ["channel_id"], ["meter_source_channel.id"], ondelete="RESTRICT"
        ),
        sa.PrimaryKeyConstraint("id"),
        sa.UniqueConstraint("uuid", name="uq_meter_source_binding_uuid"),
    )
    op.create_index("ix_meter_source_binding_meter_id", "meter_source_binding", ["meter_id"])
    op.create_index("ix_meter_source_binding_channel_id", "meter_source_binding", ["channel_id"])

    with op.batch_alter_table("energy_cost_period", schema=None) as batch_op:
        batch_op.add_column(sa.Column("source_binding_id", sa.Integer(), nullable=True))
        batch_op.create_foreign_key(
            "fk_energy_cost_period_source_binding_id",
            "meter_source_binding",
            ["source_binding_id"],
            ["id"],
            ondelete="RESTRICT",
        )


def downgrade() -> None:
    with op.batch_alter_table("energy_cost_period", schema=None) as batch_op:
        batch_op.drop_constraint("fk_energy_cost_period_source_binding_id", type_="foreignkey")
        batch_op.drop_column("source_binding_id")

    op.drop_index("ix_meter_source_binding_channel_id", table_name="meter_source_binding")
    op.drop_index("ix_meter_source_binding_meter_id", table_name="meter_source_binding")
    op.drop_table("meter_source_binding")
    op.drop_index("ix_meter_source_channel_source_id", table_name="meter_source_channel")
    op.drop_table("meter_source_channel")
    op.drop_index("ix_meter_source_kind_enabled", table_name="meter_source")
    op.drop_table("meter_source")