JBlizzard-sketch/locumlink-kenya

LocumLink Kenya — A production-grade two-sided marketplace connecting verified locum medical professionals with private clinics in Nairobi. # LocumLink Kenya > The operating room for Kenya's medical staffing economy. LocumLink Kenya is a production-grade two-sided marketplace connecting verified locum medical professionals — doctors, nurses, clinical officers — with private clinics in Nairobi. It handles the entire trust layer: credential verification, digital contracts, shift matching, M-Pesa escrow payments, ratings, and dispute resolution. --- ## Live Demo | Role | Email | Password | |------|-------|----------| | Locum (GP, verified) | `dr.wanjiku@gmail.com` | `Locum@2024!` | | Clinic admin (Aga Khan Westlands) | `hr@agakhanklinic.co.ke` | `Clinic@2024!` | | Platform admin | `admin@locumlink.co.ke` | `Admin@2024!` | --- ## Architecture ``` locumlink-kenya/ ├── artifacts/ │ ├── api-server/ # Express 5 REST API (TypeScript) │ └── locumlink/ # React + Vite frontend (TypeScript) ├── lib/ │ ├── db/ # Drizzle ORM schema + migrations (PostgreSQL) │ ├── api-spec/ # OpenAPI 3.1 spec + Orval codegen config │ ├── api-zod/ # Generated Zod validation schemas │ └── api-client-react/ # Generated TanStack Query hooks └── scripts/ └── src/seed.ts # Database seed script ``` **Stack:** - **Backend:** Express 5, TypeScript, Drizzle ORM, PostgreSQL, bcryptjs, jsonwebtoken - **Frontend:** React 19, Vite, Wouter (routing), TanStack Query v5, Radix UI / shadcn, Tailwind CSS v4 - **Codegen:** OpenAPI → Orval → Zod schemas + React Query hooks (contract-first development) - **Monorepo:** pnpm workspaces --- ## Features ### For Locum Medical Professionals - **Shift discovery board** — browse open shifts filtered by specialty, date, rate, urgency - **One-click application** with cover message - **Application tracker** — applied / shortlisted / confirmed / rejected - **Booking management** — digital contract signing, check-in, completion - **Availability calendar** — set recurring availability slots - **Earnings dashboard** — monthly ea …