# jiangzhikj/zq-platform architecture

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

- Interactive diagram: https://gitdiagram.com/jiangzhikj/zq-platform
- Repository: https://github.com/jiangzhikj/zq-platform

## Overview

ZQ Platform is a full-stack enterprise low-code platform. Users design forms and pages, publish them, and manage their data through the Vue application and FastAPI APIs; the documented feature set also includes RBAC, organization administration, chat, AI, integrations, monitoring, and scheduled jobs. The graph groups these product capabilities and shared runtime services rather than deployment tooling. Source evidence is partial: documented capabilities and sampled router/startup wiring support the main links; unsampled subsystem internals are represented at their exact directory paths without inferred call chains.

Main entry points: [`backend/main.py`](https://github.com/jiangzhikj/zq-platform/blob/main/backend/main.py) (API Application), [`web/apps/web-ele/src`](https://github.com/jiangzhikj/zq-platform/tree/main/web/apps/web-ele/src) (Vue Admin UI), [`backend/online_dev/form_manager`](https://github.com/jiangzhikj/zq-platform/tree/main/backend/online_dev/form_manager) (Form Metadata), [`backend/core/chat`](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/chat) (Realtime Chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Low-Code Design"]
  node_web["Vue Admin UI"]
  node_formdesigner["Form Designer"]
  node_dashboarddesigner["Dashboard Designer"]
  node_formmeta["Form Metadata"]
  node_formdata["Dynamic Form Data"]
  node_pagedesigner["Page Designer"]
end

subgraph group_admin["Enterprise Administration"]
  node_identity["Users and RBAC"]
  node_org["Organization"]
  node_permissions["Resource Permissions"]
end

subgraph group_collab["Communication and AI"]
  node_chat["Realtime Chat"]
  node_messaging["Messages and Notices"]
  node_ai["AI and Knowledge"]
end

subgraph group_operations["Operations and Integrations"]
  node_files["File Management"]
  node_integrations["OAuth and Sync"]
  node_scheduler["Scheduled Jobs"]
  node_monitoring["System Monitoring"]
end

subgraph group_runtime["Shared Runtime"]
  node_api["API Application<br/>[main.py]"]
  node_database[("SQL Database<br/>[database.py]")]
  node_redis[("Redis Cache<br/>[redis.py]")]
end

node_user(("Platform User"))
node_external["External Providers"]

node_user -->|"uses"| node_web
node_web -->|"requests APIs"| node_api
node_api -->|"routes online development"| node_formmeta
node_api -->|"routes jobs"| node_scheduler
node_api -->|"serves core APIs"| node_chat
node_formdesigner -->|"configures forms"| node_formmeta
node_formmeta -->|"defines data operations"| node_formdata
node_dashboarddesigner -->|"composes pages"| node_pagedesigner
node_web -->|"manages accounts"| node_identity
node_web -->|"manages organization"| node_org
node_identity -->|"uses RBAC"| node_permissions
node_user -->|"chats"| node_chat
node_chat -->|"supports notifications"| node_messaging
node_user -->|"starts conversations"| node_ai
node_api -->|"serves file APIs"| node_files
node_integrations -->|"connects providers"| node_external
node_scheduler -->|"loads job records"| node_database
node_api -->|"closes client on shutdown"| node_redis
node_api -->|"exposes monitoring APIs"| node_monitoring
node_ai -->|"calls model providers"| node_external

click node_web "https://github.com/jiangzhikj/zq-platform/tree/main/web/apps/web-ele/src"
click node_formdesigner "https://github.com/jiangzhikj/zq-platform/tree/main/web/apps/web-ele/src/components/form-design"
click node_dashboarddesigner "https://github.com/jiangzhikj/zq-platform/tree/main/web/apps/web-ele/src/components/dashboard-design"
click node_formmeta "https://github.com/jiangzhikj/zq-platform/tree/main/backend/online_dev/form_manager"
click node_formdata "https://github.com/jiangzhikj/zq-platform/tree/main/backend/online_dev/form_data_manager"
click node_pagedesigner "https://github.com/jiangzhikj/zq-platform/tree/main/backend/online_dev/page_manager"
click node_identity "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/user"
click node_org "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/dept"
click node_permissions "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/resource_scope"
click node_chat "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/chat"
click node_messaging "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/message"
click node_ai "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/chat"
click node_files "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/file_manager"
click node_integrations "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/oauth"
click node_scheduler "https://github.com/jiangzhikj/zq-platform/tree/main/backend/scheduler"
click node_monitoring "https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/server_monitor"
click node_api "https://github.com/jiangzhikj/zq-platform/blob/main/backend/main.py"
click node_database "https://github.com/jiangzhikj/zq-platform/blob/main/backend/app/database.py"
click node_redis "https://github.com/jiangzhikj/zq-platform/blob/main/backend/utils/redis.py"

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_web,node_formdesigner,node_dashboarddesigner,node_formmeta,node_formdata,node_pagedesigner,node_user toneBlue
class node_identity,node_org,node_permissions toneAmber
class node_chat,node_messaging,node_ai toneMint
class node_files,node_integrations,node_scheduler,node_monitoring toneRose
class node_api,node_database,node_redis,node_external toneIndigo
```

## Components

### Low-Code Design

- [Vue Admin UI](https://github.com/jiangzhikj/zq-platform/tree/main/web/apps/web-ele/src): `web/apps/web-ele/src`
- [Form Designer](https://github.com/jiangzhikj/zq-platform/tree/main/web/apps/web-ele/src/components/form-design): `web/apps/web-ele/src/components/form-design`
- [Dashboard Designer](https://github.com/jiangzhikj/zq-platform/tree/main/web/apps/web-ele/src/components/dashboard-design): `web/apps/web-ele/src/components/dashboard-design`
- [Form Metadata](https://github.com/jiangzhikj/zq-platform/tree/main/backend/online_dev/form_manager): `backend/online_dev/form_manager`
- [Dynamic Form Data](https://github.com/jiangzhikj/zq-platform/tree/main/backend/online_dev/form_data_manager): `backend/online_dev/form_data_manager`
- [Page Designer](https://github.com/jiangzhikj/zq-platform/tree/main/backend/online_dev/page_manager): `backend/online_dev/page_manager`

### Enterprise Administration

- [Users and RBAC](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/user): `backend/core/user`
- [Organization](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/dept): `backend/core/dept`
- [Resource Permissions](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/resource_scope): `backend/core/resource_scope`

### Communication and AI

- [Realtime Chat](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/chat): `backend/core/chat`
- [Messages and Notices](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/message): `backend/core/message`
- [AI and Knowledge](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/chat): `backend/core/chat`

### Operations and Integrations

- [File Management](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/file_manager): `backend/core/file_manager`
- [OAuth and Sync](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/oauth): `backend/core/oauth`
- [Scheduled Jobs](https://github.com/jiangzhikj/zq-platform/tree/main/backend/scheduler): `backend/scheduler`
- [System Monitoring](https://github.com/jiangzhikj/zq-platform/tree/main/backend/core/server_monitor): `backend/core/server_monitor`

### Shared Runtime

- [API Application](https://github.com/jiangzhikj/zq-platform/blob/main/backend/main.py): `backend/main.py`
- [SQL Database](https://github.com/jiangzhikj/zq-platform/blob/main/backend/app/database.py): `backend/app/database.py`
- [Redis Cache](https://github.com/jiangzhikj/zq-platform/blob/main/backend/utils/redis.py): `backend/utils/redis.py`

### Other components

- **Platform User**
- **External Providers**

## Connections

- Platform User → Vue Admin UI: uses (evidence: `README.md`)
- Vue Admin UI → API Application: requests APIs (evidence: `README.md`)
- API Application → Form Metadata: routes online development (evidence: `backend/main.py`)
- API Application → Scheduled Jobs: routes jobs (evidence: `backend/main.py`)
- API Application → Realtime Chat: serves core APIs (evidence: `backend/main.py`)
- Form Designer → Form Metadata: configures forms (evidence: `README.md`)
- Form Metadata → Dynamic Form Data: defines data operations (evidence: `README.md`)
- Dashboard Designer → Page Designer: composes pages (evidence: `README.md`)
- Vue Admin UI → Users and RBAC: manages accounts (evidence: `README.md`)
- Vue Admin UI → Organization: manages organization (evidence: `README.md`)
- Users and RBAC → Resource Permissions: uses RBAC (evidence: `README.md`)
- Platform User → Realtime Chat: chats (evidence: `README.md`)
- Realtime Chat → Messages and Notices: supports notifications (evidence: `README.md`)
- Platform User → AI and Knowledge: starts conversations (evidence: `README.md`)
- API Application → File Management: serves file APIs (evidence: `README.md`)
- OAuth and Sync → External Providers: connects providers (evidence: `README.md`)
- Scheduled Jobs → SQL Database: loads job records (evidence: `backend/scheduler/service.py`)
- API Application → Redis Cache: closes client on shutdown (evidence: `backend/main.py`)
- API Application → System Monitoring: exposes monitoring APIs (evidence: `README.md`)
- AI and Knowledge → External Providers: calls model providers (evidence: `README.md`)