Jason Thistlethwaite
47 lines
1.6 KiB
Markdown
47 lines
1.6 KiB
Markdown
# Feature detail: OCR attachment → subject rename
|
|
|
|
**Parent roadmap:** [[../features-for-redmine_tickets-sync]]
|
|
**Status:** MVP 2026-07-15
|
|
**Module:** `redmine_ticket_ocr.py` · CLI: `ocr-rename`
|
|
|
|
## Intent
|
|
|
|
Scanned docs land in Helpdesk as tickets titled “Scanned document…”.
|
|
Ops need: open attachment → understand contents → rename subject (+ optional notes).
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
# One ticket: download OCR-able attachments, propose subject, queue private note (+ subject draft)
|
|
./bin/rtl ocr-rename --issue-id 12345
|
|
|
|
# Scan cache for generic scan subjects
|
|
./bin/rtl ocr-rename --where '@scanned-document' --only-generic-subjects --max-tickets 20
|
|
|
|
# Apply subject now (LAN/prod safety gates); still queues private OCR note by default
|
|
./bin/rtd ocr-rename --issue-id 12345 --apply-subject
|
|
|
|
# Extract only (no drafts)
|
|
./bin/rtl ocr-rename --issue-id 12345 --no-queue-subject --no-queue-note --json
|
|
```
|
|
|
|
## Pipeline
|
|
|
|
1. Load ticket + attachments (`include=attachments` refresh if needed)
|
|
2. Download PDF/image candidates (multi-URL fallback)
|
|
3. Extract text: `pdftotext` → else `pdftoppm` + `tesseract`
|
|
4. Heuristic `suggest_subject_from_text` (doc type, person/company, date)
|
|
5. Queue drafts:
|
|
- `fields` subject change (unless `--no-queue-subject`)
|
|
- private `internal_note` with OCR snippet (unless `--no-queue-note`)
|
|
|
|
## Saved filter
|
|
|
|
`saved-filters/scanned-document.expr` → `@scanned-document`
|
|
|
|
## Still open
|
|
|
|
- [ ] Stronger LLM subject summarization (optional; keep heuristics default)
|
|
- [ ] Cron wrapper that only processes new generic-scan tickets
|
|
- [ ] HR-project default project config example
|