# KROW Workforce Platform — M4 Guide

**Version:** Milestone 4 (0.0.1-IlianaStaffM4 and 0.0.1-IlianaClientM4)
**Estimated Duration:** 25-30 minutes

---

## 📦 Deliverables

- **Client Mobile Application** (v0.0.1-IlianaClientM4)
- **Staff Mobile Application** (v0.0.1-IlianaStaffM4)
- **Full Demo Video** - Comprehensive walkthrough of all (M1 - M4) completed features of the mobile applications.

---

## 1. Overview

### Core Improvements
M4 delivers three key areas of improvement:

1. **Overall Application Improvements**
   - Auth session persistence: Users stay signed in after reopening the app
   - Stability fixes from M3 client feedback and dev team discoveries
   - UI/UX improvements across key screens for clarity and speed

2. **Client App Updates**
   - Complete order creation flow (Rapid, Permanent, Recurring orders)
   - Shift manager assignment support
   - Paid/unpaid break handling in orders
   - Complete Reports section (Daily Ops, Spend, Coverage, No-show, Performance)
   - Cost centres in hubs for location/business unit tracking
   - Billing approval workflow for pending bills

3. **Staff App Updates**
   - Profile completion requirements gating payments and clockings
   - Worker benefits integration
   - Enhanced shift discovery with filtering by location
   - Spanish localization support
   - AI-verified document uploads (Attire, Documents, Certificates)
   - FAQ and Privacy Policy
   - Worker profile visibility controls

---

## 2. Required Test Accounts

**Client Account (Business User):**
- Email: `legendary@krowd.com`
- Password: `Demo2026!`
- Client Name: "KROW"

**Staff Account (Worker):**
- Phone: `+15557654321`
- OTP Code: `123456` (testing mode)
- Name: "Mariana Torres"

***Note on Profile Completion***
When a staff user hasn't completed their profile, they see an empty/incomplete state on their home screen. Currently tracked sections to mark as complete:
- Profile Information (full name, email, phone, preferred locations)
- Emergency Contact

Future sections can be added as mandatory, such as Tax Forms, Bank Account, Documents, Certificates, and Attires.

***Profile Blocking Rules***
When the profile is incomplete, the following features are blocked to encourage completion:
- Clock-in page is hidden
- Payments are blocked
- "My Shifts" and History sections are hidden
- Users can view available shifts but cannot book them

This ensures we have all necessary information for compliance and payroll before workers are allowed to work.

---

## 3. M4 Key Deliverables

✅ Stronger reliability and stability
✅ Completed client ordering and reporting workflows
✅ Better profile and shift tooling for staff
✅ AI-assisted document verification
✅ Localization support (Spanish)
✅ Improved billing and cost tracking controls
