1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47"""Job status constants and state machine definitions.
Defines all valid job statuses and state transition rules
for the document conversion workflow.
"""
from typing import Literal
# Job status type definition
# Status flow:
# 1. pii_scanning - Scanning document for PII
# 2. awaiting_approval - PII found, awaiting human approval to proceed
# 3. processing_queued - Approval received, queued for processing (instant response)
# 4. processing - Converting PDF and applying AI text corrections
# 5. completed/failed/denied - Terminal states
JobStatusType = Literal[
"pii_scanning",
"awaiting_approval",
"processing_queued",
"processing",
"completed",
"failed",
"denied",
]
# Status constants
STATUS_PII_SCANNING = "pii_scanning"
STATUS_AWAITING_APPROVAL = "awaiting_approval" # PII approval
STATUS_PROCESSING_QUEUED = "processing_queued" # Instant approval response, background processing
STATUS_PROCESSING = "processing"
STATUS_COMPLETED = "completed"
STATUS_FAILED = "failed"
STATUS_DENIED = "denied"
# Status groupings
TERMINAL_STATUSES: set[str] = {STATUS_COMPLETED, STATUS_FAILED, STATUS_DENIED}
ACTIVE_STATUSES: set[str] = {
STATUS_PII_SCANNING,
STATUS_AWAITING_APPROVAL,
STATUS_PROCESSING_QUEUED,
STATUS_PROCESSING,
}
# All valid statuses
ALL_STATUSES: set[str] = TERMINAL_STATUSES | ACTIVE_STATUSES