Soficca

Structured decision report

How Soficca resolves each case into a structured, traceable output.

Each case is converted into a decision report that captures outcome, safety handling, and traceability — using a versioned clinical decision structure.

← Back to Pen

Why this matters

Soficca is designed to make medical decisions more consistent, auditable, and easier to review over time.

Instead of producing vague recommendations, the system resolves each case into a structured report covering decision status, safety actions, supporting evidence, and rule traceability.

Anatomy of the report

ok / errors

Indicates whether the report was generated successfully and captures any validation issues.

decision

Defines status, path, flags, reasons, and recommendations.

safety

Captures safety overrides, triggered policies, and required user guidance.

trace

Shows policy trace, evaluated rules, triggered rules, and uncertainty notes.

versions

Tracks engine, ruleset, and safety policy versions used for the decision.

evidence

Stores structured evidence with source, recency, confidence, and contradiction metadata.

A real decision output

Every case resolves into a structured, traceable decision report.

Illustrative example based on Soficca’s decision report structure.

Decision

Status: DECIDED

Path: PATH_MEDS_OK


Flags: none


Reason: pattern consistent with treatment-eligible hair loss


Recommendation: proceed to clinician review for treatment plan

Input case

Age: 29

Concern: hair loss


Contraindications: none reported


Goal: slow progression and improve density

Safety

Status: CLEAR


Action: NONE

Triggers: none

Trace

Rules evaluated: eligibility, contraindication screening, safety policy

Rules triggered: treatment-eligible pathway


Evidence source: user intake


Policy version: v0.3

Structured output

A simplified technical view of the same decision

DECIDEDBased on Soficca Decision Report v0.3
{
  "ok": true,
  "errors": [],
  "versions": {
    "engine": "v0.3",
    "ruleset": "hair_loss_v0.3",
    "safety_policy": "safety_v0.3"
  },
  "decision": {
    "status": "DECIDED",
    "path": "PATH_MEDS_OK",
    "flags": [],
    "reasons": [
      "profile consistent with treatment-eligible hair loss"
    ],
    "recommendations": [
      "proceed to clinician review and treatment planning"
    ]
  },
  "safety": {
    "status": "CLEAR",
    "action": "NONE",
    "triggers": [],
    "user_guidance_required_fields": [],
    "policy_version": "safety_v0.3"
  },
  "trace": {
    "policy_trace": {
      "evaluated": [
        "policy_hair_loss_eligibility",
        "policy_contraindication_screening",
        "policy_safety_gate"
      ],
      "triggered": []
    },
    "rules_evaluated": [
      "rule_age_check",
      "rule_contraindication_check",
      "rule_hair_loss_treatment_path"
    ],
    "rules_triggered": [
      "rule_hair_loss_treatment_path"
    ],
    "evidence": {
      "concern": {
        "value": "hair_loss",
        "source": "USER",
        "recency_days": 7,
        "confidence": 0.95,
        "contradiction": false
      }
    },
    "uncertainty_notes": []
  }
}
Illustrative technical output showing how Soficca resolves a case into a structured, traceable decision report.

Built for traceable care

This is what allows Soficca to turn patient inputs into clear, reviewable, and versioned decision outputs — making care more consistent at the product level and more scalable at the system level.

Soficca © 2026