# 报销流程配置表设计说明

## 一、表结构设计

### 1. 流程配置主表 (`lq_reimbursement_workflow_config`)

| 字段名 | 类型 | 说明 | 是否必填 | 默认值 |
|--------|------|------|----------|--------|
| F_Id | varchar(50) | 流程配置ID | 是 | - |
| F_WorkflowName | varchar(100) | 流程名称 | 是 | - |
| F_IsEnabled | int | 是否启用（1-启用，0-禁用） | 是 | 1 |
| F_Description | varchar(500) | 流程描述 | 否 | NULL |
| F_CreateTime | datetime | 创建时间 | 否 | CURRENT_TIMESTAMP |
| F_CreateUser | varchar(50) | 创建人ID | 否 | NULL |
| F_ModifyTime | datetime | 修改时间 | 否 | NULL |
| F_ModifyUser | varchar(50) | 修改人ID | 否 | NULL |

**索引：**
- 主键：`F_Id`
- 普通索引：`idx_is_enabled`（用于查询启用的流程）
- 普通索引：`idx_workflow_name`（用于按名称查询）

### 2. 流程节点配置表 (`lq_reimbursement_workflow_node`)

| 字段名 | 类型 | 说明 | 是否必填 | 默认值 | 对应申请节点表字段 |
|--------|------|------|----------|--------|-------------------|
| F_Id | varchar(50) | 节点配置ID | 是 | - | - |
| F_WorkflowConfigId | varchar(50) | 流程配置ID | 是 | - | - |
| F_NodeOrder | int | 节点顺序（1,2,3...） | 是 | - | F_NodeOrder ✅ |
| F_NodeName | varchar(100) | 节点名称 | 否 | NULL | F_NodeName ✅ |
| F_ApprovalType | varchar(20) | 审批类型（会签/或签） | 否 | '会签' | F_ApprovalType ✅ |
| F_IsRequired | int | 是否必审（1-必审，0-可选） | 否 | 1 | F_IsRequired ✅ |
| F_CreateTime | datetime | 创建时间 | 否 | CURRENT_TIMESTAMP | F_CreateTime ✅ |

**索引：**
- 主键：`F_Id`
- 外键：`F_WorkflowConfigId` → `lq_reimbursement_workflow_config.F_Id`（级联删除）
- 普通索引：`idx_workflow_config_id`（用于查询流程的所有节点）
- 联合索引：`idx_node_order`（用于按流程和顺序查询）

**字段映射确认：**
✅ 所有字段类型、长度、默认值完全匹配 `lq_reimbursement_application_node` 表
✅ 可以直接复制到申请节点表，无需转换

### 3. 流程节点审批人配置表 (`lq_reimbursement_workflow_node_user`)

| 字段名 | 类型 | 说明 | 是否必填 | 默认值 | 对应申请审批人表字段 |
|--------|------|------|----------|--------|---------------------|
| F_Id | varchar(50) | 记录ID | 是 | - | - |
| F_WorkflowConfigId | varchar(50) | 流程配置ID | 是 | - | - |
| F_NodeId | varchar(50) | 节点配置ID | 是 | - | - |
| F_NodeOrder | int | 节点顺序（冗余字段） | 是 | - | F_NodeOrder ✅ |
| F_UserId | varchar(50) | 审批人ID | 是 | - | F_UserId ✅ |
| F_UserName | varchar(100) | 审批人姓名 | 否 | NULL | F_UserName ✅ |
| F_SortOrder | int | 排序 | 否 | 0 | F_SortOrder ✅ |
| F_CreateTime | datetime | 创建时间 | 否 | CURRENT_TIMESTAMP | F_CreateTime ✅ |

**索引：**
- 主键：`F_Id`
- 外键1：`F_WorkflowConfigId` → `lq_reimbursement_workflow_config.F_Id`（级联删除）
- 外键2：`F_NodeId` → `lq_reimbursement_workflow_node.F_Id`（级联删除）
- 普通索引：`idx_workflow_config_id`、`idx_node_id`、`idx_user_id`
- 联合索引：`idx_node_order`（用于按流程和顺序查询）
- 唯一索引：`uk_workflow_node_user`（防止同一节点重复添加同一审批人）

**字段映射确认：**
✅ 所有字段类型、长度、默认值完全匹配 `lq_reimbursement_application_node_user` 表
✅ 可以直接复制到申请审批人表，无需转换

## 二、与现有逻辑的兼容性分析

### 2.1 数据流转逻辑

```
┌─────────────────────────────────┐
│  流程配置表（模板数据）          │
│  - lq_reimbursement_workflow_config │
│  - lq_reimbursement_workflow_node   │
│  - lq_reimbursement_workflow_node_user │
└──────────────┬──────────────────┘
               │ 创建申请时复制
               ↓
┌─────────────────────────────────┐
│  申请节点表（实际数据）          │
│  - lq_reimbursement_application_node │
│  - lq_reimbursement_application_node_user │
└──────────────┬──────────────────┘
               │ 后续所有查询
               ↓
┌─────────────────────────────────┐
│  现有查询逻辑（完全不变）        │
│  - 基于 ApplicationId 查询       │
│  - 基于 NodeOrder 排序           │
│  - 基于 NodeId 关联审批人        │
└─────────────────────────────────┘
```

### 2.2 字段映射关系

**节点配置表映射：**
| 配置表字段 | → | 申请节点表字段 | 转换逻辑 |
|-----------|---|---------------|---------|
| F_NodeOrder | → | F_NodeOrder | 直接复制 ✅ |
| F_NodeName | → | F_NodeName | 直接复制 ✅ |
| F_ApprovalType | → | F_ApprovalType | 直接复制 ✅ |
| F_IsRequired | → | F_IsRequired | 直接复制 ✅ |
| - | → | F_ApplicationId | 使用新创建的申请ID ✅ |
| - | → | F_Id | 生成新的节点ID ✅ |

**审批人配置表映射：**
| 配置表字段 | → | 申请审批人表字段 | 转换逻辑 |
|-----------|---|----------------|---------|
| F_NodeOrder | → | F_NodeOrder | 直接复制 ✅ |
| F_UserId | → | F_UserId | 直接复制 ✅ |
| F_UserName | → | F_UserName | 直接复制 ✅ |
| F_SortOrder | → | F_SortOrder | 直接复制 ✅ |
| - | → | F_ApplicationId | 使用新创建的申请ID ✅ |
| - | → | F_NodeId | 使用新创建的节点ID ✅ |
| - | → | F_Id | 生成新的记录ID ✅ |

### 2.3 现有查询逻辑兼容性

**✅ 完全兼容，无需修改：**

1. **查询申请的所有节点：**
   ```csharp
   var nodes = await _db.Queryable<LqReimbursementApplicationNodeEntity>()
       .Where(x => x.ApplicationId == id)
       .OrderBy(x => x.NodeOrder)
       .ToListAsync();
   ```
   → 查询的是申请节点表，不受配置表影响 ✅

2. **查询申请的审批人：**
   ```csharp
   var nodeUsers = await _db.Queryable<LqReimbursementApplicationNodeUserEntity>()
       .Where(x => x.ApplicationId == id)
       .OrderBy(x => x.NodeOrder)
       .ToListAsync();
   ```
   → 查询的是申请审批人表，不受配置表影响 ✅

3. **查询当前节点的审批人：**
   ```csharp
   var approvers = await _db.Queryable<LqReimbursementApplicationNodeUserEntity>()
       .Where(x => x.ApplicationId == id && x.NodeOrder == currentNodeOrder)
       .ToListAsync();
   ```
   → 查询的是申请审批人表，不受配置表影响 ✅

## 三、前端使用场景分析

### 3.1 流程配置管理（后端管理页面）

**功能需求：**
1. 列表查询：显示所有流程配置，支持按启用状态筛选
2. 新增流程：创建新流程，配置流程名称、描述、启用状态
3. 编辑流程：修改流程名称、描述、启用状态
4. 删除流程：删除流程及其所有节点和审批人配置（级联删除）
5. 节点管理：为流程添加/编辑/删除节点
6. 审批人管理：为节点添加/编辑/删除审批人

**数据操作：**
- ✅ 所有操作都在配置表进行，不影响已有申请
- ✅ 支持启用/禁用，前端列表只显示启用的流程
- ✅ 节点顺序可以调整，前端需要支持拖拽排序

### 3.2 创建报销申请（前端申请页面）

**功能需求：**
1. 流程选择：下拉框显示所有启用的流程配置
2. 流程预览：选择流程后，显示流程的节点和审批人信息
3. 审批人调整：允许用户修改审批人（如果配置了默认审批人）
4. 提交申请：传入 `workflowConfigId`，后端自动复制配置

**数据流转：**
```
前端选择流程 → 传入 workflowConfigId → 后端读取配置 → 复制到申请表 → 创建成功
```

**兼容性：**
- ✅ 如果传入 `workflowConfigId`，使用配置表数据
- ✅ 如果不传入 `workflowConfigId`，使用现有的 `nodes` 数组（保持兼容）

### 3.3 前端接口需求

**1. 获取启用的流程列表：**
```
GET /api/Extend/LqReimbursementWorkflowConfig/GetEnabledList
返回：[{ id, workflowName, description, nodeCount }]
```

**2. 获取流程详情（包含节点和审批人）：**
```
GET /api/Extend/LqReimbursementWorkflowConfig/{id}
返回：{
  id, workflowName, description, isEnabled,
  nodes: [{ nodeOrder, nodeName, approvalType, isRequired, approvers: [...] }]
}
```

**3. 创建报销申请（修改现有接口）：**
```
POST /api/Extend/LqReimbursementApplication/Create
请求：{
  ...其他字段,
  workflowConfigId: "xxx",  // 新增字段，可选
  nodes: [...]  // 如果传了 workflowConfigId，此字段可选
}
```

## 四、实现要点

### 4.1 创建申请时的数据复制逻辑

```csharp
if (!string.IsNullOrEmpty(input.workflowConfigId))
{
    // 1. 验证流程配置存在且启用
    var workflowConfig = await _db.Queryable<LqReimbursementWorkflowConfigEntity>()
        .Where(x => x.Id == input.workflowConfigId && x.IsEnabled == 1)
        .FirstAsync();
    if (workflowConfig == null)
        throw new Exception("流程配置不存在或已禁用");

    // 2. 读取流程节点配置
    var workflowNodes = await _db.Queryable<LqReimbursementWorkflowNodeEntity>()
        .Where(x => x.WorkflowConfigId == input.workflowConfigId)
        .OrderBy(x => x.NodeOrder)
        .ToListAsync();

    // 3. 读取流程审批人配置
    var workflowNodeUsers = await _db.Queryable<LqReimbursementWorkflowNodeUserEntity>()
        .Where(x => x.WorkflowConfigId == input.workflowConfigId)
        .ToListAsync();

    // 4. 复制节点配置到申请节点表
    foreach (var workflowNode in workflowNodes)
    {
        var node = new LqReimbursementApplicationNodeEntity
        {
            Id = YitIdHelper.NextId().ToString(),
            ApplicationId = entity.Id,  // 关键：关联到具体申请
            NodeOrder = workflowNode.NodeOrder,
            NodeName = workflowNode.NodeName,
            ApprovalType = workflowNode.ApprovalType,
            IsRequired = workflowNode.IsRequired,
            CreateTime = DateTime.Now
        };
        await _db.Insertable(node).ExecuteCommandAsync();

        // 5. 复制审批人配置到申请审批人表
        var nodeUsers = workflowNodeUsers
            .Where(x => x.NodeId == workflowNode.Id)
            .OrderBy(x => x.SortOrder)
            .ToList();
        
        foreach (var workflowNodeUser in nodeUsers)
        {
            var nodeUser = new LqReimbursementApplicationNodeUserEntity
            {
                Id = YitIdHelper.NextId().ToString(),
                ApplicationId = entity.Id,  // 关键：关联到具体申请
                NodeId = node.Id,  // 关键：使用新创建的节点ID
                NodeOrder = workflowNode.NodeOrder,
                UserId = workflowNodeUser.UserId,
                UserName = workflowNodeUser.UserName,
                SortOrder = workflowNodeUser.SortOrder,
                CreateTime = DateTime.Now
            };
            await _db.Insertable(nodeUser).ExecuteCommandAsync();
        }
    }
}
else
{
    // 使用现有的前端传入方式（保持兼容）
    // ... 现有逻辑
}
```

### 4.2 注意事项

1. **审批人配置是可选的：**
   - 如果配置了审批人，创建申请时自动复制
   - 如果没配置审批人，创建申请时用户需要手动选择（使用现有的 `nodes` 数组）

2. **流程配置修改不影响已有申请：**
   - 配置表只作为模板，修改配置不影响已创建的申请
   - 已创建的申请使用申请节点表的数据

3. **级联删除：**
   - 删除流程配置时，自动删除所有节点和审批人配置
   - 不会影响已创建的申请（因为数据已复制到申请表）

## 五、总结

### ✅ 设计优势

1. **完全兼容现有逻辑：** 所有现有查询逻辑无需修改
2. **字段完全匹配：** 配置表字段与申请表字段类型、长度、默认值完全一致
3. **数据隔离：** 配置表作为模板，不影响已有申请
4. **灵活使用：** 支持配置审批人，也支持创建时选择审批人
5. **前端友好：** 提供清晰的接口，便于前端实现

### ✅ 实现确认

- [x] 表结构设计完成
- [x] 字段映射关系确认
- [x] 现有逻辑兼容性确认
- [x] 前端使用场景分析
- [x] 数据复制逻辑设计
- [x] SQL创建语句生成

**结论：设计完全符合现有逻辑，前端可以顺利使用！**