oms/backend/app/controller/principalSubsidiary.js
liufumingren 85938c81ec feat: 组织架构、权限管理与员工档案
- 组织架构:主体管理改为组织架构页(左侧 tab:集团设置 / 下属公司),主体列表仅保留顶部下拉切换
  - 新增下属公司表 principal_subsidiaries、接口与页面,按当前主体隔离
  - 集团设置读取/编辑当前主体基础信息,补所属主体校验与更新字段白名单
- 权限管理:新增 permissions / roles / role_permissions 表
  - 权限以现有顶级菜单为分类,每个菜单两种范围:集团全部 / 所在公司
  - 系统预设角色:系统管理员(全部集团权限)、货主权限(全部所在公司权限)
  - 权限管理页只展示角色组,支持按菜单勾选权限;系统预设角色只读
- 员工档案:账号菜单改为员工档案
  - 新增员工-下属公司多对多关联(principal_user_companies)
  - 创建/编辑员工必须选择角色组;除所有者外必须至少关联一家公司
- 菜单重命名与旧地址重定向;账号导出新增角色组、所属公司

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 20:52:43 +08:00

206 lines
6.6 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');
/** 允许前端写入的字段,避免覆盖 principal_id 等归属信息 */
const WRITABLE_FIELDS = [ 'name', 'credit_code', 'contact_name', 'contact_phone', 'address', 'status', 'remark' ];
/** 取请求体中的可写字段(未传的字段保持原值)
* @param {Object} body 请求体
* @return {Object} 可写字段
*/
function pickWritable(body) {
const data = {};
WRITABLE_FIELDS.forEach(field => {
if (body[field] !== undefined) data[field] = body[field];
});
return data;
}
/**
* @controller PrincipalSubsidiaryController 组织架构 → 下属公司
* 数据按当前主体(ctx.state.principalId)隔离:集团主体下拉切换后只看到该主体下的公司档案。
*/
class PrincipalSubsidiaryController extends Controller {
/**
* @summary 下属公司列表
* @description 分页查询当前主体下的下属公司,支持关键词(公司名称/信用代码/联系人)与状态过滤
* @router get /api/principal-subsidiaries
* @apikey
* @request query integer page 页码,默认 1
* @request query integer pageSize 每页条数,默认 20
* @request query string keyword 关键词,匹配公司名称 / 统一社会信用代码 / 联系人
* @request query integer status 状态:1启用 0禁用,不传则不过滤
* @response 200 principalSubsidiaryListResponse success
*/
async index() {
const { ctx } = this;
const Op = this.app.Sequelize.Op;
const { page, pageSize, offset, limit } = parsePagination(ctx.query);
const { keyword, status } = ctx.query;
const where = { principal_id: ctx.state.principalId };
const text = String(keyword || '').trim();
if (text) {
where[Op.or] = [
{ name: { [Op.like]: `%${text}%` } },
{ credit_code: { [Op.like]: `%${text}%` } },
{ contact_name: { [Op.like]: `%${text}%` } },
];
}
if (status !== undefined && status !== '') where.status = Number(status);
const { count, rows } = await ctx.model.PrincipalSubsidiary.findAndCountAll({
where,
offset,
limit,
order: [[ 'id', 'DESC' ]],
});
ctx.body = { code: 0, message: 'success', data: buildPageResult(rows, count, { page, pageSize }) };
}
/**
* @summary 下属公司下拉(仅启用)
* @description 供员工档案等页面选择所属公司,按当前主体隔离
* @router get /api/principal-subsidiaries/select
* @apikey
* @response 200 baseResponse success
*/
async select() {
const { ctx } = this;
const rows = await ctx.model.PrincipalSubsidiary.findAll({
where: { principal_id: ctx.state.principalId, status: 1 },
attributes: [ 'id', 'name' ],
order: [[ 'id', 'ASC' ]],
raw: true,
});
ctx.body = { code: 0, message: 'success', data: rows };
}
/**
* @summary 下属公司详情
* @router get /api/principal-subsidiaries/{id}
* @apikey
* @request path integer *id 下属公司主键ID
* @response 200 baseResponse success
*/
async show() {
const { ctx } = this;
const item = await this.findScoped(ctx.params.id);
if (!item) {
ctx.status = 404;
ctx.body = { code: 404, message: '下属公司不存在' };
return;
}
ctx.body = { code: 0, message: 'success', data: item };
}
/**
* @summary 新增下属公司
* @description 同一主体下公司名称唯一
* @router post /api/principal-subsidiaries
* @apikey
* @request body createPrincipalSubsidiaryRequest *body
* @response 200 baseResponse success
*/
async create() {
const { ctx } = this;
const principalId = ctx.state.principalId;
const data = pickWritable(ctx.request.body || {});
const name = String(data.name || '').trim();
if (!name) {
ctx.status = 400;
ctx.body = { code: 400, message: '公司名称为必填项' };
return;
}
const exist = await ctx.model.PrincipalSubsidiary.findOne({ where: { principal_id: principalId, name } });
if (exist) {
ctx.status = 400;
ctx.body = { code: 400, message: '该主体下已存在同名公司' };
return;
}
const item = await ctx.model.PrincipalSubsidiary.create({ ...data, name, principal_id: principalId });
ctx.body = { code: 0, message: 'success', data: { id: item.id } };
}
/**
* @summary 更新下属公司
* @description 未传入的字段保持原值;同一主体下公司名称唯一
* @router put /api/principal-subsidiaries/{id}
* @apikey
* @request path integer *id 下属公司主键ID
* @request body updatePrincipalSubsidiaryRequest *body
* @response 200 baseResponse success
*/
async update() {
const { ctx } = this;
const item = await this.findScoped(ctx.params.id);
if (!item) {
ctx.status = 404;
ctx.body = { code: 404, message: '下属公司不存在' };
return;
}
const data = pickWritable(ctx.request.body || {});
if (data.name !== undefined) {
const name = String(data.name || '').trim();
if (!name) {
ctx.status = 400;
ctx.body = { code: 400, message: '公司名称为必填项' };
return;
}
const exist = await ctx.model.PrincipalSubsidiary.findOne({
where: { principal_id: item.principal_id, name },
});
if (exist && Number(exist.id) !== Number(item.id)) {
ctx.status = 400;
ctx.body = { code: 400, message: '该主体下已存在同名公司' };
return;
}
data.name = name;
}
await item.update(data);
ctx.body = { code: 0, message: 'success', data: { id: item.id } };
}
/**
* @summary 删除下属公司
* @router delete /api/principal-subsidiaries/{id}
* @apikey
* @request path integer *id 下属公司主键ID
* @response 200 baseResponse success
*/
async destroy() {
const { ctx } = this;
const item = await this.findScoped(ctx.params.id);
if (!item) {
ctx.status = 404;
ctx.body = { code: 404, message: '下属公司不存在' };
return;
}
await item.destroy();
ctx.body = { code: 0, message: 'success', data: { id: Number(item.id) } };
}
/**
* 按当前主体取下属公司,避免同一账号切换主体后操作到其它主体(集团)的数据
* @param {number|string} id 下属公司主键
* @return {Promise<object|null>} 下属公司记录
*/
async findScoped(id) {
const { ctx } = this;
return await ctx.model.PrincipalSubsidiary.findOne({
where: { id, principal_id: ctx.state.principalId },
});
}
}
module.exports = PrincipalSubsidiaryController;