diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/menu/MenuService.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/menu/MenuService.java
new file mode 100644
index 0000000..814ccef
--- /dev/null
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/menu/MenuService.java
@@ -0,0 +1,133 @@
+package com.eip4.platform.metadata.menu;
+
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+/**
+ * 菜单树构建与按权限剪枝的纯逻辑服务(无 Spring 依赖,便于单测)。
+ *
+ *
算法:
+ *
+ * - 从数据库平铺行构建 sys_menu_root → 目录/叶子两级 Map;
+ * - 按用户可见叶子集合自底向上剪枝(目录层:子树内存在可见叶子才保留);
+ * - 没有可见菜单的 root 不下发。
+ *
+ *
+ * 所有数据行由调用方({@link MenuController})以 JDBC 平铺 List 传入,本类不持有任何 bean。
+ */
+public class MenuService {
+
+ /**
+ * 构建按权限裁剪后的菜单根节点列表。
+ *
+ * @param roots sys_menu_root 全量平铺行,每行含 id / name / seq
+ * @param menus sys_menu isactive=1 全量平铺行,每行含 id / name / parentid / menuroot / view_templateid / typename / seq
+ * @param visibleMenuIds 当前用户可见的叶子菜单 id 集合(来自 view_sys_usermenuid)
+ * @return 裁剪后的根节点树,已按 seq 排序,没有可见子节点的根不包含在内
+ */
+ public List