'use strict'; const { Controller } = require('egg'); const { parsePagination, buildPageResult } = require('../lib/pagination'); const { BIZ_TYPES, BIZ_TYPE_LIST, DIRECTION_LABELS } = require('../utils/stockRecord'); /** * 把查询入参转成 Date:日期(YYYY-MM-DD)按当天 00:00:00 / 23:59:59 处理,含时间的按原值 * @param {String} value 入参时间字符串 * @param {Boolean} isEnd 是否为区间结束(true 时补到当天最后一刻) * @return {Date|null} Date 或 null */ function toDate(value, isEnd) { const raw = String(value == null ? '' : value).trim(); if (!raw) return null; const normalized = raw.includes('T') ? raw : raw.replace(' ', 'T'); const dateOnly = /^\d{4}-\d{2}-\d{2}$/.test(raw); const text = dateOnly ? `${raw}T${isEnd ? '23:59:59' : '00:00:00'}` : normalized; const date = new Date(text); return Number.isNaN(date.getTime()) ? null : date; } /** * @controller StockRecordController 出入库记录(库存流水) * * 记录每一次库存变动:出库单推送锁定、出库解锁、出库确认扣减、出库驳回回补、入库确认增加, * 以及发货单(订单)审核锁定、订单解锁、订单发货确认扣减, * 写入入口统一在 app/utils/stockRecord.js(与库存变动同事务),本控制器只提供只读查询。 * 数据按主体隔离(principal_id 由 principalCheck 中间件校验后写入 ctx.state.principalId)。 */ class StockRecordController extends Controller { /** * @summary 出入库记录列表 * @description 分页查询当前主体下的库存流水,支持按商品、仓库、业务动作、出入方向、单据类型、 * 单据号与时间区间过滤;keyword 同时匹配单据号/商品编码/商品名称。 * 前端可先用商品选择器按「商品编码/商品名称」关键词锁定 product_id,再按商品精确查询。 * @router get /api/stock-records * @apikey * @request query integer page 页码,默认 1 * @request query integer pageSize 每页条数,默认 20 * @request query integer product_id 商品ID(商品选择器锁定后传入,精确匹配) * @request query integer warehouse_id 仓库ID * @request query string biz_type 业务动作:outbound_lock 出库推送锁定 / outbound_unlock 出库解锁 / outbound_deduct 出库确认扣减 / outbound_restore 出库驳回回补 / inbound_increase 入库确认增加 / order_lock 订单审核锁定 / order_unlock 订单解锁 / order_deduct 订单发货确认扣减 * @request query integer direction 业务方向:1入库方向 2出库方向 * @request query integer bill_type 单据类型:1入库单 2出库单 3发货单(订单) * @request query string item_type 库存类型:ZC 正品 / CC 残次品 * @request query string bill_no 单据号,支持模糊匹配 * @request query string keyword 关键词,匹配单据号/商品编码/商品名称 * @request query string start_time 记录时间起(YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss) * @request query string end_time 记录时间止(日期只写到天时按当天 23:59:59) * @response 200 stockRecordListResponse success */ async index() { const { ctx } = this; const Op = this.app.Sequelize.Op; const { page, pageSize, offset, limit } = parsePagination(ctx.query); const { product_id: productId, warehouse_id: warehouseId, biz_type: bizType, direction, bill_type: billType, item_type: itemType, bill_no: billNo, keyword, start_time: startTime, end_time: endTime, } = ctx.query; const where = { principal_id: ctx.state.principalId }; if (productId) where.product_id = Number(productId); if (warehouseId) where.warehouse_id = Number(warehouseId); if (bizType) where.biz_type = String(bizType).trim(); if (direction !== undefined && direction !== '') where.direction = Number(direction); if (billType !== undefined && billType !== '') where.bill_type = Number(billType); if (itemType) where.item_type = String(itemType).trim().toUpperCase(); if (billNo) where.bill_no = { [Op.like]: `%${billNo}%` }; // 关键词:未锁定商品时用模糊匹配(单据号 / 商品编码 / 商品名称);已锁定商品时用 product_id 精确过滤 if (keyword) { where[Op.or] = [ { bill_no: { [Op.like]: `%${keyword}%` } }, { item_code: { [Op.like]: `%${keyword}%` } }, { item_name: { [Op.like]: `%${keyword}%` } }, ]; } const startDate = toDate(startTime, false); const endDate = toDate(endTime, true); if (startDate || endDate) { where.created_at = {}; if (startDate) where.created_at[Op.gte] = startDate; if (endDate) where.created_at[Op.lte] = endDate; // 只有一个边界时补全另一个,避免 Sequelize 生成空条件 if (!startDate) where.created_at[Op.gte] = new Date(0); if (!endDate) where.created_at[Op.lte] = new Date(); } const { count, rows } = await ctx.model.StockRecord.findAndCountAll({ where, offset, limit, order: [[ 'id', 'DESC' ]], }); // 附上中文标签,前端直接展示(避免前后端枚举文案漂移) const list = rows.map(row => { const item = row.get ? row.get({ plain: true }) : row; const meta = BIZ_TYPES[item.biz_type] || {}; item.biz_type_label = meta.label || item.biz_type; item.direction_label = DIRECTION_LABELS[item.direction] || ''; return item; }); ctx.body = { code: 0, message: 'success', data: buildPageResult(list, count, { page, pageSize }) }; } /** * @summary 出入库记录业务动作选项 * @description 返回业务动作枚举(值与中文名、方向、单据类型),供前端筛选下拉使用,避免前后端枚举漂移 * @router get /api/stock-records/biz-types * @apikey * @response 200 baseResponse success */ async bizTypes() { const { ctx } = this; ctx.body = { code: 0, message: 'success', data: BIZ_TYPE_LIST }; } } module.exports = StockRecordController;