Add skill for gameplay entry type workflows

docs/technical/ADMIN_WEB_CONSOLE_TECHNICAL_SOLUTION_2026-04-30.md

@@ -96,8 +96,10 @@ export interface ApiErrorEnvelope {
 | 当前管理员 | `GET /admin/api/me` | 管理员 Bearer |
 | 服务与数据库概览 | `GET /admin/api/overview` | 管理员 Bearer |
 | 受控 HTTP 调试 | `POST /admin/api/debug/http` | 管理员 Bearer |
+| 读取兑换码列表 | `GET /admin/api/profile/redeem-codes` | 管理员 Bearer |
 | 创建/更新兑换码 | `POST /admin/api/profile/redeem-codes` | 管理员 Bearer |
 | 停用兑换码 | `POST /admin/api/profile/redeem-codes/disable` | 管理员 Bearer |
+| 读取后台邀请码列表 | `GET /admin/api/profile/invite-codes` | 管理员 Bearer |
 | 创建/更新注册邀请码 | `POST /admin/api/profile/invite-codes` | 管理员 Bearer |
 
 ### 4.3 前端类型命名
@@ -206,6 +208,10 @@ export interface ProfileRedeemCodeAdminResponse {
   updatedAt: string;
 }
 
+export interface ProfileRedeemCodeAdminListResponse {
+  entries: ProfileRedeemCodeAdminResponse[];
+}
+
 export interface ProfileInviteCodeAdminResponse {
   userId: string;
   inviteCode: string;
@@ -213,6 +219,10 @@ export interface ProfileInviteCodeAdminResponse {
   createdAt: string;
   updatedAt: string;
 }
+
+export interface ProfileInviteCodeAdminListResponse {
+  entries: ProfileInviteCodeAdminResponse[];
+}
 ```
 
 ### 4.4 登录 contract
@@ -284,6 +294,31 @@ export interface ProfileInviteCodeAdminResponse {
 
 ### 4.7 兑换码管理 contract
 
+列表请求：
+
+`GET /admin/api/profile/redeem-codes`
+
+成功返回：
+
+```json
+{
+  "entries": [
+    {
+      "code": "WELCOME2026",
+      "mode": "public",
+      "rewardPoints": 100,
+      "maxUses": 1,
+      "globalUsedCount": 0,
+      "enabled": true,
+      "allowedUserIds": [],
+      "createdBy": "admin:root",
+      "createdAt": "2026-04-30T00:00:00Z",
+      "updatedAt": "2026-04-30T00:00:00Z"
+    }
+  ]
+}
+```
+
 创建/更新请求：
 
 ```json
@@ -300,8 +335,6 @@ export interface ProfileInviteCodeAdminResponse {
 
 停用请求：
 
-兑换码管理页的最近一次接口返回记录由 `AdminApp` 维护为管理端会话态，并传入 `AdminRedeemCodePage` 渲染。页面页签通过 hash 切换时子页面会卸载，不能把最近记录只放在兑换码页面内部 `useState` 中，否则切换到其他页签再返回会展示“暂无记录”。该会话态只用于保留当前操作结果，不作为兑换码历史列表；退出登录或重新登录时清空。
-
 ```json
 {
   "code": "WELCOME2026"
@@ -325,10 +358,36 @@ export interface ProfileInviteCodeAdminResponse {
 }
 ```
 
+兑换码管理页进入时必须通过 `GET /admin/api/profile/redeem-codes` 加载数据库已有记录。最近一次接口返回记录仍由 `AdminApp` 维护为管理端会话态，用于展示当前操作结果；历史列表不得依赖该会话态，刷新页面后必须从后端列表接口恢复。列表项点击后回填表单，继续通过同一个 `POST /admin/api/profile/redeem-codes` 修改原记录。
+
 前端只做基础输入约束，最终标准化、私有码用户解析、次数和奖励合法性以 `server-rs` 为准。
 
 ### 4.8 邀请码管理 contract
 
+列表请求：
+
+`GET /admin/api/profile/invite-codes`
+
+成功返回：
+
+```json
+{
+  "entries": [
+    {
+      "userId": "admin:root:SPRING2026",
+      "inviteCode": "SPRING2026",
+      "metadata": {
+        "batch": "spring"
+      },
+      "createdAt": "2026-04-30T00:00:00Z",
+      "updatedAt": "2026-04-30T00:00:00Z"
+    }
+  ]
+}
+```
+
+后台邀请码列表只返回后台运营预置码。后端按 `profile_invite_code.user_id` 的 `admin:` 前缀过滤，普通用户在邀请中心生成的个人邀请码不得展示在后台列表中。
+
 创建/更新请求：
 
 ```json
@@ -372,19 +431,22 @@ export interface ProfileInviteCodeAdminResponse {
 3. 总览页加载失败时展示后端错误，不吞掉 `fetchErrors`。
 4. API 调试页的 headers 使用键值行编辑，提交前转为 `[{ name, value }]`。
 5. 兑换码页的 `mode=private` 时展示允许用户输入区；其他模式提交空数组。
-6. 邀请码页只提交 `inviteCode` 与 JSON 对象 metadata，不在前端复制后端邀请码规则。
-7. 所有按钮的 loading 状态必须锁定重复提交。
-8. 移动端优先：表单单列，导航紧凑，结果面板可横向/纵向滚动。
+6. 兑换码页和邀请码页进入时加载数据库列表，保存后合并返回记录，点击列表项回填表单进入编辑态。
+7. 邀请码页只提交 `inviteCode` 与 JSON 对象 metadata，不在前端复制后端邀请码规则。
+8. 所有按钮的 loading 状态必须锁定重复提交。
+9. 移动端优先：表单单列，导航紧凑，结果面板可横向/纵向滚动。
 
 ## 7. 部署与联调
 
 ### 7.1 本地联调
 
-1. 启动后端：`npm run api-server`。
-2. 启动后台前端：在 `apps/admin-web` 执行 `npm run dev`。
-3. 后台 dev server 通过 Vite proxy 转发 `/admin/api` 到 `ADMIN_API_TARGET`；未配置时默认 `http://127.0.0.1:3100`。
-4. 若使用非 3100 端口，在仓库根目录 `.env.local` 设置 `ADMIN_API_TARGET=http://127.0.0.1:<api-server-port>`，并重启后台前端 dev server。
-5. `GENARRATIVE_API_PORT` 控制 Rust `api-server` 监听端口；`ADMIN_API_TARGET` 只控制后台前端 dev proxy 目标，二者需要指向同一个端口。
+1. 完整本地栈直接在仓库根目录执行 `npm run dev`。
+2. `npm run dev` 默认启动 SpacetimeDB standalone、Rust `api-server`、主站 Vite 和后台 Vite。
+3. 主站默认地址为 `http://127.0.0.1:3000`，后台可从主站 `http://127.0.0.1:3000/admin/` 进入，也可直连 `http://127.0.0.1:3102`。
+4. 主站 Vite 会把 `/admin/` 转发到后台 dev server，贴近生产同域 `/admin/` 入口。
+5. 后台 dev server 通过 Vite proxy 转发 `/admin/api` 到当前 Rust API 地址；`--api-port` 改动时脚本会同步注入 `ADMIN_API_TARGET`。
+6. 如需单独启动后台前端，可继续执行根脚本 `npm run admin-web:dev`，或在 `apps/admin-web` 执行 `npm run dev`；单独启动时未配置 `ADMIN_API_TARGET` 会默认代理到 `http://127.0.0.1:3100`。
+7. 后台 dev 端口可用 `npm run dev -- --admin-web-port <port>` 覆盖。
 
 ### 7.2 构建部署
 
@@ -430,8 +492,8 @@ export interface ProfileInviteCodeAdminResponse {
    - token 恢复、过期清理、退出登录。
    - 总览页正常数据、部分表统计失败、整体请求失败。
    - API 调试成功访问 `/healthz`，绝对 URL 被后端拒绝。
-   - 兑换码 public/unique/private 表单提交和停用。
-   - 邀请码表单提交、metadata JSON 对象校验和结果展示。
+   - 兑换码数据库列表加载、列表点击回填、public/unique/private 表单提交和停用。
+   - 邀请码数据库列表加载、普通用户邀请码不展示、列表点击回填、metadata JSON 对象校验和结果展示。
 2. 根工程：
    - `npm run check:encoding`。
    - 后续接入根 workspace 后，补充后台工程 build/typecheck 脚本。