CHD-3035 - accept both documentReference and documentReferenceUri on case document upload

[aykutdanisman]

Problem

After #156, SJP accepted either a file service id (caseDocument / documentReference) or a blob uri (caseDocumentUri / documentReferenceUri), and the schemas enforced that with oneOf. staging-dvla now derives the case document uuid from the blob uri and sends both. With oneOf that payload is rejected. The processor also treated "uuid present" as meaning "file-service addressed", so material would have been sent a fileServiceId that no file service knows about.

Change

• Schemas: upload-case-document command (api/controller/handler) and case-document-uploaded / case-document-upload-rejected events relaxed from oneOf to anyOf: at least one reference is required, and both are allowed.
• Command handler: passes through whichever references arrive.
• Aggregate (CaseDocumentHandler): rejection messages name the uri when there is one; both references stay on the event.
• Event processor (CaseDocumentProcessor):
  • A document is blob-addressed when the uri is present. It no longer depends on the uuid being absent.
  • The public event and the sjp metadata carry both references, so handleMaterialAdded uses the caller's uuid instead of deriving a new one.
  • Material still gets exactly one reference (its upload-file command is an exclusive oneOf), and the uri wins when there is one.
  • The v3 uuid derived from the uri stays as the fallback for uri-only payloads and replayed events.
• Query: documentUri added to CaseDocumentView and to the result-orders OrderView, with matching response schemas. The field is absent on the file-service path, so those responses don't change.

Verification

• mvn -o -pl sjp-json,sjp-command/{api,controller,handler},sjp-domain/sjp-domain-aggregate,sjp-event/sjp-event-processor,sjp-query/{api,view} -am install: builds, unit tests pass.
• New unit tests cover both references together in the command handler, the aggregate and the processor, plus the documentUri query views.
• sjp-integration-test compiles (test-compile). AddCaseDocumentIT and CaseDocumentHelper were updated but not run locally.
• ado.sh sonarlint team/CHD-2786: no new findings from this diff. The listed ones are stale or were already there.

🤖 Generated with Claude Code

[cpp-github-management]

[cpp-github-management]