POA Operator Repair Surface

Summary

The POA operator surface lets users inspect documents, review issues, correct typed fields, and retry processing without leaving the workflow.

Problem

Document automation needs human judgment for mismatches, missing fields, and external command failures. A manual workaround would break auditability.

Principle

Expose repair controls that create durable corrections and re-enter processing.

Platform Shape

The greenfield UI is stage-oriented. API read models expose repair detail and action affordances, while review workflow services persist corrections and retry actions.

Source Evidence

• app/web/app/poa-greenfield
• services/poa/review/workflow
• services/poa/api/greenfield/operator
• docs/domains/poa-greenfield-route-map.md

Related Reading

• docs/engineering/concepts/repair-actions.md
• docs/engineering/architecture/route-shell-container-pattern.md