Skip to content
Vraimony
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 }