docs(wxcp): 修正默认角色授权条数 14 → 15

liu

2026-09-30 e4de23725189ed120646916a674e228f84e46349

docs(wxcp): 修正默认角色授权条数 14 → 15

实测库中「会员管理」子树为 15 条（根目录 1 + 菜单 3 + 按钮 11），
原注释写的 10 个按钮少了「会员归档」，累计数也就跟着错了。
本次只改注释，SQL 本身按 menu_id 树查询，不受影响。

Co-Authored-By: Claude <noreply@anthropic.com>

 docs/sql/config_export_all_20260929.sql

@@ -11647,7 +11647,7 @@
--       属于「能登录却什么都看不到」的静默故障。
--
-- 授予范围：仅「会员管理」整棵子树（根菜单编号 1075490，定义见 ums_module.sql）。
--           共 14 条 = 根目录 1 + 菜单 3 + 按钮 10，三级全给。
--           共 15 条 = 根目录 1 + 菜单 3 + 按钮 11，三级全给。
--           首页不在这里，也不需要在这里：它是前端静态路由（src/router/routes/modules/
--           dashboard.ts 里的 /analytics），backend 模式下由 generateRoutesByBackend 末尾的
--           return [...options.routes, ...routes] 始终合并进来，任何登录用户都可见。

 docs/sql/wxcp_menu.sql

@@ -103,7 +103,7 @@
-- 为什么用编码不用角色编号：角色编号在本地/测试/生产各库不一致，写死换库就失效。
--
-- 授予范围：仅「会员管理」整棵子树（根菜单编号 1075490，定义见 ums_module.sql）。
--           共 14 条 = 根目录 1 + 菜单 3 + 按钮 10，三级全给。
--           共 15 条 = 根目录 1 + 菜单 3 + 按钮 11，三级全给。
--           首页不在这里，也不需要在这里：它是前端静态路由（src/router/routes/modules/
--           dashboard.ts 里的 /analytics），backend 模式下由 generateRoutesByBackend 末尾的
--           return [...options.routes, ...routes] 始终合并进来，任何登录用户都可见。

 docs/wxcp_login_integration.md

@@ -93,7 +93,7 @@
| 场景 | 规则 |
|------|------|
| 企业微信首次扫码（未绑定） | 自动创建系统用户，用户名为 `wx_` + 8 位随机十六进制，昵称取企业微信昵称，账号状态为启用，随机生成密码（用户无需知晓，仅用于占位） |
| 首次注册后的默认权限 | 绑定角色 `wxcp_user`，**仅授予「会员管理」整棵子树**（根目录 1075490 + 3 个菜单 + 10 个按钮，共 **14 条**；SQL 见 `docs/sql/wxcp_menu.sql` 末尾）。首页不受菜单表控制：它是前端静态路由（`src/router/routes/modules/dashboard.ts` 里的 `/analytics`），backend 模式下由 `generateRoutesByBackend` 末尾的 `return [...options.routes, ...routes]` 始终合并进来，任何登录用户都可见、也无需授权——所以「角色管理」的菜单树里**根本找不到「首页」**，这是正常的，不是漏配。角色缺失时代码只记 warn 日志、不阻断登录，表现为「能进系统但菜单全空」。**另外还要授 4 个首页按钮权限**（`wxcp_menu.sql` 第 5 段）：首页虽然是静态路由人人可见，但它内部会调 `bpm/task/todo-page`、`finance/reimbursement/page`、`research/application/page`、`research/guideline/page` 这 4 个带 `@PreAuthorize` 的接口拉数据，不授就一进首页报「没有权限」。只授按钮、不授上级菜单，不会往侧边栏塞 BPM / 财务 / 科研入口 |
| 首次注册后的默认权限 | 绑定角色 `wxcp_user`，**仅授予「会员管理」整棵子树**（根目录 1075490 + 3 个菜单 + 11 个按钮，共 **15 条**；SQL 见 `docs/sql/wxcp_menu.sql` 末尾）。首页不受菜单表控制：它是前端静态路由（`src/router/routes/modules/dashboard.ts` 里的 `/analytics`），backend 模式下由 `generateRoutesByBackend` 末尾的 `return [...options.routes, ...routes]` 始终合并进来，任何登录用户都可见、也无需授权——所以「角色管理」的菜单树里**根本找不到「首页」**，这是正常的，不是漏配。角色缺失时代码只记 warn 日志、不阻断登录，表现为「能进系统但菜单全空」。**另外还要授 4 个首页按钮权限**（`wxcp_menu.sql` 第 5 段）：首页虽然是静态路由人人可见，但它内部会调 `bpm/task/todo-page`、`finance/reimbursement/page`、`research/application/page`、`research/guideline/page` 这 4 个带 `@PreAuthorize` 的接口拉数据，不授就一进首页报「没有权限」。只授按钮、不授上级菜单，不会往侧边栏塞 BPM / 财务 / 科研入口 |
| 企业微信再次扫码（已绑定） | 直接登录，不创建新用户 |
| 非企业微信的社交平台首次登录 | 仍返回 `1_002_000_005`「未绑定账号，需要进行绑定」，需引导用户走账号密码登录并绑定 |
| 账号密码登录时携带社交参数 | 走原有绑定逻辑，登录成功后该社交账号与账号绑定 |