Skip to content

Correct and verify database setup instructions - #84

Merged
DavidMoritz merged 2 commits into
masterfrom
codex/document-management-token-migration
Sep 6, 2026
Merged

Correct and verify database setup instructions#84
DavidMoritz merged 2 commits into
masterfrom
codex/document-management-token-migration

Conversation

@ejones23

@ejones23 ejones23 commented Sep 6, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • add a production-safe rollout checklist for the ballot management-token migration
  • document backup, conflict preflight, schema verification, deployment ordering, canary checks, monitoring, and conservative rollback
  • add ballot_management_tokens to the expected fresh-install table list and schema reference
  • replace the nonexistent Schema.sql and Docker Compose references with the maintained production schema and ordered migrations
  • correct the preview command and Vite port in developer/startup guidance

Verification

  • reapplied the migration to local MySQL to verify idempotence
  • confirmed InnoDB, the six expected columns, primary/unique/ballot indexes, and zero rows
  • focused V2BallotTest: 6 tests / 48 assertions
  • full suite: 191 Vitest tests; 231 PHPUnit tests / 587 assertions
  • bash syntax check for start-local.sh
  • stale setup-reference scan and git diff --check

Context

Follow-up to merged PR #81. The full fresh-install schema already contained the table and the existing-database section already named the migration; this closes the missing verification and rollback guidance and removes stale alternate setup paths.

@ejones23 ejones23 changed the title Document safe management-token migration rollout Correct and verify database setup instructions Sep 6, 2026

@DavidMoritz DavidMoritz left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great housekeeping! Fixing the stale port numbers, npm command syntax, and nonexistent file references in AGENTS.md is really valuable — accurate docs save everyone time. The rollout checklist for the management-token migration is thorough and operationally useful, covering backup, conflict detection, deploy ordering, and verification. Thanks for catching all of these, Emmanuel!

@DavidMoritz
DavidMoritz merged commit e3ac277 into master Sep 6, 2026
4 checks passed
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.

2 participants