Files
2026-10-04 17:09:22 +02:00

46 lines
3.0 KiB
Markdown

# BoomCast
Fresh Django rebuild with separate `core`, `events`, `analysis`, `devices`, and `notifications` apps. The old project is a read-only reference at `/home/jorenmartijn/python/django` and its database and media were not copied.
## Local setup
```sh
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
PATH=/home/jorenmartijn/.nvm/versions/node/v22.23.2/bin:$PATH npm ci
.venv/bin/python manage.py migrate
PATH=/home/jorenmartijn/.nvm/versions/node/v22.23.2/bin:$PATH npm run dev
```
Node 22 is installed under the shown path on this machine. Django loads `.env` from this project directory automatically; existing process environment variables take priority. Start from `.env.example`, generate a fresh `DJANGO_SECRET_KEY`, and keep `.env` out of version control. The included domain defaults allow `django.jorendegraaf.eu` behind an HTTPS-terminating Caddy reverse proxy. Set `CLASSIFIER_URL` to the external classifier endpoint for server audio analysis. `npm run dev` deliberately enables Django debug and Vite HMR for local development; use the deployment process rather than that command for the public site.
For production assets:
```sh
PATH=/home/jorenmartijn/.nvm/versions/node/v22.23.2/bin:$PATH npm run build
.venv/bin/python manage.py collectstatic --noinput
```
## Current implementation
- Shared navigation and responsive shell, overview, report, activity, map, analyser, settings, sensors, and login.
- Single pending/approved/rejected event model. Admin actions use the shared review service.
- Manual coordinates are converted to H3 and never stored. The public map API returns coarse cells only.
- Browser and sensor uploads use one server classifier client. Upload analysis saves media only when submitted for review.
- Sensor tokens are hashed and only revealed on creation or rotation. Archived tokens stop working.
- ntfy preferences and event notifications use transaction commit callbacks.
- Original Vite integration, ffmpeg, TensorFlow/YAMNet modules, browser audio tests, and model assets are present.
## Remaining work against the full spec
The browser audio modules are connected to the analyser and the burst listener to reporting, but the rebuilt controls have not received a complete cross-browser interaction pass. Dutch translation covers the shared navigation and introductory copy; many new form and detail strings remain English. Sensor and notification settings use targeted HTMX form updates, and Activity detail uses a desktop HTMX rail. Sensor creation and rotation still need a complete keyboard and screen-reader interaction pass. The map shows coarse H3 areas and approximate direction lines, but richer legends and filter controls remain. Add those before treating this as a polished replacement for the old application.
## Verification
```sh
.venv/bin/python manage.py test
PATH=/home/jorenmartijn/.nvm/versions/node/v22.23.2/bin:$PATH npm test
PATH=/home/jorenmartijn/.nvm/versions/node/v22.23.2/bin:$PATH npm run build
.venv/bin/python manage.py collectstatic --noinput
```