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

3.0 KiB

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

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:

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

.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