2bed28212d
Bisherige Doku war über CLAUDE.md, README.md, SMOKE_TEST.md, LESSONS_FROM_MANA_MONOREPO.md plus mana/docs/playbooks/CARDS_GREENFIELD.md zerstreut — eine fresh-AI-Session musste sich Status zusammenstückeln. STATUS.md zentralisiert: - TL;DR + Architektur-Topologie - Architektur-Entscheidungen (festgenagelt) - Phasen-Status-Tabelle (✅/🚧/⏸ pro Phase mit Verifikations-Hinweis) - Lokal-Lauf-Anleitung (5 Schritte zu cards-api + cards-web im Browser) - Verifizierte Endpoints-Liste - Pre-Flight für Phase 2 + Live-Föderation - Wichtige Pointer: Konventionen, Stack, Files, Cross-Repo-Doks - Git-Historie (6 Commits) - 6 Architektur-Subtilitäten, die nicht offensichtlich sind: Reviews-plaintext, SubIndex-Granularität, Protocol-Mirror-TEMPORARY, Inbox-Auto-Create, Dev-Auth-temporär, mana-monorepo-Decommission - Onboarding-Sequenz (5-Min-Lese-Plan) - Vorschläge für nächste Phasen Cross-References: - CLAUDE.md verweist als erstes auf STATUS.md - README.md ebenso - mana/docs/playbooks/CARDS_GREENFIELD.md (im Plattform-Repo) verweist zurück auf cards/STATUS.md für aktuellen Stand — Playbook ist der Plan, STATUS.md ist die Lage. Konvention: bei Phasen-Wechsel STATUS.md aktualisieren, nicht den Playbook (sonst Doku-Drift). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# Cards
|
|
|
|
**Eigenständige Spaced-Repetition-App des Vereins mana e.V.**
|
|
|
|
Cards ist eine föderierte Peer-App im mana-Ökosystem. Sie verwaltet
|
|
Karteikarten, plant Wiederholungen mit dem FSRS-Algorithmus und
|
|
empfängt Inhalte aus anderen Verein-Apps (z.B. Zitate aus Memoro,
|
|
Notizen aus Mana, Web-Schnipsel aus dem Browser-Plugin).
|
|
|
|
→ Live (geplant): <https://cardecky.mana.how>
|
|
|
|
**Aktueller Stand und Pickup-Onboarding: [`STATUS.md`](STATUS.md).**
|
|
|
|
## Stack
|
|
|
|
- **Frontend:** SvelteKit 2 + Svelte 5 (runes-only)
|
|
- **Backend:** Hono + Bun + Drizzle ORM
|
|
- **Datenbank:** Postgres mit Schema-Isolation (`pgSchema('cards')`)
|
|
- **Auth:** föderiert über mana-auth (EdDSA JWT, JWKS-Cache)
|
|
- **Subscriptions:** mana-credits (zentral pro Verein-Account)
|
|
- **AI-Tools:** über mana-mcp Claude Desktop / persona-runner verfügbar
|
|
- **i18n:** DE / EN / FR / ES / IT
|
|
- **Build:** Turborepo + pnpm 9
|
|
|
|
## Status
|
|
|
|
Phase 0 (Repo-Skeleton) — siehe `mana/docs/playbooks/CARDS_GREENFIELD.md`
|
|
für den vollständigen Plan.
|
|
|
|
## Lokal entwickeln
|
|
|
|
```bash
|
|
pnpm install
|
|
pnpm docker:up # Postgres in Docker
|
|
pnpm db:push # Drizzle-Schema
|
|
pnpm dev # api + web parallel
|
|
```
|
|
|
|
→ API auf `http://localhost:3081`, Web auf `http://localhost:3082` (oder Vite-Dev-Default `5173`).
|
|
|
|
Voraussetzung: Mana-Plattform-Stack (mana-auth, evtl. Föderations-Services)
|
|
muss lokal laufen, sonst greift Auth-Login nicht.
|
|
|
|
## Lizenz
|
|
|
|
Mana-Verein-intern, MIT (siehe `mana/docs/COMPLIANCE.md` für Details
|
|
zur Verein-Lizenzpolitik).
|