befly-tpl 3.2.6 → 3.3.1

package/addons/admin/scripts/syncDev.ts

@@ -1,203 +0,0 @@
-/**
- * 同步开发者管理员到数据库（使用 dbHelper）
- * - 邮箱: dev@qq.com
- * - 姓名: 开发者
- * - 密码: 使用 bcrypt 加密
- * - 角色: roleCode=dev, roleType=admin
- * - 表名: addon_admin_admin
- */
-
-import { Env, Logger, Crypto2, initDatabase, closeDatabase } from 'befly';
-
-// CLI 参数类型
-interface CliArgs {
-    DRY_RUN: boolean;
-}
-
-// 解析命令行参数
-const ARGV = Array.isArray(process.argv) ? process.argv : [];
-const CLI: CliArgs = { DRY_RUN: ARGV.includes('--plan') };
-
-/**
- * 同步开发管理员账号（使用统一的 database 工具）
- * 表名: addon_admin_admin
- * 邮箱: dev@qq.com
- * 用户名: dev
- * 姓名: 开发者
- * 角色: roleCode=dev, roleType=admin
- * @returns 是否成功
- */
-export async function SyncDev(): Promise<boolean> {
-    let dbInitialized = false;
-
-    try {
-        if (CLI.DRY_RUN) {
-            Logger.info('[计划] 同步完成后将初始化/更新开发管理员账号（plan 模式不执行）');
-            return true;
-        }
-
-        if (!Env.DEV_PASSWORD || !Env.MD5_SALT) {
-            Logger.warn('跳过开发管理员初始化：缺少 DEV_PASSWORD 或 MD5_SALT 配置');
-            return false;
-        }
-
-        // 初始化数据库连接（Redis + SQL + DbHelper）
-        const { helper } = await initDatabase({ max: 1 });
-        dbInitialized = true;
-
-        // 检查 addon_admin_admin 表是否存在（使用 helper.query 执行元数据查询）
-        const existAdmin = await helper.tableExists('addon_admin_admin');
-        if (!existAdmin) {
-            Logger.warn('跳过开发管理员初始化：未检测到 addon_admin_admin 表');
-            return false;
-        }
-
-        // 检查 addon_admin_role 表是否存在
-        const existRole = await helper.tableExists('addon_admin_role');
-        if (!existRole) {
-            Logger.warn('跳过开发管理员初始化：未检测到 addon_admin_role 表');
-            return false;
-        }
-
-        // 检查 addon_admin_menu 表是否存在
-        const existMenu = await helper.tableExists('addon_admin_menu');
-        if (!existMenu) {
-            Logger.warn('跳过开发管理员初始化：未检测到 addon_admin_menu 表');
-            return false;
-        }
-
-        // 查询所有菜单 ID
-        const allMenus = await helper.getAll({
-            table: 'addon_admin_menu',
-            fields: ['id']
-        });
-
-        if (!allMenus || !Array.isArray(allMenus)) {
-            Logger.warn('查询菜单失败或菜单表为空');
-            return false;
-        }
-
-        const menuIds = allMenus.length > 0 ? allMenus.map((m: any) => m.id).join(',') : '';
-        Logger.info(`查询到 ${allMenus.length} 个菜单，ID 列表: ${menuIds || '(空)'}`);
-
-        // 查询所有接口 ID
-        const existApi = await helper.tableExists('addon_admin_api');
-        let apiIds = '';
-        if (existApi) {
-            const allApis = await helper.getAll({
-                table: 'addon_admin_api',
-                fields: ['id']
-            });
-
-            if (allApis && Array.isArray(allApis) && allApis.length > 0) {
-                apiIds = allApis.map((a: any) => a.id).join(',');
-                Logger.info(`查询到 ${allApis.length} 个接口，ID 列表: ${apiIds}`);
-            } else {
-                Logger.info('未查询到接口数据');
-            }
-        } else {
-            Logger.info('接口表不存在，跳过接口权限配置');
-        }
-
-        // 查询或创建 dev 角色
-        let devRole = await helper.getOne({
-            table: 'addon_admin_role',
-            where: { code: 'dev' }
-        });
-
-        if (devRole) {
-            // 更新 dev 角色的菜单和接口权限
-            await helper.updData({
-                table: 'addon_admin_role',
-                where: { code: 'dev' },
-                data: {
-                    name: '开发者角色',
-                    description: '拥有所有菜单和接口权限的开发者角色',
-                    menus: menuIds,
-                    apis: apiIds
-                }
-            });
-            Logger.info('dev 角色菜单和接口权限已更新');
-        } else {
-            // 创建 dev 角色
-            const roleId = await helper.insData({
-                table: 'addon_admin_role',
-                data: {
-                    name: '开发者角色',
-                    code: 'dev',
-                    description: '拥有所有菜单和接口权限的开发者角色',
-                    menus: menuIds,
-                    apis: apiIds,
-                    sort: 0
-                }
-            });
-            devRole = { id: roleId };
-            Logger.info('dev 角色已创建');
-        }
-
-        // 使用 bcrypt 加密密码（与登录验证一致）
-        const hashed = await Crypto2.hashPassword(Env.DEV_PASSWORD);
-
-        // 准备开发管理员数据
-        const devData = {
-            name: '开发者',
-            nickname: '开发者',
-            email: 'dev@qq.com',
-            username: 'dev',
-            password: hashed,
-            roleId: devRole.id,
-            roleCode: 'dev',
-            roleType: 'admin' // 小驼峰，自动转换为 role_type
-        };
-
-        // 查询现有账号
-        const existing = await helper.getOne({
-            table: 'addon_admin_admin',
-            where: { email: 'dev@qq.com' }
-        });
-
-        if (existing) {
-            // 更新现有账号
-            await helper.updData({
-                table: 'addon_admin_admin',
-                where: { email: 'dev@qq.com' },
-                data: devData
-            });
-            Logger.info('开发管理员已更新：email=dev@qq.com, username=dev, roleCode=dev, roleType=admin');
-        } else {
-            // 插入新账号
-            await helper.insData({
-                table: 'addon_admin_admin',
-                data: devData
-            });
-            Logger.info('开发管理员已初始化：email=dev@qq.com, username=dev, roleCode=dev, roleType=admin');
-        }
-
-        return true;
-    } catch (error: any) {
-        Logger.warn(`开发管理员初始化步骤出错：${error.message}`);
-        return false;
-    } finally {
-        // 清理资源：关闭所有数据库连接
-        if (dbInitialized) {
-            await closeDatabase();
-        }
-    }
-}
-
-/**
- * 允许直接运行该脚本
- */
-if (import.meta.main) {
-    SyncDev()
-        .then((ok: boolean) => {
-            if (CLI.DRY_RUN) {
-                process.exit(0);
-            }
-            process.exit(ok ? 0 : 1);
-        })
-        .catch((err: Error) => {
-            Logger.error('❌ 开发管理员同步失败:', err);
-            process.exit(1);
-        });
-}

package/addons/admin/scripts/syncMenu.ts

@@ -1,210 +0,0 @@
-#!/usr/bin/env bun
-/**
- * 同步菜单数据到数据库
- * 说明：根据 menu.json 配置文件增量同步菜单数据（最多2级：父级和子级）
- *
- * 流程：
- * 1. 读取 menu.json 配置文件
- * 2. 根据菜单的 path 字段检查是否存在
- * 3. 存在则更新其他字段（name、icon、sort、type、pid）
- * 4. 不存在则新增菜单记录
- * 5. 处理两层菜单结构（父级和子级，不支持多层嵌套）
- * 注：state 字段由框架自动管理（1=正常，2=禁用，0=删除）
- */
-
-import { Env, Logger, initDatabase, closeDatabase } from 'befly';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import menuConfig from '../config/menu.json';
-import { collectPaths, checkTableExists, deleteObsoleteRecords, logSyncStats } from '../util';
-
-// CLI 参数类型
-interface CliArgs {
-    DRY_RUN: boolean;
-}
-
-// 解析命令行参数
-const CLI: CliArgs = {
-    DRY_RUN: process.argv.includes('--plan')
-};
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * 同步菜单（两层结构：父级和子级）
- * @param helper - DbHelper 实例
- * @param menus - 菜单数组
- * @returns 同步统计信息
- */
-async function syncMenus(helper: any, menus: any[]): Promise<{ created: number; updated: number }> {
-    const stats = { created: 0, updated: 0 };
-
-    for (const menu of menus) {
-        try {
-            // 1. 同步父级菜单
-            const existingParent = await helper.getOne({
-                table: 'addon_admin_menu',
-                where: { path: menu.path || '' }
-            });
-
-            let parentId: number;
-
-            if (existingParent) {
-                // 存在则更新
-                await helper.updData({
-                    table: 'addon_admin_menu',
-                    where: { id: existingParent.id },
-                    data: {
-                        pid: 0,
-                        name: menu.name,
-                        icon: menu.icon || '',
-                        sort: menu.sort || 0,
-                        type: menu.type || 1
-                    }
-                });
-                parentId = existingParent.id;
-                stats.updated++;
-                Logger.info(`  └ 更新父级菜单: ${menu.name} (ID: ${parentId}, Path: ${menu.path})`);
-            } else {
-                // 不存在则新增
-                parentId = await helper.insData({
-                    table: 'addon_admin_menu',
-                    data: {
-                        pid: 0,
-                        name: menu.name,
-                        path: menu.path || '',
-                        icon: menu.icon || '',
-                        sort: menu.sort || 0,
-                        type: menu.type || 1
-                    }
-                });
-                stats.created++;
-                Logger.info(`  └ 新增父级菜单: ${menu.name} (ID: ${parentId}, Path: ${menu.path})`);
-            }
-
-            // 2. 同步子级菜单
-            if (menu.children && menu.children.length > 0) {
-                for (const child of menu.children) {
-                    const existingChild = await helper.getOne({
-                        table: 'addon_admin_menu',
-                        where: { path: child.path || '' }
-                    });
-
-                    if (existingChild) {
-                        // 存在则更新
-                        await helper.updData({
-                            table: 'addon_admin_menu',
-                            where: { id: existingChild.id },
-                            data: {
-                                pid: parentId,
-                                name: child.name,
-                                icon: child.icon || '',
-                                sort: child.sort || 0,
-                                type: child.type || 1
-                            }
-                        });
-                        stats.updated++;
-                        Logger.info(`    └ 更新子级菜单: ${child.name} (ID: ${existingChild.id}, PID: ${parentId}, Path: ${child.path})`);
-                    } else {
-                        // 不存在则新增
-                        const childId = await helper.insData({
-                            table: 'addon_admin_menu',
-                            data: {
-                                pid: parentId,
-                                name: child.name,
-                                path: child.path || '',
-                                icon: child.icon || '',
-                                sort: child.sort || 0,
-                                type: child.type || 1
-                            }
-                        });
-                        stats.created++;
-                        Logger.info(`    └ 新增子级菜单: ${child.name} (ID: ${childId}, PID: ${parentId}, Path: ${child.path})`);
-                    }
-                }
-            }
-        } catch (error: any) {
-            Logger.error(`同步菜单 "${menu.name}" 失败:`, error.message || String(error));
-            throw error;
-        }
-    }
-
-    return stats;
-}
-
-/**
- * 同步菜单主函数
- */
-async function syncMenu(): Promise<boolean> {
-    let dbInitialized = false;
-
-    try {
-        if (CLI.DRY_RUN) {
-            Logger.info('[计划] 同步菜单配置到数据库（plan 模式不执行）');
-            Logger.info('[计划] 1. 读取 menu.json 配置文件');
-            Logger.info('[计划] 2. 根据 path 检查菜单是否存在');
-            Logger.info('[计划] 3. 存在则更新，不存在则新增');
-            Logger.info('[计划] 4. 处理两层菜单结构（父级和子级）');
-            Logger.info('[计划] 5. 显示菜单结构预览');
-            return true;
-        }
-
-        Logger.info('开始同步菜单配置到数据库...\n');
-
-        // 初始化数据库连接（Redis + SQL + DbHelper）
-        const { helper } = await initDatabase({ max: 1 });
-        dbInitialized = true;
-
-        // 1. 检查表是否存在
-        if (!(await checkTableExists(helper, 'addon_admin_menu'))) {
-            return false;
-        }
-
-        // 2. 收集配置文件中所有菜单的 path
-        Logger.info('\n=== 步骤 2: 收集配置菜单路径 ===');
-        const configPaths = collectPaths(menuConfig);
-        Logger.info(`✅ 配置文件中共有 ${configPaths.size} 个菜单路径`);
-
-        // 3. 同步菜单（新增和更新）
-        Logger.info('\n=== 步骤 3: 同步菜单数据（新增/更新） ===');
-        const stats = await syncMenus(helper, menuConfig);
-
-        //  4. 删除文件中不存在的菜单
-        const deletedCount = await deleteObsoleteRecords(helper, 'addon_admin_menu', configPaths);
-
-        // 5. 构建树形结构预览
-        Logger.info('\n=== 步骤 5: 菜单结构预览 ===');
-        const allMenus = await helper.getAll({
-            table: 'addon_admin_menu',
-            fields: ['id', 'pid', 'name', 'path', 'type'],
-            orderBy: ['pid#ASC', 'sort#ASC', 'id#ASC']
-        });
-
-        // 6. 输出统计信息
-        logSyncStats(stats, deletedCount, '菜单');
-        Logger.info(`当前父级菜单: ${allMenus.filter((m: any) => m.pid === 0).length} 个`);
-        Logger.info(`当前子级菜单: ${allMenus.filter((m: any) => m.pid !== 0).length} 个`);
-        Logger.info('提示: 菜单缓存将在服务器启动时自动完成');
-
-        return true;
-    } catch (error: any) {
-        console.log('🔥[ error ]-262', error);
-        Logger.error('菜单同步失败:', { message: error.message, stack: error.stack });
-        return false;
-    } finally {
-        if (dbInitialized) {
-            await closeDatabase();
-        }
-    }
-}
-
-// 执行同步
-syncMenu()
-    .then((success) => {
-        process.exit(success ? 0 : 1);
-    })
-    .catch((error) => {
-        Logger.error('执行失败:', error);
-        process.exit(1);
-    });

package/addons/admin/tables/admin.json

@@ -1,14 +0,0 @@
-{
-    "name": "姓名|string|2|50|null|0|null",
-    "nickname": "昵称|string|2|50|null|0|null",
-    "email": "邮箱|string|5|100|null|1|^[\\w.-]+@[\\w.-]+\\.\\w+$",
-    "phone": "手机号|string|11|11|null|0|^1[3-9]\\d{9}$",
-    "username": "用户名|string|3|30|null|0|^[a-zA-Z0-9_]+$",
-    "password": "密码|string|6|255|null|0|null",
-    "avatar": "头像|string|0|500|null|0|null",
-    "roleId": "角色ID|number|1|999999999999999|null|1|null",
-    "roleCode": "角色编码|string|2|50|null|0|^[a-zA-Z0-9_]+$",
-    "roleType": "角色类型|string|4|5|user|1|^(admin|user)$",
-    "lastLoginTime": "最后登录时间|number|0|null|0|0|null",
-    "lastLoginIp": "最后登录IP|string|0|50|null|0|null"
-}

package/addons/admin/tables/api.json

@@ -1,8 +0,0 @@
-{
-    "name": "接口名称|string|2|100|null|1|null",
-    "path": "接口路径|string|1|200|null|1|null",
-    "method": "请求方法|string|3|10|POST|1|^(GET|POST|PUT|DELETE|PATCH)$",
-    "description": "接口描述|string|0|500|null|0|null",
-    "addonName": "所属插件|string|0|50|null|0|null",
-    "addonTitle": "插件标题|string|0|100|null|0|null"
-}

package/addons/admin/tables/dict.json

@@ -1,8 +0,0 @@
-{
-    "name": "字典名称|string|2|50|null|1|null",
-    "code": "字典代码|string|2|50|null|1|^[a-zA-Z0-9_]+$",
-    "value": "字典值|string|0|200|null|1|null",
-    "sort": "排序|number|0|9999|0|0|null",
-    "pid": "父级ID|number|0|999999999999999|0|1|null",
-    "description": "描述|string|0|200|null|0|null"
-}

package/addons/admin/tables/menu.json

@@ -1,8 +0,0 @@
-{
-    "name": "菜单名称|string|2|50|null|1|null",
-    "path": "路由路径|string|1|200|null|1|null",
-    "icon": "图标名称|string|0|50|null|0|null",
-    "sort": "排序|number|0|9999|0|0|null",
-    "pid": "父级ID|number|0|999999999999999|0|1|null",
-    "type": "菜单类型|number|1|2|1|1|^(1|2)$"
-}

package/addons/admin/tables/role.json

@@ -1,8 +0,0 @@
-{
-    "name": "角色名称|string|2|50|null|1|null",
-    "code": "角色编码|string|2|50|null|1|^[a-zA-Z0-9_]+$",
-    "description": "角色描述|string|0|200|null|0|null",
-    "menus": "菜单权限|array_text|null|null|null|0|null",
-    "apis": "接口权限|array_text|null|null|null|0|null",
-    "sort": "排序|number|0|9999|0|0|null"
-}

package/addons/admin/types/index.ts

@@ -1,44 +0,0 @@
-/**
- * Admin 相关的类型定义
- */
-
-// 管理员信息
-export interface Admin {
-    id: number;
-    name: string;
-    email: string;
-    phone?: string;
-    password: string;
-    role: 'admin' | 'user';
-    state: 0 | 1 | 2; // 0=删除, 1=正常, 2=禁用
-    last_login_time?: string;
-    last_login_ip?: string;
-    created_at?: string;
-    updated_at?: string;
-}
-
-// 登录请求
-export interface LoginRequest {
-    email?: string;
-    password?: string;
-    phone?: string;
-    code?: string;
-}
-
-// 登录响应
-export interface LoginResponse {
-    token: string;
-    userInfo: Omit<Admin, 'password'>;
-}
-
-// 注册请求
-export interface RegisterRequest {
-    name: string;
-    email: string;
-    password: string;
-}
-
-// 发送验证码请求
-export interface SendSmsCodeRequest {
-    phone: string;
-}