- 仪表盘报表:新增 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>
43 lines
1.9 KiB
JavaScript
43 lines
1.9 KiB
JavaScript
'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;
|