AI模块开发指南

本指南介绍如何在 NiuCloud 系统中进行AI模块功能的开发。通过输入"开发AI模块"关键词，AI 将自动识别并开始设计技术方案。

一、快速开始

1.1 触发方式

只需在 AI 对话中输入以下关键词即可自动触发工作流开发：

开发工作流

AI 将自动识别关键词并开始设计完整的技术方案。

1.2 自动触发流程

输入 "开发工作流" 或相关关键词
    ↓
AI 自动识别工作流需求
    ↓
AI 自动加载工作流技能规范
    ↓
AI 开始设计技术方案
    ↓
生成完整的代码结构

二、关键词说明

2.1 核心触发关键词

关键词	说明	AI 响应
`开发工作流`	开发新的工作流系统	自动设计技术方案
`工作流`	工作流相关开发	提供工作流开发支持
`流程设计`	设计工作流流程	进入可视化设计模式
`审批流程`	审批类业务流程	生成审批流程模板
`条件分支`	条件判断节点	配置条件表达式
`并行处理`	并行节点执行	设计并行流程
`会签`	多人会签审批	生成会签模板
`或签`	任一人审批即可	生成或签模板

2.2 节点类型关键词

关键词	节点类型	说明
`开始节点`	StartNode	流程入口点
`审批节点`	ApprovalNode	人工审批环节
`条件节点`	ConditionNode	条件判断分支
`并行节点`	ParallelNode	并行执行分支
`结束节点`	EndNode	流程结束点
`通知节点`	NotificationNode	消息通知
`脚本节点`	ScriptNode	执行脚本逻辑

2.3 场景关键词组合

# 直接触发开发
开发工作流
开发一个审批流程

# 审批场景
开发一个请假审批流程，包含部门经理审批和总经理审批
开发一个报销审批流程，支持多级审批

# 带条件分支
开发订单审核流程，根据金额判断审批级别

# 并行处理
开发合同审批流程，支持多个部门并行审批

三、技术方案生成

3.1 输入示例

直接输入以下任意一种方式：

开发工作流

或者

开发一个员工请假审批流程，包含开始、部门经理审批、总经理审批、结束节点

3.2 AI 自动生成内容

当触发"开发工作流"关键词后，AI 将自动生成：

（1）系统架构设计

┌─────────────────────────────────────────────────────┐
│                    前端层 (Vue 3)                    │
├─────────────────────────────────────────────────────┤
│  流程设计器  │  流程管理  │  待办任务  │  流程监控  │
└─────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────┐
│                    控制器层 (Controller)             │
├─────────────────────────────────────────────────────┤
│  WorkflowController  │  TaskController  │  MonitorController │
└─────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────┐
│                    服务层 (Service)                  │
├─────────────────────────────────────────────────────┤
│  WorkflowService  │  TaskService  │  EngineService │
└─────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────┐
│                    模型层 (Model)                    │
└─────────────────────────────────────────────────────┘

（2）目录结构

backend/app/adminapi/controller/workflow/
├── Workflow.php          # 流程定义控制器
├── Runtime.php          # 运行时控制器
├── Task.php            # 任务控制器
└── Monitor.php         # 监控控制器

backend/app/service/workflow/
├── WorkflowService.php  # 流程定义服务
├── RuntimeService.php   # 运行时服务
├── TaskService.php     # 任务服务
└── EngineService.php   # 引擎服务

backend/app/model/workflow/
├── Workflow.php        # 流程模型
├── Node.php           # 节点模型
├── Edge.php           # 连线模型
├── Instance.php       # 实例模型
└── Task.php           # 任务模型

（3）数据库表结构

表名	说明	核心字段
`wk_workflow`	流程定义表	workflow_id, name, config, version
`wk_node`	节点表	node_id, workflow_id, type, config
`wk_edge`	连线表	edge_id, source, target, condition
`wk_instance`	流程实例表	instance_id, workflow_id, status
`wk_task`	任务表	task_id, assignee, status

（4）API 接口

接口	方法	说明
`/adminapi/workflow/list`	GET	流程列表
`/adminapi/workflow/detail`	GET	流程详情
`/adminapi/runtime/start`	POST	启动流程
`/adminapi/task/list`	GET	任务列表
`/adminapi/task/approve`	POST	审批任务

（5）核心代码

AI 将自动生成完整的控制器、服务、模型代码。

（6）菜单配置

菜单采用 PHP 配置文件方式，配置在 app/dict/menu/admin.php 中。

字段	说明
`menu_key`	菜单唯一标识，如 `workflow_process_lists`
`menu_type`	0-目录/页面，1-按钮
`api_url`	API地址，如 `workflow/process/lists`
`methods`	HTTP方法，如 GET/POST/PUT/DELETE

菜单层级：

一级菜单：workflow（模块目录）
二级菜单：workflow_process（功能页面）
三级菜单：workflow_process_lists、workflow_process_add（操作按钮）

四、操作流程

4.1 整体开发流程

输入 "开发工作流"
    ↓
AI 分析需求
    ↓
AI 生成技术方案
    ↓
确认方案
    ↓
AI 生成代码
    ↓
后端实现
    ↓
前端实现
    ↓
测试验证

4.2 流程定义步骤

流程分类管理
    ↓
流程设计器可视化设计
    ↓
配置节点属性
    ↓
发布流程

4.3 流程运行步骤

发起流程 → 创建实例 → 生成任务 → 审批办理 → 流程结束

五、调用示例

5.1 简单触发

用户：开发工作流
AI：自动开始设计工作流系统技术方案

5.2 详细需求

用户：开发一个采购审批流程，需要部门经理和财务总监审批，金额大于10000需要总经理审批
AI：自动设计带条件分支的采购审批流程技术方案

5.3 指定节点

用户：开发一个售后处理工作流，包含开始、客服审核、工程师处理、用户确认、结束节点
AI：自动生成包含人工反馈节点的工作流技术方案

六、技术方案内容

当触发"开发工作流"后，AI 将生成完整的技术方案包括：

章节	内容
项目概述	项目背景、目标、技术栈
系统架构	整体架构图、模块划分
目录结构	完整的代码目录结构
数据库设计	表结构、字段说明
API 接口	接口列表、参数说明
菜单配置	PHP菜单配置、层级结构
核心代码	控制器、服务、模型代码
前端页面	页面结构、组件说明
配置说明	配置文件、参数说明

七、注意事项

输入清晰：尽量详细描述业务需求，AI 将生成更准确的技术方案
关键词匹配：确保包含"工作流"、"审批"等关键词以便准确识别
方案确认：生成技术方案后可进行调整和确认
代码生成：确认方案后 AI 将自动生成完整代码
菜单配置：菜单使用 PHP 配置文件（app/dict/menu/admin.php），不是 SQL

系统部署

后台手册

前端手册

Admin 端

UniApp 端

模块开发

附录

AI模块开发指南

一、快速开始

1.1 触发方式

1.2 自动触发流程

二、关键词说明

2.1 核心触发关键词

2.2 节点类型关键词

2.3 场景关键词组合

三、技术方案生成

3.1 输入示例

3.2 AI 自动生成内容

（1）系统架构设计

（2）目录结构

（3）数据库表结构

（4）API 接口

（5）核心代码

（6）菜单配置

四、操作流程

4.1 整体开发流程

4.2 流程定义步骤

4.3 流程运行步骤

五、调用示例

5.1 简单触发

5.2 详细需求

5.3 指定节点

六、技术方案内容

七、注意事项

Admin 端

UniApp 端

AI模块开发指南 ​

一、快速开始 ​

1.1 触发方式 ​

1.2 自动触发流程 ​

二、关键词说明 ​

2.1 核心触发关键词 ​

2.2 节点类型关键词 ​

2.3 场景关键词组合 ​

三、技术方案生成 ​

3.1 输入示例 ​

3.2 AI 自动生成内容 ​

（1）系统架构设计 ​

（2）目录结构 ​

（3）数据库表结构 ​

（4）API 接口 ​

（5）核心代码 ​

（6）菜单配置 ​

四、操作流程 ​

4.1 整体开发流程 ​

4.2 流程定义步骤 ​

4.3 流程运行步骤 ​

五、调用示例 ​

5.1 简单触发 ​

5.2 详细需求 ​

5.3 指定节点 ​

六、技术方案内容 ​

七、注意事项 ​

AI模块开发指南

一、快速开始

1.1 触发方式

1.2 自动触发流程

二、关键词说明

2.1 核心触发关键词

2.2 节点类型关键词

2.3 场景关键词组合

三、技术方案生成

3.1 输入示例

3.2 AI 自动生成内容

（1）系统架构设计

（2）目录结构

（3）数据库表结构

（4）API 接口

（5）核心代码

（6）菜单配置

四、操作流程

4.1 整体开发流程

4.2 流程定义步骤

4.3 流程运行步骤

五、调用示例

5.1 简单触发

5.2 详细需求

5.3 指定节点

六、技术方案内容

七、注意事项