# 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>

## 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).