31 lines
1.8 KiB
Markdown
31 lines
1.8 KiB
Markdown
# Maintenance tools
|
|
|
|
Run these commands from the application root. This directory contains only active startup,
|
|
registry, and verification tools.
|
|
|
|
## Normal maintenance
|
|
|
|
- `powershell -ExecutionPolicy Bypass -File tools/start_local.ps1 [-Port 8797]`: start the
|
|
local application in a hidden process and keep logs, the PID, and Python cache under
|
|
`runtime/` instead of the source root.
|
|
- `python tools/verify_baseline.py`: all unit tests, registry checks, every frontend
|
|
JavaScript syntax check, Git whitespace check, and read-only SQLite integrity check.
|
|
- `python tools/verify_baseline.py --e2e`: the same checks plus Playwright. The verifier owns
|
|
the local static-server lifecycle so the command exits cleanly on Windows.
|
|
- `python tools/build_api_registry.py [--check]`: generate or verify
|
|
`config/api.config.json` from `backend/http/dispatch.py` and the registered
|
|
`backend/features/*/routes.py` owners.
|
|
- `python tools/build_architecture_inventory.py [--check]`: generate or verify
|
|
`config/architecture-inventory.json` from the current source tree.
|
|
- `bash tools/build_image.sh <commit> <tag>`: the only sanctioned way to build the
|
|
production Docker image. Streams `git archive <commit>` to the deploy host over SSH
|
|
(default `moxiaobai@192.168.200.11`), refuses tags that do not end with the commit
|
|
short SHA, verifies the revision label after the build, and appends a record to
|
|
`~/xiaobai-build/BUILD_LOG.tsv` on the host. Building from any server-side working
|
|
tree is forbidden; see `DOCKER_DEPLOY.md`.
|
|
|
|
`verify_baseline.py` does not inspect a parent checkout or skip tests according to files outside
|
|
this application. Historical comparison scripts were retired after final standalone acceptance;
|
|
their results remain under `docs/migration/evidence/` and their source remains recoverable from
|
|
Git history.
|