# 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` 接口响应中,对每个店铺正确返回主账号的 `username` 和 `phone` 字段(非空)。 #### Scenario: 有主账号的店铺返回用户信息 - **WHEN** 调用 `/api/admin/shops/fund-summary`,店铺存在 `is_primary = true` 的账号 - **THEN** 响应中每个店铺的 `username` 和 `phone` 为该主账号的真实值,不为空字符串 #### Scenario: 历史存量数据修复后正确返回 - **WHEN** 数据迁移执行后,调用 `/api/admin/shops/fund-summary` - **THEN** 现有店铺的账号 `is_primary = true` 已修复,接口返回正确用户名和手机号