Seeda wiki: arkitektur, designbeslut, signering, CI på arm64

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

Home.md

@@ -0,0 +1,60 @@
+# FitnessDroid
+
+Android-klient (Android 12+) för gym-API:t — samma backend som gym-delen i
+[brasse-pc.eu-v2](https://gitea.brasse-pc.eu/brasse/brasse-pc.eu-v2).
+README:n täcker "få det att bygga"; här ligger arkitektur och designbeslut.
+
+## Arkitektur
+
+```
+MainActivity (Compose, edge-to-edge)
+└── FitnessDroidApp          — växlar på AuthState (Restoring/LoggedOut/LoggedIn)
+    ├── LoginScreen           — användarnamn/lösenord + API-url under "Avancerat"
+    └── HomeScreen            — profil + kommande flikar (pass, logg, statistik, PB)
+
+AppContainer (manuell DI i Application)
+├── TokenStore        — DataStore; username/sessionId/jwt/refreshToken/expiration/apiUrl
+├── GraphQlClient     — OkHttp POST {query,variables} + Bearer-header
+├── AuthRepository    — login/restore/refresh/logout, exponerar StateFlow<AuthState>
+└── GymApi            — autentiserade queries (myProfile, växer per milstolpe)
+```
+
+## Designbeslut
+
+- **Handskrivna GraphQL-strängar** (samma som webbens `gymTrackerApi.js`)
+  i stället för Apollo-codegen — API-ytan ägs av samma person, och parity
+  med webben är enklast att verifiera strängvis. Kan omprövas när fler
+  queries tillkommit.
+- **Auth speglar webben:** JWT (2 h) + roterande refresh-token (7 d) +
+  sessions-id; förnyas automatiskt 2 min före utgång bakom en mutex
+  (`AuthRepository.bearerToken()`). Vid nätfel vid appstart släpps
+  användaren in om JWT:n ännu är giltig.
+- **Manuell DI** — appen är för liten för Hilt; `AppContainer` i
+  `FitnessDroidApplication`.
+- **Material You** — dynamiska färger kan användas villkorslöst eftersom
+  minSdk är 31.
+- **versionCode = GITHUB_RUN_NUMBER** i CI så att varje release-APK räknas
+  som uppdatering på telefonen.
+
+## Signering
+
+Nyckeln är inte incheckad (publikt repo). Lokalt: `signing/` (gitignorerad).
+CI: secrets `KEYSTORE_B64` + `KEYSTORE_PASSWORD` skrivs till samma filer i
+jobbet. Utan nyckel faller release-bygget tillbaka på debug-signering —
+bygger, men kan inte uppdatera en installation från släppsidan.
+
+## CI på arm64 (Pi5-runnern)
+
+Googles aapt2 distribueras bara för linux x86_64. Bygget använder därför en
+statiskt byggd arm64-aapt2 från
+[lzhiyong/android-sdk-tools](https://github.com/lzhiyong/android-sdk-tools)
+via `-Pandroid.aapt2FromMavenOverride=…`. Allt annat i Android-bygget
+(kotlinc, d8, apksigner) är JVM-baserat och kör nativt på arm64.
+cmdline-tools + `platforms;android-35` installeras i jobbet; gradle-cache
+via `actions/cache`.
+
+## Milstolpar
+
+Se [doc/plan.md](https://gitea.brasse-pc.eu/brasse/FitnessDroid/src/branch/main/doc/plan.md)
+— 1: grund+login (klar), 2: aktivt pass, 3: passhistorik, 4: lyftlogg+PB,
+5: statistik, 6: mallar, 7: grunddata+profil.