diff --git a/docs/plans/backend/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-implementation.md b/docs/plans/backend/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-implementation.md new file mode 100644 index 00000000..0a8a4c37 --- /dev/null +++ b/docs/plans/backend/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-implementation.md @@ -0,0 +1,121 @@ +# Results Overview Project Analysis Dialog Display Optimization Backend Implementation Plan + +> **For agentic workers:** REQUIRED: Use superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** 验证结果总览“查看详情”窗口整体展示优化在当前后端契约下可直接落地，不新增接口、不扩展字段，只对现有详情链路做边界确认与回归留痕。 + +**Architecture:** 本轮设计明确属于前端展示层优化，后端默认不做开发改动。执行时先以 `CcdiProjectOverviewController + ICcdiProjectOverviewService + CcdiProjectOverviewServiceImpl + CcdiProjectOverviewMapper.xml` 的现有详情链路为基准，确认 `basicInfo`、`abnormalDetail.groups` 和既有异常分组口径足以支撑前端重排；若验证通过，则仅沉淀“后端无需改造”的验证记录，不强行制造补丁式变更。 + +**Tech Stack:** Java 21, Spring Boot 3, MyBatis XML, Maven, JUnit 5 + +--- + +### Task 1: 先验证现有详情接口契约足以支撑展示优化 + +**Files:** +- Verify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiProjectOverviewController.java` +- Verify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiProjectOverviewService.java` +- Verify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectOverviewServiceImpl.java` +- Verify: `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml` +- Test: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/controller/CcdiProjectOverviewControllerContractTest.java` +- Test: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/CcdiProjectOverviewServiceStructureTest.java` +- Test: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectOverviewServiceImplTest.java` +- Test: `ccdi-project/src/test/java/com/ruoyi/ccdi/project/mapper/CcdiProjectOverviewMapperSqlTest.java` + +- [ ] **Step 1: Review the existing backend boundary** + +确认以下设计边界与现有代码一致： + +- 详情接口路径仍为 `/ccdi/project/overview/person-analysis/detail` +- 入参仍只有 `projectId` 和 `staffIdCard` +- 返回仍以 `basicInfo` 与 `abnormalDetail.groups` 为核心 +- 现有 `BANK_STATEMENT` / `OBJECT` 分组口径无需为本轮展示优化新增后端字段 + +- [ ] **Step 2: Run the focused backend regression tests** + +Run: + +```bash +mvn test -pl ccdi-project -Dtest=CcdiProjectOverviewControllerContractTest,CcdiProjectOverviewServiceStructureTest,CcdiProjectOverviewServiceImplTest,CcdiProjectOverviewMapperSqlTest +``` + +Expected: + +- `PASS` + +- [ ] **Step 3: If tests fail, stop and reassess** + +若任一测试失败： + +- 不要直接补后端字段或新增接口 +- 先定位失败原因是否为当前展示优化误判了后端边界 +- 只有在确认现有契约确实不足时，才单独回到设计阶段补后端方案 + +- [ ] **Step 4: If tests pass, keep backend code unchanged** + +通过后明确记录： + +- 本轮不修改 Controller、Service、Mapper、SQL、DTO、VO +- 后端现有详情链路已满足前端展示层重排 + +- [ ] **Step 5: Commit** + +```bash +# 本任务若无代码与文档改动，不产生提交。 +``` + +### Task 2: 沉淀后端“无需改造”验证记录 + +**Files:** +- Create: `docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-record.md` +- Create: `docs/tests/records/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-verification.md` + +- [ ] **Step 1: Write the backend verification record** + +在 `docs/tests/records/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-verification.md` 记录： + +- 执行命令 +- 执行日期 +- 结果是否通过 +- 若通过，明确“当前详情接口契约足以支撑本轮展示优化” + +- [ ] **Step 2: Write the backend implementation record** + +在 `docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-record.md` 记录： + +- 本轮目标为展示优化 +- 已核对当前详情接口边界 +- 本轮后端无需代码改动 +- 若后续前端联调发现字段缺口，再单独开设计与实施计划 + +- [ ] **Step 3: Review git status** + +Run: + +```bash +git status --short +``` + +Expected: + +- 只包含本次新增的后端验证记录与实施记录 + +- [ ] **Step 4: Commit** + +```bash +git add docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-record.md docs/tests/records/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-verification.md +git commit -m "补充结果总览详情弹窗后端验证记录" +``` + +- [ ] **Step 5: Handoff** + +执行结论应为以下二选一： + +- `通过`：后端无需改造，进入前端实施计划 +- `不通过`：停止实施，回到设计阶段补后端方案 + +## 完成标准 + +- 已确认当前详情接口契约足以支撑本轮展示优化 +- 未引入任何与需求无关的后端补丁式改动 +- 已留下后端验证记录与实施记录 diff --git a/docs/plans/frontend/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-implementation.md b/docs/plans/frontend/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-implementation.md new file mode 100644 index 00000000..ecb03c6f --- /dev/null +++ b/docs/plans/frontend/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-implementation.md @@ -0,0 +1,312 @@ +# Results Overview Project Analysis Dialog Display Optimization Frontend Implementation Plan + +> **For agentic workers:** REQUIRED: Use superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** 在不改动结果总览入口、路由和接口边界的前提下，完成“查看详情”弹窗的整体展示优化，去掉套娃感，重排头带与侧栏层级，并统一主区、页签、摘要块和表格的工作台视觉语言。 + +**Architecture:** 保持 `PreliminaryCheck.vue` 作为结果总览唯一入口，不新增页面和抽屉。`ProjectAnalysisDialog.vue` 负责重构弹窗整体壳层、头部信息头带、来源上下文和主区节奏；`ProjectAnalysisSidebar.vue` 改为人物档案面板；`ProjectAnalysisAbnormalTab.vue` 与 `ProjectAnalysisPlaceholderTab.vue` 统一成同一套工作台区块。实现顺序遵循“先锁定视觉契约测试，再最小实现，再做回归验证与记录”。 + +**Tech Stack:** Vue 2, Element UI, SCSS, Node.js + +--- + +### Task 1: 锁定弹窗外层骨架与头带契约 + +**Files:** +- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisDialog.vue` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-layout.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-default-tab.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-source-highlight.test.js` + +- [ ] **Step 1: Write the failing test** + +在 3 个现有单测里补充断言，锁定以下展示契约： + +- 弹窗不再依赖内部 `project-analysis-shell` 大白卡作为主壳 +- 存在自定义头带容器，例如 `project-analysis-header` +- 头带里能看到： + - 姓名主标题 + - 风险等级状态位 + - 工号 / 部门 / 所属项目元信息 +- “当前命中模型”不再作为主区顶部单独提示块，而是并入头带 +- 主区中存在风险摘要条或等价概览块 +- 关闭时仍会重置 `activeTab`，再次打开默认回到 `异常明细` + +示例断言片段： + +```js +assert(source.includes("project-analysis-header"), "缺少弹窗头带"); +assert(source.includes("project-analysis-overview"), "缺少主区风险摘要条"); +assert(!source.includes("project-analysis-shell"), "不应继续保留内部大白卡外壳"); +assert(!source.includes('class=\"source-summary\"'), "当前命中模型不应停留在主区顶部"); +``` + +- [ ] **Step 2: Run test to verify it fails** + +Run: + +```bash +cd ruoyi-ui +node tests/unit/project-analysis-dialog-layout.test.js +node tests/unit/project-analysis-dialog-default-tab.test.js +node tests/unit/project-analysis-dialog-source-highlight.test.js +``` + +Expected: + +- `FAIL` + +- [ ] **Step 3: Write minimal implementation** + +在 `ProjectAnalysisDialog.vue` 中完成最小结构重排： + +- 去掉内部 `project-analysis-shell` 大白卡容器 +- 改为“头带 + 主体工作区”的单一主壳结构 +- 将“当前命中模型”合并到头带上下文区域 +- 新增主区风险摘要条骨架 +- 保持现有详情请求、错误态、重试和默认页签逻辑不变 + +- [ ] **Step 4: Run test to verify it passes** + +Run: + +```bash +cd ruoyi-ui +node tests/unit/project-analysis-dialog-layout.test.js +node tests/unit/project-analysis-dialog-default-tab.test.js +node tests/unit/project-analysis-dialog-source-highlight.test.js +``` + +Expected: + +- `PASS` + +- [ ] **Step 5: Commit** + +```bash +git add ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisDialog.vue ruoyi-ui/tests/unit/project-analysis-dialog-layout.test.js ruoyi-ui/tests/unit/project-analysis-dialog-default-tab.test.js ruoyi-ui/tests/unit/project-analysis-dialog-source-highlight.test.js +git commit -m "重构结果总览详情弹窗外层骨架" +``` + +### Task 2: 将左侧侧栏改为人物档案面板 + +**Files:** +- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisSidebar.vue` +- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisDialog.vue` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-sidebar.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-empty-field.test.js` + +- [ ] **Step 1: Write the failing test** + +补充断言，锁定以下侧栏边界： + +- 侧栏主视觉改为人物档案面板，而不是字段平铺式表单 +- 存在人物身份区、模型摘要区、辅助提示区 3 级组织 +- 风险等级改为状态徽标或等价状态块 +- 核心异常标签继续保留，但要与人物元信息分层展示 +- 空值仍统一显示 `-` +- 不恢复整卡独立边框、固定定位或额外扩展区块 + +示例断言片段： + +```js +assert(source.includes("sidebar-profile"), "缺少人物身份区"); +assert(source.includes("sidebar-summary"), "缺少辅助提示区"); +assert(source.includes("sidebar-risk-badge"), "缺少风险等级状态徽标"); +assert(!source.includes("justify-content: space-between"), "不应继续以表单式左右对齐作为主体布局"); +``` + +- [ ] **Step 2: Run test to verify it fails** + +Run: + +```bash +cd ruoyi-ui +node tests/unit/project-analysis-dialog-sidebar.test.js +node tests/unit/project-analysis-dialog-empty-field.test.js +``` + +Expected: + +- `FAIL` + +- [ ] **Step 3: Write minimal implementation** + +在 `ProjectAnalysisSidebar.vue` 中按设计完成重排： + +- 身份区突出姓名、工号、部门、项目和风险等级 +- 模型摘要区保留命中模型数与异常标签 +- 辅助提示区只承载简短说明，不硬凑大块空内容 +- 统一侧栏背景、分组标题和纵向间距 + +如需要，在 `ProjectAnalysisDialog.vue` 中整理透传给侧栏的数据结构，但不改变数据来源边界。 + +- [ ] **Step 4: Run test to verify it passes** + +Run: + +```bash +cd ruoyi-ui +node tests/unit/project-analysis-dialog-sidebar.test.js +node tests/unit/project-analysis-dialog-empty-field.test.js +``` + +Expected: + +- `PASS` + +- [ ] **Step 5: Commit** + +```bash +git add ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisSidebar.vue ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisDialog.vue ruoyi-ui/tests/unit/project-analysis-dialog-sidebar.test.js ruoyi-ui/tests/unit/project-analysis-dialog-empty-field.test.js +git commit -m "改造结果总览详情弹窗侧栏档案面板" +``` + +### Task 3: 统一主区、页签和异常明细区块视觉语言 + +**Files:** +- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisAbnormalTab.vue` +- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisPlaceholderTab.vue` +- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisDialog.vue` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-abnormal-tab.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-layout.test.js` + +- [ ] **Step 1: Write the failing test** + +补充断言，锁定主区视觉收口： + +- 主区存在统一的工作台区块类名，而不是多套卡片/占位板样式并存 +- 异常明细区支持“分组标题 + 一句摘要 + 表格/对象块”的连续阅读流 +- 占位页签外观与异常明细区块采用相同容器基线 +- 表格、对象摘要块、占位区块的圆角、边框和背景风格统一 + +示例断言片段： + +```js +assert(source.includes("analysis-panel"), "缺少统一主区面板样式"); +assert(source.includes("abnormal-card__summary"), "缺少异常分组摘要位"); +assert(!source.includes("background: linear-gradient(180deg, #ffffff 0%, #f8fafc 100%)"), "占位页签不应继续单独使用旧渐变底"); +``` + +- [ ] **Step 2: Run test to verify it fails** + +Run: + +```bash +cd ruoyi-ui +node tests/unit/project-analysis-dialog-abnormal-tab.test.js +node tests/unit/project-analysis-dialog-layout.test.js +``` + +Expected: + +- `FAIL` + +- [ ] **Step 3: Write minimal implementation** + +在 3 个组件中完成最小统一： + +- 把主区内容块统一收口为同一套 `analysis-panel` 风格 +- 给异常分组补一行摘要位或等价的次级说明位 +- 统一页签承载块、对象摘要块、表格容器的边框、圆角、背景和间距 +- 不改动现有真实数据渲染规则和分页逻辑 + +- [ ] **Step 4: Run test to verify it passes** + +Run: + +```bash +cd ruoyi-ui +node tests/unit/project-analysis-dialog-abnormal-tab.test.js +node tests/unit/project-analysis-dialog-layout.test.js +``` + +Expected: + +- `PASS` + +- [ ] **Step 5: Commit** + +```bash +git add ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisAbnormalTab.vue ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisPlaceholderTab.vue ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisDialog.vue ruoyi-ui/tests/unit/project-analysis-dialog-abnormal-tab.test.js ruoyi-ui/tests/unit/project-analysis-dialog-layout.test.js +git commit -m "统一结果总览详情弹窗主区视觉" +``` + +### Task 4: 做前端专项回归并补充记录 + +**Files:** +- Create: `docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-record.md` +- Create: `docs/tests/records/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-verification.md` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-layout.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-default-tab.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-source-highlight.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-sidebar.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-empty-field.test.js` +- Test: `ruoyi-ui/tests/unit/project-analysis-dialog-abnormal-tab.test.js` +- Test: `ruoyi-ui/tests/unit/preliminary-check-project-analysis-entry.test.js` +- Test: `ruoyi-ui/tests/unit/preliminary-check-project-analysis-source-context.test.js` + +- [ ] **Step 1: Run the focused regression suite** + +Run: + +```bash +cd ruoyi-ui +node tests/unit/project-analysis-dialog-layout.test.js +node tests/unit/project-analysis-dialog-default-tab.test.js +node tests/unit/project-analysis-dialog-source-highlight.test.js +node tests/unit/project-analysis-dialog-sidebar.test.js +node tests/unit/project-analysis-dialog-empty-field.test.js +node tests/unit/project-analysis-dialog-abnormal-tab.test.js +node tests/unit/preliminary-check-project-analysis-entry.test.js +node tests/unit/preliminary-check-project-analysis-source-context.test.js +``` + +Expected: + +- 全部 `PASS` + +- [ ] **Step 2: Record the verification result** + +在 `docs/tests/records/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-verification.md` 记录： + +- 执行命令 +- 执行日期 +- 结果是否通过 +- 若有人工核验，记录首屏层级、侧栏、主区和入口行为观察结果 + +- [ ] **Step 3: Write the implementation record** + +在 `docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-record.md` 记录： + +- 头带重排 +- 侧栏改为档案面板 +- 主区和页签统一视觉 +- 本轮未改动接口与路由 + +- [ ] **Step 4: Review git status** + +Run: + +```bash +git status --short +``` + +Expected: + +- 只包含本次前端改动、验证记录和实施记录 + +- [ ] **Step 5: Commit** + +```bash +git add ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisDialog.vue ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisSidebar.vue ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisAbnormalTab.vue ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisPlaceholderTab.vue ruoyi-ui/tests/unit/project-analysis-dialog-layout.test.js ruoyi-ui/tests/unit/project-analysis-dialog-default-tab.test.js ruoyi-ui/tests/unit/project-analysis-dialog-source-highlight.test.js ruoyi-ui/tests/unit/project-analysis-dialog-sidebar.test.js ruoyi-ui/tests/unit/project-analysis-dialog-empty-field.test.js ruoyi-ui/tests/unit/project-analysis-dialog-abnormal-tab.test.js ruoyi-ui/tests/unit/preliminary-check-project-analysis-entry.test.js ruoyi-ui/tests/unit/preliminary-check-project-analysis-source-context.test.js docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-record.md docs/tests/records/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-verification.md +git commit -m "优化结果总览详情弹窗整体展示" +``` + +## 完成标准 + +- 结果总览两个入口继续打开同一个详情弹窗 +- 首屏能先看到人、风险和来源上下文 +- 弹窗内不再出现明显“套娃”结构 +- 左右分栏比例更稳定，主区成为视觉中心 +- 现有详情接口与默认页签行为保持不变 diff --git a/docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-plan-record.md b/docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-plan-record.md new file mode 100644 index 00000000..6c954318 --- /dev/null +++ b/docs/reports/implementation/2026-03-25-results-overview-project-analysis-dialog-display-optimization-plan-record.md @@ -0,0 +1,30 @@ +# 结果总览查看详情窗口整体展示优化实施计划记录 + +## 变更概述 + +- 基于已确认的展示优化设计文档，新增后端实施计划 1 份。 +- 基于已确认的展示优化设计文档，新增前端实施计划 1 份。 +- 本轮计划聚焦弹窗壳层、头带、侧栏和主区视觉统一，不扩散到新接口、新页面或补丁式兼容方案。 +- 本轮仅完成实施计划沉淀，尚未进入代码实现阶段。 + +## 新增文件 + +- `docs/plans/backend/2026-03-25-results-overview-project-analysis-dialog-display-optimization-backend-implementation.md` +- `docs/plans/frontend/2026-03-25-results-overview-project-analysis-dialog-display-optimization-frontend-implementation.md` + +## 计划结论 + +- 前端实施计划聚焦： + - 弹窗外层骨架与头带重排 + - 左侧人物档案面板改造 + - 主区、页签和异常明细区块视觉统一 + - 聚焦回归验证与实施记录沉淀 +- 后端实施计划聚焦： + - 先验证现有详情接口契约是否足以支撑展示优化 + - 若验证通过，则保持后端代码不动 + - 补充后端验证记录与“无需改造”实施记录 + +## 说明 + +- 本次按仓库规范，将实施计划分别落到 `docs/plans/backend/` 与 `docs/plans/frontend/`。 +- 由于仓库约定不启用 subagent，后续执行阶段应在当前会话按计划顺序推进。