227 lines
7.0 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');
/**
* @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;