befly 3.17.0 → 3.17.2

package/sql/emailLog.sql

@@ -0,0 +1,20 @@
+CREATE TABLE IF NOT EXISTS `email_log` (
+    `id` BIGINT NOT NULL,
+    `admin_id` BIGINT NOT NULL DEFAULT 0,
+    `username` VARCHAR(100) NOT NULL DEFAULT '',
+    `nickname` VARCHAR(100) NOT NULL DEFAULT '',
+    `to_email` VARCHAR(200) NOT NULL DEFAULT '',
+    `subject` VARCHAR(200) NOT NULL DEFAULT '',
+    `content` TEXT NULL,
+    `cc_email` VARCHAR(500) NOT NULL DEFAULT '',
+    `bcc_email` VARCHAR(500) NOT NULL DEFAULT '',
+    `send_time` BIGINT NOT NULL DEFAULT 0,
+    `send_result` TINYINT NOT NULL DEFAULT 0,
+    `message_id` VARCHAR(200) NOT NULL DEFAULT '',
+    `fail_reason` VARCHAR(500) NOT NULL DEFAULT '',
+    `state` TINYINT NOT NULL DEFAULT 1,
+    `created_at` BIGINT NOT NULL DEFAULT 0,
+    `updated_at` BIGINT NOT NULL DEFAULT 0,
+    `deleted_at` BIGINT NULL DEFAULT NULL,
+    PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/sql/loginLog.sql

@@ -0,0 +1,25 @@
+CREATE TABLE IF NOT EXISTS `login_log` (
+    `id` BIGINT NOT NULL,
+    `admin_id` BIGINT NOT NULL DEFAULT 0,
+    `username` VARCHAR(50) NOT NULL DEFAULT '',
+    `nickname` VARCHAR(50) NOT NULL DEFAULT '',
+    `ip` VARCHAR(50) NOT NULL DEFAULT '',
+    `user_agent` VARCHAR(500) NOT NULL DEFAULT '',
+    `browser_name` VARCHAR(50) NOT NULL DEFAULT '',
+    `browser_version` VARCHAR(50) NOT NULL DEFAULT '',
+    `os_name` VARCHAR(50) NOT NULL DEFAULT '',
+    `os_version` VARCHAR(50) NOT NULL DEFAULT '',
+    `device_type` VARCHAR(20) NOT NULL DEFAULT '',
+    `device_vendor` VARCHAR(50) NOT NULL DEFAULT '',
+    `device_model` VARCHAR(50) NOT NULL DEFAULT '',
+    `engine_name` VARCHAR(50) NOT NULL DEFAULT '',
+    `cpu_architecture` VARCHAR(20) NOT NULL DEFAULT '',
+    `login_time` BIGINT NOT NULL DEFAULT 0,
+    `login_result` TINYINT NOT NULL DEFAULT 0,
+    `fail_reason` VARCHAR(200) NOT NULL DEFAULT '',
+    `state` TINYINT NOT NULL DEFAULT 1,
+    `created_at` BIGINT NOT NULL DEFAULT 0,
+    `updated_at` BIGINT NOT NULL DEFAULT 0,
+    `deleted_at` BIGINT NULL DEFAULT NULL,
+    PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/sql/menu.sql

@@ -0,0 +1,12 @@
+CREATE TABLE IF NOT EXISTS `menu` (
+    `id` BIGINT NOT NULL,
+    `name` VARCHAR(50) NOT NULL DEFAULT '',
+    `path` VARCHAR(150) NOT NULL DEFAULT '',
+    `sort` INT NOT NULL DEFAULT 0,
+    `parent_path` VARCHAR(200) NOT NULL DEFAULT '',
+    `state` TINYINT NOT NULL DEFAULT 1,
+    `created_at` BIGINT NOT NULL DEFAULT 0,
+    `updated_at` BIGINT NOT NULL DEFAULT 0,
+    `deleted_at` BIGINT NULL DEFAULT NULL,
+    PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/sql/operateLog.sql

@@ -0,0 +1,22 @@
+CREATE TABLE IF NOT EXISTS `operate_log` (
+    `id` BIGINT NOT NULL,
+    `admin_id` BIGINT NOT NULL DEFAULT 0,
+    `username` VARCHAR(50) NOT NULL DEFAULT '',
+    `nickname` VARCHAR(50) NOT NULL DEFAULT '',
+    `ip` VARCHAR(50) NOT NULL DEFAULT '',
+    `module` VARCHAR(50) NOT NULL DEFAULT '',
+    `action` VARCHAR(50) NOT NULL DEFAULT '',
+    `method` VARCHAR(10) NOT NULL DEFAULT '',
+    `path` VARCHAR(200) NOT NULL DEFAULT '',
+    `params` TEXT NULL,
+    `result` TINYINT NOT NULL DEFAULT 0,
+    `response` TEXT NULL,
+    `duration` BIGINT NOT NULL DEFAULT 0,
+    `operate_time` BIGINT NOT NULL DEFAULT 0,
+    `remark` VARCHAR(500) NOT NULL DEFAULT '',
+    `state` TINYINT NOT NULL DEFAULT 1,
+    `created_at` BIGINT NOT NULL DEFAULT 0,
+    `updated_at` BIGINT NOT NULL DEFAULT 0,
+    `deleted_at` BIGINT NULL DEFAULT NULL,
+    PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/sql/role.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS `role` (
+    `id` BIGINT NOT NULL,
+    `name` VARCHAR(50) NOT NULL DEFAULT '',
+    `code` VARCHAR(50) NOT NULL DEFAULT '',
+    `description` VARCHAR(200) NOT NULL DEFAULT '',
+    `menus` JSON NULL,
+    `apis` JSON NULL,
+    `sort` INT NOT NULL DEFAULT 0,
+    `state` TINYINT NOT NULL DEFAULT 1,
+    `created_at` BIGINT NOT NULL DEFAULT 0,
+    `updated_at` BIGINT NOT NULL DEFAULT 0,
+    `deleted_at` BIGINT NULL DEFAULT NULL,
+    PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/sql/sysConfig.sql

@@ -0,0 +1,16 @@
+CREATE TABLE IF NOT EXISTS `sys_config` (
+    `id` BIGINT NOT NULL,
+    `name` VARCHAR(50) NOT NULL DEFAULT '',
+    `code` VARCHAR(100) NOT NULL DEFAULT '',
+    `value` TEXT NULL,
+    `value_type` VARCHAR(20) NOT NULL DEFAULT '',
+    `group` VARCHAR(50) NOT NULL DEFAULT '',
+    `sort` INT NOT NULL DEFAULT 0,
+    `is_system` TINYINT NOT NULL DEFAULT 0,
+    `description` VARCHAR(500) NOT NULL DEFAULT '',
+    `state` TINYINT NOT NULL DEFAULT 1,
+    `created_at` BIGINT NOT NULL DEFAULT 0,
+    `updated_at` BIGINT NOT NULL DEFAULT 0,
+    `deleted_at` BIGINT NULL DEFAULT NULL,
+    PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/sync/api.js

@@ -0,0 +1,93 @@
+const API_TABLE_NAME = "beflyApi";
+
+const getApiParentPath = (apiPath) => {
+    const segments = apiPath
+        .split("/")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+
+    // segments 示例：
+    // - /api/app/test/hi -> ["api","app","test","hi"]
+    const take = 3;
+    const parentSegments = segments.slice(0, Math.min(take, segments.length));
+    if (parentSegments.length === 0) return "";
+    return `/${parentSegments.join("/")}`;
+};
+
+const normalizeAuthForDb = (value) => {
+    if (value === false) {
+        return "否";
+    }
+
+    if (Array.isArray(value)) {
+        return value.join(",");
+    }
+    return "是";
+};
+
+export async function syncApi(ctx, apis) {
+    const allDbApis = await ctx.mysql.getAll({
+        table: API_TABLE_NAME,
+        fields: ["id", "path", "parentPath", "name", "auth", "state"],
+        where: { state$gte: 0 }
+    });
+
+    // 给接口根据接口路径进行映射
+    const dbLists = allDbApis.data.lists || [];
+    const existingApiMap = new Map();
+    for (const item of dbLists) {
+        if (!existingApiMap.has(item.path)) {
+            existingApiMap.set(item.path, item);
+        }
+    }
+
+    const insList = [];
+    const updList = [];
+    const scannedPathSet = new Set();
+    for (const api of apis) {
+        scannedPathSet.add(api.apiPath);
+
+        const auth = normalizeAuthForDb(api.auth);
+        const parentPath = getApiParentPath(api.apiPath);
+        const existing = existingApiMap.get(api.apiPath);
+
+        if (existing) {
+            updList.push({
+                id: existing.id,
+                data: {
+                    name: api.name,
+                    path: api.apiPath,
+                    parentPath: parentPath,
+                    auth: auth
+                }
+            });
+            continue;
+        }
+
+        insList.push({
+            name: api.name,
+            path: api.apiPath,
+            parentPath: parentPath,
+            auth: auth
+        });
+    }
+
+    const delIdList = [];
+    for (const item of dbLists) {
+        if (!scannedPathSet.has(item.path)) {
+            delIdList.push(item.id);
+        }
+    }
+
+    if (updList.length > 0) {
+        await ctx.mysql.updBatch(API_TABLE_NAME, updList);
+    }
+
+    if (insList.length > 0) {
+        await ctx.mysql.insBatch(API_TABLE_NAME, insList);
+    }
+
+    if (delIdList.length > 0) {
+        await ctx.mysql.delForceBatch(API_TABLE_NAME, delIdList);
+    }
+}

package/sync/cache.js

@@ -0,0 +1,13 @@
+export async function syncCache(ctx) {
+    // 1) 缓存接口列表
+    await ctx.cache.cacheApis();
+
+    // 2) 缓存菜单列表
+    await ctx.cache.cacheMenus();
+
+    // 3) 重建角色权限缓存（严格模式下要求 role.apis 必须为 pathname 字符串数组）
+    await ctx.cache.cacheRoleApis();
+
+    // 4) 重建角色菜单权限缓存（role.menus 为 menu.path 字符串数组）
+    await ctx.cache.cacheRoleMenus();
+}

package/sync/dev.js

@@ -0,0 +1,171 @@
+import { isNumber } from "../utils/is.js";
+
+export async function syncDev(ctx) {
+    try {
+        const allMenus = await ctx.mysql.getAll({
+            table: "beflyMenu",
+            fields: ["path"],
+            where: { state$gte: 0 },
+            orderBy: ["id#ASC"]
+        });
+
+        const allApis = await ctx.mysql.getAll({
+            table: "beflyApi",
+            fields: ["path"],
+            where: { state$gte: 0 },
+            orderBy: ["id#ASC"]
+        });
+
+        const devRole = await ctx.mysql.getOne({
+            table: "beflyRole",
+            where: { code: "dev", state$gte: 0 }
+        });
+
+        const devAdmin = await ctx.mysql.getOne({
+            table: "beflyAdmin",
+            where: { username: "dev", state$gte: 0 }
+        });
+
+        const menuPaths = [];
+        for (const item of allMenus.data.lists) {
+            menuPaths.push(item.path);
+        }
+
+        const apiPaths = [];
+        for (const item of allApis.data.lists) {
+            apiPaths.push(item.path);
+        }
+
+        const devRoleData = {
+            code: "dev",
+            name: "开发者角色",
+            description: "拥有所有菜单和接口权限的开发者角色",
+            menus: menuPaths,
+            apis: apiPaths,
+            sort: 0
+        };
+
+        if (isNumber(devRole.data.id)) {
+            await ctx.mysql.updData({
+                table: "beflyRole",
+                where: { code: "dev", state$gte: 0 },
+                data: {
+                    name: devRoleData.name,
+                    description: devRoleData.description,
+                    menus: devRoleData.menus,
+                    apis: devRoleData.apis,
+                    sort: devRoleData.sort,
+                    state: 1
+                }
+            });
+        } else {
+            await ctx.mysql.insData({
+                table: "beflyRole",
+                data: devRoleData
+            });
+        }
+
+        const password = ctx.tool.sha256(ctx.tool.sha256(ctx.config.devPassword));
+
+        const devAdminData = {
+            nickname: "开发者",
+            email: ctx.config.devEmail || "dev@qq.com",
+            username: "dev",
+            password: password,
+            roleCode: "dev",
+            roleType: "admin"
+        };
+
+        if (isNumber(devAdmin.data.id)) {
+            await ctx.mysql.updData({
+                table: "beflyAdmin",
+                where: { username: "dev" },
+                data: {
+                    nickname: devAdminData.nickname,
+                    email: devAdminData.email,
+                    password: devAdminData.password,
+                    roleCode: devAdminData.roleCode,
+                    roleType: devAdminData.roleType,
+                    state: 1
+                }
+            });
+        } else {
+            await ctx.mysql.insData({
+                table: "beflyAdmin",
+                data: {
+                    nickname: devAdminData.nickname,
+                    email: devAdminData.email,
+                    username: devAdminData.username,
+                    password: devAdminData.password,
+                    roleCode: devAdminData.roleCode,
+                    roleType: devAdminData.roleType,
+                    state: 1
+                }
+            });
+        }
+
+        const roles = [
+            {
+                code: "user",
+                name: "用户角色",
+                description: "普通用户角色",
+                sort: 1
+            },
+            {
+                code: "admin",
+                name: "管理员角色",
+                description: "管理员角色",
+                sort: 2
+            },
+            {
+                code: "guest",
+                name: "访客角色",
+                description: "访客角色",
+                sort: 3
+            }
+        ];
+
+        for (const roleConfig of roles) {
+            const existingRole = await ctx.mysql.getOne({
+                table: "beflyRole",
+                where: {
+                    code: roleConfig.code,
+                    state$gte: 0
+                }
+            });
+
+            if (existingRole.data?.id) {
+                // 角色存在则强制更新（不做差异判断）
+                await ctx.mysql.updData({
+                    table: "beflyRole",
+                    where: { code: roleConfig.code, state$gte: 0 },
+                    data: {
+                        name: roleConfig.name,
+                        description: roleConfig.description,
+                        sort: roleConfig.sort,
+                        state: 1
+                    }
+                });
+            } else {
+                await ctx.mysql.insData({
+                    table: "beflyRole",
+                    data: {
+                        code: roleConfig.code,
+                        name: roleConfig.name,
+                        description: roleConfig.description,
+                        menus: [],
+                        apis: [],
+                        sort: roleConfig.sort
+                    }
+                });
+            }
+        }
+    } catch (error) {
+        throw new Error("同步开发者数据失败", {
+            cause: error,
+            code: "runtime",
+            subsystem: "sync",
+            operation: "syncDev"
+        });
+    }
+}

package/sync/menu.js

@@ -0,0 +1,99 @@
+export function flattenMenusToDefMap(menus) {
+    // 读取配置菜单：扁平化为 path => { name, sort, parentPath }
+    // - 以 path 为唯一键：后出现的覆盖先出现的（与旧逻辑“同 path 多次同步同一条记录”一致）
+    // parentPath 规则：
+    // 1) 顶级菜单 parentPath 为空
+    // 2) 子级菜单 parentPath 为其父级完整路径
+    const menuDefMap = new Map();
+
+    for (const menu of menus) {
+        const rootPath = menu.path;
+        const children = Array.isArray(menu.children) ? menu.children : [];
+        menuDefMap.set(rootPath, {
+            path: rootPath,
+            name: menu.name,
+            sort: menu.sort,
+            parentPath: "/"
+        });
+
+        if (children.length === 0) {
+            continue;
+        }
+
+        for (const child of children) {
+            const fullPath = rootPath === "/" ? child.path : `${rootPath}${child.path}`;
+            menuDefMap.set(fullPath, {
+                path: fullPath,
+                name: child.name,
+                sort: child.sort,
+                parentPath: rootPath
+            });
+        }
+    }
+
+    return menuDefMap;
+}
+
+export async function syncMenu(ctx, menus) {
+    const menuDefMap = flattenMenusToDefMap(menus);
+
+    // 2) 批量同步（事务内）：按 path diff 执行批量 insert/update/delete
+    // 读取全部菜单
+    const allExistingMenus = await ctx.mysql.getAll({
+        table: "beflyMenu",
+        fields: ["id", "name", "path", "parentPath", "sort", "state"],
+        where: { state$gte: 0 }
+    });
+
+    const existingList = allExistingMenus.data.lists || [];
+
+    const existingMenuMap = new Map();
+    const delIdSet = new Set();
+    for (const record of existingList) {
+        if (!existingMenuMap.has(record.path)) {
+            existingMenuMap.set(record.path, record);
+            delIdSet.add(record.id);
+        }
+    }
+
+    // 2) 一次性算出 insert/update（仅依赖 path diff，不使用 pid，不预生成 id）
+    const updList = [];
+    const insList = [];
+
+    for (const def of menuDefMap.values()) {
+        const existing = existingMenuMap.get(def.path);
+        if (existing) {
+            delIdSet.delete(existing.id);
+            updList.push({
+                id: existing.id,
+                data: {
+                    name: def.name,
+                    path: def.path,
+                    parentPath: def.parentPath,
+                    sort: def.sort
+                }
+            });
+        } else {
+            insList.push({
+                name: def.name,
+                path: def.path,
+                parentPath: def.parentPath,
+                sort: def.sort
+            });
+        }
+    }
+
+    if (updList.length > 0) {
+        await ctx.mysql.updBatch("beflyMenu", updList);
+    }
+
+    if (insList.length > 0) {
+        await ctx.mysql.insBatch("beflyMenu", insList);
+    }
+
+    // 3) 删除差集（DB - 配置）
+    const delIds = Array.from(delIdSet);
+    if (delIds.length > 0) {
+        await ctx.mysql.delForceBatch("beflyMenu", delIds);
+    }
+}

package/tables/admin.json

@@ -0,0 +1,56 @@
+{
+    "nickname": {
+        "name": "昵称",
+        "input": "string",
+        "min": 1,
+        "max": 50
+    },
+    "username": {
+        "name": "用户名",
+        "input": "@alphanumeric_",
+        "min": 2,
+        "max": 30
+    },
+    "password": {
+        "name": "密码",
+        "input": "string",
+        "min": 6,
+        "max": 500
+    },
+    "email": {
+        "name": "邮箱",
+        "input": "@email",
+        "max": 100
+    },
+    "phone": {
+        "name": "手机号",
+        "input": "@phone",
+        "max": 20
+    },
+    "avatar": {
+        "name": "头像",
+        "input": "string",
+        "max": 500
+    },
+    "roleCode": {
+        "name": "角色编码",
+        "input": "@alphanumeric_",
+        "min": 2,
+        "max": 50
+    },
+    "roleType": {
+        "name": "角色类型",
+        "input": "admin|user",
+        "min": 4,
+        "max": 5
+    },
+    "lastLoginTime": {
+        "name": "最后登录时间",
+        "input": "number"
+    },
+    "lastLoginIp": {
+        "name": "最后登录IP",
+        "input": "string",
+        "max": 50
+    }
+}

package/tables/api.json

@@ -0,0 +1,26 @@
+{
+    "name": {
+        "name": "接口名称",
+        "input": "string",
+        "min": 2,
+        "max": 100
+    },
+    "auth": {
+        "name": "是否需要登录",
+        "input": "string",
+        "min": 1,
+        "max": 200
+    },
+    "path": {
+        "name": "接口路径",
+        "input": "string",
+        "min": 1,
+        "max": 200
+    },
+    "parentPath": {
+        "name": "父级路径",
+        "input": "string",
+        "min": 1,
+        "max": 200
+    }
+}

package/tables/dict.json

@@ -0,0 +1,30 @@
+{
+    "typeCode": {
+        "name": "字典类型代码",
+        "input": "@alphanumeric_",
+        "min": 2,
+        "max": 50
+    },
+    "key": {
+        "name": "字典键",
+        "input": "@alphanumeric_",
+        "min": 1,
+        "max": 50
+    },
+    "label": {
+        "name": "字典标签",
+        "input": "string",
+        "min": 1,
+        "max": 100
+    },
+    "sort": {
+        "name": "排序",
+        "input": "number",
+        "max": 9999
+    },
+    "remark": {
+        "name": "备注",
+        "input": "string",
+        "max": 200
+    }
+}

package/tables/dictType.json

@@ -0,0 +1,24 @@
+{
+    "code": {
+        "name": "类型代码",
+        "input": "@alphanumeric_",
+        "min": 2,
+        "max": 50
+    },
+    "name": {
+        "name": "类型名称",
+        "input": "string",
+        "min": 2,
+        "max": 50
+    },
+    "description": {
+        "name": "描述",
+        "input": "string",
+        "max": 200
+    },
+    "sort": {
+        "name": "排序",
+        "input": "number",
+        "max": 9999
+    }
+}