speccore 8.3.147 → 8.3.149

package/templates/verify-spec-example.yaml

@@ -0,0 +1,852 @@
+# VERIFY_SPEC.yaml — 企业级 UI 冒烟测试规格（完整示例）
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# 格式类型: VERIFY_SPEC 格式（scenarios + actions + assertions 结构）
+# 适用场景: 精细 UI 交互测试（填写表单、点击按钮、断言元素状态）
+# 对应命令:
+#   • speccore verify --ui --spec ./tests/smoke.yaml     ← 推荐，原生支持完整交互逻辑
+#   • speccore verify --ui --config ./tests/smoke.yaml   ← 兼容，自动转换为批量页面测试
+# 按模块过滤: speccore verify --ui --spec ./tests/smoke.yaml --module=auth
+#
+# ⚠️ 格式说明:
+#   VERIFY_SPEC 格式 = scenarios + actions + assertions（本文件，支持完整交互）
+#   TestConfig  格式 = tests + routes + type（用于批量页面/API测试，见 pr.yaml/release.yaml）
+#   两种格式 speccore verify --config 均可自动识别。
+#
+# 本示例覆盖:
+#   • 全部 ActionType: fill, click, select, check, uncheck, hover, focus, blur, press,
+#     wait, navigate, screenshot, cookie, localStorage, script, scroll, upload, iframe,
+#     waitForRequest, waitForResponse, drag
+#   • 全部 AssertionType: visible, hidden, text, value, url, count, attribute, style, visual
+#   • 业务模块: 登录认证 / 用户中心 / 商品 / 购物车 / 订单 / 消息通知 / 后台管理
+#
+# v8.3.95+ 支持: cookie / localStorage / script / scroll / upload / iframe / waitForRequest / waitForResponse / drag
+
+name: 示例项目冒烟测试（完整版）
+platform: h5-mobile
+url: /
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 一、登录认证模块 (auth)
+# ─────────────────────────────────────────────────────────────────────────────
+scenarios:
+  # ── 场景1: 账号密码登录 ──
+  - name: 登录-账号密码登录
+    description: 模块:auth 页面:/login
+    actions:
+      - type: navigate
+        value: /login
+      - type: fill
+        selector: 'input[name="username"]'
+        value: test_user
+      - type: fill
+        selector: 'input[name="password"]'
+        value: test_password
+      - type: click
+        selector: 'button[type="submit"]'
+        waitFor: '.dashboard-container'
+    assertions:
+      - type: url
+        contains: /dashboard
+      - type: visible
+        selector: '.dashboard-container'
+      - type: text
+        selector: '.user-name'
+        contains: test_user
+
+  # ── 场景2: 手机号+验证码登录 ──
+  - name: 登录-手机号验证码
+    description: 模块:auth 页面:/login/phone
+    actions:
+      - type: navigate
+        value: /login/phone
+      - type: fill
+        selector: 'input[name="phone"]'
+        value: '13800138000'
+      - type: click
+        selector: '.send-code-btn'
+      - type: wait
+        delay: 2000
+      - type: fill
+        selector: 'input[name="verifyCode"]'
+        value: '123456'
+      - type: click
+        selector: 'button[type="submit"]'
+        waitFor: '.dashboard-container'
+    assertions:
+      - type: url
+        contains: /dashboard
+      - type: visible
+        selector: '.dashboard-container'
+
+  # ── 场景3: 微信 OAuth 登录 ──
+  - name: 登录-微信OAuth
+    description: 模块:auth 页面:/login 第三方登录
+    actions:
+      - type: navigate
+        value: /login
+      - type: click
+        selector: '.wechat-login-btn'
+      - type: waitForRequest
+        selector: 'https://open.weixin.qq.com/connect/oauth2/authorize'
+        timeout: 5000
+      - type: wait
+        delay: 3000
+    assertions:
+      - type: url
+        contains: wechat
+
+  # ── 场景4: 企业微信 SSO 登录 ──
+  - name: 登录-企业微信SSO
+    description: 模块:auth 页面:/login/sso
+    actions:
+      - type: navigate
+        value: /login/sso
+      - type: iframe
+        selector: '#sso-frame'
+      - type: fill
+        selector: 'input[name="corpId"]'
+        value: 'ww1234567890abcdef'
+      - type: click
+        selector: '.sso-submit-btn'
+        waitFor: '.dashboard-container'
+    assertions:
+      - type: url
+        contains: /dashboard
+      - type: visible
+        selector: '.dashboard-container'
+
+  # ── 场景5: 扫码登录 ──
+  - name: 登录-扫码登录
+    description: 模块:auth 页面:/login/qrcode
+    actions:
+      - type: navigate
+        value: /login/qrcode
+      - type: visible
+        selector: '.qrcode-img'
+      - type: wait
+        delay: 5000
+    assertions:
+      - type: visible
+        selector: '.qrcode-img'
+      - type: attribute
+        selector: '.qrcode-img'
+        attribute: src
+        contains: data:image
+
+  # ── 场景6: 登录失败-密码错误 ──
+  - name: 登录-密码错误提示
+    description: 模块:auth 页面:/login 异常场景
+    actions:
+      - type: navigate
+        value: /login
+      - type: fill
+        selector: 'input[name="username"]'
+        value: test_user
+      - type: fill
+        selector: 'input[name="password"]'
+        value: wrong_password
+      - type: click
+        selector: 'button[type="submit"]'
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: visible
+        selector: '.error-message'
+      - type: text
+        selector: '.error-message'
+        contains: 密码错误
+
+  # ── 场景7: 登录失败-账号锁定 ──
+  - name: 登录-账号锁定提示
+    description: 模块:auth 页面:/login 异常场景
+    actions:
+      - type: navigate
+        value: /login
+      - type: fill
+        selector: 'input[name="username"]'
+        value: locked_user
+      - type: fill
+        selector: 'input[name="password"]'
+        value: any_password
+      - type: click
+        selector: 'button[type="submit"]'
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: visible
+        selector: '.error-message'
+      - type: text
+        selector: '.error-message'
+        contains: 账号已被锁定
+
+  # ── 场景8: 记住密码功能 ──
+  - name: 登录-记住密码
+    description: 模块:auth 页面:/login 记住密码勾选
+    actions:
+      - type: navigate
+        value: /login
+      - type: check
+        selector: 'input[name="rememberMe"]'
+      - type: fill
+        selector: 'input[name="username"]'
+        value: test_user
+      - type: fill
+        selector: 'input[name="password"]'
+        value: test_password
+      - type: click
+        selector: 'button[type="submit"]'
+        waitFor: '.dashboard-container'
+    assertions:
+      - type: cookie
+        selector: remember_me
+        contains: 'true'
+
+  # ── 场景9: 退出登录 ──
+  - name: 登录-退出登录
+    description: 模块:auth 页面:/dashboard
+    actions:
+      - type: navigate
+        value: /dashboard
+      - type: click
+        selector: '.user-avatar'
+      - type: click
+        selector: '.logout-btn'
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: url
+        contains: /login
+      - type: visible
+        selector: '.login-form'
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 二、用户中心模块 (user)
+# ─────────────────────────────────────────────────────────────────────────────
+
+  # ── 场景10: 个人资料修改 ──
+  - name: 用户-修改个人资料
+    description: 模块:user 页面:/profile/edit
+    actions:
+      - type: navigate
+        value: /profile/edit
+      - type: fill
+        selector: 'input[name="nickname"]'
+        value: 新昵称测试
+      - type: select
+        selector: 'select[name="gender"]'
+        value: female
+      - type: fill
+        selector: 'input[name="email"]'
+        value: 'newemail@example.com'
+      - type: click
+        selector: '.save-profile-btn'
+      - type: wait
+        delay: 1500
+    assertions:
+      - type: visible
+        selector: '.toast-success'
+      - type: text
+        selector: '.toast-success'
+        contains: 保存成功
+
+  # ── 场景11: 头像上传 ──
+  - name: 用户-上传头像
+    description: 模块:user 页面:/profile/edit 头像上传
+    actions:
+      - type: navigate
+        value: /profile/edit
+      - type: upload
+        selector: 'input[type="file"].avatar-upload'
+        value: ./fixtures/test-avatar.png
+      - type: wait
+        delay: 2000
+    assertions:
+      - type: visible
+        selector: '.avatar-preview img'
+      - type: attribute
+        selector: '.avatar-preview img'
+        attribute: src
+        contains: avatar
+
+  # ── 场景12: 修改密码 ──
+  - name: 用户-修改密码
+    description: 模块:user 页面:/profile/security
+    actions:
+      - type: navigate
+        value: /profile/security
+      - type: fill
+        selector: 'input[name="oldPassword"]'
+        value: old_pass_123
+      - type: fill
+        selector: 'input[name="newPassword"]'
+        value: new_pass_456
+      - type: fill
+        selector: 'input[name="confirmPassword"]'
+        value: new_pass_456
+      - type: click
+        selector: '.change-password-btn'
+      - type: wait
+        delay: 1500
+    assertions:
+      - type: visible
+        selector: '.toast-success'
+      - type: text
+        selector: '.toast-success'
+        contains: 密码修改成功
+
+  # ── 场景13: Token 注入免登录（localStorage） ──
+  - name: 用户-Token注入免登录
+    description: 模块:user 页面:/profile Token注入方式
+    actions:
+      - type: localStorage
+        selector: accessToken
+        value: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+      - type: localStorage
+        selector: refreshToken
+        value: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+      - type: navigate
+        value: /profile
+      - type: wait
+        delay: 800
+    assertions:
+      - type: visible
+        selector: '.profile-header'
+      - type: text
+        selector: '.username'
+        contains: test_user
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 三、商品模块 (product)
+# ─────────────────────────────────────────────────────────────────────────────
+
+  # ── 场景14: 商品列表浏览 ──
+  - name: 商品-列表浏览
+    description: 模块:product 页面:/products
+    actions:
+      - type: navigate
+        value: /products
+      - type: scroll
+        selector: bottom
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: visible
+        selector: '.product-list'
+      - type: count
+        selector: '.product-item'
+        count: 10
+
+  # ── 场景15: 商品搜索 ──
+  - name: 商品-搜索
+    description: 模块:product 页面:/products 搜索功能
+    actions:
+      - type: navigate
+        value: /products
+      - type: fill
+        selector: 'input[name="keyword"]'
+        value: iPhone
+      - type: press
+        key: Enter
+      - type: wait
+        delay: 1500
+    assertions:
+      - type: visible
+        selector: '.search-result-list'
+      - type: count
+        selector: '.product-item'
+        count: 3
+
+  # ── 场景16: 商品详情 ──
+  - name: 商品-详情页
+    description: 模块:product 页面:/products/:id
+    actions:
+      - type: navigate
+        value: /products
+      - type: click
+        selector: '.product-item:first-child .product-title'
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: visible
+        selector: '.product-detail'
+      - type: text
+        selector: '.product-name'
+        contains: iPhone
+      - type: visible
+        selector: '.product-price'
+
+  # ── 场景17: 商品筛选 ──
+  - name: 商品-多条件筛选
+    description: 模块:product 页面:/products 筛选功能
+    actions:
+      - type: navigate
+        value: /products
+      - type: select
+        selector: 'select[name="category"]'
+        value: electronics
+      - type: check
+        selector: 'input[value="inStock"]'
+      - type: click
+        selector: '.filter-submit-btn'
+      - type: wait
+        delay: 1200
+    assertions:
+      - type: visible
+        selector: '.product-list'
+      - type: count
+        selector: '.product-item'
+        count: 5
+
+  # ── 场景18: 商品收藏 ──
+  - name: 商品-收藏/取消收藏
+    description: 模块:product 页面:/products/:id 收藏功能
+    actions:
+      - type: navigate
+        value: /products/123
+      - type: click
+        selector: '.favorite-btn'
+      - type: wait
+        delay: 500
+    assertions:
+      - type: style
+        selector: '.favorite-btn'
+        style: color
+        value: rgb(255, 77, 79)
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 四、购物车模块 (cart)
+# ─────────────────────────────────────────────────────────────────────────────
+
+  # ── 场景19: 添加商品到购物车 ──
+  - name: 购物车-添加商品
+    description: 模块:cart 页面:/products/:id
+    actions:
+      - type: navigate
+        value: /products/123
+      - type: click
+        selector: '.add-to-cart-btn'
+      - type: wait
+        delay: 800
+    assertions:
+      - type: visible
+        selector: '.cart-badge'
+      - type: text
+        selector: '.cart-badge'
+        contains: '1'
+
+  # ── 场景20: 购物车数量修改 ──
+  - name: 购物车-修改数量
+    description: 模块:cart 页面:/cart
+    actions:
+      - type: navigate
+        value: /cart
+      - type: fill
+        selector: '.cart-item:first-child .quantity-input'
+        value: '3'
+      - type: blur
+        selector: '.cart-item:first-child .quantity-input'
+      - type: wait
+        delay: 800
+    assertions:
+      - type: text
+        selector: '.cart-item:first-child .subtotal'
+        contains: '¥'
+
+  # ── 场景21: 购物车结算 ──
+  - name: 购物车-去结算
+    description: 模块:cart 页面:/cart
+    actions:
+      - type: navigate
+        value: /cart
+      - type: check
+        selector: '.cart-item:first-child .item-checkbox'
+      - type: click
+        selector: '.checkout-btn'
+      - type: wait
+        delay: 1500
+    assertions:
+      - type: url
+        contains: /checkout
+      - type: visible
+        selector: '.checkout-form'
+
+  # ── 场景22: 购物车删除商品 ──
+  - name: 购物车-删除商品
+    description: 模块:cart 页面:/cart
+    actions:
+      - type: navigate
+        value: /cart
+      - type: click
+        selector: '.cart-item:first-child .delete-btn'
+      - type: wait
+        delay: 800
+    assertions:
+      - type: count
+        selector: '.cart-item'
+        count: 0
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 五、订单模块 (order)
+# ─────────────────────────────────────────────────────────────────────────────
+
+  # ── 场景23: 订单创建 ──
+  - name: 订单-创建订单
+    description: 模块:order 页面:/checkout
+    actions:
+      - type: navigate
+        value: /checkout
+      - type: fill
+        selector: 'input[name="receiverName"]'
+        value: 张三
+      - type: fill
+        selector: 'input[name="phone"]'
+        value: '13800138000'
+      - type: fill
+        selector: 'input[name="address"]'
+        value: 北京市朝阳区测试街道123号
+      - type: click
+        selector: '.submit-order-btn'
+      - type: wait
+        delay: 2000
+    assertions:
+      - type: url
+        contains: /order/success
+      - type: visible
+        selector: '.order-success'
+      - type: text
+        selector: '.order-success'
+        contains: 订单提交成功
+
+  # ── 场景24: 订单支付 ──
+  - name: 订单-支付订单
+    description: 模块:order 页面:/pay/:orderId
+    actions:
+      - type: navigate
+        value: /pay/ORD202409110001
+      - type: click
+        selector: '.pay-method-wechat'
+      - type: click
+        selector: '.confirm-pay-btn'
+      - type: waitForResponse
+        selector: '/api/pay/create'
+        timeout: 10000
+      - type: wait
+        delay: 2000
+    assertions:
+      - type: url
+        contains: /pay/success
+      - type: visible
+        selector: '.pay-success'
+
+  # ── 场景25: 订单列表 ──
+  - name: 订单-列表查询
+    description: 模块:order 页面:/orders
+    actions:
+      - type: navigate
+        value: /orders
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: visible
+        selector: '.order-list'
+      - type: count
+        selector: '.order-item'
+        count: 5
+
+  # ── 场景26: 订单详情 ──
+  - name: 订单-详情查看
+    description: 模块:order 页面:/orders/:id
+    actions:
+      - type: navigate
+        value: /orders
+      - type: click
+        selector: '.order-item:first-child .view-detail-btn'
+      - type: wait
+        delay: 800
+    assertions:
+      - type: visible
+        selector: '.order-detail'
+      - type: text
+        selector: '.order-status'
+        contains: 待付款
+
+  # ── 场景27: 订单取消 ──
+  - name: 订单-取消订单
+    description: 模块:order 页面:/orders/:id
+    actions:
+      - type: navigate
+        value: /orders/ORD202409110001
+      - type: click
+        selector: '.cancel-order-btn'
+      - type: wait
+        delay: 500
+      - type: click
+        selector: '.confirm-cancel-btn'
+      - type: wait
+        delay: 1500
+    assertions:
+      - type: text
+        selector: '.order-status'
+        contains: 已取消
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 六、消息通知模块 (notification)
+# ─────────────────────────────────────────────────────────────────────────────
+
+  # ── 场景28: 消息列表 ──
+  - name: 消息-列表查看
+    description: 模块:notification 页面:/notifications
+    actions:
+      - type: navigate
+        value: /notifications
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: visible
+        selector: '.notification-list'
+      - type: count
+        selector: '.notification-item'
+        count: 3
+
+  # ── 场景29: 消息标记已读 ──
+  - name: 消息-标记已读
+    description: 模块:notification 页面:/notifications
+    actions:
+      - type: navigate
+        value: /notifications
+      - type: click
+        selector: '.notification-item:first-child'
+      - type: wait
+        delay: 500
+    assertions:
+      - type: style
+        selector: '.notification-item:first-child'
+        style: font-weight
+        value: '400'
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 七、后台管理模块 (admin)
+# ─────────────────────────────────────────────────────────────────────────────
+
+  # ── 场景30: 用户管理列表 ──
+  - name: 后台-用户管理
+    description: 模块:admin 页面:/admin/users
+    actions:
+      - type: navigate
+        value: /admin/users
+      - type: wait
+        delay: 1500
+    assertions:
+      - type: visible
+        selector: '.user-table'
+      - type: count
+        selector: '.user-table tbody tr'
+        count: 10
+
+  # ── 场景31: 数据报表（iframe 嵌入） ──
+  - name: 后台-数据报表iframe
+    description: 模块:admin 页面:/admin/reports iframe嵌入
+    actions:
+      - type: navigate
+        value: /admin/reports
+      - type: iframe
+        selector: '#report-frame'
+      - type: wait
+        delay: 2000
+    assertions:
+      - type: visible
+        selector: '.chart-container'
+      - type: count
+        selector: '.chart-item'
+        count: 4
+
+  # ── 场景32: 拖拽排序 ──
+  - name: 后台-拖拽排序
+    description: 模块:admin 页面:/admin/categories 拖拽排序
+    actions:
+      - type: navigate
+        value: /admin/categories
+      - type: drag
+        selector: '.category-item:first-child'
+        toSelector: '.category-item:last-child'
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: text
+        selector: '.category-item:last-child .category-name'
+        contains: 原第一个分类
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 八、通用能力与高级特性
+# ─────────────────────────────────────────────────────────────────────────────
+
+  # ── 场景33: Cookie 注入免登录 ──
+  - name: 通用-Cookie注入免登录
+    description: 模块:common Cookie注入跳过登录
+    actions:
+      - type: cookie
+        selector: session_token
+        value: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+        domain: example.com
+        path: /
+        secure: true
+        httpOnly: true
+      - type: cookie
+        selector: user_id
+        value: '10086'
+        domain: example.com
+        path: /
+      - type: navigate
+        value: /dashboard
+      - type: wait
+        delay: 1000
+    assertions:
+      - type: visible
+        selector: '.dashboard-container'
+      - type: text
+        selector: '.user-name'
+        contains: test_user
+
+  # ── 场景34: 首页滚动加载 ──
+  - name: 通用-首页滚动加载
+    description: 模块:home 页面:/
+    actions:
+      - type: navigate
+        value: /
+      - type: scroll
+        selector: bottom
+      - type: wait
+        delay: 1500
+      - type: scroll
+        selector: bottom
+      - type: wait
+        delay: 1500
+    assertions:
+      - type: visible
+        selector: '.load-more-btn'
+      - type: count
+        selector: '.product-card'
+        count: 20
+
+  # ── 场景35: 样式断言 ──
+  - name: 通用-按钮样式检查
+    description: 模块:ui 页面:/
+    actions:
+      - type: navigate
+        value: /
+    assertions:
+      - type: style
+        selector: '.primary-btn'
+        style: background-color
+        value: rgb(24, 144, 255)
+      - type: style
+        selector: '.primary-btn'
+        style: border-radius
+        value: 4px
+
+  # ── 场景36: 视觉对比测试 ──
+  - name: 通用-视觉对比测试
+    description: 模块:ui 页面:/ 视觉回归
+    actions:
+      - type: navigate
+        value: /
+      - type: screenshot
+    assertions:
+      - type: visual
+        selector: 'body'
+        threshold: normal
+
+  # ── 场景37: 键盘操作 ──
+  - name: 通用-键盘操作
+    description: 模块:common 页面:/products 键盘导航
+    actions:
+      - type: navigate
+        value: /products
+      - type: focus
+        selector: 'input[name="keyword"]'
+      - type: fill
+        selector: 'input[name="keyword"]'
+        value: MacBook
+      - type: press
+        key: Enter
+      - type: wait
+        delay: 1500
+    assertions:
+      - type: visible
+        selector: '.search-result-list'
+      - type: count
+        selector: '.product-item'
+        count: 2
+
+  # ── 场景38: hover 效果 ──
+  - name: 通用-hover效果
+    description: 模块:ui 页面:/products hover交互
+    actions:
+      - type: navigate
+        value: /products
+      - type: hover
+        selector: '.product-item:first-child'
+      - type: wait
+        delay: 500
+    assertions:
+      - type: style
+        selector: '.product-item:first-child'
+        style: box-shadow
+        contains: rgba
+
+  # ── 场景39: 元素隐藏检查 ──
+  - name: 通用-元素隐藏
+    description: 模块:ui 页面:/login 未登录状态
+    actions:
+      - type: navigate
+        value: /login
+    assertions:
+      - type: hidden
+        selector: '.user-menu'
+      - type: hidden
+        selector: '.logout-btn'
+
+  # ── 场景40: 表单值断言 ──
+  - name: 通用-表单值检查
+    description: 模块:user 页面:/profile/edit 表单默认值
+    actions:
+      - type: navigate
+        value: /profile/edit
+    assertions:
+      - type: value
+        selector: 'input[name="username"]'
+        equals: test_user
+      - type: value
+        selector: 'input[name="email"]'
+        contains: '@'
+
+  # ── 场景41: JavaScript 注入执行 ──
+  - name: 通用-JS脚本注入
+    description: 模块:common 页面:/ JS注入测试
+    actions:
+      - type: navigate
+        value: /
+      - type: script
+        value: 'window.testFlag = "injected";'
+      - type: wait
+        delay: 500
+      - type: script
+        value: 'return window.testFlag;'
+    assertions:
+      - type: text
+        selector: 'body'
+        contains: injected
+
+  # ── 场景42: 响应式断点测试 ──
+  - name: 通用-响应式布局
+    description: 模块:ui 页面:/ 移动端适配
+    actions:
+      - type: navigate
+        value: /
+      - type: wait
+        delay: 800
+    assertions:
+      - type: visible
+        selector: '.mobile-nav'
+      - type: hidden
+        selector: '.desktop-sidebar'