# 已修复缺陷与技术方案 (Fixed Issues)

本文件详细记录本次稳定化清扫中完成修复的具体代码改动、设计权衡与回归验证结果。

---

## 修复清单

### 1. 修复侧边栏空白路由与无可见子项目录渲染 (BUG-01 & BUG-02)

- **涉及文件**：
  - `build_ui/src/router/index.js`
  - `build_ui/src/layout/components/Sidebar/SidebarItem.vue`
- **代码改动**：
  1. 在 `build_ui/src/router/index.js` 中，为 `/train` 顶层 Layout 路由显式指定 `hidden: true`：
     ```javascript
     {
       path: '/train',
       component: Layout,
       hidden: true,
       redirect: '/train/auth',
       children: [ ... ]
     }
     ```
  2. 在 `build_ui/src/layout/components/Sidebar/SidebarItem.vue` 中重构显示判定逻辑：
     - 增加 `isMenuVisible(item)`：若目录的所有子项均为 `hidden` 且父级路由为纯 Layout 容器 (`component === 'Layout'` 或 `redirect === 'noRedirect'`)，则直接隐藏该父级目录；
     - 增加 `hasShowingChildren(children)`：严格检查子数组中是否存在未隐藏项目；
     - 修改 `<el-submenu>` 渲染条件为 `v-else-if="hasShowingChildren(item.children) && item.meta && item.meta.title"`，并在 `template slot="title"` 中确保仅在存在有效标题时输出标题；
     - 修改单项路由条件，避免子项全部隐藏时因 `alwaysShow: true` 强行展开空目录。
- **验证结果**：
  - Admin 端：“首页”与“人员管理”之间的空白箭头彻底消除；“教学成果”不再渲染空折叠项。
  - Teacher 端与 Student 端：侧边栏清爽规范，仅保留“首页”与各自对应的专属业务工作台。

---

### 2. 修复用户管理页面重置操作 TypeError 异常及右侧布局留白 (BUG-03)

- **涉及文件**：
  - `build_ui/src/views/system/user/index.vue`
- **代码改动**：
  1. 修复空指针：由于部门树 `<el-tree ref="tree">` 被前端注释保留，但在脚本中存在调用，因此对 `this.$refs.tree` 增加了安全判空：
     ```javascript
     // watch.deptName
     deptName(val) {
       if (this.$refs.tree) {
         this.$refs.tree.filter(val);
       }
     }

     // methods.resetQuery
     resetQuery() {
       this.dateRange = [];
       this.resetForm("queryForm");
       this.queryParams.deptId = undefined;
       if (this.$refs.tree) {
         this.$refs.tree.setCurrentKey(null);
       }
       this.handleQuery();
     }
     ```
  2. 修复栅格间隙：将表格外层 `<el-col :span="20" :xs="24">` 调整为 `<el-col :span="24">`，使表格和检索栏铺满整个右侧视口，消除此前右侧 1/6 的空白不对称现象。
- **验证结果**：
  - 在用户管理页面输入条件并点击“重置”按钮，控制台 0 异常，数据列表平滑刷新重置，表格填满 24 栅格宽度。

---

### 3. 规范学员/教师全链路性别代码转义展示 (BUG-04)

- **涉及文件**：
  - `build_ui/src/views/train/student/index.vue`
  - `build_ui/src/views/train/teacher/index.vue`
  - `build_ui/src/views/train/me/student/index.vue`
  - `build_ui/src/views/train/me/teacher/index.vue`
- **代码改动**：
  统一编写并复用 `formatGender` 转义逻辑：
  ```javascript
  formatGender(gender) {
    if (gender === '0' || gender === 0 || gender === '男') return '男';
    if (gender === '1' || gender === 1 || gender === '女') return '女';
    return gender || '未知';
  }
  ```
  并将表格中的静态绑定 `<el-table-column prop="sGender" />` 替换为具名插槽模板渲染 `<template slot-scope="scope"><span>{{ formatGender(scope.row.sGender) }}</span></template>`。
- **验证结果**：
  - `/person/student` 列表所有行性别规范显示为“男”或“女”；
  - `/student` 学员中心基本资料性别显示为“女”；
  - `/person/teacher` 与 `/teacher` 均完成空值与代码回退兼容。

---

### 4. 优化教师工作台任教培训班数据对齐与状态呈现 (BUG-05)

- **涉及文件**：
  - `build_ui/src/views/train/me/teacher/index.vue`
- **代码改动**：
  1. 状态列字段容错：`<el-tag size="mini" :type="formatPlanStatusType(scope.row.planStatus != null ? scope.row.planStatus : scope.row.status)">{{ formatPlanStatusText(scope.row.planStatus != null ? scope.row.planStatus : scope.row.status) }}</el-tag>`
  2. 日期格式化：使用内置 `parseTime(scope.row.startDate || scope.row.startTime, '{y}-{m}-{d}')`；
  3. 扩充状态字典：
     ```javascript
     formatPlanStatusText(status) {
       const map = {
         0: '未开班', '0': '未开班',
         1: '培训中', '1': '培训中',
         2: '已结训', '2': '已结训',
         3: '已取消', '3': '已取消'
       };
       return map[status] || '未知';
     }
     ```
- **验证结果**：
  - 教师工作台“我的培训班”列表中，各班级状态统一精准渲染为“未开班”绿色/灰色徽章，开班时间格式化为有效标准日期，彻底杜绝了“未知”状态。

---

### 5. 编译代理增强 (开发态验证工具)

- **涉及文件**：
  - `build_ui/vue.config.js`
- **代码改动**：
  在 `devServer.proxy` 的 `pathRewrite` 中增加对 `process.env.VUE_APP_BACKEND_PATH` 的支持，使得本地开发服务器在直连远程 Nginx 共享试用环境时，可灵活重写为 `/prod-api`，确保本地前后端联调测试真实生效。