# 1095071913/maozi-cloud architecture

> Architecture diagram of the GitHub repository 1095071913/maozi-cloud, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1095071913/maozi-cloud
- Repository: https://github.com/1095071913/maozi-cloud

## Overview

Maozi Cloud combines a Spring Cloud/Dubbo backend framework, a browser-based administration system, and an Electron developer console. The principal admin workflow is an operator signing in, navigating system-management screens, and invoking user/role/permission APIs; the backend also provides OAuth token services and reusable distributed-system capabilities. The developer console separately exposes local project and workstation utilities. README capabilities are represented where the tree supports them; several backend links are necessarily omitted because implementation call paths were not sampled.

Main entry points: [`maozi-cloud-admin/src/App.vue`](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/App.vue) (Admin interface), [`maozi-cloud-develop-admin/src/App.vue`](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/App.vue) (Developer console), [`maozi-cloud-develop-admin/electron/preload.ts`](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/electron/preload.ts) (Desktop bridge), [`maozi-cloud-admin/src/views/system/user/index.vue`](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/system/user/index.vue) (User management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin system"]
  node_adminui["Admin interface<br/>[App.vue]"]
  node_login["Sign in<br/>[index.vue]"]
  node_userpages["User management<br/>[index.vue]"]
  node_rolepages["Role management<br/>[index.vue]"]
  node_permissionpages["Permission management<br/>[index.vue]"]
  node_adminapi["Admin API modules<br/>[user.ts]"]
end

subgraph group_backend["Cloud backend"]
  node_restuser["User REST contract"]
  node_rpcuser["User RPC contract"]
  node_oauth["OAuth token service"]
  node_authorization["Authorization records"]
  node_rolesvc["Role permissions"]
  node_image["Image storage"]
end

subgraph group_framework["Platform capabilities"]
  node_security["OAuth security"]
  node_remoting["Remote service mode<br/>[RemoteService.java]"]
  node_gray["Gray traffic routing"]
  node_telemetry["Trace sampling<br/>[FilterSampler.java]"]
  node_locks["Distributed locks<br/>[LockAop.java]"]
  node_query["Query plugins<br/>[QueryPlugin.java]"]
end

subgraph group_developer["Developer console"]
  node_devapp["Developer console<br/>[App.vue]"]
  node_envmanager["Environment manager<br/>[EnvManager.vue]"]
  node_bookmarks["Bookmark manager"]
  node_projectconsole["Project console<br/>[ProjectConsole.vue]"]
  node_electron["Desktop bridge<br/>[preload.ts]"]
  node_localconfig[("Local configuration<br/>[store.ts]")]
  node_bookmarkstore[("Bookmark storage<br/>[store.ts]")]
end

node_operator(("Operator"))
node_oss(("Aliyun OSS"))

node_operator -->|"uses"| node_adminui
node_adminui -->|"routes to"| node_login
node_adminui -->|"routes to"| node_userpages
node_adminui -->|"routes to"| node_rolepages
node_adminui -->|"routes to"| node_permissionpages
node_userpages -->|"requests"| node_adminapi
node_adminapi -->|"calls"| node_restuser
node_operator -->|"uses"| node_devapp
node_devapp -->|"selects"| node_envmanager
node_devapp -->|"selects"| node_bookmarks
node_devapp -->|"selects"| node_projectconsole
node_envmanager -->|"uses bridge"| node_electron
node_bookmarks -->|"uses bridge"| node_electron
node_electron -->|"reads/writes"| node_localconfig
node_electron -->|"reads/writes"| node_bookmarkstore
node_oauth -->|"manages grants"| node_authorization
node_image -->|"uploads objects"| node_oss

click node_adminui "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/App.vue"
click node_login "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/login/index.vue"
click node_userpages "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/system/user/index.vue"
click node_rolepages "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/system/role/index.vue"
click node_permissionpages "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/system/permission/index.vue"
click node_adminapi "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/api/user.ts"
click node_restuser "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-api/src/main/java/com/maozi/system/user/api/rest/RestUserService.java"
click node_rpcuser "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-api/src/main/java/com/maozi/system/user/api/rpc/RpcUserInfoService.java"
click node_oauth "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-api/src/main/java/com/maozi/oauth/token/api/OauthTokenService.java"
click node_authorization "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-oauth/maozi-cloud-oauth-business/src/main/java/com/maozi/oauth/token/config/service/OAuth2AuthorizationService.java"
click node_rolesvc "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-business/src/main/java/com/maozi/system/permission/api/RolePermissionService.java"
click node_security "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-oauth/src/main/java/com/maozi/oauth/config/WebSecurityConfig.java"
click node_remoting "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-impl/src/main/java/com/maozi/service/api/annotation/RemoteService.java"
click node_gray "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-nacos/src/main/java/com/maozi/discovery/config/GrayRoundRobinLoadBalancer.java"
click node_telemetry "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-agent-opentelemetry/src/main/java/com/maozi/opentelemetry/sampler/config/FilterSampler.java"
click node_locks "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-lock/src/main/java/com/maozi/lock/config/LockAop.java"
click node_query "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-domain/maozi-cloud-domain-dto/src/main/java/com/maozi/base/plugin/query/QueryPlugin.java"
click node_image "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-business/src/main/java/com/maozi/system/image/handler/impl/AliyunOssImageStorageHandler.java"
click node_devapp "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/App.vue"
click node_envmanager "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/components/EnvManager.vue"
click node_bookmarks "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/components/BookmarkManager.vue"
click node_projectconsole "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/components/ProjectConsole.vue"
click node_electron "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/electron/preload.ts"
click node_localconfig "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/electron/configs/store.ts"
click node_bookmarkstore "https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/electron/bookmarks/store.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_adminui,node_login,node_userpages,node_rolepages,node_permissionpages,node_adminapi toneBlue
class node_restuser,node_rpcuser,node_oauth,node_authorization,node_rolesvc,node_image toneAmber
class node_security,node_remoting,node_gray,node_telemetry,node_locks,node_query toneMint
class node_devapp,node_envmanager,node_bookmarks,node_projectconsole,node_electron,node_localconfig,node_bookmarkstore toneRose
class node_operator,node_oss toneIndigo
```

## Components

### Admin system

- [Admin interface](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/App.vue): `maozi-cloud-admin/src/App.vue`
- [Sign in](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/login/index.vue): `maozi-cloud-admin/src/views/login/index.vue`
- [User management](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/system/user/index.vue): `maozi-cloud-admin/src/views/system/user/index.vue`
- [Role management](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/system/role/index.vue): `maozi-cloud-admin/src/views/system/role/index.vue`
- [Permission management](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/views/system/permission/index.vue): `maozi-cloud-admin/src/views/system/permission/index.vue`
- [Admin API modules](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-admin/src/api/user.ts): `maozi-cloud-admin/src/api/user.ts`

### Cloud backend

- [User REST contract](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-api/src/main/java/com/maozi/system/user/api/rest/RestUserService.java): `maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-api/src/main/java/com/maozi/system/user/api/rest/RestUserService.java`
- [User RPC contract](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-api/src/main/java/com/maozi/system/user/api/rpc/RpcUserInfoService.java): `maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-api/src/main/java/com/maozi/system/user/api/rpc/RpcUserInfoService.java`
- [OAuth token service](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-api/src/main/java/com/maozi/oauth/token/api/OauthTokenService.java): `maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-api/src/main/java/com/maozi/oauth/token/api/OauthTokenService.java`
- [Authorization records](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-oauth/maozi-cloud-oauth-business/src/main/java/com/maozi/oauth/token/config/service/OAuth2AuthorizationService.java): `maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-oauth/maozi-cloud-oauth-business/src/main/java/com/maozi/oauth/token/config/service/OAuth2AuthorizationService.java`
- [Role permissions](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-business/src/main/java/com/maozi/system/permission/api/RolePermissionService.java): `maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-business/src/main/java/com/maozi/system/permission/api/RolePermissionService.java`
- [Image storage](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-business/src/main/java/com/maozi/system/image/handler/impl/AliyunOssImageStorageHandler.java): `maozi-cloud-parent/maozi-cloud-service/maozi-cloud-services/maozi-cloud-business-system/maozi-cloud-system-business/src/main/java/com/maozi/system/image/handler/impl/AliyunOssImageStorageHandler.java`

### Platform capabilities

- [OAuth security](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-oauth/src/main/java/com/maozi/oauth/config/WebSecurityConfig.java): `maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-oauth/src/main/java/com/maozi/oauth/config/WebSecurityConfig.java`
- [Remote service mode](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-impl/src/main/java/com/maozi/service/api/annotation/RemoteService.java): `maozi-cloud-parent/maozi-cloud-service/maozi-cloud-service-impl/src/main/java/com/maozi/service/api/annotation/RemoteService.java`
- [Gray traffic routing](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-nacos/src/main/java/com/maozi/discovery/config/GrayRoundRobinLoadBalancer.java): `maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-nacos/src/main/java/com/maozi/discovery/config/GrayRoundRobinLoadBalancer.java`
- [Trace sampling](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-agent-opentelemetry/src/main/java/com/maozi/opentelemetry/sampler/config/FilterSampler.java): `maozi-cloud-parent/maozi-cloud-agent-opentelemetry/src/main/java/com/maozi/opentelemetry/sampler/config/FilterSampler.java`
- [Distributed locks](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-lock/src/main/java/com/maozi/lock/config/LockAop.java): `maozi-cloud-parent/maozi-cloud-config/maozi-cloud-config-lock/src/main/java/com/maozi/lock/config/LockAop.java`
- [Query plugins](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-parent/maozi-cloud-domain/maozi-cloud-domain-dto/src/main/java/com/maozi/base/plugin/query/QueryPlugin.java): `maozi-cloud-parent/maozi-cloud-domain/maozi-cloud-domain-dto/src/main/java/com/maozi/base/plugin/query/QueryPlugin.java`

### Developer console

- [Developer console](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/App.vue): `maozi-cloud-develop-admin/src/App.vue`
- [Environment manager](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/components/EnvManager.vue): `maozi-cloud-develop-admin/src/components/EnvManager.vue`
- [Bookmark manager](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/components/BookmarkManager.vue): `maozi-cloud-develop-admin/src/components/BookmarkManager.vue`
- [Project console](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/src/components/ProjectConsole.vue): `maozi-cloud-develop-admin/src/components/ProjectConsole.vue`
- [Desktop bridge](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/electron/preload.ts): `maozi-cloud-develop-admin/electron/preload.ts`
- [Local configuration](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/electron/configs/store.ts): `maozi-cloud-develop-admin/electron/configs/store.ts`
- [Bookmark storage](https://github.com/1095071913/maozi-cloud/blob/release/maozi-cloud-develop-admin/electron/bookmarks/store.ts): `maozi-cloud-develop-admin/electron/bookmarks/store.ts`

### Other components

- **Operator**
- **Aliyun OSS**

## Connections

- Operator → Admin interface: uses
- Admin interface → Sign in: routes to
- Admin interface → User management: routes to
- Admin interface → Role management: routes to
- Admin interface → Permission management: routes to
- User management → Admin API modules: requests
- Admin API modules → User REST contract: calls
- Operator → Developer console: uses
- Developer console → Environment manager: selects
- Developer console → Bookmark manager: selects
- Developer console → Project console: selects
- Environment manager → Desktop bridge: uses bridge
- Bookmark manager → Desktop bridge: uses bridge
- Desktop bridge → Local configuration: reads/writes
- Desktop bridge → Bookmark storage: reads/writes
- OAuth token service → Authorization records: manages grants
- Image storage → Aliyun OSS: uploads objects