quyun-v2/docs/seed_verification.md

Seed Verification & UI Test Guide (Staging)

Service Startup (Local)

• Backend: go run ./backend/main.go serve (default http://localhost:8080).
• Portal: npm -C frontend/portal install && npm -C frontend/portal run dev (default http://localhost:5174, remote http://10.1.1.104:5174).
• Superadmin: npm -C frontend/superadmin install && npm -C frontend/superadmin run dev (default http://localhost:5173, remote http://10.1.1.104:5173).
• Proxies: portal /v1 → backend 8080; superadmin /super/v1 & /v1 → backend 8080.

Chrome DevTools MCP

• Remote Chrome 已启动；连接 http://10.1.1.104:9222。
• 仅页面操作，无需 API 直接调用。

AI Auto-Handling Prereqs

• Seed 检查：SELECT COUNT(*) FROM tenants; 为 0 则 go run ./backend/main.go seed。
• tenantCode：SELECT code FROM tenants ORDER BY id DESC LIMIT 1; → /t/:tenantCode。
• 清理存储：localStorage.clear(); sessionStorage.clear(); + 清除 cookies。

Portal Test Checklist (tenantCode from DB)

1. Login /auth/login → 手机 13800138000 + OTP 1234，勾选条款；断言“登录成功”。
2. Home /t/:tenantCode → 有内容/导航无报错。
3. Content Detail /t/:tenantCode/contents/1 → 封面/正文/评论可见。
4. Orders /t/:tenantCode/me/orders → 列表非空。
5. Library /t/:tenantCode/me/library → 列表非空。
6. Favorites /t/:tenantCode/me/favorites → 列表非空，可见“取消收藏”。
7. Likes /t/:tenantCode/me/likes → 列表非空，可见“取消点赞”。
8. Notifications /t/:tenantCode/me/notifications → 页面无错误。
9. Creator entry /t/:tenantCode/creator → 页面可加载。

• 每页：调用 chrome-devtools_list_console_messages 无 error。

Superadmin Test Checklist

1. Login /super/auth/login → superadmin/superadmin123，成功进入 Dashboard。
2. Orders /super/superadmin/orders → 有标记/对账数据。
3. Finance /super/superadmin/finance → 提现审核/流水/异常标签有数据。
4. Users /super/superadmin/users → 列表可见。
5. Tenants /super/superadmin/tenants → 列表可见。
6. Notifications /super/superadmin/notifications → 模板列表可见。
7. System Configs /super/superadmin/system-configs → site_name/support_email 可见。
8. Audit Logs /super/superadmin/audit-logs → 列表可见。

• 每页：检查 console 无 error；必要时截图。

Manual-Only Coverage

• 上传链路（init/part/complete）需真实存储；seed 仅提供素材记录。

Seed Notes

• 执行 go run ./backend/main.go seed 会 TRUNCATE 全部业务表后重建。
• 用户：creator(13800000001), test(13800138000), superadmin(13800009999), negative(13800009998)。
• 租户：meipai_<rand>（DB 查询获取）。
• Orders/likes/favorites/notifications 已预置示例数据。

MCP Steps (Example)

• chrome-devtools_new_page http://10.1.1.104:5174/auth/login
• 填手机号+勾条款 → 获取验证码 → 填 1234 → 登录
• 导航并断言：
  • /t/:tenantCode/me/orders 有行
  • /t/:tenantCode/me/library 有行
  • /t/:tenantCode/me/favorites 有行
  • /t/:tenantCode/me/likes 有行
• Superadmin：打开登录 → 填账号密码 → 断言 Dashboard → 进入 Orders/Finance/Notifications/System Configs/Audit Logs；每页检查 console error。