SamMochache/ACTION--Utility-Kenya-

# 🚀 Smart Utility & Services Platform A full-stack platform for managing **utility payments** and **service bookings** in Kenya. Built with **Django REST Framework**, **React + Vite + TypeScript**, **TailwindCSS**, and **MPESA Daraja API**. --- ## 📸 Screenshots > Replace with actual screenshots of your app once ready. | Landing Page | Vendor Dashboard | Customer Dashboard | |--------------|------------------|--------------------| | | | | --- ## 🛠 Tech Stack | Layer | Technology | |---------------|------------| | **Frontend** | React 18, Vite, TypeScript, TailwindCSS, shadcn/ui, React Router, React Query/Zustand | | **Backend** | Python 3.11, Django REST Framework, JWT (SimpleJWT), DRF Filters | | **Database** | PostgreSQL (with Docker), SQLite (dev mode) | | **Payments** | MPESA Daraja API (STK Push flow) | | **Analytics** | Recharts / D3.js | | **CI/CD** | GitHub Actions | | **Deployment**| Vercel (frontend), Railway/Render/DigitalOcean (backend) | | **Dev Tools** | Docker, ESLint, Prettier, Black, Pytest | --- ## 🗓️ Project Roadmap ### ✅ Sprint 0 — Setup (1–2 days) **Goal:** Prepare environment & repositories. **Tasks:** - [x] Set up GitHub repo (frontend + backend in monorepo or separate repos). - [x] Initialize Django project (`django-admin startproject`). - [x] Initialize React + Vite + TypeScript project. - [x] Setup Docker (`docker-compose` for backend + frontend). - [x] Setup linting & formatting (**Black** for Python, **ESLint + Prettier** for TypeScript). - [x] Add GitHub Actions workflow (lint/test/build). --- ### 🟦 Sprint 1 — Backend Foundation (1 week) **Goal:** Build backend structure with authentication & base models. **Tasks:** - Install **Django REST Framework**. - Configure **JWT authentication** (`djangorestframework-simplejwt`). - Create core models: - `User` (roles: Admin, Vendor, Customer). - `Service` (title, description, price, vendor, availability). - `Transaction` (user, service, amount, status …