# Report Playwright Page Header Footer Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Make both exam sprint PDF reports render the report header on every page, format generated time as Beijing local time, and show `current page / total pages` in the footer.

**Architecture:** Keep the existing report HTML templates as the source of header content, but teach the Playwright PDF worker to extract that `.report-header` markup and pass it to Chromium's native `displayHeaderFooter` templates. Format `Instant generatedAt` in each renderer with `Asia/Shanghai` and `yyyy-MM-dd HH:mm:ss`.

**Tech Stack:** Java, Playwright Java, Chromium PDF, JUnit 5, AssertJ, PDFBox.

---

### Task 1: Renderer Generated Time Format

**Files:**
- Modify: `abilities/exam-sprint/infrastructure/src/test/java/cn/yunzhixue/ability/center/examsprint/infrastructure/report/rendering/achievement/ClasspathAchievementExamSprintReportRendererTest.java`
- Modify: `abilities/exam-sprint/infrastructure/src/test/java/cn/yunzhixue/ability/center/examsprint/infrastructure/report/rendering/outlook/ClasspathOutlookExamSprintReportRendererTest.java`
- Modify: `abilities/exam-sprint/infrastructure/src/main/java/cn/yunzhixue/ability/center/examsprint/infrastructure/report/rendering/achievement/ClasspathAchievementExamSprintReportRenderer.java`
- Modify: `abilities/exam-sprint/infrastructure/src/main/java/cn/yunzhixue/ability/center/examsprint/infrastructure/report/rendering/outlook/ClasspathOutlookExamSprintReportRenderer.java`

- [ ] **Step 1: Write failing renderer tests**

Add assertions that rendered HTML contains `2026-05-13 10:08:54` and does not contain `2026-05-13T02:08:54.657335Z` for both report renderers.

- [ ] **Step 2: Run renderer tests to verify RED**

Run: `./mvnw -pl abilities/exam-sprint/infrastructure -Dtest=ClasspathAchievementExamSprintReportRendererTest,ClasspathOutlookExamSprintReportRendererTest test`

Expected: FAIL because current renderer uses `Instant.toString()`.

- [ ] **Step 3: Implement Beijing time formatter**

Use `DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").withZone(ZoneId.of("Asia/Shanghai"))` in both renderers.

- [ ] **Step 4: Run renderer tests to verify GREEN**

Run the same Maven command. Expected: PASS.

### Task 2: Playwright Native Header and Footer

**Files:**
- Modify: `abilities/exam-sprint/infrastructure/src/test/java/cn/yunzhixue/ability/center/examsprint/infrastructure/report/pdf/PlaywrightExamSprintReportPdfGeneratorTest.java`
- Modify: `abilities/exam-sprint/infrastructure/src/main/java/cn/yunzhixue/ability/center/examsprint/infrastructure/report/pdf/DefaultPlaywrightPdfWorker.java`

- [ ] **Step 1: Write failing PDF test**

Add a multi-page HTML test with `.report-header`, generate PDF, and assert extracted text contains repeated header text and footer page text such as `1/2` and `2/2` after whitespace normalization.

- [ ] **Step 2: Run PDF test to verify RED**

Run: `./mvnw -pl abilities/exam-sprint/infrastructure -Dtest=PlaywrightExamSprintReportPdfGeneratorTest#generateRepeatsReportHeaderAndFooterPageNumbers test`

Expected: FAIL because Playwright header/footer are not configured.

- [ ] **Step 3: Implement PDF options**

In both `page.pdf(...)` call sites, call a shared method returning `Page.PdfOptions` with `displayHeaderFooter=true`, a header template built from the source `.report-header`, a footer template with `<span class="pageNumber"></span> / <span class="totalPages"></span>`, and top/bottom margins that reserve space.

- [ ] **Step 4: Run PDF test to verify GREEN**

Run the same Maven single-test command. Expected: PASS.

### Task 3: Full Relevant Verification

**Files:**
- No production files beyond Task 1 and Task 2.

- [ ] **Step 1: Run all relevant infrastructure tests**

Run: `./mvnw -pl abilities/exam-sprint/infrastructure test`

Expected: PASS.

- [ ] **Step 2: Review diff**

Run: `git diff -- abilities/exam-sprint/infrastructure docs/superpowers/plans/2026-05-13-report-playwright-page-header-footer.md`

Expected: only intended renderer, PDF worker, tests, and plan changes.