Skip to content

Monozu Cloud — Internal Documentation

Monozu Cloud is a multi-tenant SaaS platform for IT Operations (MSP/MSSP). It combines CMDB, ITSM, Security SOC, VPN, and Backup into a single product, deployed on Azure App Service and Cloudflare Pages.

This documentation covers the internal architecture, service integrations, authentication flows, database design, and deployment pipelines — written for developers already working on or onboarding to the platform.

Services at a glance

Section titled “Services at a glance”
ServiceTechURL (prod)
Cloud Backend APIGo 1.26 + Fiber v3https://api.cloud.monozu.io
Cloud Frontend SPAReact 18 + Vitehttps://cloud.monozu.io
Management BackendGo 1.26 + Fiber v3Azure App Service
Management FrontendReact 18 + ViteCloudflare Pages
Ingestor ServiceGohttps://ingest.cloud.monozu.io
Marketing WebsiteAstro 6https://monozu.io
Contact Form APICloudflare Workers—
Internal Docs (this site)Astro 6 + Starlighthttps://docs.cloud.monozu.io

Start here

Section titled “Start here”

Architecture

System overview, service map, and inter-service data flow diagrams.

Read →

Security & Auth

JWT lifecycle, RBAC permission catalog, and Entra ID SSO integration.

Read →

Cloud Backend

Go API structure, domain packages, database, WebSockets, and local dev setup.

Read →

Cloud Frontend

React SPA routing, state management, feature flags, and local dev setup.

Read →

Domain Flows

Key business process flowcharts: auth, incident lifecycle, CVE sync, device registration.

Read →

Deployment

Azure infrastructure, Cloudflare configuration, and Azure DevOps pipelines.

Read →

Repository layout

Section titled “Repository layout”
cloud-old/
├── Backend/                 # Go HTTP API
├── Frontend/                # React SPA
├── Management/
│   ├── management-backend/  # Go API (tenant provisioning)
│   └── management-frontend/ # React SPA (tenant management UI)
├── ingestor/                # Go service — Edge telemetry ingestion
├── Website/                 # Astro marketing site (monozu.io)
├── WebsiteContactApi/       # Cloudflare Worker — contact form
├── Documentation/           # Public user-facing docs (Astro)
├── Internal-Documentation/  # This site
├── docs/                    # Architecture reference docs
├── packages/licensing/      # Shared licensing library
└── go.work                  # Go workspace (Backend only)

Key facts

Section titled “Key facts”
  • ~588 source files, 35+ backend domain packages, 119+ frontend routes/components
  • 15 SQL migrations (V1–V28 at last count) managed by Flyway
  • Multi-tenant via Azure SQL Row-Level Security (SESSION_CONTEXT('tenant_id'))
  • Always-on modules: CMDB, ITSM (Incidents, Problems, Changes), Knowledge, Vulnerabilities, Dashboard, Settings
  • Optional modules (feature-flagged): Security SOC, VPN, Backup, Admin Panel
  • Compliance: EU Cyber Resilience Act Important Class I