doc: openScale milstolpe 1-4 klara + README (våg, GPL) + version 0.4.0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C2GA94E1f3cmrvdQLQhYdg

doc/openscale-integration.md

@@ -67,34 +67,55 @@ cachas lokalt (som kroppsvikten) för offline och för BIA-beräkningen.
 
 **Webb (brasse-pc.eu-v2):** samma fält på profil-fliken via `updateProfile`.
 
+## Användarens våg (identifierad 2026-08-23)
+
+**Biltema 84-1002 "Bluetooth Analyser Scale", modell PT-727** (Ningbo Putian).
+Annonserar som BLE-namnet **"VScale"** (verifierat med `bluetoothctl` på
+brasse-linux01: `Device C4:BE:84:79:D0:6C VScale`) → openScales
+**`ExingtechY1Handler`** matchar (exakt namnmatch `vscale`).
+
+Protokoll (GATT): appen skriver `[0x10, userId, kön, ålder, längd_cm]` till
+vågen; vågen räknar ut kroppssammansättningen **ombord** och notifierar en
+20-bytes-ram (vikt, fett-%, vatten-%, muskel-%, benmassa kg, bukfettsindex).
+Ingen BIA-formel behövs i appen — men längd/födelseår/kön måste finnas.
+
 ## Milstolpar (byggbara steg)
 
-1. **Grund + licens + About** — LICENSE → GPL-3.0; `blessed-kotlin`-beroende;
-   BLE-permissions i manifestet; About-vy under Profil (attribution + länkar +
-   openetlicens-text); körruntime-permission-flöde. *Ingen vågkod än — bara
-   att allt kompilerar och About visas.*
-2. **Porta bluetooth-paketet** — vendora `com.health.openscale.core.bluetooth`
-   (ScaleCommunicator, ScaleFactory, scales/, adaptrar, data/, libs/) med
-   copyright-headers kvar. Slimmad `ScaleMeasurement`/`ScaleUser`. Får det att
-   kompilera mot Blessed.
-3. **Skanna + koppla** — "Anslut våg" i inställningar: skanna BLE, kör
-   `ScaleFactory` mot varje enhet, visa matchade vågar, spara vald MAC.
-4. **Väg dig-flöde** — knapp som skannar/kopplar vald våg, tar emot en
-   `ScaleMeasurement`, förhandsvisar och sparar via `addBodyMeasurement`
-   (offline-kön tar resten). Live-status ("står på vågen…").
+1. **Grund + licens + About** *(klar 2026-08-23)* — LICENSE → GPL-3.0;
+   `blessed-kotlin` 3.0.12 via JitPack (krävde Kotlin 2.0.21→2.2.0, KSP2,
+   Room 2.7.2); BLE-permissions (`BLUETOOTH_SCAN` neverForLocation +
+   `BLUETOOTH_CONNECT`); About-vy under Profil med GPL-attribution.
+2. **Porta bluetooth-paketet (grund)** *(klar 2026-08-23)* — vendrat
+   `com.health.openscale.core.bluetooth` med copyright-headers kvar:
+   ScaleDeviceHandler, Gatt/Broadcast/Spp-adaptrar, ScaleFactory (utan Hilt),
+   ScaleCommunicator, BleScanner, ConverterUtils, ScaleMeasurement/ScaleUser,
+   samt **ExingtechY1Handler**. Shims i samma paketnamn för openScales
+   interna beroenden (facades → DataStore, slimmade enums, LogManager →
+   logcat), så fler drivrutiner kan portas nästan rakt av.
+   *Kvar: resterande ~59 handlers + libs/ portas allteftersom.*
+3. **Skanna + koppla** *(klar 2026-08-23)* — Inställningar → Bluetooth-våg:
+   BLE-skanning, vågar med drivrutinsstöd överst (drivrutinsnamn visas),
+   spara/ta bort vald våg. Runtime-permission-flöde.
+4. **Väg dig-flöde** *(klar 2026-08-23, otestat mot fysisk våg)* — knapp i
+   profilen → väg-skärm med livestatus, resultat och spara via
+   `addBodyMeasurement`. Kroppsdata (längd/födelseår/kön) i profilen skickas
+   till vågen. **Nästa steg: verifiera mot Biltema-vågen.**
 5. **API: längd (+ ålder/kön)** — utöka gym-API:ts `User` med `HeightCm`
    (+ `BirthDate`/`Sex`), migration, `myProfile` + `updateProfile`, deploy.
-   App + webb får profilfält. Se "API-ändring" ovan.
-6. **Impedansvågar + bättre kalorier** — BIA-beräkning för vågar som skickar
-   rå impedans (använder längd/ålder/kön), och BMR-baserad energiförbrukning.
-   Verifieras mot din våg.
+   App + webb får profilfält; appens lokala kroppsdata börjar synka mot
+   API:t. Se "API-ändring" ovan.
+6. **Fler drivrutiner + impedansvågar + bättre kalorier** — porta resterande
+   handlers + `libs/` (BIA-beräkningar för vågar som skickar rå impedans),
+   och BMR-baserad energiförbrukning.
 7. **Polering + docs** — felhantering, timeouts, ominställning av våg;
    uppdatera README/wiki + infra-Doc (GPL-relicens noterad).
 
 ## Öppna frågor / risker
 
-- **Vilken våg du har** avgör om milstolpe 5 (impedans-BIA) behövs eller om
-  din våg skickar färdiga procent. Identifieras i milstolpe 3 via skanning.
-- Blessed-Kotlins exakta koordinater/version verifieras vid milstolpe 1.
+- ~~Vilken våg du har~~ → Biltema PT-727 = Exingtech Y1 ("VScale"), räknar
+  ombord — milstolpe 6:s BIA behövs inte för den.
+- ~~Blessed-Kotlins koordinater~~ → `com.github.weliem:blessed-kotlin:3.0.12`
+  (JitPack). Byggd med Kotlin 2.2 → tvingade upp projektets Kotlin/KSP/Room.
 - APK växer (drivrutiner + BLE-lib) — troligen någon MB, oproblematiskt.
 - GPL-relicens är permanent för koden; medvetet val.
+- Väg-flödet är obekräftat mot fysisk våg (kräver test med telefon + våg).