Platform Guide

How Worqen Works

Explore the complete lifecycle of jobs, hires, payments and more. Interactive diagrams show you exactly how every process works on the platform.

Interactive diagrams
16 sections
01

User Onboarding

How new users join the platform and set up their profiles.

Registration

Sign up with email, password, first name & last name. Your account is created instantly.

60 Worqs Granted

Every new account receives 60 Worqs — enough for ~30 platform actions.

Crypto Wallets

Solana and TRC20 wallets are auto-generated. Private keys are encrypted and stored securely.

Profile Sections

Basic Info
Location
Languages
Education
Employment History
Certifications
Portfolio
Linked Accounts

Dual Roles

Every user can act as both Employer and Employee — the role is contextual. Post a job and you're the Employer. Create a vacancy and you're the Employee.

02

Worqs Currency

Non-tradeable internal currency that gates participation and prevents spam.

Earning Worqs
Sign up+60
Monthly grant+10
Purchase via APIVariable
Spending Worqs
Publish a job-2
Submit an application-2
Send an invitation-2

Refunds

Withdrawing an application before it's accepted gives a full refund of 2 Worqs. Declined invitations are not refunded.

How It Works

Balance is checked before every action — if insufficient Worqs, the action is blocked. Worqs are deducted first, then the action is committed. Full transaction history is available.

03

Employer: Job Flow

A Job represents work that an Employer needs done. Create a draft, publish it, and manage its lifecycle.

Draft

Not visible. Fully editable. Can be published or cancelled.

Active

Visible and accepting applications. Costs 2 Worqs to publish.

In Progress

At least one hire exists. Work is ongoing.

Paused

Temporarily hidden from search. Can resume to Active.

Completed

All work finished, reviews done.

04

Employee: Vacancy Flow

A Vacancy represents services that an Employee offers. Create a draft, publish it, and manage visibility.

Draft
Active
Paused
Closed

Draft

Not visible. Fully editable.

Active

Visible to employers. Tracks views, inquiries, invitations, hires.

Paused

Temporarily hidden. Can be resumed.

Closed

Soft-deleted, cannot be reopened.

Special Features

Platform Verification
Featured / Boost
Available Now flag
05

Discovery & Matching

How employers and employees find each other through search, filters, and map views.

How Employers Find Employees
  • Browse active vacancies with filters
  • Map view: geo-based employee search
  • Filter by category, city, rate, experience
  • View employee profile, portfolio, ratings
How Employees Find Jobs
  • Browse active jobs with filters
  • Map view: geo-based job search
  • Filter by category, urgency, rate, duration
  • View job details, milestones, employer profile

PostGIS Geo Search

Both jobs and vacancies support location-based search using PostGIS. Find opportunities near you or search within a specific radius.

06

Three Paths to Hire

There are three ways an Employer and Employee can start working together.

Path A: Employee Applies

Employee finds a job, submits application (−2 Worqs). Employer reviews, accepts or rejects. Employee can withdraw before acceptance for a refund.

Path B: Employer Invites

Employer finds a vacancy, sends invitation (−2 Worqs). Employee accepts (Worqs waived) and submits application. Employer accepts to create hire.

Path C: Direct Hire

Employer directly creates a hire for a specific employee on a job. No application step needed.

What Happens When a Hire Is Created

A hire record is created (Active), a chat is automatically created for communication, the job status updates to InProgress, and the employee is notified.

07

Hire Lifecycle

The Hire is the central entity that connects an employer with an employee for a specific job.

Hire Contains

Agreed rate & currency
Expected start/end dates
Contract document
Running totals (hours, invoiced, paid)
08

Work Logs

Work logs are used for hourly and daily payment types. Employee logs work, employer approves it.

Work Log Contains

Work date
Hours worked
Description
Tasks completed
Evidence / screenshots

Rules

  • Only for hourly/daily jobs
  • Cannot log future dates
  • Max 24 hours per day
  • One entry per date per hire
09

Milestone-Based Work

Milestones are used for fixed-price or deliverable-based work. Employer defines milestones, employee completes them.

Title & description

Amount ($ or %)

Due date

Acceptance criteria

Deliverable description

Sequence order

Revision Cycle

Employer can request revisions multiple times. Each revision increments a counter. Employee receives feedback and re-submits. No limit on revision rounds.

10

Invoicing

Invoices are the billing mechanism. Employee creates invoices, employer approves them, then payment happens via escrow.

Hourly Invoice

Based on approved work logs. Bundles work log hours into an invoice.

Milestone Invoice

Based on approved milestone. One invoice per approved milestone.

Final Invoice

Based on agreed rate. Single final invoice for entire job.

Platform Fee

1.5% of subtotal is deducted as a platform fee from the employee's payment. Example: $1000 invoice → $985 received.

11

Escrow Payments

Secure payment mechanism using Solana blockchain. Funds are locked in an on-chain escrow account until both parties confirm completion.

1

Create Escrow

USD amount converted to SOL at current price. 1.5% commission calculated. On-chain escrow account (PDA) generated.

2

Deposit On-Chain

Employer sends SOL to escrow vault. Platform verifies transaction on-chain. Hire moves to InProgress.

3

Work Happens

Employee works (logs, milestones, invoices). Funds are safely locked.

4

Both Confirm

Employer and employee independently confirm completion. Status moves to PendingRelease.

5

Release Funds

Employer releases funds. SOL sent from vault to employee's wallet. Everyone notified.

1.5% commission
USD → SOL conversion
Stored as Lamports
Full audit trail
12

Disputes & Resolution

Either party can raise a dispute if there's a disagreement about the work or payment.

Raising a Dispute
  • Provide reason for the dispute
  • Funds frozen in vault — no release possible
  • Other party notified immediately
  • Dedicated dispute chat opens
Resolution (Admin Only)
  • Admin reviews evidence and messages
  • Decides split: X% to employee, Y% to employer
  • Executes resolution on-chain
  • Both parties notified of their share
Dispute Communication

A dedicated message thread for the dispute with employer, employee, and platform admin. Supports text, evidence attachments, and system messages. Messages can only be edited within 15 minutes.

13

Completion & Reviews

How hires are completed and how the review system works.

Completion Flow
  • Employee marks hire as complete (optionally with rating + review)
  • Employer marks hire as complete (optionally with rating + review)
  • When both have completed → Hire status: Completed
Reviews
  • Rating 1–5 stars + text review
  • One review per party per hire
  • Reviews visible on public profiles
  • Notification sent when review is received
Termination

Only the employer can terminate a hire. Must provide a reason. Employee is notified. Only allowed when hire is Active.

14

Chat & Communication

Real-time messaging system with rich features for collaboration.

Auto-Created Chats

When a hire is created, a chat room is automatically created with both employer and employee as participants.

Features

Real-time messaging
Text, image, file, voice, media
Emoji reactions
Reply-to
Pin messages
Typing indicators
Read receipts
Media gallery
Mute/unmute
Archive chats

Presence System

Online
Offline
Away
Do Not Disturb
15

Notifications

Real-time notification system with WebSocket push delivery.

Persisted

Always available even if user is offline.

Real-time Push

Instant delivery via WebSocket.

Multi-Device

Supports simultaneous connections.

Notification Events

ApplicationsReceived, accepted, rejected
InvitationsReceived
HiresCreated, completed, terminated
Work LogsSubmitted, approved, rejected
MilestonesStarted, submitted, revision, approved, paid
InvoicesSubmitted, approved, disputed, paid
EscrowCreated, funded, confirmed, released, disputed, resolved
ReviewsReceived
16

State Diagrams

All state machines in one place. Select a tab to view the interactive diagram.