jobhunt-platform/docs/adr/0002-v1-scope.md

ADR-0002: v1.0 scope (post perspective review)

Status: accepted (2026-07-30)

Context

POC proved the architecture (state machine, approval gate, budgets, mock mode). docs/user-research/desperate-jobseeker.md drives v1.0 scope.

v1.0 adds

1. CV import (PDF/DOCX/paste -> extracted section drafts -> confirm-to-merge). No import, no adoption.
2. Arbetsförmedlingen connector (Official Swedish public employment API, free, no key, no ToS risk) + generic URL ingestion with readability extraction. LinkedIn stays manual-paste (account-ban risk documented).
3. Nightly digest scheduler: fetch -> dedupe -> batch score (cheap class) -> GET /today digest (top matches + follow-up nudges).
4. Follow-up rules: days-since-sent -> suggested nudge with one-click draft.
5. Interview prep generator (strong class, per application, stored as artifact).
6. Scam/red-flag check inside scoring (cheap class, extends rubric output with red_flags: []).
7. SMTP transport (env-configured) behind the unchanged approval gate; ClipboardTransport default when unconfigured.
8. Onboarding wizard in web: welcome -> import -> digest -> first application.
9. Forgejo CI: pytest suites (api, artifacts, llm-gateway, connectors) + web build/test on push.
10. Demo seed: POST /dev/seed-demo inserts a demo profile + 6 sample postings so a new user sees the product in 60 seconds with zero keys.

Not in v1.0

Multi-user auth, SaaS, auto-apply, LinkedIn write, mobile app, interview scheduling.

Targets

• docker compose up to running app in < 15 min on a dev machine.
• All tests green in CI.
• No endpoint requires an LLM key; everything degrades to mock.