diff --git a/Architecture-Diagram.md b/Architecture-Diagram.md new file mode 100644 index 0000000..1939d43 --- /dev/null +++ b/Architecture-Diagram.md @@ -0,0 +1,47 @@ +# FalahOS Architecture Diagram + +![FalahOS Architecture](FalahOS-Architecture.html) + +> **⚠️ Note:** The diagram is an interactive HTML/SVG file. View it directly by opening the link below. + +👉 **[Open Full Architecture Diagram](FalahOS-Architecture.html)** (opens in browser) + +--- + +## System Overview + +### Web Layer +- **ummah.falahos.my** — Primary WordPress site with EDD, MailPoet, Members, Tutor LMS +- **my.falahos.my** — Monetisation subdomain with PayPal Standard +- **Cloudflare** — DNS (proxied), WAF security rules, cloudflared tunnel +- **cPanel (RoketServer)** — Shared hosting at 64.20.37.43 with Imunify360 + +### AI Agent Layer +- **Hermes Agent (Contabo VPS)** — Primary orchestrator at 13.140.161.244 + - Gateway (Telegram, WhatsApp) + - Skills engine (60+ skills), MCP tools, sub-agents + - Cron scheduler for automated tasks +- **FalahOS Relay** — Telegram relay bus at :8088 (systemd) + +### Agent Fleet (Tailscale Mesh) +| Agent | Host | Port | Role | +|-------|------|------|------| +| Odysseus | Mac Mini 100.72.2.115 | :7860 | API Gateway | +| Pi | Mac Mini 100.72.2.115 | :4747 | AI Assistant | +| OpenHand | Mac Mini 100.72.2.115 | :3000 | Coding Agent | +| OpenClaw | Mac Mini 100.72.2.115 | :3100 | Model Provider | +| Claude Code | Mac Mini 100.72.2.115 | CLI | Coding Assistant | +| Hermes (MBA) | MacBook Air 100.76.3.26 | — | Fallback Agent | + +### External Integrations +- **Gitea** (git.falahos.my) — Git repos, CI/CD Actions, Wiki +- **OpenClaw Proxy** → DeepSeek v4, Qwen 3.6 models +- **PayPal Standard** (wanjauhari@me.com) +- **WhatsApp** Baileys bridge (+6013-225 0691) + +### Key Architecture Decisions +- **Hybrid model**: cPanel hosts web frontend/payments; Mac Mini/Contabo handle AI compute +- **Tailscale mesh** for inter-agent routing (no exposed ports) +- **FalahOS Ops Chat** as unified agent coordination channel +- **Imunify360** blocks datacenter IPs — cPanel Git/Terminal APIs used as bypass + diff --git a/FalahOS-Architecture.html b/FalahOS-Architecture.html new file mode 100644 index 0000000..1fda48f --- /dev/null +++ b/FalahOS-Architecture.html @@ -0,0 +1,409 @@ + + + + + + FalahOS Architecture Diagram + + + + +
+
+
+
+

FalahOS Architecture

+
+

Islamic Fintech OS — Multi-Agent AI Infrastructure (2026)

+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 📱 Telegram + DM + Ops Chat + @FalahOS_opsbot + + + + 💬 WhatsApp + Baileys Bridge + +6013-225 0691 + + + + 🌐 Web Browser + ummah.falahos.my + my.falahos.my + + + + + + ☁️ Cloudflare Edge (DNS + WAF + CDN) + + + + DNS + Proxied Records + + + + WAF + Security Rules + + + + Tunnel + cloudflared + + + + + + 🖥️ cPanel Hosting — RoketServer (64.20.37.43) + + + + ummah.falahos.my + WordPress + EDD • MailPoet + Members • Tutor LMS + + + + my.falahos.my + WordPress + Monetisation + PayPal Standard + + + + MySQL + Shared DB + + + + cPanel + Git • Terminal + Cron • Softaculous + + + + 🖥️ Contabo VPS (13.140.161.244) — Hermes Agent + + + + Hermes Gateway + Telegram • WhatsApp + Systemd Service + + + + Hermes Agent + Skills (60+) + Tools (MCP, Browser) + Sub-agents + Cron Scheduler + + + + FalahOS Relay + Port :8088 + Systemd + + + + SSH Tunnel + → Mac Mini :7860 + (ComfyUI) + + + + 🔗 External Services + + + + Gitea + git.falahos.my + CI/CD + Wiki + + + + OpenClaw Proxy + opencode.ai/zen + DeepSeek • Qwen + + + + PayPal + Standard + wanjauhari@me.com + + + + MCP Servers + UI/UX Tester + Browser Tools + + + + + + 🔗 Tailscale Mesh Network (Agent Fleet) + + + + + Odysseus + API Gateway + Mac Mini :7860 + 100.72.2.115 + + + + Pi + AI Assistant + Mac Mini :4747 + + + + OpenHand + Coding Agent + Mac Mini :3000 + + + + OpenClaw + Model Provider + Mac Mini :3100 + DeepSeek • Qwen + + + + Claude Code + Coding Assistant + Mac Mini CLI + + + + Hermes (MBA) + Fallback Agent + 100.76.3.26 + + + + Mac Mini (100.72.2.115) + MacBook Air (100.76.3.26) — macOS + + + + + + + + + + + HTTPS (Proxied) + + + + Webhooks + + + + Relay Bus + + + + Relay Protocol + + + + SSH Tunnel (:17860) + + + + Payment IPN + + + + Git Deploy + + + + CI/CD + + + + API Calls + + + + + + + + + + Legend + + + Frontend / Web + + + Backend / Agent + + + Cloud Service + + + Database + + + Agent / Security + + + Tunnel / Auth Flow + + + Model Provider + + +
+ + +
+
+
+
+

Web Layer

+
+
    +
  • • ummah.falahos.my — Primary WP site (EDD, MailPoet, Members, Tutor LMS)
    • +
  • • my.falahos.my — Monetisation subdomain (PayPal Standard)
    • +
  • • Cloudflare DNS + WAF (proxied records)
    • +
  • • Imunify360 (cPanel) blocks datacenter IPs
    • +
+
+ +
+
+
+

AI Agent Layer

+
+
    +
  • • Hermes Agent (Contabo) — Primary orchestrator
    • +
  • • FalahOS Ops Chat — Telegram relay bus
    • +
  • • Mac Mini Agent Fleet — Odysseus, Pi, OpenHand, OpenClaw
    • +
  • • Claude Code + Hermes (MBA) — Fallback / support
    • +
  • • Tailscale mesh network for inter-agent routing
    • +
+
+ +
+
+
+

External Integrations

+
+
    +
  • • Gitea (git.falahos.my) — Git repos, CI/CD, Wiki
    • +
  • • OpenClaw Proxy → DeepSeek v4, Qwen 3.6 models
    • +
  • • PayPal Standard (wanjauhari@me.com)
    • +
  • • WhatsApp Baileys bridge (+6013-225 0691)
    • +
+
+
+ +

+ FalahOS • Islamic Fintech OS • Multi-Agent AI Infrastructure • 2026-07-04 +

+
+ + diff --git a/Home.md b/Home.md index 492bebe..fc4f15b 100644 --- a/Home.md +++ b/Home.md @@ -17,3 +17,7 @@ Welcome to the Falah Mobile wiki. ## Getting Started See the main repo README for setup instructions. + +## Architecture + +- **[[Architecture-Diagram]]** — Full FalahOS system architecture diagram (web layer, AI agents, infrastructure, external services)