befly-tpl 3.0.1

package/addons/admin/apis/dictAll.ts

@@ -0,0 +1,26 @@
+import { Yes, No } from 'befly';
+import type { ApiRoute } from 'befly';
+
+/**
+ * 获取所有字典（不分页）
+ */
+export default {
+    name: '获取所有字典',
+    handler: async (befly, ctx) => {
+        try {
+            const dicts = await befly.db.getAll({
+                table: 'addon_admin_dict',
+                fields: ['id', 'name', 'code', 'value', 'sort', 'pid', 'description', 'state', 'created_at', 'updated_at'],
+                orderBy: [
+                    { field: 'sort', direction: 'ASC' },
+                    { field: 'id', direction: 'ASC' }
+                ]
+            });
+
+            return Yes('操作成功', dicts);
+        } catch (error) {
+            befly.logger.error('获取所有字典失败:', error);
+            return No('操作失败');
+        }
+    }
+} as ApiRoute;

package/addons/admin/apis/dictDel.ts

@@ -0,0 +1,27 @@
+import { Fields, Yes, No } from 'befly';
+import type { ApiRoute } from 'befly';
+
+/**
+ * 删除字典
+ */
+export default {
+    name: '删除字典',
+    fields: {
+        id: Fields._id
+    },
+    handler: async (befly, ctx) => {
+        try {
+            await befly.db.delData({
+                table: 'addon_admin_dict',
+                where: {
+                    id: ctx.body.id
+                }
+            });
+
+            return Yes('操作成功');
+        } catch (error) {
+            befly.logger.error('删除字典失败:', error);
+            return No('操作失败');
+        }
+    }
+} as ApiRoute;

package/addons/admin/apis/dictDetail.ts

@@ -0,0 +1,28 @@
+import { Fields, Yes, No } from 'befly';
+import type { ApiRoute } from 'befly';
+
+/**
+ * 获取字典详情
+ */
+export default {
+    name: '获取字典详情',
+    fields: {
+        id: Fields._id
+    },
+    handler: async (befly, ctx) => {
+        try {
+            const dict = await befly.db.getDetail({
+                table: 'addon_admin_dict',
+                fields: ['id', 'name', 'code', 'value', 'sort', 'pid', 'description', 'state', 'created_at', 'updated_at'],
+                where: {
+                    id: ctx.body.id
+                }
+            });
+
+            return Yes('操作成功', dict);
+        } catch (error) {
+            befly.logger.error('获取字典详情失败:', error);
+            return No('操作失败');
+        }
+    }
+} as ApiRoute;

package/addons/admin/apis/dictIns.ts

@@ -0,0 +1,38 @@
+import { Yes, No } from 'befly';
+import type { ApiRoute } from 'befly';
+import adminDictTable from '../tables/dict.json';
+
+/**
+ * 添加字典
+ */
+export default {
+    name: '添加字典',
+    fields: {
+        name: adminDictTable.name,
+        code: adminDictTable.code,
+        value: adminDictTable.value,
+        sort: adminDictTable.sort,
+        pid: adminDictTable.pid,
+        description: adminDictTable.description
+    },
+    handler: async (befly, ctx) => {
+        try {
+            const dictId = await befly.db.insData({
+                table: 'addon_admin_dict',
+                data: {
+                    name: ctx.body.name,
+                    code: ctx.body.code,
+                    value: ctx.body.value,
+                    sort: ctx.body.sort,
+                    pid: ctx.body.pid,
+                    description: ctx.body.description
+                }
+            });
+
+            return Yes('操作成功', { id: dictId });
+        } catch (error) {
+            befly.logger.error('添加字典失败:', error);
+            return No('操作失败');
+        }
+    }
+} as ApiRoute;

package/addons/admin/apis/dictList.ts

@@ -0,0 +1,27 @@
+import { Fields, Yes, No } from 'befly';
+import type { ApiRoute } from 'befly';
+
+/**
+ * 获取字典列表
+ */
+export default {
+    name: '获取字典列表',
+    fields: {
+        page: Fields.page,
+        limit: Fields.limit
+    },
+    handler: async (befly, ctx) => {
+        const result = await befly.db.getList({
+            table: 'addon_admin_dict',
+            fields: ['id', 'name', 'code', 'value', 'sort', 'pid', 'description', 'state', 'created_at', 'updated_at'],
+            page: ctx.body.page,
+            limit: ctx.body.limit,
+            orderBy: [
+                { field: 'sort', direction: 'ASC' },
+                { field: 'id', direction: 'ASC' }
+            ]
+        });
+
+        return Yes('操作成功', result);
+    }
+} as ApiRoute;

package/addons/admin/apis/dictUpd.ts

@@ -0,0 +1,44 @@
+import { Fields, Yes, No } from 'befly';
+import type { ApiRoute } from 'befly';
+import adminDictTable from '../tables/dict.json';
+
+/**
+ * 更新字典
+ */
+export default {
+    name: '更新字典',
+    fields: {
+        id: Fields._id,
+        name: adminDictTable.name,
+        code: adminDictTable.code,
+        value: adminDictTable.value,
+        sort: adminDictTable.sort,
+        pid: adminDictTable.pid,
+        description: adminDictTable.description,
+        state: Fields.state
+    },
+    handler: async (befly, ctx) => {
+        try {
+            await befly.db.updData({
+                table: 'addon_admin_dict',
+                data: {
+                    name: ctx.body.name,
+                    code: ctx.body.code,
+                    value: ctx.body.value,
+                    sort: ctx.body.sort,
+                    pid: ctx.body.pid,
+                    description: ctx.body.description,
+                    state: ctx.body.state
+                },
+                where: {
+                    id: ctx.body.id
+                }
+            });
+
+            return Yes('操作成功');
+        } catch (error) {
+            befly.logger.error('更新字典失败:', error);
+            return No('操作失败');
+        }
+    }
+} as ApiRoute;

package/addons/admin/apis/login.ts

@@ -0,0 +1,123 @@
+/**
+ * 管理员登录接口
+ */
+
+import { Yes, No } from 'befly';
+import { Crypto2 } from 'befly';
+import { Jwt } from 'befly';
+import adminTable from '../tables/admin.json';
+
+export default {
+    name: '管理员登录',
+    auth: false,
+    fields: {
+        email: adminTable.email,
+        password: adminTable.password,
+        phone: adminTable.phone,
+        code: '验证码|string|4|6|null|0|null'
+    },
+    handler: async (befly, ctx) => {
+        let admin = null;
+
+        // 邮箱登录
+        if (ctx.body.email && ctx.body.password) {
+            // 查询管理员
+            admin = await befly.db.getOne({
+                table: 'addon_admin_admin',
+                where: { email: ctx.body.email }
+            });
+
+            if (!admin) {
+                return No('邮箱或密码错误');
+            }
+
+            // 验证密码
+            try {
+                const isValid = await Crypto2.verifyPassword(ctx.body.password, admin.password);
+                if (!isValid) {
+                    return No('邮箱或密码错误');
+                }
+            } catch (error) {
+                befly.logger.error('密码验证失败:', {
+                    error: error.message,
+                    passwordLength: admin.password?.length,
+                    passwordPrefix: admin.password?.substring(0, 10)
+                });
+                return No('密码格式错误，请重新设置密码');
+            }
+        }
+        // 手机号登录
+        else if (ctx.body.phone && ctx.body.code) {
+            // 验证验证码
+            if (befly.redis) {
+                const key = `sms_code:${ctx.body.phone}`;
+                const storedCode = await befly.redis.get(key);
+
+                if (!storedCode) {
+                    return No('验证码已过期或不存在');
+                }
+
+                if (storedCode !== ctx.body.code) {
+                    return No('验证码错误');
+                }
+
+                // 验证成功后删除验证码
+                await befly.redis.del(key);
+            } else {
+                // 没有 Redis 时的降级处理(开发环境)
+                if (ctx.body.code !== '123456') {
+                    return No('验证码错误');
+                }
+            }
+
+            // 查询管理员
+            admin = await befly.db.getOne({
+                table: 'addon_admin_admin',
+                where: { phone: ctx.body.phone }
+            });
+
+            if (!admin) {
+                return No('该手机号未注册');
+            }
+        } else {
+            return No('请提供正确的登录信息');
+        }
+
+        // 检查账号状态（state=1 表示正常，state=2 表示禁用）
+        if (admin.state === 2) {
+            return No('账号已被禁用');
+        }
+
+        // 更新最后登录信息
+        await befly.db.updData({
+            table: 'addon_admin_admin',
+            where: { id: admin.id },
+            data: {
+                lastLoginTime: Date.now(),
+                lastLoginIp: ctx.ip || 'unknown'
+            }
+        });
+
+        // 生成 JWT Token（包含核心身份信息）
+        const token = await Jwt.sign(
+            {
+                id: admin.id,
+                email: admin.email,
+                nickname: admin.nickname,
+                roleCode: admin.roleCode,
+                roleType: admin.roleType
+            },
+            {
+                expiresIn: '7d'
+            }
+        );
+
+        // 返回用户信息（不包含密码）
+        const { password: _, ...userWithoutPassword } = admin;
+
+        return Yes('登录成功', {
+            token,
+            userInfo: userWithoutPassword
+        });
+    }
+};

package/addons/admin/apis/logout.ts

@@ -0,0 +1,23 @@
+/**
+ * 退出登录接口
+ */
+
+import { Yes } from 'befly';
+
+export default {
+    name: '退出登录',
+    handler: async (befly, ctx) => {
+        // JWT token 是无状态的,前端删除 token 即可
+        // 如果需要实现 token 黑名单,可以在这里将 token 加入 Redis 黑名单
+
+        const token = ctx.headers.authorization?.replace('Bearer ', '');
+
+        if (token && befly.redis) {
+            // 将 token 加入黑名单,有效期设置为 token 的剩余有效期
+            const key = `token_blacklist:${token}`;
+            await befly.redis.set(key, '1', 'EX', 7 * 24 * 60 * 60); // 7天
+        }
+
+        return Yes('退出成功');
+    }
+};

package/addons/admin/apis/menuAll.ts

@@ -0,0 +1,70 @@
+/**
+ * 获取当前用户的菜单权限
+ * 说明：
+ * 1. 从 Redis 缓存读取所有菜单（如果缓存不存在则从数据库查询并缓存）
+ * 2. 根据当前登录用户的角色过滤可访问的菜单
+ * 3. 返回一维数组（由前端构建树形结构）
+ * 4. 仅返回状态为启用的菜单
+ */
+
+import { Yes, No } from 'befly';
+
+export default {
+    name: '获取用户菜单',
+    auth: true,
+    handler: async (befly, ctx) => {
+        try {
+            // 2. 查询角色信息获取菜单权限（使用 roleCode 而非 roleId）
+            const role = await befly.db.getOne({
+                table: 'addon_admin_role',
+                where: { code: ctx.user.roleCode }
+            });
+
+            if (!role || !role.menus) {
+                return No('角色不存在', []);
+            }
+
+            // 3. 解析菜单ID列表（逗号分隔的字符串）
+            const menuIds = role.menus
+                .split(',')
+                .map((id: string) => parseInt(id.trim()))
+                .filter((id: number) => !isNaN(id));
+
+            if (menuIds.length === 0) {
+                return Yes('菜单为空', []);
+            }
+
+            // 4. 从 Redis 缓存读取所有菜单
+            let allMenus = await befly.redis.getObject<any[]>('menus:all');
+
+            // 如果缓存不存在，从数据库查询并缓存
+            if (!allMenus || allMenus.length === 0) {
+                befly.logger.info('菜单缓存未命中，从数据库查询');
+                allMenus = await befly.db.getAll({
+                    table: 'addon_admin_menu',
+                    fields: ['id', 'pid', 'name', 'path', 'icon', 'type', 'sort'],
+                    orderBy: ['sort#ASC', 'id#ASC']
+                });
+
+                // 回写缓存
+                if (allMenus.length > 0) {
+                    await befly.redis.setObject('menus:all', allMenus);
+                    befly.logger.info(`已缓存 ${allMenus.length} 个菜单到 Redis`);
+                }
+            } else {
+                befly.logger.debug(`从 Redis 缓存读取 ${allMenus.length} 个菜单`);
+                // JSON.parse 会保持数字类型，无需额外转换
+            }
+
+            // 5. 根据角色权限过滤菜单
+            const menuIdSet = new Set(menuIds.map(String)); // 转为字符串 Set 方便比较
+            const authorizedMenus = allMenus.filter((menu: any) => menuIdSet.has(String(menu.id)));
+
+            // 6. 返回一维数组（由前端构建树形结构）
+            return Yes('获取菜单成功', authorizedMenus);
+        } catch (error) {
+            befly.logger.error('获取用户菜单失败:', error);
+            return No('获取菜单失败');
+        }
+    }
+};

package/addons/admin/apis/menuDel.ts

@@ -0,0 +1,40 @@
+/**
+ * 删除菜单
+ */
+
+import { Yes, No, Fields } from 'befly';
+
+export default {
+    name: '删除菜单',
+    fields: {
+        id: Fields._id
+    },
+    handler: async (befly, ctx) => {
+        try {
+            // 检查是否有子菜单（使用 getList 代替 getAll）
+            const childrenList = await befly.db.getList({
+                table: 'addon_admin_menu',
+                where: { pid: ctx.body.id }
+            });
+
+            if (childrenList.total > 0) {
+                return No('该菜单下有子菜单，无法删除');
+            }
+
+            // 删除菜单
+            await befly.db.delData({
+                table: 'addon_admin_menu',
+                where: { id: ctx.body.id }
+            });
+
+            // 注意：菜单权限现在存储在 role.menus 字段中
+            // 如果需要从角色权限中移除此菜单，需要额外处理
+            // 这里暂时不处理，由管理员在角色管理界面手动调整
+
+            return Yes('操作成功');
+        } catch (error) {
+            befly.logger.error('删除菜单失败:', error);
+            return No('操作失败');
+        }
+    }
+};

package/addons/admin/apis/menuIns.ts

@@ -0,0 +1,31 @@
+import { Yes, No } from 'befly';
+import adminMenuTable from '../tables/menu.json';
+
+/**
+ * 创建菜单
+ */
+export default {
+    name: '创建菜单',
+    fields: {
+        name: adminMenuTable.name,
+        path: adminMenuTable.path,
+        icon: adminMenuTable.icon,
+        sort: adminMenuTable.sort,
+        pid: adminMenuTable.pid,
+        type: adminMenuTable.type
+        // state 由框架自动设置为 1（正常）
+    },
+    handler: async (befly, ctx) => {
+        try {
+            const menuId = await befly.db.insData({
+                table: 'addon_admin_menu',
+                data: ctx.body
+            });
+
+            return Yes('操作成功', { id: menuId });
+        } catch (error) {
+            befly.logger.error('创建菜单失败:', error);
+            return No('操作失败');
+        }
+    }
+};

package/addons/admin/apis/menuList.ts

@@ -0,0 +1,26 @@
+/**
+ * 获取所有菜单列表
+ * 说明：用于后台管理的菜单配置页面
+ */
+
+import { Yes, No } from 'befly';
+export default {
+    name: '获取菜单列表',
+    handler: async (befly, ctx) => {
+        try {
+            const menus = await befly.db.getAll({
+                table: 'addon_admin_menu',
+                fields: ['id', 'name', 'path', 'icon', 'sort', 'pid', 'type', 'state', 'created_at', 'updated_at'],
+                orderBy: [
+                    { field: 'sort', direction: 'ASC' },
+                    { field: 'id', direction: 'ASC' }
+                ]
+            });
+
+            return Yes('操作成功', menus);
+        } catch (error) {
+            befly.logger.error('获取菜单列表失败:', error);
+            return No('操作失败');
+        }
+    }
+};

package/addons/admin/apis/menuUpd.ts

@@ -0,0 +1,41 @@
+import { Yes, No, Fields } from 'befly';
+import adminMenuTable from '../tables/menu.json';
+
+/**
+ * 更新菜单
+ */
+export default {
+    name: '更新菜单',
+    fields: {
+        id: Fields._id,
+        name: adminMenuTable.name,
+        path: adminMenuTable.path,
+        icon: adminMenuTable.icon,
+        sort: adminMenuTable.sort,
+        pid: adminMenuTable.pid,
+        type: adminMenuTable.type
+        // state 需要禁用时传 2，启用时传 1
+    },
+    handler: async (befly, ctx) => {
+        try {
+            await befly.db.updData({
+                table: 'addon_admin_menu',
+                where: { id: ctx.body.id },
+                data: {
+                    name: ctx.body.name,
+                    path: ctx.body.path,
+                    icon: ctx.body.icon,
+                    sort: ctx.body.sort,
+                    pid: ctx.body.pid,
+                    type: ctx.body.type
+                    // state 字段不在此处更新，需要禁用/启用时单独处理
+                }
+            });
+
+            return Yes('操作成功');
+        } catch (error) {
+            befly.logger.error('更新菜单失败:', error);
+            return No('操作失败');
+        }
+    }
+};

package/addons/admin/apis/register.ts

@@ -0,0 +1,50 @@
+/**
+ * 管理员注册接口
+ */
+
+import { Yes, No } from 'befly';
+
+import { Crypto2 } from 'befly';
+import adminTable from '../tables/admin.json';
+
+export default {
+    name: '管理员注册',
+    auth: false,
+    fields: {
+        name: adminTable.name,
+        email: adminTable.email,
+        password: adminTable.password
+    },
+    required: ['name', 'email', 'password'],
+    handler: async (befly, ctx) => {
+        // 检查邮箱是否已存在
+        const existingAdmin = await befly.db.getOne({
+            table: 'addon_admin_admin',
+            where: { email: ctx.body.email }
+        });
+
+        if (existingAdmin) {
+            return No('该邮箱已被注册');
+        }
+
+        // 加密密码
+        const hashedPassword = await Crypto2.hashPassword(ctx.body.password);
+
+        // 创建管理员
+        const adminId = await befly.db.insData({
+            table: 'addon_admin_admin',
+            data: {
+                name: ctx.body.name,
+                email: ctx.body.email,
+                password: hashedPassword,
+                role: 'user' // 默认为普通用户，state 由框架自动设置为 1
+            }
+        });
+
+        return Yes('注册成功', {
+            id: adminId,
+            name: ctx.body.name,
+            email: ctx.body.email
+        });
+    }
+};

package/addons/admin/apis/roleApiDetail.ts

@@ -0,0 +1,34 @@
+/**
+ * 获取角色的接口权限
+ */
+
+import { Yes, No, Fields } from 'befly';
+
+export default {
+    name: '获取角色接口权限',
+    auth: true,
+    fields: {
+        roleId: Fields._id
+    },
+    handler: async (befly, ctx) => {
+        // 查询角色信息
+        const role = await befly.db.getOne({
+            table: 'addon_admin_role',
+            where: { id: ctx.body.roleId }
+        });
+
+        if (!role) {
+            return No('角色不存在');
+        }
+
+        // 解析接口ID列表（逗号分隔的字符串转为数组）
+        const apiIds = role.apis
+            ? role.apis
+                  .split(',')
+                  .map((id: string) => parseInt(id.trim()))
+                  .filter((id: number) => !isNaN(id))
+            : [];
+
+        return Yes('操作成功', { apiIds });
+    }
+};

package/addons/admin/apis/roleApiSave.ts

@@ -0,0 +1,44 @@
+/**
+ * 保存角色的接口权限
+ */
+
+import { Yes, No, Fields } from 'befly';
+import { cacheRolePermissions } from '../util';
+import adminRoleTable from '../tables/role.json';
+
+export default {
+    name: '保存角色接口权限',
+    auth: true,
+    fields: {
+        roleId: Fields._id,
+        apiIds: adminRoleTable.apis
+    },
+    handler: async (befly, ctx) => {
+        // 查询角色是否存在
+        const role = await befly.db.getOne({
+            table: 'addon_admin_role',
+            where: { id: ctx.body.roleId }
+        });
+
+        if (!role) {
+            return No('角色不存在');
+        }
+
+        // 将数组转为逗号分隔的字符串存储
+        const apiIdsStr = Array.isArray(ctx.body.apiIds) ? ctx.body.apiIds.join(',') : '';
+
+        // 更新角色的接口权限
+        await befly.db.updData({
+            table: 'addon_admin_role',
+            where: { id: ctx.body.roleId },
+            data: {
+                apis: apiIdsStr
+            }
+        });
+
+        // 增量更新 Redis 缓存
+        await cacheRolePermissions(befly, role.code, apiIdsStr);
+
+        return Yes('操作成功');
+    }
+};