| """The verification test-case taxonomy: ``case_type`` -> ground-truth verdict. |
| |
| Each :class:`CaseSpec` encodes one row of the signature-verification test |
| plan: what should actually be rendered into the target signature box |
| (``signature_mode``), whether a companion box on the same page should also |
| be filled with its own correctly-authorized signature (``fill_companion`` -- |
| only meaningful for the multi-signer-context cases), and the ground-truth |
| ``verdict``/``reject_code`` a downstream verifier is expected to produce. |
| |
| Driven by the existing ``quality.case_type`` config field (see |
| ``configs/examples/hard_degraded.yaml`` for its prior, simpler use as a |
| plain metadata label) -- setting it to one of the codes below switches |
| :meth:`~src.generator.GeneratorContext.run_sample` into scenario-driven |
| generation. Any other value (or ``None``) leaves generation entirely |
| unaffected. |
| """ |
|
|
| from __future__ import annotations |
|
|
| from dataclasses import dataclass |
|
|
| SignatureMode = str |
|
|
| NO_SIGNATURE = "NO_SIGNATURE" |
| IDENTITY_MISMATCH = "IDENTITY_MISMATCH" |
| ROLE_MISMATCH = "ROLE_MISMATCH" |
| REQUIRED_SIGNER_ABSENT = "REQUIRED_SIGNER_ABSENT" |
|
|
|
|
| @dataclass(frozen=True) |
| class CaseSpec: |
| """One row of the verification test-case taxonomy.""" |
|
|
| code: str |
| description: str |
| verdict: str |
| reject_code: "str | None" |
| signature_mode: SignatureMode |
| fill_companion: bool = False |
|
|
|
|
| CASE_TABLE: dict[str, CaseSpec] = { |
| "1a": CaseSpec("1a", "Correct signer signs normally", "PASS", None, "genuine_correct"), |
| "1b": CaseSpec("1b", "Correct signer, natural pen variation applied", "PASS", None, "genuine_variation"), |
| "1c": CaseSpec("1c", "Multi-signer form, both sign correctly", "PASS", None, "genuine_correct", fill_companion=True), |
| "1d": CaseSpec("1d", "Correct signer, scan degraded to test robustness", "PASS", None, "genuine_correct"), |
| "2a": CaseSpec("2a", "Box left completely blank", "REJECT", NO_SIGNATURE, "blank"), |
| "2b": CaseSpec("2b", "Printed/typed name only, no handwriting", "REJECT", NO_SIGNATURE, "printed_text"), |
| "3a": CaseSpec("3a", "Wrong real person signs the box", "REJECT", IDENTITY_MISMATCH, "wrong_signer_genuine"), |
| "3b": CaseSpec("3b", "Skilled-forgery sample used", "REJECT", IDENTITY_MISMATCH, "forged_skilled"), |
| "4a": CaseSpec("4a", "Authorized signer, but wrong role's box", "REJECT", ROLE_MISMATCH, "role_swap", fill_companion=True), |
| "4b": CaseSpec("4b", "Signer from a different form entirely", "REJECT", ROLE_MISMATCH, "foreign_template_signer", fill_companion=True), |
| "5a": CaseSpec("5a", "Required signer's box left empty", "REJECT", REQUIRED_SIGNER_ABSENT, "blank", fill_companion=True), |
| "5b": CaseSpec("5b", "Someone else signs in the required signer's place", "REJECT", REQUIRED_SIGNER_ABSENT, "wrong_signer_genuine", fill_companion=True), |
| } |
|
|
