Preventive Care & Hereditary Risk

The always-on preventive layer: a per-patient care plan of DUE / OVERDUE / UPCOMING screenings and prevention (life-course + risk-adjusted), a hereditary risk view derived from the consented Family Graph, and professional-guided couple/preconception risk matching. Recommendations are evidence-linked guidance with a professional in the loop, never an auto-order or diagnosis; results are FHIR CarePlan / RiskAssessment resources.

Base path /care-coordination/api/v1/precision/. Risk/preventive reads are self or service; couple matching and trait/red-flag operations are professional/service only.

Endpoints

GET/care-coordination/api/v1/precision/preventive/{uhid}/Compute preventive care plan

GET/care-coordination/api/v1/precision/preventive/{uhid}/current/Latest computed plan (no recompute)

GET/care-coordination/api/v1/precision/risk/{uhid}/Compute hereditary risk

GET/care-coordination/api/v1/precision/risk/{uhid}/current/Active risk assessments

POST/care-coordination/api/v1/precision/couple-risk/Couple/preconception risk match

Preventive care plan

Computes the patient's due/overdue/upcoming screenings from guideline config, personalized by the gender-aware care context and risk-adjusted by the Family Graph (e.g. cervical/breast for eligible women, pregnancy items when pregnant, well-man bands for men, IMCI for children). Each item carries its evidence source and patient guidance.

GET/care-coordination/api/v1/precision/preventive/UG123456789A/

RESPONSE200

{
  "patient_uhid": "UG123456789A",
  "tracks": [
    "preventive_care",
    "womens_health"
  ],
  "counts": {
    "due": 9,
    "overdue": 0,
    "upcoming": 4,
    "complete": 0
  },
  "items": [
    {
      "guideline_code": "cervical-screen",
      "status": "due",
      "due_date": "2026-07-16",
      "risk_adjusted": false
    },
    {
      "guideline_code": "preeclampsia-aspirin",
      "status": "due",
      "risk_adjusted": true,
      "driving_risk_rule": "familial-preeclampsia"
    }
  ]
}

Couple / preconception risk matching

Professional-guided (accuracy-first). Runs the hereditary risk engine for both partners and consolidates the shared/offspring risk (sickle-cell carrier × carrier → 1-in-4, etc.), exposing only the minimum-necessary derived trait — never a partner's full record. Consent is enforced at trait derivation; every match is audited; results feed the Preventive Care Engine (e.g. newborn sickle-cell screening).

POST/care-coordination/api/v1/precision/couple-risk/

Request Body

partner_a_uhidstringrequired

First partner

partner_b_uhidstringrequired

Second partner

RESPONSE200

{
  "partner_a": "UG123456789A",
  "partner_b": "UG987654321B",
  "couple_risks": [
    {
      "rule_code": "sickle-cell-carrier-couple",
      "outcome": {
        "code": "127040003",
        "display": "Sickle cell anemia"
      },
      "probability_decimal": 0.25,
      "driving_relationships": [
        "self",
        "HUSB"
      ]
    }
  ],
  "professional_in_the_loop": true,
  "summary": "Shared/offspring hereditary risk identified. Offer preconception counseling and newborn screening. Professional review required."
}