An enterprise-grade, scalable digital marketplace built specifically for Kenya's informal workforce ("fundis", casual workers, masons, carpenters, plumbers, cleaners, mechanics, and artisans).
MicroJob_Project/
├── frontend/ # Modern React 19 + TypeScript + Vite + TailwindCSS app
│ ├── src/ # Components, pages, stores, services, interactive maps
│ ├── public/ # Static PWA assets
│ └── Dockerfile # Multi-stage production Nginx static container
│
├── backend/ # NestJS + TypeScript + Prisma ORM + PostgreSQL API
│ ├── src/ # Auth, Jobs, Workers, Applications, Escrow, Chat, Moderation
│ ├── prisma/ # Schema & seed data (47 Kenyan Counties & Trade Skills)
│ ├── test/ # Supertest E2E integration test suite
│ └── Dockerfile # Multi-stage production NestJS container
│
├── docs/ # Architectural, API & Database Schema documentation
│ ├── architecture.md
│ ├── api-docs.md
│ └── database-schema.md
│
├── infrastructure/ # Nginx reverse proxy configuration
│ └── nginx.conf
│
├── docker/ # PostgreSQL & Redis docker configs
│ └── init-db.sql
│
├── .github/ # GitHub Actions CI Workflows
│ └── workflows/
│ └── ci.yml
│
├── docker-compose.yml # Full multi-container orchestration
├── README.md # Platform documentation
└── .env.example # Environment variables template
- Kenya Location Hierarchy: Support for all 47 Counties, Sub-Counties, and Wards.
- Informal Trade Skills System: Masons, Plumbers, Electricians, Carpenters, Welders, House Cleaners, Nannies, Boda Riders, Solar Technicians, etc.
- Intelligent Proximity Matching: AI recommendation algorithm weighting skill match %, Haversine GPS distance, Trust Score, and daily rate fit.
- M-Pesa Escrow Payout Engine: Hold payments on hiring via M-Pesa STK push and release funds to fundi upon job completion.
- Real-Time Communication: Socket.io WebSocket Gateway for text, photo, and voice message dispatch.
- Interactive Proximity Map: Leaflet map displaying nearby fundis and travel radii.
- Node.js
v20+& npm10+ - Docker & Docker Desktop
Copy .env.example to .env:
cp .env.example .envdocker-compose up -d postgres rediscd backend
npm install
npx prisma db push
npx prisma db seed
npm run start:dev- Interactive OpenAPI Swagger Docs:
http://localhost:5000/api/docs
cd frontend
npm install
npm run dev- Web App UI:
http://localhost:5173
cd backend
npm run build
npm run test:e2ecd frontend
npm run test
npm run buildTo run the full stack (PostgreSQL, Redis, NestJS Backend, React Frontend) in production containers:
docker-compose up --build -d- Web Application:
http://localhost:80 - Backend API:
http://localhost:5000