feat(viewer): vite vue3 scaffold with routing and i18n

- apps/viewer (@photo/viewer): Vite 5 + Vue 3.4 + TS 最小骨架（无 Pinia/UI 库） - router: /a/:token 活动页 + /a/:token/p/:photoId 单图深链（复用活动页组件） - i18n: vue-i18n 9，zh-CN/en 词条，localStorage(viewer.locale) 持久 + navigator.language 检测兜底 zh-CN；顶栏语言切换组件；文案全量走 i18n - api client: 类型化 fetch 封装（契约生成类型直连），错误信封 → ApiError，错误码 → i18n key 映射表（src/api/errors.ts） - scripts: dev/build/preview/test(vitest 10 例)/test:e2e(Playwright 冒烟, webServer 自拉 dev)/lint/vue-tsc 全部接入 turbo - root: +@playwright/test、+eslint-plugin-vue（flat config 收敛到 apps/**/*.vue）、 pnpm.onlyBuiltDependencies 放行 esbuild Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-18 09:12:45 +08:00
parent 8ba98ace63
commit f9cb72ed06
24 changed files with 2396 additions and 6 deletions
@@ -0,0 +1,43 @@
+import { createI18n } from 'vue-i18n';
+import en from './locales/en';
+import zhCN from './locales/zh-CN';
+
+export const LOCALE_STORAGE_KEY = 'viewer.locale';
+export const SUPPORTED_LOCALES = ['zh-CN', 'en'] as const;
+export type ViewerLocale = (typeof SUPPORTED_LOCALES)[number];
+export const FALLBACK_LOCALE: ViewerLocale = 'zh-CN';
+
+function isSupported(value: string): value is ViewerLocale {
+  return (SUPPORTED_LOCALES as readonly string[]).includes(value);
+}
+
+// 持久化优先（localStorage），其次浏览器语言（zh*/en 前缀），兜底 zh-CN。
+function resolveInitialLocale(): ViewerLocale {
+  try {
+    const stored = localStorage.getItem(LOCALE_STORAGE_KEY);
+    if (stored !== null && isSupported(stored)) return stored;
+  } catch {
+    // localStorage 不可用（隐私模式等）——退回浏览器语言检测
+  }
+  const nav = typeof navigator !== 'undefined' ? navigator.language : '';
+  if (nav.startsWith('zh')) return 'zh-CN';
+  if (nav.startsWith('en')) return 'en';
+  return FALLBACK_LOCALE;
+}
+
+export const i18n = createI18n({
+  legacy: false,
+  locale: resolveInitialLocale(),
+  fallbackLocale: FALLBACK_LOCALE,
+  messages: { 'zh-CN': zhCN, en },
+});
+
+// 切换语言并持久化；写失败不阻断切换。
+export function setLocale(locale: ViewerLocale): void {
+  i18n.global.locale.value = locale;
+  try {
+    localStorage.setItem(LOCALE_STORAGE_KEY, locale);
+  } catch {
+    // 忽略持久化失败
+  }
+}
@@ -0,0 +1,20 @@
+export default {
+  app: { title: 'Live Gallery' },
+  home: { hint: 'Open an album link to start viewing' },
+  album: { emptyNotice: 'Photos coming soon' },
+  lang: { switch: 'Switch language' },
+  route: { tokenLabel: 'Album token', photoLabel: 'Photo' },
+  errors: {
+    albumNotFound: 'Album not found',
+    albumNotAvailable: 'Album unavailable',
+    photoNotFound: 'Photo not found',
+    notFound: 'Page not found',
+    authExpired: 'Session expired',
+    forbidden: 'Access denied',
+    rateLimited: 'Too many requests, please try again later',
+    validationFailed: 'Invalid request',
+    internal: 'Service temporarily unavailable, please try again later',
+    unknown: 'Something went wrong, please try again later',
+    network: 'Network error, please check your connection',
+  },
+};
@@ -0,0 +1,20 @@
+export default {
+  app: { title: '现场相册' },
+  home: { hint: '打开相册链接即可观看' },
+  album: { emptyNotice: '照片即将上线' },
+  lang: { switch: '切换语言' },
+  route: { tokenLabel: '相册令牌', photoLabel: '照片' },
+  errors: {
+    albumNotFound: '相册不存在',
+    albumNotAvailable: '相册不可用',
+    photoNotFound: '照片不存在',
+    notFound: '页面不存在',
+    authExpired: '登录已过期',
+    forbidden: '没有权限',
+    rateLimited: '操作过于频繁，请稍后再试',
+    validationFailed: '请求参数有误',
+    internal: '服务暂时不可用，请稍后再试',
+    unknown: '出错了，请稍后再试',
+    network: '网络连接失败，请检查网络',
+  },
+};