# 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 "优化结果总览详情弹窗整体展示" ``` ## 完成标准 - 结果总览两个入口继续打开同一个详情弹窗 - 首屏能先看到人、风险和来源上下文 - 弹窗内不再出现明显“套娃”结构 - 左右分栏比例更稳定，主区成为视觉中心 - 现有详情接口与默认页签行为保持不变