mrrmlab App — Wiki

Willkommen im offiziellen Wiki der mrrmlab App — einer selbst gehosteten, quelloffenen Plattform für Einkaufslisten, Todos und weitere Module.

Inhalt

Für Nutzer

• App-Installation — F-Droid-Einrichtung, APK-Download
• App-Nutzen — Erste Schritte, Login, Einkaufslisten
• Paket-Tracking — Auto-Erkennung aus Mails, Provider, manuelle Anlage
• Mail-Kategorisierung — On-Device-Tagging, NLI + Llama auf Mobile, MiniLM auf Web

Für Entwickler

• Architektur — Monorepo-Struktur, Apps, Packages
• Lokale-Entwicklung — Setup, Dev-Server, Datenbank
• API-Referenz — Endpunkte, Authentifizierung, Fehler
• Datenbank — Schema, Drizzle ORM, Migrationen
• Authentifizierung — Keycloak, OIDC-Flow, PKCE
• Shared-Packages — shared-types, api-client, auth, ui

Für DevOps / IT

• CI-CD — Drone-Pipelines, Secrets, Runner
• Android-Build — APK-Signing, F-Droid-Distribution
• Deployment — Docker Compose, Server-Setup, Umgebungsvariablen
• Infrastruktur — Registry, Monitoring, Traefik
• Restore-Paperless — Backup-Setup + Restore-Test für Paperless-ngx
• Restore-Mrrmlabapp-DB — Backup-Setup + Restore-Test für mrrmlabapp-DB

Tech Stack (Übersicht)

Bereich	Technologie
Backend	NestJS 10, PostgreSQL 17, Drizzle ORM
Web	Vite, React 19, TanStack Router/Query, Tamagui
Mobile	Expo SDK 54, React Native 0.81, Expo Router
OCR	Python 3.11, FastAPI, EasyOCR
Auth	Keycloak, OIDC Authorization Code + PKCE
CI/CD	Drone CI, Forgejo (selbst gehostet)
Infra	Docker, Traefik, Drone Runner

Repositories & Services

Service	URL
Forgejo (Code)	https://git.mrrm.de/admin-mrrm/mrrmlabapp
Drone CI	https://ci.mrrm.de/admin-mrrm/mrrmlabapp
Web App	https://app.mrrm.de
API	https://api.mrrm.de
F-Droid Repo	https://fdroid.mrrm.de
Keycloak	https://auth.mrrm.de