Files

Achintha Isuru b8d07380c0 replace the "Krow" with "KROW"

2026-02-26 15:13:26 -05:00

8.3 KiB

Raw Blame History

Client Application: Use Case Overview

This document details the primary business actions and user flows within the Client Mobile Application. It is organized according to the application's logical structure and navigation flow.

1. Application Access & Authentication

1.1 Initial Startup & Auth Check

Actor: Business Manager
Description: The system determines if the user is already logged in or needs to authenticate.
Main Flow:
1. User opens the application.
2. System checks for a valid session.
3. If authenticated, user is directed to the Home Dashboard.
4. If unauthenticated, user is directed to the Get Started screen.

Actor: New Business Manager
Description: Creating a new identity for the business on the KROW platform.
Main Flow:
1. User taps "Sign Up".
2. User enters company details (Name, Industry).
3. User enters contact information and password.
4. User confirms registration and is directed to the Main App.

Actor: Existing Business Manager
Description: Accessing an existing account.
Main Flow:
1. User enters registered email and password.
2. System validates credentials.
3. User is granted access to the dashboard.

2. Order Management (Requesting Staff)

2.1 Rapid Order (Urgent Needs)

Actor: Business Manager
Description: Posting a shift for immediate, same-day fulfillment.
Main Flow: Taps "RAPID" -> Selects Role -> Sets Quantity -> Confirms ASAP status -> Posts Order.

2.2 Scheduled Orders (Planned Needs)

Actor: Business Manager
Description: Planning for future staffing requirements.
Main Flow:
1. User selects "Create Order".
2. User chooses the frequency:
  - One-Time: A single specific shift.
  - Recurring: Shifts that repeat on a schedule (e.g., every Monday).
  - Permanent: Long-term staffing placement.
3. User enters date, time, role, and location.
4. User reviews cost and posts the order.

3. Operations & Workforce Management

3.1 Monitor Today's Coverage (Coverage Tab)

Actor: Business Manager
Description: A bird's-eye view of all shifts happening today.
Main Flow: User navigates to "Coverage" tab -> Views percentage filled -> Identifies open gaps -> Re-posts unfilled shifts if necessary.

3.2 Live Activity Tracking

Actor: Business Manager
Description: Real-time feed of worker clock-ins and status updates.
Location: Home Tab / Coverage Detail.
Main Flow: User monitors the live feed for worker arrivals and on-site status.

3.3 Verify Worker Attire

Actor: Business Manager / Site Supervisor
Description: Ensuring staff arriving on-site meet the required dress code.
Main Flow: User selects an active shift -> Selects worker -> Checks attire compliance (shoes, uniform, ID) -> Submits verification.

3.4 Review & Approve Timesheets

Actor: Business Manager
Description: Finalizing hours worked for payroll processing.
Main Flow: User navigates to "Timesheets" -> Reviews actual vs. scheduled hours -> Taps "Approve" or "Dispute".

4. Reports & Analytics

4.1 Business Intelligence Reporting

Actor: Business Manager / Executive
Description: Accessing data visualizations to optimize business operations.
Available Reports:
- Daily Ops: Day-to-day fulfillment and performance.
- Spend Report: Financial breakdown of labor costs.
- Forecast: Projected staffing needs and costs.
- Performance: Worker and vendor reliability scores.
- No-Show: Tracking attendance issues.
- Coverage: Detailed fill-rate analysis.

5. Billing & Administration

5.1 Financial Management (Billing Tab)

Actor: Business Manager / Finance Admin
Description: Reviewing invoices and managing payment methods.
Main Flow: User navigates to "Billing" -> Views current balance -> Downloads past invoices -> Updates credit card/ACH info.

5.2 Manage Business Locations (Hubs)

Actor: Business Manager
Description: Defining different venues or branches where staff will be sent.
Main Flow: User goes to Settings -> Client Hubs -> Adds/Edits location details and addresses.

5.3 Profile & Settings Management

Actor: Business Manager
Description: Updating personal contact info and notification preferences.
Main Flow: User goes to Settings -> Edits Profile -> Toggles notification settings for shift updates and billing alerts.

Use Case Diagram

flowchart TD
    subgraph AppInitialization [App Initialization]
        Start[Start App] --> CheckAuth{Check Auth Status}
        CheckAuth -- Authenticated --> GoHome[Go to Main App]
        CheckAuth -- Unauthenticated --> GetStarted[Go to Get Started]
    end

    subgraph Authentication [Authentication]
        GetStarted --> AuthChoice{Select Option}
        AuthChoice -- Sign In --> SignIn[Sign In Screen]
        AuthChoice -- Sign Up --> SignUp[Sign Up Screen]
        
        SignIn --> EnterCreds[Enter Credentials]
        EnterCreds --> VerifySignIn{Verify}
        VerifySignIn -- Success --> GoHome
        VerifySignIn -- Failure --> SignInError[Show Error]
        
        SignUp --> EnterBusinessDetails[Enter Business Details]
        EnterBusinessDetails --> CreateAccount[Create Account]
        CreateAccount -- Success --> GoHome
    end

    subgraph MainApp [Main Application Shell]
        GoHome --> Shell[Scaffold with Nav Bar]
        Shell --> TabNav{Tab Navigation}
        
        TabNav -- Index 0 --> Coverage[Coverage Tab]
        TabNav -- Index 1 --> Billing[Billing Tab]
        TabNav -- Index 2 --> Home[Home Tab]
        TabNav -- Index 3 --> Orders[Orders/Shifts Tab]
        TabNav -- Index 4 --> Reports[Reports Tab]
    end

    subgraph HomeActions [Home Tab Actions]
        Home --> CreateOrderAction{Create Order}
        CreateOrderAction -- Rapid --> RapidOrder[Rapid Order Flow]
        CreateOrderAction -- One-Time --> OneTimeOrder[One-Time Order Flow]
        CreateOrderAction -- Recurring --> RecurringOrder[Recurring Order Flow]
        CreateOrderAction -- Permanent --> PermanentOrder[Permanent Order Flow]
        
        Home --> QuickActions[Quick Actions Widget]
        Home --> Settings[Go to Settings]
        Home --> Hubs[Go to Client Hubs]
    end

    subgraph OrderManagement [Order Management Flows]
        RapidOrder --> SubmitRapid[Submit Rapid Order]
        OneTimeOrder --> SubmitOneTime[Submit One-Time Order]
        RecurringOrder --> SubmitRecurring[Submit Recurring Order]
        PermanentOrder --> SubmitPermanent[Submit Permanent Order]
        
        SubmitRapid --> OrderSuccess[Order Success]
        SubmitOneTime --> OrderSuccess
        SubmitRecurring --> OrderSuccess
        SubmitPermanent --> OrderSuccess
        OrderSuccess --> Home
    end

    subgraph ReportsAnalysis [Reports & Analytics]
        Reports --> SelectReport{Select Report}
        SelectReport -- Daily Ops --> DailyOps[Daily Ops Report]
        SelectReport -- Spend --> SpendReport[Spend Report]
        SelectReport -- Forecast --> ForecastReport[Forecast Report]
        SelectReport -- Performance --> PerfReport[Performance Report]
        SelectReport -- No-Show --> NoShowReport[No-Show Report]
        SelectReport -- Coverage --> CovReport[Coverage Report]
    end

    subgraph WorkforceMgmt [Workforce Management]
        Orders --> ViewShifts[View Shifts List]
        ViewShifts --> ShiftDetail[View Shift Detail]
        ShiftDetail --> VerifyAttire[Verify Attire]
        
        Home --> ViewWorkers[View Workers List]
        Home --> ViewTimesheets[View Timesheets]
        ViewTimesheets --> ApproveTime[Approve Hours]
        ViewTimesheets --> DisputeTime[Dispute Hours]
    end

    subgraph SettingsFlow [Settings & Configuration]
        Settings --> EditProfile[Edit Profile]
        Settings --> ManageHubsLink[Manage Hubs]
        Hubs --> AddHub[Add New Hub]
        Hubs --> EditHub[Edit Existing Hub]
    end

    %% Relationships across subgraphs
    OrderSuccess -.-> Coverage
    VerifySignIn -.-> Shell
    CreateAccount -.-> Shell

8.3 KiB Raw Blame History