### 摘要

- 菜单表与接口增加终端维度 `client`(`pc` | `app`),与规范「PC 桌面 / APP 移动端」一致。不改已有授权逻辑。
- 管理端动态路由仅下发 `client=pc`;菜单管理页通过 Tab + 查询参数 `menu_client` 分端维护。
- 种子数据 `sys_menu.json` 为全量 PC 菜单补 `client: pc`,并内置 5 条 APP 顶级目录(首页/同事/打卡/消息/我的),图标使用项目 `src/assets/icons` 内已有名称。

### 后端
- `MenuModel` 增加 `client` 列(默认 `pc`)。
- Schema:`MenuCreateSchema` / `MenuOutSchema` 含 `client`;`MenuQueryParam` 增加 `menu_client` 过滤。
- `menu_request_validator` 校验 `client ∈ {pc,app}`;父子终端一致校验在 `MenuService` 创建/更新中执行。
- `get_current_user_info` 菜单树与角色菜单 ID 仅保留 PC 端,避免 APP 菜单进入 Vue Router。

### 前端
- 菜单管理:PC/APP Tab、`menu_client` 列表参数、表格/详情/表单「终端」、子级继承父级 `client`。
- API 类型与 `MenuClientEnum`;`permission.store` 路由 `meta.client`(可选扩展)。

### 数据库(已有库)
-postgres
```
ALTER TABLE sys_menu ADD COLUMN IF NOT EXISTS client VARCHAR(20) NOT NULL DEFAULT 'pc';
COMMENT ON COLUMN sys_menu.client IS '终端(pc:管理端桌面 app:移动端)';
```

-mysql
```
ALTER TABLE sys_menu ADD COLUMN client VARCHAR(20) NOT NULL DEFAULT 'pc' COMMENT '终端(pc/app)';

```

### 兼容与注意
- 角色授权抽屉仍调用**不带** `menu_client` 的菜单树,可同时勾选 PC 与 APP。不改已有逻辑。
- 仅改种子 JSON 不影响**已有数据**库;已建库需执行 DDL,APP 示例菜单需在库中已存在或通过初始化导入。
This commit is contained in:
luomgf
2026-04-27 14:09:58 +08:00
parent 842d1a5c98
commit d2a4e95357
10 changed files with 594 additions and 195 deletions
@@ -32,6 +32,10 @@ class MenuCreateSchema(BaseModel):
parent_id: int | None = Field(default=None, ge=1, description="父菜单ID")
status: str = Field(default="0", description="是否启用(0:启用 1:禁用)")
description: str | None = Field(default=None, max_length=255, description="描述")
client: Literal["pc", "app"] = Field(
default="pc",
description="终端(pc:管理端桌面 app:移动端)",
)
@model_validator(mode="before")
@classmethod
@@ -53,6 +57,9 @@ class MenuCreateSchema(BaseModel):
values[k] = (
values[k].strip() or None if values[k].strip() == "" else values[k].strip()
)
if "client" in values and isinstance(values["client"], str):
cv = values["client"].strip()
values["client"] = cv if cv in ("pc", "app") else "pc"
# 父ID转整型
if "parent_id" in values and isinstance(values["parent_id"], str):
try:
@@ -124,6 +131,10 @@ class MenuQueryParam:
),
created_id: int | None = Query(None, description="创建人"),
updated_id: int | None = Query(None, description="更新人"),
menu_client: Literal["pc", "app"] | None = Query(
None,
description="管理端 Tab:pc=桌面端菜单 app=移动端菜单;不传则不过滤终端",
),
) -> None:
# 模糊查询字段
self.name = (QueueEnum.like.value, name)
@@ -151,3 +162,6 @@ class MenuQueryParam:
self.created_id = (QueueEnum.eq.value, created_id)
if updated_id:
self.updated_id = (QueueEnum.eq.value, updated_id)
if menu_client in ("pc", "app"):
self.client = (QueueEnum.eq.value, menu_client)