- app_state gains configured + setup_token_hash (migration 0025); existing installs (any users) are marked configured so they never see the wizard, a fresh DB starts in setup mode. - On first boot the app mints a one-time setup token and logs the wizard URL (only the hash is stored); the token gates the setup steps (added in 6c). - A middleware locks all /api + /auth routes (except /api/setup, /api/version, /healthz, static) to 503 until configured, with a DB-free cached fast-path once setup completes. - GET /api/setup/status tells the SPA whether to show the wizard.
39 lines
1.5 KiB
Python
39 lines
1.5 KiB
Python
"""first-run install wizard state
|
|
|
|
Revision ID: 0025_install_wizard
|
|
Revises: 0024_google_email_verified
|
|
Create Date: 2026-06-19
|
|
|
|
Adds app_state.configured + setup_token_hash for the first-run install wizard. Existing installs
|
|
(any users present) are marked configured so they never see the wizard; a genuinely fresh DB (no
|
|
users) starts unconfigured and boots into setup mode.
|
|
"""
|
|
from typing import Sequence, Union
|
|
|
|
import sqlalchemy as sa
|
|
from alembic import op
|
|
|
|
revision: str = "0025_install_wizard"
|
|
down_revision: Union[str, None] = "0024_google_email_verified"
|
|
branch_labels: Union[str, Sequence[str], None] = None
|
|
depends_on: Union[str, Sequence[str], None] = None
|
|
|
|
|
|
def upgrade() -> None:
|
|
op.add_column(
|
|
"app_state",
|
|
sa.Column("configured", sa.Boolean(), nullable=False, server_default="false"),
|
|
)
|
|
op.add_column("app_state", sa.Column("setup_token_hash", sa.String(length=64), nullable=True))
|
|
# Ensure the singleton row exists and mark it configured, then revert to unconfigured only if
|
|
# this is a genuinely fresh DB (no users yet). Net: configured = (the instance already has users).
|
|
op.execute(
|
|
"INSERT INTO app_state (id, sync_paused, configured) VALUES (1, false, true) "
|
|
"ON CONFLICT (id) DO UPDATE SET configured = true"
|
|
)
|
|
op.execute("UPDATE app_state SET configured = false WHERE NOT EXISTS (SELECT 1 FROM users)")
|
|
|
|
|
|
def downgrade() -> None:
|
|
op.drop_column("app_state", "setup_token_hash")
|
|
op.drop_column("app_state", "configured")
|