feat: add feature roadmap and tickets documentation

feat: add detailed feature roadmap and tickets documentation
feat: add roadmap overview diagram
feat: add roadmap p0 mvp diagram
feat: add roadmap p0 complete workflow diagram
feat: update diagrams config to include new roadmap diagrams
feat: add support for syncing source code for ai context
chore: update allowed hashes
feat: add jose.salazar@oloodi.com to iap-users.txt
feat: add fazulilahi@gmail.com to iap-users.txt
feat: add zouantchaw74@gmail.com to iap-users.txt
This commit is contained in:
bwnyasse
2026-01-12 11:44:26 -05:00
parent 5cc4e0fc0a
commit 8916a4ac49
13 changed files with 2168 additions and 27 deletions

3
.gitignore vendored
View File

@@ -165,6 +165,9 @@ internal/launchpad/prototypes/web/*
internal/launchpad/prototypes/mobile/**/* internal/launchpad/prototypes/mobile/**/*
!internal/launchpad/prototypes/mobile/**/.keep !internal/launchpad/prototypes/mobile/**/.keep
# Prototype Source Code (synced for AI/Claude context, not for version control)
internal/launchpad/prototypes-src/
# Temporary migration artifacts # Temporary migration artifacts
_legacy/ _legacy/
krow-workforce-export-latest/ krow-workforce-export-latest/

View File

@@ -85,7 +85,8 @@ Follow these steps to set up your development environment and gain access to all
## 🔗 Useful Links ## 🔗 Useful Links
- **KROW Internal Launchpad:** [https://launchpad.krowwithus.com](https://launchpad.krowwithus.com) - **KROW Internal Launchpad:** [https://launchpad.krowwithus.com](https://launchpad.krowwithus.com)
- **Project Onboarding (Start Here):** [docs/05-project-onboarding-master.md](./05-project-onboarding-master.md) - Comprehensive guide covering architecture, domain logic, feature gap analysis, and development strategy
- **Project Vision:** [docs/00-vision.md](./00-vision.md) - **Project Vision:** [docs/00-vision.md](./00-vision.md)
- **Backend Specification:** [docs/01-backend-api-specification.md](./01-backend-api-specification.md) - **Backend Specification (Legacy Reference):** [docs/01-backend-api-specification.md](./01-backend-api-specification.md) - Historical API spec from Digital Ocean stack
- **Codemagic Env Vars:** [docs/02-codemagic-env-vars.md](./02-codemagic-env-vars.md) - **Codemagic Env Vars:** [docs/02-codemagic-env-vars.md](./02-codemagic-env-vars.md)

View File

@@ -917,7 +917,7 @@ Based on minimal dependencies:
## 6. Definition of Done (DoD) ## 6. Definition of Done (DoD)
### 6.1 Feature-Level DoD ### 6.1 Feature-Level DoD (MVP Phase)
A feature is **DONE** when: A feature is **DONE** when:
@@ -925,13 +925,14 @@ A feature is **DONE** when:
- [ ] **SDK:** Generated SDK integrated into app - [ ] **SDK:** Generated SDK integrated into app
- [ ] **UI:** All screens implemented per prototype design - [ ] **UI:** All screens implemented per prototype design
- [ ] **Logic:** Business logic working correctly - [ ] **Logic:** Business logic working correctly
- [ ] **Tests:** Unit tests for critical logic (>80% coverage) - [ ] **Manual Testing:** Feature tested directly in the application (happy path + edge cases)
- [ ] **Integration:** E2E test for happy path
- [ ] **Security:** Auth rules validated - [ ] **Security:** Auth rules validated
- [ ] **Accessibility:** Basic a11y compliance - [ ] **Accessibility:** Basic a11y compliance
- [ ] **Documentation:** API documented in schema comments - [ ] **Documentation:** API documented in schema comments
- [ ] **Review:** Code reviewed and approved - [ ] **Review:** Code reviewed and approved
> **Note (MVP):** For rapid MVP delivery, we focus on manual/integration testing directly in applications rather than unit tests. Automated test coverage will be added post-MVP.
### 6.2 Sprint-Level DoD ### 6.2 Sprint-Level DoD
A sprint is **DONE** when: A sprint is **DONE** when:
@@ -953,7 +954,7 @@ A sprint is **DONE** when:
| **Types** | Strict TypeScript, no `any` | | **Types** | Strict TypeScript, no `any` |
| **Commits** | Conventional commits format | | **Commits** | Conventional commits format |
| **PRs** | Template completed, 1+ approval | | **PRs** | Template completed, 1+ approval |
| **Tests** | Unit + Integration for new code | | **Testing (MVP)** | Manual testing in application |
### 6.4 Commit Message Format ### 6.4 Commit Message Format
@@ -990,7 +991,7 @@ main (production)
## PR Checklist ## PR Checklist
- [ ] Code follows project conventions - [ ] Code follows project conventions
- [ ] Self-reviewed changes - [ ] Self-reviewed changes
- [ ] Added/updated tests - [ ] Feature manually tested in application
- [ ] Documentation updated if needed - [ ] Documentation updated if needed
- [ ] No console.log/print statements - [ ] No console.log/print statements
- [ ] Sensitive data not hardcoded - [ ] Sensitive data not hardcoded

View File

@@ -0,0 +1,681 @@
# KROW Feature Roadmap & Tickets
> **Organization:** By priority (P0 → P1 → P2), then by domain
> **Source:** Analysis of prototypes in `internal/launchpad/prototypes-src/`
---
## Overview
```mermaid
flowchart LR
subgraph P0["P0: MVP Core (Sprint 3-4)"]
A[Auth] --> B[Staff Onboarding]
B --> C[Events/Orders]
C --> D[Shifts/Assignment]
D --> E[Clock In/Out]
E --> F[Timesheets]
F --> G[Invoices]
G --> H[Earnings View]
end
subgraph P1["P1: Enhanced (Sprint 5-6)"]
I[Smart Assignment]
J[Early Pay]
K[RAPID Orders]
L[Reports]
end
subgraph P2["P2: Full Vision (Sprint 7+)"]
M[KROW University]
N[Gamification]
O[Advanced Analytics]
end
P0 --> P1 --> P2
```
---
## Progression by App
### At the end of P0 (MVP), each app allows:
```mermaid
flowchart TB
subgraph WEB["WEB (Admin/Client)"]
W1[Email/Password Login]
W2[Role-based Dashboard]
W3[Manage Staff]
W4[Create Events/Orders]
W5[Assign Staff to Shifts]
W6[Approve Timesheets]
W7[Generate Invoices]
W8[View Basic Reports]
end
subgraph MC["MOBILE CLIENT"]
MC1[Email + Social Login]
MC2[Coverage Dashboard]
MC3[Create Orders]
MC4[View Active Shifts]
MC5[Manage Hubs]
MC6[View Billing]
MC7[Basic Reports]
end
subgraph MS["MOBILE STAFF"]
MS1[Phone + SMS OTP Login]
MS2[Complete Onboarding]
MS3[View Available Shifts]
MS4[Accept/Decline Shifts]
MS5[Swipe Clock In/Out]
MS6[View Earnings]
MS7[I-9/W-4 Forms]
MS8[Bank Account Setup]
end
```
---
# P0 - MUST HAVE (Sprint 3-4)
> **Goal:** End-to-end functional MVP
> **Total:** 52 tickets
---
## P0.1 - Authentication
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P0-AUTH-01 | Email/Password Login | Login form with email + password |
| P0-AUTH-02 | Password Reset | Send reset email, link, new password |
| P0-AUTH-03 | Role-Based Redirect | Admin → `/dashboard/admin`, Client → `/dashboard/client`, Vendor → `/dashboard/vendor` |
| P0-AUTH-04 | Session Persistence | Token persist, auto-refresh, logout |
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P0-AUTH-05 | Get Started Screen | Welcome screen with Sign In / Sign Up options |
| P0-AUTH-06 | Email/Password Login | Form with email + password |
| P0-AUTH-07 | Social Login (Apple/Google) | Apple and Google sign-in buttons |
| P0-AUTH-08 | Client Registration | Business signup form |
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P0-AUTH-09 | Get Started Screen | Welcome screen "Work, Grow, Elevate" |
| P0-AUTH-10 | Phone Verification | US phone number input (+1) |
| P0-AUTH-11 | SMS OTP Code | Send and validate 6-digit code |
| P0-AUTH-12 | Login vs Signup Mode | Same flow, different destination |
---
## P0.2 - Staff Management
### MOBILE STAFF - Onboarding
| ID | Ticket | Description |
|----|--------|-------------|
| P0-STAFF-01 | Profile Setup Wizard | Screen after phone verification |
| P0-STAFF-02 | Personal Info Screen | Name, date of birth, address |
| P0-STAFF-03 | Emergency Contact | Emergency contact (name, relationship, phone) |
| P0-STAFF-04 | Experience Screen | Skills/experience selection |
| P0-STAFF-05 | Attire Screen | Uniform/outfit photo |
| P0-STAFF-06 | Bank Account Setup | Banking info for payment |
### WEB - Admin Staff Management
| ID | Ticket | Description |
|----|--------|-------------|
| P0-STAFF-07 | Staff List | List with search, filters (status, skills) |
| P0-STAFF-08 | Staff Detail View | Full profile, documents, history |
| P0-STAFF-09 | Add Staff (Admin) | Staff creation form |
| P0-STAFF-10 | Edit Staff | Modify staff info |
| P0-STAFF-11 | Staff Approval Queue | Approve/Reject new staff |
---
## P0.3 - Business & Hub Management
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P0-BIZ-01 | Client List | Business list with search/filter |
| P0-BIZ-02 | Add Client | Business creation form |
| P0-BIZ-03 | Edit Client | Modify business info |
| P0-BIZ-04 | Service Rates Config | Configure rates per position |
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P0-BIZ-05 | Client Hubs Screen | Location list and management |
| P0-BIZ-06 | Client Settings | Business account settings |
---
## P0.4 - Event & Order Management
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P0-EVENT-01 | Order List (Admin) | All orders with filters |
| P0-EVENT-02 | Order List (Client) | Client's orders only |
| P0-EVENT-03 | Order List (Vendor) | Orders assigned to vendor |
| P0-EVENT-04 | Order Detail | Detailed view with shifts |
| P0-EVENT-05 | Edit Order | Modify event/shifts |
| P0-EVENT-06 | Schedule View | Event calendar |
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P0-EVENT-07 | Create Order Screen | Order type selection |
| P0-EVENT-08 | One-Time Order Flow | Wizard for one-time event creation |
| P0-EVENT-09 | Client Shifts Screen | Client's shifts list |
| P0-EVENT-10 | Client Coverage Screen | Staffing coverage view |
---
## P0.5 - Shift & Assignment
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P0-SHIFT-01 | Staff Availability View | View staff availability |
| P0-SHIFT-02 | Manual Assignment | Assign staff to shift |
| P0-SHIFT-03 | Task Board | Task/assignment kanban |
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P0-SHIFT-04 | Shifts Screen (Tabs) | Available / My Shifts / History |
| P0-SHIFT-05 | Shift Details Screen | Details with location, hours, pay |
| P0-SHIFT-06 | Accept/Decline Shift | Actions on proposed shift |
| P0-SHIFT-07 | Jobs Screen | Explore all available jobs |
| P0-SHIFT-08 | Availability Screen | Configure availability |
---
## P0.6 - Time & Attendance
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P0-TIME-01 | Clock In Screen | Main clock-in screen |
| P0-TIME-02 | Swipe to Clock In | Swipe gesture to confirm |
| P0-TIME-03 | Swipe to Clock Out | Swipe gesture to end |
| P0-TIME-04 | GPS Location Capture | Record position at clock |
| P0-TIME-05 | Time Card Screen | Clock history |
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P0-TIME-06 | Timesheet Approval | Timesheet approval queue |
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P0-TIME-07 | Client Timesheets | View timesheets for approval |
---
## P0.7 - Financial
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P0-FIN-01 | Invoice List | Invoice list with status |
| P0-FIN-02 | Invoice Detail | Detailed invoice view |
| P0-FIN-03 | Invoice Editor | Create/modify invoice |
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P0-FIN-04 | Payments Screen | Earnings dashboard |
| P0-FIN-05 | Earnings Screen | Earnings detail |
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P0-FIN-06 | Client Billing Screen | Client billing view |
---
## P0.8 - Compliance & Documents
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P0-COMP-01 | Tax Forms Screen | Tax forms list |
| P0-COMP-02 | Form I-9 | I-9 employment eligibility form |
| P0-COMP-03 | Form W-4 | W-4 tax withholding form |
| P0-COMP-04 | Documents Screen | Upload/view documents |
| P0-COMP-05 | Certificates Screen | Manage certifications |
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P0-COMP-06 | Compliance Dashboard | Compliance view for all staff |
| P0-COMP-07 | Document Vault | Document storage |
---
## P0.9 - Dashboards & Navigation
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P0-DASH-01 | Admin Dashboard | Widgets: stats, alerts, actions |
| P0-DASH-02 | Client Dashboard | Widgets: coverage, orders, spend |
| P0-DASH-03 | Vendor Dashboard | Widgets: orders, staff, revenue |
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P0-DASH-04 | Client Home Screen | Mobile main dashboard |
| P0-DASH-05 | Bottom Navigation | Coverage, Billing, Home, Shifts, Reports |
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P0-DASH-06 | Worker Home Screen | Staff main dashboard |
| P0-DASH-07 | Bottom Navigation | Shifts, Payments, Home, Clock-In, Profile |
| P0-DASH-08 | Worker Profile Screen | Settings and features menu |
---
## Complete P0 Workflow
```mermaid
sequenceDiagram
participant Staff as Mobile Staff
participant Client as Mobile Client
participant Admin as Web Admin
Note over Staff,Admin: 1. SETUP
Staff->>Staff: Phone + OTP Login
Staff->>Staff: Complete Onboarding
Staff->>Staff: Submit I-9, W-4
Admin->>Admin: Approve Staff
Note over Staff,Admin: 2. ORDER
Client->>Client: Email Login
Client->>Client: Create Order (One-Time)
Admin->>Admin: View Order
Note over Staff,Admin: 3. ASSIGNMENT
Admin->>Admin: Assign Staff to Shift
Staff->>Staff: View Shift Offer
Staff->>Staff: Accept Shift
Note over Staff,Admin: 4. WORK
Staff->>Staff: Swipe Clock In (GPS)
Staff->>Staff: Swipe Clock Out
Note over Staff,Admin: 5. PAYMENT
Client->>Client: Approve Timesheet
Admin->>Admin: Generate Invoice
Client->>Client: View Invoice
Staff->>Staff: View Earnings
```
---
# P1 - SHOULD HAVE (Sprint 5-6)
> **Goal:** Differentiating features
> **Total:** 38 tickets
---
## P1.1 - Smart Features
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P1-SMART-01 | Smart Assignment Engine | Auto-match staff based on skills, availability, proximity |
| P1-SMART-02 | Conflict Detection | Detect double-booking |
| P1-SMART-03 | Overtime Calculator | OT/DT calculation with California rules |
| P1-SMART-04 | Savings Engine | Potential savings analysis |
---
## P1.2 - Advanced Orders
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P1-ORDER-01 | RAPID Order Flow | Quick simplified order creation |
| P1-ORDER-02 | Recurring Order Flow | Recurring orders (weekly, monthly) |
| P1-ORDER-03 | Permanent Order Flow | Permanent placements |
| P1-ORDER-04 | Verify Worker Attire | Staff attire verification |
---
## P1.3 - Early Pay
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P1-PAY-01 | Early Pay Screen | Access earnings before payday |
| P1-PAY-02 | Early Pay Request | Request early payment (5% fee) |
| P1-PAY-03 | Instant Transfer | Transfer to bank account |
| P1-PAY-04 | Benefits Screen | Available benefits view |
---
## P1.4 - Reports
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P1-REPORT-01 | Client Reports Screen | Reports hub |
| P1-REPORT-02 | Daily Ops Report | Daily operations report |
| P1-REPORT-03 | Spend Report | Spending analysis |
| P1-REPORT-04 | Forecast Report | Needs forecast |
| P1-REPORT-05 | Performance Report | Staff performance |
| P1-REPORT-06 | No-Show Report | Absence report |
| P1-REPORT-07 | Coverage Report | Coverage report |
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P1-REPORT-08 | Reports Dashboard | Admin reports center |
| P1-REPORT-09 | Activity Log | System activity log |
| P1-REPORT-10 | Vendor Performance | Vendor performance |
---
## P1.5 - Communication
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P1-COMM-01 | Message Center | Internal messaging |
| P1-COMM-02 | Tutorial List | Training videos/guides |
| P1-COMM-03 | Support Center | Help center |
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P1-COMM-04 | Messages Screen | Staff messaging |
| P1-COMM-05 | FAQs Screen | Frequently asked questions |
| P1-COMM-06 | Privacy Screen | Privacy settings |
---
## P1.6 - Teams & Workers
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P1-TEAM-01 | Team List | Team list |
| P1-TEAM-02 | Create Team | Create team |
| P1-TEAM-03 | Team Detail | Team details |
| P1-TEAM-04 | Staff Onboarding Flow | Web onboarding wizard |
### MOBILE CLIENT
| ID | Ticket | Description |
|----|--------|-------------|
| P1-TEAM-05 | Client Workers Screen | View assigned staff |
---
## P1.7 - Marketplace
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P1-MKT-01 | Vendor Marketplace | Discover vendors |
| P1-MKT-02 | Compare Rates | Compare rates |
---
## P1 Added Workflow
```mermaid
flowchart TB
subgraph SMART["Smart Features"]
A[Client creates Order] --> B{Smart Engine}
B --> C[Auto-suggest Staff]
C --> D[Check Conflicts]
D --> E[Calculate OT Impact]
E --> F[Assign Optimal Staff]
end
subgraph EARLYPAY["Early Pay"]
G[Staff completes Shift]
G --> H[Earnings Available]
H --> I[Request Early Pay]
I --> J[5% Fee Applied]
J --> K[Instant Bank Transfer]
end
subgraph RAPID["RAPID Orders"]
L[Client opens RAPID]
L --> M[Quick Selection]
M --> N[Minimal Fields]
N --> O[Instant Submit]
end
```
---
# P2 - NICE TO HAVE (Sprint 7+)
> **Goal:** Complete prototype vision
> **Total:** 28 tickets
---
## P2.1 - KROW University
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P2-UNI-01 | KROW University Screen | Training hub |
| P2-UNI-02 | Trainings Screen | Available courses list |
| P2-UNI-03 | Course Enrollment | Enroll in a course |
| P2-UNI-04 | Video Lessons | Video playback |
| P2-UNI-05 | Quizzes | Knowledge tests |
| P2-UNI-06 | Certificates Earned | Earned badges/certs |
---
## P2.2 - Gamification
### MOBILE STAFF
| ID | Ticket | Description |
|----|--------|-------------|
| P2-GAME-01 | Leaderboard Screen | Staff ranking |
| P2-GAME-02 | XP System | Experience points |
| P2-GAME-03 | Badges | Achievement badges |
| P2-GAME-04 | Level Progression | Level progression |
| P2-GAME-05 | Referral Program | Referral program |
---
## P2.3 - Advanced Scheduling
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P2-SCHED-01 | Drag-Drop Scheduler | Drag-and-drop planning |
| P2-SCHED-02 | Automation Engine | Automation rules |
| P2-SCHED-03 | Double-Booking Override | Exception handling |
| P2-SCHED-04 | Cancellation Fee Modal | Cancellation fee management |
---
## P2.4 - Advanced Finance
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P2-FIN-01 | Auto Invoice Generator | Auto invoice generation |
| P2-FIN-02 | Invoice Export Panel | Multi-format export |
| P2-FIN-03 | Invoice Quick Actions | Quick actions |
---
## P2.5 - Advanced Analytics
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P2-ANAL-01 | Staffing Cost Report | Staffing cost analysis |
| P2-ANAL-02 | Staff Performance Report | Individual performance |
| P2-ANAL-03 | Operational Efficiency | Operational efficiency |
| P2-ANAL-04 | Report Template Library | Template library |
| P2-ANAL-05 | Scheduled Reports | Scheduled reports |
| P2-ANAL-06 | Report PDF Preview | PDF preview |
| P2-ANAL-07 | Report Insights Banner | Automatic insights |
---
## P2.6 - Advanced Client Features
### WEB
| ID | Ticket | Description |
|----|--------|-------------|
| P2-CLI-01 | Client Loyalty Card | Loyalty program |
| P2-CLI-02 | Client Vendor Preferences | Vendor preferences |
| P2-CLI-03 | Dashboard Customizer | Dashboard customization |
---
## Complete P2 Workflow
```mermaid
flowchart TB
subgraph UNI["KROW University"]
U1[Staff opens University] --> U2[Browse Courses]
U2 --> U3[Enroll in Course]
U3 --> U4[Watch Videos]
U4 --> U5[Pass Quiz]
U5 --> U6[Earn Certificate]
U6 --> U7[+XP Points]
end
subgraph GAME["Gamification"]
G1[Complete Shifts] --> G2[Earn XP]
G2 --> G3[Level Up]
G3 --> G4[Unlock Badges]
G4 --> G5[Climb Leaderboard]
G5 --> G6[Better Shift Priority]
end
subgraph AUTO["Advanced Automation"]
A1[New Order Created]
A1 --> A2[Automation Rules Check]
A2 --> A3[Auto-Assign Preferred Staff]
A3 --> A4[Auto-Generate Invoice]
A4 --> A5[Auto-Send Reports]
end
```
---
# Completion Checklist
## When P0 is done:
- [ ] **Auth works** for all 3 apps (phone OTP for staff, email for client/web)
- [ ] **Staff can fully onboard** via mobile
- [ ] **Client can create** one-time orders
- [ ] **Admin can assign** staff to shifts
- [ ] **Staff can clock in/out** with swipe + GPS
- [ ] **Timesheets are approved** by client
- [ ] **Invoices are generated** and visible
- [ ] **Staff can view earnings**
- [ ] **I-9/W-4 forms** work
**= MVP ACHIEVED**
---
## When P1 is done:
- [ ] **Smart Assignment** automatically suggests best staff
- [ ] **Conflict detection** prevents double-bookings
- [ ] **Early Pay** allows staff to access earnings
- [ ] **RAPID orders** speeds up creation
- [ ] **Recurring orders** handles repetitive needs
- [ ] **Full reports** give clients visibility
- [ ] **Messaging** enables direct communication
**= ENHANCED MVP**
---
## When P2 is done:
- [ ] **KROW University** trains staff
- [ ] **Gamification** motivates via XP and leaderboard
- [ ] **Advanced scheduling** optimizes planning
- [ ] **Auto-invoicing** reduces manual work
- [ ] **Advanced analytics** provide business insights
**= FULL PROTOTYPE VISION ACHIEVED**
---
# Summary
| Priority | Sprints | Tickets |
|----------|---------|---------|
| **P0** | 3-4 | **52** |
| **P1** | 5-6 | **38** |
| **P2** | 7+ | **28** |
| **TOTAL** | - | **118** |
### By App
| App | P0 | P1 | P2 | Total |
|-----|----|----|-----|-------|
| Web | 22 | 16 | 14 | 52 |
| Mobile Client | 12 | 12 | 3 | 27 |
| Mobile Staff | 18 | 10 | 11 | 39 |
---
**Document Created:** January 2026
**Source:** Analysis of `internal/launchpad/prototypes-src/`

File diff suppressed because it is too large Load Diff

View File

@@ -1,5 +1,8 @@
[ [
"1b2e22bdec8f6493bf71ee535b6db6b4b5cd2d373f0ffb25524e229f3b5b7f5f", "1b2e22bdec8f6493bf71ee535b6db6b4b5cd2d373f0ffb25524e229f3b5b7f5f",
"e075ff357ef35be2d55b0e383d59c5256980c492ada7ab84c84b2bb5ac26a73f", "e075ff357ef35be2d55b0e383d59c5256980c492ada7ab84c84b2bb5ac26a73f",
"994b31c1aef3d59fe59bc3b8e1dec860a6fb3c73cbf41bdf45028e2c1ecbcf7a" "8205f6c72d8e97358fe7638b02503c17b4bfd4a397c143ea27151f3f106720d4",
"994b31c1aef3d59fe59bc3b8e1dec860a6fb3c73cbf41bdf45028e2c1ecbcf7a",
"99144d7e873dd0ab56c185d5f42fee2048b1be73513cf36dc1df3eae1e524489",
"088aa009feb3ac78d37242c9abc339aacf42665dccdb626415590148855d0623"
] ]

View File

@@ -42,10 +42,22 @@
"icon": "bi-geo-alt" "icon": "bi-geo-alt"
}, },
{ {
"path": "assets/diagrams/roadmap/roadmap.mermaid", "path": "assets/diagrams/roadmap/0-roadmap-overview.mermaid",
"title": "Project Roadmap", "title": "Roadmap Overview",
"type": "mermaid", "type": "mermaid",
"icon": "bi-calendar-check" "icon": "bi-geo-alt"
},
{
"path": "assets/diagrams/roadmap/1-roadmap-p0-mvp.mermaid",
"title": "Roadmap P0 MVP",
"type": "mermaid",
"icon": "bi-geo-alt"
},
{
"path": "assets/diagrams/roadmap/2-roadmap-p0-complete.mermaid",
"title": "Roadmap P0 Complete Workflow",
"type": "mermaid",
"icon": "bi-geo-alt"
}, },
{ {
"path": "assets/diagrams/legacy/staff-mobile-application/overview.mermaid", "path": "assets/diagrams/legacy/staff-mobile-application/overview.mermaid",

View File

@@ -0,0 +1,25 @@
flowchart LR
subgraph P0["P0: MVP Core (Sprint 3-4)"]
A[Auth] --> B[Staff Onboarding]
B --> C[Events/Orders]
C --> D[Shifts/Assignment]
D --> E[Clock In/Out]
E --> F[Timesheets]
F --> G[Invoices]
G --> H[Earnings View]
end
subgraph P1["P1: Enhanced (Sprint 5-6)"]
I[Smart Assignment]
J[Early Pay]
K[RAPID Orders]
L[Reports]
end
subgraph P2["P2: Full Vision (Sprint 7+)"]
M[KROW University]
N[Gamification]
O[Advanced Analytics]
end
P0 --> P1 --> P2

View File

@@ -0,0 +1,32 @@
flowchart TB
subgraph WEB["WEB (Admin/Client)"]
W1[Email/Password Login]
W2[Role-based Dashboard]
W3[Manage Staff]
W4[Create Events/Orders]
W5[Assign Staff to Shifts]
W6[Approve Timesheets]
W7[Generate Invoices]
W8[View Basic Reports]
end
subgraph MC["MOBILE CLIENT"]
MC1[Email + Social Login]
MC2[Coverage Dashboard]
MC3[Create Orders]
MC4[View Active Shifts]
MC5[Manage Hubs]
MC6[View Billing]
MC7[Basic Reports]
end
subgraph MS["MOBILE STAFF"]
MS1[Phone + SMS OTP Login]
MS2[Complete Onboarding]
MS3[View Available Shifts]
MS4[Accept/Decline Shifts]
MS5[Swipe Clock In/Out]
MS6[View Earnings]
MS7[I-9/W-4 Forms]
MS8[Bank Account Setup]
end

View File

@@ -0,0 +1,30 @@
sequenceDiagram
participant Staff as Mobile Staff
participant Client as Mobile Client
participant Admin as Web Admin
Note over Staff,Admin: 1. SETUP
Staff->>Staff: Phone + OTP Login
Staff->>Staff: Complete Onboarding
Staff->>Staff: Submit I-9, W-4
Admin->>Admin: Approve Staff
Note over Staff,Admin: 2. ORDER
Client->>Client: Email Login
Client->>Client: Create Order (One-Time)
Admin->>Admin: View Order
Note over Staff,Admin: 3. ASSIGNMENT
Admin->>Admin: Assign Staff to Shift
Staff->>Staff: View Shift Offer
Staff->>Staff: Accept Shift
Note over Staff,Admin: 4. WORK
Staff->>Staff: Swipe Clock In (GPS)
Staff->>Staff: Swipe Clock Out
Note over Staff,Admin: 5. PAYMENT
Client->>Client: Approve Timesheet
Admin->>Admin: Generate Invoice
Client->>Client: View Invoice
Staff->>Staff: View Earnings

View File

@@ -1,17 +0,0 @@
timeline
title KROW Platform - Accelerated Migration & Enhancement Roadmap (2 Months to Production)
section Phase 1: Foundation & New Workflow Adoption
Week 1-2 : Initialize Firebase projects (Dev, Staging) and configure hosting<br>Set up CI/CD pipelines for automated deployments<br>Adopt new development and deployment workflows
Week 3-4 : Configure internal launchpad for easy access to resources<br>Team training on new tools and workflows<br>Documentation setup
Key Milestones : <b>Dev & Staging environments fully operational</b><br><b>Team ready to work with new infrastructure</b>
section Phase 2: Functional Parity & New Experience
Week 5-6 : Migrate core backend logic (Cloud Functions, Firestore/Cloud SQL)<br>Reconnect Web and Mobile apps to new APIs<br>Database migration and validation
Week 7-8 : Integrate new UI/UX design across all applications<br>Implement new core business workflows<br>Feature parity testing
Key Milestones : <b>All existing features are ISO-functional on the new platform</b><br><b>New design and core workflows fully integrated and tested</b>
section Phase 3: Preparation & Production Launch
Week 9-10 : Complete end-to-end testing and performance optimization<br>Security audits and penetration testing<br>Load testing and optimization
Week 11-12 : Set up robust monitoring and alerting system for production<br>Final production deployment<br>Legacy infrastructure decommissioning plan
Key Milestones : <b>KROW is live in production with new design and workflows</b><br><b>Legacy infrastructure ready for decommissioning</b>

View File

@@ -8,7 +8,13 @@ user:admin@krowwithus.com
# External users - Oloodi employees # External users - Oloodi employees
user:boris@oloodi.com user:boris@oloodi.com
user:jose.salazar@oloodi.com
user:achintha.isuru@oloodi.com user:achintha.isuru@oloodi.com
# External users - Legendary employees # External users - Legendary employees
# External users - gmail.com
user:fazulilahi@gmail.com
user:zouantchaw74@gmail.com

View File

@@ -14,6 +14,11 @@ MOBILE_STAFF_SOURCE="$POC_REPO_PATH/prototypes/mobile/staff/staff_mobile_applica
MOBILE_STAFF_DEST="internal/launchpad/prototypes/mobile/staff" MOBILE_STAFF_DEST="internal/launchpad/prototypes/mobile/staff"
MOBILE_STAFF_HREF="/prototypes/mobile/staff/" MOBILE_STAFF_HREF="/prototypes/mobile/staff/"
# Source code destinations (for AI/Claude context)
WEB_SRC_DEST="internal/launchpad/prototypes-src/web"
MOBILE_CLIENT_SRC_DEST="internal/launchpad/prototypes-src/mobile/client"
MOBILE_STAFF_SRC_DEST="internal/launchpad/prototypes-src/mobile/staff"
# Colors # Colors
GREEN='\033[0;32m' GREEN='\033[0;32m'
BLUE='\033[0;34m' BLUE='\033[0;34m'
@@ -77,6 +82,16 @@ if [ -d "$WEB_POC_SOURCE" ]; then
cp -R "$WEB_POC_SOURCE/dist/"* "$WEB_DEST/" cp -R "$WEB_POC_SOURCE/dist/"* "$WEB_DEST/"
echo -e "${GREEN}✅ Web Dashboard synced successfully.${NC}" echo -e "${GREEN}✅ Web Dashboard synced successfully.${NC}"
# Copy source code for AI context
echo " -> Copying source code for AI context..."
rm -rf "$WEB_SRC_DEST"
mkdir -p "$WEB_SRC_DEST"
cp -R "$WEB_POC_SOURCE/src" "$WEB_SRC_DEST/"
[ -f "$WEB_POC_SOURCE/package.json" ] && cp "$WEB_POC_SOURCE/package.json" "$WEB_SRC_DEST/"
[ -f "$WEB_POC_SOURCE/tsconfig.json" ] && cp "$WEB_POC_SOURCE/tsconfig.json" "$WEB_SRC_DEST/"
[ -f "$WEB_POC_SOURCE/vite.config.ts" ] && cp "$WEB_POC_SOURCE/vite.config.ts" "$WEB_SRC_DEST/"
echo -e "${GREEN}✅ Web source code copied.${NC}"
else else
echo -e "${RED}⚠️ Warning: Web POC source directory not found at $WEB_POC_SOURCE${NC}" echo -e "${RED}⚠️ Warning: Web POC source directory not found at $WEB_POC_SOURCE${NC}"
fi fi
@@ -123,6 +138,14 @@ if [ -d "$MOBILE_CLIENT_SOURCE" ]; then
cp -R "$MOBILE_CLIENT_SOURCE/build/web/"* "$MOBILE_CLIENT_DEST/" cp -R "$MOBILE_CLIENT_SOURCE/build/web/"* "$MOBILE_CLIENT_DEST/"
echo -e "${GREEN}✅ Mobile Client synced successfully.${NC}" echo -e "${GREEN}✅ Mobile Client synced successfully.${NC}"
# Copy source code for AI context
echo " -> Copying source code for AI context..."
rm -rf "$MOBILE_CLIENT_SRC_DEST"
mkdir -p "$MOBILE_CLIENT_SRC_DEST"
cp -R "$MOBILE_CLIENT_SOURCE/lib" "$MOBILE_CLIENT_SRC_DEST/"
[ -f "$MOBILE_CLIENT_SOURCE/pubspec.yaml" ] && cp "$MOBILE_CLIENT_SOURCE/pubspec.yaml" "$MOBILE_CLIENT_SRC_DEST/"
echo -e "${GREEN}✅ Mobile Client source code copied.${NC}"
else else
echo -e "${RED}⚠️ Warning: Mobile Client source not found at $MOBILE_CLIENT_SOURCE${NC}" echo -e "${RED}⚠️ Warning: Mobile Client source not found at $MOBILE_CLIENT_SOURCE${NC}"
fi fi
@@ -146,6 +169,14 @@ if [ -d "$MOBILE_STAFF_SOURCE" ]; then
cp -R "$MOBILE_STAFF_SOURCE/build/web/"* "$MOBILE_STAFF_DEST/" cp -R "$MOBILE_STAFF_SOURCE/build/web/"* "$MOBILE_STAFF_DEST/"
echo -e "${GREEN}✅ Mobile Staff synced successfully.${NC}" echo -e "${GREEN}✅ Mobile Staff synced successfully.${NC}"
# Copy source code for AI context
echo " -> Copying source code for AI context..."
rm -rf "$MOBILE_STAFF_SRC_DEST"
mkdir -p "$MOBILE_STAFF_SRC_DEST"
cp -R "$MOBILE_STAFF_SOURCE/lib" "$MOBILE_STAFF_SRC_DEST/"
[ -f "$MOBILE_STAFF_SOURCE/pubspec.yaml" ] && cp "$MOBILE_STAFF_SOURCE/pubspec.yaml" "$MOBILE_STAFF_SRC_DEST/"
echo -e "${GREEN}✅ Mobile Staff source code copied.${NC}"
else else
echo -e "${RED}⚠️ Warning: Mobile Staff source not found at $MOBILE_STAFF_SOURCE${NC}" echo -e "${RED}⚠️ Warning: Mobile Staff source not found at $MOBILE_STAFF_SOURCE${NC}"
fi fi