e596199ba0
Some checks are pending
CI / validate (push) Waiting to run
- pnpm dev:full chained: docker:up --wait → db:push → concurrently dev + dev:auth
- vite.config: ssr.noExternal + optimizeDeps.exclude für @mana/* aus Verdaccio
(Raw-.ts-Sourcen brechen Node-22-Type-Stripping in node_modules)
- README + STATUS auf neuen Setup-Umfang aktualisiert (mana-auth läuft mit)
- concurrently als devDep, dev:auth/docker🆙auth/db:push:auth Sub-Scripts
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
63 lines
2.2 KiB
Markdown
63 lines
2.2 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 dev:full # cards docker + mana docker + DB-Push (cards & auth) + dev (cards & mana-auth)
|
|
```
|
|
|
|
Oder von überall via zsh-Alias: `cards-dev`.
|
|
|
|
`dev:full` greift in `../mana/` (Plattform-Repo): startet `mana-postgres`,
|
|
pushed `mana-auth`-Schema, und startet `mana-auth` auf :3001 parallel zu
|
|
cards-api/-web. Damit ist Login lokal komplett testbar (Cookie-Domain
|
|
`localhost`, eigener Dev-User in lokaler `mana_auth`-DB).
|
|
|
|
Einzelschritte (falls nur Teile gebraucht werden):
|
|
|
|
```bash
|
|
pnpm docker:up # Cards Postgres + MinIO (wartet bis healthy)
|
|
pnpm docker:up:auth # Mana Postgres (wartet bis healthy)
|
|
pnpm db:push # Cards Drizzle-Schema
|
|
pnpm db:push:auth # mana-auth Drizzle-Schema
|
|
pnpm dev # cards api + web parallel (Turbo)
|
|
pnpm dev:auth # mana-auth :3001
|
|
```
|
|
|
|
→ 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).
|