oms/backend/app/controller/dashboard.js
liufumingren 489563a4b2 feat(backend): 仪表盘报表接口、配置裁剪、单号 5 位与账号名称/头像
- 仪表盘报表:新增 app/service/dashboard.js + app/controller/dashboard.js +
  app/lib/billStatus.js,注册 GET /api/dashboard/report(jwtAuth + principalCheck),
  一次聚合返回概览指标、发货单/入库单/出库单状态分布与待办、近 N 天单据量与
  出入库数量趋势、库存 Top 商品、最近出入库流水;warehouse_id 只过滤单据与流水
  (product_stocks 无仓库维度);契约 dashboard* 同步到 swagger
- 接口配置裁剪:仓库接口配置只保留 api_version 与 item_name_with_spec;
  历史 warehouse_apis.extra 冗余键、owner_code 配置、递交/回传设置一并清理
  (迁移 20260915002400~02800)
- 入库/出库/发货单报文与字段对齐 WMS 标准:去掉 ownerCode、operatorCode 等多余字段,
  入库明细补 itemId;发货单明细去掉无意义的 owner_code(迁移 20260915002600)
- 单号 5 位起:四张单据表 AUTO_INCREMENT 提到 10000(迁移 20260915002900)
- 账号名称/头像按主体维护:principal_users 增 name/avatar 并回填(迁移 20260915003000/03100),
  新增 app/lib/accountProfile.js(关联表名称/头像 → users 兜底);审核人写入 operator/operator_name;
  register 不再写 nickname、updateProfile 仅接受邮箱/手机号
- 出库单推送/锁库存链路的配套调整(outboundOrderPush、订单与发货单控制器)

Co-Authored-By: GitHub Copilot <noreply@github.com>
2026-09-14 16:09:35 +08:00

43 lines
1.9 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 DashboardController 仪表盘报表
*
* 只读聚合接口:基于现有单据(发货单/入库单/出库单)、库存(product_stocks)
* 与库存流水(stock_records)生成概览指标、单据状态分布与待办、近 N 天趋势、
* 库存 Top 商品与最近流水。数据按主体隔离(principal_id 由 principalCheck 中间件校验)。
*/
class DashboardController extends Controller {
/**
* @summary 仪表盘报表数据
* @description 一次返回仪表盘所需的全部聚合数据,避免前端多次请求:
* overview 概览指标、bills 三类单据的状态分布与待办数、todo 待办清单(带跳转路径)、
* trend 近 N 天单据量与出入库数量趋势、top_products 库存 Top 商品、
* recent_records 最近出入库流水。
* 说明:product_stocks 只有 (principal_id, product_id, item_type) 维度,没有仓库字段,
* 因此 warehouse_id 只过滤单据与流水,不影响库存概览与 Top 商品。
* @router get /api/dashboard/report
* @apikey
* @request query integer principal_id 主体ID(前端拦截器自动注入)
* @request query integer days 趋势区间天数,支持 7/14/30/90,其他值按 7 处理
* @request query integer warehouse_id 仓库ID(可选,过滤单据与流水)
* @response 200 dashboardReportResponse success
*/
async report() {
const { ctx } = this;
const { days, warehouse_id: warehouseId } = ctx.query;
const data = await ctx.service.dashboard.report({
principalId: ctx.state.principalId,
days,
warehouseId: warehouseId ? Number(warehouseId) : null,
});
ctx.body = { code: 0, message: 'success', data };
}
}
module.exports = DashboardController;