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

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

internal/query/shop/business_owner.go

@@ -158,6 +158,10 @@ func (q *BusinessOwnerQuery) project(ctx context.Context, shops []*model.Shop) (
 	if err != nil {
 		return nil, err
 	}
+	downstreamCounts, err := q.loadDownstreamAgentCounts(ctx, shops)
+	if err != nil {
+		return nil, err
+	}
 	responses := make([]*dto.ShopResponse, 0, len(shops))
 	for _, shop := range shops {
 		response := &dto.ShopResponse{
@@ -167,8 +171,11 @@ func (q *BusinessOwnerQuery) project(ctx context.Context, shops []*model.Shop) (
 			ContactName: shop.ContactName, ContactPhone: shop.ContactPhone, Province: shop.Province,
 			City: shop.City, District: shop.District, Address: shop.Address, Status: shop.Status,
 			ClientLoginDisabled: shop.ClientLoginDisabled,
-			StatusName:          constants.GetStatusName(shop.Status), CreatedAt: shop.CreatedAt.Format("2006-01-02 15:04:05"),
-			UpdatedAt: shop.UpdatedAt.Format("2006-01-02 15:04:05"),
+			StatusName:          constants.GetStatusName(shop.Status),
+			// 无下级的店铺返回 0（map 缺省零值），不使用空值。
+			DownstreamAgentCount: downstreamCounts[shop.ID],
+			CreatedAt:            shop.CreatedAt.Format("2006-01-02 15:04:05"),
+			UpdatedAt:            shop.UpdatedAt.Format("2006-01-02 15:04:05"),
 		}
 		if shop.ParentID != nil {
 			response.ParentShopName = parentNames[*shop.ParentID]
@@ -239,6 +246,38 @@ func (q *BusinessOwnerQuery) loadBusinessOwners(ctx context.Context, ids []uint)
 	return result, nil
 }
 
+// loadDownstreamAgentCounts 按当页店铺批量聚合直接下级代理数量。
+//
+// 口径：未删除且上级店铺标识等于该店铺的店铺数；一次分组查询完成，MUST NOT 逐店查询。
+// 该数量只读，不影响上下级关系、佣金关系、通知范围或任何既有写入语义。
+// 数据范围由调用方的列表与详情过滤保证：范围外店铺不进入结果，其下级数量自然不泄露。
+func (q *BusinessOwnerQuery) loadDownstreamAgentCounts(ctx context.Context, shops []*model.Shop) (map[uint]int64, error) {
+	result := make(map[uint]int64, len(shops))
+	shopIDs := make([]uint, 0, len(shops))
+	for _, shop := range shops {
+		if shop != nil && shop.ID > 0 {
+			shopIDs = append(shopIDs, shop.ID)
+		}
+	}
+	if len(shopIDs) == 0 {
+		return result, nil
+	}
+	var rows []struct {
+		ParentID uint
+		Total    int64
+	}
+	if err := q.db.WithContext(ctx).Model(&model.Shop{}).
+		Select("parent_id, COUNT(*) AS total").
+		Where("parent_id IN ?", shopIDs).
+		Group("parent_id").Scan(&rows).Error; err != nil {
+		return nil, errors.Wrap(errors.CodeDatabaseError, err, "统计店铺下级代理数量失败")
+	}
+	for _, row := range rows {
+		result[row.ParentID] = row.Total
+	}
+	return result, nil
+}
+
 // loadBusinessUserGroups 按负责人账号批量推导当前所属业务用户组。
 // 一账号至多一条未删除成员关系，因此先在成员上按 account_id 定位、再按组 ID 回表，
 // 停用组与负责人为已软删账号的成员关系都照常返回，保证展示与筛选口径一致。