提案以及归档

openspec/specs/fund-summary-primary-account/spec.md

@@ -0,0 +1,29 @@
+# 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` 已修复，接口返回正确用户名和手机号