Skip to main content

BizOSaaS Platform Overview

High-Level Architecture (Hybrid Automation)​

BizOSaaS is a multi-tenant platform built for mission-critical reliability and rapid AI workflow iteration:

  • Frontend: Next.js (Admin Dashboard, Client Portal, Business Directory).
  • Brain Core: FastAPI-based services for intelligence (RAG/KAG), billing (Lago), and auth (Authentik).
  • Core Orchestration (Temporal): Self-hosted Temporal cluster managing high-risk operations (QuantTrade, Billing, State recovery).
  • Temporal AI Agent Pattern: The architecture strictly separates orchestrational logic from non-deterministic inference. Agentic loops are mapped to Workflows, while LLM inference and Tool calls are mapped to Activities, guaranteeing durable execution and self-healing.
  • AI/CRM Orchestration (n8n): Dedicated self-hosted instance utilizing native LangChain nodes and rapid SaaS integration pipelines.
  • Storefront Edge (Zapier/Make): External triggers for Shopify/Amazon sync pipelines.
  • Data Persistence: PostgreSQL (PostGIS/pgvector), Redis (Caching/Queue).

Identity & Access Management​

  • Authentik SSO: Centralized identity provider for all dashboards.
  • NextAuth.js: Integration layer for Next.js frontends.
  • Vault: Secure storage for all platform secrets and API keys.
  • RBAC: 6 roles (Super Admin, Admin, Partner, Manager, Member, Viewer) with JWT permissions enforcement.

Service Catalog​

  1. Brain Gateway: The central API hub (54 endpoint modules, 39 services).
  2. AI Agents: CrewAI-powered autonomous agents (93+ across 28 modules).
  3. Documentation Site: Docusaurus-based automated platform documentation.
  4. Client Portal: Customer-facing PWA dashboard (45+ components, 20+ routes).
  5. Admin Dashboard: Governance and platform management tool.
  6. OpenClaw Bridge: Multi-channel conversational gateway (WhatsApp, Telegram, Slack).
  7. Branding & Customization: Multi-tenant brand orchestration (ThrillRing, Bizoholic, QuantTrade) powered by BizOSaaS infrastructure.

Infrastructure Stack (Upgraded Hardware Strategy)​

  • Hardware: Targeting HP Z8 G4/G5 Workstation (Dual Xeon, High DDR4 ECC RAM, GPU ready) to safely run 24/7 mission-critical nodes separated from laptop thermal constraints.
  • Docker Compose: 13 service compose files (including local Temporal + Postgres + n8n clusters).
  • CI/CD: 8 modular GitHub Action workflows (path-based isolation).
  • Deployment: Dokploy (Docker Swarm) setup with Traefik reverse proxy + auto-SSL.
  • Observability: Prometheus + Grafana + Loki + OTEL distributed tracing.

Intelligence Bridge (Phase 11)​

  • RAG/KAG Bridge: Seamless context enrichment from vector databases into Agent execution.
  • Persona Layer: Deep integration of brand voice and tone into all AI outputs.
  • Prompt Registry: Centralized management of LLM prompts with fallback and versioning.

Marketplace & Governance (Phase 18+)​

  • Agent Marketplace: Discovery portal for third-party and specialized platform agents.
  • HITL (Human-in-the-Loop): Mandatory approval gates for higher-order autonomous actions (Financial/IRL impact).
  • Agentic Loops: Integration of reflection-based recursive task execution to minimize hallucination.

Pricing & Monetization​

  • Solo: Focused on single-site automation.
  • Pro: Advanced features for scaling businesses.
  • Agency: Multi-tenant management for marketing agencies.

Current Status (2026-03-07)​

PhaseStatus
Phases 0–17 (Core, Analytics, Intelligence, OpenClaw, Quanttrade)✅ Complete
Infrastructure Consolidation & Cleanup✅ Complete
Phase 18 (Agent Marketplace & HITL Governance)✅ Complete
Phase 19 (CI/CD Isolation & Promotion Pipeline)✅ Complete
Phase 28 (EspoCRM Self-Hosted)✅ Complete
Phase 23 (Crypto Trading Infrastructure & Paper Trading)✅ Complete (Production Ready for Strategy Testing)
Phase 24 (Binary Options Refactor)✅ Complete (Deprioritized for AI)

Strategic Directive: AI agentic trading strategy development is exclusively focused on cryptocurrencies (Binance) moving forward due to robust API access and reliable market data. Binary options (IQ Option) are explicitly avoided for autonomous AI pipelines due to high-risk, short-term volatility.

Reference: docs/architecture/ Last Updated: 2026-03-07

Copilot Overview Generation​

Here’s a comprehensive document that consolidates all the features, services, and architecture of the Bizosaas platform, updated with the latest details you’ve shared:

📖 Bizosaas Platform Detailed Overview

1. Core Features​

  • Conversational AI Interface + OpenClaw

    • Natural language interaction with AI agents.
    • Clients can use their preferred apps to communicate with the platform.
    • Supports iterative strategy discussions until client approval.

  • Strategy Agent

    • AI-driven recommendation engine.
    • Suggests marketing strategies based on digital presence, goals, and budget.
    • Coordinates with other agents to execute approved campaigns.

  • Multitenancy

    • Implemented via FastAPI Users module with customizations.
    • Supports multiple tenants (SMBs, agencies) with isolated environments.

  • Vault Security Layer

    • Secure storage for API keys, secrets, and credentials.
    • Compliance with GDPR, SOC2, ISO standards.

  • Agentic RAG + KAG Feedback Loop

    • Continuous learning system.
    • Data collection agents gather insights from multiple sources.
    • Feedback loop ensures ongoing improvement of AI agents.

  • Playground Environment

    • Clients can fine-tune outputs before deployment.
    • Encourages experimentation and customization.

2. Services & Integrations​

  • Workflow Orchestration

    • Temporal + n8n: Resilient automation and task scheduling.
    • Zapier + Make: Bridges for integrations not natively supported.

  • Future Native Integrations

    • WordPress plugin and other direct connectors for performance and security.
    • Planned expansion into deeper ecosystem integrations.

  • Observability & Monitoring

    • Grafana, Loki, Tempo, Prometheus: Monitoring, tracing, and logging.
    • Redis Cloud + Neon DB + Local DB: High-performance caching and scalable database architecture.

  • Centralized Brain API Gateway

    • Built with FastAPI.
    • Routes all service interactions for consistency, modularity, and security.

3. Analytics & Reporting​

  • Internal Metrics

    • Grafana stack for system health, latency, uptime, and infra monitoring.

  • Customer-Facing Analytics (Recommendation)

    • Custom Analytics Layer: Aggregates campaign data from external APIs (Google Ads, Meta, LinkedIn).
    • Embedded BI Tools (Metabase/Superset): More intuitive dashboards for non-technical users.
    • Unified Reporting API: Exposes analytics via Brain Gateway for client-side integrations.

4. Roadmap & Future Features​

  • Custom Agent Marketplace

    • Partners/agencies can build and share specialized agents.
    • Ecosystem-driven growth.

  • Multi-Language Support

    • Critical for Europe and Asia expansion.
    • Enables localized campaigns.

  • White-Label Option

    • Planned for medium/large clients and agencies.
    • Agencies can resell Bizosaas under their brand.

  • RBAC & Compliance Dashboard (Future Enterprise Phase)

    • Role-based access control for granular permissions.
    • Audit logging and compliance transparency.

5. Target Audience​

  • Current Focus: Small businesses, individual-owned businesses, and small agencies.
  • Future Expansion: Medium and large agencies, enterprises.

6. Architecture Summary​

  • Frontend: Conversational AI interface, client dashboards, playground.
  • Backend Services:
    • FastAPI-based Brain API Gateway.
    • Multitenancy with FastAPI Users.
    • Vault for secrets management.
    • Temporal/n8n for orchestration.
  • Integrations: Zapier, Make, future native plugins.
  • Data & Observability:
    • Redis Cloud, Neon DB, local DB.
    • Grafana, Loki, Tempo, Prometheus.
  • AI Agents:
    • Strategy Agent, execution agents, data collection agents.
    • Continuous learning via RAG/KAG feedback loop.

7. Design & Branding Philosophy (Antigravity v2)​

The platform follows an Apple-inspired design language focused on:

  • Simplicity: Reducing cognitive load through uncluttered interfaces.
  • Solid Colors: Moving away from gradients to high-legibility, professional solid color schemes.
  • Infrastructural Integrity: BizOSaaS acts as the core backend engine, while Bizoholic (Digital Marketing), ThrillRing (Gaming/Entertainment), and QuantTrade (Financial Intelligence) serve as specialized client-facing brands.
  • Client Customization: Clients can modify their branding (logos, favicons, primary colors) via the specialized backend, while the Platform Admin retains overarching control via the BizOSaaS Governance layer.

Reference: docs/architecture/ Last Updated: 2026-03-12

✅ With this architecture, Bizosaas is well-positioned to serve SMBs and agencies now, while laying the foundation for enterprise expansion later.

Would you like me to visualize this architecture in a layered diagram (text-based) so you can see how the components connect end-to-end?

🔍 Recommendations for Additional Features​

  1. Client ROI Dashboard: Show campaign performance, cost savings, and revenue impact clearly.
  2. Usage Analytics: Token consumption, agent activity, and integration usage.
  3. Automated Compliance Reports: Exportable GDPR/SOC2/ISO compliance summaries.
  4. API-first Design: Allow clients to integrate Bizosaas analytics into their own systems.
  5. Lightweight Mobile App: For SMBs to quickly check campaign status and analytics.