- 登录/邮箱验证码/密码流程(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 表
266 lines
8.4 KiB
JavaScript
266 lines
8.4 KiB
JavaScript
'use strict';
|
||
|
||
const { Controller } = require('egg');
|
||
const crypto = require('crypto');
|
||
const { generateSalt, hashPassword } = require('../lib/password');
|
||
const { parsePagination, buildPageResult } = require('../lib/pagination');
|
||
|
||
/**
|
||
* @controller PrincipalUserController 主体用户关联管理
|
||
*/
|
||
class PrincipalUserController extends Controller {
|
||
/**
|
||
* @summary 关联列表
|
||
* @description 分页查询主体与用户的关联关系,可按主体或用户过滤
|
||
* @router get /api/principal-users
|
||
* @apikey
|
||
* @request query integer page 页码,默认 1
|
||
* @request query integer pageSize 每页条数,默认 20
|
||
* @request query integer principal_id 主体ID(必填,需当前账号已绑定该主体)
|
||
* @request query integer user_id 用户ID,不传则不过滤
|
||
* @request query string role 角色标识,精确匹配
|
||
* @request query integer status 状态:1启用 0禁用,不传则不过滤
|
||
* @response 200 principalUserListResponse success
|
||
*/
|
||
async index() {
|
||
const { ctx } = this;
|
||
const { page, pageSize, offset, limit } = parsePagination(ctx.query);
|
||
const { user_id: userId, role, status } = ctx.query;
|
||
const principalId = ctx.state.principalId;
|
||
|
||
const where = {};
|
||
where.principal_id = principalId;
|
||
if (userId) where.user_id = Number(userId);
|
||
if (role) where.role = role;
|
||
if (status !== undefined && status !== '') where.status = Number(status);
|
||
|
||
const { count, rows } = await ctx.model.PrincipalUser.findAndCountAll({
|
||
where,
|
||
offset,
|
||
limit,
|
||
order: [[ 'id', 'DESC' ]],
|
||
include: [
|
||
{ model: ctx.model.User, as: 'user', attributes: { exclude: [ 'password', 'salt' ] } },
|
||
],
|
||
});
|
||
|
||
ctx.body = { code: 0, message: 'success', data: buildPageResult(rows, count, { page, pageSize }) };
|
||
}
|
||
|
||
/**
|
||
* @summary 关联详情
|
||
* @description 按主键查询关联记录,并带出用户与主体信息
|
||
* @router get /api/principal-users/{id}
|
||
* @apikey
|
||
* @request path integer *id 关联记录主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async show() {
|
||
const { ctx } = this;
|
||
const relation = await ctx.model.PrincipalUser.findByPk(ctx.params.id, {
|
||
include: [
|
||
{ model: ctx.model.User, as: 'user', attributes: { exclude: [ 'password', 'salt' ] } },
|
||
{ model: ctx.model.Principal, as: 'principal' },
|
||
],
|
||
});
|
||
|
||
if (!relation) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '关联记录不存在' };
|
||
return;
|
||
}
|
||
|
||
ctx.body = { code: 0, message: 'success', data: relation };
|
||
}
|
||
|
||
/**
|
||
* @summary 绑定用户到主体
|
||
* @description 建立主体与用户的关联;同一主体下同一用户仅允许一条记录
|
||
* @router post /api/principal-users
|
||
* @apikey
|
||
* @request body bindPrincipalUserRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async create() {
|
||
const { ctx } = this;
|
||
const { principal_id: principalId, user_id: userId } = ctx.request.body;
|
||
|
||
if (!principalId || !userId) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'principal_id 与 user_id 为必填项' };
|
||
return;
|
||
}
|
||
|
||
const exist = await ctx.model.PrincipalUser.findOne({
|
||
where: { principal_id: principalId, user_id: userId },
|
||
});
|
||
if (exist) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '该用户已绑定到该主体' };
|
||
return;
|
||
}
|
||
|
||
const relation = await ctx.model.PrincipalUser.create(ctx.request.body);
|
||
// 绑定关系变化:失效该用户缓存的主体ID列表与可选主体列表
|
||
await ctx.service.cache.invalidateUserPrincipals(userId);
|
||
ctx.body = { code: 0, message: 'success', data: { id: relation.id } };
|
||
}
|
||
|
||
/**
|
||
* @summary 邀请开通主体账号
|
||
* @description 传入邮箱、用户名称与主体ID,自动创建新用户(随机初始密码)并绑定到该主体(角色 member);
|
||
* 返回明文随机密码,需由调用方妥善交付给被邀请人;同一邮箱不可重复开通
|
||
* @router post /api/principal-users/invite
|
||
* @apikey
|
||
* @request body invitePrincipalUserRequest *body
|
||
* @response 200 invitePrincipalUserResponse success
|
||
*/
|
||
async invite() {
|
||
const { ctx } = this;
|
||
const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
|
||
const { email, name, principal_id: principalId } = ctx.request.body;
|
||
|
||
if (!email || !EMAIL_REGEX.test(email)) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '请填写正确的邮箱地址' };
|
||
return;
|
||
}
|
||
if (!name) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '用户名称 name 为必填项' };
|
||
return;
|
||
}
|
||
if (!principalId) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '主体ID principal_id 为必填项' };
|
||
return;
|
||
}
|
||
|
||
// 主体必须存在,给出明确提示
|
||
const principal = await ctx.model.Principal.findByPk(principalId);
|
||
if (!principal) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '主体不存在' };
|
||
return;
|
||
}
|
||
|
||
// 邮箱全局唯一
|
||
const emailExist = await ctx.model.User.findOne({ where: { email } });
|
||
if (emailExist) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '该邮箱已注册' };
|
||
return;
|
||
}
|
||
|
||
// 生成随机初始密码(明文仅此处返回一次)
|
||
const password = this.generateRandomPassword(12);
|
||
const salt = generateSalt();
|
||
const hashed = hashPassword(password, salt);
|
||
|
||
const transaction = await ctx.model.transaction();
|
||
try {
|
||
const user = await ctx.model.User.create({
|
||
username: email,
|
||
nickname: name,
|
||
email,
|
||
salt,
|
||
password: hashed,
|
||
status: 1,
|
||
}, { transaction });
|
||
|
||
const relation = await ctx.model.PrincipalUser.create({
|
||
principal_id: principalId,
|
||
user_id: user.id,
|
||
role: 'member',
|
||
is_default: 0,
|
||
status: 1,
|
||
}, { transaction });
|
||
|
||
await transaction.commit();
|
||
|
||
await ctx.service.cache.invalidateUserPrincipals(user.id);
|
||
|
||
ctx.body = {
|
||
code: 0,
|
||
message: 'success',
|
||
data: {
|
||
user_id: user.id,
|
||
relation_id: relation.id,
|
||
email: user.email,
|
||
username: user.username,
|
||
nickname: user.nickname,
|
||
password,
|
||
},
|
||
};
|
||
} catch (err) {
|
||
await transaction.rollback();
|
||
ctx.status = 500;
|
||
ctx.body = { code: 500, message: '开通账号失败,请稍后重试' };
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 生成随机密码:12 位,含大小写字母与数字(去除易混淆字符 0/O/1/l/I)
|
||
* @param {Number} len 长度,默认 12
|
||
* @return {String} 随机密码
|
||
*/
|
||
generateRandomPassword(len = 12) {
|
||
const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz23456789';
|
||
const bytes = crypto.randomBytes(len);
|
||
let pwd = '';
|
||
for (let i = 0; i < len; i++) pwd += chars[bytes[i] % chars.length];
|
||
return pwd;
|
||
}
|
||
|
||
/**
|
||
* @summary 更新关联信息
|
||
* @description 可修改角色、默认主体标识与状态
|
||
* @router put /api/principal-users/{id}
|
||
* @apikey
|
||
* @request path integer *id 关联记录主键ID
|
||
* @request body bindPrincipalUserRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async update() {
|
||
const { ctx } = this;
|
||
const relation = await ctx.model.PrincipalUser.findByPk(ctx.params.id);
|
||
|
||
if (!relation) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '关联记录不存在' };
|
||
return;
|
||
}
|
||
|
||
delete ctx.request.body.principal_id;
|
||
await relation.update(ctx.request.body);
|
||
await ctx.service.cache.invalidateUserPrincipals(relation.user_id);
|
||
ctx.body = { code: 0, message: 'success', data: { id: relation.id } };
|
||
}
|
||
|
||
/**
|
||
* @summary 解绑用户与主体
|
||
* @description 物理删除关联记录
|
||
* @router delete /api/principal-users/{id}
|
||
* @apikey
|
||
* @request path integer *id 关联记录主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async destroy() {
|
||
const { ctx } = this;
|
||
const relation = await ctx.model.PrincipalUser.findByPk(ctx.params.id);
|
||
|
||
if (!relation) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '关联记录不存在' };
|
||
return;
|
||
}
|
||
|
||
const relationUserId = relation.user_id;
|
||
await relation.destroy();
|
||
await ctx.service.cache.invalidateUserPrincipals(relationUserId);
|
||
ctx.body = { code: 0, message: 'success', data: { id: Number(ctx.params.id) } };
|
||
}
|
||
}
|
||
|
||
module.exports = PrincipalUserController;
|