feat(req-002): implement portfolio tagging and tag filters

migrations/versions/20260414_0012_portfolio_tags.py

@@ -0,0 +1,79 @@
+"""add portfolio tags table
+
+Revision ID: 20260414_0012
+Revises: 20260414_0011
+Create Date: 2026-04-14 16:10:00
+"""
+
+from __future__ import annotations
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy import inspect
+
+
+revision = "20260414_0012"
+down_revision = "20260414_0011"
+branch_labels = None
+depends_on = None
+
+
+def _table_exists(inspector, table_name: str) -> bool:
+    return table_name in inspector.get_table_names()
+
+
+def _index_exists(inspector, table_name: str, index_name: str) -> bool:
+    return any(index["name"] == index_name for index in inspector.get_indexes(table_name))
+
+
+def _fk_exists(inspector, table_name: str, fk_name: str) -> bool:
+    return any(fk.get("name") == fk_name for fk in inspector.get_foreign_keys(table_name))
+
+
+def upgrade() -> None:
+    bind = op.get_bind()
+    inspector = inspect(bind)
+
+    if not _table_exists(inspector, "portfolio_tags"):
+        op.create_table(
+            "portfolio_tags",
+            sa.Column("portfolio_id", sa.Text(), nullable=False),
+            sa.Column("tag_value", sa.Text(), nullable=False),
+            sa.Column("created_at", sa.TIMESTAMP(timezone=True), nullable=False, server_default=sa.text("NOW()")),
+            sa.PrimaryKeyConstraint("portfolio_id", "tag_value", name="pk_portfolio_tags"),
+        )
+
+    inspector = inspect(bind)
+    if not _fk_exists(inspector, "portfolio_tags", "fk_portfolio_tags_portfolio"):
+        op.create_foreign_key(
+            "fk_portfolio_tags_portfolio",
+            "portfolio_tags",
+            "portfolios",
+            ["portfolio_id"],
+            ["portfolio_id"],
+            ondelete="CASCADE",
+        )
+
+    inspector = inspect(bind)
+    if not _index_exists(inspector, "portfolio_tags", "idx_portfolio_tags_tag_portfolio"):
+        op.create_index(
+            "idx_portfolio_tags_tag_portfolio",
+            "portfolio_tags",
+            ["tag_value", "portfolio_id"],
+            unique=False,
+        )
+
+
+def downgrade() -> None:
+    bind = op.get_bind()
+    inspector = inspect(bind)
+
+    if _table_exists(inspector, "portfolio_tags"):
+        if _fk_exists(inspector, "portfolio_tags", "fk_portfolio_tags_portfolio"):
+            op.drop_constraint("fk_portfolio_tags_portfolio", "portfolio_tags", type_="foreignkey")
+
+        inspector = inspect(bind)
+        if _index_exists(inspector, "portfolio_tags", "idx_portfolio_tags_tag_portfolio"):
+            op.drop_index("idx_portfolio_tags_tag_portfolio", table_name="portfolio_tags")
+
+        op.drop_table("portfolio_tags")