playwright-ia-automation-framework-saucedemo は何をしますか？
Jiraチケットがレビュー済みのPlaywrightプルリクエストになり、TCMSにミラーリングされるエンドツーエンドテストフレームワークです。AIエージェントが執筆し、決定論的CIでゲートされます。saucedemo上に構築されており、再利用可能なテンプレート兼ポートフォリオ作品として機能します。
概要
このフレームワークは、以下の自動化ワークフローを提供します：
- Jira統合: チケットがテスト要件を駆動します
- AIエージェントによるテスト作成: Playwrightテストコードを自動生成します
- 人間のレビュー: プルリクエストはマージ前にレビューされます
- 決定論的CI: 再現可能なテスト実行環境を保証します
- TCMSミラーリング: テストケースがテスト管理システムと同期されます
前提条件
- Node.js 18+
- npm または yarn
- Playwright
- Jiraアカウント（オプション、統合時）
- TCMSアクセス（オプション、ミラーリング時）
クイックスタート
# リポジトリをクローン
git clone https://github.com/Diegocortes15/playwright-ia-automation-framework-saucedemo.git
cd playwright-ia-automation-framework-saucedemo
# 依存関係をインストール
npm install
# Playwrightブラウザをインストール
npx playwright install
# テストを実行
npx playwright test
環境変数
| 変数名 | 説明 | 必須 |
|---|---|---|
JIRA_BASE_URL | JiraインスタンスのベースURL | いいえ |
JIRA_API_TOKEN | Jira APIトークン | いいえ |
TCMS_API_URL | TCMS APIエンドポイント | いいえ |
TCMS_API_KEY | TCMS APIキー | いいえ |
GITHUB_TOKEN | GitHub personal access token | いいえ |
使用方法
AIエージェントによるテスト生成
# Jiraチケットからテストを生成
npx playwright generate --from-jira TICKET-123
# 既存のテストを更新
npx playwright update --test-path tests/example.spec.ts
CI/CD統合
このフレームワークはGitHub Actionsと互換性があります。サンプルワークフローは .github/workflows/playwright.yml にあります。
プロジェクト構造
.
├── tests/ # テストファイル
│ ├── example.spec.ts # サンプルテスト
│ └── ...
├── .github/workflows/ # CI設定
│ └── playwright.yml # Playwright CIワークフロー
├── playwright.config.ts # Playwright設定
├── package.json # 依存関係
└── README.md # このファイル
貢献
プルリクエストは歓迎します。大きな変更の場合は、まずIssueを開いて変更内容を議論してください。