## Summary - disable the `admin/brencher` remote for the main `brencher` profile - document backend/API use cases in `docs/USE_CASES_BACKEND.md` - document UI/state use cases in `docs/USE_CASES_UI.md` - preserve the application goal section in both documents - document the actual boundary: REST is read-only (`/state`, `/branches`); mutations are currently sent through `/ws` ## Verification - `git diff --check` - `python3 -m compileall -q backend` - backend scenarios: `B-01..B-19` - UI scenarios: `U-01..U-21` - main profile no longer contains `admin/brencher`; `brencher2` remains unchanged ## Notes The PR head is `hermes/docs/exhaustive-use-cases` and the target is `admin/main`. --------- Co-authored-by: brencher_bot <rudolfss13@gmail.com> Reviewed-on: #80 Co-authored-by: hermes <rudolfss13+hermes@gmail.com>
Technical description
Use language python.
Locally run in venv create with uv tool. Use venv with uv for Python environment management and dependency installation. Keep requirements.txt updated.
Backend server flask.
UI - use plain javascript
App should be delivered as docker image.
Generate docker compose file to deploy to docker swarm.
Local start
python ./backend/app.py brencher_local1:docker_swarm_check_by_version noweb
Prod recovery
uv venv --python 3.12.3 .venv
uv pip install -r requirements.txt
python ./backend/app.py brencher:docker_swarm_check_by_version noweb
Update docker secret
docker service scale brencher_brencher-backend=0 brencher2_brencher-backend=0 docker service update --secret-rm brencher-secrets brencher_brencher-backend docker service update --secret-rm brencher-secrets brencher2_brencher-backend docker secret rm brencher-secrets
printf "GIT_USERNAME=git\nGIT_PASSWORD=TODO\nGITEA_TOKEN=TODO\n" |
docker secret create brencher-secrets -
docker service update --secret-add brencher-secrets brencher_brencher-backend docker service update --secret-add brencher-secrets brencher2_brencher-backend docker service scale brencher_brencher-backend=1 brencher2_brencher-backend=1