serv init

schoolNewsServ/api/api-system/pom.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+          <groupId>org.xyzh</groupId>
+          <artifactId>api</artifactId>
+          <version>${school-news.version}</version>
+    </parent>
+
+    <groupId>org.xyzh</groupId>
+    <artifactId>api-system</artifactId>
+    <version>${school-news.version}</version>
+
+    <properties>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+    </properties>
+
+</project>

schoolNewsServ/api/api-system/src/main/java/org/xyzh/api/system/menu/MenuService.java

@@ -0,0 +1,111 @@
+package org.xyzh.api.system.menu;
+
+import java.util.List;
+
+import org.xyzh.common.core.page.PageParam;
+import org.xyzh.common.dto.menu.TbSysMenu;
+
+/**
+ * @description    MenuRemoteService.java文件描述 菜单远程服务接口
+ * @filename    MenuRemoteService.java
+ * @author    yslg
+ * @copyright xyzh
+ * @since 2025-09-26
+ */
+public interface MenuService {
+
+    /**
+     * @description   添加菜单
+     * @param    menu 菜单对象
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void addMenu(TbSysMenu menu);
+
+    /**
+     * @description    更新菜单
+     * @param    menu 菜单对象
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void updateMenu(TbSysMenu menu);
+
+    /**
+     * @description    删除菜单
+     * @param    menuID 菜单ID
+     * @param    deep 是否深度删除（删除该菜单及其所有子菜单）
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void deleteMenu(String menuID, boolean deep);
+
+    /**
+     * @description    导入菜单
+     * @param    menus 菜单列表
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void importMenus(List<TbSysMenu> menus);
+
+    /**
+     * @description    导出菜单
+     * @param    filter 菜单对象
+     * @return    菜单列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysMenu> exportMenus(TbSysMenu filter);
+
+    /**
+     * @description    查找菜单
+     * @param    menu 菜单对象
+     * @return    菜单对象
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    TbSysMenu find(TbSysMenu filter);
+
+    /**
+     * @description    分页查找菜单
+     * @param    menu 菜单对象
+     * @param    pageParam 分页参数
+     * @return    菜单列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysMenu> findPageMenus(TbSysMenu menu, PageParam pageParam);
+
+    /**
+     * @description    根据菜单ID列表查找菜单
+     * @param    menuIDs 菜单ID列表
+     * @return    菜单列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysMenu> findByIDs(List<String> menuIDs);
+    
+    /**
+     * @description    查找子菜单
+     * @param    parentID 父菜单ID
+     * @return    子菜单列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysMenu> findChildListByParentID(String parentID);
+
+    /**
+     * @description    查找所有菜单
+     * @return    菜单列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysMenu> findAll();
+
+    List<TbSysMenu> permissionMenus(List<String> permissionIDList);
+
+
+}

schoolNewsServ/api/api-system/src/main/java/org/xyzh/api/system/permission/PermissionService.java

@@ -0,0 +1,117 @@
+package org.xyzh.api.system.permission;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Set;
+
+import org.xyzh.common.dto.permission.TbSysPermission;
+
+/**
+ * @description    PermissionRemoteService.java文件描述 权限远程服务接口
+ * @filename    PermissionRemoteService.java
+ * @author    yslg
+ * @copyright xyzh
+ * @since 2025-09-26
+ */
+public interface PermissionService {
+
+	/**
+     * @description    添加权限
+     * @param    permission 权限对象
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	void addPermission(TbSysPermission permission);
+
+	/**
+     * @description    更新权限
+     * @param    permission 权限对象
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	void updatePermission(TbSysPermission permission);
+
+	/**
+     * @description    删除权限
+     * @param    permissionID 权限ID
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	void deletePermission(String permissionID);
+
+	/**
+     * @description    批量导入权限
+     * @param    permissions 权限列表
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	void importPermissions(List<TbSysPermission> permissions);
+
+	/**
+     * @description    条件导出权限
+     * @param    filter 权限对象
+     * @return    权限列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	List<TbSysPermission> exportPermissions(TbSysPermission filter);
+
+	/**
+     * @description    权限ID查询
+     * @param    permissionID 权限ID
+     * @return    权限对象
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	TbSysPermission findByID(String permissionID);
+
+	/**
+     * @description    批量权限ID查询
+     * @param    permissionIDs 权限ID列表
+     * @return    权限对象列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	List<TbSysPermission> findByIDs(Collection<String> permissionIDs);
+
+	/**
+     * @description    根据用户ID查询用户权限集合
+     * @param    userID 用户ID
+     * @return    权限集合
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	Set<TbSysPermission> findUserPermissions(String userID);
+
+    /**
+     * @description    根据角色ID查询角色权限集合
+     * @param    roleID 角色ID
+     * @return    权限集合
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    Set<TbSysPermission> findRolePermissions(String roleID);
+
+    /**
+     * @description    根据角色ID列表查询角色权限集合
+     * @param    roleIDList 角色ID列表
+     * @return    权限集合
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    Set<TbSysPermission> findRolesPermissions(List<String> roleIDList);
+
+    /**
+     * @description    判断用户是否拥有某个权限
+     * @param    userID 用户ID
+     * @param    permissionCode 权限编码
+     * @return    true-拥有；false-不拥有
+     * @author    yslg
+     * @since 2025-09-27
+     */
+	boolean hasPermission(String userID, String permissionCode);
+}

schoolNewsServ/api/api-system/src/main/java/org/xyzh/api/system/role/RoleService.java

@@ -0,0 +1,88 @@
+package org.xyzh.api.system.role;
+
+import java.util.Collection;
+import java.util.List;
+import org.xyzh.common.dto.role.TbSysRole;
+
+
+/**
+ * @description    RoleRemoteService.java文件描述 角色远程服务接口
+ * @filename    RoleRemoteService.java
+ * @author    yslg
+ * @copyright xyzh
+ * @since 2025-09-26
+ */
+public interface RoleService {
+
+    /**
+     * @description    添加角色
+     * @param    role 角色对象
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void addRole(TbSysRole role);
+
+    /**
+     * @description    更新角色
+     * @param    role 角色对象
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void updateRole(TbSysRole role);
+
+    /**
+     * @description    删除角色
+     * @param    roleID 角色ID
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void deleteRole(String roleID);
+
+    /**
+     * @description    批量导入角色
+     * @param    roles 角色列表
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void importRoles(List<TbSysRole> roles);
+
+    /**
+     * @description    条件导出角色
+     * @param    filter 角色对象
+     * @return    角色列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysRole> exportRoles(TbSysRole filter);
+
+    /**
+     * @description    通过主键查找
+     * @param    roleID 角色ID
+     * @return    角色对象
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    TbSysRole findByID(String roleID);
+
+    /**
+     * @description    批量通过主键查找
+     * @param    roleIDs 角色ID集合
+     * @return    角色列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysRole> findByIDs(Collection<String> roleIDs);
+
+    /**
+     * @description    根据用户ID查询用户角色列表
+     * @param    userID 用户ID
+     * @return    角色列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysRole> findUserRoleList(String userID);
+}

schoolNewsServ/api/api-system/src/main/java/org/xyzh/api/system/user/UserService.java

@@ -0,0 +1,88 @@
+package org.xyzh.api.system.user;
+
+import java.util.Collection;
+import java.util.List;
+
+import org.xyzh.common.dto.user.TbSysUser;
+
+/**
+ * @description    UserRemoteService.java文件描述   用户远程服务接口
+ * @filename    UserRemoteService.java
+ * @author    yslg
+ * @copyright xyzh
+ * @since 2025-09-26
+ */
+public interface UserService {
+
+    /**
+     * @description    添加用户
+     * @param    user 用户对象
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void addUser(TbSysUser user);
+
+    /**
+     * @description    更新用户
+     * @param    user 用户对象
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void updateUser(TbSysUser user);
+
+    /**
+     * @description    删除用户（逻辑或物理取决于实现）
+     * @param    userId 用户ID
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void deleteUser(String userID);
+
+    /**
+     * @description    批量导入用户
+     * @param    users 用户列表
+     * @return    void
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    void importUsers(List<TbSysUser> users);
+
+    /**
+     * @description    条件导出用户
+     * @param    filter 用户对象
+     * @return    用户列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysUser> exportUsers(TbSysUser filter);
+
+    /**
+     * @description    查找用户
+     * @param    filter 用户对象
+     * @return    用户对象
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    TbSysUser find(TbSysUser filter);
+
+    /**
+     * @description    通过主键集合查找用户列表
+     * @param    userIds 用户ID集合
+     * @return    用户列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysUser> findByIDs(Collection<String> userIDs);
+
+    /**
+     * @description    根据角色ID查询用户列表
+     * @param    roleId 角色ID
+     * @return    用户列表
+     * @author    yslg
+     * @since 2025-09-27
+     */
+    List<TbSysUser> listUsersByRoleID(String roleID);
+}