Tronax/mitbringsl
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
4 commits 1 branch 0 tags 1 MiB
Find a file
Tronax 895725b5e5
Backend Phase C: Sync-Kern + Caddy behind-proxy 
Sync-Kern:
- internal/sync/hlc.go: Hybrid Logical Clock (wall_ms<<16|counter)
  Tick/Now/After, global mutex, strikt monoton + kausal korrekt
- internal/sync/hlc_test.go: Unit-Tests (monoton, kausal, keine Duplikate)

Store-Schicht:
- internal/store/opstore.go: AppendOps idempotent via UNIQUE(client_id,
  client_seq) ON CONFLICT DO NOTHING; LWW-Projektion (list_create/
  rename/delete, item_add/update/remove) in derselben Transaktion;
  PullOps mit Cursor (seq > since, 500er Pages)
- internal/store/liststore.go: CreateList / GetLists / GetList
- internal/store/itemstore.go: GetItems (nicht-gelöschte Items)
- internal/store/suggeststore.go: Search (pg_trgm + LIKE-fallback, 10)

HTTP-Handler:
- internal/httpapi/lists.go: GET/POST /api/lists, GET /api/lists/{id}
- internal/httpapi/ops.go: POST /api/lists/{id}/ops (Push),
  GET /api/lists/{id}/ops (Pull ?since=)
- internal/httpapi/suggest.go: GET /api/suggestions?q=
- internal/httpapi/api.go: alle Routen verdrahtet (RequireAuth)

Deployment:
- deploy/Caddyfile.behind-proxy: auto_https off, trusted_proxies
- deploy/Caddyfile: X-Forwarded-Proto hinzugefügt, Kommentar aktualisiert
- deploy/docker-compose.yml: CADDY_HTTP_PORT + CADDY_HTTPS_PORT
- deploy/.env.example: Caddy-Port-Variablen dokumentiert

go build ./... && go vet ./... && go test ./... ✅
HLC-Tests: monoton, kausal, keine Duplikate ✅
AGENTS.md: Phase C vollständig ✅
2026-08-05 19:56:05 +02:00
backend Backend Phase C: Sync-Kern + Caddy behind-proxy 2026-08-05 19:56:05 +02:00
deploy Backend Phase C: Sync-Kern + Caddy behind-proxy 2026-08-05 19:56:05 +02:00
.gitignore Backend Phase A: foundation, migrations, Docker setup 2026-08-05 15:14:37 +02:00
AGENTS.md Backend Phase C: Sync-Kern + Caddy behind-proxy 2026-08-05 19:56:05 +02:00
README.md Backend Phase A: foundation, migrations, Docker setup 2026-08-05 15:14:37 +02:00

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:

Lizenz

Privatprojekt – alle Rechte vorbehalten.