ykq-playwright-ci 0.1.0

package/scripts/configure-project.mjs

@@ -0,0 +1,280 @@
+/* global console, process */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline/promises';
+import { fileURLToPath } from 'node:url';
+
+const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const configPath = process.env.PROJECTS_CONFIG_PATH
+  ? path.resolve(process.env.PROJECTS_CONFIG_PATH)
+  : path.join(rootDir, 'projects.config.json');
+
+function createPrompt() {
+  if (process.stdin.isTTY) {
+    return readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+  }
+
+  const answers = fs.readFileSync(0, 'utf8').split(/\r?\n/);
+  let index = 0;
+
+  return {
+    question: async (question) => {
+      process.stdout.write(question);
+      const answer = answers[index] ?? '';
+      index += 1;
+      process.stdout.write(`${answer}\n`);
+      return answer;
+    },
+    close: () => {}
+  };
+}
+
+function readConfig() {
+  return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+}
+
+function writeConfig(config) {
+  fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
+}
+
+function normalizeProjectName(value) {
+  return value.trim().replace(/\s+/g, '-');
+}
+
+function defaultCaseDir(projectName) {
+  return `.case-repos/${projectName}`;
+}
+
+function parseEnvPairs(lines) {
+  const env = {};
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+
+    const separatorIndex = trimmed.indexOf('=');
+    if (separatorIndex <= 0) {
+      throw new Error(`环境变量格式错误：${line}`);
+    }
+
+    const key = trimmed.slice(0, separatorIndex).trim();
+    const value = trimmed.slice(separatorIndex + 1).trim();
+    if (!key) {
+      throw new Error(`环境变量 key 不能为空：${line}`);
+    }
+
+    env[key] = value;
+  }
+
+  return env;
+}
+
+function splitArgs(value) {
+  return value
+    .split(/\s+/)
+    .map((item) => item.trim())
+    .filter(Boolean);
+}
+
+function printProjects(config) {
+  const projects = config.projects || {};
+  const names = Object.keys(projects);
+
+  if (!names.length) {
+    console.log('暂无项目配置。');
+    return;
+  }
+
+  console.log('项目配置：');
+  for (const name of names) {
+    const project = projects[name];
+    console.log(`- ${name}`);
+    console.log(`  说明：${project.description || '-'}`);
+    console.log(`  仓库：${project.repo || '-'}`);
+    console.log(`  分支：${project.branch || '-'}`);
+    console.log(`  用例：${project.caseDir || '-'}`);
+  }
+}
+
+function showProject(config, projectName) {
+  const project = config.projects?.[projectName];
+  if (!project) {
+    throw new Error(`项目不存在：${projectName}`);
+  }
+
+  console.log(JSON.stringify({ [projectName]: project }, null, 2));
+}
+
+async function askRequired(rl, question, defaultValue = '') {
+  const suffix = defaultValue ? ` (${defaultValue})` : '';
+  const answer = (await rl.question(`${question}${suffix}: `)).trim();
+  const value = answer || defaultValue;
+
+  if (!value) {
+    throw new Error(`${question} 不能为空。`);
+  }
+
+  return value;
+}
+
+async function askOptional(rl, question, defaultValue = '') {
+  const suffix = defaultValue ? ` (${defaultValue})` : '';
+  const answer = (await rl.question(`${question}${suffix}: `)).trim();
+  return answer || defaultValue;
+}
+
+async function askEnv(rl, existingEnv = {}, allowKeep = false) {
+  const existingKeys = Object.keys(existingEnv);
+  if (allowKeep && existingKeys.length) {
+    const keep = await askOptional(rl, '是否保留现有环境变量？输入 no 重新填写', 'yes');
+    if (keep !== 'no') {
+      return existingEnv;
+    }
+  }
+
+  console.log('请输入环境变量，每行一个 KEY=VALUE；空行结束。');
+
+  const lines = [];
+  while (true) {
+    const line = await rl.question('env> ');
+    if (!line.trim()) break;
+    lines.push(line);
+  }
+
+  return parseEnvPairs(lines);
+}
+
+async function askProjectName(rl, inputName = '') {
+  const rawName = inputName || (await askRequired(rl, '项目名，例如 doctor-pc'));
+  const projectName = normalizeProjectName(rawName);
+
+  if (!projectName) {
+    throw new Error('项目名不能为空。');
+  }
+
+  return projectName;
+}
+
+async function collectProjectFields(rl, projectName, existing = undefined) {
+  const repo = await askRequired(
+    rl,
+    '用例库 Git 地址',
+    existing?.repo || `https://git.int.ybm100.com/ykq/${projectName}-test-store`
+  );
+  const branch = await askRequired(rl, '分支', existing?.branch || 'master');
+  const caseDir = await askRequired(rl, '本地用例缓存目录', existing?.caseDir || defaultCaseDir(projectName));
+  const description = await askOptional(rl, '项目说明', existing?.description || `${projectName} 用例库`);
+  const playwrightArgsInput = await askOptional(
+    rl,
+    'Playwright 参数',
+    (existing?.playwrightArgs || ['--project=chromium']).join(' ')
+  );
+  const env = await askEnv(rl, existing?.env || {}, Boolean(existing));
+
+  return {
+    description,
+    repo,
+    branch,
+    caseDir,
+    env,
+    playwrightArgs: splitArgs(playwrightArgsInput)
+  };
+}
+
+async function addProject(config, rl, inputName = '') {
+  const projectName = await askProjectName(rl, inputName);
+  const existing = config.projects?.[projectName];
+
+  if (existing) {
+    throw new Error(`项目已存在：${projectName}。请使用 project:update。`);
+  }
+
+  config.projects = config.projects || {};
+  config.projects[projectName] = await collectProjectFields(rl, projectName);
+  writeConfig(config);
+  console.log(`已新增项目：${projectName}`);
+}
+
+async function updateProject(config, rl, inputName = '') {
+  const projectName = await askProjectName(rl, inputName);
+  const existing = config.projects?.[projectName];
+
+  if (!existing) {
+    throw new Error(`项目不存在：${projectName}。请使用 project:add。`);
+  }
+
+  config.projects[projectName] = await collectProjectFields(rl, projectName, existing);
+  writeConfig(config);
+  console.log(`已更新项目：${projectName}`);
+}
+
+async function deleteProject(config, rl, inputName = '') {
+  const projectName = await askProjectName(rl, inputName);
+  const existing = config.projects?.[projectName];
+
+  if (!existing) {
+    throw new Error(`项目不存在：${projectName}`);
+  }
+
+  const confirm = await askOptional(rl, `确认删除 ${projectName} 配置？输入 delete 确认`, 'no');
+  if (confirm !== 'delete') {
+    console.log('已取消。');
+    return;
+  }
+
+  delete config.projects[projectName];
+  writeConfig(config);
+  console.log(`已删除项目配置：${projectName}`);
+  console.log(`本地用例缓存未删除，如需清理可手动删除：${existing.caseDir}`);
+}
+
+async function run() {
+  const [action = 'list', projectName = ''] = process.argv.slice(2);
+  const config = readConfig();
+
+  if (action === 'list') {
+    printProjects(config);
+    return;
+  }
+
+  if (action === 'show') {
+    const name = normalizeProjectName(projectName);
+    if (!name) {
+      throw new Error('请提供项目名，例如：npm run project:show -- doctor-pc');
+    }
+    showProject(config, name);
+    return;
+  }
+
+  const rl = createPrompt();
+
+  try {
+    if (action === 'add') {
+      await addProject(config, rl, projectName);
+      return;
+    }
+
+    if (action === 'update') {
+      await updateProject(config, rl, projectName);
+      return;
+    }
+
+    if (action === 'delete' || action === 'remove') {
+      await deleteProject(config, rl, projectName);
+      return;
+    }
+
+    throw new Error(`未知命令：${action}`);
+  } finally {
+    rl.close();
+  }
+}
+
+run().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
+});

package/scripts/run-doctor-test.mjs

@@ -0,0 +1,19 @@
+/* global process */
+
+import { spawn } from 'node:child_process';
+
+const args = ['scripts/run-project.mjs', 'doctor-pc', ...process.argv.slice(2)];
+
+const child = spawn(process.execPath, args, {
+  env: process.env,
+  stdio: 'inherit'
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 1);
+});

package/scripts/run-project.mjs

@@ -0,0 +1,252 @@
+/* global console, process */
+
+import { spawn, spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const require = createRequire(import.meta.url);
+const configPath = process.env.PROJECTS_CONFIG_PATH
+  ? path.resolve(process.env.PROJECTS_CONFIG_PATH)
+  : path.join(rootDir, 'projects.config.json');
+const workspaceDir = process.env.PROJECTS_CONFIG_PATH ? path.dirname(configPath) : rootDir;
+const playwrightConfigPath = path.join(rootDir, 'playwright.config.ts');
+const playwrightCliPath = path.join(path.dirname(require.resolve('@playwright/test/package.json')), 'cli.js');
+const knownModeArgs = new Set(['--headed', '--debug', '--ui']);
+let gitAskpassPath = '';
+
+function readConfig() {
+  return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+}
+
+function parseArgs(argv) {
+  let projectName = '';
+  const passthroughArgs = [];
+  let skipPull = false;
+
+  for (const arg of argv) {
+    if (arg === '--no-pull') {
+      skipPull = true;
+      continue;
+    }
+
+    if (!arg.startsWith('-') && !projectName) {
+      projectName = arg;
+      continue;
+    }
+
+    passthroughArgs.push(arg);
+  }
+
+  return {
+    projectName,
+    passthroughArgs,
+    skipPull
+  };
+}
+
+function createGitAskpassEnv() {
+  if (!process.env.GIT_USERNAME || !process.env.GIT_PASSWORD) {
+    return {
+      ...process.env,
+      GIT_TERMINAL_PROMPT: '0'
+    };
+  }
+
+  if (!gitAskpassPath) {
+    const askpassDir = fs.mkdtempSync(path.join(os.tmpdir(), 'playwright-ci-git-askpass-'));
+    gitAskpassPath = path.join(askpassDir, 'askpass.sh');
+    fs.writeFileSync(
+      gitAskpassPath,
+      [
+        '#!/bin/sh',
+        'case "$1" in',
+        '*Username*) printf "%s\\n" "$GIT_USERNAME" ;;',
+        '*Password*) printf "%s\\n" "$GIT_PASSWORD" ;;',
+        '*) printf "\\n" ;;',
+        'esac',
+        ''
+      ].join('\n'),
+      { mode: 0o700 }
+    );
+  }
+
+  return {
+    ...process.env,
+    GIT_ASKPASS: gitAskpassPath,
+    GIT_TERMINAL_PROMPT: '0'
+  };
+}
+
+function cleanupGitAskpass() {
+  if (!gitAskpassPath) return;
+
+  try {
+    fs.rmSync(path.dirname(gitAskpassPath), { recursive: true, force: true });
+  } catch {
+    // Best-effort cleanup only.
+  }
+}
+
+function runGit(args, cwd = workspaceDir) {
+  const result = spawnSync('git', args, {
+    cwd,
+    encoding: 'utf8',
+    env: createGitAskpassEnv(),
+    stdio: ['ignore', 'pipe', 'pipe']
+  });
+
+  if (result.status !== 0) {
+    const output = `${result.stdout || ''}${result.stderr || ''}`.trim();
+    throw new Error(`git ${args.join(' ')} failed${output ? `:\n${output}` : ''}`);
+  }
+
+  return result.stdout.trim();
+}
+
+function isEmptyDirectory(dir) {
+  return fs.existsSync(dir) && fs.statSync(dir).isDirectory() && fs.readdirSync(dir).length === 0;
+}
+
+function ensureCleanCaseRepo(caseDir) {
+  if (!fs.existsSync(path.join(caseDir, '.git'))) {
+    return;
+  }
+
+  const status = runGit(['status', '--porcelain'], caseDir);
+  if (status) {
+    throw new Error(
+      `用例库有未提交改动，已停止自动拉取，避免覆盖本地调试内容：${caseDir}\n${status}`
+    );
+  }
+}
+
+function syncCaseRepo(projectName, project, config, skipPull) {
+  if (!project.repo) {
+    return resolveCaseDir(project.caseDir);
+  }
+
+  const caseCacheDir = path.resolve(workspaceDir, config.caseCacheDir || '.case-repos');
+  const caseDir = resolveCaseDir(project.caseDir || path.join(caseCacheDir, projectName));
+  const branch = project.branch || 'main';
+
+  fs.mkdirSync(path.dirname(caseDir), { recursive: true });
+
+  if (!fs.existsSync(caseDir)) {
+    runGit(['clone', '--branch', branch, '--single-branch', project.repo, caseDir]);
+    return caseDir;
+  }
+
+  if (!fs.existsSync(path.join(caseDir, '.git')) && isEmptyDirectory(caseDir)) {
+    fs.rmdirSync(caseDir);
+    runGit(['clone', '--branch', branch, '--single-branch', project.repo, caseDir]);
+    return caseDir;
+  }
+
+  if (!fs.existsSync(path.join(caseDir, '.git'))) {
+    throw new Error(`caseDir 已存在但不是 Git 仓库：${caseDir}`);
+  }
+
+  if (!skipPull) {
+    ensureCleanCaseRepo(caseDir);
+    runGit(['fetch', 'origin', branch], caseDir);
+    runGit(['checkout', branch], caseDir);
+    runGit(['pull', '--ff-only', 'origin', branch], caseDir);
+  }
+
+  return caseDir;
+}
+
+function resolveCaseDir(caseDir) {
+  if (!caseDir) {
+    throw new Error('项目缺少 caseDir 配置。');
+  }
+
+  return path.isAbsolute(caseDir) ? caseDir : path.resolve(workspaceDir, caseDir);
+}
+
+function printProjects(config) {
+  console.log('可用项目：');
+  for (const [name, project] of Object.entries(config.projects || {})) {
+    console.log(`- ${name}: ${project.description || ''}`);
+  }
+}
+
+function validateProject(projectName, project, caseDir) {
+  if (!project) {
+    throw new Error(`未知项目：${projectName}`);
+  }
+
+  if (!fs.existsSync(caseDir)) {
+    const repoHint = project.repo ? '' : '；如果这是远程用例库项目，请先在 projects.config.json 里配置 repo';
+    throw new Error(`用例目录不存在：${caseDir}${repoHint}`);
+  }
+}
+
+function buildPlaywrightArgs(caseDir, project, passthroughArgs) {
+  const args = ['test', caseDir, '--config', playwrightConfigPath];
+  args.push(...(project.playwrightArgs || []));
+
+  for (const arg of passthroughArgs) {
+    if (knownModeArgs.has(arg) || arg.startsWith('-')) {
+      args.push(arg);
+    } else {
+      args.push(arg);
+    }
+  }
+
+  return args;
+}
+
+function main() {
+  const config = readConfig();
+  const { projectName, passthroughArgs, skipPull } = parseArgs(process.argv.slice(2));
+
+  if (!projectName || projectName === 'list') {
+    printProjects(config);
+    process.exit(projectName ? 0 : 1);
+  }
+
+  const project = config.projects?.[projectName];
+  if (!project) {
+    printProjects(config);
+    throw new Error(`未知项目：${projectName}`);
+  }
+
+  const caseDir = syncCaseRepo(projectName, project, config, skipPull);
+  cleanupGitAskpass();
+  validateProject(projectName, project, caseDir);
+
+  const child = spawn(
+    process.execPath,
+    [playwrightCliPath, ...buildPlaywrightArgs(caseDir, project, passthroughArgs)],
+    {
+      cwd: workspaceDir,
+      env: {
+        ...(project.env || {}),
+        ...process.env
+      },
+      stdio: 'inherit'
+    }
+  );
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+
+    process.exit(code ?? 1);
+  });
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error instanceof Error ? error.message : error);
+  cleanupGitAskpass();
+  process.exit(1);
+}

package/src/api/doctor.api.ts

@@ -0,0 +1,25 @@
+import type { APIRequestContext, APIResponse } from '@playwright/test';
+import { appEnv } from '../utils/env';
+
+export class DoctorApi {
+  constructor(
+    private readonly request: APIRequestContext,
+    private readonly baseURL = appEnv.apiBaseURL
+  ) {}
+
+  async get(pathname: string): Promise<APIResponse> {
+    return this.request.get(this.url(pathname));
+  }
+
+  async post(pathname: string, data: Record<string, unknown>): Promise<APIResponse> {
+    return this.request.post(this.url(pathname), { data });
+  }
+
+  private url(pathname: string): string {
+    if (!this.baseURL) {
+      throw new Error('API_BASE_URL is required for doctor API assertions.');
+    }
+
+    return new URL(pathname.replace(/^\/+/, ''), `${this.baseURL}/`).toString();
+  }
+}

package/src/api/test-data.api.ts

@@ -0,0 +1,33 @@
+import type { APIRequestContext, APIResponse } from '@playwright/test';
+import { appEnv } from '../utils/env';
+
+export type TestDataTag =
+  | 'doctor-account'
+  | 'patient-account'
+  | 'first-prescription-inquiry'
+  | 'withdrawable-prescription'
+  | 'drug-sample'
+  | 'auto-close-inquiry';
+
+export interface LeaseRequest {
+  tag: TestDataTag;
+  caseId: string;
+  workerIndex?: number;
+}
+
+export class TestDataApi {
+  constructor(
+    private readonly request: APIRequestContext,
+    private readonly baseURL = appEnv.testDataApiURL
+  ) {}
+
+  async lease(request: LeaseRequest): Promise<APIResponse> {
+    if (!this.baseURL) {
+      throw new Error('TEST_DATA_API_URL is required before leasing test data.');
+    }
+
+    return this.request.post(new URL('leases', `${this.baseURL}/`).toString(), {
+      data: request
+    });
+  }
+}

package/src/fixtures/auth.fixture.ts

@@ -0,0 +1,26 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import type { Browser, BrowserContext, Page } from '@playwright/test';
+import { appEnv } from '../utils/env';
+
+export function hasDoctorAuthState(storageStatePath = appEnv.storageStatePath): boolean {
+  return fs.existsSync(storageStatePath);
+}
+
+export async function createDoctorAuthContext(browser: Browser): Promise<BrowserContext> {
+  if (!hasDoctorAuthState()) {
+    throw new Error(
+      `Doctor storageState is missing: ${appEnv.storageStatePath}. Run npm run auth:doctor or follow docs/auth-runbook.md.`
+    );
+  }
+
+  return browser.newContext({
+    baseURL: appEnv.doctorBaseURL,
+    storageState: appEnv.storageStatePath
+  });
+}
+
+export async function saveDoctorAuthState(page: Page): Promise<void> {
+  fs.mkdirSync(path.dirname(appEnv.storageStatePath), { recursive: true });
+  await page.context().storageState({ path: appEnv.storageStatePath });
+}

package/src/fixtures/base.fixture.ts

@@ -0,0 +1,14 @@
+import { expect, test as base } from '@playwright/test';
+import { appEnv, type AppEnv } from '../utils/env';
+
+export interface BaseFixtures {
+  appEnv: AppEnv;
+}
+
+export const test = base.extend<BaseFixtures>({
+  appEnv: async ({}, use) => {
+    await use(appEnv);
+  }
+});
+
+export { expect };

package/src/fixtures/doctor.fixture.ts

@@ -0,0 +1,39 @@
+import { expect, test as base } from './base.fixture';
+import { ChatPage } from '../pages/doctor-pc/chat.page';
+import { DrugDialogPage } from '../pages/doctor-pc/drug-dialog.page';
+import { HomePage } from '../pages/doctor-pc/home.page';
+import { LoginPage } from '../pages/doctor-pc/login.page';
+import { PrescriptionPage } from '../pages/doctor-pc/prescription.page';
+import { WorklistPage } from '../pages/doctor-pc/worklist.page';
+
+export interface DoctorFixtures {
+  loginPage: LoginPage;
+  homePage: HomePage;
+  worklistPage: WorklistPage;
+  chatPage: ChatPage;
+  prescriptionPage: PrescriptionPage;
+  drugDialogPage: DrugDialogPage;
+}
+
+export const test = base.extend<DoctorFixtures>({
+  loginPage: async ({ page }, use) => {
+    await use(new LoginPage(page));
+  },
+  homePage: async ({ page }, use) => {
+    await use(new HomePage(page));
+  },
+  worklistPage: async ({ page }, use) => {
+    await use(new WorklistPage(page));
+  },
+  chatPage: async ({ page }, use) => {
+    await use(new ChatPage(page));
+  },
+  prescriptionPage: async ({ page }, use) => {
+    await use(new PrescriptionPage(page));
+  },
+  drugDialogPage: async ({ page }, use) => {
+    await use(new DrugDialogPage(page));
+  }
+});
+
+export { expect };

package/src/flows/doctor-pc/chat.flow.ts

@@ -0,0 +1,10 @@
+import { ChatPage } from '../../pages/doctor-pc/chat.page';
+
+export class ChatFlow {
+  constructor(private readonly chatPage: ChatPage) {}
+
+  async sendDoctorTextMessage(message: string): Promise<void> {
+    await this.chatPage.assertVisible();
+    await this.chatPage.sendTextMessage(message);
+  }
+}