# Incident Report PDF 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:** Add a "Print Report" button on closed incidents that generates and downloads a comprehensive PDF covering all incident sections. **Architecture:** Three-layer: a pure PDF builder function (`lib/pdf/incident-report.ts`), a new API route (`app/api/incidents/[id]/report-pdf/route.ts`) that fetches all data and streams the PDF, and a button added to the HSE incident detail page visible only when `status === 'closed'`. Follows the exact same pattern as `lib/pdf/jkkp.ts` + `app/api/incidents/[id]/jkkp-pdf/route.ts`. **Tech Stack:** pdf-lib (already installed), Drizzle ORM (`withUser`), Next.js App Router API route, TypeScript. ## Global Constraints - Every DB query goes through `withUser(session.sub, tx => ...)` for RLS (not `asAdmin` — the viewer must be permitted to see the incident). - No `.env` or secrets committed. - Access restricted to roles `hse` and `admin` only (same as JKKP PDF route). - `pdf-lib` is already in `package.json` — do not add new dependencies. - Project root: `/Users/yapweeihan/Desktop/Projects/IMS.nosync` - PDF must only be generated when `incident.status === 'closed'`; return 403 otherwise. - Audit log: no audit entry needed for PDF download (read-only operation). --- ### Task 1: Pure PDF builder — `lib/pdf/incident-report.ts` **Files:** - Create: `lib/pdf/incident-report.ts` - Create: `tests/lib/pdf/incident-report.test.ts` **Interfaces:** - Produces: `buildIncidentReportPdf(data: IncidentReportData): Promise` - Produces type: `IncidentReportData` (imported by Task 2's route) **PDF sections (in order):** 1. Header — title "INCIDENT INVESTIGATION REPORT", reference no, generated date 2. Incident Details — type, date, site, zone, reporter, severity, medical status, description 3. Triage — notes, triaged by, triaged at (skip section if `triagedBy` is null) 4. Investigation — method, findings text, root cause summary, alcohol test, urine test 5. CAPA Actions — one block per CAPA: description, owner, department, due date, priority, status, owner notes 6. Addenda — one block per addendum: author, date, body 7. Closure — closed at timestamp 8. Footer — "Generated by IMS — Confidential" - [ ] **Step 1: Write the failing test** Create `tests/lib/pdf/incident-report.test.ts`: ```typescript import { describe, it, expect } from 'vitest' import { buildIncidentReportPdf, type IncidentReportData } from '@/lib/pdf/incident-report' const MOCK: IncidentReportData = { referenceNo: 'SC1-202607-0001', incidentType: 'injury', reportedAt: '2026-07-01T08:00:00.000Z', siteName: 'Setia Warehouse KL', zoneName: 'Loading Bay A', reporterName: 'Ahmad Bin Ali', severity: 3, medicalStatus: 'first_aid', description: 'Worker slipped on wet floor near loading bay.', injuryInvolved: true, assetInvolved: false, isFatality: false, isSeriousBodilyInjury: false, isDangerousOccurrence: false, isOccupationalDisease: false, lostDays: null, triagedBy: 'Supervisor Tan', triagedAt: '2026-07-01T10:00:00.000Z', triageNotes: 'Reviewed on-site. First aid applied.', investigation: { method: 'five_why', findingsText: 'Floor was wet due to a leaking pipe.', rootCauseSummary: 'Maintenance backlog on pipe inspection.', alcoholTestResult: 'negative', urineTestResult: 'negative', }, capas: [ { description: 'Install non-slip mats in loading bay.', ownerName: 'Maintenance Dept', department: 'Maintenance', dueDate: '2026-07-15', priority: 'high', status: 'closed', completedAt: '2026-07-14T09:00:00.000Z', ownerNotes: 'Mats installed and inspected.', }, ], addenda: [ { authorName: 'HSE Officer Lim', createdAt: '2026-07-20T14:00:00.000Z', body: 'Follow-up inspection passed. Area cleared.', }, ], closedAt: '2026-07-20T15:00:00.000Z', } describe('buildIncidentReportPdf', () => { it('returns a Uint8Array starting with PDF magic bytes', async () => { const result = await buildIncidentReportPdf(MOCK) expect(result).toBeInstanceOf(Uint8Array) // PDF files start with %PDF const header = String.fromCharCode(...result.slice(0, 4)) expect(header).toBe('%PDF') }) it('handles incident with no investigation, CAPAs, or addenda', async () => { const minimal: IncidentReportData = { ...MOCK, triagedBy: null, triagedAt: null, triageNotes: null, investigation: null, capas: [], addenda: [], } const result = await buildIncidentReportPdf(minimal) expect(result).toBeInstanceOf(Uint8Array) const header = String.fromCharCode(...result.slice(0, 4)) expect(header).toBe('%PDF') }) }) ``` - [ ] **Step 2: Run test — verify it fails** ```bash cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npx vitest run tests/lib/pdf/incident-report.test.ts ``` Expected: FAIL — `Cannot find module '@/lib/pdf/incident-report'` - [ ] **Step 3: Implement `lib/pdf/incident-report.ts`** ```typescript import { PDFDocument, StandardFonts, rgb } from 'pdf-lib' export type IncidentReportData = { referenceNo: string | null incidentType: string reportedAt: string siteName: string zoneName: string | null reporterName: string severity: number | null medicalStatus: string | null description: string injuryInvolved: boolean assetInvolved: boolean isFatality: boolean isSeriousBodilyInjury: boolean isDangerousOccurrence: boolean isOccupationalDisease: boolean lostDays: number | null triagedBy: string | null triagedAt: string | null triageNotes: string | null investigation: { method: string findingsText: string | null rootCauseSummary: string | null alcoholTestResult: string | null urineTestResult: string | null } | null capas: Array<{ description: string ownerName: string department: string dueDate: string priority: string status: string completedAt: string | null ownerNotes: string | null }> addenda: Array<{ authorName: string createdAt: string body: string }> closedAt: string | null } type EmbeddedFont = Awaited> type Page = ReturnType const MARGIN = 50 const PAGE_WIDTH = 595 const PAGE_HEIGHT = 842 const BODY_FONT_SIZE = 10 const LABEL_FONT_SIZE = 9 const SECTION_FONT_SIZE = 11 const LINE_HEIGHT = 16 const SECTION_GAP = 20 const BOTTOM_MARGIN = 60 type State = { doc: PDFDocument pages: Page[] font: EmbeddedFont boldFont: EmbeddedFont y: number } function currentPage(state: State): Page { return state.pages[state.pages.length - 1] } function newPage(state: State): void { const page = state.doc.addPage([PAGE_WIDTH, PAGE_HEIGHT]) state.pages.push(page) state.y = PAGE_HEIGHT - MARGIN } function ensureSpace(state: State, needed: number): void { if (state.y - needed < BOTTOM_MARGIN) newPage(state) } function wrapText(text: string, maxWidth: number, font: EmbeddedFont, size: number): string[] { const words = text.split(' ') const lines: string[] = [] let current = '' for (const word of words) { const test = current ? `${current} ${word}` : word if (font.widthOfTextAtSize(test, size) > maxWidth && current) { lines.push(current) current = word } else { current = test } } if (current) lines.push(current) return lines.length ? lines : [''] } function drawSection(state: State, title: string): void { ensureSpace(state, SECTION_GAP + LINE_HEIGHT + 6) state.y -= SECTION_GAP currentPage(state).drawRectangle({ x: MARGIN, y: state.y - 4, width: PAGE_WIDTH - MARGIN * 2, height: LINE_HEIGHT + 4, color: rgb(0.9, 0.95, 0.9), }) currentPage(state).drawText(title.toUpperCase(), { x: MARGIN + 4, y: state.y, size: SECTION_FONT_SIZE, font: state.boldFont, color: rgb(0.05, 0.4, 0.1), }) state.y -= LINE_HEIGHT + 8 } function drawField(state: State, label: string, value: string | null): void { const v = value ?? '—' const maxW = PAGE_WIDTH - MARGIN * 2 - 120 const lines = wrapText(v, maxW, state.font, BODY_FONT_SIZE) ensureSpace(state, (lines.length + 1) * LINE_HEIGHT) currentPage(state).drawText(label + ':', { x: MARGIN, y: state.y, size: LABEL_FONT_SIZE, font: state.boldFont, color: rgb(0.3, 0.3, 0.3), }) for (const line of lines) { currentPage(state).drawText(line, { x: MARGIN + 120, y: state.y, size: BODY_FONT_SIZE, font: state.font, color: rgb(0, 0, 0), }) state.y -= LINE_HEIGHT } if (lines.length === 0) state.y -= LINE_HEIGHT } function fmt(iso: string | null): string { if (!iso) return '—' return new Date(iso).toLocaleString('en-MY', { timeZone: 'Asia/Kuala_Lumpur', hour12: false }) } function fmtDate(iso: string | null): string { if (!iso) return '—' return new Date(iso).toLocaleDateString('en-MY', { timeZone: 'Asia/Kuala_Lumpur' }) } export async function buildIncidentReportPdf(data: IncidentReportData): Promise { const doc = await PDFDocument.create() const font = await doc.embedFont(StandardFonts.Helvetica) const boldFont = await doc.embedFont(StandardFonts.HelveticaBold) const firstPage = doc.addPage([PAGE_WIDTH, PAGE_HEIGHT]) const state: State = { doc, pages: [firstPage], font, boldFont, y: PAGE_HEIGHT - MARGIN } // ── Header ────────────────────────────────────────────────────────────── currentPage(state).drawText('INCIDENT INVESTIGATION REPORT', { x: MARGIN, y: state.y, size: 16, font: boldFont, color: rgb(0.05, 0.4, 0.1), }) state.y -= 22 currentPage(state).drawText(`Reference: ${data.referenceNo ?? '—'}`, { x: MARGIN, y: state.y, size: 10, font, color: rgb(0.2, 0.2, 0.2), }) currentPage(state).drawText(`Generated: ${fmt(new Date().toISOString())}`, { x: PAGE_WIDTH - MARGIN - 160, y: state.y, size: 10, font, color: rgb(0.2, 0.2, 0.2), }) state.y -= 6 currentPage(state).drawLine({ start: { x: MARGIN, y: state.y }, end: { x: PAGE_WIDTH - MARGIN, y: state.y }, thickness: 1.5, color: rgb(0.05, 0.4, 0.1), }) state.y -= 12 // ── Incident Details ───────────────────────────────────────────────────── drawSection(state, 'Incident Details') drawField(state, 'Type', data.incidentType.replace(/_/g, ' ')) drawField(state, 'Reported At', fmt(data.reportedAt)) drawField(state, 'Site', data.siteName) drawField(state, 'Zone', data.zoneName) drawField(state, 'Reported By', data.reporterName) drawField(state, 'Severity', data.severity !== null ? String(data.severity) + ' / 5' : null) drawField(state, 'Medical Status', data.medicalStatus?.replace(/_/g, ' ') ?? null) drawField(state, 'Injury Involved', data.injuryInvolved ? 'Yes' : 'No') drawField(state, 'Asset Involved', data.assetInvolved ? 'Yes' : 'No') drawField(state, 'Fatality', data.isFatality ? 'Yes' : 'No') drawField(state, 'Serious Bodily Injury', data.isSeriousBodilyInjury ? 'Yes' : 'No') drawField(state, 'Dangerous Occurrence', data.isDangerousOccurrence ? 'Yes' : 'No') drawField(state, 'Occupational Disease', data.isOccupationalDisease ? 'Yes' : 'No') drawField(state, 'Lost Days', data.lostDays !== null ? String(data.lostDays) : null) drawField(state, 'Description', data.description) // ── Triage ─────────────────────────────────────────────────────────────── if (data.triagedBy) { drawSection(state, 'Triage') drawField(state, 'Triaged By', data.triagedBy) drawField(state, 'Triaged At', fmt(data.triagedAt)) drawField(state, 'Triage Notes', data.triageNotes) } // ── Investigation ──────────────────────────────────────────────────────── if (data.investigation) { const inv = data.investigation drawSection(state, 'Investigation') drawField(state, 'Method', inv.method.replace(/_/g, ' ')) drawField(state, 'Findings', inv.findingsText) drawField(state, 'Root Cause', inv.rootCauseSummary) drawField(state, 'Alcohol Test', inv.alcoholTestResult) drawField(state, 'Urine Test', inv.urineTestResult) } // ── CAPA Actions ───────────────────────────────────────────────────────── if (data.capas.length > 0) { drawSection(state, `CAPA Actions (${data.capas.length})`) for (let i = 0; i < data.capas.length; i++) { const c = data.capas[i] ensureSpace(state, LINE_HEIGHT) currentPage(state).drawText(`#${i + 1}`, { x: MARGIN, y: state.y, size: BODY_FONT_SIZE, font: boldFont, color: rgb(0, 0, 0), }) state.y -= LINE_HEIGHT drawField(state, 'Action', c.description) drawField(state, 'Owner', c.ownerName) drawField(state, 'Department', c.department) drawField(state, 'Due Date', fmtDate(c.dueDate)) drawField(state, 'Priority', c.priority.toUpperCase()) drawField(state, 'Status', c.status.replace(/_/g, ' ')) if (c.completedAt) drawField(state, 'Completed At', fmt(c.completedAt)) if (c.ownerNotes) drawField(state, 'Owner Notes', c.ownerNotes) state.y -= 8 } } // ── Addenda ────────────────────────────────────────────────────────────── if (data.addenda.length > 0) { drawSection(state, `Addenda (${data.addenda.length})`) for (const a of data.addenda) { drawField(state, 'Author', a.authorName) drawField(state, 'Date', fmt(a.createdAt)) drawField(state, 'Note', a.body) state.y -= 8 } } // ── Closure ────────────────────────────────────────────────────────────── drawSection(state, 'Closure') drawField(state, 'Closed At', fmt(data.closedAt)) // ── Footer on all pages ────────────────────────────────────────────────── for (const page of state.pages) { page.drawText('Generated by IMS — Confidential', { x: MARGIN, y: 30, size: 8, font, color: rgb(0.5, 0.5, 0.5), }) page.drawLine({ start: { x: MARGIN, y: 42 }, end: { x: PAGE_WIDTH - MARGIN, y: 42 }, thickness: 0.5, color: rgb(0.8, 0.8, 0.8), }) } return doc.save() } ``` - [ ] **Step 4: Run test — verify it passes** ```bash cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npx vitest run tests/lib/pdf/incident-report.test.ts ``` Expected: PASS — 2 tests pass - [ ] **Step 5: Commit** ```bash git add lib/pdf/incident-report.ts tests/lib/pdf/incident-report.test.ts git commit -m "feat(pdf): add incident report PDF builder" ``` --- ### Task 2: API route — `app/api/incidents/[id]/report-pdf/route.ts` **Files:** - Create: `app/api/incidents/[id]/report-pdf/route.ts` **Interfaces:** - Consumes: `buildIncidentReportPdf`, `IncidentReportData` from `@/lib/pdf/incident-report` - Consumes: Drizzle tables: `incidents`, `sites`, `zones`, `users`, `investigations`, `capaActions`, `incidentAddenda` - Produces: `GET /api/incidents/[id]/report-pdf` → `application/pdf` download (or 401/403/404/400) **Access rules:** - Session required (401 if missing) - Roles `hse` and `admin` only (403 otherwise) - Incident must exist (404 if not) - Incident must have `status === 'closed'` (400 with `{ error: 'Incident is not closed' }` otherwise) - [ ] **Step 1: Write the failing test** Create `tests/app/api/incidents/report-pdf.test.ts`: ```typescript import { describe, it, expect, vi, beforeEach } from 'vitest' // Mock auth vi.mock('@/lib/auth/get-session', () => ({ getSession: vi.fn(), })) // Mock db vi.mock('@/lib/db/with-user', () => ({ withUser: vi.fn(), })) // Mock pdf builder vi.mock('@/lib/pdf/incident-report', () => ({ buildIncidentReportPdf: vi.fn().mockResolvedValue(new Uint8Array([37, 80, 68, 70])), // %PDF })) import { GET } from '@/app/api/incidents/[id]/report-pdf/route' import { getSession } from '@/lib/auth/get-session' import { withUser } from '@/lib/db/with-user' import { buildIncidentReportPdf } from '@/lib/pdf/incident-report' import { NextRequest } from 'next/server' const mockSession = { sub: 'user-1', role: 'hse' as const } const MOCK_INCIDENT = { id: 'inc-1', referenceNo: 'SC1-202607-0001', incidentType: 'injury', reportedAt: new Date('2026-07-01T08:00:00Z'), status: 'closed', siteName: 'Warehouse KL', zoneName: 'Bay A', reporterName: 'Ahmad', severity: 3, medicalStatus: 'first_aid', description: 'Slip and fall', injuryInvolved: true, assetInvolved: false, isFatality: false, isSeriousBodilyInjury: false, isDangerousOccurrence: false, isOccupationalDisease: false, lostDays: null, triagedBy: 'Supervisor', triagedAt: new Date('2026-07-01T10:00:00Z'), triageNotes: 'Reviewed', closedAt: new Date('2026-07-20T15:00:00Z'), } function makeRequest(id: string) { return new NextRequest(`http://localhost/api/incidents/${id}/report-pdf`) } beforeEach(() => { vi.clearAllMocks() }) describe('GET /api/incidents/[id]/report-pdf', () => { it('returns 401 when not authenticated', async () => { vi.mocked(getSession).mockResolvedValue(null) const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) }) expect(res.status).toBe(401) }) it('returns 403 for non-hse/admin roles', async () => { vi.mocked(getSession).mockResolvedValue({ ...mockSession, role: 'reporter' as never }) const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) }) expect(res.status).toBe(403) }) it('returns 404 when incident not found', async () => { vi.mocked(getSession).mockResolvedValue(mockSession) vi.mocked(withUser).mockResolvedValue([[], [], [], []]) const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) }) expect(res.status).toBe(404) }) it('returns 400 when incident is not closed', async () => { vi.mocked(getSession).mockResolvedValue(mockSession) vi.mocked(withUser).mockResolvedValue([[{ ...MOCK_INCIDENT, status: 'investigating' }], [], [], []]) const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) }) expect(res.status).toBe(400) }) it('returns PDF with correct headers for a closed incident', async () => { vi.mocked(getSession).mockResolvedValue(mockSession) vi.mocked(withUser).mockResolvedValue([[MOCK_INCIDENT], [], [], []]) const res = await GET(makeRequest('inc-1'), { params: Promise.resolve({ id: 'inc-1' }) }) expect(res.status).toBe(200) expect(res.headers.get('Content-Type')).toBe('application/pdf') expect(res.headers.get('Content-Disposition')).toContain('SC1-202607-0001') expect(buildIncidentReportPdf).toHaveBeenCalledOnce() }) }) ``` - [ ] **Step 2: Run test — verify it fails** ```bash cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npx vitest run tests/app/api/incidents/report-pdf.test.ts ``` Expected: FAIL — `Cannot find module '@/app/api/incidents/[id]/report-pdf/route'` - [ ] **Step 3: Implement the route** Create `app/api/incidents/[id]/report-pdf/route.ts`: ```typescript export const dynamic = 'force-dynamic' import { NextRequest, NextResponse } from 'next/server' import { aliasedTable, eq } from 'drizzle-orm' import { getSession } from '@/lib/auth/get-session' import { withUser } from '@/lib/db/with-user' import { incidents, sites, zones, users, investigations, capaActions, incidentAddenda } from '@/lib/db/schema' import { buildIncidentReportPdf } from '@/lib/pdf/incident-report' export async function GET( _req: NextRequest, { params }: { params: Promise<{ id: string }> } ) { const { id } = await params const session = await getSession() if (!session) return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }) if (!['hse', 'admin'].includes(session.role)) return NextResponse.json({ error: 'Forbidden' }, { status: 403 }) const reporterAlias = aliasedTable(users, 'reporter') const triagedByAlias = aliasedTable(users, 'triaged_by_user') const ownerAlias = aliasedTable(users, 'capa_owner') const addendaAuthorAlias = aliasedTable(users, 'addenda_author') const [incidentRows, investigationRows, capaRows, addendaRows] = await withUser( session.sub, async tx => Promise.all([ tx.select({ id: incidents.id, referenceNo: incidents.referenceNo, incidentType: incidents.incidentType, reportedAt: incidents.reportedAt, status: incidents.status, siteName: sites.name, zoneName: zones.name, reporterName: reporterAlias.name, severity: incidents.severity, medicalStatus: incidents.medicalStatus, description: incidents.description, injuryInvolved: incidents.injuryInvolved, assetInvolved: incidents.assetInvolved, isFatality: incidents.isFatality, isSeriousBodilyInjury: incidents.isSeriousBodilyInjury, isDangerousOccurrence: incidents.isDangerousOccurrence, isOccupationalDisease: incidents.isOccupationalDisease, lostDays: incidents.lostDays, triagedByName: triagedByAlias.name, triagedAt: incidents.triagedAt, triageNotes: incidents.triageNotes, closedAt: incidents.closedAt, }) .from(incidents) .leftJoin(sites, eq(incidents.siteId, sites.id)) .leftJoin(zones, eq(incidents.zoneId, zones.id)) .leftJoin(reporterAlias, eq(incidents.reportedBy, reporterAlias.id)) .leftJoin(triagedByAlias, eq(incidents.triagedBy, triagedByAlias.id)) .where(eq(incidents.id, id)) .limit(1), tx.select({ method: investigations.method, findingsText: investigations.findingsText, rootCauseSummary: investigations.rootCauseSummary, alcoholTestResult: investigations.alcoholTestResult, urineTestResult: investigations.urineTestResult, }) .from(investigations) .where(eq(investigations.incidentId, id)) .limit(1), tx.select({ description: capaActions.description, ownerName: ownerAlias.name, department: capaActions.department, dueDate: capaActions.dueDate, priority: capaActions.priority, status: capaActions.status, completedAt: capaActions.completedAt, ownerNotes: capaActions.ownerNotes, }) .from(capaActions) .leftJoin(ownerAlias, eq(capaActions.ownerUserId, ownerAlias.id)) .where(eq(capaActions.incidentId, id)), tx.select({ body: incidentAddenda.body, createdAt: incidentAddenda.createdAt, authorName: addendaAuthorAlias.name, }) .from(incidentAddenda) .leftJoin(addendaAuthorAlias, eq(incidentAddenda.author, addendaAuthorAlias.id)) .where(eq(incidentAddenda.incidentId, id)), ]) ) const incident = incidentRows[0] if (!incident) return NextResponse.json({ error: 'Not found' }, { status: 404 }) if (incident.status !== 'closed') return NextResponse.json({ error: 'Incident is not closed' }, { status: 400 }) const inv = investigationRows[0] ?? null const pdfBytes = await buildIncidentReportPdf({ referenceNo: incident.referenceNo, incidentType: incident.incidentType, reportedAt: incident.reportedAt instanceof Date ? incident.reportedAt.toISOString() : (incident.reportedAt as string), siteName: incident.siteName ?? 'Unknown', zoneName: incident.zoneName ?? null, reporterName: incident.reporterName ?? 'Unknown', severity: incident.severity ?? null, medicalStatus: incident.medicalStatus ?? null, description: incident.description, injuryInvolved: incident.injuryInvolved, assetInvolved: incident.assetInvolved, isFatality: incident.isFatality, isSeriousBodilyInjury: incident.isSeriousBodilyInjury, isDangerousOccurrence: incident.isDangerousOccurrence, isOccupationalDisease: incident.isOccupationalDisease, lostDays: incident.lostDays ?? null, triagedBy: incident.triagedByName ?? null, triagedAt: incident.triagedAt instanceof Date ? incident.triagedAt.toISOString() : (incident.triagedAt as string | null), triageNotes: incident.triageNotes ?? null, investigation: inv ? { method: inv.method, findingsText: inv.findingsText ?? null, rootCauseSummary: inv.rootCauseSummary ?? null, alcoholTestResult: inv.alcoholTestResult ?? null, urineTestResult: inv.urineTestResult ?? null, } : null, capas: capaRows.map(c => ({ description: c.description, ownerName: c.ownerName ?? 'Unknown', department: c.department, dueDate: c.dueDate, priority: c.priority, status: c.status, completedAt: c.completedAt instanceof Date ? c.completedAt.toISOString() : (c.completedAt as string | null), ownerNotes: c.ownerNotes ?? null, })), addenda: addendaRows.map(a => ({ authorName: a.authorName ?? 'Unknown', createdAt: a.createdAt instanceof Date ? a.createdAt.toISOString() : (a.createdAt as string), body: a.body, })), closedAt: incident.closedAt instanceof Date ? incident.closedAt.toISOString() : (incident.closedAt as string | null), }) const filename = `incident-report-${incident.referenceNo ?? id}.pdf` return new NextResponse(pdfBytes, { status: 200, headers: { 'Content-Type': 'application/pdf', 'Content-Disposition': `attachment; filename="${filename}"`, 'Content-Length': String(pdfBytes.byteLength), }, }) } ``` - [ ] **Step 4: Run test — verify it passes** ```bash cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npx vitest run tests/app/api/incidents/report-pdf.test.ts ``` Expected: PASS — 5 tests pass - [ ] **Step 5: Build check** ```bash cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npm run build 2>&1 | tail -10 ``` Expected: `✓ Compiled successfully` with zero errors. - [ ] **Step 6: Commit** ```bash git add app/api/incidents/\[id\]/report-pdf/route.ts tests/app/api/incidents/report-pdf.test.ts git commit -m "feat(pdf): add incident report PDF API route" ``` --- ### Task 3: Print button in HSE incident detail page **Files:** - Modify: `app/(protected)/hse/incidents/[id]/page.tsx` **Interfaces:** - Consumes: existing `status` variable (already computed at line ~102) - No new imports needed — button is a plain `` link same as existing JKKP buttons The button appears in the same block as the JKKP download links. It is only rendered when `status === 'closed'`. Clicking it opens `/api/incidents/${id}/report-pdf` in a new tab (browser shows the PDF or triggers download depending on browser settings). - [ ] **Step 1: Read the current button block** Open `app/(protected)/hse/incidents/[id]/page.tsx` and locate the JKKP links block around line 176. It looks like: ```tsx href={`/api/incidents/${id}/jkkp-pdf?form=jkkp6`} ``` - [ ] **Step 2: Add the Print Report button** Find this block in `app/(protected)/hse/incidents/[id]/page.tsx`: ```tsx href={`/api/incidents/${id}/jkkp-pdf?form=jkkp7`} ``` After the closing element of that JKKP block (look for the enclosing `` or after the last JKKP link), add — **after** the existing JKKP buttons, inside the same container: ```tsx {status === 'closed' && ( Print Report )} ``` - [ ] **Step 3: Build check** ```bash cd /Users/yapweeihan/Desktop/Projects/IMS.nosync && npm run build 2>&1 | tail -10 ``` Expected: `✓ Compiled successfully` - [ ] **Step 4: Commit** ```bash git add app/\(protected\)/hse/incidents/\[id\]/page.tsx git commit -m "feat(ui): add Print Report button on closed incidents" ``` --- ## Self-Review **Spec coverage:** - ✅ Print button appears on closed incidents - ✅ PDF includes all incident sections (details, triage, investigation, CAPA, addenda, closure) - ✅ PDF only generated when `status === 'closed'` (400 otherwise) - ✅ Auth-gated to `hse` and `admin` - ✅ Multi-page support via `newPage` / `ensureSpace` - ✅ No new dependencies **Placeholder scan:** None found. **Type consistency:** `IncidentReportData` defined in Task 1, imported in Task 2. `buildIncidentReportPdf` produced in Task 1, consumed in Task 2. All field names match across tasks.