feat(reports): PDF report generator (rebased on main, conflict-free) — supersedes #8

[kiro-agent]

This pull request was created by @kiro-agent on behalf of @D-source1602 👻

Comment with /kiro fix to address specific feedback or /kiro all to address everything.
_{Learn about Kiro autonomous agent}

---

Summary

This is the conflict-free version of PR #8 (PDF report generator), rebased on top of main after PR #7 (realtime AQI) was merged. Same content as PR #8, just with the conflicts in backend/package.json, backend/prisma/schema.prisma, and backend/src/routes/index.ts resolved.

Action needed: merge this PR, then close PR #8 (it's now superseded).

Why this exists

PRs #7 and #8 were developed in parallel. After PR #7 merged, PR #8 had merge conflicts because both PRs touched:

• backend/package.json — both add deps (resolved: keep all of node-cron, socket.io, pdfkit, plus types)
• backend/prisma/schema.prisma — both append a new model at the bottom (resolved: keep both AirQualityReading and Report models)
• backend/src/routes/index.ts — both add a router import + mount (resolved: keep both aqiRouter and reportRouter)

src/App.tsx auto-merged cleanly because PR #7 added LiveAirQualityPanel while PR #8 modified the Reports component — different sections of the same file.

Conflict resolutions

backend/package.json (both sides kept)

   "jsonwebtoken": "^9.0.2",
+  "node-cron": "^3.0.3",
+  "pdfkit": "^0.15.1",
   "pino": "^9.6.0",

backend/src/routes/index.ts (both sides kept)

import { aqiRouter } from './aqi.routes';
import { reportRouter } from './report.routes';
// ...
apiRouter.use('/aqi', aqiRouter);
apiRouter.use('/reports', reportRouter);

backend/prisma/schema.prisma (both models kept)

The AirQualityReading model from PR #7 and the Report model + ReportType / ReportFormat enums from PR #8 are now stacked at the bottom of the schema, in that order.

What this PR ships (unchanged from PR #8)

PDF report generator wired end-to-end:

• pdfkit-based generator (~2 MB, no Chromium) with brand-matching layout, KPI grid, color-coded status table
• Report Prisma model + ReportType / ReportFormat enums + back-relations on User and Industry
• 4 endpoints: POST /reports/generate, GET /reports, GET /reports/:id/download, DELETE /reports/:id — all auth-protected via requireAuth
• INDUSTRY users scoped to their own reports; ADMIN/INSPECTOR see all
• Frontend Reports page now lists real reports, generates real PDFs, downloads via authenticated fetch + Blob trigger
• Files stored under backend/files/reports/<uuid>.pdf (gitignored)
• AQI section in the PDF auto-includes data from PR feat(realtime): live air quality (OpenAQ + cron + Socket.io + polling fallback) #7's air_quality_readings table

To run after merging

git checkout main && git pull origin main
cd backend
npm install                                     # adds pdfkit
npx prisma migrate dev --name add_reports       # creates `reports` table
npm run dev

# in another terminal
cd CLIMATRIX
npm run dev

Open http://localhost:5173, log in, click Reports → GENERATE REPORT → DOWNLOAD. PDF lands in your Downloads folder.

Diff stat

Same as PR #8: 9 files, +1065 / -21.