nilsandClaude Opus 5.5
5473ab1c2b
- k8s/grafana.yaml: Grafana 13.2.3 with a 1Gi PVC, sign-up and
anonymous access off. The InfluxDB datasource (URL and token from the
environment) and three dashboards — Live, Consumption, Charging — are
provisioned from k8s/grafana/ via kustomize-generated ConfigMaps.
- server.yaml for the Go server (port 8080, UID 65532, smaller limits),
image tag 2.0.0. The NetworkPolicy now admits Grafana to InfluxDB.
- ingress.yaml: IngressRoutes for car.stinnesbeck.com and Grafana
(placeholder host car-grafana.stinnesbeck.com) with tls: {}, using
Traefik's default certificate; the cert-manager Certificate is gone.
- secrets.example.yaml: drops the dashboard secrets, adds grafana-admin.
- AGENTS.md loses its Next.js block; SPECS.md describes the new setup.
The removal of web/ (the Next.js app) and of the stale .next/ cache
upstream had committed already landed in 51e6f6f, which was staged
together with the Go server by mistake.
Checked end to end in podman (Go server + InfluxDB 2.7.12 + Grafana
13.2.3): all 25 dashboard queries return the expected data, and the
dashboards were rendered with headless Chromium. Manifests validated
offline with kustomize and kubeconform. Nothing applied to a cluster.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLJfZQZeAKAwSqViTmLzki
99 lines
6.0 KiB
Markdown
99 lines
6.0 KiB
Markdown
# SPECS — Nils' MG4
|
|
|
|
Journal for this fork of [fatihdonmezdev/FatihsMG4](https://github.com/fatihdonmezdev/FatihsMG4):
|
|
what has been changed, and what is still to do.
|
|
|
|
- Our repository: https://git.stinnesbeck.com/nils/mg4
|
|
- Upstream: https://github.com/fatihdonmezdev/FatihsMG4 (itself a fork of malys / EVABRPUploader
|
|
and Leon Kernan / ABRP_Uploader). Credited in the app's About dialog.
|
|
|
|
## Architecture: car server at car.stinnesbeck.com
|
|
|
|
The car sends everything to our own server. The server stores it in InfluxDB 2 and forwards live
|
|
telemetry to ABRP, so the ABRP token lives only on the server, never in the APK. Grafana reads
|
|
InfluxDB directly for the dashboards.
|
|
|
|
```
|
|
car ──live telemetry───▶ car.stinnesbeck.com (Go) ──▶ ABRP api.iternio.com/1/tlm/send
|
|
──daily chunks─────▶ │
|
|
──charging sessions▶ ▼
|
|
InfluxDB 2 ◀── Grafana (car-grafana.stinnesbeck.com)
|
|
```
|
|
|
|
- **Server:** `server/`, Go 1.26, API only — see `server/README.md` for endpoints, configuration
|
|
and the storage layout. Replaced the Next.js app from upstream (`web/`, removed 2026-10-17).
|
|
- **Dashboards:** Grafana, provisioned from `k8s/grafana/`: Live (stats, SoC/range, power/speed,
|
|
route map, temperatures, tyres), Consumption (period totals, lifetime, SoH, per-day energy,
|
|
distance and efficiency) and Charging (totals, session table, curves). Prices in euro.
|
|
- **Car app:** Server tab (URL, ingest token, installation id, config import); live telemetry
|
|
every 15 s while driving or charging; consumption chunks and charging sessions as before.
|
|
- **Deployment:** `k8s/`, plain manifests. **Nothing is ever applied to the cluster by us** —
|
|
Nils applies them (`k8s/README.md`). TLS comes from Traefik's default certificate.
|
|
|
|
### Status
|
|
|
|
- [x] Go server 2.0.0: tests and govulncheck clean; image builds (about 11 MB).
|
|
- [x] End-to-end in podman (server + InfluxDB 2.7.12 + Grafana 13.2.3): every endpoint, retry
|
|
idempotency, all 25 dashboard queries return data, dashboards rendered and checked.
|
|
- [x] Manifests validated offline (including Traefik CRDs). **Not applied.**
|
|
- [x] Car app 2.3.0: unit tests and lint pass; **not yet tried on the car**.
|
|
- [ ] Push the image (`mg4-server:2.0.0`) to git.stinnesbeck.com (needs a registry login here).
|
|
- [ ] Check in `k8s/ingress.yaml`: the Traefik ingress class (placeholder `traefik-external`) and
|
|
Grafana's host (placeholder `car-grafana.stinnesbeck.com`).
|
|
- [ ] First drive with 2.3.0: telemetry arrives in InfluxDB, Grafana and ABRP.
|
|
|
|
## To do
|
|
|
|
- [ ] **About dialog link and QR code → https://git.stinnesbeck.com/nils/mg4.**
|
|
Both come from `REPOSITORY_URL` in `app/src/main/java/com/evsuite/abrp/MainActivity.java`
|
|
and `about_repository` in `app/src/main/res/values/strings.xml`. They still point to Fatih's
|
|
GitHub repository.
|
|
- [ ] **Re-enable OTA updates against our own releases.** `RELEASES_API` in
|
|
`app/src/unstable/java/com/evsuite/abrp/OtaUpdater.java` points at `updates.invalid` on purpose,
|
|
so checks fail. The updater speaks the GitHub releases API and only allows GitHub hosts
|
|
(`ALLOWED_HOSTS`). For git.stinnesbeck.com it needs the host on the allowlist, and the
|
|
response parsing checked against that server's releases API. Release assets must be named
|
|
`NilsMG4-unstable-<version>.apk` with a `.sha256` sidecar (`build-car` writes both).
|
|
- [ ] **Telemetry queue survives restarts.** Unsent live samples are kept in memory only.
|
|
- [ ] **Translate the rest.** The docs (`CHANGELOG.md`, `OTA.md`'s
|
|
message table, comments in `mise.toml`/`app/build.gradle`) are still Turkish or French.
|
|
- [ ] **Docs still use the old package ID.** `README.md`, `OTA.md`, `CHANGELOG.md`, `mise.toml` and
|
|
`docs/MG4_PLATFORM_INSTALL.md` refer to `com.evsuite.abrp(.unstable)` and `FatihsMG4-*.apk`.
|
|
- [ ] **Move hardcoded UI strings into `strings.xml`.** Many are inline in Java and layouts.
|
|
|
|
## Done
|
|
|
|
- 2026-10-17 — Translated the app UI from Turkish to English.
|
|
- 2026-10-17 — Nix flake: `nix develop` provides JDK 21 and the Android SDK. `build-car` builds the
|
|
unstable APK and signs it with the AOSP test platform key, which the MG4 head unit uses
|
|
(cert SHA-256 `c8a2e9bc…192ab8`).
|
|
- 2026-10-17 — OTA update checks disabled by pointing at an unresolvable host (see To do).
|
|
- 2026-10-17 — Renamed to "Nils' MG4": package ID `com.stinnesbeck.nilsmg4` (`.unstable` for the car
|
|
build), APK names `NilsMG4-*.apk`. It installs next to the old FatihsMG4 app instead of replacing
|
|
it, and starts with empty settings and history.
|
|
- 2026-10-17 — Server rewritten for InfluxDB 2 with live telemetry and ABRP forwarding; Dockerfile;
|
|
Kubernetes manifests (not applied).
|
|
- 2026-10-17 — App 2.3.0: Server tab (URL, ingest token, installation id, config import), live
|
|
telemetry restored from before `ea8032a` and sent to the server, Upload-tab cadence controls
|
|
reconnected, dead switches removed. The removed ABRP classes' unit tests compile and pass again
|
|
(AbrpApi and HeadUnitWeather tests deleted with their classes).
|
|
- 2026-10-17 — Accent colour: MG red instead of muted gold. Web app renamed to Nils' MG4.
|
|
- 2026-10-17 — Dashboard translated to English (en-GB formatting); euro instead of lira in the
|
|
dashboard and the car app's charging tab.
|
|
- 2026-10-17 — Server rewritten in Go (API only); dashboards moved to Grafana with provisioned
|
|
InfluxDB datasource and three dashboards; the Next.js app (`web/`) removed. Per-host
|
|
cert-manager certificates dropped in favour of Traefik's default certificate.
|
|
- 2026-10-17 — Temporary on-screen diagnostics (b2a5b32) to debug blank values without adb;
|
|
removed again (1002962) once values showed on the car. Revert 1002962 to bring them back.
|
|
|
|
## Installing on the car
|
|
|
|
```
|
|
nix develop
|
|
build-car
|
|
adb push build/car/NilsMG4-unstable-<version>.apk /data/local/tmp/update.apk
|
|
adb shell "pm install -r -f -d -t /data/local/tmp/update.apk"
|
|
```
|
|
|
|
To remove the old upstream app: `adb uninstall com.evsuite.abrp.unstable`.
|