Initial Interview

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

This feature shows the client’s Initial Interview (Initial Assessment) data inside the BIP tabbed workflow so clinicians can review foundational intake context while building the plan, improving clinical continuity by keeping interview context and BIP editing in one flow, and functioning as the initial clinical-behavioral history that helps the team understand the client before defining goals and interventions by bringing together developmental background, family/school context, health status, comorbidities, risk behaviors, and prior treatments.

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

• Superadmin/Admin/Owner/Manager (or any role granted manage_bips): Can access the tab and view the Initial Interview form content in the tabbed BIP flow.
• RBT/Analyst without manage_bips: In this tab implementation, they see a permission warning from the embedded Initial Assessment component and do not see the form body.
• Users without BIP access permissions (view_bips/manage_bips): Cannot reach this tab from normal client actions.

Required permissions used by this feature path:

• manage_bips: Required by the embedded Initial Assessment component to render the form content.
• view_bips: Allows BIP view entry points in client actions (outside this tab component).

3. Business Rules & Enforcements

• Rule 1: The tab exists in the tab list as initial_interview and is the first tab in the sequence.
• Rule 2: If no BIP exists yet, tab navigation is disabled and users are shown the fused create flow (app-bip-add-initial-assessment) instead of normal tab content.
• Rule 3: A BIP can be created even if required Initial Interview fields are still incomplete.
• Rule 4: Inside this tab, the embedded Initial Assessment component is forced to read-only mode (allreadonly=true) and action controls are hidden (hideActions=true).
• Rule 5: The embedded form loads by bipId (findByBip) to show the Initial Interview associated with the active BIP.
• Rule 6: Initial Assessment permission checks still apply inside the embedded component; without manage_bips, the component shows “You do not have permission to create assessments.”
• Rule 7: Observation date is validated to disallow future dates (standard Initial Assessment validation), even though this tab is rendered read-only.
• Rule 8: The Initial Interview now includes a Functional Impairment section with additional questions to capture more detailed clinical context.
• Rule 9: Maladaptives were added within the same Functional Impairment section to document behavior concerns as part of the interview context.

4. UI Placement

• Medical > clients list > client actions > BIP View / Update.
• Inside BIP tabbed view: first tab Initial Interview (icon fas fa-user-edit).
• 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: Review Initial Interview from BIP tabbed view

1. Go to Medical and open the clients list.
2. Open client actions and click BIP View / Update.
3. In the tabbed interface, open Initial Interview (usually preselected as first tab).
4. Review observation, household, school/daycare, treatments, health behavior, and related intake fields.

Scenario B: No BIP exists yet

1. Open BIP tabbed view for a client with no existing BIP.
2. The system shows the fused create state (app-bip-add-initial-assessment) instead of normal tabs.
3. Create the BIP, even if required Initial Interview fields are not fully completed yet.
4. After successful creation, the system enables tabs and moves to Initial Interview.
5. Complete remaining Initial Interview information, including Functional Impairment questions and related Maladaptives details.

Scenario C: Permission-limited user enters tabbed flow

1. Open BIP tabbed view as a user without manage_bips.
2. Navigate to Initial Interview.
3. The embedded Initial Assessment component shows a permission warning and hides form interactions/content.

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

• Q: What happens if the BIP exists but there is no Initial Interview linked to that BIP?

• A: The embedded component attempts to load by bipId; if no record is found, it emits an internal event (noAssessmentForBip). In this tab integration, no custom handler is wired, so users effectively see the non-populated embedded state.

• Q: Can users edit Initial Interview data from this tab?

• A: No. In this feature path the component is explicitly mounted as read-only and with hidden actions (allreadonly=true, hideActions=true).

• Q: Can a BIP be created if required Initial Interview fields are still missing?

• A: Yes. The current flow allows BIP creation without completing all required Initial Interview fields at creation time. Missing information can be completed afterward.

• Q: What is new in the Initial Interview structure?

• A: The interview now includes a Functional Impairment section with additional questions and Maladaptives in the same section to provide more complete clinical context.

• Q: Is this tab included/excluded by insurance feature flags?

• A: No. Initial Interview has no feature-flag condition in tab definitions; it remains part of the base tab set.