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/pages/manager/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。
Web 大弹窗拆分（Track 4，已完成）
以下弹窗已拆为 composable + 子组件，详见 roadmap-four-tracks.md Track 4「代码对照」表：
| 弹窗 | composable | 子组件示例 |
|---|---|---|
GoodsSaveDialog | useGoodsSaveDialog | GoodsSaveBomSection、GoodsSaveProcessStepsSection |
ProductionWipAddDialog | useProductionWipAddDialog | ProductionWipAddLaborFields |
UserEditDialog | useUserEditDialog | UserEditFormBody、UserEditRoleSiteSection |
验收
bash
pnpm --filter taskflow-backend exec jest acc-home-summary-metrics.spec.ts --no-cache
pnpm run check:frontend # 若改 Web
pnpm run check:miniapp # 若改小程序