Chest X-Ray Workflow Epic

User Stories: Chest X-Ray Referral, Order Management & Result Workflow

1. Epic: Chest X-Ray Test Order and Result Management

Epic Description:
As part of the TB screening workflow, the system shall create and manage Chest X-Ray test orders against a beneficiary's visit after completion of TB symptom screening. The system shall support automated and manual result entry, multiple test orders against the same visit, result-based referrals to Truenat, repeat testing for AI-invalid results, and automatic closure of pending orders at the end of the day.

1. User Story – Create Visit ID

US-CXR-001: Create Visit ID

As a TB Screening Application,
I want to create a Visit ID for a beneficiary after completion of TB symptom screening,
so that all clinical and diagnostic activities performed during the beneficiary's visit can be linked to a common visit record.

Acceptance Criteria

1. A Visit ID shall be created against every beneficiary after TB symptom screening is completed.
2. The Visit ID shall uniquely identify the beneficiary's current screening visit.
3. All Chest X-Ray orders created during the visit shall be associated with the Visit ID.
4. Multiple test orders may be associated with the same Visit ID.
5. The system shall retain the relationship between:
• Beneficiary
• Visit ID
• Test Order ID
• Test Result.

1. User Story – Automatically Create Chest X-Ray Order

US-CXR-002: Create New Chest X-Ray Order

As a Nurse User/authorized clinical user,
I want the system to automatically create a Chest X-Ray Order ID when a new Chest X-Ray referral is made,
so that the diagnostic test can be uniquely tracked against the beneficiary's visit.

Acceptance Criteria

1. For every New Chest X-Ray referral, the system shall automatically generate a unique Order ID.
2. The Order ID shall be associated with:
• Beneficiary ID
• Visit ID
• Test Type = Chest X-Ray
• Order Date
• Order Status.
3. The Order ID shall be valid for the current calendar day.
4. Multiple Chest X-Ray Order IDs may be created against the same Visit ID where repeat testing is required.
5. Each Order ID shall be unique.

1. User Story – Manage Chest X-Ray Order Status

US-CXR-003: Manage Order Status

As a system,
I want to maintain the status of each Chest X-Ray Order ID,
so that the current state of the diagnostic test is clearly tracked.

Order Statuses

Acceptance Criteria

1. A newly created order shall have status Pending.
2. A successfully conducted test with a valid result shall change the order status to Completed.
3. An order that is not conducted by the end of the day shall be changed to Closed.
4. An order for which the result is not entered by the end of the day shall be changed to Closed.
5. An order with AI Invalid Result shall be changed to Closed when the result is saved and a new order shall be created for repeat testing.
6. A closed order shall remain available in the beneficiary's historical record.

1. User Story – Automated Chest X-Ray Result

US-CXR-004: Receive Automated X-Ray Result

As a Radiographer,
I want the Chest X-Ray result to be automatically received from the integrated Digital X-Ray/AI system,
so that I do not have to manually enter the result when device integration is available.

Acceptance Criteria

1. Where Digital X-Ray integration is enabled, the system shall receive the result automatically.
2. The result shall be linked to the correct:
• Beneficiary ID
• Visit ID
• Chest X-Ray Order ID.
3. The system shall store the X-Ray Test ID.
4. The system shall store the X-Ray image where image integration is supported.
5. A valid result shall change the Order Status from Pending → Completed.
6. An AI Invalid Result shall trigger the repeat-test workflow.

1. User Story – Manual Chest X-Ray Result

US-CXR-005: Enter X-Ray Result Manually

As an authorized user,
I want to manually enter the Chest X-Ray result when automated device integration is unavailable,
so that the screening workflow can continue without dependency on device integration.

Authorized Users

Depending on configured role permissions, manual result entry may be provided to:

• Radiographer
• Nurse
• Laboratory Technician
• Counsellor

Acceptance Criteria

1. The system shall provide a Manual Result Entry option when permitted by the user's role.
2. The user shall select one of the configured Chest X-Ray results.
3. The result shall be associated with the active Order ID.
4. The system shall record the user who entered the result.
5. The system shall record date and time of result entry.
6. A valid result shall change the order status to Completed.
7. AI Invalid Result shall initiate the repeat-test workflow.

1. Chest X-Ray Result Types

US-CXR-006: Capture Chest X-Ray Result

As a authorized user/system,
I want to record a standardized Chest X-Ray result,
so that the appropriate downstream action can be initiated automatically.

The system shall support exactly the following four result types:

1. User Story – Normal Result

US-CXR-007: Process Normal Result

As a system,
I want to complete the Chest X-Ray order when the result is Normal,
so that no unnecessary diagnostic referral is generated.

Acceptance Criteria

1. User/system records Normal.
2. Order Status changes from Pending → Completed.
3. The Chest X-Ray result is saved against the Order ID.
4. No Truenat Order shall be automatically created based solely on a Normal X-Ray result.
5. The beneficiary can proceed to the next applicable workflow.

1. User Story – Abnormal but Not TB Presumptive

US-CXR-008: Refer Abnormal Result to Truenat

As a system,
I want to refer beneficiaries with an abnormal Chest X-Ray result to Truenat testing,
so that further diagnostic evaluation can be performed.

Acceptance Criteria

1. User/system records Abnormal but not TB Presumptive.
2. Chest X-Ray Order Status changes to Completed.
3. The X-Ray result is saved against the beneficiary's record.
4. A Truenat referral shall be initiated.
5. A unique Truenat Test Order ID shall be created.
6. The Truenat Order shall be associated with the same Beneficiary ID and Visit ID.

1. User Story – TB Presumptive Result

US-CXR-009: Refer TB Presumptive Result to Truenat

As a system,
I want to automatically refer a beneficiary with a TB Presumptive Chest X-Ray result for Truenat testing,
so that molecular confirmation can be performed.

Acceptance Criteria

1. User/system records TB Presumptive.
2. Chest X-Ray Order Status changes to Completed.
3. The result is saved against the beneficiary record.
4. The system shall create a Truenat Test Order ID.
5. The Truenat Order ID shall be linked to:
• Beneficiary ID
• Visit ID
• Referral source = Chest X-Ray.
6. The beneficiary shall become available for the Truenat workflow.

1. User Story – AI Invalid Result

US-CXR-010: Handle AI Invalid Result

As a system,
I want to handle an AI Invalid Result by closing the current order and creating a new order for repeat testing,
so that an invalid AI result does not incorrectly complete the diagnostic workflow.

Acceptance Criteria

1. User/system records AI Invalid Result.
2. The result shall be saved against the current Order ID.
3. The current Order Status shall change to Closed.
4. The system shall automatically create a new Chest X-Ray Order ID for repeat testing.
5. The new Order ID shall have status Pending.
6. The new Order ID shall be associated with the same:
• Beneficiary ID
• Visit ID.
7. The previous Order ID shall remain available in the test history.
8. The system shall maintain the sequence/history of repeated X-Ray tests.

Example

Order ID: CXR-001

        │

        ▼

AI Invalid Result

        │

        ▼

CXR-001 = CLOSED

        │

        ▼

Create New Order

        │

        ▼

Order ID: CXR-002

Status = PENDING

        │

        ▼

Repeat Chest X-Ray

1. User Story – Chest X-Ray Not Conducted

US-CXR-011: Close Unconducted X-Ray Order

As a Radiographer/authorized user,
I want to close a Chest X-Ray order when the test is not conducted,
so that incomplete orders are properly accounted for.

Acceptance Criteria

1. The user shall have an option to mark the Chest X-Ray test as Not Conducted.
2. A reason shall be mandatory.
3. The system shall not allow the user to close the order without entering a reason.
4. The Order Status shall change to Closed.
5. The system shall store:
• Not Conducted reason
• User ID
• Date/time
• Order ID.
6. The closed order shall remain visible in the beneficiary's history.

Example Reasons

• Beneficiary unavailable
• Device unavailable
• Technical issue
• Beneficiary declined
• Time constraint
• Other

For Other, the user should be required to provide a description.

1. User Story – End-of-Day Order Closure

US-CXR-012: Automatically Close Open Orders

As a system,
I want to automatically close all eligible open Chest X-Ray orders at the end of the day,
so that there are no stale pending orders remaining from the day's camp activity.

Acceptance Criteria

At EoD, the system shall identify all Chest X-Ray orders for the current day that remain:

• Pending
• Test not conducted
• Result not entered

and change their status to Closed.

The system shall preserve the order history and closure timestamp.

Important Rule

An order shall not remain Pending after the end-of-day processing for that day's activity.

1. User Story – Create New Order from Closed Order

US-CXR-013: Reorder Chest X-Ray

As an authorized user,
I want to create a new Chest X-Ray Order ID from a previously closed order,
so that the beneficiary can undergo another Chest X-Ray when clinically required.

Acceptance Criteria

1. Closed orders shall remain visible on the beneficiary record/card.
2. The system shall provide a "Create New X-Ray Order" option.
3. Selecting the option shall generate a new unique Order ID.
4. The new order shall be associated with the current Visit ID where applicable.
5. The new order shall have status Pending.
6. The previous closed order shall remain unchanged.
7. The system shall maintain the complete test history.

1. User Story – Multiple Orders Against a Visit

US-CXR-014: Support Multiple Chest X-Ray Orders

As a system,
I want to allow multiple Chest X-Ray Order IDs against the same Visit ID,
so that repeat testing can be tracked without overwriting previous test records.

Acceptance Criteria

For example:

Beneficiary ID: BEN-001

        │

        ▼

Visit ID: VIS-001

        │

        ├── CXR-001 → AI Invalid → Closed

        │

        ├── CXR-002 → AI Invalid → Closed

        │

        └── CXR-003 → Normal → Completed

Each Order ID shall maintain its own:

• Test ID
• Result
• Status
• Date/time
• Performing user/device
• Reason, where applicable
• Test history.

1. Complete Functional Workflow

1. Business Rules

1. Key Data Relationships

Beneficiary

     │

     ▼

Visit ID

     │

     ├───────────────┬────────────────┬────────────────┐

     ▼               ▼                ▼                ▼

 CXR Order 1     CXR Order 2      CXR Order 3     Truenat Order

     │               │                │

     ▼               ▼                ▼

 Test ID          Test ID          Test ID

     │               │                │

  Result           Result           Result

     │               │                │

  Status           Status           Status

This design ensures that repeat Chest X-Ray attempts are never overwritten, while the Visit ID continues to provide a common clinical context for all tests performed during the beneficiary's visit.

Order has expired or has been closed because the test was not conducted, result was not entered, or the final result remained AI Invalid.