106 lines
5.2 KiB
Markdown
106 lines
5.2 KiB
Markdown
# Seed Verification Guide (Staging)
|
||
|
||
## Service Startup (Local)
|
||
|
||
- Backend: `go run ./backend/main.go serve` (default `http://localhost:8080`).
|
||
- Portal frontend: `npm -C frontend/portal install` then `npm -C frontend/portal run dev` (default `http://localhost:5174`, remote use `http://10.1.1.104:5174`).
|
||
- Superadmin frontend: `npm -C frontend/superadmin install` then `npm -C frontend/superadmin run dev` (default `http://localhost:5173`, remote use `http://10.1.1.104:5173`).
|
||
- Portal dev server proxies `/v1` to `http://localhost:8080` (`frontend/portal/vite.config.js`).
|
||
- Superadmin dev server proxies `/super/v1` and `/v1` to `http://localhost:8080` (`frontend/superadmin/vite.config.mjs`).
|
||
|
||
## Chrome DevTools MCP
|
||
|
||
- Chrome remote debugging已由远程机器启动，无需本机手动启动浏览器。
|
||
- Use MCP to connect at `http://10.1.1.104:9222` (SSH forwarded DevTools port).
|
||
- Open target URLs via MCP and run page-level assertions (no API-level calls required).
|
||
|
||
## AI Auto-Handling Prereqs
|
||
|
||
- **Seed 检查/执行**
|
||
- DB 查询（示例）：`SELECT COUNT(*) FROM tenants;`
|
||
- 若结果为 0，执行 `go run ./backend/main.go seed` 后再继续。
|
||
- **tenantCode 获取**
|
||
- DB 查询：`SELECT code FROM tenants ORDER BY id DESC LIMIT 1;`
|
||
- 将结果注入到 Portal URL `/t/:tenantCode`。
|
||
- **清理浏览器存储**
|
||
- 在 MCP 中执行脚本：清理 `localStorage` / `sessionStorage`，并清除 cookies。
|
||
- 示例：`chrome-devtools_evaluate_script` → `() => { localStorage.clear(); sessionStorage.clear(); document.cookie.split(';').forEach(c => document.cookie = c.replace(/^ +/, '').replace(/=.*/, '=;expires=' + new Date().toUTCString() + ';path=/')); }`
|
||
|
||
### MCP Example Flow (AI Guidance)
|
||
|
||
1. **Open Portal Home**
|
||
- `chrome-devtools_new_page` → `http://10.1.1.104:5174/t/:tenantCode`
|
||
- `chrome-devtools_wait_for` text: `探索戏曲` or page title
|
||
|
||
2. **Portal Login**
|
||
- Navigate to `/t/:tenantCode/auth/login`
|
||
- Tick checkbox `#terms` (required)
|
||
- `chrome-devtools_fill` phone input with `13800138000`
|
||
- Click `获取验证码`, wait for OTP step
|
||
- `chrome-devtools_fill` OTP input with `1234`
|
||
- Click `登录 / 注册`
|
||
- `chrome-devtools_wait_for` text: `个人中心` or user nickname
|
||
|
||
3. **Verify Orders & Library**
|
||
- Navigate to `/t/:tenantCode/me/orders` and assert at least 1 row
|
||
- Navigate to `/t/:tenantCode/me/library` and assert at least 1 item
|
||
|
||
4. **Open Content Detail**
|
||
- From home list, click the first content card
|
||
- Assert detail page loads and cover/media is visible
|
||
|
||
5. **Superadmin Login**
|
||
- `chrome-devtools_new_page` → `http://10.1.1.104:5173/super/auth/login`
|
||
- Fill `#username` with `superadmin` and `#password1` with `superadmin123`
|
||
- Click `Sign In`
|
||
- Wait for dashboard cards or `Dashboard` text
|
||
|
||
6. **Superadmin Lists**
|
||
- `/super/superadmin/orders` → verify flagged order badge
|
||
- `/super/superadmin/finance` → verify ledger table row
|
||
- `/super/superadmin/notifications` → verify template rows
|
||
|
||
7. **Console/Error Checks**
|
||
- After each page, call `chrome-devtools_list_console_messages` and fail on `error` entries.
|
||
- Use `chrome-devtools_take_snapshot` to locate table rows by text.
|
||
|
||
## Run Seed
|
||
|
||
- Execute `go run ./backend/main.go seed`.
|
||
- Ensure no panics; capture console output for troubleshooting.
|
||
|
||
## Data Validation (DB/Logs)
|
||
|
||
- Users: verify `creator`, `test`, `superadmin`, `negative` exist in `users.username`.
|
||
- Tenant: read `tenants.code` to obtain `tenantCode` (example: `SELECT code FROM tenants ORDER BY id DESC LIMIT 1;`).
|
||
- Memberships: `tenant_users` includes `creator` as `tenant_admin`, `test` as `member`.
|
||
- Orders: `orders` has `content_purchase` + `withdrawal`, plus flagged/reconciled records.
|
||
- Ledger: `tenant_ledgers` has at least one row.
|
||
- Templates: `notification_templates` contains order/audit/interaction types.
|
||
|
||
## Portal Smoke (Use tenantCode)
|
||
|
||
- Tenant code: query DB (`SELECT code FROM tenants ORDER BY id DESC LIMIT 1;`), then open `http://10.1.1.104:5174/t/:tenantCode`.- Login: OTP is fixed to `1234` (see `backend/app/services/user.go`).
|
||
- Home: `/t/:tenantCode` lists content.
|
||
- Detail: open any content detail; cover and main asset render.
|
||
- Login: sign in as `test` (phone `13800138000`, OTP `1234`) and open `/t/:tenantCode/me`.
|
||
- Orders & Library: `/t/:tenantCode/me/orders` and `/t/:tenantCode/me/library` show data.
|
||
- Likes/Favorites: content detail shows prefilled like/favorite; toggle to confirm.
|
||
- Notifications: `/t/:tenantCode/me/notifications` shows unread items.
|
||
|
||
## Superadmin Smoke
|
||
|
||
- Open `http://localhost:5173/super/auth/login`.
|
||
- Login: `superadmin` / `superadmin123`.
|
||
- Users: list includes `negative`; balance anomaly list returns result.
|
||
- Orders: list includes flagged/reconciled and refund orders.
|
||
- Withdrawals: list contains `created`/`paid`/`failed` statuses.
|
||
- Finance: ledger list has data; order anomaly list returns missing paid/refund items.
|
||
- Content/Reports: content list is populated; report list has pending item.
|
||
- Templates: order/audit/interaction templates present.
|
||
- System Configs: `site_name` and `support_email` present.
|
||
|
||
## Manual-Only Coverage
|
||
|
||
- Upload flow (init/part/complete) requires real storage integration; seed only preloads assets.
|