Appearance
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.ts、frontend/src/shared/api/acc/home.ts
小程序:miniapp/src/types/acc-home-summary.ts、miniapp/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/finished | goodsStocks 按 goodsType → splitGoodsStocksByType |
请求参数
| 参数 | Web | 小程序经理报表 |
|---|---|---|
siteId | useAccSiteContext | 当前站点 ref |
finishedProcessTrendDays | 7 / 14 / 30 / 90 | 7 / 14 / 30 / 90(ACC_HOME_MINIAPP_TREND_DAY_OPTIONS) |
不在本接口的模块
经理报表 记工 Tab、月结 Tab 使用其它 API(记工汇总、月结巡检);记工 Tab 未选工人时展示全站 labor.* / settlement.* 与 AccHome 对照。见 miniapp-manager-reports.md。
工程债(不挡发版)
GoodsSaveDialog、ProductionWipAddDialog、UserEditDialog等大弹窗拆分见 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 # 若改小程序