项目介绍

概述

ZQ Platform 是一款企业级低代码开发平台，采用 FastAPI + Vue 3 + UniApp 三端架构，提供可视化表单引擎、工作流引擎、AI 平台、仪表盘设计器等核心能力，帮助企业快速构建业务系统。

核心特性

可视化表单引擎

• 拖拽式设计器：50+ 组件类型，所见即所得
• 动态数据操作：DynamicSQLBuilder 适配 PostgreSQL/MySQL
• 主子表支持：一对多关联表自动处理
• 权限控制：数据权限（all/self/dept）+ 字段权限（hidden/masked）
• 导入导出：带样式 Excel 导入导出，支持子表多 Sheet

工作流引擎

• 钉钉/飞书风格：树形流程设计器
• 11 种节点：审批、办理、抄送、条件分支、并行分支、延时、通知、HTTP 服务、子流程等
• 高级审批：加签、转交、委派、超时处理、催办
• 审批人解析：支持指定用户/角色/部门/上级/发起人/表单字段

AI 平台

• 多 Provider：OpenAI、Claude、Qwen、Ollama 统一抽象
• AI 工作流：42 种节点（LLM/Code/HTTP/DB/Form/Knowledge...）
• 智能体：autonomous（function_calling/react）+ dialog_flow（工作流驱动）
• 知识库：文档索引 → 向量检索 → Rerank，支持 Q&A 标注

仪表盘设计器

• 28 种 Widget：图表、卡片、列表、日历、天气等
• 网格布局：拖拽缩放，响应式设计
• 多数据源：静态数据、API、数据源 + 字段映射

移动端

• 53 个 UI 组件：自研 zq-ui 组件库
• iOS 风格：light/dark 主题，CSS 变量系统
• 三语言：简体中文/繁体中文/英语
• 全平台：H5/微信小程序/App/鸿蒙

企业级权限

• 三级权限：操作权限 + 数据权限 + 字段权限
• 资源注册表：自动绑定权限
• OAuth 登录：10+ 平台（微信/钉钉/飞书/企微...）

技术架构

┌─────────────────────────────────────────────────────────┐
│                      客户端层                            │
├──────────────┬──────────────────┬───────────────────────┤
│   Web 前端    │   UniApp 移动端   │    第三方接入          │
│  Vue 3 + TS  │  Vue 3 + UnoCSS  │   RESTful API        │
│ Element Plus │   zq-ui (53个)    │   WebSocket          │
│  Vben Admin  │ H5/小程序/App/鸿蒙 │   SSE                │
├──────────────┴──────────────────┴───────────────────────┤
│                    Nginx / API Gateway                   │
├─────────────────────────────────────────────────────────┤
│                      后端服务层                           │
│                  FastAPI (异步)                           │
├──────────┬──────────┬──────────┬──────────┬─────────────┤
│ 表单引擎  │ 工作流引擎 │ AI 平台  │ 文件管理  │ 权限系统    │
│ FormMeta │ Workflow  │ Provider │ Storage  │ RBAC+数据权限│
│ FormData │ Engine    │ AI Flow  │ Upload   │ 字段权限     │
│ Dynamic  │ Handlers  │ Agent    │ Chunk    │ 资源注册表   │
│ SQL      │ Scheduler │ KB/RAG   │ Token    │ OAuth2      │
├──────────┴──────────┴──────────┴──────────┴─────────────┤
│                      数据存储层                           │
├──────────┬──────────┬──────────┬──────────┬─────────────┤
│PostgreSQL│  Redis   │  Qdrant  │ Minio/   │ 文件系统     │
│ /MySQL   │  缓存    │  向量DB   │ OSS/Azure│  Local      │
└──────────┴──────────┴──────────┴──────────┴─────────────┘

项目结构

zq-platform-enterprise/
├── backend-fastapi/          # 后端服务 (FastAPI)
│   ├── app/                  # 核心应用模块
│   │   ├── config.py         # 配置管理
│   │   ├── database.py       # 数据库连接
│   │   ├── base_model.py     # BaseModel 基类
│   │   ├── base_service.py   # BaseService 基类
│   │   └── ...
│   ├── core/                 # 业务模块
│   │   ├── auth/             # 认证授权
│   │   ├── form_manager/     # 表单管理
│   │   ├── form_data_manager/# 表单数据操作
│   │   ├── workflow/         # 工作流引擎
│   │   ├── ai_platform/      # AI 平台
│   │   ├── file_manager/     # 文件管理
│   │   └── ...
│   ├── alembic/              # 数据库迁移
│   ├── env/                  # 环境配置
│   └── main.py               # 应用入口
│
├── web/                      # Web 前端 (Vue 3)
│   ├── apps/web-ele/         # 主应用 (Element Plus)
│   │   └── src/
│   │       ├── views/        # 页面
│   │       ├── components/   # 业务组件
│   │       ├── api/          # API 接口
│   │       └── ...
│   └── packages/             # 共享包
│       └── @core/            # 核心包
│
├── uniapp-zq/                # 移动端 (UniApp)
│   ├── components/
│   │   ├── zq-ui/            # UI 组件库 (53个)
│   │   ├── zq-icon/          # SVG 图标
│   │   ├── zq-navbar/        # 导航栏
│   │   └── zq-tabbar/        # TabBar
│   ├── pages/                # 页面
│   ├── composables/          # 组合式函数
│   ├── i18n/                 # 国际化
│   └── styles/               # 样式
│
└── docs/                     # 技术文档 (VitePress)

适用场景

场景	说明
OA 系统	审批流程、考勤、报销、请假等
CRM 系统	客户管理、销售管理、线索跟进
ERP 系统	进销存、生产管理、财务管理
项目管理	任务管理、进度追踪、工时统计
数据看板	经营数据、销售报表、KPI 仪表盘
AI 应用	智能客服、文档问答、数据分析