oms/backend/app/controller/productUnit.js
liufumingren 9c9a81f168 feat: 商品属性(分类/品牌/单位)关联货主
- product_categories / product_brands / product_units 新增 subsidiary_id(NULL 表示主体级、全集团共用)
- 列表与下拉按货主范围过滤:货主权限仅可见「主体级 + 自己所属公司」,并支持按货主筛选
- 新增/编辑支持选择货主,货主权限只能选主体或自己所属公司;同货主范围内名称唯一
- 详情/更新/删除对越权属性返回 403;导出新增货主列并收窄到可见范围

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-05 02:15:25 +08:00

286 lines
9.5 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');
const { attachUsedCount } = require('../lib/attributeUsage');
const {
resolveScope,
visibilityWhere,
resolveSubsidiaryValue,
isVisible,
} = require('../lib/productAttributeScope');
/** 商品表引用单位主键的字段名 */
const COLUMN = 'unit_id';
/**
* @controller ProductUnitController 商品单位管理
* 按主体隔离(principal_id);同一主体下单位名称唯一;被商品引用时禁止删除。
*/
class ProductUnitController extends Controller {
/**
* @summary 商品单位列表
* @description 分页查询,支持按关键词(名称/编码)与状态过滤;附带 used_count(被商品使用次数)
* @router get /api/product-units
* @apikey
* @request query integer page 页码,默认 1
* @request query integer pageSize 每页条数,默认 20
* @request query string keyword 关键词,匹配单位名称或编码
* @request query integer status 状态:1启用 0禁用
* @response 200 productUnitListResponse success
*/
async index() {
const { ctx } = this;
const Op = this.app.Sequelize.Op;
const { page, pageSize, offset, limit } = parsePagination(ctx.query);
const { keyword, status, subsidiary_id: subsidiaryId } = ctx.query;
const principalId = ctx.state.principalId;
// 货主范围:集团权限看全部;所在公司权限仅看「主体级(无货主)+ 自己所属公司」
const scope = await resolveScope(ctx);
const andConditions = [
{ [Op.or]: [{ principal_id: principalId }, { is_system: 1 }] },
];
const visible = visibilityWhere(ctx, scope);
if (visible) andConditions.push(visible);
if (keyword) {
andConditions.push({
[Op.or]: [
{ name: { [Op.like]: `%${keyword}%` } },
{ code: { [Op.like]: `%${keyword}%` } },
],
});
}
if (status !== undefined && status !== '') andConditions.push({ status: Number(status) });
// 货主筛选:0 表示主体级(无货主)
if (subsidiaryId !== undefined && subsidiaryId !== '') {
andConditions.push({ subsidiary_id: Number(subsidiaryId) === 0 ? null : Number(subsidiaryId) });
}
const { count, rows } = await ctx.model.ProductUnit.findAndCountAll({
where: { [Op.and]: andConditions },
offset,
limit,
order: [[ 'sort', 'ASC' ], [ 'id', 'ASC' ]],
include: [
{ model: ctx.model.PrincipalSubsidiary, as: 'subsidiary', attributes: [ 'id', 'name' ], required: false },
],
});
const list = await attachUsedCount(ctx, COLUMN, rows);
// 附加扁平的货主名称(主体级为空串)
const data = list.map(row => ({ ...row, subsidiary_name: row.subsidiary ? row.subsidiary.name : '' }));
ctx.body = { code: 0, message: 'success', data: buildPageResult(data, count, { page, pageSize }) };
}
/**
* @summary 商品单位下拉(仅启用)
* @description 供商品表单选择单位,按 sort 升序返回
* @router get /api/product-units/select
* @apikey
* @response 200 baseResponse success
*/
async select() {
const { ctx } = this;
const Op = this.app.Sequelize.Op;
const principalId = ctx.state.principalId;
const scope = await resolveScope(ctx);
const andConditions = [{ [Op.or]: [{ principal_id: principalId }, { is_system: 1 }] }];
const visible = visibilityWhere(ctx, scope);
if (visible) andConditions.push(visible);
const rows = await ctx.model.ProductUnit.findAll({
where: { status: 1, [Op.and]: andConditions },
attributes: [ 'id', 'name', 'code', 'subsidiary_id' ],
order: [[ 'sort', 'ASC' ], [ 'id', 'ASC' ]],
});
ctx.body = { code: 0, message: 'success', data: rows };
}
/**
* @summary 商品单位详情
* @router get /api/product-units/{id}
* @apikey
* @request path integer *id 单位主键ID
* @response 200 baseResponse success
*/
async show() {
const { ctx } = this;
const item = await ctx.model.ProductUnit.findByPk(ctx.params.id, {
include: [
{ model: ctx.model.PrincipalSubsidiary, as: 'subsidiary', attributes: [ 'id', 'name' ], required: false },
],
});
if (!item) {
ctx.status = 404;
ctx.body = { code: 404, message: '商品单位不存在' };
return;
}
if (!isVisible(item, await resolveScope(ctx))) {
ctx.status = 403;
ctx.body = { code: 403, message: '仅可查看自己所属公司或主体级的商品单位' };
return;
}
const plain = item.toJSON();
plain.subsidiary_name = plain.subsidiary ? plain.subsidiary.name : '';
ctx.body = { code: 0, message: 'success', data: plain };
}
/**
* @summary 新增商品单位
* @description 同一主体下单位名称唯一
* @router post /api/product-units
* @apikey
* @request body createProductUnitRequest *body
* @response 200 baseResponse success
*/
async create() {
const { ctx } = this;
const body = ctx.request.body || {};
const principalId = ctx.state.principalId;
const name = String(body.name || '').trim();
if (!name) {
ctx.status = 400;
ctx.body = { code: 400, message: '单位名称为必填项' };
return;
}
const Op = this.app.Sequelize.Op;
// 货主为空表示主体级;所在公司权限只能选主体或自己所属公司
const scope = await resolveScope(ctx);
const subsidiary = await resolveSubsidiaryValue(ctx, scope, body.subsidiary_id);
if (!subsidiary.ok) {
ctx.status = subsidiary.forbidden ? 403 : 400;
ctx.body = { code: ctx.status, message: subsidiary.message };
return;
}
// 同一货主范围内不可重名(系统数据可直接复用)
const exist = await ctx.model.ProductUnit.findOne({
where: {
name,
subsidiary_id: subsidiary.value,
[Op.or]: [{ principal_id: principalId }, { is_system: 1 }],
},
});
if (exist) {
ctx.body = { code: 0, message: 'success', data: { id: exist.id } };
return;
}
const item = await ctx.model.ProductUnit.create({
...body,
principal_id: principalId,
subsidiary_id: subsidiary.value,
name,
is_system: 0,
});
ctx.body = { code: 0, message: 'success', data: { id: item.id } };
}
/**
* @summary 更新商品单位
* @description 未传入的字段保持原值;同一主体下单位名称唯一
* @router put /api/product-units/{id}
* @apikey
* @request path integer *id 单位主键ID
* @request body updateProductUnitRequest *body
* @response 200 baseResponse success
*/
async update() {
const { ctx } = this;
const item = await ctx.model.ProductUnit.findByPk(ctx.params.id);
if (!item) {
ctx.status = 404;
ctx.body = { code: 404, message: '商品单位不存在' };
return;
}
if (item.is_system) {
ctx.status = 400;
ctx.body = { code: 400, message: '系统默认数据不可修改' };
return;
}
const scope = await resolveScope(ctx);
if (!isVisible(item, scope)) {
ctx.status = 403;
ctx.body = { code: 403, message: '仅可修改自己所属公司或主体级的商品单位' };
return;
}
const body = { ...(ctx.request.body || {}) };
delete body.is_system;
const subsidiary = await resolveSubsidiaryValue(ctx, scope, body.subsidiary_id);
if (!subsidiary.ok) {
ctx.status = subsidiary.forbidden ? 403 : 400;
ctx.body = { code: ctx.status, message: subsidiary.message };
return;
}
body.subsidiary_id = subsidiary.value;
if (body.name !== undefined) {
const name = String(body.name).trim();
if (!name) {
ctx.status = 400;
ctx.body = { code: 400, message: '单位名称不能为空' };
return;
}
const exist = await ctx.model.ProductUnit.findOne({
where: { principal_id: item.principal_id, name, subsidiary_id: subsidiary.value },
});
if (exist && Number(exist.id) !== Number(item.id)) {
ctx.status = 400;
ctx.body = { code: 400, message: `单位「${name}」已存在` };
return;
}
body.name = name;
}
await item.update(body);
ctx.body = { code: 0, message: 'success', data: { id: item.id } };
}
/**
* @summary 删除商品单位
* @description 若该单位已被商品引用(products.unit_id),禁止删除;否则物理删除
* @router delete /api/product-units/{id}
* @apikey
* @request path integer *id 单位主键ID
* @response 200 baseResponse success
*/
async destroy() {
const { ctx } = this;
const item = await ctx.model.ProductUnit.findByPk(ctx.params.id);
if (!item) {
ctx.status = 404;
ctx.body = { code: 404, message: '商品单位不存在' };
return;
}
if (item.is_system) {
ctx.status = 400;
ctx.body = { code: 400, message: '系统默认数据不可删除' };
return;
}
if (!isVisible(item, await resolveScope(ctx))) {
ctx.status = 403;
ctx.body = { code: 403, message: '仅可删除自己所属公司或主体级的商品单位' };
return;
}
const used = await ctx.model.Product.count({ where: { principal_id: item.principal_id, unit_id: item.id } });
if (used > 0) {
ctx.status = 400;
ctx.body = { code: 400, message: `该单位已被 ${used} 个商品使用,禁止删除` };
return;
}
await item.destroy();
ctx.body = { code: 0, message: 'success', data: { id: Number(ctx.params.id) } };
}
}
module.exports = ProductUnitController;