Phase 8: CSV + ICS export, print view, MkDocs docs, SBOM + dev-mode auth

Auth (Test-Mode):
  - middleware.AuthMiddleware now takes a devMode flag. In dev,
    requests without Authorization fall back to a deterministic dev
    UUID (00000000-...-001) and role=teacher. ENVIRONMENT=production
    re-enables the strict 401 path.
  - main.go wires devMode = cfg.Environment != "production".
  - page.tsx replaces the red 'Anmeldung noch nicht integriert' banner
    with a softer Testumgebung notice; the manual-token form moves
    behind a nested details block.

Export endpoints (school-service):
  - LoadExportLessons joins tt_lesson with tt_period for wall-clock
    times; one query feeds both CSV and ICS.
  - WriteCSV streams 10 columns including pinned flag.
  - WriteICS emits one VEVENT per lesson anchored to a Monday — caller
    overridable via ?start=YYYY-MM-DD. RFC 5545 escapes for ',', ';',
    '\n' in icsEscape().
  - NextMonday helper for the default anchor.
  - GET /timetable/solutions/:id/export.{csv,ics} handlers attach
    Content-Disposition: attachment so browsers download instead of
    rendering.

Frontend:
  - lib/stundenplan/api.ts downloadSolutionExport() fetches as blob,
    triggers a synthetic <a download> click, and forwards the JWT when
    present.
  - PlanView gains CSV / ICS / Drucken buttons next to the perspective
    selector. The toolbar carries class 'no-print' so window.print()
    yields only the grid.
  - globals.css @media print rule hides chrome, forces white
    background, gives the table proper borders for A4.

Docs:
  - docs-src/services/stundenplan/{index,architecture,constraints,
    solver-tuning,export}.md with nav entry in mkdocs.yml under
    Services → Stundenplaner.
  - sbom/stundenplan/README.md lists manually-verified key dependencies
    and the policy reference. scripts/stundenplan-sbom.sh generates
    full machine-readable inventories via go-licenses + pip-licenses
    + license-checker when those tools are available.

Tests:
  - internal/services/timetable_exports_test.go: 4 unit tests covering
    CSV column layout + quoting, ICS structure + DTSTART formatting,
    icsEscape special chars, NextMonday weekday math.
  - studio-v2/e2e/stundenplan-export.spec.ts split out of the main spec
    file (LOC budget) — 3 tests for button render, CSV download,
    ICS download.
  - mockSchoolApi extended with export.csv + export.ics routes.

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

studio-v2/e2e/_helpers.ts

@@ -128,6 +128,21 @@ export async function mockSchoolApi(page: Page, opts: MockOpts = {}) {
       body: JSON.stringify({ message: 'ok', pinned: body.pinned ?? false }),
     })
   })
+  // Phase 8: CSV + ICS exports. Routed BEFORE the generic /solutions/:id
+  // catch-all so the .csv / .ics suffix path is matched first.
+  await page.route(/\/api\/school\/timetable\/solutions\/[^/]+\/export\.csv$/, async (route) => {
+    return route.fulfill({
+      status: 200, contentType: 'text/csv',
+      body: 'day_of_week,period_index,start_time,end_time,class,subject,subject_code,teacher,room,pinned\n1,1,08:00,08:45,5a,Mathe,M,"Schmidt, Anna",A101,false\n',
+    })
+  })
+  await page.route(/\/api\/school\/timetable\/solutions\/[^/]+\/export\.ics(\?.*)?$/, async (route) => {
+    return route.fulfill({
+      status: 200, contentType: 'text/calendar',
+      body: 'BEGIN:VCALENDAR\r\nVERSION:2.0\r\nEND:VCALENDAR\r\n',
+    })
+  })
+
   await page.route(/\/api\/school\/timetable\/solutions\/[^/]+$/, async (route) => {
     if (route.request().method() === 'DELETE') {
       return route.fulfill({ status: 200, contentType: 'application/json', body: '{"message":"deleted"}' })

studio-v2/e2e/stundenplan-export.spec.ts

@@ -0,0 +1,51 @@
+import { test, expect } from '@playwright/test'
+import { mockSchoolApi } from './_helpers'
+
+/**
+ * E2E tests for the Phase 8 export functionality on /stundenplan.
+ * Split into its own file so stundenplan.spec.ts stays under the 500 LOC
+ * budget enforced by the pre-commit hook.
+ */
+
+const exportOpts = () => ({
+  solutions: [
+    { id: 's1', created_by_user_id: 'u', name: 'Plan A', status: 'completed', hard_score: 0, soft_score: 0, created_at: '2026-05-22T10:00:00Z' },
+  ],
+  lessons: [
+    { id: 'l1', solution_id: 's1', class_id: 'c1', subject_id: 'sub1', teacher_id: 't1', room_id: 'r1', day_of_week: 1, period_index: 1, pinned: false, created_at: '', class_name: '5a', subject_name: 'Mathe', teacher_name: 'Schmidt, Anna', room_name: 'A101' },
+  ],
+})
+
+test.describe('Stundenplan — Export buttons', () => {
+  test('export buttons are rendered on the PlanView', async ({ page }) => {
+    await mockSchoolApi(page, exportOpts())
+    await page.goto('/stundenplan')
+    await page.waitForLoadState('networkidle')
+    await page.getByRole('button', { name: 'Anzeigen' }).click()
+    await expect(page.getByTestId('export-csv')).toBeVisible()
+    await expect(page.getByTestId('export-ics')).toBeVisible()
+    await expect(page.getByTestId('export-print')).toBeVisible()
+  })
+
+  test('CSV download triggers a fetch to export.csv', async ({ page }) => {
+    await mockSchoolApi(page, exportOpts())
+    await page.goto('/stundenplan')
+    await page.waitForLoadState('networkidle')
+    await page.getByRole('button', { name: 'Anzeigen' }).click()
+    const downloadPromise = page.waitForEvent('download')
+    await page.getByTestId('export-csv').click()
+    const download = await downloadPromise
+    expect(download.suggestedFilename()).toContain('.csv')
+  })
+
+  test('ICS download triggers a fetch to export.ics', async ({ page }) => {
+    await mockSchoolApi(page, exportOpts())
+    await page.goto('/stundenplan')
+    await page.waitForLoadState('networkidle')
+    await page.getByRole('button', { name: 'Anzeigen' }).click()
+    const downloadPromise = page.waitForEvent('download')
+    await page.getByTestId('export-ics').click()
+    const download = await downloadPromise
+    expect(download.suggestedFilename()).toContain('.ics')
+  })
+})

studio-v2/e2e/stundenplan.spec.ts

@@ -41,8 +41,9 @@ test.describe('Stundenplan — Page Shell', () => {
     await expect(page.getByTestId('plan-hub')).toBeVisible()
   })
 
-  test('JWT dev field exists and persists into localStorage', async ({ page }) => {
-    await page.getByText('Anmeldung noch nicht integriert').click()
+  test('Dev mode banner is collapsed by default; manual token still available', async ({ page }) => {
+    await page.getByText('Testumgebung — Anmeldung deaktiviert').click()
+    await page.getByText('Manueller Token').click()
     await page.getByPlaceholder(/Bearer-Token/).fill('test-jwt-abc')
     await page.getByRole('button', { name: 'Speichern' }).click()
     const stored = await page.evaluate(() => localStorage.getItem('bp_stundenplan_jwt'))