# Deutsch Dossier - Full LLM Access

## Purpose
Deutsch Dossier is a German learning application (A2 to B2) with guided sessions, missions, grammar, writing, dictation, challenges, social crew progress, and class mode.

## Discovery
- AI manifest: `/api/ai/manifest`
- Full content catalog: `/ai/catalog.json`
- Content summary: `/ai/catalog.md`
- Well-known LLM index: `/.well-known/llms.txt`
- Crawl files: `/robots.txt` and `/sitemap.xml`
- OpenAPI: `/openapi.json`
- Plugin descriptor: `/.well-known/ai-plugin.json`

## Authentication
Two auth options exist for protected actions:

1. Cookie session:
- `POST /api/auth/register`
- `POST /api/auth/login`
- then call protected endpoints with session cookie

2. Bearer token (LLM/agent friendly):
- Create token in UI (`/settings`) or API (`POST /api/tokens/create`)
- Call protected endpoints with:
  `Authorization: Bearer dd_pat_...`

Token management:
- `GET /api/tokens/list`
- `POST /api/tokens/create`
- `POST /api/tokens/revoke`

## Protected Action APIs
- `GET /api/me`
- `GET /api/progress/pull`
- `POST /api/progress/push`
- `GET /api/rooms/my`
- `POST /api/rooms/create`
- `POST /api/rooms/join`
- `GET /api/rooms/{code}/leaderboard`
- `GET /api/rooms/{code}/member/{handle}`
- `GET /api/tts/status`
- `POST /api/tts`

## Human UI Routes
- `/session`: daily guided sequence
- `/path`: A2->B2 structured path
- `/explore`: feature map
- `/search`: global search
- `/missions`: scenario learning
- `/grammar`: grammar drills
- `/write`: writing studio
- `/dictation`: listening+typing practice
- `/challenge`: daily challenge
- `/endless`: procedural infinite practice
- `/race`: crew board
- `/class`: classroom board
- `/settings`: profile, sync, auth, LLM tokens