From 5eea0d38cc4ab0d657954d083310fa992274e255 Mon Sep 17 00:00:00 2001 From: Suriya Date: Tue, 24 Feb 2026 22:10:32 +0530 Subject: [PATCH] api-contracts --- docs/api-contracts.md | 281 ++++++++++++++++++++++++++++------------- docs/available_gql.txt | Bin 0 -> 16316 bytes 2 files changed, 191 insertions(+), 90 deletions(-) create mode 100644 docs/available_gql.txt diff --git a/docs/api-contracts.md b/docs/api-contracts.md index fd1f30e1..900608e3 100644 --- a/docs/api-contracts.md +++ b/docs/api-contracts.md @@ -1,266 +1,367 @@ # KROW Workforce API Contracts -This document captures all API contracts used by the Staff and Client mobile applications. It serves as a single reference document to understand what each endpoint does, its expected inputs, returned outputs, and any non-obvious details. +This document captures all API contracts used by the Staff and Client mobile applications. The application backend is powered by **Firebase Data Connect (GraphQL)**, so traditional REST endpoints do not exist natively. For clarity and ease of reading for all engineering team members, the tables below formulate these GraphQL Data Connect queries and mutations into their **Conceptual REST Endpoints** alongside the actual **Data Connect Operation Name**. --- ## Staff Application -### Authentication / Onboarding Pages (Get Started, Intro, Phone Verification, Profile Setup, Personal Info) +### Authentication / Onboarding Pages +*(Pages: get_started_page.dart, intro_page.dart, phone_verification_page.dart, profile_setup_page.dart)* + #### Setup / User Validation API | Field | Description | |---|---| -| **Endpoint name** | `/getUserById` | -| **Purpose** | Retrieves the base user profile to determine authentication status and role access (e.g., if user is STAFF). | +| **Conceptual Endpoint** | `GET /users/{id}` | +| **Data Connect OP** | `getUserById` | +| **Purpose** | Retrieves the base user profile to determine authentication status and role access (e.g., if the user is STAFF). | | **Operation** | Query | | **Inputs** | `id: UUID!` (Firebase UID) | | **Outputs** | `User { id, email, phone, role }` | -| **Notes** | Required after OTP verification to route users. | +| **Notes** | Required after OTP verification to route users appropriately. | #### Create Default User API | Field | Description | |---|---| -| **Endpoint name** | `/createUser` | +| **Conceptual Endpoint** | `POST /users` | +| **Data Connect OP** | `createUser` | | **Purpose** | Inserts a base user record into the system during initial signup. | | **Operation** | Mutation | | **Inputs** | `id: UUID!`, `role: UserBaseRole` | | **Outputs** | `id` of newly created User | -| **Notes** | Used explicitly during the "Sign Up" flow if the user doesn't exist. | +| **Notes** | Used explicitly during the "Sign Up" flow if the user doesn't physically exist in the database. | #### Get Staff Profile API | Field | Description | |---|---| -| **Endpoint name** | `/getStaffByUserId` | +| **Conceptual Endpoint** | `GET /staff/user/{userId}` | +| **Data Connect OP** | `getStaffByUserId` | | **Purpose** | Finds the specific Staff record associated with the base user ID. | | **Operation** | Query | | **Inputs** | `userId: UUID!` | | **Outputs** | `Staffs { id, userId, fullName, email, phone, photoUrl, status }` | -| **Notes** | Needed to verify if a complete staff profile exists before fully authenticating. | +| **Notes** | Needed to verify if a complete staff profile exists before allowing navigation to the main app dashboard. | #### Update Staff Profile API | Field | Description | |---|---| -| **Endpoint name** | `/updateStaff` | +| **Conceptual Endpoint** | `PUT /staff/{id}` | +| **Data Connect OP** | `updateStaff` | | **Purpose** | Saves onboarding data across Personal Info, Experience, and Preferred Locations pages. | | **Operation** | Mutation | -| **Inputs** | `id: UUID!`, `fullName`, `email`, `phone`, `addres`, etc. | +| **Inputs** | `id: UUID!`, `fullName`, `email`, `phone`, `address`, etc. | | **Outputs** | `id` | -| **Notes** | Called incrementally during profile setup wizard. | +| **Notes** | Called incrementally during the profile setup wizard as the user fills out step-by-step information. | + +### Home Page & Benefits Overview +*(Pages: worker_home_page.dart, benefits_overview_page.dart)* -### Home Page (worker_home_page.dart) & Benefits Overview #### Load Today/Tomorrow Shifts | Field | Description | |---|---| -| **Endpoint name** | `/getApplicationsByStaffId` | +| **Conceptual Endpoint** | `GET /staff/{staffId}/applications` | +| **Data Connect OP** | `getApplicationsByStaffId` | | **Purpose** | Retrieves applications (shifts) assigned to the current staff member within a specific date range. | | **Operation** | Query | | **Inputs** | `staffId: UUID!`, `dayStart: Timestamp`, `dayEnd: Timestamp` | | **Outputs** | `Applications { shift, shiftRole, status, createdAt }` | -| **Notes** | The frontend filters the query response for `CONFIRMED` applications to display "Today's" and "Tomorrow's" shifts. | +| **Notes** | The frontend filters the query response for `CONFIRMED` applications to successfully display "Today's" and "Tomorrow's" shifts. | #### List Recommended Shifts | Field | Description | |---|---| -| **Endpoint name** | `/listShifts` | +| **Conceptual Endpoint** | `GET /shifts/recommended` | +| **Data Connect OP** | `listShifts` | | **Purpose** | Fetches open shifts that are available for the staff to apply to. | | **Operation** | Query | -| **Inputs** | None directly mapped, but filters OPEN shifts purely on the client side at the time. | +| **Inputs** | None directly mapped on load, but fetches available items logically. | | **Outputs** | `Shifts { id, title, orderId, cost, location, startTime, endTime, status }` | -| **Notes** | Limits output to 10 on the frontend. Should ideally rely on a `$status: OPEN` parameter. | +| **Notes** | Limits output to 10 on the frontend. Should ideally rely on an active backend `$status: OPEN` parameter. | #### Benefits Summary API | Field | Description | |---|---| -| **Endpoint name** | `/listBenefitsDataByStaffId` | -| **Purpose** | Retrieves accrued benefits (e.g., Sick time, Vacation) to display on the home screen. | +| **Conceptual Endpoint** | `GET /staff/{staffId}/benefits` | +| **Data Connect OP** | `listBenefitsDataByStaffId` | +| **Purpose** | Retrieves accrued benefits (e.g., Sick time, Vacation) to display gracefully on the home screen. | | **Operation** | Query | | **Inputs** | `staffId: UUID!` | | **Outputs** | `BenefitsDatas { vendorBenefitPlan { title, total }, current }` | -| **Notes** | Calculates `usedHours = total - current`. | +| **Notes** | Used by `benefits_overview_page.dart`. Derives available metrics via `usedHours = total - current`. | + +### Find Shifts / Shift Details Pages +*(Pages: shifts_page.dart, shift_details_page.dart)* -### Find Shifts / Shift Details Pages (shifts_page.dart) #### List Available Shifts Filtered | Field | Description | |---|---| -| **Endpoint name** | `/filterShifts` | +| **Conceptual Endpoint** | `GET /shifts` | +| **Data Connect OP** | `filterShifts` | | **Purpose** | Used to fetch Open Shifts in specific regions when the worker searches in the "Find Shifts" tab. | | **Operation** | Query | | **Inputs** | `$status: ShiftStatus`, `$dateFrom: Timestamp`, `$dateTo: Timestamp` | | **Outputs** | `Shifts { id, title, location, cost, durationDays, order { business, vendor } }` | -| **Notes** | - | +| **Notes** | Main driver for discovering available work. | #### Get Shift Details | Field | Description | |---|---| -| **Endpoint name** | `/getShiftById` | -| **Purpose** | Gets deeper details for a single shift including exact uniform/managers needed. | +| **Conceptual Endpoint** | `GET /shifts/{id}` | +| **Data Connect OP** | `getShiftById` | +| **Purpose** | Gets deeper details for a single shift including exact uniform requirements and managers. | | **Operation** | Query | | **Inputs** | `id: UUID!` | | **Outputs** | `Shift { id, title, hours, cost, locationAddress, workersNeeded ... }` | -| **Notes** | - | +| **Notes** | Invoked when users click into a full `shift_details_page.dart`. | #### Apply To Shift | Field | Description | |---|---| -| **Endpoint name** | `/createApplication` | -| **Purpose** | Worker submits an intent to take an open shift. | +| **Conceptual Endpoint** | `POST /applications` | +| **Data Connect OP** | `createApplication` | +| **Purpose** | Worker submits an intent to take an open shift (creates an application record). | | **Operation** | Mutation | -| **Inputs** | `shiftId`, `staffId`, `status: APPLIED` | -| **Outputs** | `Application ID` | -| **Notes** | A shift status will switch to `CONFIRMED` via admin approval. | +| **Inputs** | `shiftId: UUID!`, `staffId: UUID!`, `roleId: UUID!`, `status: ApplicationStatus!` (e.g. `PENDING` or `CONFIRMED`), `origin: ApplicationOrigin!` (e.g. `STAFF`); optional: `checkInTime`, `checkOutTime` | +| **Outputs** | `application_insert.id` (Application ID) | +| **Notes** | The app uses `status: CONFIRMED` and `origin: STAFF` when claiming; backend also supports `PENDING` for admin review flows. After creation, shift-role assigned count and shift filled count are updated. | + +### Availability Page +*(Pages: availability_page.dart)* -### Availability Page (availability_page.dart) #### Get Default Availability | Field | Description | |---|---| -| **Endpoint name** | `/listStaffAvailabilitiesByStaffId` | +| **Conceptual Endpoint** | `GET /staff/{staffId}/availabilities` | +| **Data Connect OP** | `listStaffAvailabilitiesByStaffId` | | **Purpose** | Fetches the standard Mon-Sun recurring availability for a staff member. | | **Operation** | Query | | **Inputs** | `staffId: UUID!` | | **Outputs** | `StaffAvailabilities { dayOfWeek, isAvailable, startTime, endTime }` | -| **Notes** | - | +| **Notes** | Bound to Monday through Sunday configuration. | #### Update Availability | Field | Description | |---|---| -| **Endpoint name** | `/updateStaffAvailability` (or `createStaffAvailability`) | +| **Conceptual Endpoint** | `PUT /staff/availabilities/{id}` | +| **Data Connect OP** | `updateStaffAvailability` (or `createStaffAvailability` for new entries) | | **Purpose** | Upserts availability preferences. | | **Operation** | Mutation | | **Inputs** | `staffId`, `dayOfWeek`, `isAvailable`, `startTime`, `endTime` | | **Outputs** | `id` | | **Notes** | Called individually per day edited. | -### Payments Page (payments_page.dart) +### Payments Page +*(Pages: payments_page.dart, early_pay_page.dart)* + #### Get Recent Payments | Field | Description | |---|---| -| **Endpoint name** | `/listRecentPaymentsByStaffId` | +| **Conceptual Endpoint** | `GET /staff/{staffId}/payments` | +| **Data Connect OP** | `listRecentPaymentsByStaffId` | | **Purpose** | Loads the history of earnings and timesheets completed by the staff. | | **Operation** | Query | | **Inputs** | `staffId: UUID!` | | **Outputs** | `Payments { amount, processDate, shiftId, status }` | -| **Notes** | Displays historical metrics under Earnings tab. | +| **Notes** | Displays historical metrics under the comprehensive Earnings tab. | + +### Compliance / Profiles +*(Pages: certificates_page.dart, documents_page.dart, tax_forms_page.dart, form_i9_page.dart, form_w4_page.dart)* -### Compliance / Profiles (Agreements, W4, I9, Documents) #### Get Tax Forms | Field | Description | |---|---| -| **Endpoint name** | `/getTaxFormsByStaffId` | -| **Purpose** | Check the filing status of I9 and W4 forms. | +| **Conceptual Endpoint** | `GET /staff/{staffId}/tax-forms` | +| **Data Connect OP** | `getTaxFormsByStaffId` | +| **Purpose** | Check the filing status and detailed inputs of I9 and W4 forms. | | **Operation** | Query | | **Inputs** | `staffId: UUID!` | | **Outputs** | `TaxForms { formType, isCompleted, updatedDate }` | -| **Notes** | Required for staff to be eligible for shifts. | +| **Notes** | Crucial requirement for staff to be eligible to apply for highly regulated shifts. | #### Update Tax Forms | Field | Description | |---|---| -| **Endpoint name** | `/updateTaxForm` | -| **Purpose** | Submits state and filing for the given tax form type. | +| **Conceptual Endpoint** | `PUT /tax-forms/{id}` | +| **Data Connect OP** | `updateTaxForm` | +| **Purpose** | Submits state and filing for the given tax form type (W4/I9). | | **Operation** | Mutation | | **Inputs** | `id`, `dataPoints...` | | **Outputs** | `id` | -| **Notes** | Updates compliance state. | +| **Notes** | Modifies the core compliance state variables directly. | --- ## Client Application -### Authentication / Intro (Sign In, Get Started) +### Authentication / Intro +*(Pages: client_sign_in_page.dart, client_get_started_page.dart)* + #### Client User Validation API | Field | Description | |---|---| -| **Endpoint name** | `/getUserById` | -| **Purpose** | Retrieves the base user profile to determine authentication status and role access (e.g., if user is BUSINESS). | +| **Conceptual Endpoint** | `GET /users/{id}` | +| **Data Connect OP** | `getUserById` | +| **Purpose** | Retrieves the base user profile to determine authentication status and role access (ensuring user is BUSINESS). | | **Operation** | Query | | **Inputs** | `id: UUID!` (Firebase UID) | | **Outputs** | `User { id, email, phone, userRole }` | -| **Notes** | Must check if `userRole == BUSINESS` or `BOTH`. | +| **Notes** | Validates against conditional statements checking `userRole == BUSINESS` or `BOTH`. | -#### Get Business Profile API +#### Get Businesses By User API | Field | Description | |---|---| -| **Endpoint name** | `/getBusinessByUserId` | +| **Conceptual Endpoint** | `GET /business/user/{userId}` | +| **Data Connect OP** | `getBusinessesByUserId` | | **Purpose** | Maps the authenticated user to their client business context. | | **Operation** | Query | -| **Inputs** | `userId: UUID!` | -| **Outputs** | `Business { id, businessName, email, contactName }` | -| **Notes** | Used to set the working scopes (Business ID) across the entire app. | +| **Inputs** | `userId: String!` | +| **Outputs** | `Businesses { id, businessName, email, contactName }` | +| **Notes** | Dictates the working scopes (Business ID) across the entire application lifecycle and binds the user. | -### Hubs Page (client_hubs_page.dart, edit_hub.dart) -#### List Hubs +### Hubs Page +*(Pages: client_hubs_page.dart, edit_hub_page.dart, hub_details_page.dart)* + +#### List Hubs by Team | Field | Description | |---|---| -| **Endpoint name** | `/listTeamHubsByBusinessId` | -| **Purpose** | Fetches the primary working sites (Hubs) for a client. | +| **Conceptual Endpoint** | `GET /teams/{teamId}/hubs` | +| **Data Connect OP** | `getTeamHubsByTeamId` | +| **Purpose** | Fetches the primary working sites (Hubs) for a client context by using Team mapping. | | **Operation** | Query | -| **Inputs** | `businessId: UUID!` | -| **Outputs** | `TeamHubs { id, hubName, address, contact, active }` | -| **Notes** | - | +| **Inputs** | `teamId: UUID!` | +| **Outputs** | `TeamHubs { id, hubName, address, managerName, isActive }` | +| **Notes** | `teamId` is derived first from `getTeamsByOwnerId(ownerId: businessId)`. | -#### Update / Delete Hub +#### Create / Update / Delete Hub | Field | Description | |---|---| -| **Endpoint name** | `/updateTeamHub` / `/deleteTeamHub` | -| **Purpose** | Edits or archives a Hub location. | +| **Conceptual Endpoint** | `POST /team-hubs` / `PUT /team-hubs/{id}` / `DELETE /team-hubs/{id}` | +| **Data Connect OP** | `createTeamHub` / `updateTeamHub` / `deleteTeamHub` | +| **Purpose** | Provisions, Edits details directly, or Removes a Team Hub location. | | **Operation** | Mutation | -| **Inputs** | `id: UUID!`, `hubName`, `address`, etc (for Update) | +| **Inputs** | `id: UUID!`, optionally `hubName`, `address`, etc. | | **Outputs** | `id` | -| **Notes** | - | +| **Notes** | Fired from `edit_hub_page.dart` mutations. | + +### Orders Page +*(Pages: create_order_page.dart, view_orders_page.dart, recurring_order_page.dart)* -### Orders Page (create_order, view_orders) #### Create Order | Field | Description | |---|---| -| **Endpoint name** | `/createOrder` | -| **Purpose** | The client submits a new request for temporary staff (can result in multiple Shifts generated on the backend). | +| **Conceptual Endpoint** | `POST /orders` | +| **Data Connect OP** | `createOrder` | +| **Purpose** | Submits a new request for temporary staff requirements. | | **Operation** | Mutation | | **Inputs** | `businessId`, `eventName`, `orderType`, `status` | | **Outputs** | `id` (Order ID) | -| **Notes** | This creates an order. Shift instances are subsequently created through secondary mutations. | +| **Notes** | This explicitly invokes an order pipeline, meaning Shift instances are subsequently created through secondary mutations triggered after order instantiation. | #### List Orders | Field | Description | |---|---| -| **Endpoint name** | `/getOrdersByBusinessId` | +| **Conceptual Endpoint** | `GET /business/{businessId}/orders` | +| **Data Connect OP** | `listOrdersByBusinessId` | | **Purpose** | Retrieves all ongoing and past staff requests from the client. | | **Operation** | Query | | **Inputs** | `businessId: UUID!` | -| **Outputs** | `Orders { id, eventName, shiftCount, status }` | -| **Notes** | - | +| **Outputs** | `Orders { id, eventName }` | +| **Notes** | Populates the `view_orders_page.dart`. | + +### Billing Pages +*(Pages: billing_page.dart, pending_invoices_page.dart, completion_review_page.dart)* -### Billing Pages (billing_page.dart, pending_invoices) #### List Invoices | Field | Description | |---|---| -| **Endpoint name** | `/listInvoicesByBusinessId` | -| **Purpose** | Fetches "Pending", "Paid", and "Disputed" invoices for the client to review. | +| **Conceptual Endpoint** | `GET /business/{businessId}/invoices` | +| **Data Connect OP** | `listInvoicesByBusinessId` | +| **Purpose** | Fetches all invoices bound directly to the active business context (mapped directly in Firebase Schema). | | **Operation** | Query | | **Inputs** | `businessId: UUID!` | -| **Outputs** | `Invoices { id, amountDue, issueDate, status }` | -| **Notes** | Used across all Billing view tabs. | +| **Outputs** | `Invoices { id, amount, issueDate, status }` | +| **Notes** | Used massively across all Billing view tabs. | -#### Mark Invoice +#### Mark / Dispute Invoice | Field | Description | |---|---| -| **Endpoint name** | `/updateInvoice` | -| **Purpose** | Marks an invoice as disputed or pays it (changes status). | +| **Conceptual Endpoint** | `PUT /invoices/{id}` | +| **Data Connect OP** | `updateInvoice` | +| **Purpose** | Actively marks an invoice as disputed or pays it directly (altering status). | | **Operation** | Mutation | | **Inputs** | `id: UUID!`, `status: InvoiceStatus` | | **Outputs** | `id` | -| **Notes** | Disputing usually involves setting a memo or flag. | +| **Notes** | Disputing usually involves setting a `disputeReason` flag state dynamically via builder pattern. | + +### Reports Page +*(Pages: reports_page.dart, coverage_report_page.dart, performance_report_page.dart)* -### Reports Page (reports_page.dart) #### Get Coverage Stats | Field | Description | |---|---| -| **Endpoint name** | `/getCoverageStatsByBusiness` | -| **Purpose** | Provides data on fulfillments rates vs actual requests. | +| **Conceptual Endpoint** | `GET /business/{businessId}/coverage` | +| **Data Connect OP** | `listShiftsForCoverage` | +| **Purpose** | Provides data on Shifts grouped by Date for fulfillment calculations. | | **Operation** | Query | -| **Inputs** | `businessId: UUID!` | -| **Outputs** | `Stats { totalRequested, totalFilled, percentage }` | -| **Notes** | Driven mostly by aggregated backend views. | +| **Inputs** | `businessId: UUID!`, `startDate: Timestamp!`, `endDate: Timestamp!` | +| **Outputs** | `Shifts { id, date, workersNeeded, filled, status }` | +| **Notes** | The frontend aggregates the raw backend rows to compose Coverage percentage natively. | + +#### Get Daily Ops Stats +| Field | Description | +|---|---| +| **Conceptual Endpoint** | `GET /business/{businessId}/dailyops` | +| **Data Connect OP** | `listShiftsForDailyOpsByBusiness` | +| **Purpose** | Supplies current day operations and shift tracking progress. | +| **Operation** | Query | +| **Inputs** | `businessId: UUID!`, `date: Timestamp!` | +| **Outputs** | `Shifts { id, title, location, workersNeeded, filled }` | +| **Notes** | - | + +#### Get Forecast Stats +| Field | Description | +|---|---| +| **Conceptual Endpoint** | `GET /business/{businessId}/forecast` | +| **Data Connect OP** | `listShiftsForForecastByBusiness` | +| **Purpose** | Retrieves scheduled future shifts to calculate financial run-rates. | +| **Operation** | Query | +| **Inputs** | `businessId: UUID!`, `startDate: Timestamp!`, `endDate: Timestamp!` | +| **Outputs** | `Shifts { id, date, workersNeeded, hours, cost }` | +| **Notes** | The App maps hours `x` cost to deliver Financial Dashboards. | + +#### Get Performance KPIs +| Field | Description | +|---|---| +| **Conceptual Endpoint** | `GET /business/{businessId}/performance` | +| **Data Connect OP** | `listShiftsForPerformanceByBusiness` | +| **Purpose** | Fetches historical data allowing time-to-fill and completion-rate calculations. | +| **Operation** | Query | +| **Inputs** | `businessId: UUID!`, `startDate: Timestamp!`, `endDate: Timestamp!` | +| **Outputs** | `Shifts { id, workersNeeded, filled, createdAt, filledAt }` | +| **Notes** | Data Connect exposes timestamps so the App calculates `avgFillTimeHours`. | + +#### Get No-Show Metrics +| Field | Description | +|---|---| +| **Conceptual Endpoint** | `GET /business/{businessId}/noshows` | +| **Data Connect OP** | `listShiftsForNoShowRangeByBusiness` | +| **Purpose** | Retrieves shifts where workers historically ghosted the platform. | +| **Operation** | Query | +| **Inputs** | `businessId: UUID!`, `startDate: Timestamp!`, `endDate: Timestamp!` | +| **Outputs** | `Shifts { id, date }` | +| **Notes** | Accompanies `listApplicationsForNoShowRange` cascading querying to generate full report. | + +#### Get Spend Analytics +| Field | Description | +|---|---| +| **Conceptual Endpoint** | `GET /business/{businessId}/spend` | +| **Data Connect OP** | `listInvoicesForSpendByBusiness` | +| **Purpose** | Detailed invoice aggregates for Spend metrics filtering. | +| **Operation** | Query | +| **Inputs** | `businessId: UUID!`, `startDate: Timestamp!`, `endDate: Timestamp!` | +| **Outputs** | `Invoices { id, issueDate, dueDate, amount, status }` | +| **Notes** | Used explicitly under the "Spend Report" graphings. | --- -*This document reflects the current state of Data Connect definitions implemented across the frontend and mapped manually by reviewing Repository and UI logic.* +*This document meticulously abstracts the underlying Data Connect Data-layer definitions implemented natively across the frontend. It maps the queries/mutations to recognizable REST equivalents for comprehensive and top-notch readability by external and internal developers alike.* diff --git a/docs/available_gql.txt b/docs/available_gql.txt new file mode 100644 index 0000000000000000000000000000000000000000..54380559d6447a33449d5445463fdd8f1596d534 GIT binary patch literal 16316 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 literal 0 HcmV?d00001