MVP Phases 1-3: scraper, API, and Next.js frontend

[swehrcustoms]

Summary

• completed Phase 1 scraper engine (Mille Lacs source + SQLite persistence)
• completed Phase 2 FastAPI endpoint GET /api/reports
• completed Phase 3 Next.js + Tailwind frontend with responsive card feed and source filtering
• added Cursor cloud environment bootstrap config to preinstall Python dependencies and Playwright Chromium on startup

Phase 3 implementation details

• scaffolded frontend/ Next.js (App Router) + Tailwind project
• replaced starter UI with a report inbox view:
  • card feed showing source, title, date, preview, and "Read Full Report"
  • source filter dropdown (All + discovered sources)
  • responsive layout: 1 column mobile, 2 medium, 3 extra-large
• added frontend/app/api/reports/route.ts proxy endpoint to forward requests to backend API (BACKEND_API_URL, default http://127.0.0.1:8000)
• added loading/empty/error states in client UI

Cloud environment setup

• added .cursor/environment.json with startup install command to:
  • install Python deps from requirements.txt
  • ensure playwright, beautifulsoup4, lxml, fastapi, uvicorn are present
  • install Playwright Chromium browser

Post-testing fixes

• adjusted frontend Tailwind setup to a Node 18-compatible configuration:
  • switched from Tailwind v4 plugin path to Tailwind v3 + PostCSS + Autoprefixer
  • added frontend/tailwind.config.ts
  • updated frontend/postcss.config.mjs and frontend/app/globals.css

Validation

• backend API endpoint verified: GET http://127.0.0.1:8000/api/reports
• frontend proxy verified: GET http://127.0.0.1:3000/api/reports
• frontend lint passes: npm run lint
• frontend production build passes: npm run build