create-pardx-scaffold 0.1.0

package/template/apps/web/lib/utils/transcript-export.ts

@@ -0,0 +1,321 @@
+/**
+ * Transcript Export Utilities
+ *
+ * Provides functions for exporting transcripts to various formats:
+ * - SRT (SubRip subtitle format)
+ * - TXT (Plain text)
+ * - JSON (Structured data)
+ * - VTT (WebVTT format)
+ */
+
+import type { StreamingUtterance } from '@repo/contracts/schemas/streaming-asr.schema';
+
+/**
+ * Speaker name mapping
+ */
+export type SpeakerNames = Record<string, string>;
+
+/**
+ * Export options
+ */
+export interface ExportOptions {
+  /** Custom speaker names */
+  speakerNames?: SpeakerNames;
+  /** Include timestamps */
+  includeTimestamps?: boolean;
+  /** Include speaker names */
+  includeSpeakers?: boolean;
+  /** Include confidence scores */
+  includeConfidence?: boolean;
+  /** Meeting title */
+  title?: string;
+  /** Meeting date */
+  date?: Date;
+}
+
+/**
+ * Format time in milliseconds to SRT format (HH:MM:SS,mmm)
+ */
+function formatSrtTime(ms: number): string {
+  const hours = Math.floor(ms / 3600000);
+  const minutes = Math.floor((ms % 3600000) / 60000);
+  const seconds = Math.floor((ms % 60000) / 1000);
+  const milliseconds = Math.floor(ms % 1000);
+
+  return `${hours.toString().padStart(2, '0')}:${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')},${milliseconds.toString().padStart(3, '0')}`;
+}
+
+/**
+ * Format time in milliseconds to VTT format (HH:MM:SS.mmm)
+ */
+function formatVttTime(ms: number): string {
+  const hours = Math.floor(ms / 3600000);
+  const minutes = Math.floor((ms % 3600000) / 60000);
+  const seconds = Math.floor((ms % 60000) / 1000);
+  const milliseconds = Math.floor(ms % 1000);
+
+  return `${hours.toString().padStart(2, '0')}:${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}.${milliseconds.toString().padStart(3, '0')}`;
+}
+
+/**
+ * Format time in milliseconds to readable format (MM:SS)
+ */
+function formatReadableTime(ms: number): string {
+  const minutes = Math.floor(ms / 60000);
+  const seconds = Math.floor((ms % 60000) / 1000);
+  return `${minutes.toString().padStart(2, '0')}:${seconds.toString().padStart(2, '0')}`;
+}
+
+/**
+ * Get speaker display name
+ */
+function getSpeakerName(
+  speakerId: string,
+  speakerNames?: SpeakerNames,
+): string {
+  if (speakerNames?.[speakerId]) {
+    return speakerNames[speakerId];
+  }
+  const num = parseInt(speakerId.replace(/\D/g, '') || '1', 10);
+  return `Speaker ${num}`;
+}
+
+/**
+ * Export transcript to SRT (SubRip subtitle) format
+ *
+ * @example Output:
+ * ```
+ * 1
+ * 00:00:00,000 --> 00:00:05,500
+ * Speaker 1: Hello, welcome to the meeting.
+ *
+ * 2
+ * 00:00:05,500 --> 00:00:10,000
+ * Speaker 2: Thank you for joining.
+ * ```
+ */
+export function exportToSrt(
+  utterances: StreamingUtterance[],
+  options: ExportOptions = {},
+): string {
+  const { speakerNames, includeSpeakers = true } = options;
+
+  return utterances
+    .map((utterance, index) => {
+      const startTime = formatSrtTime(utterance.startTime);
+      const endTime = formatSrtTime(utterance.endTime);
+      const speaker = includeSpeakers
+        ? `${getSpeakerName(utterance.speakerId, speakerNames)}: `
+        : '';
+
+      return `${index + 1}\n${startTime} --> ${endTime}\n${speaker}${utterance.text}`;
+    })
+    .join('\n\n');
+}
+
+/**
+ * Export transcript to WebVTT format
+ *
+ * @example Output:
+ * ```
+ * WEBVTT
+ *
+ * 1
+ * 00:00:00.000 --> 00:00:05.500
+ * <v Speaker 1>Hello, welcome to the meeting.
+ * ```
+ */
+export function exportToVtt(
+  utterances: StreamingUtterance[],
+  options: ExportOptions = {},
+): string {
+  const { speakerNames, includeSpeakers = true } = options;
+
+  const header = 'WEBVTT\n\n';
+
+  const cues = utterances
+    .map((utterance, index) => {
+      const startTime = formatVttTime(utterance.startTime);
+      const endTime = formatVttTime(utterance.endTime);
+      const speakerTag = includeSpeakers
+        ? `<v ${getSpeakerName(utterance.speakerId, speakerNames)}>`
+        : '';
+
+      return `${index + 1}\n${startTime} --> ${endTime}\n${speakerTag}${utterance.text}`;
+    })
+    .join('\n\n');
+
+  return header + cues;
+}
+
+/**
+ * Export transcript to plain text format
+ *
+ * @example Output:
+ * ```
+ * Meeting Transcript
+ * Date: 2024-01-15
+ * ==================
+ *
+ * [00:00] Speaker 1:
+ * Hello, welcome to the meeting.
+ *
+ * [00:05] Speaker 2:
+ * Thank you for joining.
+ * ```
+ */
+export function exportToTxt(
+  utterances: StreamingUtterance[],
+  options: ExportOptions = {},
+): string {
+  const {
+    speakerNames,
+    includeTimestamps = true,
+    includeSpeakers = true,
+    title = 'Meeting Transcript',
+    date,
+  } = options;
+
+  const lines: string[] = [];
+
+  // Header
+  lines.push(title);
+  if (date) {
+    lines.push(`Date: ${date.toLocaleDateString()}`);
+  }
+  lines.push('='.repeat(50));
+  lines.push('');
+
+  // Content
+  for (const utterance of utterances) {
+    const timestamp = includeTimestamps
+      ? `[${formatReadableTime(utterance.startTime)}] `
+      : '';
+    const speaker = includeSpeakers
+      ? `${getSpeakerName(utterance.speakerId, speakerNames)}:`
+      : '';
+
+    if (speaker) {
+      lines.push(`${timestamp}${speaker}`);
+      lines.push(utterance.text);
+    } else {
+      lines.push(`${timestamp}${utterance.text}`);
+    }
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Export transcript to JSON format
+ *
+ * Includes all metadata for downstream processing
+ */
+export function exportToJson(
+  utterances: StreamingUtterance[],
+  options: ExportOptions = {},
+): string {
+  const { speakerNames, title, date } = options;
+
+  const data = {
+    title: title || 'Meeting Transcript',
+    exportedAt: new Date().toISOString(),
+    meetingDate: date?.toISOString(),
+    utterances: utterances.map((u) => ({
+      ...u,
+      speakerName: getSpeakerName(u.speakerId, speakerNames),
+    })),
+    summary: {
+      totalUtterances: utterances.length,
+      totalSpeakers: new Set(utterances.map((u) => u.speakerId)).size,
+      totalDurationMs:
+        utterances.length > 0
+          ? Math.max(...utterances.map((u) => u.endTime)) -
+            Math.min(...utterances.map((u) => u.startTime))
+          : 0,
+    },
+  };
+
+  return JSON.stringify(data, null, 2);
+}
+
+/**
+ * Export format type
+ */
+export type ExportFormat = 'srt' | 'vtt' | 'txt' | 'json';
+
+/**
+ * Export transcript to specified format
+ */
+export function exportTranscript(
+  utterances: StreamingUtterance[],
+  format: ExportFormat,
+  options: ExportOptions = {},
+): string {
+  switch (format) {
+    case 'srt':
+      return exportToSrt(utterances, options);
+    case 'vtt':
+      return exportToVtt(utterances, options);
+    case 'txt':
+      return exportToTxt(utterances, options);
+    case 'json':
+      return exportToJson(utterances, options);
+    default:
+      throw new Error(`Unsupported export format: ${format}`);
+  }
+}
+
+/**
+ * Get MIME type for export format
+ */
+export function getExportMimeType(format: ExportFormat): string {
+  switch (format) {
+    case 'srt':
+      return 'application/x-subrip';
+    case 'vtt':
+      return 'text/vtt';
+    case 'txt':
+      return 'text/plain';
+    case 'json':
+      return 'application/json';
+    default:
+      return 'text/plain';
+  }
+}
+
+/**
+ * Get file extension for export format
+ */
+export function getExportExtension(format: ExportFormat): string {
+  return `.${format}`;
+}
+
+/**
+ * Download transcript as file
+ */
+export function downloadTranscript(
+  utterances: StreamingUtterance[],
+  format: ExportFormat,
+  filename: string,
+  options: ExportOptions = {},
+): void {
+  const content = exportTranscript(utterances, format, options);
+  const mimeType = getExportMimeType(format);
+  const extension = getExportExtension(format);
+
+  const blob = new Blob([content], { type: mimeType });
+  const url = URL.createObjectURL(blob);
+
+  const link = document.createElement('a');
+  link.href = url;
+  link.download = filename.endsWith(extension)
+    ? filename
+    : `${filename}${extension}`;
+  document.body.appendChild(link);
+  link.click();
+  document.body.removeChild(link);
+
+  URL.revokeObjectURL(url);
+}

package/template/apps/web/lib/version-mismatch.ts

@@ -0,0 +1,147 @@
+/**
+ * 版本不匹配处理 (前端自愈机制)
+ *
+ * 当后端返回 HTTP 426 (Upgrade Required) 时，触发自愈流程：
+ * 1. 显示更新提示弹窗
+ * 2. 用户确认后清除缓存并刷新
+ * 3. 获取最新版本的前端资源
+ */
+
+import { toast } from 'sonner';
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+const VERSION_MISMATCH_KEY = 'pardx:version_mismatch_shown';
+
+// ============================================================================
+// Error Class
+// ============================================================================
+
+/**
+ * 版本不匹配错误
+ *
+ * 当后端返回 426 状态码时抛出此错误
+ */
+export class VersionMismatchError extends Error {
+  /** 最低兼容的构建版本 */
+  public minBuild: string | null;
+
+  constructor(minBuild: string | null) {
+    super('Client version is outdated');
+    this.name = 'VersionMismatchError';
+    this.minBuild = minBuild;
+  }
+}
+
+// ============================================================================
+// Handler Functions
+// ============================================================================
+
+/**
+ * 处理版本不匹配错误
+ *
+ * @param minBuild 后端要求的最低构建版本
+ */
+export function handleVersionMismatch(minBuild: string | null): void {
+  // 避免重复提示 (同一会话只提示一次)
+  if (typeof sessionStorage !== 'undefined') {
+    if (sessionStorage.getItem(VERSION_MISMATCH_KEY)) {
+      return;
+    }
+    sessionStorage.setItem(VERSION_MISMATCH_KEY, 'true');
+  }
+
+  showUpdateModal({
+    title: '发现新版本',
+    message: '当前版本已过期，需要刷新页面获取最新版本。',
+    minBuild,
+    onConfirm: () => {
+      clearCacheAndReload();
+    },
+  });
+}
+
+/**
+ * 清除缓存并刷新页面
+ */
+export async function clearCacheAndReload(): Promise<void> {
+  // 清除 Service Worker 缓存
+  if (typeof window !== 'undefined' && 'caches' in window) {
+    try {
+      const names = await caches.keys();
+      await Promise.all(names.map((name) => caches.delete(name)));
+    } catch (error) {
+      console.warn('Failed to clear caches:', error);
+    }
+  }
+
+  // 清除版本不匹配标记
+  if (typeof sessionStorage !== 'undefined') {
+    sessionStorage.removeItem(VERSION_MISMATCH_KEY);
+  }
+
+  // 强制刷新页面 (绕过浏览器缓存)
+  if (typeof window !== 'undefined') {
+    window.location.reload();
+  }
+}
+
+// ============================================================================
+// UI Components
+// ============================================================================
+
+interface UpdateModalOptions {
+  title: string;
+  message: string;
+  minBuild: string | null;
+  onConfirm: () => void;
+}
+
+/**
+ * 显示更新提示弹窗
+ */
+function showUpdateModal(options: UpdateModalOptions): void {
+  // 使用 sonner toast 显示提示
+  // 设置 duration: Infinity 保持显示直到用户操作
+  toast.warning(options.title, {
+    description: options.message,
+    duration: Infinity,
+    action: {
+      label: '立即刷新',
+      onClick: options.onConfirm,
+    },
+    // 不允许用户关闭
+    dismissible: false,
+  });
+}
+
+// ============================================================================
+// HTTP Status Check
+// ============================================================================
+
+/**
+ * 检查响应是否为版本不兼容错误
+ *
+ * @param status HTTP 状态码
+ * @returns 是否为 426 Upgrade Required
+ */
+export function isVersionMismatchStatus(status: number): boolean {
+  return status === 426;
+}
+
+/**
+ * 从响应中提取最低兼容版本
+ *
+ * @param headers 响应头
+ * @returns 最低兼容的构建版本
+ */
+export function getMinBuildFromHeaders(
+  headers: Headers | Record<string, string>,
+): string | null {
+  if (headers instanceof Headers) {
+    return headers.get('x-min-app-build');
+  }
+  return headers['x-min-app-build'] || null;
+}

package/template/apps/web/lib/version.ts

@@ -0,0 +1,60 @@
+/**
+ * 前端版本配置
+ *
+ * 用于端到端版本控制，确保前后端版本兼容。
+ *
+ * 构建版本格式: YYYY.MM.DD-<hash>-g<generation>
+ * 示例: 2025.03.18-abcdef-g42
+ */
+
+import { API_VERSION_DEFAULT } from '@repo/constants';
+
+// ============================================================================
+// Version Configuration
+// ============================================================================
+
+/**
+ * 前端版本配置
+ */
+export const APP_VERSION = {
+  /** API 版本号 */
+  apiVersion: process.env.NEXT_PUBLIC_API_VERSION || API_VERSION_DEFAULT,
+  /** 构建版本 (格式: YYYY.MM.DD-hash-gNN) */
+  appBuild: process.env.NEXT_PUBLIC_APP_BUILD || 'dev',
+} as const;
+
+// ============================================================================
+// Utilities
+// ============================================================================
+
+/**
+ * 从构建版本中提取代际号 (generation)
+ *
+ * @param buildVersion 构建版本字符串
+ * @returns 代际号，如果无法解析则返回 0
+ *
+ * @example
+ * extractGeneration("2025.03.18-abcdef-g42") // => 42
+ * extractGeneration("dev") // => 0
+ */
+export function extractGeneration(buildVersion: string): number {
+  const match = buildVersion.match(/-g(\d+)$/);
+  const captured = match?.[1];
+  return captured ? parseInt(captured, 10) : 0;
+}
+
+/**
+ * 获取当前前端的代际号
+ */
+export function getCurrentGeneration(): number {
+  return extractGeneration(APP_VERSION.appBuild);
+}
+
+/**
+ * 比较两个构建版本的代际号
+ *
+ * @returns 负数表示 a < b, 0 表示相等, 正数表示 a > b
+ */
+export function compareGenerations(a: string, b: string): number {
+  return extractGeneration(a) - extractGeneration(b);
+}

package/template/apps/web/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/template/apps/web/next.config.ts

@@ -0,0 +1,97 @@
+import type { NextConfig } from 'next';
+import { execSync } from 'child_process';
+import { API_GENERATION } from '@repo/constants';
+import createNextIntlPlugin from 'next-intl/plugin';
+
+// ============================================================================
+// Build-time Version Generation
+// ============================================================================
+
+/**
+ * 生成构建版本号
+ * 格式: YYYY.MM.DD-<hash>-g<generation>
+ * 示例: 2025.03.18-abcdef-g1
+ */
+function generateAppBuild(): string {
+  const date = new Date().toISOString().slice(0, 10).replace(/-/g, '.');
+
+  let hash = '000000';
+  try {
+    hash = execSync('git rev-parse --short HEAD', { encoding: 'utf-8' }).trim();
+  } catch {
+    // Git not available or not a git repo
+  }
+
+  return `${date}-${hash}-g${API_GENERATION}`;
+}
+
+// Generate build version at build time
+const APP_BUILD = process.env.NEXT_PUBLIC_APP_BUILD || generateAppBuild();
+
+const nextConfig: NextConfig = {
+  // Inject build-time environment variables
+  env: {
+    NEXT_PUBLIC_APP_BUILD: APP_BUILD,
+  },
+  output: 'standalone',
+  /* config options here */
+  experimental: {
+    mcpServer: true,
+  },
+  images: {
+    // 响应式图片尺寸配置
+    deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048],
+    imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
+    // 启用现代图片格式（WebP 和 AVIF）以减少图片体积
+    formats: ['image/avif', 'image/webp'],
+    // 远程图片域名白名单
+    remotePatterns: [
+      {
+        protocol: 'https',
+        hostname: '*.volces.com',
+      },
+      {
+        protocol: 'https',
+        hostname: '*.aliyuncs.com',
+      },
+      {
+        protocol: 'https',
+        hostname: '*.pardx.cn',
+      },
+      {
+        protocol: 'https',
+        hostname: '*.alicdn.com',
+      },
+    ],
+  },
+  // HTML 禁止缓存 - 确保用户始终获取最新版本
+  async headers() {
+    return [
+      {
+        // 匹配所有 HTML 页面（排除静态资源）
+        source: '/:path((?!_next/static|_next/image|favicon.ico).*)',
+        headers: [
+          {
+            key: 'Cache-Control',
+            value: 'no-store, must-revalidate',
+          },
+        ],
+      },
+    ];
+  },
+  // 配置 transpilePackages 以支持 monorepo 包
+  transpilePackages: ['@repo/ui', '@repo/utils', '@repo/types', '@repo/config'],
+  // 配置 serverExternalPackages 以解决依赖打包问题
+  // - shiki: 版本冲突
+  // - pino/thread-stream: Turbopack 错误打包测试文件
+  serverExternalPackages: ['shiki', 'pino', 'thread-stream'],
+  typescript: {
+    // TODO 构建时忽略 TypeScript 错误
+    ignoreBuildErrors: true,
+  },
+};
+
+// 创建 next-intl 插件，指定 i18n 请求配置文件路径
+const withNextIntl = createNextIntlPlugin('./i18n/request.ts');
+
+export default withNextIntl(nextConfig);