Reinstall + data import runbook (1.0+)

Use this runbook when an environment was created from a legacy migration path. Arthexis 1.0+ supports fresh install + import as the upgrade path for those legacy databases.

0) Architecture freeze quick context

Latest planning baseline (from recent release prep commits):

  • 1.0 architecture freeze landed as a migration-baseline reset with no dual-track migration support.
  • Runtime legacy migration shims were removed.
  • 1.0 release prep work focused on fresh-install/import operations instead of in-place migration from old graphs.
  • Recent PRs in this sequence included #6575 (1.0 baseline decision record), #6576 (single migration baseline), and #6579 (legacy shim removal).

Before you start, confirm goals for the environment:

  1. Fresh database bootstrap succeeds.
  2. Startup checks and OCPP smoke checks pass.
  3. Data import succeeds from approved export artifacts.
  4. Operator docs match actual script behavior.

Initial validation steps completed on 2026-03-28:

  • Fresh SQLite migration run completed successfully (manage.py migrate --noinput).
  • Startup preflight completed successfully (run_runserver_preflight).
  • Core and OCPP grouped health checks passed (manage.py health --group core --group ocpp --force).
  • OCPP smoke tests passed (test_chargers_command.py, test_simulator_command.py).
Loading remaining sections…