Mahsoob Platform

Mahsoob Platform An architecture diagram generated by Archify. Users · المستخدمون · Egypt · Architecture component Users المستخدمون · Egypt WhatsApp · text · voice · RTL · Architecture component WhatsApp text · voice · RTL Evolution API · Baileys gateway · Architecture component · webhook Evolution API Baileys gateway webhook Telegram · Bot API · private · Architecture component Telegram Bot API · private Web App · Nuxt 4 · PrimeVue RTL · Mahsoob (Nuxt + Nitro) · Vue.js Web App Nuxt 4 · PrimeVue RTL Nitro API · REST · webhooks · Mahsoob (Nuxt + Nitro) Nitro API REST · webhooks Human Behavior · MySQL buffers & jobs · Mahsoob (Nuxt + Nitro) › Ban-risk mitigation · ADR 0001 Human Behavior MySQL buffers & jobs ADR 0001 Voice STT · Egyptian Arabic · Mahsoob (Nuxt + Nitro) › Ban-risk mitigation Voice STT Egyptian Arabic AI Agent · tools · AiMemory · Mahsoob (Nuxt + Nitro) AI Agent tools · AiMemory Google Gemini · LLM · audio STT · Architecture component Google Gemini LLM · audio STT Domain Services · ledger · planning · Mahsoob (Nuxt + Nitro) Domain Services ledger · planning MySQL · Prisma · queue state · Mahsoob (Nuxt + Nitro) MySQL Prisma · queue state webhook · 200 OK REST /api WA buffer TG inbound job voice notes transcribe grouped turn web CRUD generate + tools capability tools Prisma Mahsoob (Nuxt + Nitro) Ban-risk mitigation Legend Frontend Backend Database Cloud Security External

Touch points

  • • WhatsApp — one business number, routed by sender phone → ChannelIdentity
  • • Telegram — co-primary recorder; immediate inbound job queue (no human delays)
  • • Web — link codes, timeline mirror, debts, plans, budgets (ar-EG RTL)

Human Behavior engine

  • • Webhook returns 200 immediately — no sync AI in the request path
  • • Message grouping, per-phone in-flight lock, human delays & typing at send
  • • Rate-limit deferral; MySQL buffers/jobs — no Redis (ADR 0001)

AI copilot & ledger

  • • Gemini agent with Arabic capability catalog and AiMemory rules
  • • Voice STT for Egyptian Arabic; transaction working set for follow-up
  • • Domain services own Prisma — accounts, debts, recurring, plans
  • • One User across WhatsApp · Telegram · Web ChannelIdentity