227 lines
7.0 KiB
JavaScript
227 lines
7.0 KiB
JavaScript
'use strict';
|
||
|
||
const { Controller } = require('egg');
|
||
|
||
/**
|
||
* @controller OrderController 订单管理
|
||
*/
|
||
class OrderController extends Controller {
|
||
/**
|
||
* @summary 订单列表
|
||
* @description 分页查询订单,支持按主体、订单号、主状态、WMS 状态、上交状态过滤
|
||
* @router get /api/orders
|
||
* @apikey
|
||
* @request query integer page 页码,默认 1
|
||
* @request query integer pageSize 每页条数,默认 20
|
||
* @request query integer principal_id 所属主体ID(必填,需当前账号已绑定该主体)
|
||
* @request query string order_no 业务订单号,支持模糊匹配
|
||
* @request query integer status 主状态:1待处理 2处理中 3已完成 4已取消
|
||
* @request query string wms_status 外部WMS状态,如 CREATED/PICKING/SHIPPED
|
||
* @request query integer submit_status 上交状态:0未上交 1上交中 2已上交 3上交失败
|
||
* @response 200 orderListResponse success
|
||
*/
|
||
async index() {
|
||
const { ctx } = this;
|
||
const Op = this.app.Sequelize.Op;
|
||
const page = Number(ctx.query.page || 1);
|
||
const pageSize = Number(ctx.query.pageSize || 20);
|
||
const {
|
||
order_no: orderNo,
|
||
status,
|
||
wms_status: wmsStatus,
|
||
submit_status: submitStatus,
|
||
} = ctx.query;
|
||
const principalId = ctx.state.principalId;
|
||
|
||
const where = {};
|
||
where.principal_id = principalId;
|
||
if (orderNo) where.order_no = { [Op.like]: `%${orderNo}%` };
|
||
if (status !== undefined && status !== '') where.status = Number(status);
|
||
if (wmsStatus) where.wms_status = wmsStatus;
|
||
if (submitStatus !== undefined && submitStatus !== '') where.submit_status = Number(submitStatus);
|
||
|
||
const { count, rows } = await ctx.model.Order.findAndCountAll({
|
||
where,
|
||
offset: (page - 1) * pageSize,
|
||
limit: pageSize,
|
||
order: [[ 'id', 'DESC' ]],
|
||
});
|
||
|
||
ctx.body = { code: 0, message: 'success', data: { list: rows, total: count, page, pageSize } };
|
||
}
|
||
|
||
/**
|
||
* @summary 订单详情
|
||
* @description 按主键查询订单,含主状态、WMS 状态与上交状态
|
||
* @router get /api/orders/{id}
|
||
* @apikey
|
||
* @request path integer *id 订单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async show() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.Order.findByPk(ctx.params.id);
|
||
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '订单不存在' };
|
||
return;
|
||
}
|
||
|
||
ctx.body = { code: 0, message: 'success', data: order };
|
||
}
|
||
|
||
/**
|
||
* @summary 新增订单
|
||
* @description 订单号 order_no 全局唯一;初始主状态默认 1(待处理)
|
||
* @router post /api/orders
|
||
* @apikey
|
||
* @request body createOrderRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async create() {
|
||
const { ctx } = this;
|
||
const { order_no: orderNo, principal_id: principalId } = ctx.request.body;
|
||
|
||
if (!orderNo || !principalId) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'order_no 与 principal_id 为必填项' };
|
||
return;
|
||
}
|
||
|
||
const exist = await ctx.model.Order.findOne({ where: { order_no: orderNo } });
|
||
if (exist) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '订单号已存在' };
|
||
return;
|
||
}
|
||
|
||
const order = await ctx.model.Order.create({
|
||
status: 1,
|
||
submit_status: 0,
|
||
...ctx.request.body,
|
||
});
|
||
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id } };
|
||
}
|
||
|
||
/**
|
||
* @summary 更新订单
|
||
* @description 未传入的字段保持原值;状态流转建议使用专用状态接口
|
||
* @router put /api/orders/{id}
|
||
* @apikey
|
||
* @request path integer *id 订单主键ID
|
||
* @request body updateOrderRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async update() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.Order.findByPk(ctx.params.id);
|
||
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '订单不存在' };
|
||
return;
|
||
}
|
||
|
||
delete ctx.request.body.principal_id;
|
||
await order.update(ctx.request.body);
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id } };
|
||
}
|
||
|
||
/**
|
||
* @summary 订单状态流转(主状态/上交状态)
|
||
* @description 更新主状态与上交(上报)状态;上交成功时自动写入 submit_at
|
||
* @router put /api/orders/{id}/status
|
||
* @apikey
|
||
* @request path integer *id 订单主键ID
|
||
* @request body updateOrderStatusRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async updateStatus() {
|
||
const { ctx } = this;
|
||
const { status, submit_status: submitStatus, submit_order_no: submitOrderNo, submit_msg: submitMsg } = ctx.request.body;
|
||
const order = await ctx.model.Order.findByPk(ctx.params.id);
|
||
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '订单不存在' };
|
||
return;
|
||
}
|
||
|
||
const data = {};
|
||
if (status !== undefined && status !== '') data.status = Number(status);
|
||
if (submitStatus !== undefined && submitStatus !== '') {
|
||
data.submit_status = Number(submitStatus);
|
||
data.submit_at = new Date();
|
||
}
|
||
if (submitOrderNo !== undefined) data.submit_order_no = submitOrderNo;
|
||
if (submitMsg !== undefined) data.submit_msg = submitMsg;
|
||
|
||
await order.update(data);
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id } };
|
||
}
|
||
|
||
/**
|
||
* @summary 外部WMS状态回写
|
||
* @description 由 WMS 回调调用,更新外部WMS状态、WMS单号与同步时间
|
||
* @router put /api/orders/{id}/wms-status
|
||
* @apikey
|
||
* @request path integer *id 订单主键ID
|
||
* @request body wmsStatusRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async updateWmsStatus() {
|
||
const { ctx } = this;
|
||
const { wms_status: wmsStatus, wms_order_no: wmsOrderNo, status, message } = ctx.request.body;
|
||
|
||
if (!wmsStatus) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'wms_status 为必填项' };
|
||
return;
|
||
}
|
||
|
||
const order = await ctx.model.Order.findByPk(ctx.params.id);
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '订单不存在' };
|
||
return;
|
||
}
|
||
|
||
const data = {
|
||
wms_status: wmsStatus,
|
||
wms_synced_at: new Date(),
|
||
};
|
||
if (wmsOrderNo !== undefined) data.wms_order_no = wmsOrderNo;
|
||
if (status !== undefined && status !== '') data.status = Number(status);
|
||
if (message !== undefined) data.submit_msg = message;
|
||
|
||
await order.update(data);
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id } };
|
||
}
|
||
|
||
/**
|
||
* @summary 删除订单
|
||
* @description 物理删除订单
|
||
* @router delete /api/orders/{id}
|
||
* @apikey
|
||
* @request path integer *id 订单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async destroy() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.Order.findByPk(ctx.params.id);
|
||
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '订单不存在' };
|
||
return;
|
||
}
|
||
|
||
await order.destroy();
|
||
ctx.body = { code: 0, message: 'success', data: { id: Number(ctx.params.id) } };
|
||
}
|
||
}
|
||
|
||
module.exports = OrderController;
|