Krow-workspace/apps/mobile/apps/client/CHANGELOG.md

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

---