evergreen-realm/mutune--

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 …