oms/backend/app/controller/warehouseApiField.js
liufumingren cbd16752a5 feat(backend): 商品、店铺、组合商品、仓库与库存模块
- 商品/商品图片、店铺、店铺商品、组合商品及明细
- 仓库、仓库商品(WMS itemId 映射)、仓库接口配置与字段定义(warehouseApi/warehouseApiField)
- 库存:stock_items、product_stocks(ZC/CC 双维度)与库存重算工具(utils/recalcStock.js)
- 库存单据与对接日志:stock orders、api_outbound_logs
- 相关迁移:shops/shop_products/stock_orders/warehouses/warehouse_apis/warehouse_products/product_stocks/files-images 等表与字段
2026-09-13 02:23:39 +08:00

99 lines
2.9 KiB
JavaScript
Raw Permalink 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 {
FIELD_TYPE_LIST,
listGroupDefs,
listFieldDefs,
normalizeFieldValues,
} = require('../lib/warehouseApiFields');
/**
* @controller WarehouseApiFieldController 仓库接口配置项
* 配置项定义(分组 + 字段清单 + 类型)硬编码在 app/lib/warehouseApiFields.js;
* 配置项值由本组接口整体覆盖读写,落库在 warehouse_apis.extra
*/
class WarehouseApiFieldController extends Controller {
/**
* @summary 配置项定义(硬编码分组、字段清单与类型枚举)
* @description 前端按 group 分组渲染小标题、按 type 渲染对应的表单控件;不需要传主体
* @router get /api/warehouse-api-fields
* @apikey
* @response 200 warehouseApiFieldSchemaResponse success
*/
async index() {
const { ctx } = this;
ctx.body = {
code: 0,
message: 'success',
data: {
types: FIELD_TYPE_LIST,
groups: listGroupDefs(),
fields: listFieldDefs(),
},
};
}
/**
* @summary 查询某个接口配置的配置项值
* @description 统一走模型 getFieldValues() 读取,返回 { 字段名: 值 } JSON 对象,未配置的字段返回硬编码默认值
* @router get /api/warehouse-apis/{id}/fields
* @apikey
* @request path integer *id 接口配置主键ID
* @response 200 warehouseApiFieldValuesResponse success
*/
async show() {
const { ctx } = this;
const item = await this.findApi(ctx.params.id);
if (!item) return;
ctx.body = {
code: 0,
message: 'success',
data: { api_id: Number(item.id), values: item.getFieldValues() },
};
}
/**
* @summary 保存某个接口配置的配置项值
* @description 按字段类型校验后整体覆盖保存;字段 key 需在硬编码清单内
* @router put /api/warehouse-apis/{id}/fields
* @apikey
* @request path integer *id 接口配置主键ID
* @request body updateWarehouseApiFieldValuesRequest *body
* @response 200 baseResponse success
*/
async update() {
const { ctx } = this;
const item = await this.findApi(ctx.params.id);
if (!item) return;
const { values, errors } = normalizeFieldValues(ctx.request.body.values);
if (errors.length) {
ctx.status = 400;
ctx.body = { code: 400, message: errors.join(';') };
return;
}
await item.update({ extra: values });
ctx.body = { code: 0, message: 'success', data: { api_id: Number(item.id) } };
}
/**
* 按主键取接口配置,不存在时写 404 响应
* @param {String|Number} id 接口配置主键
* @return {Object|null} 接口配置实例
*/
async findApi(id) {
const { ctx } = this;
const item = await ctx.model.WarehouseApi.findByPk(id);
if (!item) {
ctx.status = 404;
ctx.body = { code: 404, message: '接口配置不存在' };
return null;
}
return item;
}
}
module.exports = WarehouseApiFieldController;