docs: #8006 订正 c141592 的错误:base 改回 dev-v3,补充零写入用例
changelog-filename-gate / validate (push) Failing after 1s

c141592 误改 base=main,理由写成「hl-api-changelog 仓无 dev-v3 分支」
但 base 指的是「后端改动合进了 HL 仓的哪个分支」,不是 changelog 仓的分支。
存量 513 份用 dev-v3,只有那一份用 main。

同时补充零写入的用例引用:
- 单测 GroupBatchStaffConfigServiceTest#requestedRoleOutOfScope_rejectedWithZeroWrites
  用 Mockito verify(..., never()) 断言范围外角色被拒时无 Feign/软删/INSERT

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot
2026-09-21 23:30:28 +08:00
共同撰写人 Claude Haiku 4.5
父节点 427124d2a5
当前提交 1624104862
@@ -14,7 +14,7 @@ target_release: ""
verified_at: ""
status_note: "2026-09-21 于网关 https://api.test.1814.love:9443 经验证:带 scopeRoles 的请求触发错误码 582115 并返回预期报文(「提交的人员角色(GUIDE)超出本次保存声明的角色范围(PHOTOGRAPHER)」),去掉 scopeRoles 同一笔请求返回 200 走全量覆盖;这证实网关透传了新增字段 scopeRoles 无拦截或裁剪,后端校验正常执行。PR #8117 已合入 dev-v3(合并提交 094521f0b),当前测试环境部署 commit d30cd9561。"
updated_at: "2026-09-21"
base: "main"
base: "dev-v3"
---
# 团期人员配置:保存接口新增角色范围声明,支持按配置位分部分保存
@@ -339,7 +339,7 @@ base: "main"
**单测覆盖**(241 examples new + existing,全过):
- 范围保存的删除窗口(0.5 → 1.5 间隔)
- 导游位必须同时声明两个角色(缺一触发 582115)
- staffList 超出范围拒绝(582115,零写入)
- staffList 超出范围拒绝(582115,零写入已验证:单测 `GroupBatchStaffConfigServiceTest#requestedRoleOutOfScope_rejectedWithZeroWrites`)
- 回显值切换(toInsert → finalState)
- 扇出快照来源(同上)
- ready 回填按整期算(不按本范围算)