feat(收口): 补齐 8 月迭代缺口并同步 Spec 与证据链

- 新增六对成对迁移 000232–000237：H5 弹窗类型、退款结算标识与申请人备注、优先轮询事实字段与两个新终态、通道阈值命中留痕、手机号最近解绑人、提现资格校验留痕
- 退款：原因必填与申请人备注、来源支付与渠道流水冻结、线下处理流水号补录审计、按订单查询可选退款方式、企微审批材料补齐且新增字段缺失映射即明确失败
- 优先轮询：人工关闭、有效期到期独立周期任务、失败与过期人工重触发、事实字段与异常重试查询、资产解析端点只读投影
- 通道阈值：命中事实同事务留痕与命中记录查询；员工账单：列表筛选与详情投影；商户池：列表投影与统计周期语义；H5：弹窗类型与类别排序
- 手机号：有效关联数量与最近解绑人、短信验证码失败次数限制；导出：佣金明细十五列与报表序号列
- 时间筛选：三处新增筛选纳入统一严格解析契约，员工账单产生时间参数改名
- 同步 12 份主 Spec 需求、两端点与异步任务证据链，门禁 context-health 与 OpenSpec 校验通过

internal/routes/shop.go

@@ -17,7 +17,7 @@ func registerShopRoutes(router fiber.Router, handler *admin.ShopHandler, doc *op
 
 	Register(shops, doc, groupPath, "GET", "", coreShopManagement(handler.List), RouteSpec{
 		Summary:     "店铺列表",
-		Description: constants.ShopManagementAccessDescription + constants.ShopListPaginationDescription,
+		Description: constants.ShopManagementAccessDescription + constants.ShopListPaginationDescription + shopDownstreamAgentDescription,
 		Tags:        []string{"店铺管理"},
 		Input:       new(dto.ShopListRequest),
 		Output:      new(dto.ShopPageResult),
@@ -84,7 +84,7 @@ func registerShopDetailRoute(router fiber.Router, handler *admin.ShopHandler, do
 	groupPath := basePath + "/shops"
 	Register(shops, doc, groupPath, "GET", "/:id", coreShopManagement(handler.Detail), RouteSpec{
 		Summary:     "查询店铺详情",
-		Description: constants.ShopManagementAccessDescription + " 返回与店铺列表一致的业务员归属摘要。",
+		Description: constants.ShopManagementAccessDescription + " 返回与店铺列表一致的业务员归属摘要。" + shopDownstreamAgentDescription,
 		Tags:        []string{"店铺管理"},
 		Input:       new(dto.IDReq),
 		Output:      new(dto.ShopResponse),
@@ -92,6 +92,9 @@ func registerShopDetailRoute(router fiber.Router, handler *admin.ShopHandler, do
 	})
 }
 
+// shopDownstreamAgentDescription 说明店铺列表与详情返回的直接下级代理数量口径。
+const shopDownstreamAgentDescription = " 同时返回直接下级代理数量（未删除且上级店铺标识等于该店铺的店铺数），按页批量聚合、受店铺数据范围约束，无下级返回 0；该字段只读，不影响上下级关系、佣金关系与通知范围。"
+
 func coreShopManagement(handler fiber.Handler) fiber.Handler {
 	return func(c *fiber.Ctx) error {
 		if middleware.GetUserTypeFromContext(c.UserContext()) == constants.UserTypeEnterprise {