feat: tournament onboarding, tracks, and forms edit lifecycle

.gitattributes

@@ -0,0 +1,5 @@
+# Shell scripts must keep LF endings. Git's autocrlf would otherwise check them
+# out with CRLF on Windows, and bash fails on the shebang:
+#   bad interpreter: /usr/bin/env bash^M
+*.sh text eol=lf
+.githooks/* text eol=lf

.githooks/post-checkout

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# Runs after `git worktree add` and after every branch checkout.
+#
+# $3 is 1 for a branch checkout, 0 for a file checkout (`git checkout -- path`).
+# Only the former can land us in a new worktree.
+[[ ${3:-0} == 1 ]] || exit 0
+
+root=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0
+[[ -f "$root/scripts/setup-worktree-db.sh" ]] || exit 0
+
+# Never fail a checkout over dev-environment setup.
+bash "$root/scripts/setup-worktree-db.sh" || true

.gitignore

@@ -4,8 +4,10 @@
 
 # Claude
 CLAUDE_OUTPUT_BEHAVIOR.md
+.claude/settings.local.json
 
 # Misc
 password.txt
 docs/
-CLAUDE.md
+CLAUDE.md
+TASK.md

backend/alembic/env.py

@@ -20,9 +20,12 @@
 # Alembic Config object — provides access to alembic.ini values
 config = context.config
 
-# Wire up Python logging from alembic.ini
+# Wire up Python logging from alembic.ini.
+# disable_existing_loggers must be False: init_db() runs this inside the app's
+# startup lifespan, and the default (True) would disable every logger not named
+# in alembic.ini — including uvicorn.access, silencing the request log.
 if config.config_file_name is not None:
-    fileConfig(config.config_file_name)
+    fileConfig(config.config_file_name, disable_existing_loggers=False)
 
 # Override sqlalchemy.url with value from .env
 config.set_main_option("sqlalchemy.url", settings.database_url)

backend/alembic/versions/066d0807d514_add_tournament_membership_track_statuses.py

@@ -0,0 +1,58 @@
+"""add tournament membership track statuses
+
+Revision ID: 066d0807d514
+Revises: d8c1e4c9b52d
+Create Date: 2026-08-28 14:16:15.320805
+
+Write-through target for track_status_* answers (and opted-in availability_*
+answers). One row per (membership, track).
+
+Autogenerate also picked up pre-existing drift between the models and the dev
+database — a dropped ix_forms_id index and a batch of created_at/updated_at
+nullability flips on unrelated tables. Those are not this change and were
+stripped out; they need their own revision if they're real.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+# revision identifiers, used by Alembic.
+revision: str = '066d0807d514'
+down_revision: Union[str, None] = 'd8c1e4c9b52d'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        'tournament_membership_track_statuses',
+        sa.Column('id', sa.Integer(), nullable=False),
+        sa.Column('membership_id', sa.Integer(), nullable=False),
+        sa.Column('track_id', sa.Integer(), nullable=False),
+        sa.Column('status', sa.String(length=32), nullable=False),
+        sa.Column('source_response_id', sa.String(length=12), nullable=True),
+        sa.Column('source_field_id', sa.String(length=12), nullable=True),
+        sa.Column('created_at', sa.DateTime(timezone=True), nullable=True),
+        sa.Column('updated_at', sa.DateTime(timezone=True), nullable=True),
+        sa.ForeignKeyConstraint(['membership_id'], ['tournament_memberships.id'], ondelete='CASCADE'),
+        # SET NULL, not CASCADE: invalidating the question that set a status
+        # must not delete the status. See backend/form-edit-lifecycle.md.
+        sa.ForeignKeyConstraint(['source_field_id'], ['form_fields.id'], ondelete='SET NULL'),
+        sa.ForeignKeyConstraint(['source_response_id'], ['form_responses.id'], ondelete='SET NULL'),
+        sa.ForeignKeyConstraint(['track_id'], ['tournament_tracks.id'], ondelete='CASCADE'),
+        sa.PrimaryKeyConstraint('id'),
+        sa.UniqueConstraint('membership_id', 'track_id', name='uq_membership_track_status'),
+    )
+    op.create_index(
+        op.f('ix_tournament_membership_track_statuses_id'),
+        'tournament_membership_track_statuses', ['id'], unique=False,
+    )
+
+
+def downgrade() -> None:
+    op.drop_index(
+        op.f('ix_tournament_membership_track_statuses_id'),
+        table_name='tournament_membership_track_statuses',
+    )
+    op.drop_table('tournament_membership_track_statuses')

backend/alembic/versions/8d55ec2b6640_tournament_forms_and_onboarded_at.py

@@ -0,0 +1,83 @@
+"""tournament forms, onboarding, prerequisites, and tracks
+
+Revision ID: 8d55ec2b6640
+Revises: 7db31ae17e3c
+Create Date: 2026-08-25 00:00:00.000000
+
+Adds tournament_forms — a 1:1 companion row every tournament-scoped Form
+gets (owner_type == "tournament"; chapter forms never get one). is_onboarding
++ order (order only meaningful for is_onboarding=True rows) drive the
+onboarding step sequence for a tournament. See the TournamentForm model
+docstring in app/models/models.py for the full design.
+
+form_id is the table's own primary key, not a separate surrogate id — the
+relationship is strictly 1:1, so there's no "which TournamentForm" beyond
+"which Form." Deleting a Form cascades away its TournamentForm row for free.
+
+Also adds tournament_memberships.onboarded_at, set once a member has
+answered every currently-onboarding-flagged published form, plus the
+TournamentForm.prerequisites JSON configuration used by standard form
+visibility rules and the tournament_tracks catalog used by later track fields.
+
+Backfills a tournament_forms row for every existing forms row that already
+has a tournament_id, so the 1:1 invariant holds for pre-existing data too.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+# revision identifiers, used by Alembic.
+revision: str = '8d55ec2b6640'
+down_revision: Union[str, None] = '7db31ae17e3c'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.create_table('tournament_forms',
+    sa.Column('form_id', sa.String(length=12), nullable=False),
+    sa.Column('tournament_id', sa.Integer(), nullable=False),
+    sa.Column('is_onboarding', sa.Boolean(), nullable=False),
+    sa.Column('order', sa.Integer(), nullable=True),
+    sa.Column('prerequisites', sa.JSON(), nullable=False, server_default=sa.text("'{}'::json")),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=True),
+    sa.ForeignKeyConstraint(['form_id'], ['forms.id'], ondelete='CASCADE'),
+    sa.ForeignKeyConstraint(['tournament_id'], ['tournaments.id'], ondelete='CASCADE'),
+    sa.PrimaryKeyConstraint('form_id')
+    )
+
+    op.add_column('tournament_memberships', sa.Column('onboarded_at', sa.DateTime(timezone=True), nullable=True))
+
+    op.create_table(
+        'tournament_tracks',
+        sa.Column('id', sa.Integer(), nullable=False),
+        sa.Column('tournament_id', sa.Integer(), nullable=False),
+        sa.Column('name', sa.String(length=255), nullable=False),
+        sa.Column('is_archived', sa.Boolean(), nullable=False),
+        sa.Column('created_at', sa.DateTime(timezone=True), nullable=True),
+        sa.Column('updated_at', sa.DateTime(timezone=True), nullable=True),
+        sa.ForeignKeyConstraint(['tournament_id'], ['tournaments.id'], ondelete='CASCADE'),
+        sa.PrimaryKeyConstraint('id'),
+        sa.UniqueConstraint('tournament_id', 'name', name='uq_tournament_track_name'),
+    )
+    op.create_index(op.f('ix_tournament_tracks_id'), 'tournament_tracks', ['id'], unique=False)
+
+    # Backfill: every pre-existing tournament-owned form needs its
+    # companion row too, or the 1:1 invariant is broken from day one.
+    op.execute(
+        """
+        INSERT INTO tournament_forms (form_id, tournament_id, is_onboarding, created_at)
+        SELECT id, tournament_id, false, now()
+        FROM forms
+        WHERE tournament_id IS NOT NULL
+        """
+    )
+    op.alter_column('tournament_forms', 'prerequisites', server_default=None)
+
+
+def downgrade() -> None:
+    op.drop_index(op.f('ix_tournament_tracks_id'), table_name='tournament_tracks')
+    op.drop_table('tournament_tracks')
+    op.drop_column('tournament_memberships', 'onboarded_at')
+    op.drop_table('tournament_forms')

backend/alembic/versions/8e43330211be_add_tournament_membership_event_.py

@@ -0,0 +1,50 @@
+"""add tournament membership event preferences
+
+Revision ID: 8e43330211be
+Revises: a3f81c60e274
+Create Date: 2026-08-28 00:00:00.000000
+
+Write-through target for event_preference_* answers. One row per
+(membership, key, event) — an event can only appear in one option per field
+(see validate_event_preference_options) and a ranked_choice event_preference
+field is required to have allow_duplicates=false, so rank is stored per row
+but isn't part of the uniqueness.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+# revision identifiers, used by Alembic.
+revision: str = '8e43330211be'
+down_revision: Union[str, None] = 'a3f81c60e274'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        'tournament_membership_event_preferences',
+        sa.Column('id', sa.Integer(), nullable=False),
+        sa.Column('membership_id', sa.Integer(), nullable=False),
+        sa.Column('tournament_event_id', sa.Integer(), nullable=False),
+        sa.Column('key', sa.String(length=64), nullable=False),
+        sa.Column('rank', sa.Integer(), nullable=True),
+        sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+        sa.ForeignKeyConstraint(['membership_id'], ['tournament_memberships.id'], ondelete='CASCADE'),
+        sa.ForeignKeyConstraint(['tournament_event_id'], ['tournament_events.id'], ondelete='CASCADE'),
+        sa.PrimaryKeyConstraint('id'),
+        sa.UniqueConstraint('membership_id', 'key', 'tournament_event_id', name='uq_membership_event_preference'),
+    )
+    op.create_index(
+        op.f('ix_tournament_membership_event_preferences_id'),
+        'tournament_membership_event_preferences', ['id'], unique=False,
+    )
+
+
+def downgrade() -> None:
+    op.drop_index(
+        op.f('ix_tournament_membership_event_preferences_id'),
+        table_name='tournament_membership_event_preferences',
+    )
+    op.drop_table('tournament_membership_event_preferences')

backend/alembic/versions/a3f81c60e274_drop_membership_status.py

@@ -0,0 +1,41 @@
+"""drop membership status
+
+Revision ID: a3f81c60e274
+Revises: 066d0807d514
+Create Date: 2026-08-28 15:02:00.000000
+
+TournamentMembership.status ("interested" | "confirmed") is superseded by
+per-track statuses: one tournament-wide flag can't express a member who is
+confirmed on one track and declined on another, which is what complex
+tournaments actually need. See tournament_membership_track_statuses.
+
+The column gated nothing and was effectively write-only — set at join and at
+tournament creation, then never moved (mark_confirmed, its only mutator, had
+zero callers). Nothing to migrate into the new table: an "interested" here
+never named a track, so there's no per-track fact to recover from it.
+
+Irreversible in practice — downgrade recreates the column with the old default
+rather than the values it held.
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+# revision identifiers, used by Alembic.
+revision: str = 'a3f81c60e274'
+down_revision: Union[str, None] = '066d0807d514'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.drop_column('tournament_memberships', 'status')
+
+
+def downgrade() -> None:
+    op.add_column(
+        'tournament_memberships',
+        sa.Column('status', sa.String(length=32), nullable=False, server_default='interested'),
+    )
+    op.alter_column('tournament_memberships', 'status', server_default=None)