evergreen-realm/mutune--
Domain:
digital infrastructureRecord type:
software
Creator:
eve
Host:
MutuneRent Pro – Mombasa’s smarter property management
# MutuneRent Pro 🏢
> Full-stack property management platform for Mutune Estate Agency, Mombasa, Kenya.
> Designed to scale from 600+ to 2,000+ properties.
---
## Architecture
```mermaid
flowchart TB
subgraph Client["Frontend — Vercel"]
SPA["React 18 + Vite SPA"]
end
subgraph Server["Backend — Render (Frankfurt)"]
API["Express 4 API 29 Route Modules"]
end
subgraph Data["Database"]
DB[(MongoDB Atlas)]
end
SPA -->|HTTPS| API
API --> DB
subgraph External["External Services"]
MPESA["Safaricom M-Pesa Daraja API"]
AT["Africa's Talking SMS + USSD"]
KRA["KRA eTIMS Tax Invoices"]
KYANDA["Kyanda KPLC / Water"]
R2["Cloudflare R2 Object Storage"]
CLERK["Clerk Auth & SSO"]
RESEND["Resend Email"]
KIMI["Kimi / Moonshot AI Chat"]
SENTRY["Sentry Error Tracking"]
end
API --> MPESA
API --> AT
API --> KRA
API --> KYANDA
API --> R2
API --> CLERK
API --> RESEND
API --> KIMI
API --> SENTRY
SPA --> CLERK
```
---
## Live URLs
| Service | URL |
|---------|-----|
| **Frontend** | mutune-alpha.vercel.app |
| **Backend API** | mutunerent-api.onrender.com |
| **API Documentation** | mutunerent-api.onrender.com |
| **Health Check** | mutunerent-api.onrender.com |
---
## Repository Structure
```
mutune/
├── backend/
│ ├── config/ # Database connection, Swagger, index sync
│ ├── cron/ # Scheduled jobs (late fees, lease cleanup, rent accrual)
│ ├── middleware/ # Auth (Clerk JWT), RBAC, sanitize, security
│ ├── models/ # 24 Mongoose schemas
│ ├── routes/ # 29 REST API route modules
│ ├── services/ # External integrations (M-Pesa, SMS, eTIMS, AI, etc.)
│ ├── tests/ # 14 test suites (Jest + Supertest)
│ ├── utils/ # Logger, R2 uploads, encryption, pagination
│ ├── server.js # Express entry point
│ └── .env.example # Backend env template
│
├── frontend/
│ ├── public/assets/ # Images, icons
│ ├── src/
│ │ ├── compon …