Manual attribution and an explicit re-match action

[jbagsik]

Parent

#21

What to build

An operator can correct an attribution by hand and can deliberately re-run matching on selected
documents — and neither of those can undo the other.

Both halves are needed because the review outcomes only pay off if the loop closes. Documents park in
review precisely so master data gets completed; if nothing is ever re-evaluated, they stay parked
forever. Conversely, if a re-run can silently overwrite a human decision, reviewing is pointless.

Re-matching stays explicit. Confirmed and validated documents are never re-evaluated by the
automatic path, and nothing re-attributes documents in the background — an attribution must not change
without someone asking for it.

Acceptance criteria

• An operator can set the attribution on a document by hand from the admin surface.
• A manually set attribution is recorded with a manual source, distinguishable from an automatic
  one.
• An operator can trigger re-matching for a selected document; it resets to the pre-confirmation
  state and re-evaluates.
• Re-matching leaves a manually sourced attribution untouched.
• The automatic path still refuses to re-evaluate a confirmed or validated document.
• Nothing re-matches on a schedule or as a side effect of unrelated processing.
• A document parked in review is picked up correctly by a re-run after the missing master data is
  completed.
• Covered through the validation entry point plus the re-match action, asserting the resulting
  attribution and status.

Blocked by

• Corroborate the attribution against name, VAT identifier, country and address #25 — the review outcomes are what make re-matching worth having.

[jbagsik]

Done

Manual attribution and explicit rematch are in place.

What shipped

• Nullable indexed attribution_source (auto | manual) on ebilling_documents
• SetInvoiceAttributionAction — operator sets/clears customer attribution; derives company_id; marks source as manual
• RematchAttributionAction — resets review_status to parser_created, then re-runs InvoiceFieldValidator::validate()
• Validator freezes customer_id / company_id when source is manual; automatic path still refuses HumanConfirmed / Validated
• Filament: Set attribution + Re-match on invoice detail; Re-match on the list (no bulk, no schedule)
• Changing attribution after confirm/validate clears attestation back to DbValidated so the visibility gate stays honest

AC

• Manual attribution
• Manual source distinguishable from automatic
• Explicit rematch resets to pre-confirmation and re-evaluates
• Rematch leaves manual attribution untouched
• Automatic path still refuses confirmed/validated
• No scheduled / side-effect rematch
• Parked review docs re-evaluated after master data is fixed
• Covered via validate() + rematch action (attribution + status)