huang
4aab0bcbf2
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 4m39s
30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
# 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` 已修复，接口返回正确用户名和手机号
|