Falah OS — Community Edition

Islamic finance operating system with integrated Zakat, Waqf, Qurban, Sadaqah, and Infaq modules.

Architecture

falah-app (React + Vite + Tailwind) — port 3005
├── Zakat Vault     → falah-zakat  (port 3011)
├── Waqf Chain      → falah-waqf   (port 3012)
├── Qurban          → falah-qurban (port 3016)
├── Sadaqah Stream  → falah-sadaqah(port 3014)
├── Infaq           → falah-infaq  (port 3015)
├── Wallet          → wallet       (port 3002)
├── Ummah ID        → ummahid      (port 3001)
├── RAMZ            → ramz         (port 3003)
├── Prayer          → prayer       (port 3008)
├── Chat            → chat         (port 3009)
├── Community       → community    (port 3007)
├── Mock-Net        → mocknet      (port 3004)
├── Halal Certs     → certs        (port N/A)
└── API Gateway     → gateway      (port 3000)

All microservices use Express with in-memory Maps (v1.3 pattern — no PostgreSQL dependency).

Stack

• Frontend: TypeScript, React, Vite, Tailwind CSS
• Backend: Express.js, in-memory storage
• Deploy: Docker, docker-compose on Synology NAS (Alpine Linux)

Quick Start

npm install
npm run dev        # Vite dev server (hot reload)
npm run build      # Production build → dist/
node server.cjs    # Serve dist/ on port 3000

Docker

docker build -t falah-app .
docker run -d -p 3005:3000 falah-app

Modules

Module	Port	Description
Zakat Vault	3011	Nisab calculation, asset/liability wizard, history
Waqf Chain	3012	Endowment project listing, donations, certificates
Qurban	3016	Eid sacrifice booking (goat/sheep/cow/camel)
Sadaqah Stream	3014	Recurring micro-charity with cause explorer
Infaq	3015	Community crowdfunding campaigns

UI Features

• Draggable app windows with macOS-style window manager
• Dock with auto-hide toggle
• Right-click context menu (wallpaper, iStore, system info)
• Clock/date display, balance/contracts/certs widgets
• App search bar with / keyboard shortcut

License

Falah Consultancy Limited