Cases

warning

Satxuma is still under active development. It is not yet HIPAA compliant and should only be used with dummy data.

A therapy case represents an episode of care for a specific therapy discipline (e.g., OT, PT, or SLP). It's a container that ties together an admission, evaluation, progress notes, recertifications, treatments, measures, and discharge.

---

Data model

Satxuma stores cases under a patient:

Each case links to exactly one evaluation:

Furthermore, a case may link to

• 0 or 1 admissions
• 0 or more progress notes
• 0 or more recertifications
• 0 or more treatments
• 0 or more measures
• 0 or 1 discharges

Properties

• admission (AdmissionInOtherDoc<T> | null) — The admission associated with this case. May be null for outpatient or evaluation-only cases.
• certifications (NonEmptyArray<CertificationInCaseDoc<T>>) — List of certifications defining treatment periods and goals.
• discharge (DischargeInCaseDoc<T> | null) — Discharge summary if the case has been closed.
• disciplineId (DisciplineId) — Therapy discipline for this case (e.g., "OT", "PT", "SLP").
• endDate (string) — Date the case officially ended (often matches discharge).
• expectedDischargeDate (string) — Anticipated discharge date, used for scheduling and tracking progress.
• notes (string) — Free-text notes about the case.
• organizationId (string) — The organization responsible for managing the case.
• physicians (PhysicianInCaseDoc[]) — Physicians involved in signing and approving the plan of care.
• priorAssistiveDevices (string[]) — List of assistive devices used prior to therapy (e.g., “Walker”, “Wheelchair”).
• priorHospitalization (AdmissionInOtherDoc<T> | boolean | null) — Indicates if the patient had a prior hospitalization; may store full admission details or a simple yes/no.
• progressNotes (ProgressNoteInCaseDoc<T>[]) — Clinical notes documenting ongoing progress.
• startDate (string) — Date the case began (often aligns with evaluation).
• tags (string[]) — Custom labels for filtering or categorizing cases (e.g., “Fall Risk”, “Pediatrics”).
• timeZone (TimeZone) — Time zone of the facility or service location.
• weekType (WeekType) — Scheduling convention used for the case (e.g., "Calendar", "Therapy Week").

Examples

Example 1

{
  "admission": {
    "id": "a1001",
    "name": "Pine Nursing — Jan 2025"
  },
  "certifications": [
    {
      "startDate": "2025-01-01",
      "endDate": "2025-02-15",
      "type": "Initial Evaluation"
    }
  ],
  "discharge": null,
  "disciplineId": "PT",
  "endDate": "",
  "expectedDischargeDate": "2025-02-15",
  "notes": "Post-op rehab following total knee replacement.",
  "organizationId": "org001",
  "physicians": [{ "id": "md01", "name": "Dr. Halpern" }],
  "priorAssistiveDevices": ["Walker"],
  "priorHospitalization": true,
  "progressNotes": [],
  "startDate": "2025-01-01",
  "tags": ["Orthopedic"],
  "timeZone": "America/Chicago",
  "weekType": "Calendar"
}

Example 2

{
  "admission": {
    "id": "a2002",
    "name": "Maple Hospital — Feb 2025"
  },
  "certifications": [
    {
      "startDate": "2025-02-10",
      "endDate": "2025-03-25",
      "type": "Initial Evaluation"
    }
  ],
  "discharge": {
    "date": "2025-03-25T13:00:00Z",
    "summary": "Patient met all short-term goals; discharged home with independent ADL function."
  },
  "disciplineId": "OT",
  "endDate": "2025-03-25",
  "expectedDischargeDate": "2025-03-25",
  "notes": "Focused on ADL training and upper extremity strengthening.",
  "organizationId": "org001",
  "physicians": [{ "id": "md02", "name": "Dr. Singh" }],
  "priorAssistiveDevices": ["Grab bar"],
  "priorHospitalization": {
    "id": "a1999",
    "name": "Oak Rehab — Prior Stay"
  },
  "progressNotes": [{ "date": "2025-03-01T10:00:00Z", "summary": "Improved shoulder ROM to 130°" }],
  "startDate": "2025-02-10",
  "tags": ["Stroke", "Upper Extremity"],
  "timeZone": "America/New_York",
  "weekType": "Therapy Week"
}

Example 3

{
  "admission": null,
  "certifications": [
    {
      "startDate": "2025-04-01",
      "endDate": "2025-05-15",
      "type": "Initial Evaluation"
    }
  ],
  "discharge": null,
  "disciplineId": "SLP",
  "endDate": "",
  "expectedDischargeDate": "2025-05-15",
  "notes": "Outpatient voice therapy for post-surgical hoarseness.",
  "organizationId": "org002",
  "physicians": [{ "id": "md03", "name": "Dr. Ellis" }],
  "priorAssistiveDevices": [],
  "priorHospitalization": false,
  "progressNotes": [],
  "startDate": "2025-04-01",
  "tags": ["Voice", "Outpatient"],
  "timeZone": "America/Los_Angeles",
  "weekType": "Calendar"
}