soul-yongping/.cursor/agent/管理端开发工程师/evolution/2026-03-10.md

管理端开发工程师 经验记录 - 2026-03-10

会议结论：管理端迁移 Mycontent-temp 菜单/布局

• 目标态基线：以 Mycontent-temp/soul-admin 为“新规范基线”，旧 soul-admin 若继续演进则对齐其实现，避免两套后台信息架构发散。
• 菜单信息架构：
  • 侧栏主菜单固定 5 项：数据概览 / 内容管理 / 用户管理 / 找伙伴 / 推广中心
  • 系统设置固定在侧栏底部
  • 取消「更多」折叠入口
• 路由与入口策略：
  • author-settings、admin-users 不再作为独立菜单/页面入口，统一并入 /settings?tab=author|admin
  • 订单/提现/推广设置/VIP角色/导师等页面保留路由可达，但不进入侧栏主菜单；入口通过概览卡片/页面内跳转承载
• 实现抓手：
  • AdminLayout.tsx：用 primaryMenuItems 平铺主菜单；Settings 单独固定
  • App.tsx：对旧路径用 Navigate 做兼容跳转（减少断链风险）

详见会议纪要：.cursor/meeting/2026-03-10_管理端迁移Mycontent-temp菜单布局讨论.md

---

Toast 通知系统全局落地

背景

管理端全部操作反馈使用原生 alert()，体验差、阻断操作流程、需点 OK 才能继续。

解决方案

创建 soul-admin/src/utils/toast.ts（纯原生 DOM 实现，无第三方依赖）：

// 用法
import toast from '@/utils/toast'
toast.success('已保存：标题')   // 绿色，3s 消失
toast.error('保存失败: ...')    // 红色，3s 消失
toast.info('暂无数据')          // 蓝色，3s 消失

全系统替换

使用 PowerShell 批量脚本处理 18 个文件、约 90 处 alert，替换规则：

• 含"失败/错误/请填/不一致/必填" → toast.error()
• 含"成功/已保存/已删除/已创建" → toast.success()
• 其余 → toast.info()

替换后人工复查 toast.info() 调用，修正 5 处语义误判（验证提示类应为 error）。

规则沉淀

1. 管理端禁用 alert()，统一使用 @/utils/toast
2. 新增页面/组件时，操作反馈一律用 toast
3. 批量脚本替换后，必须人工复查 toast.info() 是否有应为 toast.error() 的验证提示
4. toast 自动消失（3s），不阻断流程；若需用户确认，仍使用 confirm()

详见会议纪要：.cursor/meeting/2026-03-10_Toast通知系统全局落地.md