572 lines
31 KiB
Python
572 lines
31 KiB
Python
#!/usr/bin/env python3
|
||
"""生成 UI自动化测试计划.docx"""
|
||
|
||
from docx import Document
|
||
from docx.shared import Inches, Pt, Cm, RGBColor
|
||
from docx.enum.table import WD_TABLE_ALIGNMENT
|
||
from docx.enum.text import WD_ALIGN_PARAGRAPH
|
||
from docx.enum.section import WD_ORIENT
|
||
from docx.oxml.ns import qn
|
||
from docx.oxml import OxmlElement
|
||
import datetime
|
||
|
||
doc = Document()
|
||
|
||
# ======================== 样式设置 ========================
|
||
style = doc.styles['Normal']
|
||
style.font.name = '微软雅黑'
|
||
style.font.size = Pt(10.5)
|
||
style.element.rPr.rFonts.set(qn('w:eastAsia'), '微软雅黑')
|
||
|
||
|
||
def set_cell_shading(cell, color):
|
||
shading_elm = OxmlElement('w:shd')
|
||
shading_elm.set(qn('w:fill'), color)
|
||
shading_elm.set(qn('w:val'), 'clear')
|
||
cell._tc.get_or_add_tcPr().append(shading_elm)
|
||
|
||
|
||
def add_table_with_header(doc, headers, rows, col_widths=None):
|
||
table = doc.add_table(rows=1 + len(rows), cols=len(headers))
|
||
table.style = 'Table Grid'
|
||
# Header
|
||
for i, h in enumerate(headers):
|
||
cell = table.rows[0].cells[i]
|
||
cell.text = h
|
||
cell.paragraphs[0].runs[0].bold = True
|
||
set_cell_shading(cell, '4472C4')
|
||
cell.paragraphs[0].runs[0].font.color.rgb = RGBColor(255, 255, 255)
|
||
# Data
|
||
for r_idx, row_data in enumerate(rows):
|
||
for c_idx, val in enumerate(row_data):
|
||
table.rows[r_idx + 1].cells[c_idx].text = str(val)
|
||
if col_widths:
|
||
for i, w in enumerate(col_widths):
|
||
for row in table.rows:
|
||
row.cells[i].width = Cm(w)
|
||
return table
|
||
|
||
|
||
# ======================== 封面 ========================
|
||
doc.add_paragraph()
|
||
doc.add_paragraph()
|
||
title = doc.add_paragraph()
|
||
title.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
||
run = title.add_run('SwitchBot App UI自动化测试计划')
|
||
run.font.size = Pt(26)
|
||
run.bold = True
|
||
|
||
doc.add_paragraph()
|
||
subtitle = doc.add_paragraph()
|
||
subtitle.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
||
run = subtitle.add_run('单品设备功能测试 + 设备添加 + 自动化场景')
|
||
run.font.size = Pt(14)
|
||
run.font.color.rgb = RGBColor(68, 114, 196)
|
||
|
||
doc.add_paragraph()
|
||
doc.add_paragraph()
|
||
info = doc.add_paragraph()
|
||
info.alignment = WD_ALIGN_PARAGRAPH.CENTER
|
||
info.add_run(f'版本: v1.0\n').font.size = Pt(11)
|
||
info.add_run(f'日期: {datetime.date.today().strftime("%Y-%m-%d")}\n').font.size = Pt(11)
|
||
info.add_run('部门: 测试部\n').font.size = Pt(11)
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 1. 项目概述 ========================
|
||
doc.add_heading('1. 项目概述', level=1)
|
||
|
||
doc.add_heading('1.1 背景', level=2)
|
||
doc.add_paragraph(
|
||
'SwitchBot App 涵盖 100+ 款 IoT 设备，需要对每款设备的 App 功能进行自动化回归测试。'
|
||
'本计划基于已验证的 Vitest + Appium 技术框架，按优先级分层推进：'
|
||
'必测项 → 单品探索 → 全功能 → 平台，高优先级层先达标再投入下一层。'
|
||
)
|
||
|
||
doc.add_heading('1.2 技术栈', level=2)
|
||
rows = [
|
||
('框架', 'Vitest (TypeScript) + Appium'),
|
||
('驱动', 'UIAutomator2 (Android) / WebDriverAgent (iOS)'),
|
||
('AI辅助', 'Claude Code 边跑边写生成 & 调试脚本'),
|
||
('测试设备', 'Samsung 1080x2280 (Android) / iPhone 390x844pt (iOS)'),
|
||
('App', 'SwitchBot (com.theswitchbot.switchbot)'),
|
||
('报告', '自定义 HTML 报告 + JSON 结果'),
|
||
('用例管理', 'ONES 平台同步'),
|
||
]
|
||
add_table_with_header(doc, ['项目', '说明'], rows)
|
||
|
||
doc.add_heading('1.3 当前进度', level=2)
|
||
doc.add_paragraph('已调试完成的设备（不在本计划范围内）：')
|
||
rows = [
|
||
('Bot', '5', '卡片/控制/设置/场景/日志', '100%'),
|
||
('Camera (Pan/Tilt Plus 3K)', '6', '卡片/控制/全屏/事件/录像/设置', '100%'),
|
||
('AI Hub', '11', '设置/投屏/侦测/勿扰/存储/回放/AI事件/日报/功能页/连接/绑定', '86%'),
|
||
]
|
||
add_table_with_header(doc, ['设备', '脚本文件数', '覆盖模块', '通过率'], rows)
|
||
|
||
doc.add_heading('1.4 目标', level=2)
|
||
doc.add_paragraph('• P0 必测项：各单品添加 + 核心控制（双协议）准入闸门，来源 ONES 必测项-AI自动化')
|
||
doc.add_paragraph('• P1 单品探索：82 款单品主流程冒烟，覆盖广度')
|
||
doc.add_paragraph('• P2 全功能：全维度回归（card/control/setting/scene/logs），覆盖深度')
|
||
doc.add_paragraph('• P3 平台：账号/房间/消息/家庭分享/场景等平台功能')
|
||
doc.add_paragraph('• 按优先级 backlog 依次交付，各层有独立退出标准（不绑定固定周次）')
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 2. 设备清单 ========================
|
||
doc.add_heading('2. 待覆盖设备清单（82款）', level=1)
|
||
|
||
device_categories = {
|
||
'窗帘 (9款)': [
|
||
('Curtain Rod', '已有脚本', '调试适配'),
|
||
('Curtain Rod 2', '已有脚本', '调试适配'),
|
||
('Curtain U Rail', '已有脚本', '调试适配'),
|
||
('Curtain U Rail 2', '已有脚本', '调试适配'),
|
||
('Curtain U Rail 2.3', '复用模板', '新增配置'),
|
||
('Curtain 3 U Rail', '复用模板', '新增配置'),
|
||
('Curtain 3 Rod 2025', '复用模板', '新增配置'),
|
||
('Curtain 4 Urail', '复用模板', '新增配置'),
|
||
('Roller Shade', '复用模板', '新增配置'),
|
||
],
|
||
'锁 (12款)': [
|
||
('Lock (JP)', '已有脚本', '调试适配'),
|
||
('Lock (US)', '已有脚本', '调试适配'),
|
||
('Lock (EU)', '复用模板', '新增配置'),
|
||
('Lock Pro (EU)', '复用模板', '新增配置'),
|
||
('Lock Pro (US)', '复用模板', '新增配置'),
|
||
('Lock Lite', '复用模板', '新增配置'),
|
||
('Lock Ultra (JP)', '需新写', 'UI差异大'),
|
||
('Lock Ultra (US)', '需新写', 'UI差异大'),
|
||
('Lock Ultra (EU)', '需新写', 'UI差异大'),
|
||
('Lock Pro Matter Enabled', '复用模板', '新增配置'),
|
||
('US Vision Deadbolt Pro', '需新写', '全新UI'),
|
||
('US Vision Deadbolt', '需新写', '全新UI'),
|
||
],
|
||
'灯光 (10款)': [
|
||
('LED Strip Light 2', '已有脚本', '调试适配'),
|
||
('Strip Light 3', '已有脚本', '调试适配'),
|
||
('RGBICWW Strip Light', '复用模板', '新增配置'),
|
||
('RGBICWW Floor Lamp', '复用模板', '新增配置'),
|
||
('RGBIC Neon Rope Light', '复用模板', '新增配置'),
|
||
('RGBIC Wire Neon Rope Light', '复用模板', '新增配置'),
|
||
('RGBICWW Ceiling Light', '已有脚本', '调试适配'),
|
||
('Floor Lamp', '复用模板', '新增配置'),
|
||
('Candle Lamp', '复用模板', '新增配置'),
|
||
('Permanent Outdoor Lights', '需新写', '户外新品'),
|
||
],
|
||
'插座+开关 (6款)': [
|
||
('Plug Mini (JP) HomeKit Enabled', '已有脚本', '调试适配'),
|
||
('Plug Mini (US) HomeKit Enabled', '已有脚本', '调试适配'),
|
||
('Plug Mini (EU)', '复用模板', '新增配置'),
|
||
('Relay Switch 1', '已有脚本', '调试适配'),
|
||
('Relay Switch 1PM', '复用模板', '新增配置'),
|
||
('Relay Switch 2PM', '复用模板', '新增配置'),
|
||
],
|
||
'扫地机 (9款)': [
|
||
('Robot Vacuum Cleaner S1', '已有脚本', '调试适配'),
|
||
('Robot Vacuum Cleaner S1 Plus (W)', '已有脚本', '调试适配'),
|
||
('Mini Robot Vacuum K10+Pro', '复用模板', '新增配置'),
|
||
('Robot Vacuum K20+ Pro', '需新写', '新一代UI'),
|
||
('Robot Vacuum K10+ Pro Combo', '复用模板', '新增配置'),
|
||
('Robot Vacuum K11+', '需新写', '新一代UI'),
|
||
('Robot Vacuum K11+ Pro', '需新写', '新一代UI'),
|
||
('Floor Cleaning Robot S20', '需新写', '全新UI'),
|
||
('Floor Cleaning Robot S20 Mini', '需新写', '全新UI'),
|
||
],
|
||
'传感器+温控 (7款)': [
|
||
('Indoor/Outdoor Thermo-Hygrometer', '已有脚本', '调试适配'),
|
||
('Meter Pro', '已有脚本', '调试适配'),
|
||
('Meter Pro (CO2 Monitor)', '复用模板', '新增CO2功能'),
|
||
('Water Leak Detector with Sensor Cable', '已有脚本', '调试适配'),
|
||
('Presence Sensor', '需新写', '全新UI'),
|
||
('Home Climate Panel', '需新写', '全新UI'),
|
||
('Weather Station', '需新写', '全新UI'),
|
||
],
|
||
'风扇+空净+加湿器 (6款)': [
|
||
('Circulator Fan', '已有脚本', '调试适配'),
|
||
('Standing Circulator Fan', '复用模板', '新增配置'),
|
||
('Circulator Fan Pro', '复用模板', '新增配置'),
|
||
('Air Purifier', '需新写', '全新品类'),
|
||
('Air Purifier Table', '需新写', '全新品类'),
|
||
('Evaporative Humidifier (Auto-refill)', '已有脚本', '调试适配'),
|
||
],
|
||
'摄像头+门铃 (3款)': [
|
||
('Pan/Tilt Cam 3MP猫狗定制款', '复用camera', '调试适配'),
|
||
('Video Doorbell', '需新写', '门铃UI差异'),
|
||
('OSC KVS', '已有脚本', '调试适配'),
|
||
],
|
||
'网关Hub (3款)': [
|
||
('Hub 3', '已有脚本', '调试适配'),
|
||
('AI Hub', '已完成', '—'),
|
||
('AI Hub Show', '需新写', '带屏新品'),
|
||
],
|
||
'门控+安防+配件 (5款)': [
|
||
('Keypad Vision', '已有脚本', '调试适配'),
|
||
('Keypad Vision Pro', '复用模板', '新增配置'),
|
||
('Garage Door Opener', '需新写', '全新品类'),
|
||
('Safety Alarm', '需新写', '全新品类'),
|
||
('Smart Radiator Thermostat', '需新写', '全新品类'),
|
||
],
|
||
'AI产品 (5款)': [
|
||
('Art Frame', '需新写', '全新UI框架'),
|
||
('Art Frame luma', '需新写', '全新UI框架'),
|
||
('AI Pet', '需新写', '全新品类'),
|
||
('AI PinNote', '需新写', '全新品类'),
|
||
('Bot Rechargeable', '复用bot', '调试适配'),
|
||
],
|
||
'机器人+联名+其他 (8款)': [
|
||
('OBBOTO 1.0', '需新写', '全新品类'),
|
||
('Robotic Actuator', '需新写', '全新品类'),
|
||
('Robotic Arm', '需新写', '全新品类'),
|
||
('Robotic Picker', '需新写', '全新品类'),
|
||
('SwitchBot KATAフレンズ KUMAMON ver.', '复用bot', '特殊UI定制'),
|
||
('KATA Friends 国行版', '复用bot', '特殊UI定制'),
|
||
('Outdoor PTC', '需新写', '全新品类'),
|
||
('FindCard', '已有脚本', '调试适配'),
|
||
],
|
||
}
|
||
|
||
for cat_name, devices in device_categories.items():
|
||
doc.add_heading(cat_name, level=2)
|
||
add_table_with_header(doc,
|
||
['设备名称', '脚本状态', '备注'],
|
||
devices,
|
||
col_widths=[6, 3, 4]
|
||
)
|
||
doc.add_paragraph()
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 3. 测试维度说明 ========================
|
||
doc.add_heading('3. 测试维度说明', level=1)
|
||
|
||
doc.add_paragraph('每款设备根据功能复杂度，覆盖以下测试维度。人力预估基于 AI 辅助（Claude Code 边跑边写）：首台需建模分析，同品类复用台仅改配置，工时约减半或更低。')
|
||
|
||
rows = [
|
||
('card', '{device}_card.test.ts', '首页卡片展示与交互', '3-5', 'P1 / P2', '0.3 / 0.1'),
|
||
('control', '{device}_control.test.ts', '功能页核心操作（开关/模式/参数调节）', '8-20', 'P0 / P1 / P2', '1.0 / 0.3'),
|
||
('setting', '{device}_setting.test.ts', '设备设置页（名称/房间/固件/信息）', '5-8', 'P2', '0.5 / 0.2'),
|
||
('connect', '{device}_connect.test.ts', '设备添加/配对流程', '3-5', 'P0 / P2', '0.5 / 0.2'),
|
||
('scene', '{device}_scene.test.ts', '自动化/场景联动', '3-8', 'P3', '0.5 / 0.2'),
|
||
('logs', '{device}_logs.test.ts', '操作日志查看', '2-4', 'P2(可选)', '0.2 / 0.1'),
|
||
]
|
||
add_table_with_header(doc,
|
||
['维度', '文件命名', '内容', '用例数', '优先级层', 'AI预估(人日:首台/复用)'],
|
||
rows,
|
||
col_widths=[1.3, 3.8, 4.2, 1.2, 2, 3]
|
||
)
|
||
|
||
doc.add_paragraph()
|
||
doc.add_paragraph('用例数量估算：每设备平均 25-40 条，82款设备总计约 2000-3000 条自动化用例。')
|
||
doc.add_paragraph('AI 提效口径：单维度脚本首台 0.2-1 人日、复用台 0.1-0.3 人日；串口添加框架为一次性投入（见 §5.2）。下列各层人力预估均按此口径，单位为人日（1 人）。')
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 4. 测试优先级分层 ========================
|
||
doc.add_heading('4. 测试优先级分层', level=1)
|
||
doc.add_paragraph(
|
||
'本计划按优先级分四层推进，依次为：必测项 → 单品探索 → 全功能 → 平台。'
|
||
'高优先级层先达标再投入下一层；不绑定固定周次，按相对工作量排 backlog。'
|
||
)
|
||
|
||
rows = [
|
||
('P0 必测项', '各单品添加 + 核心控制（双协议）', 'ONES 必测项-AI自动化 (CQz9YCNX)', '187', '每次提测/版本必跑', '通过率≥95%'),
|
||
('P1 单品探索', '每单品主流程冒烟（card+核心control）', '按单品模板', '82款各1遍', '每迭代', '全单品冒烟通过'),
|
||
('P2 全功能', '全维度回归(card/control/setting/scene/logs)', '各品类用例库', '~2366', '版本回归', '通过率≥85%'),
|
||
('P3 平台', '账号/房间/消息/家庭分享/场景等平台功能', 'App平台用例库', '平台模块', '版本回归', '平台用例通过'),
|
||
]
|
||
add_table_with_header(doc,
|
||
['优先级', '范围', '来源', '用例量', '运行频率', '退出标准'],
|
||
rows,
|
||
col_widths=[2.2, 4, 3.5, 1.3, 2.5, 2.5]
|
||
)
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 5. P0 必测项 ========================
|
||
doc.add_heading('5. P0 必测项（最高优先）', level=1)
|
||
doc.add_paragraph(
|
||
'必测项是提测/版本更新的准入闸门，来源 ONES 测试计划「必测项-AI自动化」(plan CQz9YCNX / lib EPfZfC9Y)，'
|
||
'映射清单见 test-plan/must-test.manifest.ts，转换规则见 prompts/must_test_conversion.md。'
|
||
)
|
||
|
||
doc.add_heading('5.1 必测项构成', level=2)
|
||
rows = [
|
||
('添加 (connect)', '每单品型号一条「添加X验证」', '73', 'connect 维度，需串口配合'),
|
||
('单品功能 (feature)', '绑定手持/学习遥控器/keypad密码指纹/温湿度单位等', '9', 'control/setting 维度'),
|
||
('控制 (control)', '2条协议超级用例逐 step：BLE 49 + WiFi 56', '105', 'control 维度，双协议各跑一遍'),
|
||
]
|
||
add_table_with_header(doc, ['类型', '说明', '条数', '落点/备注'], rows)
|
||
doc.add_paragraph()
|
||
p = doc.add_paragraph()
|
||
p.add_run('合计：').bold = True
|
||
p.add_run('187 条（另 2 条 na：safety alarm 无目录、强绑定解绑归平台）。控制粒度在 step，按 (用例号#step)+协议精确回写 ONES。')
|
||
|
||
doc.add_heading('5.2 前置：设备添加自动化（关键路径，最先启动）', level=2)
|
||
doc.add_paragraph(
|
||
'必测含 73 条添加，添加流程需硬件配合（串口控制设备进入配对模式），分 BLE 直连与 Wi-Fi 配网两种模式。'
|
||
'此为 P0 第一阻塞项，须最先启动；控制部分（无需串口）可并行先行。'
|
||
)
|
||
rows = [
|
||
('串口命令协议文档', '统一所有设备“进入配对模式”的串口指令', '嵌入式+测试'),
|
||
('串口控制模块', 'serial_controller.ts (基于 serialport库)', '测试'),
|
||
('添加流程通用框架', 'connect_base_helper.ts', '测试'),
|
||
('Wi-Fi 配网模块', 'wifi_connect_helper.ts', '测试'),
|
||
('硬件环境', 'USB Hub + USB转TTL × 5-10', '测试'),
|
||
]
|
||
add_table_with_header(doc, ['任务', '输出', '负责'], rows)
|
||
doc.add_paragraph()
|
||
p = doc.add_paragraph()
|
||
p.add_run('框架一次性投入：').bold = True
|
||
p.add_run('serial_controller + connect_base_helper + wifi_connect_helper ≈ 1-1.5 人日纯代码（serial 基于现成桌面 serialport 工具薄封装、add 流程复用现有 addDeviceViaBLE，仅 wifi 配网 helper 需新写）。硬件联调（USB-TTL 接线/端口/时序）由嵌入式主导，为 wall-clock 不确定项，不计入纯人日。')
|
||
doc.add_paragraph(
|
||
'关键：添加流程 app 侧通用，逐设备差异仅为“开发版上进入配对模式的按键/串口指令”，由嵌入式提供的「设备→串口键」配置表驱动，逐设备近乎零编码。'
|
||
'app 侧只需按类别区分设置步骤（BLE 直连 / Wi-Fi 配网 / 带屏 / 锁含校准），约 4-5 类，而非 73 份脚本。'
|
||
)
|
||
|
||
doc.add_heading('5.3 添加 backlog（通用流程 + 配置表驱动）', level=2)
|
||
rows = [
|
||
('首验', 'BLE直连(Bot/Meter/Sensor) + Wi-Fi配网框架打通', '端到端 demo', '0.5'),
|
||
('BLE 直连类', '窗帘/传感器/风扇/遥控器/插座开关/灯 等', '设备→串口键配置 + 验证', '1'),
|
||
('Wi-Fi 配网类', 'Hub/摄像头/扫地机 等（额外配网步骤）', '配网流程 + 配置', '1.5'),
|
||
('带屏 / 锁类', 'AI Hub Show / Lock 系列（含校准）', '类别专属设置步骤', '1.5'),
|
||
]
|
||
add_table_with_header(doc, ['批次', '范围', '交付物', 'AI预估(人日)'], rows)
|
||
doc.add_paragraph('添加小计：约 4-6 人日（流程通用、按 4-5 类区分；逐设备仅配置串口键，成本主要在逐台硬件验证的 wall-clock，非人日）。')
|
||
|
||
doc.add_heading('5.4 控制 backlog（双协议，105 step）', level=2)
|
||
doc.add_paragraph('• 协议为运行模式：PROTO=ble（关WiFi/热点、开蓝牙）/ PROTO=wifi（开WiFi/热点、关蓝牙），各跑一遍。')
|
||
doc.add_paragraph('• camera/robot/osc 仅 WiFi；Bot/Lock/Curtain/Meter 等两协议都覆盖。')
|
||
doc.add_paragraph('• 控制内容含开关/开锁/百分比/meter温湿度校正/camera出流3min/robot清扫暂停回充/Humidifier2绑温湿度计。')
|
||
doc.add_paragraph('• 结果按 [ONES:号#step][协议] 锚点 step 级回写 plan CQz9YCNX。')
|
||
doc.add_paragraph('控制小计：约 3-4 人日（大部分品类已有 _control 用例 → P0 主要是给既有断言打 [P0][#step][协议] 锚点 + 双协议切换 harness ~1 人日 + 补少量缺口；双协议第二遍仅切前置、增量低）。')
|
||
doc.add_paragraph()
|
||
p = doc.add_paragraph()
|
||
p.add_run('P0 合计：').bold = True
|
||
p.add_run('约 11-15 人日（串口框架~1-1.5 + 添加 4-6 + 控制 3-4 + 功能9条~3 + step回写工具~0.5）。控制大部分品类已有 _control 用例可复用，主要是打锚点 + 双协议 harness；功能 9 条为 keypad 密码指纹/学习遥控/绑定手持等较复杂项；硬件联调由嵌入式主导，单列不计入。')
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 6. P1 单品探索 ========================
|
||
doc.add_heading('6. P1 单品探索（覆盖广度）', level=1)
|
||
doc.add_paragraph(
|
||
'必测项达标后，为全部 82 款单品各跑通一遍主流程冒烟，确保每款设备最低限度可用。'
|
||
'范围 = card（首页卡片）+ 核心 control（开关/主模式），不含设置/场景/日志等深度回归。'
|
||
)
|
||
doc.add_paragraph('• 目标：82 款单品各 1 套冒烟，广度优先、深度浅。')
|
||
doc.add_paragraph('• 复用必测项已建的 control helper，单品只补 card 与主流程断言。')
|
||
doc.add_paragraph('• 退出标准：每款单品冒烟用例通过（card 可见 + 核心控制响应）。')
|
||
doc.add_paragraph('• 运行频率：每迭代跑一遍，作为单品级回归基线。')
|
||
doc.add_paragraph('• 人力预估（AI 辅助）：约 12-16 人日（建立在 P0 已建 control helper 之上，82 款多为同品类复用，首台 ~0.3、复用台 ~0.1 人日/款）。')
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 7. P2 全功能 ========================
|
||
doc.add_heading('7. P2 全功能（深度回归）', level=1)
|
||
doc.add_paragraph(
|
||
'对每款单品做全维度回归（card/control/setting/scene/logs）。按品类批量推进：'
|
||
'同品类 UI 高度相似，调通首台后改设备名配置快速扩展，并沉淀通用 helper。'
|
||
'不绑定周次，按复用度从高到低排批次。'
|
||
)
|
||
|
||
rows = [
|
||
('批1·高复用', '窗帘9 / 锁12 / 插座开关6 / 灯光10', '37', '脚本×37 + curtain/lock/relay/light helper', '~25'),
|
||
('批2·中复杂', '扫地机9 / 传感器温控7 / 风扇空净加湿6 / 摄像头门铃3', '25', '脚本×25 + robot/sensor/climate helper', '~27'),
|
||
('批3·新品特殊', 'Hub门控安防5 / AI产品5 / 机器人联名5', '15+', '脚本×15 + 全新UI框架', '~28'),
|
||
]
|
||
add_table_with_header(doc,
|
||
['批次', '品类', '设备数', '交付物', 'AI预估(人日)'],
|
||
rows,
|
||
col_widths=[2.3, 5, 1.3, 5, 2.2]
|
||
)
|
||
|
||
doc.add_paragraph()
|
||
p = doc.add_paragraph()
|
||
p.add_run('覆盖目标：').bold = True
|
||
p.add_run('全部 82 款单品全维度回归，~2366 条用例，单品功能覆盖率 100%。')
|
||
p = doc.add_paragraph()
|
||
p.add_run('P2 合计：').bold = True
|
||
p.add_run('约 75-90 人日（仅 card/control/setting 约 60-70，含 scene/logs 约 75-90）。约 50 款为“已有/复用”可低成本适配；真正“需新写”的新品 UI 约 30 款（扫地机新机/Lock Ultra·Vision/AI产品/机器人）需 Figma/UX 重新分析，AI 辅助有限、为主要成本；add/control 已被 P0/P1 覆盖可复用。')
|
||
|
||
doc.add_heading('7.1 高复用品类要点', level=2)
|
||
doc.add_paragraph('• 窗帘: 位置控制、校准流程、定时器、群组控制 → curtain_helper')
|
||
doc.add_paragraph('• 锁: 密码管理、开锁方式切换、自动锁定、电量监控 → lock_helper')
|
||
doc.add_paragraph('• 插座开关: 开关、定时器、功率/电量统计、过载保护 → relay_helper')
|
||
doc.add_paragraph('• 灯光: RGB颜色、亮度、模式切换、渐变 → light_helper')
|
||
|
||
doc.add_heading('7.2 中复杂品类要点', level=2)
|
||
doc.add_paragraph('• 扫地机: 地图管理/禁区/多楼层、清扫模式、自清洁基站（地图画布操作为难点）')
|
||
doc.add_paragraph('• 传感器+温控: 温湿度展示、历史图表、告警、灵敏度（图表验证需截图/文本提取）')
|
||
doc.add_paragraph('• 风扇+空净+加湿: 风速/模式/摇头/定时、空气质量/滤网、湿度目标/水箱')
|
||
doc.add_paragraph('• 摄像头+门铃: 出流/录像/事件、门铃呼叫/访客/对讲、OSC 复用')
|
||
|
||
doc.add_heading('7.3 新品+特殊要点', level=2)
|
||
doc.add_paragraph('• Hub 3 / AI Hub Show: 设备管理、红外学习、Matter、带屏交互')
|
||
doc.add_paragraph('• 门控安防: Garage Door、Safety Alarm、Radiator Thermostat')
|
||
doc.add_paragraph('• AI产品: Art Frame、AI Pet、AI PinNote（全新UI，需从Figma/UX重新分析）')
|
||
doc.add_paragraph('• 机器人+联名: OBBOTO、Robotic Actuator/Arm/Picker、KATA Friends（Bot复用+定制皮肤）')
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 8. P3 平台 ========================
|
||
doc.add_heading('8. P3 平台功能', level=1)
|
||
doc.add_paragraph(
|
||
'单品三层达标后，覆盖跨单品的平台级功能（必测项中约 12 条平台项 + 平台用例库）。'
|
||
)
|
||
|
||
doc.add_heading('8.1 平台功能范围', level=2)
|
||
rows = [
|
||
('账号', '注册/登录/登出/忘记密码/第三方登录/欧区账号', '账号2.0'),
|
||
('家庭与房间', '创建房间、家庭分享3.0、家庭分组', '分享/分组用例库'),
|
||
('消息与商城', '消息中心3.0、商城、我的、小组件', '对应平台库'),
|
||
('其他', '覆盖安装、插件热更、第三方服务接入', 'App必测项平台模块'),
|
||
]
|
||
add_table_with_header(doc, ['模块', '内容', '来源'], rows)
|
||
|
||
doc.add_heading('8.2 自动化/场景联动', level=2)
|
||
doc.add_paragraph('验证设备间联动可靠性（复用已有 automation 脚本基础）：')
|
||
doc.add_paragraph('• 创建自动化：手动/条件触发/定时触发')
|
||
doc.add_paragraph('• 执行验证：触发条件满足后动作执行')
|
||
doc.add_paragraph('• 编辑/删除：修改条件或动作、删除自动化')
|
||
doc.add_paragraph('• 多设备联动：A设备触发 → B设备执行')
|
||
doc.add_paragraph('• 异常处理：设备离线时的自动化表现')
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 8. 资源需求 ========================
|
||
doc.add_heading('9. 资源需求汇总', level=1)
|
||
|
||
doc.add_heading('9.1 人力与分工', level=2)
|
||
rows = [
|
||
('自动化测试工程师', '1人', '全职、全程，承担全部脚本编写与调试'),
|
||
('嵌入式工程师（配合）', '按需', '提供串口协议与配对框架支持（P0 添加阻塞项），最优先'),
|
||
('AI辅助 (Claude Code)', '—', '边跑边写生成+调试脚本，贯穿全程提效'),
|
||
]
|
||
add_table_with_header(doc, ['角色', '人数', '说明'], rows)
|
||
|
||
doc.add_paragraph()
|
||
doc.add_paragraph(
|
||
'人力安排：仅 1 名自动化工程师，四层按优先级串行推进，AI 辅助提效。'
|
||
'P0 内部拆两条轨——「控制轨」不依赖串口可先行，「添加轨」待嵌入式串口框架就绪后插入，两轨由同一人分时推进。'
|
||
)
|
||
rows = [
|
||
('P0 · 控制轨', '自动化(1人)', '—', '先行：双协议控制 105 step，不待串口'),
|
||
('P0 · 添加轨', '自动化(1人)', '嵌入式(串口协议+框架)', '串口就绪后插入：73 添加 + 9 功能'),
|
||
('P1 单品探索', '自动化(1人)', '—', 'P0 达标后：82 款冒烟'),
|
||
('P2 全功能', '自动化(1人)', '—', '按品类批量，复用 helper'),
|
||
('P3 平台', '自动化(1人)', '—', '最后：平台功能 + 场景联动'),
|
||
]
|
||
add_table_with_header(doc,
|
||
['优先级层', '主负责', '配合', '安排说明'],
|
||
rows,
|
||
col_widths=[2.5, 2.5, 3.5, 6]
|
||
)
|
||
|
||
doc.add_heading('9.2 硬件设备', level=2)
|
||
doc.add_paragraph('每品类至少需要1台实体设备用于调试和验证：')
|
||
rows = [
|
||
('P0 串口硬件', 'USB Hub + USB转TTL×5-10、开发版设备', '最先到位（添加为关键路径）'),
|
||
('P0/P1 必测+冒烟', '必测涉及的各品类代表设备各1台', '随 P0 启动'),
|
||
('P2 高复用', '窗帘×1, 锁×2, 插座×1, 开关×1, 灯×3', '全功能批1前到位'),
|
||
('P2 中复杂', '扫地机×2, 传感器×3, 风扇×1, 空净×1, 加湿器×1, 门铃×1', '全功能批2前到位'),
|
||
('P2 新品特殊', 'Hub 3, AI Hub Show, Art Frame, AI Pet等', '全功能批3前到位'),
|
||
]
|
||
add_table_with_header(doc, ['用途', '设备需求', '到位时间'], rows)
|
||
|
||
doc.add_heading('9.3 环境', level=2)
|
||
rows = [
|
||
('测试手机', 'Samsung (Android) + iPhone (iOS)', '已有'),
|
||
('Appium Server', 'v2.x + UIAutomator2', '已有'),
|
||
('网络环境', '稳定Wi-Fi (Deco)', '已有'),
|
||
('CI/CD', 'Jenkins/GitHub Actions (可选)', '待搭建'),
|
||
]
|
||
add_table_with_header(doc, ['项目', '说明', '状态'], rows)
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 10. 优先级 backlog 一览 ========================
|
||
doc.add_heading('10. 优先级 backlog 一览', level=1)
|
||
|
||
rows = [
|
||
('P0 必测项', '添加73 + 功能9 + 控制105step(双协议)', '187条', '~11-15', 'serial框架 + connect + 控制断言 + step回写', '通过率≥95%'),
|
||
('P1 单品探索', '82款单品主流程冒烟(card+核心control)', '82款×1', '~12-16', '每单品冒烟用例', '全单品冒烟通过'),
|
||
('P2 全功能', '全维度回归，按品类批量(高复用→新品)', '~2366条', '~75-90', '85+脚本 + 8个通用helper', '通过率≥85%、覆盖100%'),
|
||
('P3 平台', '账号/房间/消息/家庭分享/场景等', '平台模块', '~12-15', '平台用例 + 场景联动', '平台用例通过'),
|
||
]
|
||
add_table_with_header(doc,
|
||
['优先级', '范围', '用例量', 'AI预估(人日)', '交付物', '退出标准'],
|
||
rows,
|
||
col_widths=[2, 4.3, 1.5, 2, 4.2, 2.5]
|
||
)
|
||
|
||
doc.add_paragraph()
|
||
p = doc.add_paragraph()
|
||
p.add_run('人力总计（AI 辅助口径）：').bold = True
|
||
p.add_run('约 105-135 人日 ≈ 5-7 人月（1 人，按 20 人日/月）。P0 大幅复用既有 control、串口硬件联调由嵌入式主导不计入；P2 “需新写”新品 UI 占比最高、最不可压缩。')
|
||
|
||
doc.add_paragraph(
|
||
'人力构成说明：以上为 AI 辅助口径（较手工已下调约 2-3 倍）。其中“脚本编写”仅占约 1/3——AI 提效主要在此；'
|
||
'其余约 2/3 是真机调试（元素核对、加载等待、flaky 复跑）、设备/硬件配置与新品 UI 分析，受真机往返与 UI 稳定性约束，AI 难以进一步压缩。'
|
||
'项目使用 Midscene（AI 元素定位）已减少传统选择器维护成本，故未再按“零调试”乐观值估算。'
|
||
'若需再压缩周期，杠杆在于：多台真机并行、收窄 P2 范围（只保高频设备）、放宽 flaky 容忍度，而非提高编写速度。'
|
||
)
|
||
|
||
doc.add_paragraph()
|
||
p = doc.add_paragraph()
|
||
p.add_run('说明：').bold = True
|
||
p.add_run('按优先级依次交付，高层达标后投入下一层；不绑定固定周次。P0 控制部分可不待串口先行，添加随串口框架就绪推进。')
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 10. 质量标准 ========================
|
||
doc.add_heading('11. 质量标准与验收', level=1)
|
||
|
||
doc.add_heading('11.1 单设备验收标准', level=2)
|
||
doc.add_paragraph('• 核心用例通过率 ≥ 85%（首轮调试）')
|
||
doc.add_paragraph('• 单次全量执行时间 < 10分钟/设备')
|
||
doc.add_paragraph('• 用例覆盖：card + control + setting 三个维度必须覆盖')
|
||
doc.add_paragraph('• 脚本可在 Android/iOS 双平台运行（通过平台适配层）')
|
||
|
||
doc.add_heading('11.2 优先级层验收标准', level=2)
|
||
rows = [
|
||
('P0 必测项', '187条全部实现并跑通（添加+控制双协议）', '通过率≥95%，作为提测门禁'),
|
||
('P1 单品探索', '82款单品冒烟全部通过', '广度100%覆盖'),
|
||
('P2 全功能', '全维度回归，通过率≥85%', '单品功能覆盖率100%'),
|
||
('P3 平台', '平台功能 + 场景联动通过', '全流程覆盖'),
|
||
]
|
||
add_table_with_header(doc, ['优先级', '验收标准', '覆盖目标'], rows)
|
||
|
||
doc.add_heading('11.3 回归策略', level=2)
|
||
doc.add_paragraph('• P0 必测项：每次提测/版本更新必跑（双协议），作为准入门禁')
|
||
doc.add_paragraph('• P1 单品探索：每迭代执行一遍全单品冒烟')
|
||
doc.add_paragraph('• P2 全功能：版本回归执行累计设备全量')
|
||
doc.add_paragraph('• P3 平台：版本回归执行平台功能与场景联动')
|
||
|
||
doc.add_page_break()
|
||
|
||
# ======================== 11. 风险与依赖 ========================
|
||
doc.add_heading('12. 风险与依赖', level=1)
|
||
|
||
doc.add_heading('12.1 关键依赖', level=2)
|
||
rows = [
|
||
('串口/添加为关键路径(前移)', '高', '硬件或协议不就绪将阻塞 P0 整体', '控制部分(无需串口)先行，串口框架并行启动'),
|
||
('实体设备到位', '高', '无设备无法调试', 'P0 涉及的代表设备最先准备'),
|
||
('嵌入式串口协议', '高', '直接影响 P0 添加', '最优先启动协议定义'),
|
||
('同品类UI一致性', '中', 'UI差异大则无法复用', '差异设备单独排期'),
|
||
('新品UI稳定', '高', 'UI仍在迭代会导致返工', '等UI冻结后再开始(主要影响P2新品)'),
|
||
('App版本稳定', '中', '频繁改版影响脚本维护', '锁定测试版本'),
|
||
]
|
||
add_table_with_header(doc, ['依赖项', '风险等级', '影响', '缓解措施'], rows)
|
||
|
||
doc.add_heading('12.2 待讨论问题', level=2)
|
||
doc.add_paragraph('1. 设备添加的串口开发版/协议时间线？（决定 P0 添加何时能启动）')
|
||
doc.add_paragraph('2. 必测项控制双协议环境切换（开关WiFi/蓝牙）能否用 adb/串口自动化，还是需人工配合？')
|
||
doc.add_paragraph('3. 已下市产品（Hub Plus、老灯带、加湿器1等）是否纳入 P2 全功能？')
|
||
doc.add_paragraph('4. 同一设备的不同区域版本（JP/US/EU）UI差异程度？是否需逐个调试？')
|
||
doc.add_paragraph('5. CI/CD 持续集成环境是否需要在 P0 之前搭建？')
|
||
|
||
# ======================== 保存 ========================
|
||
output_path = '/Users/woan/Desktop/AI_UIAutomation/docs/UI自动化测试计划.docx'
|
||
doc.save(output_path)
|
||
print(f'✓ 文档已生成: {output_path}')
|