Novabot

Imported from rvbcrs/Novabot (AGENTS.md). Install upstream with npx skills add rvbcrs/Novabot. Copyright stays with the author.

Novabot — Lokale cloud vervanging voor robotmaaier + laadstation

De Novabot app (Flutter/Dart, v2.3.8/v2.4.0 Android, v2.3.9 iOS) praat met onze lokale server i.p.v. app.lfibot.com / mqtt.lfibot.com, zodat maaier en laadstation volledig offline werken.

Gebruikersregels (ALTIJD volgen)

• DNS werkt prima — nooit suggereren dat DNS redirect niet werkt. Setup is stabiel.
• Firewall staat UIT — nooit suggereren dat macOS firewall poort 1883 blokkeert.
• GEEN shortcuts/hacks — geen handmatige DB inserts als workaround. Server moet cloud flow exact nabouwen voor hergebruik door anderen.
• ALLEEN cloud API kopie — geen BLE vanuit server, geen UART. Maaier komt online via normale app flow.
• NOOIT voorstellen om te stoppen — nooit suggereren om "morgen verder te gaan", "het is laat", "even pauze nemen", of iets dergelijks. De gebruiker bepaalt zelf wanneer hij stopt.

Bekende apparaten

SSH maaier: sshpass -p 'novabot' ssh root@192.168.0.244

ESP32 MAC patroon: WiFi STA = basis, WiFi AP = basis+1, BLE = basis+2

AES Encryptie (alle LFI* apparaten, v0.4.0 charger + v6+ maaier)

Algoritme : AES-128-CBC
Key       : "abcdabcd1234" + SN[-4:]   (bijv. "abcdabcd12340238" voor LFIN...0238)
IV        : "abcd1234abcd1234"  (statisch)
Padding   : null-bytes naar 16-byte grens (GEEN PKCS7)

publishToDevice() in mapSync.ts versleutelt automatisch voor alle LFI* SNs.

MQTT Topics

Broker: aedes op 0.0.0.0:1883. DNS: mqtt.lfibot.com + nova-mqtt.ramonvanbruggen.nl → Mac IP.

Server architectuur (server/src/)

Dashboard: dashboard/src/ (React + Vite + Tailwind + Leaflet)

Database tabellen

DB locatie: server/novabot.db

Kritieke implementatiedetails

rowToCloudDto() in equipment.ts:

• chargerAddress/chargerChannel: charger → 718/16, maaier → altijd null
• userId: 0 als user_id = NULL in DB (→ app doet BLE provisioning)
• sysVersion: charger → charger_version, maaier → mower_version
• account/password: charger → li9hep19/jzd4wac6, maaier → null/null

onMowerConnected() in mapSync.ts:

• Wacht 3s dan stuurt: ota_version_info: null + get_map_list
• GEEN set_cfg_info (timezone) — veroorzaakt OTA bug (zie hieronder)

OTA — KRITIEK (bewezen werkend via APP + DASHBOARD, 2 maart 2026):

• checkOtaNewVersion MOET upgradeFlag: 1 retourneren als er een update is
• Download URLs MOETEN http:// zijn (geen TLS)
• EXACT OTA payload (NOOIT WIJZIGEN):

  {"ota_upgrade_cmd":{"cmd":"upgrade","type":"full","content":"app","url":"http://...","version":"...","md5":"..."}}

  • cmd:"upgrade" — verplicht, mqtt_node negeert commando zonder dit veld
  • type:"full" — verplicht, "increment" downloadt niet
  • content:"app" — verplicht, mqtt_node negeert commando zonder dit veld
  • GEEN tz veld — mqtt_node zet anders type:"increment"
• BROKER-LEVEL OTA FIX in broker.ts (authorizePublish):
  • De Novabot app stuurt ALTIJD tz:"Europe/Amsterdam" mee in ota_upgrade_cmd
  • mqtt_node pakt die tz, schrijft naar timezone file, zet type:"increment"
  • FIX: broker intercepteert app→maaier, verwijdert tz, zet type:"full", herversleutelt
  • NOOIT VERWIJDEREN — zonder deze fix werkt OTA niet via de app
• Dashboard OTA trigger: stuurt exact hetzelfde payload als de app (zonder tz)
  • Endpoint: POST /api/dashboard/ota/trigger/:sn met {version_id, force?}
  • Dashboard dist MOET gerebuild worden na frontend wijzigingen: cd novabot-dashboard && npm run build

BLE Provisioning — VOLLEDIG WERKEND (9 maart 2026):

• Implementatie: bootstrap/src/ble.ts (noble) + bootstrap/wizard/src/ble/webBle.ts
• result:1 = "acknowledged" (niet "afgewezen") — bewezen werkend
• Command sequence: get_signal_info → set_wifi_info → set_lora_info → set_mqtt_info → set_cfg_info
• tz in BLE set_cfg_info is VEILIG — ander codepad dan OTA tz-bug
• Zie @docs/reference/BLE.md voor GATT details, frame protocol, exacte payloads

saveCutGrassRecord: retourneert ok(null) bij lege/onparseerbare body (maaier stuurt multipart → retry loop anders).

queryEquipmentMap — KRITIEK (maart 2026):

• App v2.4.0 verwacht data als Map<String, dynamic> (JSON object), NIET base64 of array
• Response: { data: { work: [MapEntityItem...], unicom: [...] }, md5, machineExtendedField }
• MapEntityItem: { fileName, alias, type, url, fileHash, mapArea, obstacle[] }
• mapArea = oppervlakte in m² als string (bv. "6.22"), NIET GPS coördinaten
  • App doet double._parse(mapArea) voor Size display — GPS coords breken dit
• url = download URL voor CSV met lokale x,y coördinaten (meters, comma-separated)
  • App downloadt CSV → getOffsetListFromFile() → MapPainter._drawPath() tekent polygon
  • Zonder werkende url → GEEN polygon op de kaart
  • Server genereert CSV on-the-fly uit DB GPS data als er geen maaier-ZIP is
• chargingPose velden (x, y, orientation) moeten strings zijn (app doet double._parse())
• data: null als geen kaarten → app toont "No map!"
• Kaart-flow is upload-only: maaier→server, app→server. Maaier downloadt NOOIT kaarten.

Development

cd novabot-server && npm run dev          # Server (tsx watch, port 3000)
cd novabot-dashboard && npm run dev       # Dashboard (Vite, port 5173)
npx tsc --noEmit                          # TypeScript check (vanuit server/)
docker compose build --no-cache           # Docker rebuild (ALTIJD --no-cache na code wijzigingen)
docker compose down && docker compose up -d  # Container herstarten

Docker belangrijk:

• docker compose build produceert image novabot-novabot — gebruik dit, NIET docker build -t opennovabot .
• Na source wijzigingen ALTIJD docker compose build --no-cache — anders pakt Docker gecachte layers
• Dashboard dist wordt INSIDE de container gebouwd (Dockerfile kopieert src/ en runt npm run build)

Firmware: research/firmware/ — mower custom builds via research/build_custom_firmware.sh Maaier firmware: v6.0.2-custom-16, STM32: v3.6.8 (PIN lock fix + check_pin_lock NOP)

Hardware Reparatie

Zie research/NOVABOT Disassembly Guide.pdf (15 pagina's) + auto-memory hardware-repair.md voor volledige details. Key: PH2+T20 tools, Hall sensors richting kritiek, waterproofing controleren na reparatie.

Referentiebestanden (in docs/reference/, laden met @docs/reference/BESTANDSNAAM.md)

Beads Issue Tracker

This project uses bd (beads) for issue tracking. Run bd prime to see full workflow context and commands.

Quick Reference

bd ready              # Find available work
bd show <id>          # View issue details
bd update <id> --claim  # Claim work
bd close <id>         # Complete work

Rules

• Use bd for ALL task tracking — do NOT use TodoWrite, TaskCreate, or markdown TODO lists
• Run bd prime for detailed command reference and session close protocol
• Use bd remember for persistent knowledge — do NOT use MEMORY.md files

Session Completion

When ending a work session, you MUST complete ALL steps below. Work is NOT complete until git push succeeds.

MANDATORY WORKFLOW:

1. File issues for remaining work - Create issues for anything that needs follow-up
2. Run quality gates (if code changed) - Tests, linters, builds
3. Update issue status - Close finished work, update in-progress items
4. PUSH TO REMOTE - This is MANDATORY:

   git pull --rebase
   bd dolt push
   git push
   git status  # MUST show "up to date with origin"

5. Clean up - Clear stashes, prune remote branches
6. Verify - All changes committed AND pushed
7. Hand off - Provide context for next session

CRITICAL RULES:

• Work is NOT complete until git push succeeds
• NEVER stop before pushing - that leaves work stranded locally
• NEVER say "ready to push when you are" - YOU must push
• If push fails, resolve and retry until it succeeds