rogee/quyun-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
05a0d07dbb3b52c49d2e158918786f51f8a4d206
quyun-v2/docs/release-evidence/2026-02-08.md

16 KiB
Raw Blame History

Release Evidence — 2026-02-08

Scope

D1 基线执行（对应 docs/plan.md：T1 / T4 / T15）：

  • 生产部署能力差距台账（4 项标准）
  • 前端生产路由数据来源盘点（Portal + Superadmin）
  • 后端隔离基线盘点（order/content/coupon/tenant/wallet）

Environment

  • Repo: /home/rogee/Projects/quyun_v2
  • Branch: main
  • Plan commit: 3126ed5 (chore: refine production-readiness execution plan)

Evidence A — 4项标准差距台账（Baseline)

标准 当前状态 结论 关键证据
1) 前端所有数据来源后端接口/渲染 Portal/Superadmin 主业务页大多为 API；存在硬编码业务数据页面与 demo mock 数据入口 未达标 frontend/portal/src/views/user/LikesView.vue:12-35（硬编码 items）；frontend/superadmin/src/views/uikit/TableDoc.vue:2,85-91 + frontend/superadmin/src/service/CustomerService.js:2-39（mock数据源）
2) 用户/租户数据隔离完备 Controller 与 Service 多数传递 tenantID/userID 并做 where 约束；仍存在“依赖人工维护”的模式，需继续补负向测试 部分达标 backend/app/http/v1/helpers.go（tenant/user 上下文）；backend/app/services/order.go:31-39,64-73; backend/app/services/content.go:31-47; backend/app/services/coupon.go:162-175,237-239; backend/app/services/tenant_member.go:138-154; backend/app/services/wallet.go:35-43
3) 超级管理员后台可审计 超管审计链路已存在（表、服务、API、页面） 达标 backend/database/migrations/20260115103830_create_audit_logs_and_system_configs.sql:3-25; backend/app/http/super/v1/audit_logs.go:16-27; frontend/superadmin/src/views/superadmin/AuditLogs.vue:46-67
4) 租户管理对租户数据可审计 目前未见租户侧独立审计日志查询 API/页面（仅通知不等同审计日志） 未达标 backend/app/http/v1 未发现租户 audit-log 列表入口；Portal 仅有通知页 frontend/portal/src/views/user/NotificationsView.vue

Evidence B — Portal 路由数据来源盘点（生产相关）

来源：frontend/portal/src/router/index.js

B1. API 驱动为主（带少量 UI 常量）

  • /, /t/:tenantCode -> HomeView.vue（API + fallback 常量）
  • /t/:tenantCode/channel -> tenant/HomeView.vue（API + tab 常量）
  • /t/:tenantCode/contents/:id -> content/DetailView.vue（API）
  • /t/:tenantCode/me/orders、/wallet、/coupons、/library、/favorites、/notifications、/profile（以 userApi 为主）
  • /t/:tenantCode/creator/*（以 creatorApi 为主）
  • /t/:tenantCode/checkout、/payment/:id（contentApi/orderApi）

B2. 高风险（业务硬编码）

  • /t/:tenantCode/me/likes -> user/LikesView.vue
    • 证据：items 直接硬编码业务内容 LikesView.vue:12-35

B3. 静态/演示型（非关键业务）

  • /creator/apply -> creator/ApplyView.vue
    • 证据：setTimeout 模拟提交，未接后端 ApplyView.vue:42-47
  • /t/:tenantCode/me/security -> user/SecurityView.vue
    • 证据：页面展示固定手机号/验证流程占位，未接后端 SecurityView.vue:64,113,29

Evidence C — Superadmin 路由数据来源盘点

来源：frontend/superadmin/src/router/index.js

C1. 生产业务路由（/superadmin/*）

  • 租户、用户、订单、内容、创作者、优惠券、财务、报表、资产、通知、审计日志、系统配置等页面均存在。
  • 这些页面普遍是“API 查询 + 本地选项常量（筛选项）”混合模式。

C2. 明确 demo/mock 数据入口（应隔离）

  • /uikit/table -> views/uikit/TableDoc.vue
    • 证据：CustomerService.getCustomers* TableDoc.vue:85-91
    • 数据源：CustomerService.js 内置对象数组 CustomerService.js:2-39（后续大量同类对象）

Evidence D — 后端隔离基线矩阵（T4）

模块 主要隔离实现 风险备注 证据
order query-time 使用 tenantID/userID 条件；读取明细时 tenant + user 双条件 Recharge 类型用 OR 放行（设计允许同用户跨租户查看充值记录），需确认业务预期 order.go:31-39,64-73,66-70
content 列表/详情普遍 tenant 过滤；filter tenant mismatch 直接 forbidden UnderlyingDB + preload 路径需持续关注遗漏风险 content.go:31-47,148-159,172-176
coupon Receive/Create/Update/Get/Validate/MarkUsed 多处 tenant 校验 存在 tenantID==0 分支（平台视角），需在接口层严格限定调用入口 coupon.go:162-175,237-239,306-308,657-658,720-721
tenant (member) 管理操作先 ensureTenantAdmin，再检查 request/invite 的 tenant 一致性 需用负向用例覆盖“跨租户 requestID/inviteID”场景 tenant_member.go:138-154,227-237,291-295,320-330
wallet 钱包交易列表使用 tenant+user 查询；支持充值订单特例 与订单同样存在 recharge 例外，需文档化并测试 wallet.go:35-43

Performance Baseline Protocol (for later execution)

按计划定义，后续性能验证需满足：

  • 目标接口：/super/v1/audit-logs + 新增租户审计列表
  • 条件：page=1&limit=20，默认排序
  • 样本：预热10次 + 采样50次，统计 p95
  • 结果写入本文件后续“性能结果”小节

D1 Exit Check

  • T1 差距台账已建立并含证据路径
  • T4 隔离基线矩阵已建立（order/content/coupon/tenant/wallet）
  • T15 证据模板文件已创建并写入 D1 结果

Evidence E — T2 执行结果（LikesView API化）

E1. 变更内容

  • 文件：frontend/portal/src/views/user/LikesView.vue
  • 改动要点：
    • 删除硬编码 items 列表（原本本地静态业务记录）。
    • 接入 userApi.getLikes() 拉取后端数据。
    • 接入 userApi.removeLike(id) 处理取消点赞并同步本地列表。
    • 复用与 Favorites/Library 一致的数据字段渲染：title/cover/type/author_name/author_avatar/created_at。

E2. 核验结果

  • LSP（目标文件）: lsp_diagnostics frontend/portal/src/views/user/LikesView.vue severity=error -> No diagnostics found。
  • Portal lint: npm -C frontend/portal run lint -> pass。
  • Portal build: npm -C frontend/portal run build -> pass（包含 LikesView-*.js 构建产物）。

E3. 状态更新

  • 标准 #1（前端数据来源后端接口/渲染）：
    • LikesView 已从“未达标子项”移除。
    • 剩余风险主要在 demo/doc 路由隔离（/uikit/table）与静态占位页策略。

Evidence F — T3 执行结果（Superadmin demo 路由隔离）

F1. 变更内容

  • 文件：frontend/superadmin/src/router/index.js
  • 改动要点：
    • 新增 isDemoOnlyRoute(path) 判定，覆盖：
      • /uikit/*
      • /blocks
      • /pages/empty
      • /pages/crud
      • /documentation
      • /landing
    • 在全局 beforeEach 中加入生产环境拦截：
      • if (!import.meta.env.DEV && isDemoOnlyRoute(to.path)) return { name: 'dashboard' }
    • 效果：开发环境保留 demo 调试能力；非开发环境禁止通过 URL 直接进入 demo 页面。

F2. 核验结果

  • LSP（目标文件）: frontend/superadmin/src/router/index.js -> No diagnostics found。
  • Superadmin lint: npm -C frontend/superadmin run lint -> pass（首次执行出现一次临时文件 ENOENT，重试通过）。
  • Superadmin build: npm -C frontend/superadmin run build -> pass。

F3. 状态更新

  • 标准 #1（前端生产数据来源约束）继续收敛：
    • demo/mock 路由已从“可直接访问”改为“生产环境拦截”。
    • 仍建议后续把 demo 路由按配置化开关进一步显式隔离（可选增强项）。

Evidence G — T6 执行结果（跨租户负向测试补强）

G1. 新增测试覆盖

Order

  • 文件：backend/app/services/order_test.go
  • 新增用例：
    • Test_Pay_DenyCrossTenantOrder
    • Test_Status_DenyCrossTenantOrder
  • 断言目标：同一用户持有 A 租户订单时，用 B 租户上下文调用 Pay/Status 必须返回 ErrForbidden。

Coupon

  • 文件：backend/app/services/coupon_test.go
  • 新增用例：
    • Test_Validate_DenyCrossTenantCoupon
    • Test_MarkUsed_DenyCrossTenantCoupon
    • Test_Grant_DenyCrossTenantCoupon
  • 断言目标：
    • Validate/MarkUsed 跨租户必须拒绝（ErrForbidden）
    • Grant 使用非所属租户发放时必须失败且不产生 user_coupons 记录。

Tenant Member

  • 文件：backend/app/services/tenant_member_test.go
  • 新增用例：
    • Test_ReviewJoin 中补充跨租户 review 拒绝场景
    • Test_ListMembersAndRemove 中补充跨租户 remove 拒绝场景
    • Test_ListInvitesAndDisable 中补充跨租户 disable 邀请拒绝场景
  • 断言目标：跨租户操作返回 ErrForbidden，目标记录状态不应被修改。

G2. 测试执行结果

  • 命令（聚合）：
    • cd backend && env GOCACHE=$PWD/.gocache GOTMPDIR=$PWD/.gotmp go test ./app/services -run 'Test_Order/(Test_Pay_DenyCrossTenantOrder|Test_Status_DenyCrossTenantOrder)|Test_Coupon/(Test_Validate_DenyCrossTenantCoupon|Test_MarkUsed_DenyCrossTenantCoupon|Test_Grant_DenyCrossTenantCoupon)|Test_Tenant/(Test_ReviewJoin|Test_ListMembersAndRemove|Test_ListInvitesAndDisable)'
  • 结果：PASS（ok quyun/v2/app/services）

G3. 过程说明

  • 首轮执行暴露新增测试数据问题（tenants_code_key 唯一约束冲突），已通过为新增租户测试数据设置唯一 code 修复。
  • 修复后目标测试集稳定通过。

Evidence H — T8 执行结果（租户侧审计日志 API）

H1. 变更内容

  • 新增 DTO：backend/app/http/v1/dto/creator_audit.go
    • CreatorAuditLogListFilter：分页 + operator_id/operator_name/action/target_id/keyword/created_at_from/created_at_to/asc/desc
    • CreatorAuditLogItem：id/operator_id/operator_name/action/target_id/detail/created_at
  • 新增服务方法：backend/app/services/creator.go
    • Creator.ListAuditLogs(ctx, tenantID, userID, filter)
    • 强制租户范围：audit_logs.tenant_id = currentTenantID
    • 权限校验：复用 Tenant.ensureTenantAdmin，仅租户主账号/tenant_admin 可查看
    • 过滤/排序/分页：对齐 super audit 风格（支持 id/created_at 排序）
    • 操作者名补齐：批量查询 user 表回填 operator_name
    • DB 错误统一 errorx.ErrDatabaseError.WithCause(err) 包装
  • 新增控制器接口：backend/app/http/v1/creator.go
    • GET /v1/t/:tenantCode/creator/audit-logs
    • 控制器仅做 bind + tenant/user 上下文提取 + service 调用
  • 路由/文档生成：
    • atomctl gen route
    • atomctl swag init
    • 生成结果包含：
      • backend/app/http/v1/routes.gen.go 新路由注册
      • backend/docs/swagger.yaml|swagger.json|docs.go 新接口与模型

H2. 测试与核验

  • 新增测试：backend/app/services/creator_test.go
    • Test_ListAuditLogs
    • 覆盖点：
      • 仅返回当前租户日志（跨租户数据不泄露）
      • operator_name 过滤生效
      • 非管理员访问拒绝
  • 执行结果：
    • go test ./app/services -run 'Test_Creator/(Test_ListAuditLogs|Test_ReportOverview|Test_ExportReport)$' -> PASS
    • go test ./app/http/v1 ./app/services -> PASS
    • go test ./...（backend）-> PASS
  • LSP（本次变更文件）: No diagnostics found

Evidence I — T9 执行结果（Portal 创作者审计页面）

I1. 变更内容

  • API 封装：frontend/portal/src/api/creator.js
    • 新增 listAuditLogs(params) -> /creator/audit-logs
  • 新增页面：frontend/portal/src/views/creator/AuditView.vue
    • 筛选：operator_id/operator_name/action/target_id/keyword/created_at_from/created_at_to
    • 排序：created_at|id + 升降序
    • 列表展示：日志ID、操作者、动作、目标ID、详情、创建时间
    • 分页：PrimeVue Paginator
  • 路由注册：frontend/portal/src/router/index.js
    • 新增 creator-audit，路径 creator/audit
  • 侧边菜单：frontend/portal/src/layout/LayoutCreator.vue
    • 新增“操作审计”入口，链接 tenantRoute('/creator/audit')

I2. 核验结果

  • Portal lint: npm -C frontend/portal run lint -> pass
  • Portal build: npm -C frontend/portal run build -> pass（产物含 AuditView-*.js）
  • LSP（本次前端变更文件）: No diagnostics found

Status Update

  • 标准 #4（租户管理侧可审计）：
    • 已具备租户侧审计查询 API + Portal 页面入口与展示能力
    • 当前状态：达标（待后续前后端联调回归统一验收）

Evidence J — T16 执行结果 (Tenant Creator Audit Flow Acceptance)

J1. 测试执行摘要

测试用例 状态 观察结果 证据
Admin Login & Navigation PASS Admin 13800000001 成功登录并导航至 /t/meipai_765/creator/audit。页面标题“操作审计”验证通过。 admin-audit-page-loaded.png
Data Rendering PASS 审计日志列表渲染多行数据 (IDs 13, 12, etc.)。 admin-audit-page-loaded.png
Action Filter PASS 筛选动作 "seed" 后列表缩减为单条匹配记录 (ID 3)。 admin-filter-result.png
Pagination PASS 切换至第 2 页显示了不同的记录 (IDs 3, 2, 1)。 admin-page-2.png
Permission Control PASS 普通成员 13800138000 访问页面显示“暂无审计记录”，验证了数据权限控制。 member-denied-state.png

J2. 截图证据

1. Admin: Audit Page Loaded

Admin Audit Page 完整审计日志列表展示

2. Admin: Filter Result ("seed")

Admin Filter Result 筛选 action='seed' 结果

3. Admin: Pagination (Page 2)

Admin Page 2 第 2 页旧数据展示

4. Member: Access Denied / No Data

Member Denied 非管理员用户访问无数据展示

J3. 结论

PASS. 新增的租户创作者审计流程对管理员功能正常，对普通成员具备权限控制。T16 验收通过。

Evidence K — T17 发布门禁汇总与 Go/No-Go

K1. 门禁清单结果

门禁项 结果 证据
T13 Backend 全量测试 PASS go test ./...（backend）通过
T14 Frontend build/lint PASS npm -C frontend/portal run lint && npm -C frontend/portal run build 通过；npm -C frontend/superadmin run lint && npm -C frontend/superadmin run build 通过
T16 前端页面流验收（本次受影响流） PASS Evidence J + 截图 docs/release-evidence/2026-02-08/*.png
租户审计 API 权限与数据面验证 PASS 成员调用 /v1/t/meipai_765/creator/audit-logs 返回 code=1206 无权限操作该租户；管理员调用返回 total=13 且可筛选/分页

K2. 四项标准最终判定（本轮）

标准 判定 说明
1) 前端业务数据来自后端接口/渲染 PASS（本轮范围） LikesView 已 API 化；superadmin demo 路由已生产拦截
2) 用户/租户数据隔离完备 PASS（本轮范围） 跨租户负向测试补强通过（Evidence G）
3) 超管后台可审计 PASS 既有超管审计链路 + 构建验证通过
4) 租户管理侧可审计 PASS 新增 creator audit API + Portal 页面 + 页面流验收通过

K3. Go/No-Go 结论

Go（可进入生产发布候选）。

依据：T13/T14/T16/T17 门禁均通过，且四项标准在本轮改造范围内均达标。

K4. 发布前剩余建议（非阻塞）

  1. 按计划补充审计接口性能基线（p95）记录（目前文档仅有测量协议，尚缺执行数据）。
  2. 将 superadmin demo 路由从“运行时拦截”进一步提升为“构建期裁剪”（可选增强）。
  3. 按计划完成归档动作：若确认本阶段收口，执行 T18（归档 docs/plan.md -> docs/plans/<date>.md 并清空活动 plan）。

Next Actions (D2+)

  1. （已完成）执行计划门禁与联调验收项（T13/T14/T16/T17），见 Evidence K。
  2. （已完成）进行前端页面流验收（creator audit 查询/筛选/分页）并补充录屏或截图证据（见 Evidence J）。
  3. （可选增强）将 superadmin demo 路由按构建开关完全剔除，而非仅运行时拦截。
Reference in New Issue View Git Blame Copy Permalink