🎚️ Q•Ai-GenAI自动化和质量编排
Q•艾是一个现代化的，生产准备就绪 QA编排工具包 （QA驾驶舱🎛️) 旨在为团队提供一个单一、清晰的质量工作流程视图和控制点。
它结合了：
- 剧作家 （用户界面、API和视觉测试）
- 诱惑报告 （丰富、可追溯的结果）
- 通过MCP的AI代理 （运行、调试、生成测试）
- GitHub CI/CD （每次推送和公关都实现自动化）
- Slack通知 （快速反馈回路）
- 结构清晰，依赖性最小，团队准备就绪
Q•Ai超越了测试执行——它充当了一个 QA驾驶舱 在这里，执行、报告、诊断和人工智能辅助的工作流程结合在一起。
______________________________________________________________________
🎛️ 什么是QA驾驶舱？
QA驾驶舱是质量的中央控制层：
- 协调测试执行 （UI、API、可视化、性能）
- 汇总结果 纳入单一健康观
- 启用人工智能辅助的工作流程 （调查、生成、分类）
- 连接CI、报告和通信渠道
Q•Ai提供的不是分散的工具 一个面向工作流的入口点 质量。
______________________________________________________________________
🚀 特性
✔ UI、API和可视化测试
以Playwright为基础，具有干净的固定装置和可扩展的结构。
✔ 诱惑报告
包含屏幕截图、跟踪、步骤和附件的丰富报告。
✔ 人工智能辅助QA工作流程（通过MCP）
AI代理可以：
- 运行测试
- 调试失败
- 生成新测试
- 发送API请求
- 检查响应
- 分析不稳定或不稳定的行为
✔ CI/CD编排（GitHub操作）
- 在推送和PR上自动运行
- 将报告作为工件上传
- 与Slack集成，实现快速反馈
✔ Slack集成
CI职位：
- 成功/失败
- 回购人名称
- 跑步链接
- 高级状态摘要
只需添加 SLACK_WEBHOOK_URL 作为GitHub的秘密。______________________________________________________________________
🏁 快速开始
npm install
npm test
npm run allure:generate
npm run allure:open
npm run mcp:dev______________________________________________________________________
📄 页面对象模型（POM）
Q•Ai遵循页面对象模型，以保持测试的可读性、可维护性和可扩展性。
helpers/
pages/
login.page.ts
dashboard.page.ts
common.page.ts例子： helpers/pages/login.page.ts
import { Page } from '@playwright/test';
export class LoginPage {
readonly page: Page;
readonly emailInput = '#email';
readonly passwordInput = '#password';
readonly loginButton = 'button[type="submit"]';
constructor(page: Page) {
this.page = page;
}
async goto() {
await this.page.goto('/login');
}
async login(email: string, password: string) {
await this.page.fill(this.emailInput, email);
await this.page.fill(this.passwordInput, password);
await this.page.click(this.loginButton);
}
}______________________________________________________________________
🔐 身份验证、2FA和存储状态（最佳实践）
许多应用程序使用第三方身份提供者和MFA（2FA）。
推荐方法： 验证一次并重用剧作家的 storageState.
为什么这是最佳实践：
- 尊重身份提供者安全
- 避免脆弱的MFA自动化
- 保持CI稳定快速
- 符合剧作家的官方指导
/**
* 2FA is intentionally not automated.
* Authenticate once and reuse storage state.
*/______________________________________________________________________
🔫 API性能和载荷测试（炮兵）
UI测试验证行为。 负载测试验证了弹性。
Q•艾集成 炮兵 作为QA工作流程的一部分，在负载下测试API。
示例用例：
- 在发布前验证API的稳定性
- 捕捉性能回归
- 补充功能UI覆盖范围
______________________________________________________________________
🤖 人工智能辅助质量保证工作流程（MCP）
npm run mcp:dev运行后，AI助手可以访问：
- 剧作家
- API工具
- 测试结果
- 执行上下文
你可以问AI助手：
- “运行测试并总结失败”
- “为登录端点生成新测试”
- “检查此失败的跟踪并解释原因”
- “这间套房里什么东西看起来很古怪？”
此设置是 模型不可知 并与托管的LLM、本地模型或未来的代理运行时配合使用。
______________________________________________________________________
📊 报告和可见性（吸引力）
npm run allure:generate
npm run allure:open报告包括：
- 截图
- 痕迹
- 步骤
- 附件
- 通过/失败矩阵
所有结果都输入到 QA驾驶舱视图 以便快速检查。
______________________________________________________________________
🔬 交互式原型（QA驾驶舱UI）
Q•Ai QA驾驶舱的交互式UI原型可在此处获得：
原型展示了：
- 项目健康状况概述和关键绩效指标
- 测试执行状态和通过率
- 台阶级测试可见性
- QA驾驶舱布局和导航概念
该原型旨在：
- 传达用户体验和工作流程的想法
- 与利益相关者在编排概念上保持一致
- 探索测试结果如何跨级别（项目）显示→ test → step)
它是一个 设计与交互原型，而不是生产部署。
______________________________________________________________________
🔧 CI/CD编排
自动运行于：
- 推到main
- 拉取请求
管道
- 安装依赖项
- 运行测试
- 上传报告
- 通知Slack
______________________________________________________________________
🔒 秘密和配置
必需的GitHub机密
SLACK_WEBHOOK_URLTEST_EMAIL,TEST_PASSWORD
永不承诺
playwright/.auth/user.json.env文件- API密钥或令牌
______________________________________________________________________
✅ QA编排最佳实践
- ✔ 中央QA驾驶舱，而不是分散的工具
- ✔ UI、API和负载测试的清晰分离
- ✔ 经过身份验证的流的存储状态
- ✔ 2FA处理一次，不自动
- ✔ 用于执行、分类和生成的AI代理
- ✔ CI优先，反馈驱动的工作流程
- ✔ 为团队和经理提供清晰的报告
______________________________________________________________________
☕ 支持项目
如果你觉得Q•Ai有用或鼓舞人心，你可以支持它的持续发展：
给我买杯咖啡
您的支持有助于资助：
- 原型和设计探索
- 开源维护
- 未来QA编排和GenAI实验
感谢您的支持💛
______________________________________________________________________
由Vlad Babayan设计
______________________________________________________________________
🪪 许可证
麻省理工学院
Q•Ai - GenAI Automation & Quality Orchestration