Schema & contract
The platform needs one canonical case object.
To become adoptable, Vraimony needs a portable schema for case type, reason code, signals, modules, repair protocols, and reviewer simulation outputs.
Module map
The parts of the case machine.
M1 — Identity
Actors, account, order, payment, recipient linkage.
Submodules: payer-order link, customer-recipient link, account ownership
M2 — Timeline
Event order, gaps, chronology integrity.
Submodules: dispatch sequence, support-response chain, dispute chronology
M3 — Delivery
Shipment, handoff, proof-of-delivery, address path.
Submodules: order-tracking link, proof-of-delivery, recipient handoff
M4 — Evidence
Attachment concentration, evidence map, reviewer load.
Submodules: bundle structure, labeling, channel spread
M5 — Policy
Reason-code fit and proof relevance.
Submodules: reason-code mapping, proof type relevance, policy snapshot
M6 — Decision
Summary, ask, requested remedy, reader orientation.
Submodules: summary block, decision ask, requested outcome
M7 — Contradiction
Conflicts across dates, actors, amounts, statements.
Submodules: date conflicts, amount conflicts, statement conflicts
M8 — Deadline
Time left, missing proof, submission survivability.
Submodules: deadline proximity, critical missing items, submission readiness
Schema excerpt
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.vraimony.com/data/diagnostic/case-diagnostic.schema.v1.json",
"title": "Vraimony Case Diagnostic Schema v1",
"type": "object",
"required": [
"case_type",
"reason_code",
"signals"
],
"properties": {
"case_type": {
"type": "string",
"enum": [
"chargeback",
"delivery_denial",
"vendor_review",
"handover_dispute",
"refund_dispute"
]
},
"reason_code": {
"type": "string"
},
"deadline_days_left": {
"type": "number"
},
"signals": {
"type": "object",
"properties": {
"has_order_id": {
"type": "boolean"
},
"has_payment_proof": {
"type": "boolean"
},
"identity_linked": {
"type": "boolean"
},
"has_timeline": {
"type": "boolean"
},
"timeline_gap_days": {
"type": "number"
},
"critical_events_missing": {
"type": "integer"
},
"has_tracking": {
"type": "boolean"
},
"has_delivery_confirmation": {
"type": "boolean"
},
"order_tracking_linked": {
"type": "boolean"
},
"attachment_count": {
"type": "integer"
},
"channel_count": {
"type": "integer"
},
"has_evidence_map": {
"type": "boolean"
},
"has_summary": {
"type": "boolean"
},
"has_decision_ask": {
"type": "boolean"
},
"has_acknowledgment": {
"type": "boolean"
},
"policy_relevance_score": {
"type": "number"
},
"has_contradiction": {
"type": "boolean"
},
"contradiction_count": {
"type": "integer"
},
"missing_critical_count": {
"type": "integer"
},
"claim_scope_unclear": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
}