forge_admin/code-copilot/changes/framework-controller-boundary-hardening/tasks.md

任务拆分 — Controller 边界与查询规范整改

前置条件

• 已读取根目录规范、记忆文件和自动化测试标准。
• 已在当前工作树重新扫描 Controller 基线。
• 已确认用户授权按分阶段方案继续实施。
• 不启动真实服务、不连接真实数据库、不执行流程清理。

执行状态

• Task 1：修复分页协议和 Controller 异常边界。
• Task 2：下沉 System Controller 查询。
• Task 3：下沉 AI Controller 查询和事务更新。
• Task 4：下沉 Generator Controller 查询。
• Task 5：下沉 Data/Message Controller 数据操作。
• Task 6：下沉 Flow Controller 查询、统计和清理。
• Task 7：聚合验证并执行两阶段审查。

Task 1：分页协议和异常边界

• 修改：SysCacheController、FlowMonitorController、FlowErrorLogController，增加 pageNum/page 双读。
• 修改：SysUserController、SysExcelExportConfigController、FlowModelVersionController、ExcelEnhancedController。
• 验收：前端只传 pageNum 可正确翻页，旧 page 仍可用；Controller throw new RuntimeException 为零；Excel 不回传底层消息。

Task 2：System Controller 查询下沉

• 修改：SysLoginLogController 对应 Service/Mapper/XML；LoginTenantAssetController 改用已有或新增 Service 查询。
• 验收：两个 Controller 无 Wrapper/直接 Mapper，过滤、排序和租户语义不变。

Task 3：AI Controller 查询与事务更新下沉

• 修改：AiAgentController、AiModelController、AiProviderController 及对应 Service/Mapper/XML。
• 验收：Controller 无 Wrapper；默认项切换在 Service 事务内完成；列表条件不变。

Task 4：Generator Controller 查询下沉

• 修改：GenController、GenDatasourceController、GenTemplateController、GenTableColumnController 及对应 Service/Mapper/XML。
• 验收：Controller 无 Wrapper；用途范围、表名、模板类型、字段排序等条件不变。

Task 5：Data/Message 操作下沉

• 修改：DataDatasetController、MessageBizTypeController 及对应 Service/Mapper/XML。
• 验收：数据集状态更新和启用业务类型查询不再由 Controller 构造。

Task 6：Flow 查询、统计和清理下沉

• 修改：FlowInstanceController、FlowErrorLogController、FlowMonitorController 及对应 Service/Manager/Mapper/XML。
• 清理合同：FlowFormInstance/FlowFillBatchItem 继续逻辑删除；其余 5 张 Forge 表仅在管理员确认清理端点执行物理删除。
• 验收：三个 Controller 无 Wrapper/直接 Mapper；确认门禁、统计字段和失败清单保持。

Task 7：聚合验证与审查

• 执行相关 Maven 模块 package -DskipTests 和增量单测。
• 执行 Mapper XML、Wrapper、RuntimeException、分页参数、尾随空白和 EOF 检查。
• 回填 spec.md、test-spec.md、execution-log.md。
• 先 Spec Compliance，通过后再 Code Quality Review。