"""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")