# 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

---
