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