# ResumeInputProcessor

Central resume **input** normalization for all resume-dependent Gateway flows.

## Flow

```
Resume file / resume_text / candidate_id
        ↓
ResumeInputProcessor
        ↓
DocumentsService (parse) / ResumeService (versioned store)
        ↓
normalized resume_text (+ structured)
        ↓
Existing API business logic
```

Does **not** create a second parser. Always reuses `DocumentsService` via `ResumeService`.

## Inputs (any one)

| Input | Notes |
|-------|--------|
| `resume_text` | Plain text (existing JSON) |
| `resume_structured` | Structured dict |
| `content_base64` + `filename` / `document_type` | PDF / DOCX / TXT (JSON; project standard) |
| `source_url` | Fetch then parse |
| `candidate_id` | Latest stored profile |
| Multipart file | `POST /documents/parse-file` only — **structured response** (personal / summary / experience / education / skills / other); no `raw_text` |

Legacy `.doc` (OLE) → `400 unsupported_document_type` (misnamed DOCX/PK zip still works).

## Wired flows

| API / service | require_resume |
|---------------|----------------|
| `/documents/parse`, `/documents/parse-file` | yes (resume target) |
| `/resume-match/score` | yes |
| `/prep-plans/generate` | when resume signal present |
| `/job-matching/recommend` | optional (skills-only ok) |
| Workflow / role questions | when resume signal present |
| Skill-gap / hiring-fit / profiles (services) | when signal present |

## Errors

| Code | When |
|------|------|
| `missing_resume` | No text/media/candidate when required |
| `empty_resume` | Empty upload or no extractable text |
| `unsupported_document_type` | Legacy `.doc` OLE |
| `invalid_document` / `document_parse_failed` | Bad base64 / corrupt file |

See also: `docs/RESUME_SERVICE.md` (versioning / cache).
