codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs//344/270/212/347/272/277/350/257/225/350/277/220/350/241/214/346/235/220/346/226/231/03/351/234/200/346/261/202/350/260/203/347/240/224//345/272/224/347/224/250-/350/257/246/347/273/206/350/256/276/350/256/241/346/226/207/346/241/243.md

@@ -0,0 +1,4575 @@
+**统一填报采集平台**
+
+详细设计文档
+
+**修订历史**
+
+|  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- |
+| 版本号 | 修订时间 | 修订说明 | 生效日期 | 作者 | 审核 | 批准 |
+| 1.0 | 2025/10/15 | 新建 | 2025/10/22 | 老元驹 | 汪家琼 | 冯荣峰 |
+| 1.1 | 2025/10/22 | 完善详细设计方案 | 2025/10/29 | 老元驹 | 汪家琼 | 冯荣峰 |
+
+目录
+
+一、统一的整体目标 1
+
+二、功能模块框架 1
+
+三、统一的功能菜单 2
+
+四、各模块功能点详细设计 3
+
+1. 工作台模块 3
+
+2. 任务中心模块 13
+
+3. 我的填报模块 47
+
+4. 审批中心模块 63
+
+5. 指标查询模块 69
+
+6. 表单管理模块 82
+
+7. 报告管理模块 123
+
+8. 系统管理模块 131
+
+**一、统一的整体目标**
+
+统一填报采集平台是一个综合性的数据管理与分析系统，旨在为组织提供高效、规范的数据填报、处理和分析能力。该平台整合了多个功能模块，包括工作台、任务中心、填报管理、审批流程、数据查询、表单管理、报告生成和系统管理等，形成一套完整的数据治理解决方案。
+
+**核心目标：**
+
+1. **统一数据入口**：提供工作台模块作为用户的统一入口，展示关键信息和操作指引，让用户能够快速了解系统整体状态。
+2. **任务驱动的填报流程**：通过任务中心模块驱动用户的数据填报工作，确保数据填报的有序性和及时性。
+3. **灵活的表单与数据管理**：表单管理模块提供强大的表单设计和管理能力，支持复杂的业务逻辑和数据验证。
+4. **规范的审批流程**：审批中心模块提供完善的工作流审批机制，确保数据的审查和批准流程规范有序。
+5. **全面的数据查询分析**：指标查询模块为用户提供统一的数据查询和分析能力，支持多维度的数据访问。
+6. **自动化的报告生成**：报告管理模块支持自动生成各类报告，并支持多种格式的导出。
+7. **完整的系统治理**：系统管理模块提供用户管理、权限控制、组织管理等功能，确保系统的安全性和可管理性。
+
+**二、功能模块框架**
+
+|  |
+| --- |
+| Plaintext 统一填报采集平台 │ ├─ 工作台模块（Dashboard） │ └─ 关键指标展示、快速操作入口 │ ├─ 任务中心模块 │ └─ 任务分配、填报驱动、进度跟踪 │ ├─ 我的填报模块 │ └─ 填报表单、数据验证、状态管理 │ ├─ 审批中心模块 │ └─ 工作流审批、权限控制、历史追踪 │ ├─ 指标查询模块 │ └─ 数据查询、多维分析、权限查看 │ ├─ 表单管理模块 │ └─ 表单设计、字段配置、版本管理 │ ├─ 报告管理模块 │ └─ 报告生成、多格式导出、归档管理 │ └─ 系统管理模块  └─ 用户管理、权限控制、组织管理、系统配置 |
+
+**三、统一的功能菜单**
+
+本平台的功能菜单按照模块进行组织，用户可以根据自身的权限和角色访问相应的功能模块：
+
+1. **工作台模块**
+
+* 访问路径：主菜单 → 工作台
+* 主要功能：数据填报、查看、审批和管理
+
+1. **任务中心模块**
+
+* 访问路径：主菜单 → 任务中心
+* 主要功能：数据填报、查看、审批和管理
+
+1. **我的填报模块**
+
+* 访问路径：主菜单 → 我的填报
+* 主要功能：数据填报、查看、审批和管理
+
+1. **审批中心模块**
+
+* 访问路径：主菜单 → 审批中心
+* 主要功能：数据填报、查看、审批和管理
+
+1. **指标查询模块**
+
+* 访问路径：主菜单 → 指标查询
+* 主要功能：数据填报、查看、审批和管理
+
+1. **表单管理模块**
+
+* 访问路径：主菜单 → 表单管理
+* 主要功能：数据填报、查看、审批和管理
+
+1. **报告管理模块**
+
+* 访问路径：主菜单 → 报告管理
+* 主要功能：数据填报、查看、审批和管理
+
+1. **系统管理模块**
+
+* 访问路径：主菜单 → 系统管理
+* 主要功能：数据填报、查看、审批和管理
+
+**四、各模块功能点详细设计**
+
+**1. 工作台模块**
+
+**功能框架**
+
+工作台模块
+
+**功能点详细设计**
+
+1. 原型界面
+2. 指标快速搜索
+   功能说明
+   支持用户在工作台界面快速搜索系统内的相关指标,方便用户即时获取指标详情和数据。用户输入关键字后,系统实时匹配并展示相关指标列表,点击指标可跳转到指标查询模块查看详情。
+   原型界面
+   操作流程
+   用户在工作台的搜索框输入指标关键字。
+   系统实时匹配指标名称、指标编码,以下拉列表形式展示匹配的指标(最多显示10条)。
+   用户点击某条指标,系统跳转至指标查询模块,自动定位并展示该指标详情。
+   界面设计
+   页面顶部设置显眼的搜索框,输入框宽度适中,右侧显示搜索图标。
+   搜索结果以下拉列表形式展示指标名称和简要描述。
+   支持键盘上下键选择,回车键确认。
+   界面字段
+   界面操作
+   关键字输入: 实时触发搜索。
+   点击搜索结果: 跳转至指标查询模块的指标详情页。
+   清空搜索框: 清除搜索结果,隐藏下拉列表。
+3. 创建任务入口
+   功能说明
+   提供一个显眼的快捷入口,允许任务发起人快速跳转到任务中心进行新任务的创建。该入口仅对具有"任务发起人"角色的用户可见。
+   操作流程
+   用户在工作台点击"创建任务"按钮。
+   系统验证用户是否具有"任务发起人"角色。
+   系统跳转至任务中心模块的任务创建界面。
+   界面设计
+   页面中间或右上角设置一个高亮或突出的"创建任务"按钮/卡片。
+   按钮使用主题色,带有图标(如"+"号或文档图标)。
+   界面字段
+   界面操作
+   点击按钮: 跳转至任务中心的任务创建页面。
+4. 待办事项展示
+   功能说明
+   实时展示当前用户所有待处理的任务,包括填报任务、审批任务等,并可直接点击进入详情处理。待办列表分为"我的填报"和"我的审批"两类,用户可快速识别任务类型并处理。此功能需与招商随行待办任务对接集成。
+   操作流程
+   用户登录工作台。
+   系统从任务中心和审批中心获取当前用户的待办任务列表。
+   待办列表按任务类型分类展示(填报待办、审批待办)。
+   用户点击某条待办任务,跳转至我的填报或审批中心详情页进行处理。
+   界面设计
+   待办列表采用卡片或列表形式展示,每条记录显示任务名称、类型、截止日期、发起人等关键信息。
+   支持按"紧急程度"(临期、逾期、正常)标记任务。
+   支持分页显示,默认显示前10条,可点击"查看更多"。
+   支持下拉刷新或自动刷新。
+   界面字段
+   界面操作
+   列表项点击: 跳转至对应的任务详情页或处理页(我的填报/审批中心)。
+   刷新待办列表: 点击刷新按钮。
+   筛选任务类型: 通过Tab页切换"填报待办"和"审批待办"。
+   查看更多: 点击加载更多待办任务。
+5. 临期逾期催办消息提醒
+   功能说明
+   系统根据任务截止日期,判断任务是否临期或逾期,并向相关用户(填报人、审批人)发送催办消息提醒。该消息提醒功能需与招商随行待办任务对接集成,支持站内消息。
+   操作流程
+   系统定时扫描任务状态(每小时执行一次),识别临期/逾期任务。
+   系统生成催办提醒消息,包括任务名称、截止日期、发起人等信息。
+   通过消息通知集成接口,向用户工作台和招商随行待办发送消息。
+   用户在工作台消息中心查看催办消息,点击消息跳转至任务详情页。
+   界面设计
+   消息提醒以页面顶部通知栏、消息中心列表或待办列表中的特殊标记形式展示。
+   临期任务显示黄色标记,逾期任务显示红色标记。
+   消息中心显示未读消息数量徽章。
+   界面字段
+   界面操作
+   查看消息详情: 点击消息列表项,展开消息内容。
+   消除提醒: 标记消息为"已读"或删除消息。
+   跳转任务: 点击任务链接,跳转至任务详情页。
+   催办规则
+   临期任务: 距离截止日期小于24小时的任务,每6小时发送一次提醒。
+   逾期任务: 超过截止日期的任务,每12小时发送一次提醒,直至任务完成或取消。
+   提醒方式:站内消息、招商随行推送。
+   五、业务流程
+6. 工作台加载整体流程
+7. 指标快速搜索流程
+8. 待办任务查询流程
+9. 催办消息提醒流程
+   六、接口设计
+10. 获取工作台数据接口
+    接口路径: GET /api/dashboard/overview
+    请求参数: 无(通过登录态获取当前用户ID)
+    响应数据:
+    {
+    "code": 200,
+    "message": "success",
+    "data": {
+    "todoTasks": {
+    "fillTasks": [
+    {
+    "taskId": "T001",
+    "taskName": "2024年Q4财务数据填报",
+    "taskType": "填报任务",
+    "deadline": "2025-10-20 18:00:00",
+    "initiator": "张三",
+    "status": "临期"
+    }
+    ],
+    "approvalTasks": [
+    {
+    "taskId": "A001",
+    "taskName": "财务报表审批",
+    "taskType": "审批任务",
+    "deadline": "2025-10-18 18:00:00",
+    "initiator": "李四",
+    "status": "逾期"
+    }
+    ]
+    },
+    "messages": [
+    {
+    "messageId": "M001",
+    "content": "您有1个任务即将逾期,请及时处理",
+    "time": "2025-10-14 10:00:00",
+    "taskLink": "/task/detail/T001",
+    "isRead": false
+    }
+    ],
+    "statistics": {
+    "pendingFillCount": 5,
+    "pendingApprovalCount": 3,
+    "completedCount": 20,
+    "overdueCount": 2
+    }
+    }
+    }
+11. 获取待办任务列表接口
+    接口路径: GET /api/dashboard/todos
+    请求参数:
+    响应数据:
+    {
+    "code": 200,
+    "message": "success",
+    "data": {
+    "total": 8,
+    "list": [
+    {
+    "taskId": "T001",
+    "taskName": "2024年Q4财务数据填报",
+    "taskType": "填报任务",
+    "deadline": "2025-10-20 18:00:00",
+    "initiator": "张三",
+    "status": "临期",
+    "detailUrl": "/fill/detail/T001"
+    }
+    ]
+    }
+    }
+12. 搜索指标接口
+    接口路径: GET /api/dashboard/search-metrics
+    请求参数:
+    响应数据:
+    {
+    "code": 200,
+    "message": "success",
+    "data": [
+    {
+    "metricCode": "M001",
+    "metricName": "财务应付明细",
+    "categoryName": "财务应收应付"
+    }
+    ]
+    }
+13. 获取消息提醒列表接口
+    接口路径: GET /api/dashboard/messages
+    请求参数:
+    响应数据:
+    {
+    "code": 200,
+    "message": "success",
+    "data": {
+    "total": 5,
+    "unreadCount": 3,
+    "list": [
+    {
+    "messageId": "M001",
+    "content": "您有1个任务即将逾期,请及时处理",
+    "time": "2025-10-14 10:00:00",
+    "taskLink": "/task/detail/T001",
+    "isRead": false
+    }
+    ]
+    }
+    }
+14. 标记消息为已读接口
+    接口路径: PUT /api/dashboard/messages/{messageId}/read
+    请求参数:
+    响应数据:
+    {
+    "code": 200,
+    "message": "消息已标记为已读"
+    }
+15. 获取任务统计数据接口
+    接口路径: GET /api/dashboard/statistics
+    请求参数: 无(通过登录态获取当前用户ID)
+    响应数据:
+    {
+    "code": 200,
+    "message": "success",
+    "data": {
+    "pendingFillCount": 5,
+    "pendingApprovalCount": 3,
+    "completedCount": 20,
+    "overdueCount": 2
+    }
+    }
+    七、数据库设计
+    消息通知记录表 (msg\_notice)
+    存储发送给用户的催办消息和系统通知。
+
+|  |  |  |
+| --- | --- | --- |
+| 一级菜单 (模块名称) | 二级菜单 | 三级菜单 |
+| 工作台 |  |  |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 搜索关键字 | 文本输入 | 输入指标名称或编码关键字。 |
+| 指标名称 | 文本展示 | 展示匹配的指标名称。 |
+| 指标编码 | 文本展示 | 展示匹配的指标编码。 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 创建任务按钮 | 按钮 | 点击跳转创建任务。 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 任务名称 | 文本展示 | 待办任务的名称。 |
+| 任务类型 | 文本标签 | 填报任务/审批任务。 |
+| 截止日期 | 文本展示 | 任务的截止日期。 |
+| 任务发起人 | 文本展示 | 发起该任务的用户姓名。 |
+| 任务状态 | 状态标签 | 正常/临期/逾期。 |
+| 操作 | 链接按钮 | 点击进入任务详情或处理页面。 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 消息内容 | 文本展示 | 催办消息的详细内容。 |
+| 消息时间 | 文本展示 | 消息发送的时间。 |
+| 任务链接 | 超链接 | 点击跳转至任务详情页。 |
+| 消息状态 | 状态标签 | 已读/未读。 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| taskType | String | 否 |
+| pageNum | Integer | 否 |
+| pageSize | Integer | 否 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| keyword | String | 是 |
+| limit | Integer | 否 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| isRead | Boolean | 否 |
+| pageNum | Integer | 否 |
+| pageSize | Integer | 否 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| messageId | String | 是 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | bigint | 20 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| created\_by | VARCHAR | 255 |
+| updated\_by | VARCHAR | 255 |
+| receiver\_user\_id | varchar | 64 |
+| message\_type | varchar | 32 |
+| message\_title | varchar | 200 |
+| message\_content | text | — |
+| send\_time | datetime | — |
+| is\_read | tinyint(1) | — |
+| read\_time | DATETIME | — |
+| task\_link | varchar | 500 |
+| priority | varchar | 10 |
+| expire\_time | datetime | — |
+| is\_expire | tinyint(1) | — |
+
+**2. 任务中心模块**
+
+**功能框架**
+
+任务中心
+
+**功能点详细设计**
+
+1. 任务列表与查询
+   功能说明
+   任务发起人进入"我的任务"界面后,系统默认展示该用户发起的所有任务列表,支持通过多种查询条件进行筛选和搜索,并提供快捷操作入口。列表支持分页显示、多字段排序和按权限过滤数据。
+   原型界面
+   界面设计
+   顶部为查询区域,包含多个查询条件输入框和"查询"、"重置"、"创建任务"按钮。
+   中部为列表展示区域,支持分页和多列展示。
+   列表支持固定列头,横向滚动查看更多字段。
+   操作流程
+   用户进入"任务中心"->"我的任务"菜单。
+   系统展示任务列表(默认显示当前用户发起的所有任务)。
+   用户在查询条件区域输入或选择条件,点击"查询"按钮筛选列表。
+   点击"重置"按钮清空所有查询条件,恢复默认列表。
+   在列表中,用户可以对任务进行"编辑任务"、"查看进度"、"复制任务"、"取消任务"、"查看详情"等操作。
+   查询条件项
+   列表字段栏目
+   数据权限
+   任务发起人权限: 仅能查看由当前用户发起创建的所有任务。
+   列表的操作按钮
+   操作按钮根据任务状态动态显示：
+   任务进行中时，展示：编辑任务，查看进度，取消任务，复制任务
+   任务已完成时，展示：查看详情，复制任务
+   任务未发布时，展示：编辑任务，删除任务，复制任务
+2. 创建任务
+   功能说明
+   任务发起人通过此界面创建新任务。填写任务的基本信息,包括任务名称、填报周期、截止日期、选择表单模板、配置填报单位和填报人,以及设置审批流程。支持两种下发方式:直接下发和保存草稿。
+   原型界面
+   界面设计
+   表单式布局,分区展示不同类型的配置项。
+   填报配置区支持动态添加/删除多组配置。
+   必填项用红色星号标识。
+   底部操作按钮区:保存、下发、取消。
+   操作流程
+   任务发起人进入"我的任务"菜单,点击"创建任务"按钮。
+   选择填报周期(必填)。
+   选择表单模板,系统自动带出主属部门和业务领域。
+   填写任务名称(必填)。
+   系统展示表单模板关联的默认审批流程，如果表单里没有设置，并且有
+   可勾选"强制审批"选项。
+   设置任务截止日期(必填)。
+   勾选是否汇总填报（必填，如果 是否生成报告 为是，那么值锁定为是）。
+   勾选是否生成报告（必填）。
+   上传要是用的报告模板（如果 是否生成报告 为是，那么必填）
+   填写对接随行爱写作接口。
+   填写任务描述(可选)。
+   动态添加填报单位和填报人(至少配置一组)。
+   点击"保存"按钮:任务以"未下发"状态暂存为草稿。
+   点击"下发"按钮:任务将保存到数据库,并整体下发到填报人,同时发送通知。
+   界面字段
+   界面操作
+   选择填报周期
+   选择表单模板(触发主属部门和业务领域的自动填充)
+   点击"表单详情"(查看所选表单模板的详细信息)
+   勾选"强制审批"
+   选择截止日期
+   勾选是否汇总填报
+   勾选是否生成报告
+   上传报告模板文件
+   配置随行爱写作的接口地址
+   添加填报配置(新增一组填报单位/填报人)
+   删除填报配置(删除某组填报单位/填报人)
+   点击"保存"(保存为草稿,状态为"未下发")
+   点击"下发"(保存并下发任务,状态为"进行中")
+   点击"取消"(关闭页面,返回列表)
+3. 编辑任务
+   功能说明
+   任务发起人可修改已创建任务的基本信息,包括任务名称、截止日期、任务描述,并可添加或删除填报单位和填报人。对于已下发的任务,新增的填报配置将立即下发。
+   原型界面
+   操作流程
+   任务发起人在任务列表中选择某个任务,点击"编辑"操作按钮。
+   系统展示任务编辑页面,预填充现有任务信息。
+   用户可修改任务名称、截止日期、任务描述。
+   用户可添加新的填报单位和填报人(对于已下发任务,新增配置将在保存后立即下发)。
+   用户可删除尚未开始填报的填报配置。
+   点击"保存"按钮,系统更新任务信息。
+   系统提示保存成功,返回任务列表。
+   界面设计
+   表单式布局,与创建任务界面保持一致。
+   不可修改字段置灰显示。
+   填报配置区支持动态添加/删除(已开始填报的配置不可删除)。
+   界面字段
+   同创建任务,但部分字段不可编辑:
+   界面操作
+   修改任务名称
+   修改截止日期
+   修改任务描述
+
+添加填报配置(新增一组填报单位/填报人)
+删除填报配置(仅可删除尚未开始填报的配置)
+点击"保存"(保存修改)
+点击"取消"(放弃修改,返回列表)
+4. 查看进度
+功能说明
+任务发起人可查看任务下各单位的填报进度。对于"审批中"和"已完成"的子任务,发起人可查看填报详情、审批流程、任务拆分情况和填报进度。支持按填报单位、填报负责人、任务状态等条件筛选子任务列表。
+原型界面
+查询/重置
+查询 (Query): 根据用户输入的查询条件,筛选并展示符合条件的子任务列表。
+重置 (Reset): 清空所有查询条件项,并重新加载默认的子任务列表。
+操作流程
+任务发起人在任务列表中点击某个任务的"查看进度"按钮。
+系统展示任务进度详情页,包含主任务信息列表。
+用户可通过查询条件筛选子任务列表。
+对于"审批中"和"已完成"状态的子任务,可点击"查看详情"按钮,跳转查看填报数据、审批流程等。
+对于有"整体分发"或"拆解分发"的子任务,可点击相应按钮,弹窗查看下级填报情况,逐级展示填报人、填报单位、所属部门、任务状态等信息。
+用户可点击"取消"按钮(需二次确认),取消整个任务。
+用户可勾选复数个任务后，点击“任务催办”按钮，催办任务。
+用户可勾选单个任务后，点击“生成报告”按钮，生成填报报告。
+界面设计
+顶部主任务信息区,展示任务的基本信息和整体进度。
+中部查询条件区,支持多条件筛选。
+底部子任务列表,展示各填报单位的任务状态和进度。
+子任务列表每行操作:查看详情、查看分发情况(如有拆分)。
+查询条件项
+主任务信息展示字段
+子任务列表字段栏目
+整体分发/拆解分发填报情况弹窗字段
+界面操作
+查询条件筛选
+点击"查看详情"(跳转到子任务填报详情页)
+点击"查看分发情况"(弹窗展示下级填报情况)
+点击"取消"按钮(取消整个任务,需二次确认)
+点击"任务催办"发起催办通知
+点击“生成报告”生成报告
+分页查询操作
+5. 取消任务
+功能说明
+任务发起人可以取消正在进行中的任务。取消任务后,所有已下发的子任务将被终止,填报人将无法继续填报。
+操作流程
+任务发起人在任务列表中点击"取消"按钮,或在任务进度详情页点击"取消"按钮。
+系统弹出确认提示:"取消任务后,所有已下发的子任务将被终止,填报人将无法继续填报,是否确认取消?"
+用户点击"确认"按钮。
+系统将任务状态更新为"已取消"。
+系统向所有填报人发送任务取消通知。
+系统提示"任务已取消",返回任务列表。
+界面设计
+二次确认弹窗,展示取消任务的影响。
+确认按钮:确认、取消。
+界面操作
+点击"取消"按钮(列表或进度详情页)
+确认取消操作
+系统发送通知
+6. 复制任务
+功能说明
+任务发起人可以复制已有任务的配置,用于快速创建新任务。复制任务时,系统会复制任务的所有配置项(表单模板、填报周期、审批流程、填报单位和填报人等),但不复制任务状态和填报数据。
+操作流程
+任务发起人在任务列表中点击某个任务的"复制"按钮。
+系统跳转到任务创建页面,预填充原任务的所有配置项。
+系统自动生成新的任务名称(在原任务名称后加"-副本"后缀)。
+用户可根据需要修改任务配置。
+用户点击"保存"或"下发"按钮,创建新任务。
+界面设计
+复用任务创建页面。
+预填充原任务的配置项。
+界面操作
+点击"复制"按钮(跳转到任务创建页面)
+修改任务配置
+保存或下发新任务
+7. 任务分类查询
+功能说明
+为任务创建人提供对权限内所有任务的分类查询功能。支持按组织部门树和业务领域树筛选任务,结合多条件查询,快速定位目标任务。
+原型界面
+查询/重置
+查询 (Query): 根据用户输入的查询条件,筛选并展示符合条件的任务列表。
+重置 (Reset): 清空所有查询条件项,并重新加载默认的任务列表。
+操作流程
+用户进入"任务中心"->"任务分类"菜单。
+系统展示左侧组织部门树(默认)和右侧任务列表。
+用户可通过顶部页签切换"按组织部门"或"按业务领域"查看。
+用户点击左侧树节点,右侧列表自动刷新,显示该节点及其子节点下的所有任务。
+用户可通过查询条件项进一步筛选任务列表。
+用户可点击任务的"查看详情"按钮,跳转至任务填报详情界面查看任务详情。
+界面设计
+布局: 左右布局,左侧为树形结构,右侧为任务列表。
+联动: 左侧树节点的点击事件触发右侧列表的刷新,实现"树-表"联动查询。
+切换: 顶部Tab支持切换"按组织部门"和"按业务领域"两种视图。
+查询条件项
+列表字段栏目
+界面操作
+Tab切换(按组织部门/按业务领域)
+点击树节点筛选任务
+查询条件筛选
+点击"查看详情"(跳转到任务详情页)
+分页操作
+五、业务流程
+
+1. 任务创建与下发流程
+2. 编辑任务流程
+3. 查看任务进度流程
+   六、接口设计
+4. 任务管理接口
+   1.1 获取任务列表
+   接口路径: POST /api/lcplogics/loadMyTaskTableView3
+   接口说明: 获取任务列表,支持多条件查询和分页
+   请求参数:
+   响应示例:
+   {
+   "RequestId": "120bc44d-5e91-4cb7-ae3f-b6fe077c8fbb",
+   "Code": 200,
+   "Message": "",
+   "Data": {
+   "list": [
+   {
+   "taskInstance": {
+   "id": 3237095302078720,
+   "createdTime": "2025-10-15T09:35:31.000Z",
+   "updatedTime": "2025-10-15T11:03:20.000Z",
+   "createdBy": "DEVACC-rwzx",
+   "updatedBy": "DEVACC-rwzx",
+   "creatorOrgId": null,
+   "creatorDeptId": null,
+   "mainTaskId": 0,
+   "parentInstanceId": null,
+   "taskName": "123123",
+   "deadline": "2025-10-15",
+   "status": "NOT\_DISTRIBUTED",
+   "description": "123123123123",
+   "formTemplateId": 2,
+   "formTemplateName": "项目立项申请表",
+   "unitId": null,
+   "reporterUserId": 0,
+   "reporterDeptId": null,
+   "finalContentJson": null,
+   "appId": null,
+   "fillInPeriod": "YEAR",
+   "fillInFrequency": "123",
+   "belongOrgId": "ORG002",
+   "belongOrgName": "项目管理部",
+   "categoryId": "BD002",
+   "categoryName": "项目管理",
+   "wfId": "AF002",
+   "wfName": "项目审批流程B",
+   "isNeedVerify": "false"
+   }
+   }
+   ],
+   "total": 1
+   }
+   }
+   1.2 获取任务详情
+   接口路径: GET /api/task-instance?id={id}
+   接口说明: 获取任务的完整信息
+   请求参数: 无
+   响应示例:
+   {
+   "RequestId": "a406a6c8-3a26-4020-b817-29d9c6f44686",
+   "Code": 200,
+   "Message": "",
+   "Data": {
+   "id": 3237095302078720,
+   "createdTime": "2025-10-15T09:35:31.000Z",
+   "updatedTime": "2025-10-15T11:03:20.000Z",
+   "createdBy": "DEVACC-rwzx",
+   "updatedBy": "DEVACC-rwzx",
+   "creatorOrgId": null,
+   "creatorDeptId": null,
+   "mainTaskId": 0,
+   "parentInstanceId": null,
+   "taskName": "123123",
+   "deadline": "2025-10-15",
+   "status": "NOT\_DISTRIBUTED",
+   "description": "123123123123",
+   "formTemplateId": 2,
+   "formTemplateName": "项目立项申请表",
+   "unitId": null,
+   "reporterUserId": 0,
+   "reporterDeptId": null,
+   "finalContentJson": null,
+   "appId": null,
+   "fillInPeriod": "YEAR",
+   "fillInFrequency": "123",
+   "belongOrgId": "ORG002",
+   "belongOrgName": "项目管理部",
+   "categoryId": "BD002",
+   "categoryName": "项目管理",
+   "wfId": "AF002",
+   "wfName": "项目审批流程B",
+   "isNeedVerify": "false"
+   }
+   }
+   1.3 创建任务
+   接口路径: POST /api/lcplogics/createTask
+   接口说明: 创建新任务
+   请求参数:
+   {
+   "task": {
+   "id": null,
+   "createdTime": null,
+   "updatedTime": null,
+   "createdBy": null,
+   "updatedBy": null,
+   "creatorOrgId": null,
+   "creatorDeptId": null,
+   "mainTaskId": null,
+   "parentInstanceId": null,
+   "taskName": "任务名称",
+   "deadline": null,
+   "status": null,
+   "description": "描述",
+   "formTemplateId": 1,
+   "formTemplateName": "月度绩效考核表",
+   "unitId": null,
+   "reporterUserId": null,
+   "reporterDeptId": null,
+   "finalContentJson": null,
+   "appId": null,
+   "fillInPeriod": "YEAR",
+   "fillInFrequency": null,
+   "belongOrgId": "ORG001",
+   "belongOrgName": "人力资源部",
+   "categoryId": "BD001",
+   "categoryName": "人事管理",
+   "wfId": "AF001",
+   "wfName": "绩效考核流程A",
+   "isNeedVerify": null
+   },
+   "fillInPersonList": [
+   {
+   "id": null,
+   "createdTime": null,
+   "updatedTime": null,
+   "createdBy": null,
+   "updatedBy": null,
+   "taskId": null,
+   "unitID": 3236924440583424,
+   "unitName": "根部门",
+   "reporterUserID": 3236324065432832,
+   "reporterUserName": "DEVACC-rwzx",
+   "isSend": false,
+   "sendTime": null,
+   "indexNO": null
+   }
+   ]
+   }
+   响应示例:
+   {
+   "RequestId": "408653df-9a62-41d1-b215-8bfd6a97f6f9",
+   "Code": 200,
+   "Message": "",
+   "Data": {
+   "code": "200",
+   "msg": null
+   }
+   }
+   1.4 更新任务
+   接口路径: POST /api/lcplogics/updateTask
+   接口说明: 更新任务信息
+   请求参数:
+   {
+   "task": {
+   "id": 3237095302078720,
+   "createdTime": "2025-10-15T09:35:31.000Z",
+   "updatedTime": "2025-10-15T11:03:20.000Z",
+   "createdBy": "DEVACC-rwzx",
+   "updatedBy": "DEVACC-rwzx",
+   "creatorOrgId": null,
+   "creatorDeptId": null,
+   "mainTaskId": 0,
+   "parentInstanceId": null,
+   "taskName": "123123",
+   "deadline": "2025-10-15",
+   "status": "NOT\_DISTRIBUTED",
+   "description": "123123123123",
+   "formTemplateId": 2,
+   "formTemplateName": "项目立项申请表",
+   "unitId": null,
+   "reporterUserId": 0,
+   "reporterDeptId": null,
+   "finalContentJson": null,
+   "appId": null,
+   "fillInPeriod": "YEAR",
+   "fillInFrequency": "123",
+   "belongOrgId": "ORG002",
+   "belongOrgName": "项目管理部",
+   "categoryId": "BD002",
+   "categoryName": "项目管理",
+   "wfId": "AF002",
+   "wfName": "项目审批流程B",
+   "isNeedVerify": "false"
+   },
+   "fillPersonList": [
+   {
+   "id": 3237095302144256,
+   "createdTime": "2025-10-15T09:35:31.000Z",
+   "updatedTime": "2025-10-15T11:03:20.000Z",
+   "createdBy": "DEVACC-rwzx",
+   "updatedBy": "DEVACC-rwzx",
+   "taskId": 3237095302078720,
+   "unitID": 3236924440583424,
+   "unitName": "根部门",
+   "reporterUserID": 3237081504981248,
+   "reporterUserName": "用户1",
+   "isSend": false,
+   "sendTime": "2025-10-15T09:35:31.000Z",
+   "indexNO": 0
+   },
+   {
+   "id": 3237095369335040,
+   "createdTime": "2025-10-15T09:35:39.000Z",
+   "updatedTime": "2025-10-15T11:03:20.000Z",
+   "createdBy": "DEVACC-rwzx",
+   "updatedBy": "DEVACC-rwzx",
+   "taskId": 3237095302078720,
+   "unitID": 3236924762029312,
+   "unitName": "某部门2",
+   "reporterUserID": 3236324065432832,
+   "reporterUserName": "DEVACC-rwzx",
+   "isSend": false,
+   "sendTime": "2025-10-15T09:35:31.000Z",
+   "indexNO": 0
+   }
+   ]
+   }
+   响应示例:
+   {
+   "RequestId": "8a46b3eb-ee43-43a2-9be4-c00e8b2fbbbb",
+   "Code": 200,
+   "Message": "",
+   "Data": {
+   "code": "200",
+   "msg": null
+   }
+   }
+   1.5 取消任务
+   接口路径: POST /api/lcplogics/cancelTask
+   接口说明: 取消任务
+   请求参数:
+   {
+   "id":3237095369335040
+   }
+   响应示例:
+   {
+   "code": 200,
+   "message": "任务已取消"
+   }
+   1.6 获取填报人员信息接口
+   接口路径：POST /api/lcplogics/getFillInPersonListByTaskId
+   接口说明：返回所有填报人员的信息，包括未下发任务的人员信息
+   请求参数：
+   {
+   "id":3237095369335040
+   }
+   响应示例：
+   {
+   "RequestId": "8bb66273-0831-43e4-88f4-980b10dc41bc",
+   "Code": 200,
+   "Message": "",
+   "Data": [
+   {
+   "taskFillPerson": {
+   "id": 3237095302144256,
+   "createdTime": "2025-10-15T09:35:31.000Z",
+   "updatedTime": "2025-10-15T11:03:20.000Z",
+   "createdBy": "DEVACC-rwzx",
+   "updatedBy": "DEVACC-rwzx",
+   "taskId": 3237095302078720,
+   "unitID": 3236924440583424,
+   "unitName": "根部门",
+   "reporterUserID": 3237081504981248,
+   "reporterUserName": "用户1",
+   "isSend": false,
+   "sendTime": "2025-10-15T09:35:31.000Z",
+   "indexNO": 0
+   }
+   },
+   {
+   "taskFillPerson": {
+   "id": 3237095369335040,
+   "createdTime": "2025-10-15T09:35:39.000Z",
+   "updatedTime": "2025-10-15T11:03:20.000Z",
+   "createdBy": "DEVACC-rwzx",
+   "updatedBy": "DEVACC-rwzx",
+   "taskId": 3237095302078720,
+   "unitID": 3236924762029312,
+   "unitName": "某部门2",
+   "reporterUserID": 3236324065432832,
+   "reporterUserName": "DEVACC-rwzx",
+   "isSend": false,
+   "sendTime": "2025-10-15T09:35:31.000Z",
+   "indexNO": 0
+   }
+   }
+   ]
+
+}
+1.7 获取模板信息接口
+接口路径：POST /api/lcplogics/getFormTemplateList
+接口说明：获取创建任务用的模板信息数据，返回允许使用的模板信息列表
+响应示例：
+{
+"RequestId": "db7d2eff-d894-410d-b7e4-5fbc4f29ffb4",
+"Code": 200,
+"Message": "",
+"Data": [
+{
+"formTemplate": {
+"id": 1,
+"templateName": "月度绩效考核表",
+"belongOrgName": "人力资源部",
+"leaderName": "张三",
+"businessDomainName": "人事管理",
+"approvalFlowName": "绩效考核流程A",
+"createdTime": "2025-10-14T09:52:23.000Z",
+"updatedTime": "2025-10-14T09:52:23.000Z",
+"createdBy": "admin",
+"updatedBy": "admin",
+"status": null,
+"businessDomainID": "BD001",
+"approvalFlowID": "AF001",
+"isReusable": true,
+"isLockedForUse": false,
+"templateContent": "{"fields":[{"name":"employeeName","type":"text"},{"name":"score","type":"number"}]}",
+"belongOrgId": "ORG001",
+"leaderID": "USER001",
+"isGenerateReport": true,
+"currentActiveVersionNum": "v1.0"
+}
+},
+{
+"formTemplate": {
+"id": 2,
+"templateName": "项目立项申请表",
+"belongOrgName": "项目管理部",
+"leaderName": "李四",
+"businessDomainName": "项目管理",
+"approvalFlowName": "项目审批流程B",
+"createdTime": "2025-10-14T09:52:23.000Z",
+"updatedTime": "2025-10-14T09:52:23.000Z",
+"createdBy": "system",
+"updatedBy": "system",
+"status": null,
+"businessDomainID": "BD002",
+"approvalFlowID": "AF002",
+"isReusable": true,
+"isLockedForUse": true,
+"templateContent": "{"fields":[{"name":"projectName","type":"text"},{"name":"budget","type":"number"}]}",
+"belongOrgId": "ORG002",
+"leaderID": "USER002",
+"isGenerateReport": false,
+"currentActiveVersionNum": "v2.3"
+}
+},
+{
+"formTemplate": {
+"id": 3,
+"templateName": "费用报销单模板",
+"belongOrgName": "财务部",
+"leaderName": "王五",
+"businessDomainName": "财务核算",
+"approvalFlowName": "费用审批流程C",
+"createdTime": "2025-10-14T09:52:23.000Z",
+"updatedTime": "2025-10-14T09:52:23.000Z",
+"createdBy": "finance\_admin",
+"updatedBy": "finance\_admin",
+"status": null,
+"businessDomainID": "BD003",
+"approvalFlowID": "AF003",
+"isReusable": false,
+"isLockedForUse": false,
+"templateContent": "{"fields":[{"name":"expenseType","type":"select","options":["差旅","招待","办公"]},{"name":"amount","type":"number"}]}",
+"belongOrgId": "ORG003",
+"leaderID": "USER003",
+"isGenerateReport": true,
+"currentActiveVersionNum": "v1.2"
+}
+}
+]
+}
+1.8 获取单位信息接口
+接口路径：POST /api/lcplogics/getUnitInfoList
+接口说明：获取创建任务选择填报单位用的数据
+响应示例：
+{
+"RequestId": "dd67edd7-719d-4a11-ad17-98985f87ee0e",
+"Code": 200,
+"Message": "",
+"Data": [
+{
+"lCAPDepartment": {
+"id": 3236924440583424,
+"createdTime": "2025-10-15T03:47:54.000Z",
+"updatedTime": "2025-10-15T03:47:54.000Z",
+"createdBy": "DEVACC-rwzx",
+"updatedBy": "DEVACC-rwzx",
+"name": "根部门",
+"deptId": "根部门",
+"parentDeptId": null,
+"orgId": null
+}
+},
+{
+"lCAPDepartment": {
+"id": 3236924655828224,
+"createdTime": "2025-10-15T03:48:20.000Z",
+"updatedTime": "2025-10-15T03:48:20.000Z",
+"createdBy": "DEVACC-rwzx",
+"updatedBy": "DEVACC-rwzx",
+"name": "某部门1",
+"deptId": "ORG01",
+"parentDeptId": "根部门",
+"orgId": null
+}
+},
+{
+"lCAPDepartment": {
+"id": 3236924762029312,
+"createdTime": "2025-10-15T03:48:33.000Z",
+"updatedTime": "2025-10-15T03:48:33.000Z",
+"createdBy": "DEVACC-rwzx",
+"updatedBy": "DEVACC-rwzx",
+"name": "某部门2",
+"deptId": "ORG02",
+"parentDeptId": "根部门",
+"orgId": null
+}
+}
+]
+}
+1.9 获取填报人信息接口
+接口路径：POST /api/lcplogics/getUserInfoList
+接口说明：获取创建任务选择填报人用的数据
+响应示例：
+{
+"RequestId": "f0b63069-7f52-473b-b9ff-fe26a3741770",
+"Code": 200,
+"Message": "",
+"Data": [
+{
+"lCAPUser": {
+"id": 3236324065432832,
+"createdTime": "2025-10-14T07:26:26.000Z",
+"updatedTime": "2025-10-15T08:55:05.000Z",
+"userId": "ebf2cdd6a6b05a033f21ad4cf35a6d3a",
+"userName": "DEVACC-rwzx",
+"password": "$2a$10$LxGxXUXjXhCrLRC2LAyyLOrVOY7uldk6UvvAAX38gV.O0jCjxg.bS","phone": null,"email": null,"displayName": "DEVACC−rwzx","status": "Normal","source": "Normal","directLeaderId": null,"orgId": null\}\},\{"lCAPUser": \{"id": 3237081504981248,"createdTime": "2025−10−15T09:07:27.000Z","updatedTime": "2025−10−15T09:07:27.000Z","userId": "899f725a40aedadad53b0360d1ccadad","userName": "用户1","password": "$2a$10$1ucfaYxUvkeAnW1k9cstpuasOo/U.bkih/O2oyWHvwpLCrqGUbGby",
+"phone": null,
+"email": null,
+"displayName": null,
+"status": "Normal",
+"source": "Normal",
+"directLeaderId": null,
+"orgId": null
+}
+}
+]
+}
+2. 任务进度查询接口
+2.1 获取子任务的进度详情
+接口路径: POST /api/lcplogics/getSubTaskProgress
+接口说明: 获取子任务的进度详情
+请求参数:
+{
+"taskId": 123456
+}
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"mainTask": {
+"id": 3237095302078720,
+"createdTime": "2025-10-15T09:35:31.000Z",
+"updatedTime": "2025-10-15T11:03:20.000Z",
+"createdBy": "DEVACC-rwzx",
+"updatedBy": "DEVACC-rwzx",
+"creatorOrgId": null,
+"creatorDeptId": null,
+"mainTaskId": 0,
+"parentInstanceId": null,
+"taskName": "123123",
+"deadline": "2025-10-15",
+"status": "NOT\_DISTRIBUTED",
+"description": "123123123123",
+"formTemplateId": 2,
+"formTemplateName": "项目立项申请表",
+"unitId": null,
+"reporterUserId": 0,
+"reporterDeptId": null,
+"finalContentJson": null,
+"appId": null,
+"fillInPeriod": "YEAR",
+"fillInFrequency": "123",
+"belongOrgId": "ORG002",
+"belongOrgName": "项目管理部",
+"categoryId": "BD002",
+"categoryName": "项目管理",
+"wfId": "AF002",
+"wfName": "项目审批流程B",
+"isNeedVerify": "false"
+},
+"subTasks": {
+"total": 10,
+"list": [
+{
+"id": 3237095302078720,
+"createdTime": "2025-10-15T09:35:31.000Z",
+"updatedTime": "2025-10-15T11:03:20.000Z",
+"createdBy": "DEVACC-rwzx",
+"updatedBy": "DEVACC-rwzx",
+"creatorOrgId": null,
+"creatorDeptId": null,
+"mainTaskId": 0,
+"parentInstanceId": null,
+"taskName": "123123",
+"deadline": "2025-10-15",
+"status": "NOT\_DISTRIBUTED",
+"description": "123123123123",
+"formTemplateId": 2,
+"formTemplateName": "项目立项申请表",
+"unitId": null,
+"reporterUserId": 0,
+"reporterDeptId": null,
+"finalContentJson": null,
+"appId": null,
+"fillInPeriod": "YEAR",
+"fillInFrequency": "123",
+"belongOrgId": "ORG002",
+"belongOrgName": "项目管理部",
+"categoryId": "BD002",
+"categoryName": "项目管理",
+"wfId": "AF002",
+"wfName": "项目审批流程B",
+"isNeedVerify": "false"
+},
+{
+"id": 3237095302078720,
+"createdTime": "2025-10-15T09:35:31.000Z",
+"updatedTime": "2025-10-15T11:03:20.000Z",
+"createdBy": "DEVACC-rwzx",
+"updatedBy": "DEVACC-rwzx",
+"creatorOrgId": null,
+"creatorDeptId": null,
+"mainTaskId": 0,
+"parentInstanceId": null,
+"taskName": "123123",
+"deadline": "2025-10-15",
+"status": "NOT\_DISTRIBUTED",
+"description": "123123123123",
+"formTemplateId": 2,
+"formTemplateName": "项目立项申请表",
+"unitId": null,
+"reporterUserId": 0,
+"reporterDeptId": null,
+"finalContentJson": null,
+"appId": null,
+"fillInPeriod": "YEAR",
+"fillInFrequency": "123",
+"belongOrgId": "ORG002",
+"belongOrgName": "项目管理部",
+"categoryId": "BD002",
+"categoryName": "项目管理",
+"wfId": "AF002",
+"wfName": "项目审批流程B",
+"isNeedVerify": "false"
+}
+]
+}
+}
+}
+
+1. 任务分类查询接口
+   3.1 获取组织部门树
+   接口路径: POST /api/lcplogics/getOrgTree
+   接口说明: 获取组织部门树结构，按树结构返回主层与1级子层的组织信息
+   请求参数:
+   {
+   "orgId": 123456
+   }
+   响应示例:
+   {
+   "code": 200,
+   "message": "success",
+   "data": [
+   {
+   "orgId": "ORG001",
+   "orgName": "招商局集团",
+   "parentId": null,
+   "taskCount": 20,
+   "children": [
+   {
+   "orgId": "ORG001-01",
+   "orgName": "集团财务部",
+   "parentId": "ORG001",
+   "taskCount": 10,
+   "children": []
+   }
+   ]
+   }
+   ]
+   }
+   3.2 获取业务领域树
+   接口路径: POST /api/lcplogics/getCategoryTree
+   接口说明: 获取业务领域树结构
+   请求参数:
+   {
+   "categoryId": 123456
+   }
+   响应示例:
+   {
+   "code": 200,
+   "message": "success",
+   "data": [
+   {
+   "categoryId": 201,
+   "categoryName": "财务管理",
+   "parentId": null,
+   "taskCount": 20,
+   "children": [
+   {
+   "categoryId": 202,
+   "categoryName": "财务报表",
+   "parentId": 201,
+   "taskCount": 10,
+   "children": []
+   }
+   ]
+   }
+   ]
+   }
+   3.3 按分类查询任务列表
+   接口路径: POST /api/lcplogics/loadTaskProgressTableView
+   接口说明: 获取指定组织部门或业务领域节点下及其子节点的任务列表
+   请求参数:
+   响应示例:
+   {
+   "code": 200,
+   "message": "success",
+   "data": {
+   "total": 20,
+   "list": [
+   {
+   "taskId": "TASK001",
+   "taskName": "2024年Q4财务数据填报",
+   "deptName": "集团财务部",
+   "templateName": "季度财务报表",
+   "categoryName": "财务管理",
+   "createUserName": "张三",
+   "processName": "财务报表审批流程",
+   "deadline": "2025-10-20",
+   "createTime": "2025-10-01 09:00:00",
+   "completeTime": null
+   }
+   ]
+   }
+   }
+   七、数据库表结构设计
+2. 任务实例表
+   表名：TASK\_INSTANCE
+   描述：记录主任务与子任务的信息，包括填报人员，以及关联表单模板、审批流等的信息
+3. 任务实例填报人员表
+   表名：TASK\_FILL\_PERSON
+   描述：记录任务的填报人员信息，用作暂存数据以及记录任务是否已下发的状态记录。
+
+|  |  |  |
+| --- | --- | --- |
+| 一级菜单 (模块名称) | 二级菜单 | 三级菜单 |
+| 任务中心 | 我的任务 |  |
+|  |  | 查看进度 |
+|  | 任务分类 |  |
+|  |  | 查看详情 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 任务名称 | 文本输入 | 模糊匹配任务名称关键字。 |
+| 主属部门 | 下拉选择 | 筛选任务的主属部门。 |
+| 业务领域 | 下拉选择 | 筛选任务所属的业务领域。 |
+| 任务状态 | 下拉选择 | 筛选任务的当前状态(如:进行中、已完成等)。 |
+| 截止日期 | 日期范围选择 | 筛选任务的截止日期范围。 |
+| 创建时间 | 日期范围选择 | 筛选任务的创建时间范围。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 任务在当前列表中的序号。 |  |
+| 任务名称 | 任务的标题。 |  |
+| 表单模板 | 任务使用的表单模板名称。 |  |
+| 主属部门 | 任务所属的主属部门。 |  |
+| 业务领域 | 任务所属的业务领域。 |  |
+| 任务状态 | 任务的当前状态(如:进行中、已完成)。 |  |
+| 截止日期 | 任务的截止日期。 |  |
+| 创建时间 | 任务的创建时间。 |  |
+| 更新时间 | 任务的更新时间。 |  |
+| 完成时间 | 任务的完成时间。 |  |
+| 操作 | 针对该任务可执行的操作按钮集合。 |  |
+| 字段名称 | 控件类型 | 必填 |
+| --- | --- | --- |
+| 填报周期 | 下拉选择 | 否 |
+| 表单模板 | 下拉选择 | 是 |
+| 任务名称 | 文本输入 | 是 |
+| 主属部门 | 文本展示 | 否 |
+| 业务领域 | 文本展示 | 否 |
+| 审批流程 | 文本展示+复选框 | 否 |
+| 截止日期 | 日期选择 | 是 |
+| 是否汇总填报 | 单选框 | 是 |
+| 是否生成报告 | 单选框 | 是 |
+| 报告模板 | 文件上传框 | 否 |
+| 对接随行爱写作接口 | 文本展示 | 否 |
+| 任务描述 | 多行文本 | 否 |
+| 填报单位 | 组织选择器 | 是 |
+| 填报人 | 用户选择器 | 是 |
+| 字段名称 | 控件类型 | 必填 |
+| --- | --- | --- |
+| 填报周期 | 文本展示 | 否 |
+| 表单模板 | 文本展示 | 是 |
+| 任务名称 | 文本输入 | 是 |
+| 主属部门 | 文本展示 | 否 |
+| 业务领域 | 文本展示 | 否 |
+| 审批流程 | 文本展示 | 否 |
+| 截止日期 | 日期选择 | 是 |
+| 任务描述 | 多行文本 | 否 |
+| 填报单位 | 组织选择器 | 是 |
+| 填报人 | 用户选择器 | 是 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 填报单位 | 下拉选择 | 筛选子任务中的填报单位名称。 |
+| 填报负责人 | 文本输入 | 筛选子任务的填写负责人名称。 |
+| 任务下发时间 | 日期范围选择 | 筛选子任务创建时间所在的时间区间。 |
+| 任务状态 | 下拉选择 | 筛选任务的当前状态(如:进行中、已完成)。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 任务名称 | 创建任务时的任务名称。 |  |
+| 任务发起人 | 创建任务的创建人。 |  |
+| 任务截止时间 | 创建任务时指定的截止时间。 |  |
+| 整体进度 | 子任务中已完成的数量在子任务总量中的占比。 |  |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 当前列表序号。 |  |
+| 填报单位 | 子任务所属单位。 |  |
+| 填报人 | 子任务填报用户。 |  |
+| 填报人所属部门 | 填报人所属部门。 |  |
+| 任务更新时间 | 该子任务的更新时间。 |  |
+| 任务状态 | 未开始/填报中/审批中/已完成。 |  |
+| 当前进度 | 以"人数+状态"的方式展示,例如:3人已完成/共6人填报。 |  |
+| 操作 | 查看详情、查看分发情况等操作按钮。 |  |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 填报人 | 被分发的填报人。 |  |
+| 填报单位 | 被分发的填报单位。 |  |
+| 所属部门 | 填报人所属部门。 |  |
+| 任务状态 | 未开始/填报中/审批中/已完成。 |  |
+| 任务更新时间 | 该子任务的更新时间。 |  |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 任务名称 | 文本输入 | 筛选任务的名称。 |
+| 主属部门 | 下拉选择 | 筛选子任务的主属部门。 |
+| 任务发起人 | 文本输入 | 筛选任务的发起人。 |
+| 创建时间 | 日期范围选择 | 筛选任务的创建时间区间。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 任务在列表中的序号。 |  |
+| 任务名称 | 创建任务时的任务名称。 |  |
+| 主属部门 | 任务的主属部门名称。 |  |
+| 表单模板 | 任务关联的表单模板名称。 |  |
+| 业务领域 | 任务关联的业务领域名称。 |  |
+| 任务发起人 | 该任务的创建人名称。 |  |
+| 审批流程 | 任务关联的审批流程名。 |  |
+| 任务截止时间 | 任务创建时设置的截止时间。 |  |
+| 创建时间 | 任务的创建时间。 |  |
+| 完成时间 | 任务的完成时间。 |  |
+| 操作 | 查看详情操作按钮。 |  |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| taskName | String | 否 |
+| belongOrgId | String | 否 |
+| belongOrgName | String | 否 |
+| categoryId | String | 否 |
+| categoryName | String | 否 |
+| taskStatus | String | 否 |
+| deadlineStart | String | 否 |
+| deadlineEnd | String | 否 |
+| createTimeStart | String | 否 |
+| createTimeEnd | String | 否 |
+| page | Integer | 否 |
+| size | Integer | 否 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| taskName | String | 否 |
+| belongOrgId | String | 否 |
+| belongOrgName | String | 否 |
+| createUserName | String | 否 |
+| createTimeStart | String | 否 |
+| createTimeEnd | String | 否 |
+| categoryId | String | 否 |
+| categoryName | String | 否 |
+| page | Integer | 否 |
+| size | Integer | 否 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT |  |
+| approval\_time | DATETIME |  |
+| app\_id | VARCHAR | 100 |
+| belong\_org\_id | VARCHAR |  |
+| belong\_org\_name | VARCHAR |  |
+| category\_id | INT |  |
+| created\_time | DATETIME |  |
+| creator\_dept\_id | VARCHAR | 64 |
+| creator\_org\_id | VARCHAR | 64 |
+| creator\_user\_id | VARCHAR | 64 |
+| deadline | DATETIME |  |
+| description | TEXT |  |
+| final\_content\_json | JSON |  |
+| finish\_time | DATETIME |  |
+| fill\_in\_year | INT |  |
+| fill\_in\_frequency | VARCHAR |  |
+| fill\_in\_period | VARCHAR |  |
+| form\_template\_id | BIGINT |  |
+| form\_template\_name | VARCHAR |  |
+| template\_file | VARCHAR |  |
+| is\_need\_verify | BOOLEAN |  |
+| is\_need\_summray | BOOLEAN |  |
+| ai\_writing\_interface | VARCHAR |  |
+| is\_urged | BOOLEAN |  |
+| main\_task\_id | BIGINT |  |
+| parent\_instance\_id | BIGINT |  |
+| reporter\_dept\_id | VARCHAR | 64 |
+| reporter\_user\_id | VARCHAR | 64 |
+| status | VARCHAR | 50 |
+| task\_name | VARCHAR | 255 |
+| unit\_id | VARCHAR | 64 |
+| wf\_id | INT |  |
+| wf\_name | VARCHAR |  |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT |  |
+| index\_no | INT |  |
+| is\_send | BOOLEAN |  |
+| reporter\_user\_id | VARCHAR | 64 |
+| reporter\_user\_name | VARCHAR | 64 |
+| send\_time | DATETIME | 3 |
+| task\_id | BIGINT |  |
+| unit\_id | VARCHAR | 64 |
+| unit\_name | VARCHAR | 64 |
+
+**3. 我的填报模块**
+
+**功能框架**
+
+流程主线：待填报列表 → 填报/拆分下发 → 查看进度 → 提交审批 → 已完成详情。
+数据主线：表单模板驱动 → 指标/字段校验→ 审批流实例化 → 汇总入库与报告生成。
+关键能力：拆分下发、退回意见、审批流程、任务催办。
+整体业务流程
+任务下发与接收
+
+**功能点详细设计**
+
+4.1 待填报 — 任务填报
+功能说明
+任务填报 在“待填报”页面，填报人按表单模板进行字段填写与实时校验，可随时保存；同时支持基于当前内容或指标的智能总结、对已下发子任务的下级数据汇总、历史填报参考插入以及在内容完整后生成报告预览。操作过程中遵守必填、格式与范围等校验及字段权限限制。
+原型界面
+界面设计
+上方包含三个按钮：汇总下级数据、填报参考、生成报告。
+表单填报界面，支持自定义字段和指标选择组件。
+下发包含两个按钮，可保存和取消。
+界面流程
+数据权限
+仅当前任务的指派填报人及具备相应权限的上级/管理员可访问与编辑本任务填报数据；
+4.2 待填报 — 任务分发
+功能说明
+任务分发 当前任务可整体下发或按组件/字段维度拆解分发到下级，支持选择接收人、设置批量或逐个截止日期并进行二次确认；下发时严格校验接收人填报权限与截止日期不晚于主任务、对已审批或已完成节点的字段禁止再次拆分，并在再次拆分时提示影响范围。创建成功后返回结果统计并推送通知，失败则逐条标注原因便于修正。
+原型界面
+界面设计
+布局结构：
+上方为拆分策略选择（整体下发/拆解分发）。
+中间为拆分对象选择区（字段组件架构/人员列表或拆解分发的详情）。
+下方为下发和取消按钮。
+组件与交互：
+子任务预览表支持行内编辑。
+下发确认弹窗，二次确认。
+规则与异常：
+禁止对已审批或已完成节点的字段再拆分；对已拆分字段再次拆分需提示影响范围。
+权限校验：接收人必须具备“填报权限”。
+截止日期规则：截止日期可选；未设置则继承当前任务截止日期；若设置则必须不晚于当前任务截止日期；批量设置需统一校验，超出约束时阻止下发并在列表逐行提示原因。
+变更约束：下发后允许调整子任务截止日期，但仍需满足“不晚于父任务截止日期”，并在操作日志中记录变更历史。
+操作流程
+整体下发
+拆解分发
+数据权限
+仅任务发起人/填报人的用户可执行整体下发或拆解分发；接收人候选列表按组织与角色权限过滤，必须具备“填报权限”方可选中。
+时序图
+4.3 待填报 — 查看填报进度与核查
+功能说明
+查看进度与核查 发起人或具备权限的用户可在进度页面按组织、人员、状态、时间范围与拆分类型进行过滤查询，查看分页列表与统计、支持排序；对待填报或进展慢的子任务可执行任务催办，对已填报的子任务可进行核查并在不通过时填写退回意见。所有操作遵循权限与脱敏规则。
+原型界面
+界面设计
+布局结构：
+顶部过滤区（组织、人员、状态、时间范围、拆分类型）；支持保存筛选方案。
+主表区域显示子任务列表（分页、排序、导出），右侧或弹窗为核查详情面板。
+工具区：批量催办、批量核查、批量退回，操作留痕。
+交互细节：
+催办支持选择渠道与消息模板；显示推送结果与失败重试入口。
+退回需填写意见，支持引用规范意见模板（可维护）。
+可用性与异常：
+对大列表启用服务端分页与列宽拖拽；支持导出选中或全部结果。
+对“已填报但未核查超过X天”的记录自动标记并提示批量处理建议。
+操作流程
+查询条件项
+列表字段栏目
+数据权限
+查看进度与核查 列表与详情的行级数据按“任务所属组织范围 + 用户角色权限”进行过滤，发起人、管理员或已授权的核查人可见。
+催办逻辑
+触发场景：
+手动催办：在进度列表勾选子任务后触发，支持按渠道（站内/邮件/短信）与消息模板发送；支持选择原因标签（进度慢/逾期/需补充材料）。
+自动催办：按策略每日定时扫描，满足“距截止≤X天且状态为待填报/填报中/退回未修正”或“已逾期”的子任务自动加入催办队列。
+频率限制：
+单子任务单渠道24小时内至多一次；同一模板重复发送自动去重（按SubTaskId+Channel+TemplateId+Day）。
+夜间保护：22:00-08:00的邮件/短信延迟至工作时段发送；站内消息不受限。
+升级策略：
+连续3次未响应或逾期≥2天，自动抄送部门负责人与上级任务发起人；再次逾期升级到管理员并标记“高优”。
+消息内容：
+模板变量：{任务名称, 截止日期, 逾期天数, 子任务链接}；支持自定义附加说明。
+权限与审计：
+催办操作仅限任务发起人、管理员或拥有核查权限的用户；所有催办记录进入审计日志并可导出。
+时序图
+时序图（查看进度，不含核查）
+
+4.4 待填报 — 提交审批
+功能说明
+提交审批（含自定义流程） 在字段校验通过后可选择默认或自定义审批流程（会签/或签/条件/抄送/转办等）发起审批实例；若允许无流程直达，则直接完成填报。
+原型界面
+界面设计
+布局结构：
+左侧为版本快照列表（VersionNo、时间、提交人）；右侧为提交面板（汇总说明、流程选择）。
+支持对比不同版本快照差异（新增/修改/删除字段）。
+流程与交互：
+默认审批流程自动带出；未配置时可选择“自定义流程”，并提供节点库（会签/或签/条件/抄送/转办等）。
+提交前校验包含字段完整性、权限一致性与流程合法性（环路、空节点）。
+提交后展示审批进度条与节点意见列表（实时刷新/轮询）。
+异常与回退：
+审批启动失败提供原因与重试；允许撤回在首节点前。
+驳回后可引用历史版本重新提交；支持“按差异修正”快速定位问题字段。
+操作流程
+数据权限
+发起审批仅限当前任务的填报人或其授权代理，审批流程节点参与者必须在组织目录中具备可被审核的角色或显式授权。“强制审批/无流程直达”的开关由任务发起人或管理员控制，并记录完整的权限变更轨迹。
+4.5 已完成 — 查看已完成填报操作的任务详情
+功能说明
+已完成模块提供列表检索、筛选能力，进入详情页可查看填报快照与完整审批流程、节点时间线与意见汇总，并支持查看审批记录。
+原型界面
+界面设计
+布局结构：
+已完成列表（支持搜索、筛选、导出）；详情页包含“填报详情”和“审批流程”两个分栏。
+审批流程页展示流程图、节点时间线与意见汇总；支持导出审批记录。
+关联能力：
+支持跳转至报告生成预览；显示与报告的绑定关系。
+操作流程
+查询条件项
+列表字段栏目
+数据权限
+任务详情 已完成列表与详情的访问受行级权限限制（仅本部门或授权范围的记录可见）。从详情页跳转报告预览需具备报告访问权限，且报告中的引用数据同样遵循来源数据的权限边界。
+4.6 填报参考
+功能说明
+在任务填报页打开参考抽屉后，可按业务领域、时间范围、填报人/单位与关键字筛选参考源；支持复制插入到指定填报指标位置。
+原型界面
+界面设计
+入口：在“待填报 — 任务填报”页面点击“填报参考”按钮，右侧弹出参考抽屉。
+布局结构（参照图片）：
+顶部筛选区：业务领域、模板、时间范围、填报人/单位、关键字搜索。
+左侧列表区：参考源卡片列表（任务名称、版本号、提交时间、填报人/单位）。
+右侧详情区：表单快照预览，支持字段级高亮（与当前模板匹配的字段标绿色，不匹配标灰）。
+底部操作区：插入模式（整单/字段/选中）、冲突策略（覆盖/仅空填）、复制到剪贴板、关闭。
+交互与体验：
+支持在“历史版本/已完成/下级汇总”三类参考源间切换；可多选合并预览。
+显示“差异对比”视图：标注当前表单与参考内容的新增/修改/缺失项，支持只看差异。
+插入前展示预览确认弹窗；插入后以提示条反馈插入数量与冲突处理结果。
+规则与异常：
+权限：仅可查看本人历史版本和有查看权限的已完成记录；敏感字段按规则脱敏显示。
+模板约束：整单插入仅在模板一致时允许；字段插入按字段key映射，无法映射的项保持未选。
+留痕：插入行为记录到操作日志（来源、插入字段数、策略、时间）。
+操作流程
+数据权限
+参考源的加载与插入严格遵守来源数据权限：历史版本仅本人可见，已完成记录需具备查看授权，整单插入需模板一致且不突破字段权限边界。
+五、业务流程
+5.1 流程说明
+任务下发与接收：主/子任务进入“待填报”。
+填报与保存：按模板字段填报；可随时暂存。
+拆分与下发：按整体或拆解维度创建子任务，进行权限与截止日期校验。
+下级填报与上级核查：核查通过同步至上级；不通过需填写意见并退回，支持再次提交与催办。
+提交审批：默认或自定义流程；支持失败原因反馈与撤回（首节点前）。
+完成与报告：审批通过或允许“无需审批直达”即完成；可生成报告并归档。
+5.2 流程图
+六、数据库表结构设计
+6.1 任务实例表（task\_instance）
+6.2 任务填报单位人员表（task\_file\_person）
+七、接口设计
+为“我的填报”模块提供关键接口定义，覆盖待填报列表、获取表单、数据暂存、任务分发、进度查询、核查/退回、提交审批、催办与版本查询。统一响应结构：{ code: 200, message: "success", data: ... }；错误统一返回非 200 的 code 与 message。
+7.1 查询待填报列表
+接口路径：GET /api/my/tasks
+接口说明：查询当前用户的待填报/填报中/审批中/已完成任务，支持筛选分页与排序。
+请求参数：
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"total": 2,
+"list": [
+{
+"taskId": 9001,
+"title": "Q3 指标填报",
+"formTemplateId": 301,
+"orgId": 10,
+"creatorUserName": "张三",
+"assigneeUserName": "李四",
+"dispatchedAt": "2025-10-10 09:00:00",
+"deadline": "2025-10-20 18:00:00",
+"status": "TO\_FILL"
+}
+]
+}
+}
+7.2 获取填报表单
+接口路径：GET /api/tasks/{taskId}/form
+接口说明：返回指定任务的表单结构、字段校验与默认值，用于填报页面渲染。
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"formTemplateId": 301,
+"templateName": "季度指标填报表",
+"fields": [
+{ "key": "revenue", "label": "营业收入", "type": "NUMBER", "required": true },
+{ "key": "growth", "label": "同比增长", "type": "PERCENT", "required": false }
+],
+"rules": { "revenue": { "min": 0 }, "growth": { "range": [-1, 1] } }
+}
+}
+7.3 暂存/提交填报数据
+接口路径：POST /api/tasks/{taskId}/save
+接口说明：暂存或提交填报内容（不触发审批），生成版本并可继续编辑。
+请求体（JSON）：
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"versionNo": 5
+}
+}
+7.4 任务分发（拆分/下发子任务）
+接口路径：POST /api/tasks/{taskId}/dispatch
+接口说明：按“整体下发/拆解分发”策略创建子任务并通知接收人。
+请求体（JSON）：
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": { "createdCount": 3, "subTaskIds": [9101,9102,9103] }
+}
+7.5 查看填报进度
+接口路径：GET /api/tasks/{taskId}/progress
+接口说明：查询子任务进度与状态，支持过滤与分页。
+请求参数：status、assigneeUserName、pageNum、pageSize
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"total": 10,
+"list": [
+{
+"subTaskId": 9101,
+"assignee": "王五",
+"status": "FILLING"
+}
+]
+}
+}
+7.6 退回
+接口路径：POST /api/sub-tasks/{subTaskId}/check
+接口说明：对已提交子任务进行核查，支持通过或退回并填写意见。
+请求体（JSON）：
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"status": "CHECKED"
+}
+}
+7.8 已完成列表查询
+接口路径：GET /api/my/tasks/completed
+接口说明：查询当前用户已完成的任务，支持时间范围与关键字。
+请求参数：taskTitle、dateStart、dateEnd、pageNum、pageSize
+7.9 发送催办
+接口路径：POST /api/tasks/{taskId}/remind
+接口说明：对进展慢或逾期的子任务发送催办消息。
+请求体（JSON）：
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"pushed": 8,
+"failed": [
+9107
+]
+}
+}
+
+|  |  |  |
+| --- | --- | --- |
+| 一级菜单 | 二级菜单 | 三级菜单 |
+| 我的填报 | 待填报 |  |
+| 我的填报 | 已完成 |  |
+| 操作 | 入口 | 条件 |
+| --- | --- | --- |
+| 手动填写 | 表单控件 | 任务有效且字段可见 |
+| 保存 | 保存按钮 | 字段校验通过 |
+| 智能总结 | AI 按钮 | 表单有内容或指标可用 |
+| 汇总下级数据 | 按钮 | 下级是否填报 |
+| 填报参考 | 按钮 | 是否有历史填报数据 |
+| 生成报告 | 按钮 | 填报数据是否完整 |
+| 操作 | 入口 | 条件 |
+| --- | --- | --- |
+| 选择接收人 | 人员选择器 | 组织树可用 |
+| 设置截止与要求 | 配置面板 | 接收人有效 |
+| 确认下发 | 下发按钮 | 配置完整且截止校验通过 |
+| 取消 | 取消按钮 | — |
+| 操作 | 入口 | 条件 |
+| --- | --- | --- |
+| 选择拆分范围 | 拆分配置 | 已选模板组件 |
+| 选择接收人 | 人员选择器 | 组织树可用 |
+| 设置截止与要求 | 配置面板 | 子任务有效 |
+| 确认下发 | 下发按钮 | 配置完整且截止校验通过 |
+| 取消 | 取消按钮 | — |
+| 操作 | 入口 | 条件 |
+| --- | --- | --- |
+| 查询进度 | 查询按钮 | 选择任务/过滤条件 |
+| 催办提醒 | 催办按钮 | 状态为待填报/进展慢 |
+| 退回并填写意见 | 核查入口 | 不通过 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 任务名称 | 文本输入 | 模糊搜索任务名称 |
+| 填报状态 | 下拉选择 | 选择任务填报状态进行下拉筛选 |
+| 任务发起人 | 文本输入 | 模糊搜索任务发起人的工号/姓名 |
+| 截止日期 | 时间范围选择 | 根据任务的截止日期时间进行筛选(开始时间-结束时间) |
+| 任务下发时间 | 时间范围选择 | 根据任务的下发时间进行筛选(开始时间-结束时间) |
+| 字段 | 字段名称 | 描述 |
+| --- | --- | --- |
+| userName | 填报人 | 填报人名称 |
+| orgFullName | 填报人所属单位 | 填报人所属单位名称 |
+| createTime | 任务下发时间 | 当前任务的下发时间 |
+| status | 填报状态 | 当前任务的填报状态 |
+| 操作 | 入口 | 条件 |
+| --- | --- | --- |
+| 生成版本 | 提交按钮 | 字段校验通过 |
+| 启动审批 | 提交按钮 | 有默认/自定义流程 |
+| 无流程直达 | 提交按钮 | 未配置流程且允许 |
+| 操作 | 入口 | 条件 |
+| --- | --- | --- |
+| 查看填报详情 | 列表/详情 | 已完成记录 |
+| 查看审批进展 | 详情页 | 有审批实例 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 任务名称 | 文本输入 | 模糊搜索任务名称 |
+| 填报状态 | 下拉选择 | 选择任务填报状态进行下拉筛选 |
+| 任务发起人 | 文本输入 | 模糊搜索任务发起人的工号/姓名 |
+| 截止日期 | 时间范围选择 | 根据任务的截止日期时间进行筛选(开始时间-结束时间) |
+| 任务下发时间 | 时间范围选择 | 根据任务的下发时间进行筛选(开始时间-结束时间) |
+| 字段 | 字段名称 | 描述 |
+| --- | --- | --- |
+| taskId | 任务名称 | 已完成任务的名称 |
+| deadline | 任务截止日期 | 任务的截止日期 |
+| status | 任务状态 | 当前任务的状态 |
+| createBy | 任务发起人 | 当前任务的发起人 |
+| deporterDeptId | 主属部门 | 当前任务的主属部门 |
+| categoryId | 业务领域 | 当前任务的业务领域 |
+| createTime | 任务下发时间 | 当前任务的下发时间 |
+| approvalTime | 提交审批时间 | 当前任务的提交审批时间 |
+| finishTime | 完成时间 | 当前任务的完成时间 |
+| 操作 | 入口 | 条件 |
+| --- | --- | --- |
+| 打开参考 | “填报参考”按钮 | 当前任务有效 |
+| 筛选与搜索 | 顶部筛选区 | 无 |
+| 选择参考源 | 列表卡片 | 有数据 |
+| 设置冲突策略 | 底部操作区 | 有当前表单数据 |
+| 插入到当前表单 | 底部操作区 | 确认通过 |
+| 关闭参考 | 关闭按钮 | 无 |
+| 字段名 | 类型 | 约束 |
+| --- | --- | --- |
+| id | BIGINT | PK |
+| parent\_instance\_id | BIGINT | IDX |
+| task\_name | VARCHAR(200) | NOT NULL |
+| description | TEXT |  |
+| form\_template\_id | BIGINT | NOT NULL, IDX |
+| category\_id | BIGINT | IDX |
+| creator\_user\_id | BIGINT | NOT NULL, IDX |
+| is\_need\_verify | TINYINT(1) | DEFAULT 0 |
+| status | VARCHAR(50) | NOT NULL, IDX |
+| deadline | DATETIME |  |
+| create\_time | DATETIME |  |
+| update\_time | DATETIME | NOT NULL |
+| 字段名 | 类型 | 约束 |
+| --- | --- | --- |
+| id | BIGINT | PK |
+| task\_id | BIGINT | NOT NULL, IDX |
+| unit\_id | BIGINT | IDX |
+| unit\_name | VARCHAR(200) |  |
+| reporter\_user\_id | BIGINT | NOT NULL, IDX |
+| reporter\_user\_name | VARCHAR(100) |  |
+| is\_send | BOOLEAN |  |
+| send\_time | DATETIME |  |
+| deadline | DATETIME |  |
+| index\_no | INTEGER | IDX |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| taskTitle | String | 否 |
+| orgId | Integer | 否 |
+| businessDomainId | Long | 否 |
+| status | String | 否 |
+| dispatchedStart | String | 否 |
+| dispatchedEnd | String | 否 |
+| deadlineStart | String | 否 |
+| deadlineEnd | String | 否 |
+| pageNum | Integer | 否 |
+| pageSize | Integer | 否 |
+| sortBy | String | 否 |
+| sortOrder | String | 否 |
+| 字段 | 类型 | 必填 |
+| --- | --- | --- |
+| fieldsJson | JSON | 是 |
+| draft | Boolean | 否 |
+| comment | String | 否 |
+| 字段 | 类型 | 必填 |
+| --- | --- | --- |
+| splitType | String | 是 |
+| items | Array | 是 |
+| items[].componentKey | String | 条件 |
+| items[].reporterUserId | Long | 是 |
+| items[].departmentId | Long | 否 |
+| items[].deadline | String | 否 |
+| items[].requirement | String | 否 |
+| 字段 | 类型 | 必填 |
+| --- | --- | --- |
+| result | String | 是 |
+| comment | String | 条件 |
+| attachments | Array | 否 |
+| 字段 | 类型 | 必填 |
+| --- | --- | --- |
+| subTaskIds | Array | 是 |
+| channel | String | 是 |
+| templateId | Long | 否 |
+
+**4. 审批中心模块**
+
+**功能框架**
+
+审批中心
+
+**功能点详细设计**
+
+1. 待审批 - 审批填报任务 (含查看详情/提交/退回/委托)
+   功能说明
+   任务审批人在“待审批”页面可集中处理所有待其审批的填报任务。此页面提供任务列表、筛选和搜索功能，以便快速定位和处理任务。审批人可以查看任务详情、提交流程、退回或委托他人处理。
+   待审批列表页
+   页面说明
+   本页面主要用户为审批人员，页面展示所有待审批的任务。
+   原型界面
+   查询条件项
+
+列表字段栏目
+交互说明:
+排序: 默认按照提交审批时间进行排序，任务下发时间越近，则越靠前。
+界面操作
+查询：用户输入或选择查询条件后，点击“查询”按钮，下方列表刷新显示匹配的结果。
+重置：点击“重置”按钮，清空所有查询条件，并重新加载全部列表数据。
+审批: 在列表操作栏中点击【审批】按钮，系统弹出弹窗。审批人员查看填报负责人提交审批时填写的汇总说明，或者点击tab按钮切换到填报详情页面查看填报内容。如果没有问题，填写审批意见，点击【提交】按钮完成审批：如果有问题，填写审批意见，点击【退回】按钮回到填报负责人手中。
+审批详情弹窗
+功能说明
+任务审批人在审批页面可查看审批进度，包括填报人提交的汇总说明、已审批完成的节点、后续审批节点，以及整体填报详情。审批操作支持提交、退回、及其他各类审批操作，支持流程待办委托给他人处理。
+操作流程
+任务审批人在“待审批”列表选择任务，点击“审批”按钮。
+进入审批详情弹窗，显示“填报详情”页签，查看汇总说明和填报数据。
+切换到“审批”页签，查看审批进度。
+填写审批意见。
+选择审批操作：提交（通过）、退回（到指定节点或填报人）、委托等。
+确认操作，流程流转至下一节点。
+界面设计
+审批详情弹窗，包含填报详情、审批等页签
+填报详情页签：通过表单渲染组件动态生成，用于展示填报数据和汇总数据。
+审批页签：显示审批意见(Textarea)和审批进度（Visual Component）
+审批意见：可编辑，由审批人填写，提交后会在审批记录列表中显示。
+审批进度：供审批人查看审批流程，按顺序展示当前任务已完成节点、当前节点和后续节点，通过颜色区分节点状态。已完成节点显示节点名称、审批人、审批意见。当前节点显示节点名称和审批人。后续节点显示节点名称。
+原型界面
+填报详情
+审批
+界面字段
+汇总说明 (Read-only Textarea)
+填报数据 (Read-only Form)
+审批意见 (Textarea)
+审批流程数据（Visual Component）
+（具体字段待定）
+界面操作
+审批操作按钮组
+提交/通过 （Button）,
+退回 （Button）,
+更多 （Select Button）(包含抄送、转办等下拉选项)
+数据存储
+（待定）
+审批流实例表：记录流程状态、当前节点、审批人。
+审批意见表：存储审批意见、操作类型、时间。
+2. 已处理 - 查看已完成审批操作的任务详情
+功能说明
+任务审批人能查看自己处理完成的审批任务列表，可查看每条任务记录的审批流程进展和表单填报详情。
+操作流程
+任务审批人在“已处理”列表选择任务，点击“详情”。
+查看任务的最终状态、表单数据和完整的审批流程记录，包括自己的审批意见和历史记录。
+界面设计
+页面整体布局与“待审批”页面保持一致，主要由查询条件区和任务列表区组成。
+查询条件项
+列表字段栏目
+交互说明:
+排序: 默认按照提交审批时间进行排序，任务提交审批时间越近，则越靠前。
+界面操作
+查询：用户输入或选择查询条件后，点击“查询”按钮，下方列表刷新显示匹配的结果。
+重置：点击“重置”按钮，清空所有查询条件，并重新加载全部列表数据。
+查看详情：点击每条任务后的“查看详情”按钮，弹窗显示任务详情。详情页内容与审批时的页面相同，但所有内容均为只读状态，不可修改。
+数据存储
+读取已处理任务的表单数据和审批流记录。
+查看详情弹窗
+功能说明
+任务审批人在审批页面可查看审批进度，包括填报人提交的汇总说明、已审批完成的节点、后续审批节点，以及整体填报详情。审批相关操作支持撤回、抄送、补发、催办等。
+操作流程
+任务审批人在“已处理”列表选择任务，点击“查看详情”按钮。
+进入查看详情弹窗，显示“填报详情”页签，查看汇总说明和填报数据。
+切换到“审批流程”页签，查看审批流程。
+可选择审批相关操作：撤回（撤销本次提交审批操作）、抄送、补发、催办等。
+界面设计
+查看详情弹窗，包含填报详情、审批流程等页签
+填报详情页签：通过表单渲染组件动态生成，用于展示填报数据和汇总数据。
+审批流程页签：供审批人查看审批流程，按顺序展示当前任务已完成节点、当前节点和后续节点，通过颜色区分节点状态。已完成节点显示节点名称、审批人、审批意见。当前节点显示节点名称和审批人。后续节点显示节点名称。
+原型界面
+填报详情
+审批流程
+界面字段
+汇总说明 (Read-only Textarea)
+填报数据 (Read-only Form)
+审批流程数据 (Visual Component)
+（具体字段待定）
+界面操作
+审批操作按钮组
+抄送 （Button）,
+撤回 （Button）,
+更多 （Select Button）(包含补发、催办等下拉选项)
+3. 流程控制 - 实现复杂的审批流程控制能力
+功能说明
+平台应支持复杂的审批流程，包括会签、或签、条件节点、抄送、转办、催办、补发、退回、撤回、删除等。
+操作流程
+任务接收人选择预设的审批流程。
+配置流程节点类型（如会签、或签、条件分支）。
+配置节点操作权限（如转办、催办、补发）。
+流程引擎解析配置并执行流程流转。
+界面设计
+流程模板选择界面（Visual Flow Components），支持选择已有流程。
+创建流程界面，支持新增节点和配置属性。
+界面字段
+流程名称 (Input)
+节点类型 (Dropdown)
+条件表达式 (Input)
+界面操作
+流程设计、保存、发布
+数据存储
+流程模板表：存储流程定义（JSON/XML）。
+流程引擎配置数据：存储会签/或签规则、条件分支逻辑等。
+需与系统管理中的权限模块集成，支持流程节点的权限控制。
+
+|  |  |  |
+| --- | --- | --- |
+| 一级菜单 (模块名称) | 二级菜单 | 三级菜单 |
+| 审批中心 | 待审批 |  |
+|  | 已处理 |  |
+|  | 流程控制 |  |
+| 条件 | 说明 |  |
+| --- | --- |  |
+| 任务名称 | 支持模糊查询 |  |
+| 主属部门 | 下拉多选：（权限内全部部门） |  |
+| 业务领域 | 下拉多选：（权限内全部业务领域） |  |
+| 任务发起人 | 支持姓名/工号查询 |  |
+| 填报负责人 | 支持姓名/工号查询 |  |
+| 字段名 | 类型 | 长度 |
+| --- | --- | --- |
+| 任务名称 | varchar | 32 |
+| 主属部门 | varchar | 32 |
+| 业务领域 | varchar | 32 |
+| 任务发起人 | varchar | 16 |
+| 任务截止日期 | date |  |
+| 填报负责人 | varchar | 16 |
+| 提交审批时间 | datetime |  |
+| 条件 | 说明 |  |
+| --- | --- |  |
+| 任务名称 | 文本输入框，支持关键字模糊查询 |  |
+| 任务状态 | 下拉选择框，用于筛选不同状态的任务 |  |
+| 主属部门 | 下拉选择框，用于筛选不同部门的任务 |  |
+| 业务领域 | 下拉选择框，用于筛选不同业务领域的任务 |  |
+| 任务发起人 | 文本输入框，支持按人员姓名/工号模糊查询 |  |
+| 填报负责人 | 文本输入框，支持按人员姓名/工号模糊查询 |  |
+| 字段名 | 类型 | 长度 |
+| --- | --- | --- |
+| 序号 | int |  |
+| 任务名称 | varchar | 32 |
+| 主属部门 | varchar | 32 |
+| 业务领域 | varchar | 32 |
+| 任务发起人 | varchar | 16 |
+| 任务截止日期 | date |  |
+| 任务状态 | varchar | 16 |
+| 填报负责人 | varchar | 16 |
+| 提交审批时间 | datetime |  |
+| 完成时间 | datetime |  |
+
+**5. 指标查询模块**
+
+**功能框架**
+
+指标查询
+
+**功能点详细设计**
+
+1. 指标查询列表
+   功能说明
+   用户进入指标目录模块后,系统展示用户权限范围内的指标目录,可通过搜索框快速搜索指标名称、编码等关键字,查找目标指标。
+   原型界面
+   根据原型设计:指标列表、查询条件和指标详情展示区
+   查询/重置
+   查询 (Query): 根据用户输入的查询条件,筛选并展示符合条件的指标列表。
+   重置 (Reset): 清空所有查询条件项,并重新加载默认的指标列表。
+   导出列表: 导出当前查询结果的指标列表为 Excel 文件。
+   查询条件项
+   列表字段栏目
+   数据权限
+   用户仅能查看其权限范围内的指标信息。权限范围由用户所属组织、角色以及指标的公司维度配置共同决定。
+   列表的操作按钮
+2. 查看指标详情
+   功能说明
+   用户点击指标列表中的"查看指标详情"按钮后,系统弹出指标详情弹窗,展示该指标的完整信息,包括:
+   指标定义和统计口径: 指标的业务含义和计算方法
+   四维度属性信息: 业务属性、技术属性、管理属性、公司维度
+   原型界面
+   操作流程
+   用户在指标列表中点击某条指标的"查看指标详情"按钮。
+   系统查询该指标的详细信息和用户有权限访问的公司维度数据。
+   弹出指标详情弹窗,展示指标的四维度属性。
+   用户点击"关闭"按钮关闭弹窗。
+   界面设计
+   指标详情弹窗采用分Tab页展示,包含以下Tab页:
+   Tab 1: 指标概览
+   指标编码
+   指标名称
+   指标定义
+   统计口径
+   计算公式(如有)
+   更新频度
+   Tab 2: 业务属性
+   业务领域
+   主属部门
+   负责人
+   业务规则
+   适用范围
+   其他业务属性(存储在 business\_attr JSON 字段中)
+   Tab 3: 技术属性
+   数据类型
+   单位
+   精度
+   数据来源
+   取数规则
+   其他技术属性(存储在 technical\_attr JSON 字段中)
+   Tab 4: 管理属性
+   创建人
+   创建时间
+   更新人
+   更新时间
+   审批状态
+   版本号
+   其他管理属性
+   界面字段
+   指标概览字段
+   界面操作
+   切换Tab页: 查看指标的不同维度信息。
+   选择公司: 通过下拉框或树形选择器切换查看不同公司的指标数据。
+   关闭: 关闭指标详情弹窗。
+3. 指标搜索
+   功能说明
+   用户在页面顶部的搜索框中输入指标关键字,系统实时匹配指标名称、指标编码,以下拉列表形式展示匹配的指标,用户点击选中后,页面自动定位到该指标并展示其详细信息。
+   原型界面
+   操作流程
+   用户在搜索框输入关键字(支持中文名称、编码)。
+   系统实时查询 指标定义表,匹配 metric\_name、metric\_code 字段。
+   以下拉列表形式展示匹配的指标(最多显示10条)。
+   用户点击某条指标,系统在右侧指标列表中定位并高亮显示该指标。
+   界面设计
+   页面顶部设置搜索框,输入框占据合理宽度,右侧显示搜索图标。
+   输入时实时显示下拉匹配列表,每条显示:指标编码 + 指标名称。
+   支持键盘上下键选择,回车键确认。
+   界面字段
+   界面操作
+   输入关键字: 实时触发搜索。
+   点击搜索结果: 定位到指标详情。
+   清空搜索框: 清除搜索结果,恢复默认列表。
+   五、业务流程
+4. 指标查询整体流程
+5. 指标搜索流程
+6. 查看指标详情流程
+   六、接口设计
+7. 获取指标列表接口
+   接口路径: GET /api/metrics/list
+   请求参数:
+   响应数据:
+   {
+   "code": 200,
+   "message": "success",
+   "data": {
+   "total": 200,
+   "list": [
+   {
+   "metricCode": "M001",
+   "metricName": "指标1",
+   "metricDefinition": "财务应付明细",
+   "deptName": "集团财务部",
+   "categoryName": "财务应收应付",
+   "creatorName": "赵六",
+   "creatorNo": "1000020",
+   "createTime": "2025-06-14 14:45:48",
+   "updateTime": "2025-06-14 14:45:48"
+   }
+   ]
+   }
+   }
+8. 获取指标详情接口
+   接口路径: GET /api/metrics/detail/{metricCode}
+   请求参数:
+   响应数据:
+   {
+   "code": 200,
+   "message": "success",
+   "data": {
+   "metricCode": "M001",
+   "metricName": "指标1",
+   "frequency": "季度",
+   "analysisMethod": "同比分析",
+   "companyDim": "招商局集团",
+   "businessAttr": {
+   "definition": "财务应付明细指标定义",
+   "statisticMethod": "汇总统计",
+   "businessDomain": "财务管理",
+   "deptName": "集团财务部",
+   "owner": "张三"
+   },
+   "technicalAttr": {
+   "dataType": "数值型",
+   "unit": "万元",
+   "precision": "2",
+   "dataSource": "财务系统",
+   "fetchRule": "每季度汇总"
+   },
+   "managementAttr": {
+   "creator": "赵六",
+   "createTime": "2025-01-10 10:00:00",
+   "updater": "王五",
+   "updateTime": "2025-06-14 14:45:48",
+   "approvalStatus": "已审批",
+   "version": "1.2"
+   }
+   }
+   }
+   接口路径: GET /api/metrics/data/{metricCode}
+   请求参数:
+   响应数据:
+   {
+   "code": 200,
+   "message": "success",
+   "data": {
+   "metricCode": "M001",
+   "metricName": "指标1",
+   "dataList": [
+   {
+   "companyId": "C001",
+   "companyName": "招商局集团",
+   "dataPeriod": "2024-Q1",
+   "dataValue": "1,200,000",
+   "dataStatus": "已确认",
+   "submitTime": "2024-04-10 16:30:00"
+   },
+   {
+   "companyId": "C001",
+   "companyName": "招商局集团",
+   "dataPeriod": "2024-Q2",
+   "dataValue": "1,350,000",
+   "dataStatus": "已确认",
+   "submitTime": "2024-07-15 14:20:00"
+   }
+   ]
+   }
+   }
+9. 搜索指标接口
+   接口路径: GET /api/metrics/search
+   请求参数:
+   响应数据:
+   {
+   "code": 200,
+   "message": "success",
+   "data": [
+   {
+   "metricCode": "M001",
+   "metricName": "指标1",
+   "categoryName": "财务应收应付"
+   },
+   {
+   "metricCode": "M002",
+   "metricName": "指标2",
+   "categoryName": "财务应收应付"
+   }
+   ]
+   }
+10. 获取业务领域树接口
+    接口路径: GET /api/metrics/categories
+    请求参数: 无
+    响应数据:
+    {
+    "code": 200,
+    "message": "success",
+    "data": [
+    {
+    "categoryId": "C001",
+    "categoryName": "财务管理",
+    "parentId": null,
+    "metricCount": 50,
+    "children": [
+    {
+    "categoryId": "C001-01",
+    "categoryName": "财务应收应付",
+    "parentId": "C001",
+    "metricCount": 20,
+    "children": []
+    },
+    {
+    "categoryId": "C001-02",
+    "categoryName": "财务分析",
+    "parentId": "C001",
+    "metricCount": 30,
+    "children": []
+    }
+    ]
+    }
+    ]
+    }
+11. 导出指标列表接口
+    接口路径: POST /api/metrics/export
+    请求参数: 同"获取指标列表接口"的查询参数
+    响应数据: Excel 文件流(Content-Type: application/vnd.ms-excel)
+    七、数据库设计
+12. 核心数据表
+    指标查询模块依赖以下数据表(详细设计见《数据库设计文档.md》):
+    指标定义表(metric\_index)
+    存储指标的基本信息和属性数据。
+    指标定义所属公司表（metric\_define\_company）
+    指标属性关联表(metric\_attr\_link)
+    存储指标的扩展属性记录。
+
+|  |  |  |
+| --- | --- | --- |
+| 一级菜单 (模块名称) | 二级菜单 | 三级菜单 |
+| 指标目录 |  |  |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 指标名称 | 文本输入 | 模糊匹配指标名称关键字。 |
+| 主属部门 | 下拉选择 | 筛选指标所属的主属部门。 |
+| 业务领域 | 下拉选择 | 筛选指标所属的业务领域。 |
+| 创建时间 | 日期范围 | 筛选指标的创建时间范围(开始时间-结束时间)。 |
+| 更新时间 | 日期范围 | 筛选指标的更新时间范围(开始时间-结束时间)。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 指标在当前列表中的序号。 |  |
+| 指标名称 | 指标的名称。 |  |
+| 指标定义 | 指标的定义说明和计算口径。 |  |
+| 主属部门 | 指标所属的主属部门。 |  |
+| 业务领域 | 指标所属的业务领域分类。 |  |
+| 创建人 | 指标的创建人姓名。 |  |
+| 发起人工号 | 创建人的工号。 |  |
+| 创建时间 | 指标的创建时间。 |  |
+| 更新时间 | 指标的最后更新时间。 |  |
+| 操作 | 针对该指标可执行的操作按钮集合。 |  |
+| 操作按钮 | 说明 |  |
+| --- | --- |  |
+| 查看指标详情 | 点击后弹出指标详情弹窗,展示指标的四维度属性。 |  |
+| 字段名称 | 控件类型 | 数据来源 |
+| --- | --- | --- |
+| 指标编码 | 文本展示 | 指标定义表.metric\_code |
+| 指标名称 | 文本展示 | 指标定义表.metric\_name |
+| 指标定义 | 文本展示 | 指标定义表.business\_attr |
+| 统计口径 | 文本展示 | 指标定义表.business\_attr |
+| 更新频度 | 文本展示 | 指标定义表.data\_cycle |
+| 分析方法 | 文本展示 | 指标定义表.analysis\_method |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 搜索关键字 | 文本输入 | 输入指标名称或编码关键字。 |
+| 搜索结果 | 下拉列表 | 展示匹配的指标列表。 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| metricName | String | 否 |
+| deptId | String | 否 |
+| categoryId | String | 否 |
+| createTimeStart | String | 否 |
+| createTimeEnd | String | 否 |
+| updateTimeStart | String | 否 |
+| updateTimeEnd | String | 否 |
+| pageNum | Integer | 否 |
+| pageSize | Integer | 否 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| metricCode | String | 是 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| metricCode | String | 是 |
+| companyId | String | 否 |
+| startDate | String | 否 |
+| endDate | String | 否 |
+| cycle | String | 否 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| keyword | String | 是 |
+| limit | Integer | 否 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 20 |
+| define\_name | VARCHAR | 255 |
+| metric\_code | VARCHAR | 100 |
+| metric\_name | VARCHAR | 255 |
+| widget\_name | VARCHAR | 255 |
+| data\_type | VARCHAR | 255 |
+| metric\_unit | VARCHAR | 255 |
+| scope\_limit | VARCHAR | 255 |
+| format | VARCHAR | 255 |
+| is\_general | VARCHAR | 1 |
+| data\_cycle | VARCHAR | 255 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| created\_by | VARCHAR | 255 |
+| updated\_by | VARCHAR | 255 |
+| initiator | VARCHAR | 255 |
+| dept\_id | VARCHAR | 255 |
+| category\_id | VARCHAR | 255 |
+| business\_attr | JSON | — |
+| technical\_attr | JSON | — |
+| management\_attr | JSON | — |
+| subject\_domain | VARCHAR | 64 |
+| level1\_category | VARCHAR | 64 |
+| level2\_category | VARCHAR | 64 |
+| level3\_category | VARCHAR | 64 |
+| company\_dim | VARCHAR | 64 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 20 |
+| metric\_define\_id | BIGINT | 20 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| created\_by | VARCHAR | 255 |
+| updated\_by | VARCHAR | 255 |
+| company\_code | VARCHAR | 64 |
+| company\_name | VARCHAR | 255 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| link\_id | char | 36 |
+| metric\_code | varchar | 100 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| created\_by | VARCHAR | 255 |
+| updated\_by | VARCHAR | 255 |
+| attribute\_type | varchar | 50 |
+| attribute\_value | varchar | 500 |
+
+**6. 表单管理模块**
+
+**功能框架**
+
+表单管理
+
+**功能点详细设计**
+
+1. 表单模板列表
+   功能说明
+   提供表单模板的集中展示和管理界面。用户可以通过多条件组合查询快速定位表单,并对表单进行属性维护、详情查看、启用/停用等操作。列表支持分页显示、多字段排序和按权限过滤数据。
+   原型界面
+   根据原型设计,页面采用查询条件+列表布局:
+   顶部:查询条件区(表单名称、主属部门、业务领域、负责人、更新时间)
+   中部:表单列表表格
+   列表操作:预览表单、发布、更多（含维护属性、维护表单、删除表单、复制表单）按钮、停用/启用状态按钮
+   界面设计
+   顶部为查询区域,包含多个查询条件输入框和"查询"、"重置"按钮。
+   中部为列表展示区域,支持分页和多列展示。
+   列表支持固定列头,横向滚动查看更多字段。
+   操作流程
+   用户进入"表单管理"->"表单模板"菜单。
+   系统展示表单模板列表(默认显示用户权限范围内的所有表单)。
+   用户在查询条件区域输入或选择条件,点击"查询"按钮筛选列表。
+   点击"重置"按钮清空所有查询条件,恢复默认列表。
+   在列表中,用户可以对表单进行"预览表单"、"发布"、"更多操作"（含"维护属性"、"维护表单"、"删除表单"、"复制表单"）、"停用/启用状态"等操作。
+   查询条件项
+   列表字段栏目
+   数据权限
+   列表数据根据模板属性中配置的可见范围(currentUserVisibleRange)，判断当前用户的组织权限、配置的数据权限进行过滤展示。操作列按钮(如"维护属性")的可见性也需根据用户权限进行控制。
+   列表的操作按钮
+   界面操作
+   查询和筛选操作
+   关键字搜索：支持按表单名称进行模糊查询
+   分类筛选：按表单分类进行筛选
+   状态筛选：按启用/停用状态进行筛选
+   部门筛选：按主属部门进行筛选
+   高级筛选：支持多条件组合筛选
+   分页操作：支持分页浏览，可设置每页显示数量
+   单项操作
+   预览表单：点击预览按钮，在新窗口或弹窗中以只读模式查看表单模板
+   发布表单：点击发布按钮，将表单当前版本发布为正式版本
+   维护属性：点击维护属性按钮，跳转到表单属性维护界面
+   维护表单：点击维护表单按钮，跳转到表单设计器进行编辑
+   删除表单：点击删除按钮，弹出确认对话框后执行删除操作
+   复制表单：点击复制按钮，创建表单副本并跳转到编辑界面
+   状态切换：点击启用/停用按钮，切换表单的可用状态
+   交互反馈
+   操作确认：删除、停用等敏感操作需要用户确认
+   操作结果提示：操作成功或失败后显示相应的提示信息
+   加载状态：数据加载时显示加载动画
+   数据存储
+   关联数据库表:form\_template(表单模板表)、form\_category(表单分类表)、form\_template\_visible\_person(表单模板可见人员表)
+2. 表单设计工具(低代码拖拽设计器)
+   功能说明
+   表单设计工具支持业务人员通过拖拽方式快速设计表单,包含自定义字段和指标选择组件。指标从主数据同步,支持引入指标库中的指标(可多选),自动带出指标编码、名称、定义、组织维度、频度、指标时间、分析方法等属性。设计器提供丰富的组件库,支持表单结构的可视化编排。
+   功能清单
+   原型界面
+   根据原型设计,设计器采用三栏布局:
+   左侧:组件库面板(基础组件、指标组件、布局组件)
+   中间:设计画布区域
+   右侧:属性配置面板(组件属性、表单属性)
+   操作流程
+   负责人或运营人员进入"表单模板",点击"新建表单"按钮。
+   进入低代码表单设计器界面。
+   通过拖拽方式从左侧组件库添加自定义字段或指标选择组件到画布。
+   使用指标选择组件时,可搜索和选择指标库中的指标,系统自动填充指标属性。
+   在右侧属性面板配置组件的详细属性(必填、校验规则、默认值等)。
+   配置表单整体属性(表单名称、表单描述、版本号等)。
+   完成设计后,点击"保存"按钮保存表单模板(初始状态为"停用")。
+   界面设计
+   低代码表单设计器界面,采用三栏布局。
+   左侧组件库支持分类展示和搜索。
+   画布区域支持拖拽、复制、删除、排序操作。
+   右侧属性面板根据选中组件动态展示配置项。
+   组件库分类
+   基础组件:
+   单行文本
+   多行文本
+   数字输入
+   日期选择
+   下拉选择
+   单选按钮
+   复选框
+   文件上传
+   富文本编辑器
+   指标组件:
+   指标选择器
+   布局组件:
+   表格布局
+   分栏布局
+   标签页
+   折叠面板
+   界面字段
+   表单基本属性配置:
+   表单组件库
+   字段属性说明
+3. 单行输入组件
+4. 多行输入组件
+5. 数字输入组件
+6. 下拉单选组件
+7. 单选按钮组件
+8. 联级选择组件
+9. 多选框组件
+10. 多选输入组件
+11. 开关组件
+12. 日期时间组件
+13. 文字组件
+14. 文件上传组件
+15. 指标库组件
+    组件通用配置
+    基础配置
+    所有组件都包含以下基础配置项：
+    验证配置
+    界面操作
+    拖拽组件到画布
+    选中组件(高亮显示)
+    配置组件属性
+    复制/删除组件
+    调整组件顺序
+    保存表单模板
+    数据存储
+    关联数据库表:
+    FORM\_TEMPLATE: 存储表单模板的基本信息和JSON结构定义。
+    FORM\_COMPONENT: 存储表单组件的详细配置。
+    METRIC\_INDEX: 指标库,用于指标选择器组件。
+    表单模板JSON结构定义
+    {
+    "templateJson": {
+    "struct": {
+    "inputNumber68475": {
+    "comment": "数字输入",
+    "type": "Long"
+    },
+    },
+    "pageComponentList": [
+    {
+    "uid": 8650629447,
+    "tag": "cw-antd-input",
+    "idx": 1,
+    "label": "文本框",
+    "children": [],
+    "belong": "form",
+    "title": "单行输入",
+    "selfProps": {
+    "placeholder": "请输入"
+    },
+    "placeholder": "请输入",
+    "type": "String",
+    "span": 1,
+    "name": "input29432",
+    "dependency": [],
+    "rules": []
+    }],
+    "formSetting":{
+    "serial": "true",
+    "labelWidth": 100,
+    "customStyle ": "",
+    "layout": "vertical",
+    "span": 3
+    }
+    },
+    "TemplateID":"0001",
+    "TemplateName":"测试表单",
+    "Status":"Enabled",
+    "BusinessDomainID":"001",
+    "BusinessDomainName":"测试业务领域",
+    "versionId":"1"
+    }
+    templateJson定义说明
+    struct：表单结构，包含字段名、控件类型和数据类型
+    pageComponentList：页面组件列表，包含所有表单组件的详细配置
+    formSetting：表单设置，包含表单的布局、标签宽度、自定义样式等
+    高码扩展组件
+    指标选择器 (Metric Selector)
+    指标选择器是为满足填报业务中与集团指标库深度集成的需求而开发的高代码组件。它允许表单设计者将指标库中的标准指标快速引入表单，实现数据同源和口径一致。
+    配置步骤与业务流程：
+    拖拽组件：在表单设计器左侧的组件库中，找到“指标选择”组件，并将其拖拽至中间的画布区域。
+    属性配置：选中画布上的指标选择器组件，右侧的属性配置面板将显示其相关属性。点击“选择指标”按钮。
+    指标库弹窗：系统将弹出一个指标库搜索与选择的模态窗口。在此窗口中，设计者可以：
+    关键词搜索：通过输入指标的名称、编码或相关业务词汇，快速检索目标指标。
+16. 维护表单属性
+    功能说明
+    表单设计完成后,默认状态为停用。负责人需通过此功能维护表单的核心业务属性,确保表单能够正确地分配给相应的组织和人员进行填报。
+    核心属性配置包括:
+    基本信息: 主属部门(表单归属部门)、负责人(表单管理员)、业务领域(表单所属业务分类)
+    报告配置: 是否生成报告(控制表单数据是否用于报告生成)
+    填报配置: 默认填报单位和对应的填报人员
+    业务规则:
+    表单属性维护是表单启用的前置条件,未完成属性配置的表单无法启用
+    填报单位和填报人可以配置多组,每组对应一个填报单位及其指定的填报人员
+    只有完成所有必填属性的配置后,表单模板才能被启用并用于创建填报任务。
+    原型界面
+    根据原型设计,属性维护界面采用弹窗表单布局,包含以下功能区域:
+    界面布局结构:
+    基本属性区: 主属部门、负责人、业务领域的配置
+    报告配置区: 是否生成报告的选择、模板上传以及对接爱写作API信息填写
+    填报配置区: 填报单位和填报人的多组配置管理
+    界面设计
+    属性维护界面采用分区表单布局。
+    填报配置区支持动态添加/删除多组配置。
+    必填项用红色星号标识。
+    操作流程
+    主流程:
+    负责人在表单模板列表中,选择目标表单,点击"维护属性"按钮。
+    系统以弹窗形式展示表单属性维护界面,加载现有属性数据。
+    用户按区域填写或选择业务属性:
+    基本属性配置: 主属部门(下拉选择)、负责人(用户选择器)、业务领域(树形选择)
+    报告配置: 是否生成报告(单选按钮:是/否)、模板上传以及对接爱写作API信息填写
+    填报配置: 填报单位及对应填报人的多组配置
+    在填报配置区,用户可以:
+    点击"添加填报配置"按钮新增填报单位/填报人组合
+    点击每行的"删除"按钮移除不需要的配置组合
+    修改已有配置的填报单位或填报人
+    系统验证数据完整性和业务规则,保存成功后关闭弹窗。
+    属性维护完成后,负责人可在列表页对表单进行"启用"操作。
+    界面字段
+    界面操作
+    属性字段填写和选择
+    添加填报配置(新增一组填报单位/填报人)
+    删除填报配置(删除某组填报单位/填报人)
+    提交保存
+    取消操作
+    数据存储
+    关联数据库表:form\_template(表单模板表)、form\_category(表单分类表)、form\_template\_visible\_person(表单模板可见人员表)、form\_template\_fill\_person(表单模板填报单位人员子表)
+17. 查看表单详情
+    功能说明
+    负责人能通过弹窗查看表单模板的详细配置信息。该界面采用Tab页形式,包括"表单详情"和"审批流程"两个标签页,其中"表单详情"通过表单解析器渲染表单结构示例,以便用户直观了解表单内容和布局。
+    原型界面
+    根据原型设计,详情弹窗采用Tab页布局:
+    Tab1:表单详情 - 通过表单渲染引擎展示表单结构示例
+    Tab2:审批流程 - 展示配置的审批流程图(如有配置)
+    操作流程
+    负责人在表单模板列表中点击某条表单的"查看详情"按钮。
+    系统弹出表单详情弹窗,默认展示"表单详情"Tab页。
+    系统通过表单解析器渲染表单内容,展示表单的完整结构和字段配置。
+    用户可切换至"审批流程"Tab页,查看该表单配置的审批流程图(如有)。
+    用户点击"关闭"按钮或遮罩层关闭详情弹窗。
+    界面设计
+    详情弹窗居中显示,宽度适中。
+    Tab页切换按钮位于弹窗顶部。
+    "表单详情"Tab页:使用表单渲染引擎展示表单结构示例,样式与实际填报页面一致。
+    "审批流程"Tab页:以流程图形式展示审批节点和流转路径。
+    界面字段
+    表单详情Tab:
+    表单结构(由表单渲染引擎动态生成,展示所有组件)
+    表单基本信息:表单名称、表单编码、版本号、创建时间、更新时间
+    审批流程Tab:
+    流程图(节点名称、节点类型、流转条件)
+    流程基本信息:流程名称、流程版本、审批模式
+    界面操作
+    Tab页切换
+    表单预览滚动查看
+    关闭详情弹窗
+    数据存储
+    关联数据库表:
+    FORM\_TEMPLATE: 读取表单模板的基本信息和JSON结构定义。
+    WF\_PROCESS\_DEF: 读取关联的审批流程定义。
+18. 表单启用/停用
+    功能说明
+    管理员可以对表单模板进行启用或停用操作。只有"已启用"状态的表单才能被用于创建填报任务。停用的表单不影响已创建的任务,但无法用于新任务的创建。如果表单正在被进行中的任务使用,系统会将其锁定,防止关键定义被修改。
+    界面设计
+    列表状态栏显示开关按钮。
+    点击开关按钮时弹出确认提示框。
+    如果表单被锁定,系统将禁止停用操作。
+    操作流程
+    管理员在表单模板列表中找到目标表单。
+    点击表单状态栏的"启用/停用"开关按钮。
+    系统弹出确认提示(如:停用表单后,将无法用于新任务创建,是否确认?)。
+    用户确认后,系统更新表单状态。
+    列表实时刷新,显示更新后的状态。
+    界面操作
+    点击状态开关
+    确认提示
+    状态更新
+    数据存储
+    关联数据库表:form\_template(表单模板主表)
+19. 表单分类管理
+    功能说明
+    该功能为应用管理员提供了一个集成的界面,用于维护树状的业务领域结构,并通过该结构对表单模板进行分类管理和快速查询。左侧的业务领域树与右侧的表单模板列表形成联动,实现了高效的分类导航和数据筛选。
+    原型界面
+    根据原型设计,页面采用左右分栏布局:
+    左侧:业务领域树形展示和操作
+    右侧:表单模板列表,根据左侧树节点筛选
+    界面设计
+    布局: 左右布局,左侧为业务领域树,右侧为表单模板列表,推荐比例为 3:7。
+    联动: 左侧树节点的点击事件触发右侧列表的刷新,实现"树-表"联动查询。
+    反馈:
+    所有增、删、改、移操作均需提供明确的 成功 或 失败 消息提示(如 Toast 或 Notification)。
+    删除操作前需有二次确认弹窗。
+    加载数据或执行耗时操作时,显示加载中状态(Loading)。
+    操作流程
+    加载与展示:
+    应用管理员进入"表单分类"菜单。
+    系统默认加载完整的业务领域树,并展示在左侧区域。
+    右侧列表默认显示所有业务领域的表单模板。
+    树节点操作:
+    查询: 点击任意业务领域节点,右侧列表异步刷新,显示该领域及其所有子领域下的表单模板。
+    新增: 点击节点旁的"新增"图标,弹出对话框,输入新节点名称后,在当前节点下创建子节点。
+    编辑: 点击"编辑"图标,可直接在节点上修改名称或弹出对话框进行修改。
+    删除: 点击"删除"图标,系统提示提醒用户该树节点以及所有下层节点都会被删除，用户确定后删除成功。
+    移动: 点击"上移"或"下移"图标,调整节点在同级中的顺序。
+    用户需要具备相对应的权限，才可以进行对应操作。
+    列表查询:
+    右侧列表根据左侧树节点的选择结果进行动态数据过滤。
+    提供独立的关键词搜索框,用于在当前列表结果中进一步搜索。
+    界面字段
+    左侧 - 业务领域树:
+    右侧 - 表单模板列表:
+    界面操作
+    树节点展开/收起
+    点击树节点查看对应表单列表
+    新增子节点
+    编辑节点名称
+    删除节点(带确认提示)
+    上移/下移节点
+    列表查询和搜索
+    数据存储
+    关联数据库表:form\_template(表单模板主表)、form\_category(表单分类表)
+    档案规则维护
+    业务背景
+    为支持表单分类的树形结构查询，特别是"查询指定节点及其所有子节点下的表单模板"这类复杂查询场景，系统采用级次编码机制实现高效的层级查询。通过预设的级次编码规则，可以避免递归查询，显著提升查询性能。
+    级次编码规则设计
+20. 编码结构定义
+    级次（Level）：表示节点在树形结构中的层级深度，根节点为第1级
+    级次编码（Level Code）：采用固定长度的数字编码，每4位表示一个层级
+21. 编码模式示例
+    根节点： 级次=1，级次编码=0001
+    一级子节点： 级次=2，级次编码=00010001
+    二级子节点： 级次=3，级次编码=000100010001
+22. 编码生成算法
+    (1) 级次计算
+    新节点级次 = 父节点级次 + 1
+    (2) 级次编码生成
+    步骤1：获取父节点的级次编码作为前缀
+    步骤2：查询同级所有子节点，获取最大级次编码
+    步骤3：提取最大编码的最后4位，转换为数字并加1
+    步骤4：将结果转换为4位数字字符串（左补零）
+    步骤5：拼接父节点编码前缀和新生成的4位编码
+23. 算法实现示例
+    假设父节点编码为"0001"，已有子节点编码为"00010001"、"00010002"
+    新子节点编码生成过程：
+24. 父节点前缀：0001
+25. 同级最大编码：00010002
+26. 提取最后4位：0002 → 数字2
+27. 加1后转换：3 → "0003"
+28. 最终编码：0001 + 0003 = "00010003"
+    技术实现要点
+29. 数据库设计
+    在表单分类表中增加level（级次）和level\_code（级次编码）字段
+    建立级次编码的数据库索引，优化查询性能
+30. 查询优化
+    子树查询：WHERE level\_code LIKE '父节点编码%'
+    层级限制：WHERE level\_code LIKE '父节点编码%' AND level = 指定层级
+    五、业务流程
+31. 表单模板完整生命周期流程
+    表单管理模块的核心业务流程围绕表单模板的完整生命周期展开，采用"先配置属性，再设计表单，最后发布版本"的流程，确保表单的完整性和可用性。
+32. 新建表单属性配置流程
+33. 表单设计器操作流程
+34. 表单发布流程
+35. 表单属性修改流程（已发布表单）
+36. 查看表单详情（预览）流程
+37. 表单启用/停用流程
+38. 表单分类管理流程
+    六、接口设计
+39. 表单模板管理接口
+    1.1 获取表单模板列表
+    接口路径: GET /api/forms/templates
+    接口说明: 获取表单模板列表,支持多条件查询和分页
+    请求参数:
+    响应示例:
+    {
+    "code": 200,
+    "message": "success",
+    "data": {
+    "total": 50,
+    "list": [
+    {
+    "templateId": 1001,
+    "templateName": "季度财务报表",
+    "belongOrgName": "集团财务部",
+    "leaderName": "张三",
+    "businessDomainName": "财务管理",
+    "approvalFlowName": "财务报表审批流程",
+    "status": "ENABLED",
+    "isLockedForUse": false,
+    "updateTime": "2025-10-10 15:30:00",
+    "currentActiveVersionNo": "1.2"
+    }
+    ]
+    }
+    }
+    1.2 获取表单模板详情
+    接口路径: GET /api/forms/templates/{templateId}
+    接口说明: 获取表单模板的完整信息,包括表单结构和组件配置
+    请求参数: 无
+    响应示例:
+    {
+    "code": 200,
+    "message": "success",
+    "data": {
+    "templateId": 1001,
+    "templateName": "季度财务报表",
+    "templateContent": {
+    "version": "1.0",
+    "description": "用于季度财务数据填报"
+    },
+    "belongOrgId": 101,
+    "belongOrgName": "集团财务部",
+    "leaderId": 10001,
+    "leaderName": "张三",
+    "businessDomainId": 201,
+    "businessDomainName": "财务管理",
+    "approvalFlowId": 301,
+    "approvalFlowName": "财务报表审批流程",
+    "isGenerateReport": true,
+    "status": "ENABLED",
+    "isLockedForUse": false,
+    "components": [
+    {
+    "componentId": 5001,
+    "componentName": "报告期",
+    "dataType": "TEXT",
+    "isRequired": true,
+    "metricCode": null,
+    "indexNO": 1
+    },
+    {
+    "componentId": 5002,
+    "componentName": "营业收入",
+    "dataType": "NUMBER",
+    "isRequired": true,
+    "metricCode": "M001",
+    "fieldConfigJson": {
+    "unit": "万元",
+    "precision": 2
+    },
+    "indexNO": 2
+    }
+    ],
+    "reporterConfig": [
+    {
+    "unitId": "ORG001",
+    "unitName": "招商局集团",
+    "reporterUserId": "USER002",
+    "reporterUserName": "李四"
+    }
+    ],
+    "currentActiveVersionNo": "1.2"
+    }
+    }
+    1.3 创建表单模板
+    接口路径: POST /api/forms/templates
+    接口说明: 创建新的表单模板(初始状态为停用)
+    请求参数:
+    {
+    "templateName": "月度运营报表",
+    "templateContent": {
+    "description": "用于月度运营数据填报"
+    },
+    "components": [
+    {
+    "componentName": "报告月份",
+    "dataType": "TEXT",
+    "isRequired": true,
+    "indexNO": 1
+    }
+    ]
+    }
+    响应示例:
+    {
+    "code": 200,
+    "message": "创建成功",
+    "data": {
+    "templateId": 1002,
+    "currentActiveVersionNo": "1.0"
+    }
+    }
+    1.4 更新表单模板
+    接口路径: PUT /api/forms/templates/{templateId}
+    接口说明: 更新表单模板的设计结构
+    请求参数: 同创建接口(不含版本号,系统自动递增)
+    响应示例:
+    {
+    "code": 200,
+    "message": "更新成功",
+    "data": {
+    "currentActiveVersionNo": "1.3"
+    }
+    }
+
+1.5 维护表单属性
+接口路径: PUT /api/forms/templates/{templateId}/attributes
+接口说明: 维护表单的业务属性和填报配置
+请求参数:
+{
+"belongOrgId": 101,
+"leaderId": 10001,
+"businessDomainId": 201,
+"approvalFlowId": 301,
+"isGenerateReport": true,
+"reporterConfig": [
+{
+"unitId": "ORG001",
+"reporterUserId": "USER002"
+},
+{
+"unitId": "ORG002",
+"reporterUserId": "USER003"
+}
+]
+}
+响应示例:
+{
+"code": 200,
+"message": "属性更新成功"
+}
+1.6 启用/停用表单模板
+接口路径: PUT /api/forms/templates/{templateId}/status
+接口说明: 启用或停用表单模板
+请求参数:
+{
+"status": "ENABLED"
+}
+响应示例:
+{
+"code": 200,
+"message": "状态更新成功"
+}
+1.7 删除表单模板
+接口路径: DELETE /api/forms/templates/{templateId}
+接口说明: 删除表单模板(软删除)
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "删除成功"
+}
+1.8 发布版本
+接口路径: POST /api/forms/templates/{templateId}/publish
+接口说明: 发布表单模板版本，创建form\_template\_version\_control数据记录，生成新的版本控制信息
+响应示例:
+成功发布:
+{
+"code": 200,
+"message": "版本发布成功",
+"data": {
+"templateId": 1001,
+"versionId": 3,
+"currentActiveVersionNo": "1.3",
+"publishTime": "2025-01-17 14:30:00",
+"formContentId": 5001
+}
+}
+2. 表单设计器相关接口
+2.1 获取组件库
+接口路径: GET /api/forms/components/library
+接口说明: 获取表单设计器的组件库配置
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"basicComponents": [
+{
+"componentType": "TEXT",
+"componentName": "单行文本",
+"icon": "text-icon",
+"defaultConfig": {
+"componentName": "文本框",
+"isRequired": false,
+"placeholder": "请输入"
+}
+},
+{
+"componentType": "NUMBER",
+"componentName": "数字输入",
+"icon": "number-icon",
+"defaultConfig": {
+"componentName": "数字框",
+"isRequired": false,
+"min": null,
+"max": null
+}
+}
+],
+"metricComponents": [
+{
+"componentType": "METRIC",
+"componentName": "指标选择器",
+"icon": "metric-icon",
+"defaultConfig": {
+"componentName": "指标",
+"isRequired": true,
+"selectMode": "single"
+}
+}
+],
+"layoutComponents": [
+{
+"componentType": "TABLE",
+"componentName": "表格布局",
+"icon": "table-icon",
+"defaultConfig": {
+"rows": 3,
+"cols": 3
+}
+}
+]
+}
+}
+2.2 搜索指标
+接口路径: GET /api/forms/metrics/search
+接口说明: 在表单设计器中搜索指标(供指标选择器使用)
+请求参数:
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": [
+{
+"metricCode": "M001",
+"metricName": "营业收入",
+"unit": "万元",
+"precision": "2",
+"dataType": "数值型",
+"frequency": "季度",
+"categoryName": "财务管理"
+}
+]
+}
+2.3 获取指标详情
+接口路径: GET /api/forms/metrics/{metricCode}
+接口说明: 获取指标的详细属性(供指标选择器自动填充使用)
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"metricCode": "M001",
+"metricName": "营业收入",
+"metricDefinition": "企业在一定期间内销售商品、提供劳务等经营活动所取得的收入",
+"unit": "万元",
+"precision": "2",
+"dataType": "数值型",
+"frequency": "季度",
+"analysisMethod": "同比分析",
+"companyDim": "招商局集团",
+"dataSource": "财务系统"
+}
+}
+3. 表单分类管理接口
+3.1 获取业务领域树
+接口路径: GET /api/forms/categories
+接口说明: 获取业务领域树结构
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": [
+{
+"id": 201,
+"categoryName": "财务管理",
+"parentId": null,
+"indexNO": 1,
+"formCount": 20,
+"children": [
+{
+"id": 202,
+"categoryName": "财务报表",
+"parentId": 201,
+"indexNO": 1,
+"formCount": 10,
+"children": []
+}
+]
+}
+]
+}
+3.2 新增业务领域
+接口路径: POST /api/forms/categories
+接口说明: 新增业务领域节点
+请求参数:
+{
+"categoryName": "运营管理",
+"parentId": null,
+"indexNO": 2
+}
+响应示例:
+{
+"code": 200,
+"message": "新增成功",
+"data": {
+"id": 203
+}
+}
+3.3 更新业务领域
+接口路径: PUT /api/forms/categories/{categoryId}
+接口说明: 更新业务领域信息
+请求参数: 同新增接口
+响应示例:
+{
+"code": 200,
+"message": "更新成功"
+}
+3.4 删除业务领域
+接口路径: DELETE /api/forms/categories/{categoryId}
+接口说明: 删除业务领域节点
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "删除成功"
+}
+如果有子节点或表单关联:
+{
+"code": 400,
+"message": "该分类下有子节点或10个表单,无法删除",
+"data": {
+"hasChildren": true,
+"formCount": 10
+}
+}
+3.5 调整节点顺序
+接口路径: PUT /api/forms/categories/{categoryId}/sort
+接口说明: 调整业务领域节点在同级中的顺序
+请求参数:
+{
+"direction": "UP"
+}
+参数说明:
+direction: 移动方向,可选值为"UP"(上移)或"DOWN"(下移)
+响应示例:
+{
+"code": 200,
+"message": "顺序调整成功"
+}
+七、数据库设计
+
+1. E-R 关系图
+2. 数据表定义
+   2.1 表单模板主表(form\_template)
+   描述: 该表存储表单模板的核心定义和业务属性。
+   索引设计:
+   主键索引: PK\_form\_template(template\_id)
+   SQL查询示例:
+   -- 查询表单模板列表(带权限过滤)
+   SELECT
+   t.template\_id,
+   t.template\_name,
+   t.belong\_org\_name,
+   t.leader\_name,
+   t.business\_domain\_name,
+   t.approval\_flow\_name,
+   t.status,
+   t.is\_locked\_for\_use,
+   t.current\_active\_version\_num,
+   t.template\_no,
+   t.template\_message,
+   t.is\_all\_visible
+   FROM form\_template t
+   WHERE t.status = 'ENABLED'
+   AND (:template\_name IS NULL OR t.template\_name LIKE CONCAT('%', :template\_name, '%'))
+   AND (:business\_domain\_id IS NULL OR t.business\_domain\_id = :business\_domain\_id)
+   AND (:belong\_org\_id IS NULL OR t.belong\_org\_id = :belong\_org\_id)
+   ORDER BY t.template\_id DESC
+   LIMIT :pageSize OFFSET :offset;
+   2.2 表单组件/字段定义表(FORM\_COMPONENT)
+   描述: 该表存储表单模板中所有组件(字段)的详细定义。
+   索引设计:
+   主键索引: PK\_form\_component(component\_id)
+   普通索引: IDX\_TEMPLATE\_ID(template\_id), IDX\_METRIC\_CODE(metric\_code)
+   SQL查询示例:
+   -- 查询表单的所有组件
+   SELECT
+   component\_id,
+   component\_name,
+   data\_type,
+   is\_required,
+   field\_config\_json,
+   metric\_code,
+   index\_no,
+   is\_add
+   FROM form\_component
+   WHERE template\_id = :template\_id
+   ORDER BY index\_no ASC;
+   2.3 表单模板填报单位人员子表(form\_template\_fill\_person)
+   描述: 该表定义了哪些单位或个人需要填报此表单。
+   索引设计:
+   主键索引: PK\_form\_template\_fill\_person(id)
+   SQL查询示例:
+   -- 查询表单的填报配置
+   SELECT
+   id,
+   template\_id,
+   unit\_id,
+   unit\_name,
+   user\_id,
+   user\_name,
+   index\_no
+   FROM form\_template\_fill\_person
+   WHERE template\_id = :template\_id
+   ORDER BY index\_no ASC;
+   2.4 表单模板可视范围人员子表(form\_template\_visible\_person)
+   描述: 该表定义了哪些单位或个人可以查看此表单。
+   索引设计:
+   主键索引: PK\_form\_template\_visible\_person(id)
+   普通索引: IDX\_TEMPLATE\_ID(template\_id)
+   SQL查询示例:
+   -- 查询表单的可视范围配置
+   SELECT
+   id,
+   template\_id,
+   unit\_id,
+   unit\_name,
+   user\_id,
+   user\_name,
+   index\_no
+   FROM form\_template\_visible\_person
+   WHERE template\_id = :template\_id
+   ORDER BY index\_no ASC;
+   2.5 表单分类/业务领域表(form\_category)
+   描述: 该表用于维护业务领域,以树状结构对表单进行分类管理。
+   索引设计:
+   主键索引: PK\_form\_category(id)
+   普通索引: IDX\_PARENT\_ID(parent\_id)
+   SQL查询示例:
+   -- 查询业务领域树
+   WITH RECURSIVE CategoryTree AS (
+   SELECT id, category\_name, parent\_id, index\_no, level, level\_code, 0 AS Level
+   FROM form\_category
+   WHERE parent\_id IS NULL
+
+UNION ALL
+
+SELECT c.id, c.category\_name, c.parent\_id, c.index\_no, c.level, c.level\_code, ct.Level + 1
+FROM form\_category c
+INNER JOIN CategoryTree ct ON c.parent\_id = ct.id
+)
+SELECT \* FROM CategoryTree ORDER BY Level, index\_no;
+2.6 表单模板版本控制表(form\_template\_version\_control)
+描述: 该表用于管理表单模板的版本控制信息。
+索引设计:
+主键索引: PK\_form\_template\_version\_control(id)
+普通索引: IDX\_TEMPLATE\_ID(template\_id), IDX\_VERSION\_ID(version\_id)
+SQL查询示例:
+-- 查询表单模板的版本控制信息
+SELECT
+id,
+template\_id,
+index\_no,
+version\_id,
+form\_content\_id
+FROM form\_template\_version\_control
+WHERE template\_id = :template\_id
+ORDER BY version\_id DESC;
+3. 数据关联关系
+form\_template (表单模板)
+├── form\_component (表单组件)
+│ 通过 template\_id 关联
+│ └── METRIC\_INDEX (指标定义)
+│ 通过 metric\_code 关联
+│
+├── form\_category (表单分类)
+│ 通过 business\_domain\_id 关联
+│
+├── form\_template\_fill\_person (填报人员配置)
+│ 通过 template\_id 关联
+│
+├── form\_template\_visible\_person (可视人员配置)
+│ 通过 template\_id 关联
+│
+└── form\_template\_version\_control (版本控制)
+通过 template\_id 关联
+
+|  |  |  |
+| --- | --- | --- |
+| 一级菜单(模块名称) | 二级菜单 | 三级菜单 |
+| 表单管理 | 表单模板 |  |
+|  | 表单分类 |  |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 表单名称 | 文本输入 | 模糊搜索表单的名称。 |
+| 主属部门 | 下拉选择 | 选择表单所属的主属部门进行筛选。 |
+| 业务领域 | 下拉选择 | 选择表单所属的业务领域进行筛选。 |
+| 负责人 | 文本输入 | 模糊搜索表单的负责人姓名或工号。 |
+| 更新时间 | 日期范围选择 | 根据表单的最后更新时间进行筛选(开始时间-结束时间)。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 列表序号。 |  |
+| 表单名称 | 表单模板的名称。 |  |
+| 主属部门 | 表单的主属部门。 |  |
+| 负责人 | 表单的负责人姓名。 |  |
+| 业务领域 | 表单所属的业务领域。 |  |
+| 审批流程 | 表单关联的审批流程名称。 |  |
+| 状态 | 表单的启用/停用状态。 |  |
+| 更新时间 | 表单的最后更新时间。 |  |
+| 生效版本号 | 表单模板当前生效的版本号。 |  |
+| 操作 | 包含"预览表单"、"发布"、"更多操作"（含"维护属性"、"维护表单"、"删除表单"、"复制表单"）、"停用/启用状态"等操作按钮。 |  |
+| 操作按钮 | 说明 | 权限要求 |
+| --- | --- | --- |
+| 预览表单 | 以只读模式预览表单模板的完整结构和样式，查看表单的实际展示效果。 | 表单查看权限 |
+| 发布 | 将表单模板发布为正式版本，发布后可供用户填报使用。 | 表单发布权限 |
+| 维护属性 | 跳转到表单属性维护界面,可修改主属部门、负责人、业务领域等属性,并进行启用/停用操作。 | 表单维护权限 |
+| 维护表单 | 跳转到表单设计器界面，可对表单的结构、字段、布局等进行编辑和修改。 | 表单维护权限 |
+| 删除表单 | 删除选中的表单模板，删除前需确认操作，已发布或有填报数据的表单不允许删除。 | 表单删除权限 |
+| 复制表单 | 基于当前表单模板创建一个副本，可在副本基础上进行修改，可以快速新建表单。 | 表单创建权限 |
+| 停用/启用状态 | 切换表单的启用状态，停用后表单不可用于填报，启用后恢复正常使用。 | 表单维护权限 |
+| 功能清单 | 功能操作 |  |
+| --- | --- |  |
+| 创建表单 | 表单设计器 |  |
+| 修改表单 |  |  |
+| 删除表单 |  |  |
+| 表单启停 |  |  |
+| 字段名称 | 字段类型 | 是否必填 |
+| --- | --- | --- |
+| 表单名称 | String | 是 |
+| 表单编码 | String | 是 |
+| 版本 | String | 否 |
+| 描述 | String | 否 |
+| 列数 | Number | 否 |
+| 布局 | String | 否 |
+| 标签宽度 | Number | 否 |
+| 对齐方式 | String | 否 |
+| 开启序号 | Boolean | 否 |
+| 表单自定义样式 | String | 否 |
+| 序号 | 组件分类 | 组件名称 |
+| --- | --- | --- |
+| 1 | 基础输入组件 | 单行输入 |
+| 2 | 基础输入组件 | 多行输入 |
+| 3 | 基础输入组件 | 数字输入 |
+| 4 | 选择类组件 | 下拉单选 |
+| 5 | 选择类组件 | 单选按钮 |
+| 6 | 选择类组件 | 联级选择 |
+| 7 | 多选类组件 | 多选框 |
+| 8 | 多选类组件 | 多选输入 |
+| 9 | 特殊功能组件 | 开关 |
+| 10 | 特殊功能组件 | 日期时间 |
+| 11 | 特殊功能组件 | 文字 |
+| 12 | 特殊功能组件 | 文件上传 |
+| 13 | 高级组件 | 指标库 |
+| 14 | 布局组件 | 表格容器 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 占位符文本 | 文本输入 | 否 |
+| 默认值 | 文本输入 | 否 |
+| 最大长度 | 数字输入 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 占位符文本 | 文本输入 | 否 |
+| 默认值 | 多行输入 | 否 |
+| 自动高度 | 开关 | 否 |
+| 行数设置 | 数字输入 | 否 |
+| 最大长度 | 数字输入 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 占位符文本 | 文本输入 | 否 |
+| 默认值 | 数字输入 | 否 |
+| 最小值 | 数字输入 | 否 |
+| 最大值 | 数字输入 | 否 |
+| 步长设置 | 数字输入 | 否 |
+| 小数位数 | 数字输入 | 否 |
+| 单位显示 | 文本输入 | 否 |
+| 单位转换 | 数字输入 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 选项配置 | 选项编辑器 | 是 |
+| 默认选项 | 下拉选择 | 否 |
+| 选项来源 | 单选按钮 | 否 |
+| 联动设置 | 联动配置器 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 选项配置 | 选项编辑器 | 是 |
+| 默认选项 | 单选按钮 | 否 |
+| 排列方式 | 单选按钮 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 数据源配置 | 数据源选择器 | 是 |
+| 默认值 | 联级选择器 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 选项配置 | 选项编辑器 | 是 |
+| 默认选项 | 多选框 | 否 |
+| 排列方式 | 单选按钮 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 预设选项 | 选项编辑器 | 否 |
+| 允许自定义 | 开关 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 默认状态 | 开关 | 否 |
+| 开启文本 | 文本输入 | 否 |
+| 关闭文本 | 文本输入 | 否 |
+| 开启值 | 文本输入 | 否 |
+| 关闭值 | 文本输入 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 日期格式 | 下拉选择 | 否 |
+| 时间精度 | 下拉选择 | 否 |
+| 默认值 | 日期选择器 | 否 |
+| 最小日期 | 日期选择器 | 否 |
+| 最大日期 | 日期选择器 | 否 |
+| 快捷选择 | 多选框 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 显示文本 | 富文本编辑器 | 是 |
+| 字体大小 | 下拉选择 | 否 |
+| 字体颜色 | 颜色选择器 | 否 |
+| 字体粗细 | 下拉选择 | 否 |
+| 对齐方式 | 单选按钮 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 文件类型 | 多选框 | 否 |
+| 文件大小 | 数字输入 | 否 |
+| 上传数量 | 数字输入 | 否 |
+| 上传方式 | 多选框 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | 文本输入 | 是 |
+| 字段名称 | 文本输入 | 是 |
+| 指标范围 | 下拉选择 | 否 |
+| 自动带出 | 选项编辑器 | 否 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 字段标签 | String | 是 |
+| 字段名称 | String | 是 |
+| 占位 | Number | 是 |
+| 配置项名称 | 配置类型 | 是否必填 |
+| --- | --- | --- |
+| 必填验证 | Boolean | 否 |
+| 格式验证 | String | 否 |
+| 自定义验证 | Function | 否 |
+| 错误提示 | String | 否 |
+| 字段名称 | 控件类型 | 是否必填 |
+| --- | --- | --- |
+| 主属部门 | 下拉选择器 | 是 |
+| 负责人 | 用户选择器 | 是 |
+| 业务领域 | 树形选择器 | 是 |
+| 是否生成报告 | 单选按钮组 | 是 |
+| 填报单位 | 组织选择器 | 是 |
+| 填报人 | 用户选择器 | 是 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 节点名称 | 文本展示 | 业务领域名称(可编辑)。 |
+| 新增子节点 | 图标按钮 | 在当前节点下新增子节点。 |
+| 编辑节点 | 图标按钮 | 编辑当前节点名称。 |
+| 删除节点 | 图标按钮 | 删除当前节点。 |
+| 上移/下移 | 图标按钮 | 调整节点在同级中的顺序。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 表单在列表中的序号。 |  |
+| 表单名称 | 表单模板的名称。 |  |
+| 主属部门 | 表单的主属部门。 |  |
+| 负责人 | 表单的负责人姓名。 |  |
+| 业务领域 | 表单所属的业务领域。 |  |
+| 创建时间 | 表单的创建时间。 |  |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| template\_name | String | 否 |
+| belong\_org\_id | Integer | 否 |
+| business\_domain\_id | Long | 否 |
+| leader\_name | String | 否 |
+| update\_time\_start | String | 否 |
+| update\_time\_end | String | 否 |
+| status | String | 否 |
+| page\_num | Integer | 否 |
+| page\_size | Integer | 否 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| keyword | String | 是 |
+| category\_id | Integer | 否 |
+| limit | Integer | 否 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| template\_id | BIGINT | 64 |
+| template\_name | VARCHAR | 255 |
+| status | FormTemplateStatusEnum | 50 |
+| business\_domain\_id | BIGINT | 64 |
+| business\_domain\_name | VARCHAR | 255 |
+| approval\_flow\_id | BIGINT | 64 |
+| approval\_flow\_name | VARCHAR | 255 |
+| is\_locked\_for\_use | BOOLEAN | NULL |
+| belong\_org\_id | INT | 11 |
+| belong\_org\_name | VARCHAR | 255 |
+| leader\_id | INT | 11 |
+| leader\_name | VARCHAR | 255 |
+| is\_generate\_report | BOOLEAN | NULL |
+| current\_active\_version\_num | VARCHAR | 255 |
+| template\_no | VARCHAR | 255 |
+| template\_message | VARCHAR | 255 |
+| report\_template | VARCHAR | 255 |
+| integrate\_with\_writing\_api | VARCHAR | 255 |
+| is\_all\_visible | BOOLEAN | NULL |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| component\_id | BIGINT | 64 |
+| template\_id | BIGINT | 64 |
+| component\_name | VARCHAR | 255 |
+| data\_type | VARCHAR | 50 |
+| is\_required | BOOLEAN | NULL |
+| field\_config\_json | JSON | NULL |
+| metric\_code | VARCHAR | 100 |
+| index\_no | INT | 11 |
+| is\_add | BOOLEAN | NULL |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 64 |
+| template\_id | BIGINT | 64 |
+| unit\_id | VARCHAR | 64 |
+| unit\_name | VARCHAR | 64 |
+| user\_id | VARCHAR | 64 |
+| user\_name | VARCHAR | 64 |
+| index\_no | INT | 11 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 64 |
+| template\_id | BIGINT | 64 |
+| unit\_id | VARCHAR | 64 |
+| unit\_name | VARCHAR | 64 |
+| user\_id | VARCHAR | 64 |
+| user\_name | VARCHAR | 64 |
+| index\_no | INT | 11 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | INT | 64 |
+| category\_name | VARCHAR | 255 |
+| parent\_id | VARCHAR | 64 |
+| index\_no | INT | 11 |
+| level | INT | 11 |
+| level\_code | VARCHAR | 255 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 64 |
+| template\_id | BIGINT | 64 |
+| index\_no | INT | 11 |
+| version\_id | INT | 11 |
+| form\_content\_id | INT | 11 |
+
+**7. 报告管理模块**
+
+**功能框架**
+
+报告管理
+业务主线：报告列表 → 报告下载 → 预览 → 上传归档。
+数据主线：模板驱动（表单/报告模板）→ 数据拉取与汇总 → 文件归档与状态管理。
+对接能力：随行爱写作（AI 生成）、任务中心（已填报数据自动填充）、文件服务（归档）。
+整体业务流程
+
+**功能点详细设计**
+
+4.1 报告列表展示与查询
+功能说明
+在报告列表页，用户可通过报告名称、主属部门、创建人及时间范围等条件进行多维度筛选与重置，列表支持服务端分页与排序，并提供进入下载、上传归档等操作；所有操作均受菜单与数据权限控制，异常将反馈清晰的错误信息与可重试入口。
+原型界面
+界面设计
+布局结构：
+顶部查询区（文本/下拉/时间范围/查询/重置）。
+中间列表区（序号、报告名称、报告模板、所属部门、业务领域、创建人、创建时间、更新时间、状态、操作）。
+底部分页区（页码、每页条数）。
+交互与操作：
+查询/重置：支持多条件查询与重置；保留上次查询条件（可选）。
+列表操作：编辑（进入内容填报/预览）、导出、上传归档、查看详情、删除（未归档/未锁定）。
+排序/分页：支持创建时间、更新时间、状态排序；大列表服务端分页。
+操作流程
+查询条件项
+列表字段栏目
+数据权限
+所有操作均受菜单与数据权限控制，仅任务的填报人和审批人、任务发起人可查看报告。
+流程时序图
+4.2 报告导出与上传归档
+功能说明
+该功能支持将报告按需导出为 Word/PPT/PDF 等格式，并在终版形成后上传归档以锁定内容与版本；上传过程对文件类型、大小进行校验（可结合病毒扫描/水印策略），归档成功后状态更新为“已归档”，同时记录操作者、时间与文件信息的操作日志；导出/上传失败会返回明确错误码与重试入口，确保流程的可恢复性。
+原型界面
+界面设计
+导出弹窗选择格式与版本；上传归档弹窗选择文件，展示上传结果。
+操作流程
+数据权限
+导出：仅报告生成人、审批人、任务发起人可导出。
+上传归档：仅报告生成人、任务发起人可上传归档。
+五、业务流程
+六、数据库表结构设计
+6.1 报告表（data\_report）
+6.2 报告文件表（data\_report\_file）
+6.4 报告归档文件表（archive\_files）
+七、接口设计
+为“报告管理/报告生成”提供后端接口定义，涵盖列表查询、详情、内容填报/自动拉取与 AI 生成、预览、导出、上传归档与状态更新等能力。所有接口返回统一结构：{ code: 200, message: "success", data: ... }；异常返回 code 为非 200，并包含错误消息与错误码。
+7.1 获取报告列表
+接口路径：GET /api/reports
+接口说明：按条件查询报告列表，支持分页与排序。
+请求参数：
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"total": 50,
+"list": [
+{
+"reportId": 1001,
+"reportName": "招商局Q3季度报告",
+"formTemplateId": 301,
+"belongOrgId": 10,
+"businessDomainId": 200,
+"creatorName": "张三",
+"createdAt": "2025-10-01 10:00:00",
+"updatedAt": "2025-10-14 09:30:00",
+"status": "EDITING"
+}
+]
+}
+}
+7.2 下载报告
+接口路径：POST /api/reports/{id}/export
+接口说明：导出指定格式的报告文件。
+请求参数：
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"downloadUrl": "/download/reports/1001/Q3-2025.pdf"
+}
+}
+7.3 上传归档
+接口路径：POST /api/reports/{id}/archive
+接口说明：上传最终版本的文件并将报告状态更新为“已归档”。
+请求方式：multipart/form-data
+响应示例：
+{
+"code": 200,
+"message": "success",
+"data": {
+"fileUrl": "/files/reports/1001/Q3-2025-final.docx",
+"status": "ARCHIVED"
+}
+}
+
+|  |  |  |
+| --- | --- | --- |
+| 一级菜单 | 二级菜单 | 三级菜单 |
+| 报告管理 | 报告生成 |  |
+| 操作 | 触发位置 | 前置条件 |
+| --- | --- | --- |
+| 查询 | 查询区按钮 | 输入任意条件 |
+| 重置 | 查询区按钮 | 无 |
+| 编辑 | 列表操作 | 权限校验通过 |
+| 导出 | 列表操作 | 内容存在 |
+| 上传归档 | 列表操作 | 文件选择完成 |
+| 删除 | 列表操作 | 未归档/未锁定 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 报告名称 | 文本输入 | 模糊搜索报告名称 |
+| 主属部门 | 下拉选择 | 选择报告所属部门进行下拉筛选 |
+| 创建人 | 文本输入 | 模糊搜索创建人的工号/姓名 |
+| 创建日期 | 时间范围选择 | 根据报告创建日期时间进行筛选(开始时间-结束时间) |
+| 更新日期 | 时间范围选择 | 根据报告更新日期时间进行筛选(开始时间-结束时间) |
+| 字段 | 字段名称 | 描述 |
+| --- | --- | --- |
+| taskId | 任务名称 | 已完成任务的名称 |
+| formTemplateId | 表单模板 | 使用表单模板的id |
+| orgId | 主属部门 | 报告所属部门id |
+| categoryId | 业务领域 | 报告所属业务领域id |
+| createBy | 生成人 | 报告生成人 |
+| createTime | 生成时间 | 报告生成时间 |
+| 操作 | 触发位置 | 前置条件 |
+| --- | --- | --- |
+| 导入文件 | 导入弹窗 | 选择格式与版本 |
+| 上传归档 | 上传弹窗 | 上传合法文件 |
+| 字段 | 类型 | 约束 |
+| --- | --- | --- |
+| report\_id | BIGINT | PK |
+| report\_name | VARCHAR(200) | NOT NULL |
+| task\_id | BIGINT | NOT NULL, IDX |
+| form\_template\_id | BIGINT | NOT NULL, IDX |
+| final\_version | BIGINT | IDX |
+| create\_by | BIGINT | NOT NULL, IDX |
+| create\_time | DATETIME | NOT NULL |
+| update\_time | DATETIME | NOT NULL |
+| 字段 | 类型 | 约束 |
+| --- | --- | --- |
+| file\_id | BIGINT | PK |
+| report\_id | BIGINT | NOT NULL, IDX |
+| report\_name | VARCHAR(200) | NOT NULL |
+| report\_description | TEXT | NULL |
+| version\_no | INT | NOT NULL |
+| file\_path | VARCHAR(200) | NOT NULL |
+| file\_type | VARCHAR(200) | NOT NULL |
+| file\_size | INTEGER | NULL |
+| gen\_by\_ai | BOOLEAN | NOT NULL |
+| gen\_by\_ai | BOOLEAN | NOT NULL |
+| create\_by | BIGINT | NOT NULL, IDX |
+| create\_time | DATETIME | NOT NULL |
+| update\_time | DATETIME | NOT NULL |
+| 字段 | 类型 | 约束 |
+| --- | --- | --- |
+| id | BIGINT | PK |
+| report\_id | BIGINT | NOT NULL, IDX |
+| file\_id | BIGINT | NOT NULL |
+| file\_type | VARCHAR(20) | NOT NULL |
+| archived\_time | DATETIME | NOT NULL |
+| archived\_by | BIGINT | NOT NULL |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| reportName | String | 否 |
+| belongOrgId | Integer | 否 |
+| businessDomainId | Long | 否 |
+| creatorName | String | 否 |
+| createTimeStart | String | 否 |
+| createTimeEnd | String | 否 |
+| updateTimeStart | String | 否 |
+| updateTimeEnd | String | 否 |
+| status | String | 否 |
+| pageNum | Integer | 否 |
+| pageSize | Integer | 否 |
+| sortBy | String | 否 |
+| sortOrder | String | 否 |
+| 参数名称 | 类型 | 必填 |
+| --- | --- | --- |
+| format | String | 是 |
+| 字段 | 类型 | 必填 |
+| --- | --- | --- |
+| file | File | 是 |
+
+**8. 系统管理模块**
+
+**功能框架**
+
+系统管理
+
+**功能点详细设计**
+
+1. 组织管理 - 维护组织架构
+   功能说明
+   系统同步NUC主数据的组织架构(部分),支持多组织树,并支持管理员手工维护组织信息(新增、编辑、删除)。提供组织架构的树形展示和详细信息编辑功能。
+   原型界面
+   根据原型设计,页面采用左右分栏布局:
+   左侧:组织架构树形导航
+   右侧:组织列表表格,展示组织简称、组织全称、更新时间等信息
+   操作流程
+   管理员进入"组织管理"页面
+   系统展示从NUC同步的组织架构树
+   管理员可查看左侧组织树,右侧展示组织列表及详细信息
+   管理员可执行新增、编辑、删除组织节点的操作
+   管理员可手动触发NUC数据同步
+   系统展示组织的基本信息:组织简称、组织全称、更新时间等
+   界面设计
+   左侧:组织架构树形展示组件
+   右侧:组织列表表格(包含组织简称、组织全称、更新时间等字段)
+   顶部工具栏:包含"同步NUC"、"新增组织"按钮
+   列表每行操作:编辑、删除按钮
+   界面字段
+   列表字段栏目
+   列表排序
+   默认按更新时间倒序排列。支持点击列表头对"组织简称"、"更新时间"等字段进行升序或降序排序。
+   界面操作
+   树节点展开/收起
+   点击树节点筛选右侧列表
+   新增组织(弹出表单)
+   编辑组织(弹出表单)
+   删除组织(确认提示)
+   手动触发NUC数据同步
+2. 用户管理 - 维护应用用户
+   功能说明
+   管理员可维护应用用户,点击左侧组织部门树可筛选组织下用户,支持新增和编辑用户。提供用户与组织的关联管理,支持用户基本信息的增删改查。
+   原型界面
+   根据原型设计,页面采用左右分栏布局:
+   左侧:组织架构树形导航(用于筛选)
+   右侧:用户列表表格,展示用户姓名、工号、所属组织、状态等信息
+   操作流程
+   管理员进入"用户管理"页面
+   系统展示左侧组织树和右侧用户列表
+   管理员点击组织树节点筛选该组织下的用户
+   管理员可执行"新增用户"、"编辑用户"、"删除用户"操作
+   管理员可搜索用户(按姓名、工号等)
+   界面设计
+   左侧:组织树(用于筛选)
+   右侧:用户列表表格
+   顶部工具栏:搜索框、"新增用户"、"批量导入"按钮
+   用户信息编辑/新增表单弹窗
+   界面字段
+   列表字段栏目
+   数据权限
+   管理员可查看和管理其权限范围内的用户信息。权限范围由管理员的角色和所属组织共同决定。
+   界面操作
+   组织树节点点击筛选
+   用户搜索(支持模糊查询)
+   新增用户(弹出表单)
+   编辑用户(弹出表单)
+   删除用户(确认提示)
+3. 权限管理 - 设置用户角色权限
+   功能说明
+   管理员通过添加用户到角色组,并为角色组配置菜单授权和表单授权,从而控制用户权限。平台需支持对表单行列级别和字段级别的权限控制。采用RBAC(基于角色的访问控制)模型。
+   原型界面
+   根据原型设计,页面采用Tab页布局:
+   Tab1:角色管理 - 角色列表和基本信息编辑
+   Tab2:菜单权限 - 树形勾选菜单权限
+   Tab3:表单权限 - 表单权限配置(含数据范围和字段级权限)
+   Tab4:用户分配 - 穿梭框分配用户到角色
+   操作流程
+   管理员进入"权限管理"页面,选择角色管理标签
+   管理员新增/编辑角色组,配置角色名称和描述
+   为角色组配置菜单授权:勾选可访问的菜单(树形勾选)
+   为角色组配置功能授权:勾选可执行的操作(如新增、编辑、删除、导出等)
+   为角色组配置表单授权:
+   选择可访问的表单模板
+   配置表单数据行列级权限(如:只能查看本组织数据)
+   配置字段级权限(如:某些字段只读或不可见)
+   管理员将用户关联到角色组(用户-角色分配)
+   系统实时生效权限配置
+   界面设计
+   角色列表表格(左侧或顶部)
+   角色详情配置面板(右侧或下方):
+   Tab1:基本信息
+   Tab2:菜单权限(树形勾选)
+   Tab3:表单权限(表格+弹窗配置)
+   Tab4:用户分配(穿梭框)
+   细粒度权限配置弹窗(用于配置表单行列字段级权限)
+   界面字段
+   角色基本信息:
+   菜单权限:
+   表单权限:
+   用户分配:
+   列表字段栏目
+   角色列表:
+   界面操作
+   角色增删改查
+   菜单权限树勾选(支持父子级联)
+   表单权限配置(打开弹窗)
+   用户分配(穿梭框选择)
+   权限保存和实时生效
+4. 应用管理 - 管理其他应用对接集成权限
+   功能说明
+   管理其他应用使用填报采集平台功能时的对接集成权限,包括嵌入到其他应用的页面访问权限
+   原型界面
+   根据原型设计,页面采用列表+详情表单布局:
+   主区域:对接应用列表表格
+   操作流程
+   管理员进入"应用管理"页面
+   管理员新增/编辑对接应用信息
+   配置对接应用的基本信息:
+   应用名称
+   应用编号
+   管理员可启用/停用应用
+   界面设计
+   对接应用列表
+   应用详情配置表单(弹窗或侧边栏)
+   列表字段栏目
+   列表排序
+   默认按创建时间倒序排列。支持点击列表头对"应用名称"、"创建时间"、"状态"等字段进行升序或降序排序。
+   界面操作
+   应用信息的增删改查
+   启用/停用应用
+5. 操作日志 - 查看和导出操作日志功能
+   功能说明
+   管理员能够查看和导出用户的操作日志,用于审计和问题追溯。记录用户的关键操作(如登录、创建任务、修改表单、删除数据等),包含操作时间、操作人、操作类型、操作对象、操作结果等信息。
+   原型界面
+   根据原型设计,页面采用查询条件+列表布局:
+   顶部:查询条件区(时间范围、操作用户、操作类型、操作模块、操作结果)
+   中部:操作日志列表表格
+   列表操作:查看详情、导出按钮
+   查询/重置/导出
+   查询 (Query): 根据用户输入的查询条件,筛选并展示符合条件的操作日志列表。
+   重置 (Reset): 清空所有查询条件项,并重新加载默认的日志列表(最近7天)。
+   导出 (Export): 导出当前查询结果的操作日志为Excel文件。
+   操作流程
+   管理员进入"操作日志"页面
+   系统展示操作日志列表(默认显示最近的日志)
+   管理员通过筛选条件查询日志:
+   时间范围(开始时间-结束时间)
+   操作用户(下拉选择或搜索)
+   操作类型(下拉选择:登录、创建、修改、删除、导出等)
+   操作模块(下拉选择:任务中心、表单管理等)
+   操作结果(下拉选择:成功、失败)
+   管理员点击日志行查看详情(弹窗展示完整日志信息)
+   管理员点击"导出"按钮,导出当前筛选条件下的日志记录(Excel格式)
+   界面设计
+   顶部筛选条件区:时间范围、操作用户、操作类型、操作模块、操作结果
+   日志列表表格:操作时间、操作用户、操作类型、操作模块、操作对象、操作结果、操作详情
+   详情弹窗:展示完整的日志信息(包括请求参数、响应结果等)
+   导出按钮
+   查询条件项
+   列表字段栏目
+   列表排序
+   默认按操作时间倒序排列。支持点击列表头对"操作时间"、"操作用户"、"操作类型"等字段进行升序或降序排序。
+   日志详情字段
+   点击"查看详情"按钮后,弹出日志详情弹窗,展示以下字段:
+   界面操作
+   日志筛选和查询
+   查看日志详情(点击行或详情按钮)
+   日志导出(Excel格式)
+   列表分页和排序
+   五、业务流程
+6. 组织管理业务流程
+7. 用户管理业务流程
+8. 权限管理业务流程
+9. 应用管理业务流程
+10. 操作日志查询业务流程
+    六、接口设计
+11. 组织管理接口
+    1.1 获取组织树
+    接口路径: GET /api/system/organizations
+    接口说明: 获取组织树结构和列表
+    请求参数: 无
+    响应示例:
+    {
+    "code": 200,
+    "message": "success",
+    "data": [
+    {
+    "orgId": "ORG001",
+    "orgCode": "CMHJ",
+    "orgShortName": "招商局集团",
+    "orgFullName": "招商局集团有限公司",
+    "parentOrgId": null,
+    "updateTime": "2025-07-28T21:45:45",
+    "children": [
+    {
+    "orgId": "ORG002",
+    "orgCode": "ZSGK",
+    "orgShortName": "招商港口",
+    "orgFullName": "招商港口控股有限公司",
+    "parentOrgId": "ORG001",
+    "updateTime": "2025-07-28T21:45:45",
+    "children": []
+    }
+    ]
+    }
+    ]
+    }
+    1.2 同步NUC组织数据
+    接口路径: POST /api/system/organizations/sync
+    接口说明: 手动触发NUC主数据同步
+    请求参数: 无
+    响应示例:
+    {
+    "code": 200,
+    "message": "同步成功",
+    "data": {
+    "syncTime": "2025-10-14T10:30:00",
+    "addedCount": 5,
+    "updatedCount": 10,
+    "deletedCount": 2
+    }
+    }
+    1.3 新增组织
+    接口路径: POST /api/system/organizations
+    接口说明: 新增组织节点
+    请求参数:
+    {
+    "orgCode": "LNGK",
+    "orgShortName": "辽宁港口",
+    "orgFullName": "辽宁港口股份有限公司",
+    "parentOrgId": "ORG002",
+    "orgType": "子公司"
+    }
+    响应示例:
+    {
+    "code": 200,
+    "message": "新增成功",
+    "data": {
+    "orgId": "ORG003"
+    }
+    }
+    1.4 更新组织
+    接口路径: PUT /api/system/organizations/{orgId}
+    接口说明: 更新组织信息
+    请求参数: 同新增接口
+    响应示例:
+    {
+    "code": 200,
+    "message": "更新成功"
+    }
+    1.5 删除组织
+    接口路径: DELETE /api/system/organizations/{orgId}
+    接口说明: 删除组织节点
+    请求参数: 无
+    响应示例:
+    {
+    "code": 200,
+    "message": "删除成功"
+    }
+12. 用户管理接口
+    2.1 获取用户列表
+    接口路径: GET /api/system/users
+    接口说明: 获取用户列表,支持按组织筛选
+    请求参数:
+    orgId(可选): 组织ID
+    keyword(可选): 搜索关键词(姓名、工号)
+    page: 页码
+    pageSize: 每页数量
+    响应示例:
+    {
+    "code": 200,
+    "message": "success",
+    "data": {
+    "total": 100,
+    "list": [
+    {
+    "userId": "USER001",
+    "userName": "张三",
+    "userCode": "10001",
+    "orgId": "ORG001",
+    "orgName": "招商局集团",
+    "email": "zhangsan@cmhj.com",
+    "phone": "13800138000",
+    "isActive": true
+    }
+    ]
+
+}
+}
+2.2 获取用户详情
+接口路径: GET /api/system/users/{userId}
+接口说明: 获取用户详细信息
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"userId": "USER001",
+"userName": "张三",
+"userCode": "10001",
+"orgId": "ORG001",
+"orgName": "招商局集团",
+"email": "zhangsan@cmhj.com",
+"phone": "13800138000",
+"isActive": true,
+"roles": ["任务发起人", "任务填报人"]
+}
+}
+2.3 新增用户
+接口路径: POST /api/system/users
+接口说明: 新增用户
+请求参数:
+{
+"userName": "李四",
+"userCode": "10002",
+"orgId": "ORG001",
+"email": "lisi@cmhj.com",
+"phone": "13800138001",
+"isActive": true
+}
+响应示例:
+{
+"code": 200,
+"message": "新增成功",
+"data": {
+"userId": "USER002"
+}
+}
+2.4 更新用户
+接口路径: PUT /api/system/users/{userId}
+接口说明: 更新用户信息
+请求参数: 同新增接口
+响应示例:
+{
+"code": 200,
+"message": "更新成功"
+}
+2.5 删除用户
+接口路径: DELETE /api/system/users/{userId}
+接口说明: 删除用户
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "删除成功"
+}
+3. 权限管理接口
+3.1 获取角色列表
+接口路径: GET /api/system/roles
+接口说明: 获取角色列表
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": [
+{
+"roleId": "ROLE001",
+"roleName": "系统管理员",
+"roleDesc": "拥有系统所有权限",
+"userCount": 5
+},
+{
+"roleId": "ROLE002",
+"roleName": "任务发起人",
+"roleDesc": "可以创建和管理任务",
+"userCount": 20
+}
+]
+}
+3.2 新增角色
+接口路径: POST /api/system/roles
+接口说明: 新增角色
+请求参数:
+{
+"roleName": "审批管理员",
+"roleDesc": "负责审批流程管理"
+}
+响应示例:
+{
+"code": 200,
+"message": "新增成功",
+"data": {
+"roleId": "ROLE003"
+}
+}
+3.3 获取角色菜单权限
+接口路径: GET /api/system/roles/{roleId}/menu-permissions
+接口说明: 获取角色的菜单权限配置
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"menuTree": [
+{
+"menuId": "MENU001",
+"menuName": "工作台",
+"checked": true,
+"children": []
+},
+{
+"menuId": "MENU002",
+"menuName": "任务中心",
+"checked": true,
+"children": [
+{
+"menuId": "MENU002-01",
+"menuName": "我的任务",
+"checked": true
+}
+]
+}
+]
+}
+}
+3.4 更新角色菜单权限
+接口路径: PUT /api/system/roles/{roleId}/menu-permissions
+接口说明: 更新角色的菜单权限
+请求参数:
+{
+"menuIds": ["MENU001", "MENU002", "MENU002-01"]
+}
+响应示例:
+{
+"code": 200,
+"message": "更新成功"
+}
+3.5 获取角色表单权限
+接口路径: GET /api/system/roles/{roleId}/form-permissions
+接口说明: 获取角色的表单权限配置
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": [
+{
+"templateId": "TEMPLATE001",
+"templateName": "季度财务报表",
+"dataScope": "本组织",
+"fieldPermissions": [
+{
+"fieldName": "营业收入",
+"visible": true,
+"editable": true
+},
+{
+"fieldName": "净利润",
+"visible": true,
+"editable": false
+}
+]
+}
+]
+}
+3.6 更新角色表单权限
+接口路径: PUT /api/system/roles/{roleId}/form-permissions
+接口说明: 更新角色的表单权限
+请求参数:
+{
+"permissions": [
+{
+"templateId": "TEMPLATE001",
+"dataScope": "本组织",
+"fieldPermissions": [
+{
+"fieldName": "营业收入",
+"visible": true,
+"editable": true
+}
+]
+}
+]
+}
+响应示例:
+{
+"code": 200,
+"message": "更新成功"
+}
+3.7 获取角色用户
+接口路径: GET /api/system/roles/{roleId}/users
+接口说明: 获取角色已分配的用户列表
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"assignedUsers": [
+{
+"userId": "USER001",
+"userName": "张三"
+}
+],
+"availableUsers": [
+{
+"userId": "USER002",
+"userName": "李四"
+}
+]
+}
+}
+3.8 更新角色用户
+接口路径: PUT /api/system/roles/{roleId}/users
+接口说明: 更新角色的用户分配
+请求参数:
+{
+"userIds": ["USER001", "USER003"]
+}
+响应示例:
+{
+"code": 200,
+"message": "更新成功"
+}
+4. 应用管理接口
+4.1 获取应用列表
+接口路径: GET /api/system/applications
+接口说明: 获取对接应用列表
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": [
+{
+"appId": "APP001",
+"appName": "资产管理平台",
+"appKey": "ak\_1234567890abcdef",
+"authType": "Token",
+"isActive": true,
+"createTime": "2025-09-01T10:00:00"
+}
+]
+}
+4.2 获取应用详情
+接口路径: GET /api/system/applications/{appId}
+接口说明: 获取应用详细信息
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"appId": "APP001",
+"appName": "资产管理平台",
+"appKey": "ak\_1234567890abcdef",
+"authType": "Token",
+"callbackUrl": "https://asset.cmhj.com/callback",
+"isActive": true,
+"tokenExpireDays": 365,
+"ipWhiteList": ["192.168.1.100", "192.168.1.101"],
+"apiPermissions": [
+{
+"apiId": "API001",
+"apiName": "创建任务",
+"apiPath": "/api/tasks",
+"checked": true
+}
+]
+}
+}
+4.3 新增应用
+接口路径: POST /api/system/applications
+接口说明: 新增对接应用
+请求参数:
+{
+"appName": "招商随行",
+"authType": "Token",
+"callbackUrl": "https://mobile.cmhj.com/callback",
+"tokenExpireDays": 365,
+"ipWhiteList": ["192.168.1.100"]
+}
+响应示例:
+{
+"code": 200,
+"message": "新增成功",
+"data": {
+"appId": "APP002",
+"appKey": "ak\_0987654321fedcba",
+"tokenSecret": "ts\_abcdef1234567890"
+}
+}
+4.4 更新应用
+接口路径: PUT /api/system/applications/{appId}
+接口说明: 更新应用信息和权限配置
+请求参数: 同新增接口(不含appKey和tokenSecret)
+响应示例:
+{
+"code": 200,
+"message": "更新成功"
+}
+4.5 更新应用状态
+接口路径: PUT /api/system/applications/{appId}/status
+接口说明: 启用或停用应用
+请求参数:
+{
+"isActive": false
+}
+响应示例:
+{
+"code": 200,
+"message": "状态更新成功"
+}
+4.6 删除应用
+接口路径: DELETE /api/system/applications/{appId}
+接口说明: 删除对接应用
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "删除成功"
+}
+5. 操作日志接口
+5.1 获取操作日志列表
+接口路径: GET /api/system/audit-logs
+接口说明: 获取操作日志列表
+请求参数:
+startTime(必填): 开始时间
+endTime(必填): 结束时间
+userId(可选): 操作用户ID
+operationType(可选): 操作类型
+operationModule(可选): 操作模块
+operationResult(可选): 操作结果(成功/失败)
+page: 页码
+pageSize: 每页数量
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"total": 500,
+"list": [
+{
+"logId": "LOG001",
+"operationTime": "2025-10-14T10:30:00",
+"userId": "USER001",
+"userName": "张三",
+"operationType": "创建",
+"operationModule": "任务中心",
+"operationObject": "季度财务报表任务",
+"operationResult": "成功"
+}
+]
+}
+}
+5.2 获取操作日志详情
+接口路径: GET /api/system/audit-logs/{logId}
+接口说明: 获取操作日志详细信息
+请求参数: 无
+响应示例:
+{
+"code": 200,
+"message": "success",
+"data": {
+"logId": "LOG001",
+"operationTime": "2025-10-14T10:30:00",
+"userId": "USER001",
+"userName": "张三",
+"operationIp": "192.168.1.100",
+"operationType": "创建",
+"operationModule": "任务中心",
+"operationObject": "季度财务报表任务",
+"requestParams": "{"taskName":"季度财务报表","deadline":"2025-12-31"}",
+"responseResult": "{"code":200,"taskId":"TASK001"}",
+"operationResult": "成功",
+"errorMessage": null
+}
+}
+5.3 导出操作日志
+接口路径: POST /api/system/audit-logs/export
+接口说明: 导出操作日志为Excel文件
+请求参数: 同获取日志列表接口的筛选参数
+响应示例:
+{
+"code": 200,
+"message": "导出成功",
+"data": {
+"downloadUrl": "/api/files/audit-logs-20251014.xlsx",
+"fileName": "操作日志\_20251014.xlsx"
+}
+}
+七、数据库设计
+
+1. 组织架构表(cfg\_org\_sync)
+2. 用户信息表(lcap\_user)
+3. 角色表(lcap\_role)
+4. 权限配置表(lcap\_permission)
+5. 操作日志表(operate\_log)
+6. 部门表(lcap\_department)
+
+|  |  |  |
+| --- | --- | --- |
+| 一级菜单(模块名称) | 二级菜单 | 三级菜单 |
+| 系统管理 | 组织管理 |  |
+|  | 用户管理 |  |
+|  | 权限管理 |  |
+|  | 应用管理 |  |
+|  | 操作日志 |  |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 组织简称 | 文本输入 | 输入组织简称,必填。 |
+| 组织全称 | 文本输入 | 输入组织全称,必填。 |
+| 更新时间 | 日期时间展示 | 展示最后更新时间。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 组织在当前列表中的序号。 |  |
+| 组织简称 | 组织的简称。 |  |
+| 更新时间 | 组织的最后更新时间。 |  |
+| 操作 | 编辑、删除操作按钮。 |  |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 姓名 | 文本输入 | 输入用户姓名,必填。 |
+| 账号/工号 | 文本输入 | 输入用户工号,必填,唯一。 |
+| 所属组织 | 树形选择器 | 选择用户所属组织,必填。 |
+| 邮箱 | 邮箱输入 | 输入用户邮箱地址。 |
+| 手机号 | 电话输入 | 输入用户手机号码。 |
+| 状态 | 开关切换 | 设置用户状态:激活/停用。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 用户在当前列表中的序号。 |  |
+| 姓名 | 用户的姓名。 |  |
+| 账号/工号 | 用户的工号。 |  |
+| 所属组织 | 用户所属的组织名称。 |  |
+| 邮箱 | 用户的邮箱地址。 |  |
+| 手机号 | 用户的手机号码。 |  |
+| 状态 | 用户状态:激活/停用。 |  |
+| 操作 | 编辑、删除操作按钮。 |  |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 角色名称 | 文本输入 | 输入角色名称,必填。 |
+| 角色描述 | 多行文本 | 输入角色描述说明。 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 菜单权限树 | 复选树形控件 | 勾选可访问的菜单,支持父子级联。 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 表单模板列表 | 表格复选 | 勾选可访问的表单模板。 |
+| 数据范围 | 下拉选择 | 选择数据范围:全部数据/本组织/本部门/自己创建。 |
+| 字段权限配置 | 表格配置 | 配置字段级权限:字段名、可见、可编辑。 |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 用户穿梭框 | 穿梭框组件 | 从可用用户中选择分配到角色。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 角色在当前列表中的序号。 |  |
+| 角色名称 | 角色的名称。 |  |
+| 角色描述 | 角色的描述说明。 |  |
+| 用户数量 | 该角色关联的用户数量。 |  |
+| 操作 | 编辑、删除操作按钮。 |  |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 应用在当前列表中的序号。 |  |
+| 应用名称 | 对接应用的名称。 |  |
+| 所属单位 | 应用所属的单位或组织。 |  |
+| 版本号 | 应用的版本号。 |  |
+| 创建人 | 创建该应用的管理员用户名。 |  |
+| 状态 | 应用状态:启用/停用。 |  |
+| 创建时间 | 应用的创建时间。 |  |
+| 更新时间 | 应用最近一次更新时间。 |  |
+| 操作 | 编辑 |  |
+| 字段名称 | 控件类型 | 描述 |
+| --- | --- | --- |
+| 时间范围 | 日期范围选择 | 筛选操作日志的时间范围(开始时间-结束时间),必填。 |
+| 操作用户 | 下拉选择 | 筛选指定用户的操作日志,支持搜索。 |
+| 操作类型 | 下拉选择 | 筛选操作类型:全部/登录/创建/修改/删除/导出/审批等。 |
+| 操作模块 | 下拉选择 | 筛选操作模块:全部/任务中心/表单管理/系统管理等。 |
+| 操作结果 | 下拉选择 | 筛选操作结果:全部/成功/失败。 |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 序号 | 日志在当前列表中的序号。 |  |
+| 操作时间 | 操作发生的时间。 |  |
+| 操作用户 | 执行操作的用户姓名。 |  |
+| 操作类型 | 操作的类型(如创建、修改、删除)。 |  |
+| 操作模块 | 操作所属的功能模块。 |  |
+| 操作对象 | 操作的目标对象。 |  |
+| 操作结果 | 操作的结果:成功/失败。 |  |
+| 操作 | 查看详情操作按钮。 |  |
+| 字段名称 | 描述 |  |
+| --- | --- |  |
+| 操作ID | 日志记录的唯一标识。 |  |
+| 操作时间 | 操作发生的时间。 |  |
+| 操作用户 | 执行操作的用户姓名。 |  |
+| 操作IP | 操作来源的IP地址。 |  |
+| 操作类型 | 操作的类型。 |  |
+| 操作模块 | 操作所属的功能模块。 |  |
+| 操作对象 | 操作的目标对象。 |  |
+| 请求参数 | 操作请求的参数(JSON格式)。 |  |
+| 响应结果 | 操作响应的结果(JSON格式)。 |  |
+| 操作结果 | 操作的结果:成功/失败。 |  |
+| 错误信息 | 如果操作失败,显示错误信息。 |  |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| org\_sync\_id | UUID | 36 |
+| external\_org\_id | VARCHAR | 64 |
+| internal\_org\_id | VARCHAR | 64 |
+| org\_code | VARCHAR | 64 |
+| org\_short\_name | VARCHAR | 255 |
+| org\_full\_name | VARCHAR | 500 |
+| parent\_org\_id | VARCHAR | 64 |
+| org\_type | VARCHAR | 50 |
+| sync\_time | DATETIME | NULL |
+| is\_active | BOOLEAN | NULL |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 20 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| user\_id | VARCHAR | 255 |
+| user\_name | VARCHAR | 255 |
+| password | VARCHAR | 255 |
+| phone | VARCHAR | 255 |
+| email | VARCHAR | 255 |
+| display\_name | VARCHAR | 255 |
+| status | VARCHAR | 255 |
+| source | VARCHAR | 255 |
+| direct\_leader\_id | VARCHAR | 255 |
+| org\_id | VARCHAR | 64 |
+| is\_active | BOOLEAN | NULL |
+| is\_sync | BOOLEAN | NULL |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 20 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| created\_by | VARCHAR | 255 |
+| updated\_by | VARCHAR | 255 |
+| uuid | VARCHAR | 255 |
+| name | VARCHAR | 255 |
+| description | VARCHAR | 255 |
+| role\_status | TINYINT | 1 |
+| editable | TINYINT | 1 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| permission\_id | BIGINT | 36 |
+| role\_id | BIGINT | 36 |
+| resource\_type | VARCHAR | 50 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| created\_by | VARCHAR | 255 |
+| updated\_by | VARCHAR | 255 |
+| resource\_key | VARCHAR | 255 |
+| access\_level | VARCHAR | 50 |
+| uuid | VARCHAR | 36 |
+| name | VARCHAR | 100 |
+| description | VARCHAR | 255 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 20 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| created\_by | VARCHAR | 255 |
+| updated\_by | VARCHAR | 255 |
+| access\_time | DATETIME | 0 |
+| visitor\_account | VARCHAR | 64 |
+| visitor\_name | VARCHAR | 64 |
+| visitor\_type | VARCHAR | 32 |
+| org\_id | VARCHAR | 128 |
+| access\_path | VARCHAR | 255 |
+| access\_duration | INT | 11 |
+| 字段名称 | 数据类型 | 长度/精度 |
+| --- | --- | --- |
+| id | BIGINT | 20 |
+| created\_time | DATETIME | — |
+| updated\_time | DATETIME | — |
+| created\_by | VARCHAR | 255 |
+| updated\_by | VARCHAR | 255 |
+| name | VARCHAR | 255 |
+| dept\_id | VARCHAR | 255 |
+| parent\_dept\_id | VARCHAR | 255 |
+| org\_id | BIGINT | 64 |