Skip to content

Acc 首页 / 经理报表指标口径对照

Web AccHomeView 与小程序 pages/manager/reports(站点 Tab)共用 POST /acc/home/summary

类型与合计逻辑(单一来源)

路径
API 响应类型shared/types/acc-home-summary.ts
趋势合计(出货/销售/毛利/产出)shared/utils/acc-home-summary-metrics.ts
对照单测backend/src/libs/shared/acc-home-summary-metrics.spec.ts(与 shared 实现同步;test:permission 内执行)

前端 re-export:frontend/src/shared/types/acc-home-summary.tsfrontend/src/shared/api/acc/home.ts
小程序:miniapp/src/types/acc-home-summary.tsminiapp/src/api/acc-home.ts

字段对照表

展示位置指标API 字段 / 计算
两端本月入库/出库单month.inboundOrders / month.outboundOrders
两端商品档案goods.total / goods.raw / goods.finished
两端往来partners.*
两端在制/关账/冲红production.open / closed / voided
两端记工待结算/已进单labor.pendingLines / settledLines
两端结算已结/已付settlement.settled / paid
Web 独有待结算记工批次表pendingLaborBatches[]
两端近 N 天出货数量合计sum(outboundSalesTrend.points[].outboundQty)computeAccHomeTrendTotals
两端近 N 天销售金额合计sum(...saleAmount)
两端近 N 天毛利合计sum(...profitAmount)(后端为出库单利润字段)
两端近 N 天成品产出合计sum(finishedProcessTrend.points[].qty)
两端库存预览 raw/finishedgoodsStocksgoodsTypesplitGoodsStocksByType

请求参数

参数Web小程序经理报表
siteIduseAccSiteContext当前站点 ref
finishedProcessTrendDays7 / 14 / 30 / 907 / 14 / 30 / 90ACC_HOME_MINIAPP_TREND_DAY_OPTIONS

不在本接口的模块

经理报表 记工 Tab月结 Tab 使用其它 API(记工汇总、月结巡检);记工 Tab 未选工人时展示全站 labor.* / settlement.* 与 AccHome 对照。见 miniapp-manager-reports.md

工程债(不挡发版)

  • GoodsSaveDialogProductionWipAddDialogUserEditDialog 等大弹窗拆分见 roadmap-four-tracks.md Track 4。

验收

bash
pnpm --filter taskflow-backend exec jest acc-home-summary-metrics.spec.ts --no-cache
pnpm run check:frontend   # 若改 Web
pnpm run check:miniapp    # 若改小程序

TaskFlow 内部文档 Released under the MIT License.