|
|
|
|
@ -0,0 +1,186 @@
|
|
|
|
|
# 邢远鑫第 13 周学习总结
|
|
|
|
|
|
|
|
|
|
第 13 周(2025-12-15 至 2025-12-21)
|
|
|
|
|
|
|
|
|
|
## 本周完成情况概览
|
|
|
|
|
|
|
|
|
|
### 已完成内容
|
|
|
|
|
|
|
|
|
|
1. **导航与认证体验重构(12/18)**
|
|
|
|
|
|
|
|
|
|
- 顶部导航迁移至侧边栏,新增角色驱动的下拉分组(系统配置/角色权限)
|
|
|
|
|
- 登录/注册页居中与样式优化;通过路由 meta 隐藏侧栏与控制项
|
|
|
|
|
- 认证模块正常化角色;用户信息改用 `/api/v1/users` 接口
|
|
|
|
|
- 后端不可用时提供演示登录(`123/123`)以便联调与演示
|
|
|
|
|
- 涉及文件:`frontend-vue/src/app/App.vue`、`frontend-vue/src/app/components/HeaderNav.vue`、`frontend-vue/src/app/components/Sidebar.vue`、`frontend-vue/src/app/router/index.ts`、`frontend-vue/src/app/stores/auth.ts`、`frontend-vue/src/app/views/Login.vue`、`frontend-vue/src/app/views/Register.vue`、`frontend-vue/src/app/views/Profile.vue`
|
|
|
|
|
|
|
|
|
|
2. **诊断页与 AI 联动(12/18)**
|
|
|
|
|
|
|
|
|
|
- 集成后端诊断聊天历史/发送能力,提升错误信息细节展示
|
|
|
|
|
- 侧边栏筛选能力增强,支持通过 CSS 变量调整宽度;标签/选择垂直对齐
|
|
|
|
|
- 布局与间距抛光,提升可读性与操作体验
|
|
|
|
|
- 涉及文件:`frontend-vue/src/app/views/Diagnosis.vue`、`frontend-vue/src/app/components/Sidebar.vue`
|
|
|
|
|
|
|
|
|
|
3. **集群列表操作增强(12/18)**
|
|
|
|
|
|
|
|
|
|
- 移除 UUID 列,新增详情/启动/停止/注销操作入口
|
|
|
|
|
- 用户管理页支持内联角色选择,创建用户新增密码与确认字段
|
|
|
|
|
- 清理过时页面与侧边栏链接(删除 `RoleAssignment.vue`、`PermissionPolicy.vue`)
|
|
|
|
|
- 涉及文件:`frontend-vue/src/app/views/ClusterList.vue`、`frontend-vue/src/app/views/UserManagement.vue`、`frontend-vue/src/app/router/index.ts`
|
|
|
|
|
|
|
|
|
|
4. **联调文档与注册逻辑优化(12/18, 12/21)**
|
|
|
|
|
|
|
|
|
|
- 编写并更新后端联调指南(`AI-Backend-Integration.md`、`BACKEND_INTEGRATION.md`)
|
|
|
|
|
- 调整为 `backend_register_cluster_guide.md`,补充 SSH 参数与注册流程说明
|
|
|
|
|
- 涉及文件:`backend_register_cluster_guide.md`(新增/更新)
|
|
|
|
|
|
|
|
|
|
5. **稳定性修复(12/21)**
|
|
|
|
|
|
|
|
|
|
- 修复集群注册时节点列表不显示问题,改用 `ref` 与 `watch` 保持数据联动
|
|
|
|
|
- 错误信息展示采用红色高亮并支持多行详情
|
|
|
|
|
- 为 `nodes.map` 运行时错误补充中文提示,提升可理解性
|
|
|
|
|
- 涉及文件:`frontend-vue/src/app/views/ClusterList.vue`
|
|
|
|
|
|
|
|
|
|
6. **组件与仪表优化(12/21)**
|
|
|
|
|
- 修正 CPU/Memory 图表尺寸与状态色;对 `ExecLogsTable` 等组件进行小幅优化
|
|
|
|
|
- 多视图与侧边栏进行联动抛光,减少视觉与交互不一致
|
|
|
|
|
- 涉及文件:`frontend-vue/src/app/components/CpuChart.vue`、`frontend-vue/src/app/components/MemoryChart.vue`、`frontend-vue/src/app/components/ExecLogsTable.vue`、多处视图
|
|
|
|
|
|
|
|
|
|
## 关键改动细节与文件映射
|
|
|
|
|
|
|
|
|
|
- 导航迁移与角色分组
|
|
|
|
|
- 路由:`frontend-vue/src/app/router/index.ts`(使用 `meta` 控制登录/注册隐藏侧栏与控件)
|
|
|
|
|
- 侧栏:`frontend-vue/src/app/components/Sidebar.vue`(新增角色驱动分组与下拉)
|
|
|
|
|
- 顶部导航:`frontend-vue/src/app/components/HeaderNav.vue`(主导航下沉至侧栏后保留必要入口)
|
|
|
|
|
- 认证与用户信息
|
|
|
|
|
- 认证状态与角色:`frontend-vue/src/app/stores/auth.ts`(角色规范化与演示登录兜底)
|
|
|
|
|
- 用户信息来源更新:`frontend-vue/src/app/views/Profile.vue`(改用 `/api/v1/users`)
|
|
|
|
|
- 登录/注册页:`frontend-vue/src/app/views/Login.vue`、`frontend-vue/src/app/views/Register.vue`(居中布局与控件显隐)
|
|
|
|
|
- 诊断与 AI 联动
|
|
|
|
|
- 历史与发送:`frontend-vue/src/app/views/Diagnosis.vue`(整合后端接口,错误详情增强)
|
|
|
|
|
- 侧边筛选与布局:`frontend-vue/src/app/components/Sidebar.vue`(通过 CSS 变量调整宽度,控件垂直对齐)
|
|
|
|
|
- 集群管理与操作
|
|
|
|
|
- 列与操作入口:`frontend-vue/src/app/views/ClusterList.vue`(移除 UUID 列,新增详情/启动/停止/注销)
|
|
|
|
|
- 用户管理:`frontend-vue/src/app/views/UserManagement.vue`(内联角色选择;创建页新增密码与确认)
|
|
|
|
|
- 路由与页面清理:`frontend-vue/src/app/router/index.ts`、删除 `RoleAssignment.vue`、`PermissionPolicy.vue`
|
|
|
|
|
- 稳定性修复与错误处理
|
|
|
|
|
- 节点列表联动:`frontend-vue/src/app/views/ClusterList.vue`(使用 `ref` 与 `watch` 保持数据同步)
|
|
|
|
|
- 错误展示:`frontend-vue/src/app/views/ClusterList.vue`(红色高亮与多行详情;`nodes.map` 中文提示)
|
|
|
|
|
- 组件与仪表
|
|
|
|
|
- 图表尺寸与状态色:`frontend-vue/src/app/components/CpuChart.vue`、`frontend-vue/src/app/components/MemoryChart.vue`
|
|
|
|
|
- 执行日志表格抛光:`frontend-vue/src/app/components/ExecLogsTable.vue`
|
|
|
|
|
- 联调文档
|
|
|
|
|
- 后端联调:`backend_register_cluster_guide.md`(整合 SSH 参数与注册流程说明)
|
|
|
|
|
- 历史文档:`AI-Backend-Integration.md`、`BACKEND_INTEGRATION.md`(已合并/重命名)
|
|
|
|
|
|
|
|
|
|
## 接口与路由调整要点
|
|
|
|
|
|
|
|
|
|
- 接口
|
|
|
|
|
- 用户信息接口统一为 `GET /api/v1/users`,替代此前个人信息接口
|
|
|
|
|
- 诊断聊天接入历史记录与发送接口,错误细节呈现增强
|
|
|
|
|
- 路由与显示控制
|
|
|
|
|
- 通过 `route.meta` 控制登录/注册页的侧栏与顶栏显隐
|
|
|
|
|
- 角色常量驱动侧栏分组与链接显示,路由与页面保持一致
|
|
|
|
|
|
|
|
|
|
## 文件变更清单(你名下,12/18 与 12/21)
|
|
|
|
|
|
|
|
|
|
- 12/18
|
|
|
|
|
- `frontend-vue/src/app/components/CpuChart.vue`
|
|
|
|
|
- `frontend-vue/src/app/components/MemoryChart.vue`
|
|
|
|
|
- `frontend-vue/src/app/components/Sidebar.vue`
|
|
|
|
|
- `frontend-vue/src/app/stores/auth.ts`
|
|
|
|
|
- `frontend-vue/src/app/views/ClusterList.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/Dashboard.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/Diagnosis.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/Login.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/Profile.vue`
|
|
|
|
|
- `frontend-vue/src/app/App.vue`
|
|
|
|
|
- `frontend-vue/src/app/components/HeaderNav.vue`
|
|
|
|
|
- `frontend-vue/src/app/router/index.ts`
|
|
|
|
|
- `frontend-vue/src/app/views/Register.vue`
|
|
|
|
|
- 12/21
|
|
|
|
|
- `frontend-vue/src/app/views/ClusterList.vue`
|
|
|
|
|
- `frontend-vue/src/app/components/CpuChart.vue`
|
|
|
|
|
- `frontend-vue/src/app/components/ExecLogsTable.vue`
|
|
|
|
|
- `frontend-vue/src/app/components/HeaderNav.vue`
|
|
|
|
|
- `frontend-vue/src/app/components/MemoryChart.vue`
|
|
|
|
|
- `frontend-vue/src/app/components/Sidebar.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/AlertConfig.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/AuditLogs.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/Dashboard.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/Diagnosis.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/ExecLogs.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/Login.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/Logs.vue`
|
|
|
|
|
- `frontend-vue/src/app/views/UserManagement.vue`
|
|
|
|
|
- `backend_register_cluster_guide.md`
|
|
|
|
|
|
|
|
|
|
### 部分完成/待完善内容
|
|
|
|
|
|
|
|
|
|
1. 集群操作的统一反馈(加载/禁用/错误提示)与状态约束需进一步规范
|
|
|
|
|
2. 诊断页错误与消息中心的统一策略尚未完全落地
|
|
|
|
|
3. 认证与角色的页面级细粒度守卫需要补齐(侧栏/路由双重校验)
|
|
|
|
|
4. 联调文档与前端配置的一致性与版本化管理需加强
|
|
|
|
|
|
|
|
|
|
### 各领域掌握程度评估
|
|
|
|
|
|
|
|
|
|
#### 前端架构与导航
|
|
|
|
|
|
|
|
|
|
- 掌握状态:完成从顶部到侧栏的架构迁移与角色驱动
|
|
|
|
|
- 具体表现:路由 meta 控制、侧栏分组与交互统一
|
|
|
|
|
- 能力描述:能在不影响功能的前提下完成较大范围的架构调整
|
|
|
|
|
|
|
|
|
|
#### 诊断与 AI 集成
|
|
|
|
|
|
|
|
|
|
- 掌握状态:具备历史/发送的基础联调与错误细节处理
|
|
|
|
|
- 具体表现:诊断页交互更顺畅,错误信息更可读
|
|
|
|
|
- 能力描述:能推动前端与后端在诊断链路上的集成与体验提升
|
|
|
|
|
|
|
|
|
|
#### 集群管理与操作
|
|
|
|
|
|
|
|
|
|
- 掌握状态:操作入口与页面联动基本完善
|
|
|
|
|
- 具体表现:新增多项操作与 UI 抛光,修复关键稳定性问题
|
|
|
|
|
- 能力描述:具备功能推进与问题定位能力,需补齐统一状态与反馈
|
|
|
|
|
|
|
|
|
|
#### 文档与联调
|
|
|
|
|
|
|
|
|
|
- 掌握状态:能输出开发/联调指南
|
|
|
|
|
- 具体表现:文档迭代与命名统一,补充 SSH 参数与注册流程说明
|
|
|
|
|
- 能力描述:可支撑团队联调,但需持续保持与后端版本契约一致
|
|
|
|
|
|
|
|
|
|
## 问题分析与反思
|
|
|
|
|
|
|
|
|
|
### 主要收获
|
|
|
|
|
|
|
|
|
|
1. 优先统一导航/权限骨架显著提升整体一致性与扩展性
|
|
|
|
|
2. 诊断与联动链路更顺畅,错误信息与用户反馈更清晰
|
|
|
|
|
3. 小步快跑的组件与样式抛光提升了回归效率与产品质感
|
|
|
|
|
|
|
|
|
|
### 存在不足与改进方向
|
|
|
|
|
|
|
|
|
|
1. 多模块并行迭代带来的状态管理与回归风险需以规范与测试兜底
|
|
|
|
|
2. 错误提示与国际化需要形成统一策略并在组件层落地
|
|
|
|
|
3. 文档与配置需建立稳定的版本标识与更新流程
|
|
|
|
|
|
|
|
|
|
## 下周重点与计划
|
|
|
|
|
|
|
|
|
|
1. 完成权限路由守卫与角色驱动的侧栏控制细粒度落地
|
|
|
|
|
2. 统一集群注册与操作的消息与异常处理策略(含重试与禁用态)
|
|
|
|
|
3. 在诊断页引入消息中心与错误拦截器,沉淀统一反馈机制
|
|
|
|
|
4. 对联调指南进行统一与版本化,抽取公共配置与约束
|
|
|
|
|
5. 补充关键流程的端到端测试与必要单元测试,形成质量闭环
|
|
|
|
|
|
|
|
|
|
## 经验总结与启示
|
|
|
|
|
|
|
|
|
|
1. 导航/权限架构是前端应用的骨架,统一优先级应靠前
|
|
|
|
|
2. 与后端契约变动需要同步更新文档与前端约束,减少灰度不一致
|
|
|
|
|
3. 持续的小批次优化与回归清单结合,能保证节奏与稳定性
|
|
|
|
|
|
|
|
|
|
## 总体评价与展望
|
|
|
|
|
|
|
|
|
|
本周在导航、认证、诊断联动与集群管理方面取得了显著进展,并修复多项稳定性问题,形成初步的联调与配置规范。下周将围绕权限守卫、统一错误处理与测试补齐,持续提升整体可用性与鲁棒性。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
**总结人**:邢远鑫
|
|
|
|
|
**总结时间**:第 13 周末
|