ViktorVakareev/Playwright-DotNet-Enterprise-Architecture
GitHub: ViktorVakareev/Playwright-DotNet-Enterprise-Architecture
基于 .NET 10、NUnit 和 Playwright 构建的企业级测试自动化框架，融合零信任安全、合成数据生成和离线 AI 故障诊断，专为高合规金融场景设计。
Stars: 0 | Forks: 0
# World Bank：企业级 Playwright 自动化框架
## 概述
本仓库包含一个基于 **.NET 10**、**NUnit** 和 **Playwright** 构建的专家级、生产级测试自动化框架。它遵循严格的 DevSecOps 原则、零信任安全架构以及 AI 辅助的故障分类，旨在满足像 World Bank 这样的金融机构的严格合规标准。
## 🏗️ 架构决策（“为什么这样做”）
### 1. 选择 Playwright 而非 Selenium
* **原因：** Playwright 提供了开箱即用的自动等待、网络拦截和隔离的浏览器上下文。我们严格使用 **Locator API**（`GetByRole`、`GetByLabel`）和 **Web-First Assertions**，从而消除了对不稳定的 `WebDriverWait` 循环或自定义同步逻辑的需求。
### 2. 零信任机密管理
* **原因：** 将凭证硬编码或将其提交到源代码管理中是一个严重的安全漏洞。
* **实现：** 我们在本地开发期间使用 `.NET User Secrets`，使密码和 API token 完全脱离代码仓库。在 CI/CD 流水线中，这些配置会直接映射到 Azure Key Vault 或 GitHub Secrets。
### 3. 通过合成数据生成实现数据主权
* **原因：** 使用真实的生产数据（PII）进行测试违反了监管合规要求（GDPR、KYC 法律）。静态测试数据库会导致测试冲突和不稳定。
* **实现：** 我们在 `BankingDataFactory.cs` 中使用 `Bogus` 库，在运行时动态生成高度逼真且关系准确的银行业务数据（IBAN、SWIFT codes、SSN）。测试是非确定性的，且不会留下数据残留。
### 4. 供应链完整性
* **原因：** 盲目拉取 NuGet 包会使框架面临供应链攻击的风险。
* **实现：** 通过 `NuGet.Config` 文件限制包来源，模拟企业内部的 JFrog Artifactory 网关。
## 🚀 入门指南
### 前置条件
1. **Visual Studio 2026**（或 Rider）以及 .NET 10 SDK。
2. 本地安装 **Ollama**（用于 AI 分类诊断）。
3. **PowerShell**（用于安装 Playwright 二进制文件）。
### 安装设置
1. **克隆仓库：**
git clone [https://github.com/yourusername/WorldBank.Automation.git](https://github.com/yourusername/WorldBank.Automation.git)
安装 Playwright 浏览器：
在 Visual Studio 中打开 Developer PowerShell 并运行：
PowerShell
pwsh bin/Debug/net10.0/playwright.ps1 install
3. **设置 User Secrets：**
右键点击 `WorldBank.Automation.Tests` 项目 -> **Manage User Secrets**。添加您的配置：
{
"TargetEnv": {
"Url": "[https://sandbox.worldbank.internal](https://sandbox.worldbank.internal)"
}
}
启动本地 AI：
确保 Ollama 在后台运行您的 Llama 3 模型：
Bash
ollama run llama3
### 项目结构
* `Infrastructure/` - 全局设置、AI 集成和 HTTP 客户端。
* `Data/` - 用于生成合成银行业务数据的 Bogus 工厂。
* `Pages/` - 基于组件的 Page Objects。
* `Tests/` - NUnit 测试执行套件。
标签：AI合规, AI辅助分析, AI风险缓解, Azure Key Vault, Bogus, DevSecOps, DNS 反向解析, E2E测试, GDPR, JFrog Artifactory, LLM评估, .NET 10, NUnit, Ollama, Playwright, pocsuite3, StruQ, UI自动化, Visual Studio, Web自动化, 上游代理, 企业级框架, 合规性测试, 数据主权, 测试数据生成, 特征检测, 软件测试, 金融科技, 隔离环境大模型, 零信任架构