Phase 0+1: Repo-Skelett für Cards-Greenfield

Strategie B (beschlossen 2026-05-08): Cards wird als eigenständige
föderierte App neu gebaut, ohne Code-Übernahme aus mana-monorepo.

Skelett enthält:
- apps/api: Hono+Bun mit /healthz, /version, Manifest-Endpoint, leere
  pgSchema('cards'), Drizzle-Config, erstem Vitest
- apps/web: SvelteKit 2 + Svelte 5 (runes), Vite auf 3082
- packages/cards-domain: Pure-TS, CardType-Discriminated-Union,
  SubIndex-Granularität für Reviews, Future-CardType-Set vorbereitet
- infrastructure/docker-compose.yml: Postgres 16 auf 5435
- app-manifest.json: v1.0.0, Verein-owned, beta-tier
- .github/workflows/ci.yml
- docs/LESSONS_FROM_MANA_MONOREPO.md (Read-Day-Output, 15 Lehren)

Pre-Flight für Phase 2 (Auth-Föderation): DNS cardecky.mana.how,
GitHub-Repo mana-ev/cards, Cards-App-Registrierung in mana-auth,
NPM_AUTH_TOKEN für Verdaccio.

Plan: mana/docs/playbooks/CARDS_GREENFIELD.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

apps/api/src/db/schema/index.ts

@@ -0,0 +1,13 @@
+// Drizzle-Schemas für die `cards`-Datenbank.
+//
+// Phase-3-Aufgabe (siehe CARDS_GREENFIELD.md): hier landen
+// `decks`, `cards`, `reviews`, `study_sessions`, `tags`, `media_refs`,
+// `import_jobs` als pgSchema('cards').table(...) Definitionen.
+//
+// Schema-Skizze in mana/docs/playbooks/CARDS_GREENFIELD.md §"Drizzle-Schema-Skizze".
+// Card-Type-Granularität (subIndex pro Karte) aus
+// docs/LESSONS_FROM_MANA_MONOREPO.md mitnehmen.
+
+import { pgSchema } from 'drizzle-orm/pg-core';
+
+export const cardsSchema = pgSchema('cards');

apps/api/src/index.ts

@@ -0,0 +1,26 @@
+import { Hono } from 'hono';
+
+import { manifestRoute } from './routes/manifest.ts';
+import { healthRoute } from './routes/health.ts';
+
+const app = new Hono();
+
+app.route('/', healthRoute);
+app.route('/.well-known/mana-app.json', manifestRoute);
+
+app.get('/', (c) =>
+	c.json({
+		app: 'cards',
+		version: process.env.CARDS_API_VERSION ?? '0.0.0',
+		see: '/.well-known/mana-app.json',
+	})
+);
+
+const port = Number(process.env.CARDS_API_PORT ?? 3081);
+
+console.log(`[cards-api] listening on http://localhost:${port}`);
+
+export default {
+	port,
+	fetch: app.fetch,
+};

apps/api/src/routes/health.ts

@@ -0,0 +1,27 @@
+import { Hono } from 'hono';
+
+export const healthRoute = new Hono();
+
+healthRoute.get('/healthz', (c) => c.json({ status: 'ok' }));
+
+healthRoute.get('/healthz/details', (c) =>
+	c.json({
+		status: 'ok',
+		app: 'cards',
+		version: process.env.CARDS_API_VERSION ?? '0.0.0',
+		uptime_s: Math.floor(process.uptime()),
+		mana_packages: {
+			// In Phase 5 mit @mana/shared-app-tpl ersetzen.
+			'@mana/shared-share-protocol': 'TBD',
+			'@mana/shared-app-tpl': 'TBD',
+		},
+	})
+);
+
+healthRoute.get('/version', (c) =>
+	c.json({
+		app: 'cards',
+		version: process.env.CARDS_API_VERSION ?? '0.0.0',
+		build: process.env.CARDS_BUILD_SHA ?? 'dev',
+	})
+);

apps/api/src/routes/manifest.ts

@@ -0,0 +1,7 @@
+import { Hono } from 'hono';
+
+import manifest from '../../../../app-manifest.json' with { type: 'json' };
+
+export const manifestRoute = new Hono();
+
+manifestRoute.get('/', (c) => c.json(manifest));