Skip to content

B3 — first-run onboarding wizard - #205

Merged
tomqwu merged 1 commit into
mainfrom
overnight-B3-onboarding-wizard
May 19, 2026
Merged

tomqwu merged 1 commit into
mainfrom
overnight-B3-onboarding-wizard

Conversation

@tomqwu

@tomqwu tomqwu commented May 19, 2026

Copy link
Copy Markdown
Owner

Summary

  • New /a/onboarding guided first-run checklist: invite a teammate → create an event → generate a schedule → publish it. Each step's done-state is derived from real org data (people/invitations, events, solutions, published solutions) and the count is persisted to the existing onboarding_progress table.
  • POST /a/onboarding/skip records onboarding_skipped; the admin dashboard shows a progress nudge banner while incomplete and not skipped.
  • OnboardingProgress reads are org-scoped so the strict tenancy guard passes (learned pattern).

Test plan

  • tests/web/test_onboarding_wizard.py — 5 tests (auth gate, fresh 0/4, partial + dashboard banner, full 4/4 complete, skip persists & hides banner)
  • Committed e2e tests/e2e/test_onboarding_wizard.py — fresh admin completes the wizard end to end (0/4 → invite → event → solve → publish → complete)
  • Local: full tests/e2e/ green (3 passed); tests/web tests/contract tests/unit/test_openapi_schema.py 206 passed; black --check api tests + ruff check api tests clean
  • CI: Lint/type/test + blocking e2e lane green

Closes #204 · part of #196 (Phase B).

🤖 Generated with Claude Code

A guided 4-step first-run checklist for fresh admins (invite → create
event → generate schedule → publish), with progress derived from real
org data and persisted to onboarding_progress, a skip action, and a
dashboard nudge while incomplete. OnboardingProgress queries are
org-scoped to satisfy the strict tenancy guard.

Tests: tests/web/test_onboarding_wizard.py (5) and committed e2e
tests/e2e/test_onboarding_wizard.py (fresh admin completes the wizard
end to end).

Closes #204

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@tomqwu tomqwu added this to the Overnight — e2e workflows milestone May 19, 2026
@tomqwu
tomqwu merged commit 682faf5 into main May 19, 2026
5 checks passed
@tomqwu
tomqwu deleted the overnight-B3-onboarding-wizard branch May 19, 2026 16:35
@tomqwu tomqwu mentioned this pull request May 19, 2026
16 tasks done
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

B3 — first-run onboarding wizard (/a/onboarding)

1 participant