132 lines
6.9 KiB
Markdown
132 lines
6.9 KiB
Markdown
|
# 会议纪要 - 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；其余页面保持路由但不占侧栏入口
|
|||
|
|
- 达成一致：**以新工程布局/菜单为准**，旧功能以“路由可达 + 概览/页面内跳转”方式保留。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 会议决议
|
|||
|
|
|
|||
|
|
1. **目标态以 `Mycontent-temp/soul-admin` 为准**：菜单与布局“照新不照旧”，旧工程如需改造则对齐该实现。
|
|||
|
|
2. **侧栏信息架构**：
|
|||
|
|
- 主菜单固定 5 项：数据概览、内容管理、用户管理、找伙伴、推广中心
|
|||
|
|
- 系统设置固定在侧栏底部
|
|||
|
|
- 取消「更多」折叠入口
|
|||
|
|
3. **功能入口收敛规则**：
|
|||
|
|
- `author-settings`、`admin-users` 不再作为独立菜单项，统一并入 `/settings?tab=author|admin`
|
|||
|
|
- 订单/提现/推广设置/VIP角色/导师等页面：**保留路由**，但入口不进入侧栏主菜单（可由概览卡片、页面内按钮或系统设置进入）
|
|||
|
|
4. **接口与边界不变**：管理端继续只调用 `/api/admin/*`、`/api/db/*`、`/api/orders`，不得引入 `/api/miniprogram/*`。
|
|||
|
|
5. **待确认项**：
|
|||
|
|
- 哪些“非主菜单页面”需要在概览页提供快捷入口（订单、提现、推广设置等）的优先级排序。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 待办事项
|
|||
|
|
|
|||
|
|
| 责任角色 | 任务 | 优先级 | 截止建议 |
|
|||
|
|
|---------|------|--------|---------|
|
|||
|
|
| 管理端开发工程师 | 基于 `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`*
|
|||
|
|
|