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

31 lines
1.7 KiB
Markdown

# 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.