Interventions

1. What does this feature do? (High-Level Overview)

This feature structures the intervention design section of the BIP so clinicians can define function-based treatment strategies in a single workflow, supporting clinical continuity and medical necessity by linking hypothesis text, function-specific plans (tangibles, attention, escape, automatic/sensory), direct intervention procedures, and RBT work-schedule rationale to the client’s behavioral presentation.

2. Who is this for? (Roles & Permissions)

• Superadmin/Admin/Owner/Manager (or any role granted manage_bips): Primary users of the tabbed BIP flow; can create, edit, and remove intervention content.
• RBT/Analyst without manage_bips: Usually redirected to full BIP read-only flow (/bip/show/patient/:id) instead of tabbed editing flow.
• Users without BIP access permissions (view_bips/manage_bips): Cannot access BIP actions from normal client workflows.

Required permissions used by this feature path:

• manage_bips: Required to remain in editable tabbed BIP route.
• view_bips: Used in non-tabbed BIP viewing entry points.

3. Business Rules & Enforcements

• Rule 1: This tab is defined as interventions with title Interventions in the BIP tab catalog.
• Rule 2: If no BIP exists yet, tab interaction is blocked globally and users must first create a BIP in the initial state.
• Rule 3: Any field change in the tab emits bipUpdated, and the parent container persists changes through debounced autosave.
• Rule 4: Tab completion for Interventions requires both conditions: at least one maladaptive goal and non-empty hypothesis_based_intervention text.
• Rule 5: Tab warning state is raised when maladaptive goals exist but hypothesis_based_intervention is empty.
• Rule 6: Function-based strategy lists (Tangibles, Attention, Escape, Automatic/Sensory) support add/edit/remove operations; delete actions require explicit confirmation.
• Rule 7: General intervention entries support title, analyst signature date, and description; delete action also requires explicit confirmation.
• Rule 8: Behavior Assistant Work Schedule is maintained as table rows; adding/removing rows updates BIP state, and row removal requires confirmation.

4. UI Placement

• Medical > client list > client actions > BIP View / Update.
• Inside BIP tabbed view: tab Interventions (tab id interventions).
• Route family used for tabbed BIP: /bip/tabbed/:patient_id and /:id route variant under BIP module.

5. How-To Guide (Step-by-Step)

Scenario A: Build hypothesis-based interventions

1. Go to Medical and open the client list.
2. Open client actions and click BIP View / Update.
3. Open tab Interventions.
4. Complete the hypothesis-based interventions narrative.
5. Add function-specific strategies for Tangibles, Attention, Escape, and Automatic/Sensory.
6. For each strategy, complete preventive strategies, replacement skills, and management strategies.
7. Wait for autosave confirmation/toast after edits.

Scenario B: Add direct intervention procedures

1. In Interventions, go to the Interventions card.
2. Click Add Intervention.
3. Enter intervention title.
4. Add analyst signature date.
5. Enter intervention description.
6. Repeat for additional procedures.

Scenario C: Maintain Behavior Assistant (RBT) work schedule

1. In Interventions, open Behavior Assistant Rationale.
2. Update introduction text.
3. Add/remove rows in the work schedule table as needed.
4. Edit each cell content inline.
5. Confirm deletion prompt when removing a row.

6. What happens if…? (Edge Cases / FAQ)

• Q: What happens if there are maladaptive goals but no hypothesis-based intervention text?

• A: The tab is flagged with warning/error state in tab validation, and it is not marked complete.

• Q: Can I remove a strategy or intervention accidentally?

• A: Deletion flows require explicit confirmation dialogs before the row/item is removed.

• Q: What happens if the BIP has not been created yet?

• A: Interventions tab cannot be used until a BIP exists; the user is kept in the create-BIP initial flow first.