Make "one active round" a DB invariant and record why a tx failed
Two schema changes the fixes in the following commits build on (BUGS.md B-09, B-04): ix_rounds_single_active is a unique index over the constant expression (1), restricted to the active statuses, so the table holds any number of closed rounds and only ever one live one. Rounds never overlapping was previously enforced only by a read-then-insert in open_new_round_if_needed, which two concurrent callers can both pass — and a second stuck "open" row blocks every future round forever, since get_active_round matches on status. The migration doesn't create that index blind: an instance that already has two active rounds (the very bug) would fail mid-migration with an opaque IntegrityError, so it first closes the stale duplicates and keeps the newest — which is what get_active_round was already doing silently. Verified against a DB seeded with an 'open' plus a 'closing' round. pending_transactions.failure_reason is for the reconciler added next: when it gives up on a transaction, an operator needs to see whether it was dropped or rejected. The PendingTransaction docstring now also documents the full status lifecycle (building -> pending -> confirmed | failed), since "building" is new and load-bearing. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
9b6a4a240c
commit
cc88763a9d
2 files changed
+94
-2
No files matched your search
@@ -0,0 +1,57 @@
|
||||
"""Add pending tx failure_reason and the single-active-round index
|
||||
|
||||
Supports two fixes from BUGS.md:
|
||||
|
||||
* B-04 — the reconciler (app/tx/reconcile.py) records *why* it abandoned a
|
||||
transaction, so an operator can tell a dropped tx from a rejected one.
|
||||
* B-09 — "at most one active round" becomes a database guarantee instead of a
|
||||
read-then-insert that two concurrent callers could both pass. A unique index
|
||||
over the constant expression (1), restricted to the active statuses: any number
|
||||
of closed rounds, only ever one live one.
|
||||
|
||||
The index creation is not blind: if an instance already has more than one active
|
||||
round (the very bug this prevents), creating it would fail with an opaque
|
||||
IntegrityError mid-migration. It closes the stale duplicates first, keeping the
|
||||
newest — which is exactly what get_active_round was already doing silently.
|
||||
|
||||
Revision ID: 8a1c4e7b2d90
|
||||
Revises: 6cb50b29f64c
|
||||
Create Date: 2026-07-26
|
||||
|
||||
"""
|
||||
from typing import Sequence, Union
|
||||
|
||||
import sqlalchemy as sa
|
||||
from alembic import op
|
||||
|
||||
revision: str = "8a1c4e7b2d90"
|
||||
down_revision: Union[str, Sequence[str], None] = "6cb50b29f64c"
|
||||
branch_labels: Union[str, Sequence[str], None] = None
|
||||
depends_on: Union[str, Sequence[str], None] = None
|
||||
|
||||
_ACTIVE = "'open', 'closing', 'drawing', 'paying_out'"
|
||||
|
||||
|
||||
def upgrade() -> None:
|
||||
op.add_column(
|
||||
"pending_transactions", sa.Column("failure_reason", sa.String(length=128), nullable=True)
|
||||
)
|
||||
|
||||
connection = op.get_bind()
|
||||
active_ids = [
|
||||
row[0]
|
||||
for row in connection.execute(
|
||||
sa.text(f"SELECT id FROM rounds WHERE status IN ({_ACTIVE}) ORDER BY id DESC")
|
||||
)
|
||||
]
|
||||
for stale_id in active_ids[1:]:
|
||||
connection.execute(
|
||||
sa.text("UPDATE rounds SET status = 'closed' WHERE id = :id"), {"id": stale_id}
|
||||
)
|
||||
|
||||
op.execute(f"CREATE UNIQUE INDEX ix_rounds_single_active ON rounds ((1)) WHERE status IN ({_ACTIVE})")
|
||||
|
||||
|
||||
def downgrade() -> None:
|
||||
op.execute("DROP INDEX IF EXISTS ix_rounds_single_active")
|
||||
op.drop_column("pending_transactions", "failure_reason")
|
||||
Reference in new issue
Block a user