Case Lifecycle

A review case is the central record for a second-opinion request. It moves through a series of stages from creation until it is completed, cancelled, or rejected.

Status flow

stateDiagram-v2
  [*] --> Draft: Patient creates case
  [*] --> Submitted: Patient submits directly
  Draft --> Submitted: Submit for review
  Submitted --> AwaitingPayment: Admin assigns coordinator
  AwaitingPayment --> PaymentSuccessful: Patient pays successfully
  AwaitingPayment --> PaymentFailed: Payment does not complete
  PaymentSuccessful --> DoctorsAssigned: Coordinator assigns doctors
  DoctorsAssigned --> Completed: Coordinator submits final summary
  Draft --> Cancelled: Patient cancels
  Submitted --> Cancelled: Admin or patient cancels
  PaymentSuccessful --> Cancelled: Cancellation
  DoctorsAssigned --> Cancelled: Cancellation
  Submitted --> Rejected: Admin rejects case
  Completed --> [*]
  Cancelled --> [*]
  Rejected --> [*]
  PaymentFailed --> [*]

Stages explained

Stage	What it means
Draft	Patient is still editing; documents can be added or changed
Submitted for review	Case submitted; waiting for admin to assign a coordinator
Awaiting payment	Coordinator assigned; patient must complete payment
Payment successful	Paid; coordinator can assign specialist doctors
Payment failed	Payment did not go through; case does not proceed
Doctors assigned	Specialist doctors are reviewing the case
Completed	Final report is available to the patient
Cancelled	Case closed by patient or admin (refund issued if already paid)
Rejected	Admin declined the case with a stated reason

Tracking timeline (admin view)

The admin dashboard shows a step-by-step timeline for each case:

1. New case created
2. Coordinator assigned
3. Awaiting payment
4. Payment received
5. Doctors assigned
6. Under specialist review
7. Case completed

Cancellation and rejection appear as separate timeline outcomes when they occur.

Patient journey

1. Browse available review types and disease categories
2. Create a case (save as draft, or submit immediately)
3. Upload medical documents while the case is still a draft
4. Submit the case for review
5. After a coordinator is assigned, pay using the payment link provided
6. Track case progress in the patient app
7. View the final report when the case is completed
8. Cancel the case if needed (refund processed when applicable)

---

Technical reference: system status values (draft, review, payment_pending, etc.) and database tables are documented under Database → review_cases and API Flows.