提交图
100 次代码提交
作者 SHA1 备注 提交日期
yaosutu bb6df1469a docs(changelog): 订正 04_8714 团期核单确认门禁契约(#8783 PR #8784):confirm blocking 非空服务端硬拦 589568、负金额 400 改抛 589753、零值金额统一 0.00(修改接口·管理后台)
changelog-filename-gate / validate (push) Failing after 1s
2026-10-04 14:23:28 +08:00
yaosutu d47e68a451 docs(changelog): 团期核单重做8类tab明细+公摊/指定报名拆账前端契约(#8714 整批6PR + teamNo #8779)
changelog-filename-gate / validate (push) Failing after 2s
- 8 类费用 tab GET 换实现 + 新增 8 个 PUT 整 tab 暂存(全量替换 + expectedVersion CAS)
- 新增面板族 7 端点:panel / sub-orders / lines 增删 / panel confirm / alloc-preview / invoice
- 旧 /audit 6 端点下线 404,旧四表 DROP
- sharedCostByType 键值 BatchCostType 4 值切 settlement_category 8 值
- 错误码新增 589750-589755 拆账段,589569/589570 废弃
2026-10-04 10:43:41 +08:00
yaosutu 97056b0370 docs(changelog): 8768 资金账户盘盈盘亏整功能下线(inventory-adjust 删除 + INVENTORY 枚举删除,管理后台)
changelog-filename-gate / validate (push) Failing after 1s
- POST /admin/finance/fund-accounts/{id}/inventory-adjust 已删,调用一律 404
- 资金流水 bizType 枚举删 INVENTORY(历史残留行 bizTypeName 返 null)
- 错误码 595106 废弃(码位保留不重发)
- 关联:Issue #8768 / PR #8773(代码)/ PR #8781(原型+文档)
2026-10-04 10:23:13 +08:00
yaosutu c200920a76 docs(changelog): 8751 往来台账净额视图破坏性契约 partyType(反转 #8719)
changelog-filename-gate / validate (push) Failing after 1s
2026-10-04 09:48:42 +08:00
yaosutu 5203c4a599 docs(changelog): 标注 #8719 台账 changelog 已被 #8751 净额视图反转(frontend_status→superseded)
changelog-filename-gate / validate (push) Failing after 1s
(SUPPLIER=供应商应付+应收轧差/CUSTOMER=客户应收),ledgerType 入参作废。
避免前端按旧文档开发,标注 superseded 指向 #8751 最新契约。
2026-10-03 15:40:33 +08:00
yaosutu 3d0a3d7757 feat(finance): 应收侧往来台账放开 ledgerType 扩域 changelog(#8719 / PR #8727)
changelog-filename-gate / validate (push) Failing after 2s
statements/page 与 entries/page 入参 ledgerType 由仅 SUPPLIER 扩为
SUPPLIER / SUPPLIER_RECV / CUSTOMER(STAFF 未开放报 596005);
netAmount/openingAmount 符号方向按账套分化,应收账套本期无流水空页属正常。
2026-10-02 17:09:34 +08:00
yaosutu 26c43ee57c feat(order-v3): 微信商户对账管理端 6 端点 changelog(#8690 / PR #8703)
changelog-filename-gate / validate (push) Failing after 1s
对账汇总/逐笔记录/差异列表/差异详情/处理差异/手动补跑,5824 段错误码 + 4 组枚举全量内联
2026-10-02 11:22:55 +08:00
yaosutu b41e3df62d feat(finance): 往来账财务调账5端点 changelog(#8699)
changelog-filename-gate / validate (push) Failing after 2s
新增 /admin/finance/adjusts 5 端点:TZ调账单+页内审批+应收/应付入账联动。
2026-10-02 09:57:09 +08:00
yaosutu 5c13bfd8b4 docs(changelog): fin_advance 抽象化接通团期级预支,反转 #8680 详情出参(#8693)
changelog-filename-gate / validate (push) Failing after 2s
2026-10-01 23:03:54 +08:00
yaosutu 4123a6a59c 核销管理后端落地:坏账核销/债务豁免 5 端点(#8689)
changelog-filename-gate / validate (push) Failing after 2s
2026-10-01 17:42:29 +08:00
yaosutu fbd759f003 feat(finance): 收款账户关联服务人员档案 changelog(#8679)
changelog-filename-gate / validate (push) Failing after 2s
个人类收款方从手填改为档案下拉选人:新增 staff-candidates 候选接口 +
create 个人类 payeeRefId 必填/payeeName 档案真名覆盖/档案校验。财务域推
changelogs-v2/ 管理后台。
2026-10-01 16:35:55 +08:00
yaosutu ba729d6623 feat(finance): ADVANCE 已付台账补预支详情接口 changelog(#8680)
changelog-filename-gate / validate (push) Failing after 2s
新增 GET /admin/finance/advances/{id},补齐已付台账 8 页签明细抽屉最后一环。
2026-10-01 14:23:52 +08:00
yaosutu bed946723f docs(changelog): #8673 应付款列表默认只看欠款 + 付款明细补全量支付状态
changelog-filename-gate / validate (push) Failing after 1s
2026-10-01 09:58:57 +08:00
yaosutu 8b8c147a1c 团期核单页签 changelog 示例数据修正为部署后实测(#8671)
changelog-filename-gate / validate (push) Failing after 1s
§8.1 示例改为真实响应:T26-2325 核单中(REVIEWING/stage=核单)、T26-5936 已结算(SETTLED/stage=结算),
当前库无待核单团故 total=2;补充说明待核单团仍显示出行节点。
2026-10-01 09:32:19 +08:00
yaosutu b82d4f4e6e 团期核单页签 opsStage=REVIEW 筛选口径扩为核单三态(#8671)
changelog-filename-gate / validate (push) Failing after 2s
changelogs-v2/2026-10/01_8671_团期核单页签扩为核单三态-修改接口-管理后台.md
2026-10-01 09:18:32 +08:00
yaosutu 86c8752549 新增 公司借款单笔收回端点 changelog(管理后台)(#8664)
changelog-filename-gate / validate (push) Failing after 2s
2026-10-01 07:20:18 +08:00
yaosutu 0e8500103a docs(changelog): #8663 公司借款域往来单位放开员工类型 + 归还归支付管理 + 双 tab
changelog-filename-gate / validate (push) Failing after 1s
2026-09-30 21:14:16 +08:00
yaosutu 7242ab4108 收款方类型 payeeType 删 STAFF 拆为司机/导游/摄影/领队四类个人,保留 FLEET/GUIDE_CO/SUPPLIER(#8657)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-30 15:55:25 +08:00
yaosutu dc080e389e docs(changelog): #8655 资金明细页补筛选控件对接指引(科目/账户/收支,接口已支持零改动)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-30 14:58:19 +08:00
yaosutu和Claude Opus 4.8 687999963b docs(changelog): 团期核团详情统一接口 return-detail 上线,reports/group 旧路径已删 404(#8641)
changelog-filename-gate / validate (push) Failing after 2s
- 新增 GET /v3/admin/order/group-batch/{gid}/settlement/return-detail 团期核团详情统一总览
- 出参新增 driverVehicles 司机车辆连续区间(本地快照按司机+车辆合并,driverPhone 脱敏)
- 原 /settlement/reports/group 已下线,调用返回业务码 404(HTTP 200 包装)
- PR #8651 / Issue #8641

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-30 14:18:12 +08:00
yaosutu 3f3f5e7558 docs(changelog): 团期核单分类科目明细 tab——8 个新增读端点(#8632)
changelog-filename-gate / validate (push) Failing after 2s
团期核单新增 8 个分类明细只读端点(/v3/admin/order/group-batch/{id}/settlement/{hotels,activities,vehicles,guide-fees,photographer-fees,meals,other-expenses,other-incomes}),
数据来自团维度 order_batch_audit_item 按 category 过滤,命名对齐核心订单核单 tab。
管理后台目录 changelogs-v2/,关联 PR #8634。
2026-09-30 11:04:46 +08:00
yaosutu 315e9dbb2e 财务初始化三tab对齐原型:纠偏前端4tab为3tab(应收初始化/应付初始化/现金银行初始化),删员工往来tab(#8507 #8511)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-30 10:32:47 +08:00
yaosutu a3dcb89d6e docs(finance): 司导往来账账页+明细两接口上线 changelog(#8626)
changelog-filename-gate / validate (push) Failing after 2s
新增 /admin/finance/statements/guide-ledger/page + /entries 两接口,
按带团服务人员(导游/司机/摄影/领队)聚合报账+预支现算净往来。
关联 PR #8574(初版)+ #8627(口径扩摄影/领队),Issue #8555 + #8626。
2026-09-30 10:04:41 +08:00
yaosutu aeedf41639 docs(changelog): 团期核单详情 frontmatter 补 hl-changelog/v2 必需 key(#8510)
changelog-filename-gate / validate (push) Failing after 1s
补 base / updated_at,修正为完整 v2 schema 以过 hl-changelog-gate。
2026-09-30 00:17:05 +08:00
yaosutu 447b3294a9 docs(changelog): 团期核单详情对齐常规订单核单——reports/group 出参新增 21 字段(#8510)
聚合复核 GET /v3/admin/order/group-batch/{id}/settlement/reports/group 出参对齐常规订单核单财务总览:
新增 11 金额字段 + 4 个 mirrorMatched + customers 客户合并列表 + 6 个人数汇总字段,
数据从单订单换成全团在团子订单合并(排除已取消),待收尾款与 /finance 同源。

管理后台目录 changelogs-v2/,关联 PR #8546。
2026-09-30 00:12:44 +08:00
yaosutu da2ea29e67 docs(changelog-v2): 应收期初新增供应商应收账套 SUPPLIER_RECV(应收初始化 tab 对接指引)(#8507)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-29 16:16:30 +08:00
yaosutu 9806253b4a docs(finance): 进项发票登记表单原型对齐与前端自查单(后端零改动)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-29 15:39:32 +08:00
yaosutu 6bb0506f37 docs(changelog): 应收台账加「全部/散客订单/团期」页签与行内查看按钮——前端动作指引(管理后台)
changelog-filename-gate / validate (push) Failing after 1s
面向前端(mmg)的实施清单:顶部按 rowType 三态页签分流(必须走后端过滤),
行内「查看」按钮按 rowType 分流跳转(ORDER 跳订单详情用 id,GROUP_BATCH 跳出团详情用 groupBatchId)。
后端 #8504 已部署测试服,接口契约见同目录 29_8504 接口 changelog。
2026-09-29 13:57:12 +08:00
yaosutu d7bec334e5 docs(changelog-v2): 应收台账新增 rowType 入参 + 查看按钮对接指引(PR #8505 / Issue #8504)
changelog-filename-gate / validate (push) Failing after 1s
2026-09-29 11:40:31 +08:00
yaosutu 7c7ece465c docs(finance): 供应商应付期初表单对接纠偏 changelog(后端接口零改动)
changelog-filename-gate / validate (push) Failing after 1s
财务初始化·供应商应付期初表单前端画错(手填雪花ID+双金额+必填佐证),
本文档给出正确 6 字段形态与字段映射,POST /admin/finance/opening-balances
入参/出参/枚举均无变更,无 Issue/PR。
2026-09-29 11:06:43 +08:00
yaosutu 9bcfc55fb8 feat(finance): 应收往来对象分类/应收性质下拉字典化 + 新增 /receipt/options 接口 changelog(#8501)
changelog-filename-gate / validate (push) Failing after 2s
管理后台 changelogs-v2;PR #8503,测试服已部署+网关实测验证
2026-09-29 11:00:46 +08:00
yaosutu 117a6815c7 docs(changelog): 团期预支防双花——团单子订单禁走订单级预支入口(589558)+团期财务在途口径补PAID (#8384)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-28 17:26:29 +08:00
yaosutu 348d17b646 docs(changelog): Epic #8361 团期报销核单一团一张——团期核单 finalize/confirm/reports 三端点新增 + 台账应收整团聚合一行(rowType/groupBatchId) + 报账单 biz 三字段 + 搜索兼容团号 + summary 新增 SETTLED(新增接口-管理后台)
changelog-filename-gate / validate (push) Failing after 1s
2026-09-27 10:18:54 +08:00
yaosutu 31b3e68b7a 新增尾款收款模型重构专题(确认行程主报账人必填化 + 核单欠收硬闸豁免 + 财务应收台账,#8248)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-24 15:28:24 +08:00
yaosutu a0413a53be docs(changelog): #8181 线下收款废除报账人代收DRIVER_CASH渠道——options出参channels移除DRIVER_CASH+register新增520417(尾款收款模型重构PR-1,修改接口-管理后台)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-22 17:07:15 +08:00
yaosutu 553b870997 docs(changelog): #8164 收票核销硬钩稽PR-2——钱侧防御钩子599413/599414(应付/预付编辑改价超额+删除/驳回有票关联硬拦,修改接口-管理后台)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-22 14:42:14 +08:00
yaosutu 6095307804 docs(changelog): #8161 收票核销硬钩稽PR-1——挂票生效态门槛599412+单据维度对账下钻biz-recon(修改接口-管理后台)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-22 12:02:54 +08:00
yaosutu 785c6ed84a feat(changelog): 财务应付款两批——冲抵预付(#8127)+建议清单统计页切流读台账(#8070)
changelog-filename-gate / validate (push) Failing after 1s
- 22_8127 应付款付款支持冲抵供应商预付款:4 建单/改单接口入参新增 prepayOffsets,
  详情出参新增 offsets[]/prepayOffsetAmount/actualPayAmount 真值化,新增 offsettable-prepays 查询
- 22_8070 应付款建议清单/统计页切流读推送台账:出参补 appliedAmount/owedAmount 口径字段 + isLocked 前置闸
2026-09-22 09:27:00 +08:00
yaosutu 334d84e3ff docs(changelog): #7928 资金流水分页/详情出参补 bizTypeName 中文名-管理后台
changelog-filename-gate / validate (push) Failing after 2s
ORDER_REFUND 此前因前端硬编码 map 漏配回显英文枚举码。后端两个只读接口
/admin/finance/fund-flows/page 与 /{id} 出参各新增 bizTypeName(枚举 label,
14 业务类型全覆盖),bizType 英文码不变,零入参/零DDL。已部署测试服网关实调
8 项断言全 PASS。
2026-09-18 14:06:51 +08:00
yaosutu 755c690e24 docs(changelog): #7930 司导预支出纳队列行 remark 补预支用途快照(修改接口-管理后台)
changelog-filename-gate / validate (push) Failing after 2s
ADVANCE 待支付队列 GET /admin/finance/cashier/advance/queue 出参 remark
由恒 null 改为 fin_advance.purpose(申请用途快照);纯出参补值向后兼容,
入参/路径/其余字段/错误码/付款接口均不变;历史单与未填用途单仍为 null。
PR #7931 已合并 dev-v3 尚未部署。
2026-09-18 12:44:32 +08:00
yaosutu 26e995a97e feat(changelog): 司导预支(司导借款)支付链接通——出纳 ADVANCE 页签 queue/pay 真实接通(Epic #7901,PR #7902/#7906/#7910 已合并 dev-v3 部署测试服 E2E 通过;原 598607 空壳下线,金额锁死 598610,新增错误码 599500-599505)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-18 11:28:02 +08:00
yaosutu 28effce68e docs(changelog): 核单复核出参加报账字段(Issue #7724 / PR #7725)
changelog-filename-gate / validate (push) Failing after 1s
2026-09-17 23:40:33 +08:00
yaosutu a080db4c72 docs(changelog): 发票管理列表行补订单侧字段(Issue #7897 / PR #7899)
changelog-filename-gate / validate (push) Failing after 2s
GET /v3/admin/order/invoice/page 行级 records[] 纯新增 10 个订单侧字段:
teamNo/createTime/orderStatus(含文案)/flowStatus(含文案)/orderAmount/paidAmount/refundedAmount/settlementAmount。
入参/既有出参/错误码零变化,NONE tab 同样回填,前端无需同步上线。
2026-09-17 21:55:24 +08:00
yaosutu 16ed452d00 docs(changelog-v2): #7857 收票(进项发票)域上线——登记/编辑/核对/作废 + 关联勾选 + 供应商对账 8 端点
changelog-filename-gate / validate (push) Failing after 1s
- 新增 changelogs-v2/2026-09/17_7857 收票(进项发票)域上线-新增接口-管理后台.md
- 覆盖 Epic #7857(PR #7860/#7874/#7880 + 文档 #7891,已合并 dev-v3 并部署测试服验证通过)
- 8 端点:page/detail/create/update/verify/void/biz-candidates/supplier-recon
- 错误码 599400-599411 + 字典 fin_invoice_in_type + 菜单「收票管理」全内联自包含
2026-09-17 16:35:52 +08:00
yaosutu e8fdb57940 docs(changelog-v2): #7883 往来账·供应商往来最小闭环——账页分页 + 流水明细分页 2 个查询端点
changelog-filename-gate / validate (push) Failing after 1s
2026-09-17 16:17:21 +08:00
yaosutu a669350b0f docs(changelog): 出纳支付接口拆壳合芯——删3旧端点404+增18页签端点(#7842 PR #7855)
changelog-filename-gate / validate (push) Failing after 2s
- 删 GET /cashier/queue、POST /cashier/pay、POST /cashier/confirm-in(一律 404)
- 增 queue×8 + pay×8 + confirm-in×2,路径前缀 /cashier/{nonbiz,payment,prepay,expense,staff-loan,reimburse,advance,company-loan}
- 队列出参消灭 unitName/category 槽位复用,8 页签各用业务真名强类型字段
- ADVANCE 司导预支 2 端点预留空壳一律 598607,前端勿接
- 台账 GET /cashier/payments/page 不变
2026-09-17 10:43:13 +08:00
yaosutu 58c216669c feat(changelog): 公司借款域全量上线——12 接口 + 出纳 COMPANY_LOAN 新付款线(#7845 / PR #7846 #7848 #7850 #7851)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-17 08:53:33 +08:00
yaosutu 09f59e6d68 docs(changelog): 报账款查看明细页对接指引(复用现成接口拼装,零接口变更)(#7838)
changelog-filename-gate / validate (push) Failing after 1s
2026-09-17 00:05:19 +08:00
yaosutu 0f9e87db01 feat(changelog): 报账款支持部分收款(组合还款分多次,PARTIAL_RECEIVED 中间态)(#7838 / PR #7840)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-16 23:48:14 +08:00
yaosutu 46909eba8d docs(changelog): 6 域审核记录独立查询接口(#7801 PR-2 / PR #7814,前端)
changelog-filename-gate / validate (push) Failing after 1s
2026-09-16 22:04:56 +08:00
yaosutu 0bce0dd772 feat(changelog): 出纳待付款队列补 amount 与 fee 字段(#7815 / PR #7818)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-16 16:05:16 +08:00
yaosutu 072c3f8717 docs(changelog): 报账详情补透出支出行凭证 voucherUrls + 审核流水 reviewLogs(#7790/#7791)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-16 13:40:47 +08:00
yaosutu 577e3a98af docs(changelog): 报账款模块整模块接入指引(复核5接口+出纳3接口,含详情明细/退回重推护栏,Epic #7721/#7764)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-16 09:00:38 +08:00
yaosutu 207425a9af docs(finance): 资金统计点日期下钻前端纠错——日期走 query 不拼路径,查明细用 fund-flows/page
changelog-filename-gate / validate (push) Failing after 1s
后端契约零变更:/daily 无 /{date} 路径,前端把日期拼成路径段致 404「接口不存在」。
点日期下钻看当天流水明细应调 GET /admin/finance/fund-flows/page?flowAtStart=flowAtEnd=该日;
附两接口参数差异(flowAtStart/flowAtEnd/fundAccountId vs startDate/endDate/accountId)+ 正反例。
2026-09-15 15:34:17 +08:00
yaosutu a1c85b4061 docs(finance): 资金统计日报前端纠错——查询参数是 startDate/endDate 不是 dateFrom/dateTo
changelog-filename-gate / validate (push) Failing after 2s
后端契约零变更,仅前端对接说明:GET /admin/finance/fund-stats/daily 参数名
startDate/endDate,前端误传 dateFrom/dateTo 致 @NotNull 拦截返 400;附实测复现 +
正反例 + 400 兜底建议(勿留静态期初占位行掩盖)。
2026-09-15 14:09:02 +08:00
yaosutu 50dad163a8 docs(finance): 资金账户 overdraftAllowed 前端纠错——禁传布尔须传整数 1/0
changelog-filename-gate / validate (push) Failing after 2s
后端契约零变更,仅前端对接说明:新建/编辑资金账户的 overdraftAllowed 为 Integer,
前端开关直传 true/false 会被 Jackson 反序列化拦截报「字段 [overdraftAllowed] 格式错误」,
提交前须规整为 1/0。附正反例 JSON + 回显判真建议。
2026-09-15 11:53:35 +08:00
yaosutu 053776756f feat(finance): 预付款功能 changelog(#7428)
changelog-filename-gate / validate (push) Failing after 1s
后端全链路就绪,前端需补「付款管理/预付款」菜单+页面;
应付款支付页支持 payType=PREPAY。
2026-09-15 02:55:38 +08:00
yaosutu 4917e44e6a feat(finance): 出纳付款金额锁死 changelog(598610,#7713)
changelog-filename-gate / validate (push) Failing after 2s
5 条 OUT 付款线金额须等于审批应付金额,不一致抛 598610;
前端付款弹窗金额应改只读。
2026-09-15 02:40:43 +08:00
yaosutu 8e9856fd6d docs(changelog): 出纳方式↔账户两级校验(598609) + 资金账户详情删flows走独立分页 (Issue #7695/#7710)
changelog-filename-gate / validate (push) Failing after 1s
2026-09-15 00:15:24 +08:00
yaosutu b80d3e3ca2 docs(changelog): 资金账户详情 flows 本账户流水对接说明 (Issue #7695)
changelog-filename-gate / validate (push) Failing after 1s
2026-09-14 23:38:11 +08:00
yaosutu 559e3da634 docs(changelog): 收付方式字典统一两维口径 前端 changelog (Issue #7681 / PR #7685)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-14 15:50:32 +08:00
yaosutu 6b41b5fa0f docs(finance): 业务外收入建单去掉账户/凭证字段对齐两步资金流程 changelog(#7662)
changelog-filename-gate / validate (push) Failing after 1s
入参删 fundAccountId/payMethod/voucherNo/voucherUrl,由出纳 confirm-in 采集;
出参不变、零 DDL;前端需把字段从申请页挪到确认收款弹窗。
2026-09-14 12:40:23 +08:00
yaosutu 3becd7f6da docs(finance): 员工借款申请与审批 changelog——Row 出参补 purpose 申请事由
changelog-filename-gate / validate (push) Failing after 2s
接口 PR #7655(Issue #7654)员工借款分页 Row 出参新增 purpose(对应 fin_staff_loan.purpose,
原型列表有事由列、接口原缺失)。出参只增不删向后兼容。已部署测试服行为级验证
(page 返回 Row 含 purpose 字段)。changelog §5.1 Row 补 purpose、§5.2 Detail 去重。
2026-09-13 23:04:13 +08:00
yaosutu 9ad6178c3c docs(finance): 费用报销 changelog 冲抵勾稽自包含——内联 offsettable 用法
changelog-filename-gate / validate (push) Failing after 2s
原 §七 错误码 599107/599113 写"见 PR #7566 冲抵借款 changelog"违反自包含铁律。
本次补全:599107/599113 拆行写清触发条件 + 新增「冲抵勾稽(自包含)」段——
内联 GET /admin/finance/staff-loans/offsettable 端点用法与出参(balanceAmt 可冲上限)、
use=min(报销剩余额度,借款余额) 勾稽规则、offsetLoanAmt/payableAmt 关系,
指向员工借款申请与审批篇准确文件名。
2026-09-13 17:51:23 +08:00
yaosutu 1191b6e046 docs(finance): 员工借款 changelog 重写——按原型修正核销归属 + 审批写清
changelog-filename-gate / validate (push) Failing after 2s
按原型对齐两菜单分工:
- 员工借款申请与审批(改名,原"申请与核销"):付款管理/员工借款 = 申请 + 审批(submit/approve/reject 手工推进状态,approvalInstanceId 留空待接企微) + 核销进度只读 + 报销冲抵选借款;砍掉还款登记/红冲
- 员工借款支付出纳放款:支付管理/员工借款支付 = 出纳放款(cashier bizType=STAFF_LOAN) + 还款核销(现金/转账登记 POST /{id}/repays、红冲 DELETE、报销冲抵 offsetLoanIds) + 资金账户下拉

修正点:还款核销登记/红冲从申请篇挪到支付篇(原型 L1674 notice 明确核销在出纳侧);审批接口写清为手工推进状态、approvalInstanceId 留空。
2026-09-13 17:43:48 +08:00
yaosutu c91730668b docs(finance): 员工借款两菜单 changelog——申请+核销 / 出纳放款支付
changelog-filename-gate / validate (push) Failing after 2s
Epic #7520 四 PR(#7543/#7549/#7557/#7566)员工借款域已全量接通 + 菜单已挂载(PR #7642 / 迁移 V20260913_001)。

- 13_staffloan_员工借款申请与核销-新增接口:「付款管理/员工借款」/admin/finance/staff-loans 12 端点全表 + 状态机 + 错误码 599101-599113
- 13_staffloan_员工借款支付出纳放款-修改接口:「支付管理/员工借款支付」出纳放款对接(cashier bizType=STAFF_LOAN)
- 两篇均含 菜单↔功能↔接口 对照表;借款人下拉统一 GET /admin/user/employee-options;资金账户 fund-accounts/options
2026-09-13 17:01:28 +08:00
yaosutu edab50a6a8 feat(changelog): 费用报销三件套(#7472/#7486/#7502) + 费用支付出纳对接说明
changelog-filename-gate / validate (push) Failing after 2s
- 费用报销:page 加 statuses 多状态筛选、detail 加 payRecords 付款记录、表单补 applicantId/payeeAccount/voucherUrl、透出经办人 operatorId/operatorName、598705 文案放宽;含部门组织树/员工选择器/所属公司 travel_agency/费用分类 关联接口指引
- 费用支付:出纳域对接说明(queue/pay/payments 按 EXPENSE 路由),接口无变更
2026-09-13 16:25:38 +08:00
yaosutu d53a6f4328 docs(changelog): 业务外收支 7612 入参按 IN/OUT 两个页签分开说明
changelog-filename-gate / validate (push) Failing after 2s
把"四、入参"重构为分方向:先讲一套接口两个页签(direction 区分)怎么调,再分别给业务外收入(IN)/业务外支出(OUT)两张干净表单字段表,支出明确"只有 8 字段、不收凭证类"。前端对着自己页签抄即可。
2026-09-13 14:44:50 +08:00
yaosutu 6e05bd81aa feat(changelog): 业务外收支接供应商与经办人(#7612) + 员工选择器接口(#7625)
changelog-filename-gate / validate (push) Failing after 2s
- 13_7612:业务外收支修改接口(破坏性:删 unitName/加 operatorId 必填/OUT 裁剪 6 字段;出参加 flowNo;含供应商弹窗/部门树/员工选择器/类别/收付方式字典 5 个关联接口对接指引)
- 13_7625:新增员工选择器 GET /admin/user/employee-options(不限角色,供经办人下拉)
2026-09-13 14:37:16 +08:00
yaosutu 48d36a1c84 docs(changelog): 资金账户新建/编辑表单字段对接说明(管理后台 v2)
changelog-filename-gate / validate (push) Failing after 2s
非接口改动:资金账户接口字段早已齐全,前端补 5 字段(bankName/shortName/nature/feeRate/refundReserve)+ scopeCompanies 改多选。
2026-09-13 10:05:19 +08:00
yaosutu be7415b771 docs(finance): 更正 7232 changelog §10 出纳付款登记入参字段名勘误
changelog-filename-gate / validate (push) Failing after 2s
前端联调反馈 cashier/pay bizType=EXPENSE 报 400 出账账户不能为空/付款金额不能为空。
经测试服实调实证:后端 cashier/pay 为全 bizType 统一扁平入参,付款账户/金额字段名
固定为 payAccountId/amount(@NotNull 文案与前端 400 逐字一致),changelog §10 误把
输出字段名 fundAccountId/actualAmount 写进了请求入参表,前端据此调用触发校验失败。

更正内容(§10):
- 入参表 fundAccountId→payAccountId、actualAmount→amount,并补全量必填字段 payDate 等
- 变更点说明补「回写列名非入参字段」澄清
- 新增请求/成功响应示例(可直接照抄)
- 598602 错误文案对齐实测「业务单状态非已批准,不可付款」
- frontmatter status_note 追加勘误说明 + updated_at 升 2026-09-10

验证(测试服,FY-202609100001):
错误字段→复现 400;正确字段 payAccountId/amount→付款成功 LS202609100002、
余额 114894→114594、报销单回写 PAID+fundAccountId+paidAt、重复付款 598602 防重拦下。

Refs #7232
2026-09-10 15:19:23 +08:00
yaosutu c74fc50926 docs(changelog): 供应商分页/列表出参补 contactPhone(#7199 / PR #7202)
changelog-filename-gate / validate (push) Failing after 2s
出参 SupplierListItemRespVO 新增 contactPhone(联系电话完整原值,管理后台授权场景)。
注:同 PR 曾新增 balance,已被 #7291 移除,changelog 内已显式标注勿消费。
2026-09-10 00:20:54 +08:00
yaosutu 19d434ef3b docs(finance): 补推期初建账/业务外收支/出纳/费用报销 changelog(#7164/#7165/#7217/#7232)
changelog-filename-gate / validate (push) Failing after 1s
2026-09-09 23:21:35 +08:00
yaosutu和Claude Opus 4.8 5025f8d69b docs(changelog): 财务域 账期/费用分类/业务外分类/收款账户/资金流水/资金互转/资金日报 7 篇入 changelogs-v2
changelog-filename-gate / validate (push) Failing after 2s
- 09_6951_财务账期设置:page/开新账期/封账 3 端点
- 09_7129_费用分类:tree/增/改/停用/启用 5 端点(DISABLED 统一+幂等)
- 09_7052_业务外收支分类:查询/增/改/停用/启用 5 端点(自动生码 NONBIZ_)
- 09_7003_收款账户:page/增/改/设默认/停用 5 端点
- 09_7003_资金流水:page/详情 2 端点(只读,含 remark)
- 09_7003_资金互转:page/发起 2 端点(双边成对记账+幂等)
- 09_7003_资金日报:daily 1 端点(closing=opening+收入−支出勾稽)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-09 16:25:37 +08:00
yaosutu和Claude Opus 4.8 89be26b98b docs(changelog): 财务域 参数设置(#6951)+资金账户(#7003/#7141) 2 篇入 changelogs-v2
changelog-filename-gate / validate (push) Failing after 3s
- 09_6951_财务系统参数设置:GET/PUT /admin/finance/params 2 端点
- 09_7003_资金账户:10 端点全量(含 #7141 三字段字典化 accountTypeName/natureName/channelName + /options 下拉)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-09 16:16:00 +08:00
yaosutu 16c68b6b25 docs(mp): C端发票切流v3状态枚举值域变化+email必填收紧 (#7252)
changelog-filename-gate / validate (push) Failing after 2s
2026-09-07 12:05:07 +08:00
yaosutu 60e683921a docs(changelog): 定制需求管理后台接口迁移 v3 路径(Epic #7171)
changelog-filename-gate / validate (push) Failing after 2s
customize 定制需求域由 order-v2 迁往 order-v3,管理后台 5 个接口
base 路径 /admin/order/customize → /v3/admin/order/customize,
仅路径前缀变化,字段/方法/出入参契约零变更。旧 v2 路径已下线 404。

Refs #7174
2026-09-07 00:49:24 +08:00
yaosutu 3c0a8ce1a7 docs(changelog): 导游/摄影核单确认状态去签名重置-修改接口-管理后台 (#6168)
changelog-filename-gate / validate (push) Failing after 2s
2026-08-22 15:28:41 +08:00
yaosutu b7357dbfb7 docs(changelog): 导游/摄影核单去EXCLUDED改全量替换,确认状态统一settlementConfirmStatus(#6117 / PR #6119)
changelog-filename-gate / validate (push) Failing after 2s
2026-08-21 11:28:19 +08:00
yaosutu dd56a2b0e5 docs(changelog): 核单车辆费用归其他支出(#5969 / PR #5970)
changelog-filename-gate / validate (push) Successful in 2s
单团核算表 vehicleLines 行删 4 字段,5 类车辆费用行迁到 otherExpenseLines,
expenseType 值域扩为 6 类;管理后台端 changelog。
2026-08-15 14:24:50 +08:00
yaosutu 34e50005f9 docs(changelog): 单团核算表出参重构——收入拍平逐项+成本7分类明细数组+保险独立子块(#5963)
changelog-filename-gate / validate (push) Successful in 2s
- 删 perCapita 人均三指标 + hotelCost 等 7 个成本分类小计 + costCategories 套层 + incomeLines[].details 嵌套
- incomeLines 拍平逐项行(4 type 各至少一行,无明细给占位行 amount=聚合值)
- 成本改 hotelLines 等 7 分类明细数组平铺顶层,空分类 []
- 新增 insuranceInfo 保险子块;insurancePremium 顶层保留且计入 totalCost
- PR #5966 已合并 dev-v3(c8cae25131),测试服部署 + 网关实调验证通过
2026-08-14 17:45:57 +08:00
yaosutu 983c274860 docs(changelog): 主报账表baseInfo尾款口径三新字段透出+outstandingAmount下线(#5955 / PR #5958)管理后台
changelog-filename-gate / validate (push) Successful in 2s
2026-08-14 11:01:58 +08:00
yaosutu 0a689d93c5 docs(changelog): 主报账表展示其他收入/其他支出明细(不影响报账人净额)(#5953 / PR #5954)管理后台
changelog-filename-gate / validate (push) Successful in 1s
2026-08-13 14:32:18 +08:00
yaosutu d98db3e76e docs(changelog): 核单两报表出参瘦身合并版(#5876 + #5916 / PR #5881 + #5920)管理后台
changelog-filename-gate / validate (push) Failing after 2s
orderHeader 拍平 + 审计字段下线 + outstandingAmount 替代 primaryReporterDueAmount
+ finalize warnings 结构化 + summary 新增 settled,以 #5916 合并后最终态为准
2026-08-12 17:11:30 +08:00
yaosutu d1e98fa028 docs(changelog): 核单 finalize warnings 结构化带行id + summary 新增 settled 标识(#5876 / PR #5881)管理后台
changelog-filename-gate / validate (push) Failing after 1s
2026-08-12 09:12:56 +08:00
yaosutu 627c4c8721 changelog(#5867): 出行人智能批量导入纳入"至少一名成人填手机号"硬校验(581136,PR #5868)
changelog-filename-gate / validate (push) Failing after 2s
补充 #5855 changelog:smart-parse(dryRun=false 正式落库)与 5 个保存入口复用同一
成人手机门禁;dryRun=true 预览不校验。部署测试服网关实调通过:无成人手机导入被
581136 阻断且 DB 零写入,含 1 成人手机导入 200 放行落库。
2026-08-11 18:15:46 +08:00
yaosutu d362c3acb1 docs(changelog): 主报账人报账表出参重构统一字段(#5820/#5859)管理后台
changelog-filename-gate / validate (push) Failing after 2s
破坏性变更通知:顶层平铺汇总字段收拢进 baseInfo、expenseLines 统一 12 扁平字段、
删除 vehicleLines 与 6 个冗余字段、orderHeader 补 returnDate/travelerCount。
对应后端 PR #5839 + #5865,前端必须同步改造。
2026-08-11 18:02:05 +08:00
yaosutu 231f2e0411 changelog(#5855): 出行人保存新增"至少一名成人必须填手机号"服务端硬校验(PR #5858)
changelog-filename-gate / validate (push) Failing after 2s
涉及 PUT traveler-info / POST batch-edit / POST add 三个保存入口,
新增错误码 581136;validate 接口 blockReasons 文案同步收紧为"成人"。
入参/出参结构无变化,前端按 code!=200 toast 约定即可兼容。
2026-08-11 17:40:31 +08:00
yaosutu 690046d0b2 docs(changelog): 核单两报表统一实时路径+出参新增订单头orderHeader(#5840)管理后台
changelog-filename-gate / validate (push) Failing after 2s
- PR #5854 / Issue #5840 / merge commit 452ebd63
- GET /v3/admin/order/{orderId}/settlement/reports/group 出参加 orderHeader
- GET /v3/admin/order/{orderId}/settlement/reports/reimbursement 出参加 orderHeader
- 两报表去掉快照读分叉统一实时计算(对前端透明,reportStatus 取值不变)
2026-08-11 17:05:03 +08:00
yaosutu 036f1558a1 changelog(#5816): 主报账对账 transferStatus 彻底下线——报账表出参删字段 + recon 读/写路径声明下线(PR #5826)
changelog-filename-gate / validate (push) Failing after 2s
2026-08-11 12:04:57 +08:00
yaosutu 71a0544914 docs(changelog): 单团核算表扩充逐项明细出参(#5781 / PR #5786)
changelog-filename-gate / validate (push) Failing after 2s
incomeLines[i] 新增 details 收入逐项、costCategories[i] 新增 lines 成本逐项(按 category 窄化);
配套新增 insurance_biz_type / settlement_refund_source 两个字典。纯出参增量,向后兼容。
2026-08-10 22:42:28 +08:00
yaosutu 7921162dfa docs(changelog): 完成核单去转账/签字凭据采集(#5809 / PR #5813)
changelog-filename-gate / validate (push) Failing after 2s
finalize 改无请求体;recon 入参与报账表出参各删 4 个凭据字段;
ReqVO ignoreUnknown=false,前后端必须同批上线。
2026-08-10 21:46:16 +08:00
yaosutu a24f7cc724 docs(changelog): #5739 核单报表快照指纹彻底下线(PR #5764)
changelog-filename-gate / validate (push) Failing after 1s
- GET /v3/admin/order/{orderId}/settlement/reports/group 出参删除 sourceFingerprint,reportStatus 枚举删除 STALE
- GET /v3/admin/order/{orderId}/settlement/reports/reimbursement 同步变更
- 承接 #5704 写入路径指纹下线,本次为报表读取路径收尾批次
2026-08-09 23:04:57 +08:00
yaosutu 737e3fcb4c docs: 核单完成按钮校验逻辑简化 changelog
changelog-filename-gate / validate (push) Failing after 1s
2026-08-09 16:28:04 +08:00
yaosutu 1d88fab99d feat(order-v3): 核单报表出参强类型化补中文名(#5729)
changelog-filename-gate / validate (push) Failing after 2s
2026-08-09 14:17:09 +08:00
yaosutu 3928b35212 docs(changelog): 撤回含错误指纹说法的 #5674 白名单,只读字段清单并入 #5704
changelog-filename-gate / validate (push) Failing after 1s
2026-08-08 22:44:38 +08:00
yaosutu f6ca749fe3 docs(changelog): 车辆核单金额放开可编辑(#5712)+车辆下拉新增dayPrice(#5708)
changelog-filename-gate / validate (push) Failing after 2s
- 5712: PUT /v3/admin/order/{orderId}/settlement/step3/vehicles FLEET行amount放开可编辑
- 5708: GET /v3/admin/order/{orderId}/settlement/vehicle-options 出参新增dayPrice参考价
2026-08-08 20:12:16 +08:00
yaosutu 16c743d37e docs(changelog): 核单域下线数据指纹乐观锁(#5704 / PR #5709)
changelog-filename-gate / validate (push) Failing after 1s
- 6 个端点删除 expectedSourceFingerprint/version 入参与 sourceFingerprint/version 出参
- 错误码 584108/584110/584325 下线,车辆来源漂移改挂 584315
- 字段删除硬破坏契约,前端须先停传旧字段再与后端同批发布
2026-08-08 16:32:31 +08:00
yaosutu ffdfd6057a docs(changelog): 核单导游/摄影费用保存接口入参字段白名单澄清(#5674)
changelog-filename-gate / validate (push) Failing after 2s
保存请求 VO 对未声明字段显式拒绝,前端原样回传 GET 响应对象会带出
sourceType 等只读派生字段触发 400。本文档给出两接口保存入参白名单、
字段约束、必须剥掉的只读字段清单及示例。
2026-08-08 16:25:33 +08:00
yaosutu afeb26cf31 docs(changelog): 核单导游摄影费用解析失败错误码 584125 细化为 584128(#5674)
changelog-filename-gate / validate (push) Failing after 2s
PR #5677 已合并 dev-v3:4 个核单导游/摄影费用接口请求体解析失败/Bean 校验失败
错误码由 584125 细化为 584128,message 透出具体字段原因;请求体为空仍 584125 不变。
2026-08-08 10:56:40 +08:00