Files
junhong_cmp_fiber/openspec/specs/fund-summary-primary-account/spec.md
huang 4aab0bcbf2
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 4m39s
提案以及归档
2026-04-18 09:10:29 +08:00

1.5 KiB

fund-summary-primary-account Specification

Purpose

修复资金概况接口的主账号数据来源问题:确保新建店铺时初始账号被标记为主账号(is_primary = true),并通过数据迁移修复历史存量数据,使 GET /api/admin/shops/fund-summary 接口能够正确返回每个店铺的主账号用户名和手机号。

ADDED Requirements

Requirement: 新建店铺时初始账号标记为主账号

系统 SHALL 在创建店铺的同时创建初始账号时,将该账号的 is_primary 字段设置为 true

Scenario: 创建店铺生成主账号

  • WHEN 调用 POST /api/admin/shops 创建新店铺
  • THEN 自动创建的初始代理账号 is_primary = true,可被 GetPrimaryAccountsByShopIDs 查询返回

Requirement: 资金概况接口返回正确的用户名和手机号

系统 SHALL 在 GET /api/admin/shops/fund-summary 接口响应中,对每个店铺正确返回主账号的 usernamephone 字段(非空)。

Scenario: 有主账号的店铺返回用户信息

  • WHEN 调用 /api/admin/shops/fund-summary,店铺存在 is_primary = true 的账号
  • THEN 响应中每个店铺的 usernamephone 为该主账号的真实值,不为空字符串

Scenario: 历史存量数据修复后正确返回

  • WHEN 数据迁移执行后,调用 /api/admin/shops/fund-summary
  • THEN 现有店铺的账号 is_primary = true 已修复,接口返回正确用户名和手机号