提案以及归档

openspec/changes/archive/2026-04-18-super-admin-operation-password/proposal.md

@@ -0,0 +1,34 @@
+## Why
+
+系统中需要操作密码验证的接口（如代理充值线下确认）目前使用**当前登录用户自己的登录密码**作为操作密码，缺乏独立的操作层安全机制。需要引入一个**全局操作密码**，仅由超级管理员设置和修改，所有需要操作密码的接口统一验证这一密码，实现"操作密码"与"登录密码"的职责分离。
+
+## What Changes
+
+- 新增 `POST /api/admin/super-admin/operation-password` 接口：超级管理员设置/修改全局操作密码
+- 新增 `GET /api/admin/super-admin/operation-password/status` 接口：查询操作密码是否已设置
+- 全局操作密码以 bcrypt 哈希值存储于 Redis，Key 定义在 `pkg/constants/redis.go`
+- `agent_recharge` `OfflinePay` 的操作密码验证逻辑从"当前用户登录密码"改为"全局操作密码"
+- 新增统一工具函数 `VerifyOperationPassword(ctx, inputPassword)` 供后续接口复用
+
+## Capabilities
+
+### New Capabilities
+
+- `global-operation-password`：全局操作密码的设置、修改、验证能力，存储于 Redis，仅超级管理员可维护
+
+### Modified Capabilities
+
+（无已有 spec 变更）
+
+## Impact
+
+| 层级 | 文件 | 变更类型 |
+|------|------|---------|
+| Handler | `internal/handler/admin/`（新建 `super_admin.go`） | 新建 |
+| Service | `internal/service/`（新建 `operation_password/service.go`） | 新建 |
+| Service | `internal/service/agent_recharge/service.go` | 修改验证逻辑 |
+| Constants | `pkg/constants/redis.go` | 新增 Redis Key 常量 |
+| Bootstrap | `internal/bootstrap/handlers.go`、`services.go` | 注册新组件 |
+| Routes | 路由注册文件 | 新增路由 |
+
+**依赖**：Redis（已有，无需新增依赖）