Merge branch 'dev' into 493-implement-rapid-order-creation-voice-text-in-client-mobile-app

apps/mobile/apps/client/CHANGELOG.md

@@ -0,0 +1,230 @@
+# Client Mobile App - Change Log
+
+## [v0.0.1-m3] - Milestone 3 - 2026-02-15
+
+### Added - Authentication & Onboarding
+- Business email and password authentication
+- Client account registration
+- Business onboarding flow
+- Company information setup
+
+### Added - Home Dashboard
+- Welcome screen with business name
+- Coverage statistics for today:
+  - Coverage percentage
+  - Workers checked in vs needed
+  - Open positions count
+- Late workers alerts with visual indicators
+- Today's estimated labor cost
+- Upcoming shifts section
+- Quick action buttons:
+  - Create Order
+  - Hubs management
+
+### Added - Hub Management
+- Hubs page accessible from settings
+- Hub creation flow:
+  - Hub name input
+  - Address autocomplete with Google Maps Places API
+  - Hub creation confirmation
+- Hubs list view showing all created hubs
+- Hub card display with name, address, and tag ID
+
+### Added - Order Creation
+- Orders tab in bottom navigation
+- "+ Post" button to create new orders
+- Order type selection screen:
+  - One-Time orders (implemented)
+- One-Time Order creation form:
+  - Order name
+  - Date picker
+  - Hub selection
+  - Position management:
+    - Role selection
+    - Worker count
+    - Start/end time
+    - Shift duration calculation
+  - Cost estimation
+- Order creation confirmation
+
+### Added - Order Management
+- Orders list view with:
+  - Order cards showing date, location, time
+  - Worker count (filled/needed)
+  - Coverage percentage bar
+  - Status indicators (OPEN, FILLED, IN PROGRESS)
+- Order details view:
+  - Event name and location
+  - Roles and worker requirements
+  - Clock in/out times
+  - Estimated cost
+  - Coverage percentage
+  - Map integration with directions
+
+### Added - Coverage Monitoring
+- Coverage tab in bottom navigation
+- Real-time worker status dashboard:
+  - Checked In (green indicator)
+  - En Route (yellow indicator)
+  - Late (red indicator)
+  - Not Arrived status
+- Color-coded status badges
+- Worker information cards
+- Active shift monitoring
+
+### Added - Navigation
+- Bottom navigation bar with tabs:
+  - Coverage
+  - Billing
+  - Home
+  - Orders
+  - Reports
+- Settings menu accessible from home screen
+- Back navigation handling
+
+### Added - Settings
+- Settings page with options:
+  - Hubs management
+  - Profile editing
+  - Notifications preferences
+  - Log out
+
+### Technical Features
+- Firebase authentication integration
+- Data Connect backend integration
+- Google Maps Places API for address autocomplete
+- Real-time worker status tracking
+- Cost calculation engine
+- Coverage percentage calculations
+
+### Known Limitations
+- Orders require hub assignment
+- Currently supports one-time orders only
+- Order approval flow not yet implemented
+- RAPID, Recurring, and Permanent order types are placeholders
+
+---
+
+## [v0.0.1-m4] - Milestone 4 - 2026-03-05
+
+### Added - Enhanced Authentication & Session Management
+- Authentication session persistence across app restarts
+- Automatic login with valid session tokens
+- Improved user experience with seamless session handling
+
+### Added - RAPID Order Creation (AI-Powered)
+- Voice input for order creation with audio recording
+- Text input for order description
+- Multi-platform audio recording support (iOS/Android)
+- AI transcription service for voice-to-text conversion
+- AI parsing to generate order drafts from natural language
+- Same-day order support for urgent coverage needs
+- Populated order form matching one-time order structure
+- Edit AI-generated order before submission
+- Quick order creation workflow
+- Audio file upload for transcription
+- RAPID order verification page with refinements
+- Hub and role matching for order creation
+
+### Added - Recurring Order Support
+- Recurring order creation flow
+- Schedule configuration interface
+- Recurring patterns (daily, weekly, custom)
+- Recurring order management
+
+### Added - Permanent Order Support
+- Permanent order creation flow
+- Long-term position setup
+- Permanent order management
+
+### Added - Enhanced Order Management
+- Hide edit icon for past or completed orders
+- Updated Reorder modal supporting all order types:
+  - One-Time reorder
+  - RAPID reorder
+  - Recurring reorder
+  - Permanent reorder
+- Reorder functionality with order type awareness
+- Hub manager assignment to orders
+- Cost center entity linking to hubs
+- Completion review UI with:
+  - Actions summary
+  - Amount display
+  - Info sections
+  - Worker listing
+- Invoice management improvements
+
+### Added - Comprehensive Reports System
+- Reports page with AI-powered insights
+- Three AI-generated insights on reports landing page
+- Six report types:
+  1. **Daily Ops Report**: Daily operational metrics and statistics
+  2. **Spend Report**: Labor cost analysis and spend tracking
+  3. **Coverage Report**: Shift coverage analytics and trends
+  4. **No-Show Report**: Worker attendance and no-show tracking
+  5. **Performance Report**: Worker performance metrics and ratings
+  6. *(Reserved for future report type)*
+
+### Added - Hub Management Enhancements
+- Dedicated hub details interface
+- Detailed hub information view
+- Hub editing page (separate interface)
+- Enhanced hub navigation
+
+### Added - Home Dashboard Enhancements
+- Reorder quick action button
+### Added - Home Dashboard Enhancements
+- Reorder quick action button for fast order duplication
+- Insights quick action button for AI analytics
+- Direct access to AI insights from home
+- Refactored home widgets with SectionLayout:
+  - Today's shifts section with titles
+  - Tomorrow's shifts section
+  - Coverage widget improvements
+  - Live activity widget enhancements
+  - Spending widget updates
+- Full-width dividers for better visual separation
+- Improved dashboard widget organization
+
+### Improved - User Experience
+- Better order type selection flow
+- Enhanced order creation UX across all types
+- Improved reports navigation
+- Better hub management interface
+- Bottom navigation bar show/hide based on route changes
+- Enhanced navigation robustness with error handling
+- Improved invoice page layout with reordered titles
+- Session management improvements with proper role validation
+- Enhanced settings page navigation flow
+- Better amount widget styling in completion review
+
+### Fixed
+- Client app crash issues resolved
+- Shift booking status inconsistencies fixed
+- Session navigation errors corrected
+- Formatting and code clarity improvements across codebase
+
+### Technical Features
+- Backend transaction support for order creation
+- Order validation (minimum hours check)
+- Shift creation validation
+- 24-hour cancellation policy enforcement
+- Enhanced backend reporting APIs
+- AI insights generation system
+- Core API integration:
+  - RAPID order transcription endpoints
+  - Order parsing services  
+  - File upload with signed URLs
+  - LLM services
+- ApiService with Dio for standardized API requests
+- DataConnectService integration across all repositories
+- Enhanced session management with SessionListener
+- Role-based session handling
+
+### Known Limitations
+- RAPID order parsing requires clear voice/text input
+- AI insights require sufficient historical data
+- Reports may have limited data in early usage
+- PDF export for reports not yet implemented
+
+---

apps/mobile/apps/client/pubspec.yaml

@@ -1,7 +1,7 @@
 name: krowwithus_client
 description: "KROW Client Application"
 publish_to: "none"
-version: 0.0.1-IlianaClientM4
+version: 0.0.1-m4
 resolution: workspace
 
 environment:

apps/mobile/apps/staff/CHANGELOG.md

@@ -0,0 +1,193 @@
+# Staff Mobile App - Change Log
+
+## [v0.0.1-m3] - Milestone 3 - 2026-02-15
+
+### Added - Authentication & Onboarding
+- Phone number authentication with OTP verification
+- Staff onboarding flow with profile setup
+- Personal information collection (name, bio, languages)
+- Preferred work locations selection
+- Skills and industry selection
+
+### Added - Home Dashboard
+- Welcome screen with personalized greeting
+- Today's shifts section showing confirmed shifts
+- Tomorrow's shifts preview
+- Recommended shifts section based on profile
+- Quick action buttons (Find Shifts, Availability, Messages, Earnings)
+
+### Added - Shift Management
+- Find Shifts functionality to discover available work
+- Shift details view showing:
+  - Business name and location
+  - Hourly rate and estimated earnings
+  - Date, start time, end time
+  - Job requirements
+  - Map integration with directions
+- Shift booking/application process
+- Booking confirmation dialog
+- My Shifts view with week-by-week navigation
+- Color-coded shift status (Confirmed, Pending, Completed)
+
+### Added - Clock In/Out
+- Clock In page with slider interaction
+- Clock Out page with slider interaction
+- Automatic timestamp recording
+- Shift status updates upon clock in/out
+- Visual status indicators (green for checked in)
+
+### Added - Profile Management
+- Profile tab with personal information
+- Emergency Contact management:
+  - Contact name
+  - Relationship
+  - Phone number
+- Bank Account linking for direct deposit
+- Tax Forms section:
+  - W-4 form access
+  - I-9 form access
+- Time Card view:
+  - Historical shift records
+  - Hours worked tracking
+  - Earnings history
+
+### Added - Navigation
+- Bottom navigation bar with 5 tabs:
+  - Shifts
+  - Payments
+  - Home
+  - Clock In
+  - Profile
+- Tab bar hiding on specific pages
+
+### Technical Features
+- Firebase authentication integration
+- Data Connect backend integration
+- Google Maps integration for locations
+- Phone verification system
+- OTP code handling
+
+### Known Limitations
+- Newly created orders don't appear immediately in Find Shifts (requires vendor approval)
+- Limited to one-time order types in this milestone
+
+---
+
+## [v0.0.1-m4] - Milestone 4 - 2026-03-05
+
+### Added - Enhanced Authentication & Session Management
+- Authentication session persistence across app restarts
+- Automatic login with valid session tokens
+- Improved user experience with seamless session handling
+
+### Added - Enhanced Shift Details
+- Google Maps location display in shift details view
+- Interactive map showing shift location
+- Directions integration
+- Shift requirements section showing:
+  - Required attire items (MUST HAVE)
+  - Preferred attire items (NICE TO HAVE)
+  - Other shift-specific requirements
+
+### Added - Attire Management
+- Dedicated Attire screen in profile
+- Camera and gallery support for attire photo capture
+- Local image preview before submission
+- Upload attire images for verification
+- MUST HAVE attire items list
+- NICE TO HAVE attire items list
+- Attire photo gallery in profile
+- Submit attire for review workflow
+- Attire verification status tracking (Pending, Approved, Rejected)
+- Attestation checkbox for attire accuracy confirmation
+- Filtered attire items based on requirements
+
+### Added - Documents & Certificates Management
+- Documents section in profile with verification status tracking
+- Upload documents (ID, licenses, etc.) with:
+  - Camera or gallery selection
+  - File type validation
+  - Upload progress tracking
+  - Verification metadata
+- Certificates management:
+  - Upload certificates with expiry dates
+  - Certificate number field
+  - Certificate type selection
+  - View existing certificates
+  - Delete certificates
+  - Verification status (Not Verified, Verified, Expired)
+- Mandatory document flagging
+- Document verification workflow
+
+### Added - Profile Enhancements
+- FAQ (Frequently Asked Questions) screen
+- Privacy and Security settings screen:
+  - Profile visibility toggle ("Hide account from business")
+  - Terms of Service document access
+  - Privacy Policy document access
+- Preferred locations management:
+  - Dedicated edit screen
+  - Location search functionality
+  - Display selected locations
+- Language selection interface:
+  - Spanish language support
+  - Success feedback on language change
+  - Persistent language preference
+- Benefits overview section:
+  - Benefits listing with circular progress indicators
+  - Benefits dashboard integration
+- Profile completion tracking for:
+  - Personal information
+  - Emergency contacts
+  - Experience
+  - Attire
+  - Documents
+  - Certificates
+
+### Added - Profile Completion Gating
+- Navigation restrictions for incomplete profiles
+- Only Home and Profile tabs accessible until profile is complete
+- Profile completion checklist
+- Guided onboarding completion flow
+
+### Improved - User Experience
+- Enhanced shift details UI with better information hierarchy
+- Improved profile section organization
+- Better navigation flow for profile completion
+- UiEmptyState widgets for better empty state handling:
+  - Bank account page empty state
+  - Home page when no shifts available
+- Improved onboarding flow with refactored experience and personal info pages
+- Enhanced emergency contact screen with info banner
+- Refactored profile header with profile level badge ("KROWER I")
+- Benefits card components with improved styling
+- Bottom navigation bar show/hide based on route
+- Tax forms page with progress overview
+- Improved notice and file type banners for uploads
+- Enhanced navigation robustness with proper error handling
+- Immediate ID token refresh after sign-in to prevent unauthenticated requests
+
+### Fixed
+- Profile completion status now updates correctly for emergency contacts
+- Session handling improved to prevent data loss
+- Navigation errors redirect to appropriate home page
+- Locale synchronization by reloading from persistent storage after change
+
+### Technical Features
+- Enhanced backend validation for shift acceptance
+- Overlapping shift prevention
+- Improved session management
+- Document upload and storage integration
+- Signed URL generation for file uploads
+- Camera and gallery native device access
+- File visibility controls (public/private)
+- Core API services integration (verification, file upload, LLM)
+- ApiService with Dio for standardized API requests
+- Device services abstraction layer
+
+### Known Limitations
+- Cannot accept overlapping shifts
+- Shifts require manual confirmation in some cases
+- Attire verification requires manual client approval
+
+---

apps/mobile/apps/staff/pubspec.yaml

@@ -1,7 +1,7 @@
 name: krowwithus_staff
 description: "KROW Staff Application"
 publish_to: 'none'
-version: 0.0.1-IlianaStaffM4
+version: 0.0.1-m4
 resolution: workspace
 
 environment: