暂存提交

auth/AGENTS.md

@@ -13,7 +13,7 @@
 | 登录、注册、刷新、退出、改密 API | `controller/AuthController.java`（`/api/auth`） |
 | 内部账号管理 API | `controller/InternalAccountController.java`（`/internal/auth/accounts`） |
 | 认证与令牌编排 | `service/AuthService.java`、`TokenSessionStore.java` |
-| 账号状态、密码重置 | `service/AccountManagementService.java` |
+| 账号创建、显示名同步、状态和密码重置 | `service/AccountManagementService.java`；平台账号使用 `default_app_code=PLATFORM`、`tenant_id=0` |
 | 商户注册协作 | `service/MerchantRegistrationService.java` |
 | IAM 调用与授权快照 | `client/IamAuthorizationClient.java`、`IamOnboardingClient.java`、`AuthorizationSnapshot.java` |
 | 账号与 Refresh Token 持久化 | `entity/`、`mapper/`、`repository/` |
@@ -26,4 +26,5 @@
 - 密码必须安全散列；不得记录密码、Token、密钥或完整敏感 Claim。
 - 修改 Token Claim、会话 Redis Key、过期或撤销逻辑时同步检查 `common-security/`、`gateway/` 和 IAM 授权快照。
 - 注册流程跨 Auth/IAM，失败补偿和幂等必须成对检查；不要跨库写 IAM 表。
+- 内部账号创建允许相同账号 ID 与相同归属幂等重试；不同身份占用同一 ID 必须冲突。内部接口只接收 IAM 的服务令牌，不直接暴露给前端。
 - 从父目录运行 `mvn -pl auth -am test`，认证接口变更再运行相关 `scripts/` 回归。