M4 结算 — Web / 小程序列表筛选参数对齐

与 m4-settlement-manual-checklist.md 用例 #3、Track 1 路线图「结算列表/详情对齐」配套。

接口

POST /acc/settlement/page · DTO：backend/src/apps/acc/modules/settlement/dto/settlement-page.dto.ts

共享类型：shared/types/acc-settlement-page-query.ts（AccSettlementPageQuery）

参数对照

字段	Web AccSettlementListView	小程序 useSettlementList	说明
siteId	useAccSiteListFetch 当前站	getStoredSiteId()	必填
current / size	PageQueryTable 分页	z-paging pageNo / pageSize	PageQueryDto 归一化
workerId	远程工人下拉 → workerId	useSettlementListWorkerFilter → filterWorkerId	关键字搜索后落 ID
status	状态下拉（含「全部」空串）	SettlementListStatusTab Tab	draft / settled / paid
dateFrom / dateTo	dateRange[0] / [1]	useSettlementListBizDateFilter → ymdFromTimestamp	YYYY-MM-DD；未选为不传

后端语义：dateTo 为当日结束（含当天 23:59:59），与 Web 日期区间选择一致（settlement.service.ts bizDate 过滤）。

客户端入口

端	文件
Web	frontend/src/views/acc/settlement/AccSettlementListView.vue → accSettlementPage
小程序	miniapp/src/composables/manager/useSettlementList.ts → fetchSettlementPage
API 封装	frontend/src/shared/api/acc/settlement.ts、miniapp/src/pages/manager/api/acc-settlement.ts（工人端 pages/worker/api/acc-settlement.ts）

开发验收（代码仓，发版前）

• ✅ 上表字段名与 SettlementPageDto 一致
• ✅ 小程序 Tab status 与 Web ACC_SETTLEMENT_STATUS_FILTER_OPTIONS 同枚举
• ⬜ 预发/生产：手工表 m4-settlement-manual-checklist.md 用例 1–7 勾选（人工业务签字）

手工验收提示（#3）

1. Web 选工人 A、日期区间、状态「已结算」，记下首条 settleNo。
2. 小程序同站、同工人筛选、同日期、同 Tab，列表应含该单且顺序/总数与 Web 一致（分页 size 可不同，总数 total 须一致）。

详情 / 标记发放 / 工资条见手工表其余用例。