{项目名称} - 业务逻辑说明

📋 核心业务规则

🔄 {业务规则1名称}

{业务规则描述}

✅ 规则：

{具体规则说明}

⚠️ 注意：

{注意事项}

🔄 状态流转

{实体}状态流转图

stateDiagram-v2 [*] --> {状态1}: 创建 {状态1} --> {状态2}: {操作1} {状态2} --> {状态3}: {操作2} {状态2} --> {状态4}: {操作3} {状态3} --> [*]: 完成 {状态4} --> [*]: 取消

状态值	状态名称	说明	可执行操作
0	{状态1}	{状态说明}	{可执行操作列表}
1	{状态2}	{状态说明}	{可执行操作列表}
2	{状态3}	{状态说明}	无
-1	{状态4}	{状态说明}	无

⏱️ 关键时序图

{关键业务}时序

sequenceDiagram autonumber actor User as 用户角色 participant App as 客户端 participant API as API网关 participant Svc as 核心服务 participant Queue as 消息队列 participant AI as AI服务 participant DB as MySQL/Redis User->>App: 触发动作 App->>API: 请求接口 API->>Svc: 参数校验 + 权限校验 Svc->>DB: 写入业务数据 Svc->>Queue: 发布业务事件 Queue->>AI: 触发分析任务 AI->>DB: 写入分析结果 API-->>App: 返回处理结果 App-->>User: 展示结果

🔄 端到端流程图

{关键链路}流程

flowchart TD A[用户发起操作] --> B[前端校验] B --> C[服务处理] C --> D[事件发布] D --> E[异步任务处理] E --> F[结果写入] F --> G[消息通知] G --> H[页面刷新与反馈]

🏗️ 系统架构图

{项目名称}系统架构

flowchart LR subgraph Client["客户端层"] C1[客户端A] C2[客户端B] end subgraph Gateway["接入层"] G1[API网关] end subgraph Service["业务服务层"] S1[服务1] S2[服务2] end subgraph AI["AI能力层"] A1[AI模块] end subgraph Data["数据层"] D1[(MySQL)] D2[(Redis)] D3[(对象存储)] end C1 --> G1 C2 --> G1 G1 --> S1 G1 --> S2 S1 --> A1 S1 --> D1 S2 --> D2 S2 --> D3

🔢 计算规则

{计算项名称}

{计算公式} = {参数1} × {参数2} + {参数3}

{公式说明}

💡 计算示例

场景：{示例场景描述}

输入：{输入参数}

计算：{计算过程}

结果：{计算结果}

🔐 权限规则

👤 角色权限

角色	权限范围	操作限制
超级管理员	全部数据	无限制
{角色1}	{数据范围}	{操作限制}
{角色2}	{数据范围}	{操作限制}

⚠️ 异常处理

🚫 异常场景

异常场景	触发条件	处理方式
{异常1名称}	{触发条件}	{处理方式}
{异常2名称}	{触发条件}	{处理方式}

← 返回文档总览