No description
- Auth UI & Logic: AuthScreen (Login/Register), AuthViewModel, AuthRepository, SessionManager
- SyncEngine: HybridLogicalClock (client-side), SyncWorker (outbox drain + server cursor pull), SyncManager
- Repository Layer: ShoppingRepository for local-first Room mutations + op_log outbox queue
- Screens & UI: ListsScreen (list overview & creation dialog), ListDetailScreen (checked/open sectioning, autocomplete AddItemBar)
- Navigation: MainNavigation (AuthNavKey -> ListsNavKey -> ListDetailNavKey)
- Verification: ./gradlew assembleDebug & ./gradlew test green ✅
|
||
|---|---|---|
| android | ||
| backend | ||
| deploy | ||
| .gitignore | ||
| AGENTS.md | ||
| README.md | ||
Mitbringsl
Eine Local-First Einkaufslisten-App – eine schlanke, werbefreie Bring-Alternative. Android-App (Kotlin + Jetpack Compose) mit eigenem Go-Backend (PostgreSQL, Docker), OIDC-Login (Google + Generic) und verlustfreiem Sync.
Status: Work in Progress / MVP.
Was das Projekt kann (Ziel)
- 📝 Einkaufslisten anlegen, Items verwalten, an-/abhaken
- 🔄 Local-First: voll funktionsfähig offline, automatischer Sync ohne Datenverluste (Append-only Operations-Log + Hybrid Logical Clocks + Tombstones)
- 👤 Anmeldung mit eigenen Usern (E-Mail/Passwort, Argon2id) oder OIDC (Google + beliebiger Generic-OIDC-Provider wie Keycloak/Authentik)
- 🔍 Autocomplete beim Tippen – Vorschläge aus den aggregierten Item-Namen aller User
- 🚫 Keine Werbung – cleanes Material-3-Design
- 🐳 Self-hosted als Docker-Container, automatisches HTTPS via Caddy
Repository-Aufbau
mitbringsl/
├── backend/ # Go-API (net/http, pgx, sqlc, golang-migrate, go-oidc)
├── android/ # Android-App (Kotlin, Jetpack Compose, Room, Hilt, WorkManager)
├── deploy/ # docker-compose.yml, Caddyfile, .env.example
└── docs/ # Architektur-, Sync- und API-Doku
Schnellstart
Backend (Docker)
cd deploy
cp .env.example .env # Werte anpassen (v.a. Secrets/URLs)
docker compose up -d --build
# API unter https://<deine-domain> (oder http://localhost:8080 ohne Caddy)
App bauen
Siehe android/README.md (folgt).
Detaillierte Doku:
docs/ARCHITECTURE.md– Aufbau, Auth-Flowsdocs/SYNC.md– Sync-Modell & Konfliktlösungdocs/API.md– REST-Endpoints
Lizenz
Privatprojekt – alle Rechte vorbehalten.