liufumingren 8597cf5ac9 feat(backend): 用户鉴权、菜单权限、主体与系统基础模块
- 登录/邮箱验证码/密码流程(controller/auth.js、lib/emailCode.js、middleware/jwt_auth.js)
- 主体(principal)隔离与主体用户、对外接口配置模块及 principalCheck 中间件
- 菜单、用户、文件上传、快递公司字典(express_companies)等基础模块
- 通用工具:分页(lib/pagination.js)、缓存(service/cache.js)
- 全量接口契约(contract/index.js)与路由注册(router.js)、config.default.js 配置
- 相关迁移:菜单组件调整与菜单种子、创建 files 表
2026-09-13 02:23:34 +08:00

179 lines
4.8 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const { Controller } = require('egg');
const { parsePagination, buildPageResult } = require('../lib/pagination');
/**
* @controller MenuController 菜单管理
*/
class MenuController extends Controller {
/**
* @summary 菜单列表
* @description 分页查询菜单,支持按父级、类型与状态过滤
* @router get /api/menus
* @apikey
* @request query integer page 页码,默认 1
* @request query integer pageSize 每页条数,默认 20
* @request query integer parent_id 父菜单ID,0 表示根节点
* @request query integer type 类型:1目录 2菜单 3按钮,不传则不过滤
* @request query integer status 状态:1启用 0禁用,不传则不过滤
* @response 200 menuListResponse success
*/
async index() {
const { ctx } = this;
const { page, pageSize, offset, limit } = parsePagination(ctx.query);
const { parent_id: parentId, type, status } = ctx.query;
const where = {};
if (parentId !== undefined && parentId !== '') where.parent_id = Number(parentId);
if (type !== undefined && type !== '') where.type = Number(type);
if (status !== undefined && status !== '') where.status = Number(status);
const { count, rows } = await ctx.model.Menu.findAndCountAll({
where,
offset,
limit,
order: [[ 'sort', 'DESC' ], [ 'id', 'ASC' ]],
});
ctx.body = { code: 0, message: 'success', data: buildPageResult(rows, count, { page, pageSize }) };
}
/**
* @summary 菜单树
* @description 一次性返回全部菜单并按 parent_id 组装为树形结构
* @router get /api/menus/tree
* @apikey
* @request query integer status 状态:1启用 0禁用,不传则返回全部
* @response 200 baseResponse success
*/
async tree() {
const { ctx } = this;
const { status } = ctx.query;
const where = {};
if (status !== undefined && status !== '') where.status = Number(status);
const list = await ctx.model.Menu.findAll({
where,
order: [[ 'sort', 'DESC' ], [ 'id', 'ASC' ]],
});
const rows = list.map(item => item.toJSON());
const map = new Map();
const tree = [];
rows.forEach(item => {
item.children = [];
map.set(item.id, item);
});
rows.forEach(item => {
const parent = map.get(item.parent_id);
if (parent) {
parent.children.push(item);
} else {
tree.push(item);
}
});
ctx.body = { code: 0, message: 'success', data: tree };
}
/**
* @summary 菜单详情
* @description 按主键查询菜单
* @router get /api/menus/{id}
* @apikey
* @request path integer *id 菜单主键ID
* @response 200 baseResponse success
*/
async show() {
const { ctx } = this;
const menu = await ctx.model.Menu.findByPk(ctx.params.id);
if (!menu) {
ctx.status = 404;
ctx.body = { code: 404, message: '菜单不存在' };
return;
}
ctx.body = { code: 0, message: 'success', data: menu };
}
/**
* @summary 新增菜单
* @description parent_id 不传默认为 0(根节点)
* @router post /api/menus
* @apikey
* @request body createMenuRequest *body
* @response 200 baseResponse success
*/
async create() {
const { ctx } = this;
const { name } = ctx.request.body;
if (!name) {
ctx.status = 400;
ctx.body = { code: 400, message: 'name 为必填项' };
return;
}
const menu = await ctx.model.Menu.create({
parent_id: 0,
type: 2,
sort: 0,
status: 1,
...ctx.request.body,
});
ctx.body = { code: 0, message: 'success', data: { id: menu.id } };
}
/**
* @summary 更新菜单
* @description 未传入的字段保持原值
* @router put /api/menus/{id}
* @apikey
* @request path integer *id 菜单主键ID
* @request body updateMenuRequest *body
* @response 200 baseResponse success
*/
async update() {
const { ctx } = this;
const menu = await ctx.model.Menu.findByPk(ctx.params.id);
if (!menu) {
ctx.status = 404;
ctx.body = { code: 404, message: '菜单不存在' };
return;
}
await menu.update(ctx.request.body);
ctx.body = { code: 0, message: 'success', data: { id: menu.id } };
}
/**
* @summary 删除菜单
* @description 物理删除菜单;存在子菜单时需先删除子菜单
* @router delete /api/menus/{id}
* @apikey
* @request path integer *id 菜单主键ID
* @response 200 baseResponse success
*/
async destroy() {
const { ctx } = this;
const menu = await ctx.model.Menu.findByPk(ctx.params.id);
if (!menu) {
ctx.status = 404;
ctx.body = { code: 404, message: '菜单不存在' };
return;
}
await menu.destroy();
ctx.body = { code: 0, message: 'success', data: { id: Number(ctx.params.id) } };
}
}
module.exports = MenuController;