AIDOP_MENU_SEED.md 17 KB
Ai-DOP 规划菜单落地说明
原则：凡要在侧栏或权限里出现的 新菜单，都必须落在 sys_menu（种子 + 菜单管理 可配）；前端只对旧数据做标题/组件等 小范围兼容，不在运行时 整段注入 菜单树。团队约定见仓库 .cursor/rules/project.mdc 中「菜单与侧栏」一节。
因 Cursor 当前为 Plan 模式 时无法直接写入插件/前端源码，请将下方脚本保存后本地执行；或切换到 Agent 模式 让助手自动写入。
做法概览
- 菜单来自
sys_menu种子：在Admin.NET.Plugin.AiDOP中新增类名SysMenuSeedData（与 Core、ApprovalFlow 等一致），框架会把各程序集菜单合并；租户默认菜单逻辑只展开 顶层目录 → 子级 → 再一级，因此结构为 Ai-DOP（顶）→ 一级模块（目录）→ 功能（菜单），共三级。 - 叶子菜单
Component指向官方 Web 占位页/aidop/planning/index；Remark写入[模块|复杂度|人天] 描述（≤256 字），便于后续在菜单管理或页面中对照。 - M11～M16 与框架自带「系统管理 / 平台 / 流程」等存在能力重叠，此处仍按你给的清单生成 规划占位菜单；后续可把
Component改为映射已有页面（如机构管理、字典等），或删掉重复项只保留 M01～M10。
步骤
- 将仓库中
tools/gen_aidop_menu.py保存为文件（内容见下）。 - 执行：
python tools/gen_aidop_menu.py（在ai-dop-platform根目录）。 - 在主库
Web/src/views/aidop/planning/index.vue创建占位页（内容见下）。 - 重启后端，使种子写入/更新
sys_menu；超级管理员若仍看不到新菜单，在 角色管理 中给角色勾选 Ai-DOP 下菜单，或清空库重建（仅开发环境）。
智慧诊断与智慧运营看板（菜单管理可配）
这两项及「智慧运营看板」下子菜单（九宫格、S1～S9 看板、运营指标建模）由 SysMenuSeedData 中的 BuildAidopSmartOpsSeedMenus 写入 sys_menu（固定 Id 段 1320990000201、1320990000200 目录及其子项 1320990000301～1320990000311）。前端 Web/src/utils/aidopMenuDisplay.ts 只对目录标题与个别 component 做覆盖，不再在运行时注入上述菜单，避免与库表重复。
生成器 tools/gen_aidop_menu.py 内已包含 SMART_OPS_SEED_METHOD_LINES，执行 python tools/gen_aidop_menu.py 会一并生成该段 C#，勿再单独维护一份副本。
已有数据库升级后如何看到新菜单
- 部署含新种子的后端 并 重启，让框架执行
ISqlSugarEntitySeedData<SysMenu>的合并逻辑（与你们环境首次建库/初始化一致；若项目有「初始化数据」管理端入口，按其说明执行一次亦可）。插件在Startup.Configure中会执行AidopMenuLinkSync：对已存在于sys_menu的 Ai-DOP 种子 Id，向sys_tenant中全部租户 补sys_tenant_menu；向sys_role_menu中已拥有任一 Ai-DOP 种子菜单 的角色（并始终包含默认系统管理员角色1300000000101）补全缺失项，避免仅写入菜单主表却不在侧栏/菜单管理（按租户筛选）中可见。 - 若当前环境的种子策略是 仅首次插入 且库中已存在旧
sys_menu：新 Id 可能尚未写入，需在 菜单管理 中 手工新增 与种子相同的 Path/Name/Component，或按团队约定的 SQL/运维脚本 补录（以实际种子实现为准）。开启配置EnableIncreSeed: true时，Ai-DOP 的SysMenuSeedData已贴[IncreSeed]，会参与增量种子更新。 - 菜单已在
sys_menu但账号侧栏仍无：在 角色管理 为对应角色勾选 Ai-DOP 下新增项；多租户 时还需确认租户与菜单的关联（如sys_role_menu/ 租户菜单同步）已包含新菜单 Id。
tools/gen_aidop_menu.py
请以主库内 tools/gen_aidop_menu.py 为准（含主库根解析）；在 ai-dop-platform/ 根执行 python tools/gen_aidop_menu.py 即可。下列代码块为说明用摘录，与仓库文件冲突时以仓库为准。
# -*- coding: utf-8 -*-
"""Generate Admin.NET.Plugin.AiDOP SeedData/SysMenuSeedData.cs. Run: python tools/gen_aidop_menu.py"""
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
def _find_aidop_repo_root(ai_dop_platform_dir: Path) -> Path:
for ancestor in [ai_dop_platform_dir.resolve()] + list(ai_dop_platform_dir.resolve().parents):
if (ancestor / "server" / "Admin.NET.sln").is_file():
return ancestor
nested = ancestor / "references" / "Admin.NET" / "server" / "Admin.NET.sln"
if nested.is_file():
return ancestor / "references" / "Admin.NET"
raise RuntimeError("找不到 server/Admin.NET.sln")
OUT = _find_aidop_repo_root(ROOT) / "server/Plugins/Admin.NET.Plugin.AiDOP/SeedData/SysMenuSeedData.cs"
mods = [
("S0", "S0 运营建模", [("数据建模", "支持数据库表结构设计与建模", "高", "5", "核心基础功能"), ("业务建模", "支持业务流程建模与配置", "高", "5", "核心基础功能")]),
("S1", "S1 产销协同", [("订单管理", "销售订单录入、查询、编辑、删除", "中", "3", ""), ("计划管理", "生产计划制定与分解", "中", "3", ""), ("工单管理", "工单创建、分配、跟踪", "中", "3", ""), ("产销协同看板", "订单与生产协同数据可视化", "高", "5", "数据看板类")]),
("S2", "S2 制造协同", [("生产排程", "生产任务排程与调度", "高", "5", ""), ("作业计划", "车间作业计划管理", "中", "3", ""), ("制造协同看板", "制造过程协同数据展示", "高", "5", "数据看板类")]),
("S3", "S3 供应协同", [("物料计划", "物料需求计划(MRP)计算", "高", "7", "核心算法"), ("供应协同看板", "供应商协同数据可视化", "中", "4", "数据看板类")]),
("S4", "S4 采购执行", [("采购管理", "采购申请、订单、合同管理", "中", "4", ""), ("交货管理", "供应商交货跟踪与验收", "中", "3", ""), ("退货管理", "采购退货流程处理", "低", "2", ""), ("采购执行看板", "采购执行数据可视化", "中", "4", "数据看板类")]),
("S5", "S5 物料仓储", [("来料检验", "IQC来料质量检验", "中", "3", ""), ("仓储管理", "仓库入库、出库、调拨", "中", "4", ""), ("库存数据", "库存查询、盘点、调整", "中", "3", ""), ("物料仓储看板", "仓储数据可视化分析", "中", "4", "数据看板类")]),
("S6", "S6 生产执行", [("生产记录管理", "生产过程数据记录", "中", "3", ""), ("过程质量管理", "IPQC过程质量检验", "中", "4", ""), ("设备工装管理", "设备台账、保养、维修", "中", "4", ""), ("生产执行看板", "生产执行数据可视化", "高", "5", "数据看板类")]),
("S7", "S7 成品仓储", [("成品质量管理", "OQC成品质量检验", "中", "3", ""), ("生产入库管理", "成品入库流程", "低", "2", ""), ("成品出库管理", "成品出库发货流程", "低", "2", ""), ("成品库存管理", "成品库存查询与管理", "中", "3", "")]),
("S8", "S8 异常监控", [("异常管理", "生产异常上报、处理、跟踪", "中", "4", "")]),
("S9", "S9 运营指标", [("ERP同步", "与外部ERP系统数据同步", "高", "7", "接口集成"), ("日志查询", "系统操作日志查询", "低", "2", ""), ("ERP事务", "ERP相关事务处理", "中", "3", "")]),
("M11", "系统管理", [("组织架构", "部门、岗位、人员管理", "中", "3", "与框架系统管理对应，后续可映射具体页"), ("菜单管理", "系统菜单权限配置", "中", "3", "")]),
("M12", "流程平台", [("流程管理", "工作流流程定义与配置", "高", "7", "核心引擎"), ("表单管理", "流程表单设计与配置", "高", "5", ""), ("应用设计", "业务应用快速设计", "高", "5", ""), ("数据资源配置", "数据资源连接配置", "中", "4", ""), ("格式化JSON", "JSON数据格式化工具", "低", "1", "工具类"), ("模板管理", "流程模板管理", "中", "3", ""), ("系统按钮", "系统按钮权限配置", "低", "2", ""), ("流程按钮", "流程操作按钮配置", "低", "2", ""), ("应用程序", "外部应用集成管理", "中", "4", ""), ("接口系统", "API接口配置管理", "高", "5", "")]),
("M13", "系统工具", [("数据字典", "系统字典数据管理", "低", "2", ""), ("数据连接", "数据库连接配置", "中", "3", ""), ("首页设置", "系统首页个性化配置", "低", "2", ""), ("日志查询", "系统运行日志查询", "低", "2", ""), ("流水号管理", "业务流水号规则配置", "低", "2", ""), ("工作日设置", "工作日历配置", "低", "1", ""), ("图标库", "系统图标资源管理", "低", "1", ""), ("在线用户", "在线用户监控", "低", "2", ""), ("周库存统计", "库存周期统计报表", "中", "3", "报表类"), ("数据导入", "批量数据导入工具", "中", "3", "")]),
("M14", "流程中心", [("发起流程", "新建并发起工作流程", "中", "3", ""), ("待办事项", "个人待办任务处理", "中", "3", ""), ("待办批量处理", "待办任务批量操作", "中", "3", ""), ("已办事项", "已办任务查询", "低", "2", ""), ("我的流程", "我发起的流程跟踪", "中", "3", ""), ("已委托事项", "委托他人处理的事项", "低", "2", ""), ("流程委托", "流程任务委托配置", "低", "2", ""), ("流程意见", "流程审批意见管理", "低", "2", "")]),
("M15", "个人设置", [("个人信息", "个人资料维护", "低", "1", ""), ("头像设置", "个人头像上传", "低", "1", ""), ("修改密码", "密码修改功能", "低", "1", ""), ("签章管理", "个人电子签章管理", "中", "3", ""), ("文件管理", "个人文件存储管理", "中", "3", ""), ("快捷菜单", "个人快捷方式配置", "低", "1", "")]),
("M16", "系统首页", [("系统首页", "系统门户首页", "中", "3", "门户类"), ("发起流程(快捷)", "首页快捷发起流程", "低", "1", ""), ("我的流程(快捷)", "首页流程快捷入口", "低", "1", ""), ("待办事项(快捷)", "首页待办快捷入口", "低", "1", "")]),
]
def esc(s: str) -> str:
return s.replace("\\", "\\\\").replace('"', '\\"')
def main() -> None:
lines: list[str] = []
lines.append("// Ai-DOP 业务规划菜单种子（由 ai-dop-platform/tools/gen_aidop_menu.py 生成）")
lines.append("")
lines.append("namespace Admin.NET.Plugin.AiDOP;")
lines.append("")
lines.append("/// <summary>")
lines.append("/// Ai-DOP 规划菜单；类名须为 SysMenuSeedData，以便租户默认菜单聚合所有程序集种子。")
lines.append("/// </summary>")
lines.append("public class SysMenuSeedData : ISqlSugarEntitySeedData<SysMenu>")
lines.append("{")
lines.append(" private const long AidopRootId = 1320990000101L;")
lines.append("")
lines.append(" /// <inheritdoc />")
lines.append(" public IEnumerable<SysMenu> HasData()")
lines.append(" {")
lines.append(' var ct = DateTime.Parse("2022-02-10 00:00:00");')
lines.append(" var list = new List<SysMenu>")
lines.append(" {")
lines.append(" new()")
lines.append(" {")
lines.append(" Id = AidopRootId,")
lines.append(" Pid = 0,")
lines.append(' Title = "Ai-DOP",')
lines.append(' Path = "/aidop",')
lines.append(' Name = "aidopRoot",')
lines.append(' Component = "Layout",')
lines.append(' Icon = "ele-Grid",')
lines.append(" Type = MenuTypeEnum.Dir,")
lines.append(" CreateTime = ct,")
lines.append(" OrderNo = 250,")
lines.append(' Remark = "Ai-DOP 主菜单（规划项，叶子为占位页）"')
lines.append(" }")
lines.append(" };")
lines.append("")
lines.append(" var dirSeq = 0;")
lines.append(" var menuSeq = 0;")
lines.append(" foreach (var mod in ModuleDefinitions)")
lines.append(" {")
lines.append(" dirSeq++;")
lines.append(" var dirId = 1321000000000L + dirSeq * 1000L;")
lines.append(" var codeLower = mod.Code.ToLowerInvariant();")
lines.append(" list.Add(new SysMenu")
lines.append(" {")
lines.append(" Id = dirId,")
lines.append(" Pid = AidopRootId,")
lines.append(" Title = mod.L1,")
lines.append(' Path = $"/aidop/{codeLower}",')
lines.append(' Name = $"aidopDir{mod.Code}",')
lines.append(' Component = "Layout",')
lines.append(' Icon = "ele-Folder",')
lines.append(" Type = MenuTypeEnum.Dir,")
lines.append(" CreateTime = ct,")
lines.append(" OrderNo = 260 + dirSeq")
lines.append(" });")
lines.append("")
lines.append(" var subOrder = 100;")
lines.append(" var idx = 0;")
lines.append(" foreach (var leaf in mod.Leaves)")
lines.append(" {")
lines.append(" menuSeq++;")
lines.append(" idx++;")
lines.append(" list.Add(new SysMenu")
lines.append(" {")
lines.append(" Id = 1322000000000L + menuSeq,")
lines.append(" Pid = dirId,")
lines.append(" Title = leaf.Title,")
lines.append(' Path = $"/aidop/{codeLower}/{idx:000}",')
lines.append(' Name = $"aidop{mod.Code}{idx:000}",')
lines.append(' Component = "/aidop/planning/index",')
lines.append(" Type = MenuTypeEnum.Menu,")
lines.append(" CreateTime = ct,")
lines.append(" OrderNo = subOrder++,")
lines.append(' Icon = "ele-Document",')
lines.append(" Remark = BuildRemark(mod.Code, leaf)")
lines.append(" });")
lines.append(" }")
lines.append(" }")
lines.append("")
lines.append(" return list;")
lines.append(" }")
lines.append("")
lines.append(" private static string BuildRemark(string code, (string Title, string Desc, string Complexity, string Days, string Note) leaf)")
lines.append(" {")
lines.append(' var notePart = string.IsNullOrWhiteSpace(leaf.Note) ? "" : $" | {leaf.Note}";')
lines.append(' var s = $"[{code}|{leaf.Complexity}|{leaf.Days}人天] {leaf.Desc}{notePart}";')
lines.append(" return s.Length <= 256 ? s : s[..256];")
lines.append(" }")
lines.append("")
lines.append(" private static readonly (string Code, string L1, (string Title, string Desc, string Complexity, string Days, string Note)[] Leaves)[] ModuleDefinitions =")
lines.append(" {")
for code, l1, leaves in mods:
lines.append(f' ("{esc(code)}", "{esc(l1)}", new[]')
lines.append(" {")
for t, d, cx, day, note in leaves:
lines.append(f' ("{esc(t)}", "{esc(d)}", "{esc(cx)}", "{esc(day)}", "{esc(note)}"),')
lines.append(" }),")
lines.append(" };")
lines.append("}")
OUT.parent.mkdir(parents=True, exist_ok=True)
OUT.write_text("\n".join(lines) + "\n", encoding="utf-8")
print("Wrote", OUT)
if __name__ == "__main__":
main()
说明：一级业务模块编码为 S0～S9（路径 /aidop/s0 … /aidop/s9），展示名称分别为：S0 运营建模、S1 产销协同、S2 制造协同、S3 供应协同、S4 采购执行、S5 物料仓储、S6 生产执行、S7 成品仓储、S8 异常监控、S9 运营指标。M11～M16 仍为平台类菜单，详见 tools/gen_aidop_menu.py。
Web/src/views/aidop/planning/index.vue（主库根相对路径）
在官方 Web 中创建目录 src/views/aidop/planning/，新建 index.vue：
<template>
<div class="aidop-planning-layout">
<el-card shadow="hover">
<template #header>
<span>{{ pageTitle }}</span>
<el-tag type="warning" size="small" class="ml8">规划占位</el-tag>
</template>
<p v-if="pageRemark" class="remark">{{ pageRemark }}</p>
<el-empty v-else description="后续在此接入 Ai-DOP 业务页面" />
</el-card>
</div>
</template>
<script setup lang="ts" name="aidopPlanningIndex">
import { computed } from 'vue';
import { useRoute } from 'vue-router';
const route = useRoute();
const pageTitle = computed(() => (route.meta?.title as string) || 'Ai-DOP');
const pageRemark = computed(() => (route.meta as any)?.remark as string);
</script>
<style scoped lang="scss">
.aidop-planning-layout {
padding: 12px;
}
.ml8 {
margin-left: 8px;
}
.remark {
white-space: pre-wrap;
color: var(--el-text-color-secondary);
margin: 0;
}
</style>
若接口未把 remark 填进 route.meta，页面仍显示 标题；需要展示备注时可在后端 SysMenuMapper 增加 Meta.Remark 映射，或在前端组装路由时写入 meta.remark。