# Buschauffeurswekker

Android-wekker-app die wekkers **automatisch** zet op basis van het EBS-dienstrooster
in de Nextcloud CalDAV-agenda **EBS-Diensten**. De wekker wekt zoals elke normale
wekker-app (geluid, trillen, volledig scherm, snooze) — maar het wanneer wordt zelf
bepaald uit de dienst van morgen.

## Werking

Elke dag om **12:00** haalt de app de agenda van **morgen** op en zet daaruit de
dienstaanvang. Die wordt **naar beneden afgerond op een heel kwartier**:

| Aanvang dienst | Aangenomen aanvang |
|---|---|
| 05:00 – 05:14 | 05:00 |
| 05:15 – 05:29 | 05:15 |
| 05:30 – 05:44 | 05:30 |
| 05:45 – 05:59 | 05:45 |

Technisch: `minuut = (minuut / 15) * 15` (floor op kwartier). Rond middernacht kan de
wekker op de vorige dag vallen (dienst 00:10 → Opstaan de dag ervoor 22:00).

Daarna worden drie wekkers gezet, elk voor de afgeronde aanvang:

| Wekker | Tijd vóór aanvang | Voorbeeld (06:15) |
|---|---|---|
| **Opstaan** | 2 uur | 04:15 |
| **Wally** | 1,5 uur | 04:45 |
| **Vertrek** | 0,5 uur | 05:45 |

**Geen dienst morgen → geen wekkers.**

## Kenmerken

- **Donkere wekker-UI** in de stijl van de systeemwekker: kop "Wekkers", één kaart
  per wekker met grote tijd + naam, acties achter het **⋮-menu**.
- **Aan/uit per wekker** — schakelaar op elke kaart; een uitgezette wekker blijft uit
  (ook de dagelijkse 12:00-controle plant hem niet opnieuw) tot je hem weer aanzet.
  Uitgeschakelde kaart is grijs, aangezette blauw.
- **Eigen geluid per wekker** via Instellingen → Wekkergeluiden (systeem-ringtone-
  kiezer). Standaard is het systeem-alarmgeluid; valt terug op die toon als het
  gekozen bestand verdwenen is.
- **Volwaardige wekker**: geluid (herhalend) + trillen, volledig scherm óók bovenop
  het vergrendelscherm, snooze 10 min, "wekker uit".
- **Werkt op de achtergrond**: exacte alarmen (ook in Doze), herstel na herstart,
  mobiele data toegestaan.
- **Statusmelding om 12:00** met de wekkers van morgen; tikken opent de app.

## Schermen

- **Hoofdscherm** — "Wekkers": de drie wekkerkaarten (met aan/uit) van morgen; onderaan
  de diensttijd ("Dienst om 06:18"). Het **⋮**-menu bevat *Nu controleren* en
  *Instellingen*.
- **Instellingen** — CalDAV-gegevens (agenda-URL, gebruiker, app-wachtwoord + Opslaan)
  en *Wekkergeluiden* (per wekker een geluid).
- **Afgaande wekker** — full-screen: naam, lopende klok, Snooze (10 min) / Wekker uit.

## Installatie

1. Bouw: `./gradlew :app:assembleDebug`
   → `app/build/outputs/apk/debug/app-debug.apk`
2. APK op de telefoon zetten en installeren (sideload).
3. App openen → **⋮ → Instellingen** → invullen:
   - Agenda-URL: `https://nextcloud.eddydevink.nl/remote.php/dav/calendars/eddy/ebs_diensten-1/`
   - Gebruikersnaam: `eddy`
   - App-wachtwoord: een Nextcloud-app-wachtwoord (Nextcloud → Beveiliging →
     App-wachtwoorden). Niet in de app hardcoden; zie de Obsidian-vault.
4. **Opslaan** → terug → **⋮ → Nu controleren** om te testen.
5. Meldingenmachtiging: systeemdialoog bij de eerste start.

Config is ook zonder UI te zetten (installatiehulp):

```bash
adb shell am start -n nl.eddydevink.buschauffeurswekker/.MainActivity \
  --es url 'https://nextcloud.eddydevink.nl/remote.php/dav/calendars/eddy/ebs_diensten-1/' \
  --es user 'eddy' --es pass '<app-wachtwoord>'
```

## Machtigingen

| Machtiging | Doel |
|---|---|
| Internet / netwerk | Agenda ophalen over wifi én mobiele data |
| Meldingen (`POST_NOTIFICATIONS`) | Afgaande wekker + status tonen |
| Exacte alarmen (`USE_EXACT_ALARM` / `SCHEDULE_EXACT_ALARM`) | Wekker óp tijd, ook in Doze |
| Volledig scherm (`USE_FULL_SCREEN_INTENT`) | Wekker bovenop het vergrendelscherm |
| Wakelock + trillen | Scherm aanhouden en trillen tijdens afgaan |
| Boot (`RECEIVE_BOOT_COMPLETED`) | Wekkers + 12:00-controle na herstart herstellen |

## Architectuur

```
App                  kanalen + 12:00-controle bij opstart

dagelijks 12:00
  AlarmScheduler.scheduleNoonCheck (exact, allowWhileIdle)
    → DailyCheckReceiver → ShiftCheck.run
        CalDavClient  REPORT calendar-query (time-range, basic auth)
        Ical          iCal-parse: DTSTART (TZID/UTC), vroegste aanvang
        ShiftPlanner  kwartier-afronding + Opstaan/Wally/Vertrek
        AlarmScheduler  plan de aangezette wekkers

afgaan
  AlarmScheduler.scheduleAlarm (exact, allowWhileIdle)
    → AlarmRingReceiver → full-screen intent + start → AlarmActivity
        Ringer      geluid (loop; eigen keuze met fallback) + trillen
        snooze 10 min / dismiss

MainActivity / SettingsActivity  UI (kaarten, menu, instellingen, geluidskeuze)
BootReceiver     na reboot: wekkers + 12:00-controle herstellen
Prefs            instellingen/status/plan, versleuteld (EncryptedSharedPreferences)
```

### Modules

- `core/ShiftPlanner.kt` — pure logica: kwartier-afronding + wekkerplanning (JVM-tests).
- `caldav/Ical.kt` — minimale RFC 5545-parser (VEVENT, DTSTART met TZID/UTC; all-day en
  geannuleerde events worden overgeslagen).
- `caldav/CalDavClient.kt` — REPORT calendar-query (recept uit de scrapedienst).
- `core/ShiftCheck.kt` — orchestrator: ophalen → filteren op morgen → vroegste aanvang
  → plannen (aangezette) of annuleren; gedeeld door receiver, menu-knop en setup-intent.
- `core/AlarmScheduler.kt` — exacte alarmen, 12:00-controle, snooze, per-naam aanv/uit.
- `core/Notifier.kt` — kanalen "wekkers"/"status"; statusmelding tikt de app open.
- `core/Ringer.kt` — wekkergeluid (loop) gekozen per wekker + vibratie; fallback naar
  de standaard alarmtoon als het gekozen bestand weg is.
- `receivers/DailyCheckReceiver.kt`, `AlarmRingReceiver.kt`, `BootReceiver.kt`.
- `AlarmActivity.kt` — full-screen wekker (geluid, trillen, snooze/dismiss).
- `SettingsActivity.kt` — CalDAV-gegevens + per-wekker geluidskeuze.

## Keuzes

- **12:00-controle = exact AlarmManager-alarm**, niet WorkManager: precies om 12:00
  (WorkManager-periodiek is minimaal 15 min en onnauwkeurig).
- Meerdere events op één dag → **vroegste aanvang** telt als dienstaanvang.
- **All-day-events** ("vrij") tellen niet; alleen getimede diensten.
- Na een fout (bv. offline) blijven eerder geplande wekkers staan + statusmelding.
- Wachtwoord **versleuteld** op het toestel (EncryptedSharedPreferences AES256-GCM;
  bij falen plain fallback in de app-sandbox). Nooit hardcoded.
- UI volgt Material 3: donker thema, standaard `MaterialSwitch` en systeemcomponenten.

## Build & test

- Gradle wrapper 8.13 · AGP 8.7.3 · Kotlin 2.0.21
- compileSdk/targetSdk 34, minSdk 27 (Android 8.1+)
- `./gradlew :app:assembleDebug` en `./gradlew :app:testDebugUnitTest`
- Unit tests dekken de afrondingsvoorbeelden (incl. de vier óf), wekkerplanning,
  iCal-parse en een snapshot van een echte serverresponse door de pipeline.

## Gerelateerd

- **Scrapedienst** — vult de `ebs_diensten`-agenda (dagelijks 17:05):
  `~/src/scrapedienst` + vault-notitie `Homelab/Software ontwikkeling/scrapedienst.md`
- **CalDAV-referentieclient**: `~/src/caldav-mcp`
- **Meldingen/wekkers** staan uit; zie de Obsidian-vault-notitie
  `Homelab/Software ontwikkeling/Buschauffeurswekker.md`