Ignore Time Limits for BCBA Notes

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

This feature allows authorized users to create or update BCBA notes even when standard time-based restrictions would normally block the save. It helps managers and designated staff resolve operational exceptions without disabling core schedule safety controls.

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

• Users with ignore_time_limits in the current location: Can save BCBA notes without daily/weekly hour limits, backdating limits, and CPT-per-day limits.
• Superadmin: Has the same bypass behavior for those limits through global role logic.
• BCBA/Analyst without ignore_time_limits: Must follow all configured time, backdating, and CPT limits.

Required permission:

• ignore_time_limits (location-scoped permission).

Related permission context:

• manage_notes does not replace ignore_time_limits for all validations, but it is considered in some edit and backdating workflows.

3. Business Rules & Enforcements

• Rule 1: With ignore_time_limits, BCBA note requests skip time-limit validation (daily and weekly hour caps).
• Rule 2: With ignore_time_limits, BCBA note requests skip backdating-limit validation.
• Rule 3: With ignore_time_limits, BCBA note requests skip CPT daily unit-limit validation.
• Rule 4: Overlap validation is still enforced, even when the user has ignore_time_limits or is Superadmin.
• Rule 5: Provider ownership and note edit authorization rules still apply (for example, editing another provider’s note still requires manage_notes).
• Rule 6: Standard field-level validations (required fields, date/time format, chronological order, future date/time restrictions) are still enforced.

4. UI Placement

1. Notes > BCBA Notes list: Open BCBA notes and create or edit a note.
2. Create route: /note-bcba/:patient_id (or appointment flow /note-bcba/:patient_id/:appointment_id).
3. Edit route: /note-bcba/edit/:patient_id/:id.
4. Role/permission assignment area: Admin role management screens where ignore_time_limits is granted for the location.

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

Scenario A: Manager creates a BCBA note outside configured limits

1. Confirm the user has ignore_time_limits for the active location.
2. Open BCBA note creation for the patient.
3. Enter DOS, times, CPT, and required clinical fields.
4. Save the note, even if normal daily/weekly/backdating/CPT limits would otherwise block it.
5. Review the success response and confirm the note appears in the patient BCBA list.

Scenario B: Authorized user updates an older BCBA note that would normally fail backdating/CPT checks

1. Open the note in edit mode.
2. Confirm the active location and that the user has ignore_time_limits.
3. Apply required changes (time block, CPT-related fields, or session date updates).
4. Save the note.
5. Confirm the update succeeds, as long as overlap and base validation rules are still satisfied.

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

• Q: What happens if a user has ignore_time_limits but creates an overlapping BCBA session? A: The save is still rejected. Overlap rules remain active.

• Q: What happens if a user has ignore_time_limits but tries to edit another provider’s note without manage_notes? A: The update is blocked by authorization rules.

• Q: What happens if a user does not have ignore_time_limits and exceeds configured limits? A: The request is rejected with validation errors for time limits, backdating limits, or CPT limits (depending on what was exceeded).