@sun-asterisk/sungen 2.6.0 → 2.6.2

package/src/dashboard/snapshot-builder.ts

@@ -0,0 +1,273 @@
+/**
+ * Orchestrate dashboard snapshot construction across all screens/flows.
+ *
+ * Inputs are read from the same on-disk sources used by `sungen delivery`:
+ *   qa/screens/<name>/...        feature, test-data, selectors, requirements
+ *   qa/flows/<name>/...
+ *   specs/generated/<...>/...    compiled .spec.ts + per-target test-result.json
+ *   test-results/results.json    global fallback
+ *
+ * Output is a DashboardSnapshot ready to be embedded in HTML or written as
+ * a history entry under qa/dashboard/history/<runId>.json.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import { parseFeatureMetadata } from '../exporters/feature-parser';
+import { parseSpecFile } from '../exporters/spec-parser';
+import { loadTestData } from '../exporters/test-data-resolver';
+import { loadPlaywrightReport } from '../exporters/playwright-report-parser';
+import { mergeFeatureAndSpec } from '../exporters/scenario-merger';
+import { buildScreenSnapshot } from '../exporters/json-exporter';
+import { getPackageVersion } from '../exporters/package-info';
+import { EnvironmentInfo } from '../exporters/types';
+import {
+  AggregateSummary,
+  DashboardSnapshot,
+  ScenarioSnapshot,
+  ScreenSnapshot,
+  SNAPSHOT_VERSION,
+} from './types';
+
+export interface DashboardTarget {
+  name: string;
+  isFlow: boolean;
+}
+
+export interface BuildSnapshotOptions {
+  cwd: string;
+  targets: DashboardTarget[];
+  env: EnvironmentInfo;
+  /** Skip targets where the .feature/.spec.ts pair fails to parse. */
+  continueOnError?: boolean;
+}
+
+export function buildDashboardSnapshot(options: BuildSnapshotOptions): DashboardSnapshot {
+  const { cwd, targets, env } = options;
+  const screens: ScreenSnapshot[] = [];
+
+  for (const target of targets) {
+    try {
+      const screen = buildOneScreen(cwd, target, env);
+      if (screen) screens.push(screen);
+    } catch (err) {
+      if (!options.continueOnError) throw err;
+      // eslint-disable-next-line no-console
+      console.warn(`[dashboard] skipping ${target.name}: ${(err as Error).message}`);
+    }
+  }
+
+  const now = new Date();
+  return {
+    version: SNAPSHOT_VERSION,
+    runId: makeRunId(now),
+    generatedAt: toLocalIso(now),
+    environment: collectEnvironment(cwd, env),
+    summary: aggregateSummary(screens),
+    screens: screens.sort((a, b) => a.name.localeCompare(b.name)),
+  };
+}
+
+// ----------------------------------------------------------------------------
+// Per-target build
+// ----------------------------------------------------------------------------
+
+function buildOneScreen(
+  cwd: string,
+  target: DashboardTarget,
+  env: EnvironmentInfo
+): ScreenSnapshot | null {
+  const base = qaDir(cwd, target);
+  const genBase = generatedDir(cwd, target);
+  const featureFile = path.join(base, 'features', `${target.name}.feature`);
+  const testDataFile = path.join(base, 'test-data', `${target.name}.yaml`);
+  const specFile = path.join(genBase, `${target.name}.spec.ts`);
+  const specMdFile = path.join(base, 'requirements', 'spec.md');
+  const resultsFile = resolveResultsPath(cwd, target);
+
+  if (!fs.existsSync(featureFile)) return null;
+
+  const feature = parseFeatureMetadata(featureFile);
+  const spec = fs.existsSync(specFile)
+    ? parseSpecFile(specFile)
+    : { tests: [] };
+  const testData = fs.existsSync(testDataFile) ? loadTestData(testDataFile) : {};
+  const results = resultsFile ? loadPlaywrightReport(resultsFile) : null;
+
+  const merged = mergeFeatureAndSpec(feature, spec);
+  const label = target.isFlow ? `flow/${target.name}` : target.name;
+  const specLink = fs.existsSync(specMdFile) ? path.relative(cwd, specMdFile) : undefined;
+
+  return buildScreenSnapshot({
+    screen: label,
+    isFlow: target.isFlow,
+    featureName: feature.featureName,
+    featurePath: feature.featurePath,
+    specLink,
+    merged,
+    testData,
+    results,
+    env,
+  });
+}
+
+// ----------------------------------------------------------------------------
+// Aggregate summary across all screens
+// ----------------------------------------------------------------------------
+
+function aggregateSummary(screens: ScreenSnapshot[]): AggregateSummary {
+  const summary: AggregateSummary = {
+    total: 0,
+    passed: 0,
+    failed: 0,
+    pending: 0,
+    na: 0,
+    notCompiled: 0,
+    passRate: 0,
+    byPriority: { Critical: 0, High: 0, Normal: 0, Low: 0 },
+    byCategory: { Accessing: 0, GUI: 0, Function: 0 },
+    byType: { Auto: 0, Manual: 0, 'Not compiled': 0 },
+  };
+
+  for (const screen of screens) {
+    summary.total += screen.summary.total;
+    summary.passed += screen.summary.passed;
+    summary.failed += screen.summary.failed;
+    summary.pending += screen.summary.pending;
+    summary.na += screen.summary.na;
+    summary.notCompiled += screen.summary.notCompiled;
+
+    for (const s of screen.scenarios) {
+      bumpKey(summary.byPriority, s.priority);
+      bumpKey(summary.byCategory, s.category2);
+      bumpKey(summary.byType, s.type);
+    }
+  }
+
+  const executed = summary.passed + summary.failed;
+  summary.passRate = executed > 0 ? summary.passed / executed : 0;
+  return summary;
+}
+
+function bumpKey(record: Record<string, number>, key: string): void {
+  record[key] = (record[key] ?? 0) + 1;
+}
+
+// ----------------------------------------------------------------------------
+// Path helpers (mirror delivery.ts to stay consistent)
+// ----------------------------------------------------------------------------
+
+function qaDir(cwd: string, target: DashboardTarget): string {
+  return path.join(cwd, 'qa', target.isFlow ? 'flows' : 'screens', target.name);
+}
+
+function generatedDir(cwd: string, target: DashboardTarget): string {
+  return target.isFlow
+    ? path.join(cwd, 'specs', 'generated', 'flows', target.name)
+    : path.join(cwd, 'specs', 'generated', target.name);
+}
+
+function resolveResultsPath(cwd: string, target: DashboardTarget): string | null {
+  const genDir = generatedDir(cwd, target);
+  const perTarget = path.join(genDir, `${target.name}-test-result.json`);
+  if (fs.existsSync(perTarget)) return perTarget;
+  const global = path.join(cwd, 'test-results', 'results.json');
+  if (fs.existsSync(global)) return global;
+  return null;
+}
+
+// ----------------------------------------------------------------------------
+// Discovery (also used by CLI)
+// ----------------------------------------------------------------------------
+
+export function listDashboardTargets(cwd: string): DashboardTarget[] {
+  const targets: DashboardTarget[] = [];
+
+  const screensDir = path.join(cwd, 'qa', 'screens');
+  if (fs.existsSync(screensDir)) {
+    for (const d of fs.readdirSync(screensDir, { withFileTypes: true })) {
+      if (d.isDirectory()) targets.push({ name: d.name, isFlow: false });
+    }
+  }
+
+  const flowsDir = path.join(cwd, 'qa', 'flows');
+  if (fs.existsSync(flowsDir)) {
+    for (const d of fs.readdirSync(flowsDir, { withFileTypes: true })) {
+      if (d.isDirectory()) targets.push({ name: d.name, isFlow: true });
+    }
+  }
+
+  return targets.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+export function resolveTargetType(cwd: string, name: string): DashboardTarget {
+  if (fs.existsSync(path.join(cwd, 'qa', 'flows', name))) {
+    return { name, isFlow: true };
+  }
+  return { name, isFlow: false };
+}
+
+// ----------------------------------------------------------------------------
+// Run ID + environment metadata (Vietnam Indochina Time, UTC+7, no DST)
+// ----------------------------------------------------------------------------
+
+const VN_OFFSET_MS = 7 * 60 * 60 * 1000;
+
+/**
+ * Filename-safe ISO timestamp in Vietnam time (UTC+7).
+ * Example: 2026-04-29T08-13-53+0700
+ *
+ * Colons in HH:MM:SS are replaced with `-` (filename-safe on Windows too).
+ * The `+0700` suffix makes the offset explicit so consumers don't need
+ * to assume a default timezone.
+ */
+function makeRunId(now: Date): string {
+  const vn = new Date(now.getTime() + VN_OFFSET_MS);
+  const yyyy = vn.getUTCFullYear();
+  const MM = String(vn.getUTCMonth() + 1).padStart(2, '0');
+  const dd = String(vn.getUTCDate()).padStart(2, '0');
+  const HH = String(vn.getUTCHours()).padStart(2, '0');
+  const mm = String(vn.getUTCMinutes()).padStart(2, '0');
+  const ss = String(vn.getUTCSeconds()).padStart(2, '0');
+  return `${yyyy}-${MM}-${dd}T${HH}-${mm}-${ss}+0700`;
+}
+
+/**
+ * Full ISO 8601 timestamp in Vietnam time, with milliseconds and `+07:00` offset.
+ * Example: 2026-04-29T08:13:53.495+07:00
+ */
+function toLocalIso(now: Date): string {
+  const vn = new Date(now.getTime() + VN_OFFSET_MS);
+  const yyyy = vn.getUTCFullYear();
+  const MM = String(vn.getUTCMonth() + 1).padStart(2, '0');
+  const dd = String(vn.getUTCDate()).padStart(2, '0');
+  const HH = String(vn.getUTCHours()).padStart(2, '0');
+  const mm = String(vn.getUTCMinutes()).padStart(2, '0');
+  const ss = String(vn.getUTCSeconds()).padStart(2, '0');
+  const ms = String(vn.getUTCMilliseconds()).padStart(3, '0');
+  return `${yyyy}-${MM}-${dd}T${HH}:${mm}:${ss}.${ms}+07:00`;
+}
+
+function collectEnvironment(cwd: string, env: EnvironmentInfo) {
+  let gitBranch: string | undefined;
+  let gitSha: string | undefined;
+  try {
+    gitBranch = execSync('git rev-parse --abbrev-ref HEAD', { cwd, encoding: 'utf-8' }).trim();
+  } catch { /* ignore */ }
+  try {
+    gitSha = execSync('git rev-parse --short HEAD', { cwd, encoding: 'utf-8' }).trim();
+  } catch { /* ignore */ }
+
+  return {
+    baseURL: env.baseURL,
+    projectName: env.projectName,
+    executor: env.executor,
+    sungenVersion: getPackageVersion(),
+    gitBranch,
+    gitSha,
+  };
+}
+
+// Helper for ScenarioSnapshot tree filters in UI (re-exported for callers)
+export type { ScenarioSnapshot };