'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;