hermesandadmin f70c0a1d12
Merge main to all / rebase (push) Failing after 29s
Python package / build (3.12.3) (push) Successful in 2m28s
Python package / build (3.13) (push) Successful in 2m7s
Python package / build (3.14) (push) Successful in 2m13s
docs: document exhaustive Brencher use cases (#80)
## 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>
2026-10-05 20:48:58 +02:00
2026-03-19 17:01:23 +01:00
2026-03-19 19:34:35 +01:00
2026-05-09 17:31:50 +02:00
2026-03-19 17:01:23 +01:00
2026-01-20 22:49:40 +01:00
2026-03-19 17:01:23 +01:00
2026-03-19 17:01:23 +01:00

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

S
Description
No description provided
Readme
1.6 MiB
Languages
Python 84.3%
JavaScript 12.1%
CSS 2.1%
HTML 0.9%
Dockerfile 0.6%