From c906d70812be7e446fef536b1771bdf9fbeec064 Mon Sep 17 00:00:00 2001 From: Achintha Isuru Date: Thu, 12 Feb 2026 17:00:42 -0500 Subject: [PATCH] feat: Add M4 Planning Phase documentation outlining identified discrepancies and proposed enhancements --- .../M4/planning/m4-discrepencies.md | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 docs/MILESTONES/M4/planning/m4-discrepencies.md diff --git a/docs/MILESTONES/M4/planning/m4-discrepencies.md b/docs/MILESTONES/M4/planning/m4-discrepencies.md new file mode 100644 index 00000000..75053860 --- /dev/null +++ b/docs/MILESTONES/M4/planning/m4-discrepencies.md @@ -0,0 +1,47 @@ +# M4 Planning Phase: Identified Discrepancies and Enhancements + +## Feedback and Discrepancies (Based on M3 Review done by Iliana) + +### Mobile Application (Client & Staff) +- **Flexible Shift Locations:** Feedback from the M3 review indicated a need for the ability to specify different locations for individual positions within an order on the mobile app. Currently, the web application handles this by requiring a separate shift for each location. + +- **Order Visibility Management:** Currently, when an order is created with multiple positions, the "View Order" page displays them as separate orders. This is due to UI (prototype) cannot support multi-position views in the order. We should consider adopting the "legacy" app's approach to group these positions under a single order for better clarity. + +- **Cost Center Clarification:** The purpose and functionality of the "Cost Center" field in the Hub creation process is not clear. + +- **Tax Form Data Completeness:** Feedback noted that while tax forms are visible in the Staff mobile application, they appear to be missing critical information. This not clear. + +### Web Dashboard +- **Role-Based Content Logic:** The current web dashboard prototype contains some logical inconsistencies regarding user roles: + - **Client Dashboard:** Currently includes Staff Availability, Staff Directory, and Staff Onboarding. Since workers (Staff) are managed by Vendors, these pages should be moved to the Vendor dashboard. + + - **Vendor Dashboard:** Currently includes "Teams and Hubs." Since Hubs are client-specific locations where staff clock in/out, these management pages should be moved to the Client dashboard. + +- **Admin Dashboard Filtering:** The Admin dashboard requires improved filtering capabilities. Admins should be able to select specific Clients or Vendors to filter related data, such as viewing only the orders associated with a chosen partner. + +## Proposed Features and Enhancements (Post-M3 Identification) + +- **Feature: Navigation to Hub Details from Coverage Screen (#321)** + - **Description:** Allow users to navigate directly to the Hub Details page by clicking on a hub within the Coverage Screen. + +- **Feature: Dedicated Hub Details Screen with Order History (#320)** + - **Description:** Develop a comprehensive Hub Details view that aggregates all hub-specific data, including historical order records. + - **Benefit:** Centralizes information for better decision-making and easier access to historical data. + +- **Feature: Dedicated Order Details Screen** + - **Description:** Transition from displaying all order information on the primary "View Order" page to a dedicated "Order Details" screen. This screen will support viewing multiple positions within a single order. + - **Benefit:** + - **Improved UX:** Reduces complexity by grouping associated positions together and presenting them in a structured way. + - **Performance:** Optimizes data loading by fetching detailed position information only when requested. + +- **Feature: Optimized Clock-In Page (#350)** + - **Description:** Remove the calendar component from the Clock-In page. Since workers only clock in for current-day assignments, the calendar is unnecessary. + - **Benefit:** Simplifies the interface and reduces user confusion. + +- **Feature: Contextual Shift Actions** + - **Description:** Restrict the Clock-In page to show only active or upcoming shifts (starting within 30 minutes). Shift-specific actions (Clock-In/Clock-Out) should be performed within the specific Shift Details page. + - **Reasoning:** This solves issues where staff cannot clock out of overnight shifts (shifts starting one day and ending the next) due to the current day-based UI. + +- **Feature: Dedicated Emergency Contact Management (#356)** + - **Description:** Replace the inline form in the "View Emergency Contact" page with a dedicated "Create Emergency Contact" screen. + - **Benefit:** Standardizes the data entry process and improves UI organization within the Staff app.