# RateRight Verified Worker Profile & Pre-Onboarding Pack
## Product Specification

### 1. Feature Overview

The Verified Worker Profile and Pre-Onboarding Pack feature addresses the critical pain point of onboarding friction in construction hiring. Currently, contractors spend 30+ minutes on paperwork per worker. RateRight will pre-collect all necessary documents and deliver them as a professional, ready-to-use onboarding pack after payment, reducing onboarding time to under 5 minutes.

#### Core Components:
- **Verification Badge System**: Visual indicators showing worker verification level
- **Document Collection**: Secure upload and storage of mandatory construction documents
- **Pre-Onboarding Pack**: Generated PDF containing all worker documents and information
- **Tiered Verification**: Progressive verification levels encouraging document completion

#### Integration with Existing Flow:
- Maintains current search and hire workflow
- Adds verification badges to worker cards
- Introduces document upload prompts during/after signup
- Triggers pack generation upon successful payment

### 2. Worker Profile Documents

#### Mandatory Documents:
1. **White Card** (Construction Induction Card)
   - Required for all construction sites in Australia
   - Must be current (not expired)
   - Upload: Front and back scan
   - Verification: Check expiry date, verify with issuing authority

2. **Trade Licenses/Tickets** (Minimum 1 for verification)
   - Forklift License
   - Elevated Work Platform (EWP) License
   - Dogging License
   - Rigging License
   - Crane Operation License
   - Scaffolding License
   - Confined Spaces Certificate
   - Working at Heights Certificate
   - Upload: Clear photo/scan of license
   - Verification: Check expiry, verify license number

3. **Bank Details** (for contractor payments)
   - BSB Number (6 digits)
   - Account Number
   - Account Name
   - Upload: Bank statement or deposit slip (optional for verification)

4. **Tax File Number (TFN) Declaration**
   - TFN (encrypted storage)
   - Declaration form completion
   - Upload: Signed TFN declaration form

5. **Superannuation Fund Details**
   - Fund Name
   - Member Number
   - USI (Unique Superannuation Identifier)
   - Upload: Member card or statement

6. **Emergency Contact Details**
   - Primary Contact: Name, relationship, phone
   - Secondary Contact: Name, relationship, phone
   - Medical conditions/allergies (optional)

#### Optional Documents:
1. **Photo ID**
   - Driver's License (preferred)
   - Passport
   - Proof of Age Card
   - Upload: Front and back scan

2. **Australian Business Number (ABN)**
   - Required for subcontractors (vs employees)
   - ABN Number
   - Business Name (if applicable)
   - Upload: ABN confirmation document

### 3. Verification Levels

#### Tier System:

**Basic (Current Minimum)**
- Requirements: Name, phone number, trade selection
- Badge: Gray checkmark
- Benefits: Can be found in searches

**Verified (Recommended)**
- Requirements:
  - White card (current)
  - At least 1 trade license/ticket
  - Bank details completed
  - Emergency contact added
- Badge: Blue checkmark with "Verified" text
- Benefits:
  - Higher search ranking
  - Verification badge on profile
  - Eligible for instant onboarding pack

**Fully Verified (Premium)**
- Requirements:
  - All mandatory documents uploaded
  - Photo ID verified
  - TFN declaration completed
  - Superannuation details provided
- Badge: Gold shield with "Fully Verified" text
- Benefits:
  - Top search ranking
  - Premium badge visibility
  - Priority in contractor recommendations
  - Access to premium job postings

#### Visual Indicators:
- Search results cards show verification level badge
- Profile pages display document completion progress bar
- Verification badges are color-coded and prominently displayed

### 4. Pre-Onboarding Pack

#### PDF Structure:
1. **Cover Page**
   - RateRight branding
   - Worker name and photo
   - Verification level badge
   - Pack generation date
   - Unique QR code linking to profile

2. **Personal Details Section**
   - Full name
   - Date of birth
   - Address
   - Phone number
   - Email
   - Emergency contacts

3. **Safety Certifications Section**
   - White card (front/back)
   - All trade licenses/tickets
   - Expiry dates clearly marked
   - Certification authority

4. **Financial Details Section**
   - Bank details (masked for security)
   - TFN declaration status
   - Superannuation fund details
   - ABN (if applicable)

5. **Summary Page**
   - Document checklist with status
   - Next steps for contractor
   - RateRight contact information

#### Features:
- **Professional Layout**: Clean, construction-industry appropriate design
- **Downloadable**: PDF format, optimized for printing
- **Emailable**: Direct email delivery option
- **QR Code**: Links back to worker's live profile
- **Security**: Watermarked with contractor's details

### 5. User Flow

#### Worker Journey:
1. **Sign Up**
   - Basic registration (name, phone, trade)
   - Prompt: "Complete your profile for verification badges"

2. **Profile Completion**
   - Step-by-step document upload wizard
   - Progress indicator showing verification level
   - Mobile-optimized upload process
   - Real-time validation feedback

3. **Verification Process**
   - Document review (automated + manual for complex cases)
   - Verification badge awarded
   - Notification: "You're now verified!"

4. **Profile Maintenance**
   - Expiry date reminders
   - Easy document renewal process
   - Verification status updates

#### Contractor Journey:
1. **Worker Search**
   - Filter by verification level
   - Badges visible on search cards
   - Hover for verification details

2. **Worker Selection**
   - Click verified worker profile
   - View document summary
   - "Hire Verified Worker" button

3. **Payment Process**
   - $50 hiring fee
   - Payment confirmation
   - Instant pack generation

4. **Pack Delivery**
   - Download link provided
   - Email delivery option
   - QR code for mobile access

### 6. Security Considerations

#### Data Protection:
- **Encryption**: All sensitive data (TFN, bank details) encrypted at rest
- **Access Control**: Documents only accessible after successful payment
- **Audit Trail**: Log all document access and downloads
- **Worker Control**: Workers can revoke access or delete documents

#### Compliance:
- **Privacy Act 1988**: Australian privacy law compliance
- **GDPR**: Data protection for EU workers (if applicable)
- **Notifiable Data Breaches**: Incident response procedures
- **Document Retention**: Clear policies on data retention/deletion

#### Security Features:
- **Secure Upload**: HTTPS encrypted file transfers
- **Virus Scanning**: All uploaded documents scanned
- **File Type Validation**: Only approved formats accepted
- **Size Limits**: Maximum file size restrictions
- **Watermarking**: Packs watermarked with contractor details

#### Document Expiry Tracking:
- **Automated Monitoring**: System tracks expiry dates
- **Renewal Reminders**: 30, 14, and 7-day notifications
- **Grace Period**: 30-day grace period for renewal
- **Auto-downgrade**: Verification level reduced if documents expire

### 7. Implementation Phases

#### Phase 1 (MVP) - 4 weeks
**Goals**: Core verification system with basic documents

**Features**:
- White card upload and verification
- Bank details collection
- Emergency contact details
- Basic verification badge system
- Simple PDF generation (basic template)

**Technical Requirements**:
- Document upload functionality
- Basic PDF generation library
- Verification status tracking
- Badge display system

#### Phase 2 (Full Feature) - 8 weeks
**Goals**: Complete document suite and professional packs

**Features**:
- All mandatory documents supported
- Professional PDF templates
- QR code generation
- Email delivery system
- Advanced verification levels
- Document expiry tracking

**Technical Requirements**:
- Advanced PDF generation with templates
- QR code generation library
- Email service integration
- Document verification APIs
- Expiry date monitoring system

#### Phase 3 (Enhancement) - 4 weeks
**Goals**: Automation and advanced features

**Features**:
- Auto-renewal reminders
- Document verification API integrations
- Advanced analytics
- Bulk document processing
- Mobile app integration

**Technical Requirements**:
- Automated reminder system
- Third-party API integrations
- Analytics dashboard
- Mobile API endpoints

### 8. Competitive Advantage

#### Market Position:
- **First Mover**: No other Australian construction platform offers this
- **Time Savings**: Reduces 30-minute onboarding to 5 minutes
- **Value Proposition**: Unique selling point for RateRight
- **Barrier to Entry**: Workers won't re-upload documents to competitors

#### Business Benefits:
- **Customer Retention**: Contractors dependent on RateRight for quick onboarding
- **Premium Pricing**: Justifies $50 hiring fee with tangible value
- **Network Effects**: More verified workers attract more contractors
- **Data Moat**: Accumulation of verified worker data

#### Competitive Moats:
- **Switching Costs**: High effort to re-verify with competitor
- **Network Density**: Critical mass of verified workers
- **Process Optimization**: Continuous improvement of verification speed
- **Industry Trust**: RateRight becomes the trusted verification standard

### 9. Database Schema

#### Tables:

**worker_verifications**
```sql
CREATE TABLE worker_verifications (
  id UUID PRIMARY KEY,
  worker_id UUID REFERENCES workers(id),
  verification_level ENUM('basic', 'verified', 'fully_verified'),
  status ENUM('pending', 'approved', 'rejected', 'expired'),
  reviewed_by UUID REFERENCES admins(id),
  reviewed_at TIMESTAMP,
  expires_at TIMESTAMP,
  created_at TIMESTAMP DEFAULT NOW(),
  updated_at TIMESTAMP DEFAULT NOW()
);
```

**worker_documents**
```sql
CREATE TABLE worker_documents (
  id UUID PRIMARY KEY,
  worker_id UUID REFERENCES workers(id),
  document_type ENUM('white_card', 'trade_license', 'bank_details', 'tfn', 'super', 'photo_id', 'abn'),
  document_subtype VARCHAR(100),
  file_url VARCHAR(500),
  file_name VARCHAR(255),
  file_size INTEGER,
  mime_type VARCHAR(100),
  expiry_date DATE,
  document_number VARCHAR(100),
  issuing_authority VARCHAR(200),
  verification_status ENUM('pending', 'verified', 'rejected', 'expired'),
  verified_at TIMESTAMP,
  rejection_reason TEXT,
  created_at TIMESTAMP DEFAULT NOW(),
  updated_at TIMESTAMP DEFAULT NOW()
);
```

**onboarding_packs**
```sql
CREATE TABLE onboarding_packs (
  id UUID PRIMARY KEY,
  worker_id UUID REFERENCES workers(id),
  contractor_id UUID REFERENCES contractors(id),
  pack_url VARCHAR(500),
  qr_code_url VARCHAR(500),
  download_count INTEGER DEFAULT 0,
  last_downloaded_at TIMESTAMP,
  expires_at TIMESTAMP,
  created_at TIMESTAMP DEFAULT NOW()
);
```

**document_verification_log**
```sql
CREATE TABLE document_verification_log (
  id UUID PRIMARY KEY,
  document_id UUID REFERENCES worker_documents(id),
  action ENUM('uploaded', 'verified', 'rejected', 'expired', 'renewed'),
  performed_by UUID REFERENCES users(id),
  notes TEXT,
  created_at TIMESTAMP DEFAULT NOW()
);
```

### 10. API Endpoints

#### Document Management:
```
POST /api/workers/{workerId}/documents
- Upload new document
- Parameters: document_type, file, expiry_date, etc.
- Returns: document_id, upload_status

GET /api/workers/{workerId}/documents
- List all worker documents
- Returns: array of documents with verification status

PUT /api/workers/{workerId}/documents/{documentId}
- Update document details
- Parameters: expiry_date, document_number, etc.

DELETE /api/workers/{workerId}/documents/{documentId}
- Remove document (soft delete)
```

#### Verification:
```
GET /api/workers/{workerId}/verification/status
- Get current verification level and status
- Returns: level, status, missing_requirements

POST /api/workers/{workerId}/verification/submit
- Submit for verification review
- Returns: submission_id, estimated_review_time

PUT /api/admin/verifications/{verificationId}/review
- Admin endpoint to approve/reject verification
- Parameters: status, rejection_reason
```

#### Onboarding Packs:
```
POST /api/contractors/{contractorId}/packs/generate
- Generate onboarding pack for worker
- Parameters: worker_id
- Returns: pack_id, download_url, qr_code

GET /api/contractors/{contractorId}/packs/{packId}
- Download onboarding pack
- Returns: PDF file

POST /api/contractors/{contractorId}/packs/{packId}/email
- Email pack to contractor
- Parameters: email_address
```

### 11. UI Wireframes

#### Worker Dashboard - Document Upload:
```
┌─────────────────────────────────────────────┐
│ RateRight Worker Profile                    │
├─────────────────────────────────────────────┤
│ Verification Progress: [====----] 60%       │
│ Current Level: Basic → Verified             │
├─────────────────────────────────────────────┤
│ Required Documents:                         │
│ ☑ White Card [Uploaded - Verified]         │
│ ☐ Trade License [Upload required]          │
│ ☑ Bank Details [Completed]                 │
│ ☐ Emergency Contact [Add contact]          │
├─────────────────────────────────────────────┤
│ [Upload Document] [View Profile]           │
└─────────────────────────────────────────────┘
```

#### Document Upload Modal:
```
┌─────────────────────────────────────────────┐
│ Upload Trade License                        │
├─────────────────────────────────────────────┤
│ Document Type: [Dropdown select]            │
│ License Number: [Input field]              │
│ Expiry Date: [Date picker]                 │
│                                            │
│ [Drag & Drop Zone]                         │
│ or click to browse                         │
│                                            │
│ ☐ Set reminder before expiry               │
│                                            │
│ [Cancel] [Upload]                          │
└─────────────────────────────────────────────┘
```

#### Contractor Search Results:
```
┌─────────────────────────────────────────────┐
│ John Smith - Carpenter                      │
│ ⭐ Fully Verified                           │
│ 📍 Sydney, NSW | 5km away                  │
│ 💰 $45/hr | ⏰ Available tomorrow          │
│ 🏗️ 10 yrs experience | White Card ✓       │
│                                             │
│ [View Profile] [Hire Now - $50]            │
└─────────────────────────────────────────────┘
```

#### Onboarding Pack Preview:
```
┌─────────────────────────────────────────────┐
│ Onboarding Pack Generated!                  │
├─────────────────────────────────────────────┤
│ Worker: John Smith                         │
│ Verification: Fully Verified               │
│ Generated: 2024-01-15 10:30 AM            │
│                                            │
│ 📄 Download PDF                            │
│ 📧 Email to me                             │
│ 📱 View on mobile (QR Code)               │
│                                            │
│ Pack includes:                             │
│ • Personal details                         │
│ • Safety certifications (5)                │
│ • Financial details                        │
│ • Emergency contacts                       │
└─────────────────────────────────────────────┘
```

### 12. Success Metrics

#### Key Performance Indicators:
- **Document Upload Rate**: % of workers uploading documents
- **Verification Completion**: Average time to reach verified status
- **Pack Generation**: Number of packs generated per month
- **Contractor Satisfaction**: NPS score for onboarding experience
- **Time Savings**: Average onboarding time reduction
- **Worker Retention**: Verified vs non-verified worker retention
- **Revenue Impact**: Additional revenue from verified worker hires

#### Target Goals (6 months):
- 70% of active workers reach "Verified" status
- 50% reach "Fully Verified" status
- 80% reduction in onboarding time (30 min → 6 min)
- 90% contractor satisfaction with onboarding pack
- 25% increase in verified worker hire rate

### 13. Risk Mitigation

#### Technical Risks:
- **Document Storage**: Implement redundant backup systems
- **PDF Generation**: Load test generation under high demand
- **Security Breaches**: Regular security audits and penetration testing
- **System Downtime**: Implement fallback verification processes

#### Business Risks:
- **Worker Adoption**: Gamification and incentive programs
- **Contractor Acceptance**: Free trial packs for early adopters
- **Competition**: Continuous feature development and improvement
- **Compliance**: Regular legal review of document handling

#### Mitigation Strategies:
- Phased rollout with beta testing
- Comprehensive user education program
- 24/7 support during initial launch
- Regular feature updates based on feedback
- Strong SLA commitments for enterprise clients