提交

docs/superpowers/specs/2026-08-17-portal-home-todo-list-design.md

@@ -0,0 +1,35 @@
+# 门户首页「待办列表」汇总入口
+
+## 背景与目标
+
+门户首页（`web-admin/src/views/portal/home/index.vue`）已对部分菜单卡片展示右上角数字角标，但分散在各一级模块中，用户需逐个翻找。目标：在侧栏「收藏」下方增加虚拟分类 **「待办列表」**，集中展示当前有待办的菜单入口。
+
+## 已确认决策
+
+| 项 | 决策 |
+|----|------|
+| 展示范围 | 仅角标数量 > 0 的菜单（方案 B） |
+| 与原模块关系 | 两边都有；待办列表为汇总，原模块卡片不变（方案 A） |
+| 卡片排序 | 按角标数量降序；相同则按标题（zh） |
+| 侧栏数字 | **角标数字总和**（>99 显示 `99+`） |
+| 实现形态 | 侧栏虚拟模块（非独立路由） |
+| 后端 | 不新增接口；复用 `refreshMenuBadges` + CRM 报价/合同 pending |
+
+## 角标来源（与现网一致）
+
+- 统一体系：`MENU_BADGE_CODES`（PL / BX / workflow）
+- 首页单独：报价单审批、合同审批（`PENDING_CARD_RULES`）
+
+## SHALL
+
+1. 侧栏顺序：收藏 → **待办列表** → 各一级业务模块。
+2. 待办列表仅列出当前用户可见且 `pendingCount > 0` 的卡片；空态文案「暂无待办」。
+3. 卡片交互与模块页一致（进入、角标、星标收藏）。
+4. 侧栏「待办列表」右侧数字为各待办卡片角标之和（格式化同卡片）。
+5. 不改侧栏业务菜单树、不改角标拉取 API。
+
+## 非目标
+
+- 不把 CRM 角标并入侧栏 `menu-badge` 体系（仍仅首页拉取）。
+- 不隐藏原模块内同名卡片。
+- 不做拖拽排序（待办顺序由数量决定）。