Add Phase 12 server AI semantic accounting layer

2026-08-22 21:36:27 +05:30
parent 016299cf0c
commit ef2b0e1f83
14 changed files with 1023 additions and 5 deletions
@@ -0,0 +1,70 @@
+"""Phase 12 server AI semantic accounting layer.
+
+Revision ID: 20260822_accounting_ai_p12
+Revises: 20260822_bank_client_archive_p11b
+"""
+from alembic import op
+import sqlalchemy as sa
+
+
+revision = "20260822_accounting_ai_p12"
+down_revision = "20260822_bank_client_archive_p11b"
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.create_table(
+        "accounting_ai_semantic_decisions",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column("tenant_id", sa.Integer(), sa.ForeignKey("tenants.id", ondelete="CASCADE"), nullable=False),
+        sa.Column("client_id", sa.Integer(), sa.ForeignKey("clients.id", ondelete="CASCADE"), nullable=False),
+        sa.Column("source_type", sa.String(30), nullable=False),
+        sa.Column("source_record_id", sa.Integer(), nullable=False),
+        sa.Column("source_fingerprint", sa.String(80), nullable=False, server_default=""),
+        sa.Column("provider_name", sa.String(60), nullable=False, server_default=""),
+        sa.Column("model_name", sa.String(120), nullable=False, server_default=""),
+        sa.Column("prompt_version", sa.String(40), nullable=False, server_default="phase12-v1"),
+        sa.Column("deterministic_nature_id", sa.Integer(), sa.ForeignKey("accounting_natures.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("deterministic_confidence", sa.Integer(), nullable=False, server_default="0"),
+        sa.Column("ai_nature_id", sa.Integer(), sa.ForeignKey("accounting_natures.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("ai_nature_code", sa.String(80), nullable=False, server_default=""),
+        sa.Column("ai_confidence", sa.Integer(), nullable=False, server_default="0"),
+        sa.Column("combined_confidence", sa.Integer(), nullable=False, server_default="0"),
+        sa.Column("capital_revenue", sa.String(20), nullable=False, server_default=""),
+        sa.Column("business_personal", sa.String(20), nullable=False, server_default="business"),
+        sa.Column("concise_reason", sa.Text(), nullable=False, server_default=""),
+        sa.Column("alternatives_json", sa.Text(), nullable=True),
+        sa.Column("review_flags_json", sa.Text(), nullable=True),
+        sa.Column("context_json", sa.Text(), nullable=True),
+        sa.Column("raw_response_json", sa.Text(), nullable=True),
+        sa.Column("applied_to_source", sa.Boolean(), nullable=False, server_default=sa.false()),
+        sa.Column("skipped_reason", sa.Text(), nullable=True),
+        sa.Column("status", sa.String(30), nullable=False, server_default="completed"),
+        sa.Column("error_message", sa.Text(), nullable=True),
+        sa.Column("final_nature_id", sa.Integer(), sa.ForeignKey("accounting_natures.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("final_ledger_name", sa.String(255), nullable=False, server_default=""),
+        sa.Column("suggestion_accepted", sa.Boolean(), nullable=True),
+        sa.Column("reviewed_by_user_id", sa.Integer(), sa.ForeignKey("users.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("reviewed_at_utc", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("input_tokens", sa.Integer(), nullable=False, server_default="0"),
+        sa.Column("output_tokens", sa.Integer(), nullable=False, server_default="0"),
+        sa.Column("latency_ms", sa.Integer(), nullable=False, server_default="0"),
+        sa.Column("created_by_user_id", sa.Integer(), sa.ForeignKey("users.id", ondelete="SET NULL"), nullable=True),
+        sa.Column("created_at_utc", sa.DateTime(timezone=True), nullable=False, server_default=sa.func.now()),
+    )
+
+    for name in (
+        "tenant_id", "client_id", "source_type", "source_record_id", "source_fingerprint",
+        "deterministic_nature_id", "ai_nature_id", "applied_to_source", "status",
+        "final_nature_id", "suggestion_accepted", "created_at_utc",
+    ):
+        op.create_index(
+            f"ix_accounting_ai_semantic_decisions_{name}",
+            "accounting_ai_semantic_decisions",
+            [name],
+        )
+
+
+def downgrade():
+    op.drop_table("accounting_ai_semantic_decisions")