ykq-playwright-ci 0.1.0

package/cases/doctor-pc/prescription/submit-failure-keeps-drugs.spec.ts

@@ -0,0 +1,10 @@
+import { test } from '../../../src/fixtures/doctor.fixture';
+
+test.describe('prescription high-risk placeholders', () => {
+  test('PW-RX-004 @p0 @rx-high @mocked submit failure keeps selected drugs', async () => {
+    test.skip(
+      true,
+      'Blocked until prescription test data and stable selectors are confirmed. See docs/test-data.md.'
+    );
+  });
+});

package/cases/doctor-pc/smoke/authenticated-home.spec.ts

@@ -0,0 +1,28 @@
+import { test, expect } from '../../../src/fixtures/base.fixture';
+import { createDoctorAuthContext, hasDoctorAuthState } from '../../../src/fixtures/auth.fixture';
+import { HomePage } from '../../../src/pages/doctor-pc/home.page';
+import { annotateCase } from '../../../src/utils/evidence';
+import { hasDoctorBaseURL } from '../../../src/utils/env';
+
+test.skip(!hasDoctorBaseURL(), 'DOCTOR_BASE_URL is required for deployed smoke tests.');
+
+test('PW-SMK-002 @smoke authenticated doctor home loads', async ({ browser }, testInfo) => {
+  test.skip(!hasDoctorAuthState(), 'Doctor storageState is missing; see docs/auth-runbook.md.');
+
+  annotateCase(testInfo, {
+    caseId: 'PW-SMK-002',
+    evidenceId: 'SMOKE-authenticated-home',
+    priority: 'Smoke'
+  });
+
+  const context = await createDoctorAuthContext(browser);
+  try {
+    const page = await context.newPage();
+    const homePage = new HomePage(page);
+    await homePage.goto();
+    await homePage.assertLoaded();
+    await expect(page.locator('body')).toBeVisible();
+  } finally {
+    await context.close();
+  }
+});

package/cases/doctor-pc/smoke/login-page.spec.ts

@@ -0,0 +1,21 @@
+import { test, expect } from '../../../src/fixtures/doctor.fixture';
+import { annotateCase } from '../../../src/utils/evidence';
+import { hasDoctorBaseURL } from '../../../src/utils/env';
+
+test.skip(!hasDoctorBaseURL(), 'DOCTOR_BASE_URL is required for deployed smoke tests.');
+
+test('PW-SMK-001 @smoke login page renders without blank screen', async (
+  { loginPage },
+  testInfo
+) => {
+  annotateCase(testInfo, {
+    caseId: 'PW-SMK-001',
+    sourceId: 'SMK-01',
+    evidenceId: 'SMOKE-login-page-render',
+    priority: 'Smoke'
+  });
+
+  await loginPage.goto();
+  await loginPage.assertLoaded();
+  await expect(testInfo.status).toBe(testInfo.expectedStatus);
+});

package/cases/doctor-pc/smoke/prescription-tab.spec.ts

@@ -0,0 +1,30 @@
+import { test, expect } from '../../../src/fixtures/base.fixture';
+import { createDoctorAuthContext, hasDoctorAuthState } from '../../../src/fixtures/auth.fixture';
+import { HomePage } from '../../../src/pages/doctor-pc/home.page';
+import { PrescriptionPage } from '../../../src/pages/doctor-pc/prescription.page';
+import { annotateCase } from '../../../src/utils/evidence';
+import { hasDoctorBaseURL } from '../../../src/utils/env';
+
+test.skip(!hasDoctorBaseURL(), 'DOCTOR_BASE_URL is required for deployed smoke tests.');
+
+test('PW-SMK-003 @smoke prescription tab can open', async ({ browser }, testInfo) => {
+  test.skip(!hasDoctorAuthState(), 'Doctor storageState is missing; see docs/auth-runbook.md.');
+
+  annotateCase(testInfo, {
+    caseId: 'PW-SMK-003',
+    evidenceId: 'SMOKE-prescription-tab-open',
+    priority: 'Smoke'
+  });
+
+  const context = await createDoctorAuthContext(browser);
+  try {
+    const page = await context.newPage();
+    const homePage = new HomePage(page);
+    await homePage.goto();
+    await homePage.openPrescriptionTab();
+    await new PrescriptionPage(page).assertVisible();
+    await expect(page.locator('body')).toBeVisible();
+  } finally {
+    await context.close();
+  }
+});

package/cases/doctor-pc/test-env/doctor-master-basic.spec.ts

@@ -0,0 +1,89 @@
+import { test, expect } from '../../../src/fixtures/base.fixture';
+import { annotateCase } from '../../../src/utils/evidence';
+import { appEnv, doctorURL, hasDoctorBaseURL } from '../../../src/utils/env';
+
+async function gotoDoctor(path: string, page: import('@playwright/test').Page): Promise<void> {
+  await page.goto(doctorURL(path), { waitUntil: 'domcontentloaded' });
+}
+
+test.describe('doctor-master test environment basics', () => {
+  test.beforeEach(async () => {
+    test.skip(!hasDoctorBaseURL(), 'DOCTOR_BASE_URL is required for doctor-master test environment tests.');
+  });
+
+  test('PW-TEST-001 @smoke login page renders required login controls', async ({ page }, testInfo) => {
+    annotateCase(testInfo, {
+      caseId: 'PW-TEST-001',
+      evidenceId: 'TEST-login-page-render',
+      priority: 'Smoke'
+    });
+
+    await gotoDoctor(appEnv.doctorLoginPath, page);
+
+    await expect(page).toHaveTitle('荷叶医生');
+    await expect(page.getByRole('heading', { name: '荷叶医生' })).toBeVisible();
+    await expect(page.getByPlaceholder('手机号')).toBeVisible();
+    await expect(page.getByPlaceholder('图形验证码')).toBeVisible();
+    await expect(page.getByPlaceholder('验证码', { exact: true })).toBeVisible();
+    await expect(page.locator('.verify-img')).toBeVisible();
+    await expect(page.getByText('发送验证码')).toBeVisible();
+    await expect(page.getByText('我已阅读并同意')).toBeVisible();
+    await expect(page.getByText('《荷叶健康用户服务协议》')).toBeVisible();
+    await expect(page.locator('.submit-btn', { hasText: '登录' })).toHaveClass(/gruyBtn/);
+  });
+
+  test('PW-TEST-002 @smoke unauthenticated home redirects to login by route guard', async ({
+    page
+  }, testInfo) => {
+    annotateCase(testInfo, {
+      caseId: 'PW-TEST-002',
+      evidenceId: 'TEST-home-redirect-login',
+      priority: 'Smoke'
+    });
+
+    await gotoDoctor(`${appEnv.doctorPublicPath}home`, page);
+
+    await expect(page).toHaveURL(/\/physician-admin\/login(?:\?|#|$)/);
+    await expect(page.getByRole('heading', { name: '荷叶医生' })).toBeVisible();
+  });
+
+  test('PW-TEST-003 @smoke service agreement is public by whitelist', async ({ page }, testInfo) => {
+    annotateCase(testInfo, {
+      caseId: 'PW-TEST-003',
+      evidenceId: 'TEST-service-agreement-render',
+      priority: 'Smoke'
+    });
+
+    await gotoDoctor(`${appEnv.doctorPublicPath}serviceAgreement`, page);
+
+    await expect(page).toHaveURL(/\/physician-admin\/serviceAgreement(?:\?|#|$)/);
+    await expect(page.locator('body')).toContainText('荷叶健康用户服务协议');
+  });
+
+  test('PW-TEST-004 @smoke login validation follows doctor-master form rules', async ({
+    page
+  }, testInfo) => {
+    annotateCase(testInfo, {
+      caseId: 'PW-TEST-004',
+      evidenceId: 'TEST-login-validation',
+      priority: 'Smoke'
+    });
+
+    await gotoDoctor(appEnv.doctorLoginPath, page);
+
+    await page.locator('.submit-btn', { hasText: '登录' }).click();
+    await expect(page.getByText('手机号输入不能为空')).toBeVisible();
+    await expect(page.getByText('图形验证码不能为空')).toBeVisible();
+    await expect(page.getByText('验证码不能为空', { exact: true })).toBeVisible();
+
+    await page.getByPlaceholder('手机号').fill('12345');
+    await page.getByPlaceholder('图形验证码').fill('abcd');
+    await page.getByPlaceholder('验证码', { exact: true }).fill('123456');
+    await page.locator('.submit-btn', { hasText: '登录' }).click();
+    await expect(page.getByText('请输入正确的手机号')).toBeVisible();
+
+    await page.getByPlaceholder('手机号').fill('13800138000');
+    await page.locator('.submit-btn', { hasText: '登录' }).click();
+    await expect(page.getByText('请阅读并勾选《荷叶健康用户服务协议》')).toBeVisible();
+  });
+});

package/ci/github-actions/playwright.yml

@@ -0,0 +1,61 @@
+name: playwright
+
+on:
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      suite:
+        description: "Suite to run: smoke, p0, or release"
+        default: "smoke"
+  schedule:
+    - cron: "0 18 * * *"
+
+jobs:
+  playwright:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    env:
+      DOCTOR_BASE_URL: ${{ secrets.DOCTOR_BASE_URL }}
+      DOCTOR_USERNAME: ${{ secrets.DOCTOR_USERNAME }}
+      DOCTOR_PASSWORD: ${{ secrets.DOCTOR_PASSWORD }}
+      TEST_ENV: test
+      BUILD_SHA: ${{ github.sha }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+
+      - run: npm ci
+
+      - run: npx playwright install --with-deps chromium
+
+      - name: Check target URL
+        run: |
+          if [ -z "$DOCTOR_BASE_URL" ]; then
+            echo "DOCTOR_BASE_URL is required in CI."
+            exit 1
+          fi
+
+      - name: Generate auth state
+        if: ${{ env.DOCTOR_USERNAME != '' && env.DOCTOR_PASSWORD != '' }}
+        run: npm run auth:doctor
+
+      - name: Run selected suite
+        run: |
+          case "${{ github.event.inputs.suite || 'smoke' }}" in
+            p0) npm run test:p0 ;;
+            release) npm run test:release ;;
+            *) npm run test:smoke ;;
+          esac
+
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-artifacts
+          path: |
+            playwright-report/
+            test-results/
+          if-no-files-found: ignore

package/docs/auth-runbook.md

@@ -0,0 +1,44 @@
+# 登录态说明
+
+## 自动生成
+
+配置 `.env`：
+
+```bash
+DOCTOR_BASE_URL=https://your-test-doctor-pc.example.com
+DOCTOR_USERNAME=doctor-account
+DOCTOR_PASSWORD=doctor-password
+DOCTOR_OTP=optional-otp
+```
+
+运行：
+
+```bash
+npm run auth:doctor
+```
+
+成功后会生成：
+
+```text
+playwright/.auth/doctor.json
+```
+
+该文件包含登录态，已被 `.gitignore` 排除。
+
+## 手工生成
+
+当验证码无法自动化时，可以先手工生成：
+
+```bash
+npx playwright codegen --save-storage=playwright/.auth/doctor.json "$DOCTOR_BASE_URL"
+```
+
+在打开的浏览器中完成登录，然后关闭窗口。之后再运行：
+
+```bash
+npm run test:smoke
+```
+
+## 当前阻塞
+
+规划里 `WP-03 登录态与账号池` 仍是 `Blocked`。在后端测试登录接口、验证码绕过或稳定测试账号确认前，CI 只能跑不依赖登录态的检查，或者使用定期刷新的 storageState。

package/docs/case-map.md

@@ -0,0 +1,10 @@
+# 用例映射
+
+| Playwright Case ID | Source QA ID | Evidence ID | 优先级 | 文件 |
+| --- | --- | --- | --- | --- |
+| `PW-SMK-001` | `SMK-01` | `SMOKE-login-page-render` | Smoke | `cases/doctor-pc/smoke/login-page.spec.ts` |
+| `PW-SMK-002` | 待补 | `SMOKE-authenticated-home` | Smoke | `cases/doctor-pc/smoke/authenticated-home.spec.ts` |
+| `PW-SMK-003` | 待补 | `SMOKE-prescription-tab-open` | Smoke | `cases/doctor-pc/smoke/prescription-tab.spec.ts` |
+| `PW-RX-004` | `QA-RXHIGH-006` | `RX-submit-fail-keep-drugs` | P0 | `cases/doctor-pc/prescription/submit-failure-keeps-drugs.spec.ts` |
+
+`PW-RX-004` 当前只保留跳过用例，用来固定后续实现位置。真实实现依赖处方测试数据、稳定选择器和 mock 策略确认。

package/docs/ci.md

@@ -0,0 +1,36 @@
+# CI 接入说明
+
+## 流水线分层
+
+| 流程 | 命令 | 触发 |
+| --- | --- | --- |
+| PR Smoke | `npm run test:smoke` | PR 或测试仓变更 |
+| Nightly P0 | `npm run test:p0` | 每晚定时 |
+| Release Regression | `npm run test:release` | 发版前手动 |
+
+## 环境变量
+
+CI 至少需要：
+
+```bash
+DOCTOR_BASE_URL=https://your-test-doctor-pc.example.com
+```
+
+如果要跑已登录用例，还需要提供稳定登录态：
+
+```bash
+DOCTOR_USERNAME=
+DOCTOR_PASSWORD=
+```
+
+或在 CI secret 中提供 `playwright/.auth/doctor.json` 的安全还原方式。
+
+## 产物
+
+建议归档：
+
+- `playwright-report/`
+- `test-results/`
+- `playwright/.auth/` 不归档
+
+GitHub Actions 模板在 `ci/github-actions/playwright.yml`。确认公司实际 CI 平台后，再移动到对应平台配置位置。

package/docs/runbook.md

@@ -0,0 +1,39 @@
+# 运行手册
+
+## 本地运行
+
+```bash
+npm install
+npx playwright install chromium
+cp .env.example .env
+npm run test:smoke
+```
+
+`DOCTOR_BASE_URL` 未配置时，真实页面用例会跳过。这样可以先验证工程、类型检查和 CI 脚本，不把未确认的测试环境伪装成可用。
+
+## 登录态
+
+优先使用测试登录接口或账号密码生成 storageState：
+
+```bash
+npm run auth:doctor
+```
+
+如果验证码暂时无法自动化，按 `docs/auth-runbook.md` 手工生成 `playwright/.auth/doctor.json`。
+
+## 报告和证据
+
+失败时 Playwright 会保留：
+
+- trace
+- screenshot
+- video
+- HTML report
+- JUnit report
+- JSON report
+
+报告命令：
+
+```bash
+npm run report
+```

package/docs/selector-convention.md

@@ -0,0 +1,24 @@
+# 选择器规范
+
+## 优先级
+
+1. `getByRole`
+2. `getByLabel`
+3. `getByText`
+4. `data-testid`
+5. 其他稳定业务属性
+
+禁止把样式类名、DOM 层级或 `nth-child` 作为主要定位方式。
+
+## 建议补充的 `data-testid`
+
+| 区域 | 建议标识 |
+| --- | --- |
+| 问诊列表 | `doctor-worklist`、`inquiry-card-{inquiryId}` |
+| 聊天区 | `chat-panel`、`chat-input`、`chat-send-button` |
+| 处方区 | `prescription-panel`、`prescription-submit-button` |
+| 诊断搜索 | `diagnosis-search-input` |
+| 药品弹窗 | `drug-dialog`、`drug-search-input`、`drug-row-{drugName}` |
+| 自动关诊 | `auto-close-countdown`、`auto-close-confirm-button` |
+
+列表项尽量暴露业务 ID，便于断言不串问诊、不串处方。

package/docs/test-data.md

@@ -0,0 +1,23 @@
+# 测试数据
+
+## 首批数据标签
+
+| 标签 | 用途 | 当前状态 |
+| --- | --- | --- |
+| `doctor-account` | 医生端登录和并发隔离 | `Blocked` |
+| `patient-account` | 患者发消息、视频、接诊配合 | `Blocked` |
+| `first-prescription-inquiry` | 首次开方链路 | `Blocked` |
+| `withdrawable-prescription` | 撤回修改处方 | `Blocked` |
+| `drug-sample` | 药品搜索、库存、互斥 | `Blocked` |
+| `auto-close-inquiry` | 自动关诊倒计时和关诊 | `Blocked` |
+
+## 数据原则
+
+- 修改同一问诊或处方的用例必须串行或独占数据。
+- P0 用例优先使用可重复准备的数据，不依赖人工临时造数。
+- 真实 IM/WebSocket 链路放 nightly，异常分支优先通过 mock 或测试桩覆盖。
+- 每条用例需要记录 `Playwright Case ID`、来源 QA ID、Evidence ID 和 Data Tag。
+
+## 后续接口约定
+
+`src/api/test-data.api.ts` 预留了 `lease` 调用，等测试数据服务确认后再对齐真实路径和返回结构。

package/eslint.config.mjs

@@ -0,0 +1,28 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default [
+  {
+    ignores: [
+      'node_modules/**',
+      'playwright-report/**',
+      'test-results/**',
+      'blob-report/**'
+    ]
+  },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    files: ['**/*.ts'],
+    rules: {
+      'no-empty-pattern': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_'
+        }
+      ]
+    }
+  }
+];

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "ykq-playwright-ci",
+  "version": "0.1.0",
+  "description": "Company-level Playwright E2E test project for doctor PC workflows.",
+  "bin": {
+    "playwright-ci": "bin/playwright-ci.mjs"
+  },
+  "files": [
+    "bin/",
+    "cases/",
+    "ci/",
+    "docs/",
+    "scripts/",
+    "src/",
+    ".env.example",
+    ".nvmrc",
+    "eslint.config.mjs",
+    "package.json",
+    "playwright.config.ts",
+    "projects.config.json",
+    "README.md",
+    "tsconfig.json"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "test": "playwright test",
+    "test:smoke": "playwright test --grep @smoke",
+    "test:p0": "playwright test --grep @p0 --workers=2",
+    "test:release": "playwright test --grep \"@p0|@rx-high\"",
+    "project:list": "node scripts/configure-project.mjs list",
+    "project:show": "node scripts/configure-project.mjs show",
+    "project:add": "node scripts/configure-project.mjs add",
+    "project:update": "node scripts/configure-project.mjs update",
+    "project:delete": "node scripts/configure-project.mjs delete",
+    "project:remove": "node scripts/configure-project.mjs remove",
+    "project:test": "node scripts/run-project.mjs",
+    "test:doctor-test": "node scripts/run-doctor-test.mjs",
+    "doctor:test": "node scripts/run-project.mjs doctor-pc",
+    "doctor:test:headed": "node scripts/run-project.mjs doctor-pc --headed",
+    "doctor:test:debug": "node scripts/run-project.mjs doctor-pc --debug",
+    "doctor:test:ui": "node scripts/run-project.mjs doctor-pc --ui",
+    "doctor:test:local": "DOCTOR_BASE_URL=https://ys-test.heyejk.com DOCTOR_PUBLIC_PATH=/physician-admin/ DOCTOR_LOGIN_PATH=/physician-admin/login playwright test cases/doctor-pc/test-env --project=chromium --no-deps",
+    "patient:test": "node scripts/run-project.mjs patient-h5",
+    "admin:test": "node scripts/run-project.mjs admin",
+    "test:headed": "playwright test --headed",
+    "auth:doctor": "playwright test --project=setup",
+    "report": "playwright show-report",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@playwright/test": "^1.49.0",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@types/node": "^22.10.0",
+    "eslint": "^9.17.0",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.18.0"
+  }
+}

package/playwright.config.ts

@@ -0,0 +1,44 @@
+import { defineConfig, devices } from '@playwright/test';
+import { appEnv } from './src/utils/env';
+
+export default defineConfig({
+  testDir: '.',
+  testMatch: ['cases/**/*.spec.ts', 'cases/**/*.setup.ts'],
+  outputDir: 'test-results',
+  timeout: 60_000,
+  expect: {
+    timeout: 10_000
+  },
+  fullyParallel: false,
+  forbidOnly: Boolean(process.env.CI),
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 2 : undefined,
+  reporter: [
+    ['list'],
+    ['html', { outputFolder: 'playwright-report', open: 'never' }],
+    ['junit', { outputFile: 'test-results/junit.xml' }],
+    ['json', { outputFile: 'test-results/results.json' }]
+  ],
+  use: {
+    baseURL: appEnv.doctorBaseURL,
+    actionTimeout: 15_000,
+    navigationTimeout: 30_000,
+    trace: 'retain-on-failure',
+    screenshot: 'only-on-failure',
+    video: 'retain-on-failure'
+  },
+  projects: [
+    {
+      name: 'setup',
+      testMatch: /.*\.setup\.ts/
+    },
+    {
+      name: 'chromium',
+      dependencies: ['setup'],
+      testIgnore: /.*\.setup\.ts/,
+      use: {
+        ...devices['Desktop Chrome']
+      }
+    }
+  ]
+});

package/projects.config.json

@@ -0,0 +1,33 @@
+{
+  "caseCacheDir": ".case-repos",
+  "projects": {
+    "doctor-pc": {
+      "description": "医生端 PC 测试环境基础用例",
+      "repo": "https://git.int.ybm100.com/ykq/doctor-pc-web-test-store",
+      "branch": "master",
+      "caseDir": ".case-repos/doctor-pc",
+      "env": {
+        "DOCTOR_BASE_URL": "https://ys-test.heyejk.com",
+        "DOCTOR_PUBLIC_PATH": "/physician-admin/",
+        "DOCTOR_LOGIN_PATH": "/physician-admin/login"
+      },
+      "playwrightArgs": ["--project=chromium", "--no-deps"]
+    },
+    "patient-h5": {
+      "description": "患者端 H5 用例库占位，配置 repo 后可运行",
+      "repo": "",
+      "branch": "main",
+      "caseDir": ".case-repos/patient-h5",
+      "env": {},
+      "playwrightArgs": ["--project=chromium"]
+    },
+    "admin": {
+      "description": "运营后台用例库占位，配置 repo 后可运行",
+      "repo": "",
+      "branch": "main",
+      "caseDir": ".case-repos/admin",
+      "env": {},
+      "playwrightArgs": ["--project=chromium"]
+    }
+  }
+}