6.9 KiB
6.9 KiB
会议纪要 - 2026-03-10 | 管理端迁移 Mycontent-temp 菜单/布局讨论
本文件由助理橙子在会议结束后自动生成。
基本信息
- 时间：2026-03-10 15:10
- 议题：管理端改为使用
Mycontent-temp/soul-admin这套“新菜单 + 新布局”规范；基于现有soul-admin功能，明确菜单/布局改造方式与功能适配点 - 触发方式：开个会议研究下
- 参与角色：产品经理、后端开发、管理端开发工程师、小程序开发工程师、测试人员
各角色发言
【产品经理】
- 目标：后台的导航与信息架构要“更运营化”：核心入口更少、更聚焦；次要功能不消失但不占主导航。
- 新规范（以
Mycontent-temp/soul-admin/src/layouts/AdminLayout.tsx为准）：- 侧栏主菜单平铺 5 个：数据概览 / 内容管理 / 用户管理 / 找伙伴 / 推广中心
- 系统设置固定在侧栏下方
- 原「更多」折叠的部分要么隐藏入口（从概览/页面内跳转进入），要么并入系统设置 Tab
- 验收：菜单一致；旧功能可达；用户操作路径更短（尤其内容/找伙伴/推广）。
【后端开发】
- 管理端迁移/重构不改变接口边界：只允许
/api/admin/*、/api/db/*、/api/orders。 - 路由与菜单调整不需要新增后端接口；若概览页需要聚合接口（如
/api/admin/dashboard/overview）可作为“优化项”，同时保留降级方案（用现有 users/orders 拼）。 - 需要注意“路由别名/跳转”不应影响鉴权：
GET /api/admin校验逻辑保持不变。
【管理端开发工程师】
- 新工程的关键差异点：
AdminLayout：取消「更多」折叠，主菜单平铺；/settings永远在底部。- 路由：保留历史页面路由，但不一定在菜单出现；
/author-settings、/admin-users变为Navigate到/settings?tab=author|admin（页面承载搬到 Settings Tab）。
- 迁移策略建议：
- 以
Mycontent-temp/soul-admin为“样板/目标态”，把现有soul-admin中已实现的页面与功能对齐过去（或反向：把目标态布局/菜单 port 回现有项目）。 - 保持路由路径尽量不变（避免大量链接/收藏失效），通过菜单“入口收敛”达成产品目标。
- 以
【小程序开发工程师】
- 小程序侧只关心“内容编辑产物能否稳定下发/解析”，管理端菜单迁移不应改变内容接口或字段。
- 若管理端页面拆分导致内容结构改动（例如富文本 HTML、mention/tag 的数据结构），必须提前同步小程序解析策略并回归阅读页兼容。
【测试人员】
- 重点回归点：
- 路由可达性：菜单入口虽减少，但旧页面必须仍能通过路由访问（尤其订单/提现/推广设置/导师等）。
- 鉴权：任意页面刷新后均能正确校验 token 并跳转登录（
GET /api/admin）。 - 信息架构一致：侧栏 5 项 + 系统设置固定位置；
author/admin设置从/settings的 tab 进入。
讨论过程
- 对照了两套工程：
- 旧
soul-admin：主菜单 3 项 + 「更多」折叠（VIP角色/作者详情/管理员/导师/导师预约/推广中心/找伙伴/匹配记录/推广设置） - 新
Mycontent-temp/soul-admin：主菜单 5 项平铺（概览/内容/用户/找伙伴/推广），系统设置固定；作者/管理员并入 Settings Tabs；其余页面保持路由但不占侧栏入口
- 旧
- 达成一致：以新工程布局/菜单为准，旧功能以“路由可达 + 概览/页面内跳转”方式保留。
会议决议
- 目标态以
Mycontent-temp/soul-admin为准：菜单与布局“照新不照旧”，旧工程如需改造则对齐该实现。 - 侧栏信息架构：
- 主菜单固定 5 项：数据概览、内容管理、用户管理、找伙伴、推广中心
- 系统设置固定在侧栏底部
- 取消「更多」折叠入口
- 功能入口收敛规则：
author-settings、admin-users不再作为独立菜单项，统一并入/settings?tab=author|admin- 订单/提现/推广设置/VIP角色/导师等页面：保留路由，但入口不进入侧栏主菜单（可由概览卡片、页面内按钮或系统设置进入）
- 接口与边界不变：管理端继续只调用
/api/admin/*、/api/db/*、/api/orders，不得引入/api/miniprogram/*。 - 待确认项：
- 哪些“非主菜单页面”需要在概览页提供快捷入口（订单、提现、推广设置等）的优先级排序。
待办事项
| 责任角色 | 任务 | 优先级 | 截止建议 |
|---|---|---|---|
| 管理端开发工程师 | 基于 Mycontent-temp/soul-admin 梳理：侧栏主菜单 5 项、Settings Tab 承载 author/admin、其余页面入口方案（概览卡片/页面内跳转） |
高 | 2026-03-11 |
| 产品经理 | 给出“非主菜单页面”的入口优先级（概览要露出哪些快捷卡片/按钮） | 中 | 2026-03-11 |
| 后端开发 | 确认概览聚合接口 /api/admin/dashboard/overview 是否作为正式接口上线；若不上线，确认降级方案字段口径 |
中 | 2026-03-12 |
| 测试人员 | 输出菜单/路由/鉴权回归清单（含隐藏路由可达性） | 中 | 2026-03-12 |
| 小程序开发工程师 | 关注内容编辑产物格式是否变化；若变更，补充阅读页兼容用例 | 低 | 持续 |
问题与作答区
| # | 问题 | 责任角色 | 作答 |
|---|---|---|---|
| 1 | 非主菜单页面（订单/提现/推广设置/VIP角色/导师等）哪些必须在概览页提供快捷入口？ | 产品经理 | （待补充） |
| 2 | Mycontent-temp/soul-admin 是否作为线上唯一管理端工程（替换旧 soul-admin），还是旧工程按新规范改造？ |
团队 | （待补充） |
各角色经验与业务理解更新
产品经理
- 菜单信息架构收敛：主导航只保留运营主链路入口，次要功能“可达但不抢入口”。
后端开发
- 概览聚合接口可以作为优化项，但必须保留降级（users+orders）确保不阻塞前端迁移。
管理端开发工程师
- 迁移以
Mycontent-temp/soul-admin为目标态；作者/管理员并入 Settings Tab；取消“更多”折叠。
小程序开发工程师
- 管理端迁移不应影响小程序接口边界；若内容格式变更需及时同步解析策略并回归。
测试人员
- 菜单减少不等于功能减少：必须覆盖“隐藏路由可达性 + 鉴权跳转 + 新侧栏一致性”。
团队共享
- 统一以
Mycontent-temp/soul-admin的AdminLayout/SettingsPage为“新规范基线”，后续所有菜单/布局调整按该基线执行，避免两套后台并行发散。
会议纪要由助理橙子生成 | 各角色经验已同步至 agent/{角色}/evolution/2026-03-10.md