foucui 1.0.1

package/components/QiuCanvasKit/export/html.ts

@@ -0,0 +1,132 @@
+/**
+ * Banner / 画布 HTML 导出（含链接热区）
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+import type { CanvasKitDoc, CanvasKitElement, MergeContext } from '../types'
+import { mergeTemplateText, sortCanvasElements } from '../modules/merge'
+import { downloadBlob } from './png'
+
+const MM_TO_PX = 96 / 25.4
+
+export type ExportHtmlOptions = {
+  fileName?: string
+  title?: string
+  /** 合并后再写死 URL / 文本 */
+  context?: MergeContext | Record<string, string>
+  /** 导出单位：优先 canvas.unit */
+  forceUnit?: 'mm' | 'px'
+}
+
+function canvasSize(doc: CanvasKitDoc, unit: 'mm' | 'px') {
+  const c = doc.canvas
+  if (unit === 'px') {
+    const w = c.widthPx ?? Math.round(c.widthMm * MM_TO_PX)
+    const h = c.heightPx ?? Math.round(c.heightMm * MM_TO_PX)
+    return { w, h, unit: 'px' as const }
+  }
+  return { w: c.widthMm, h: c.heightMm, unit: 'mm' as const }
+}
+
+function esc(s: string) {
+  return String(s || '')
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+}
+
+function resolveAsset(src: string) {
+  return src || ''
+}
+
+function elBoxStyle(el: CanvasKitElement, unit: 'mm' | 'px') {
+  const x = unit === 'px' ? `${Math.round(el.xMm * MM_TO_PX)}px` : `${el.xMm}mm`
+  const y = unit === 'px' ? `${Math.round(el.yMm * MM_TO_PX)}px` : `${el.yMm}mm`
+  const w = unit === 'px' ? `${Math.round(el.wMm * MM_TO_PX)}px` : `${el.wMm}mm`
+  const h = unit === 'px' ? `${Math.round(el.hMm * MM_TO_PX)}px` : `${el.hMm}mm`
+  const transforms: string[] = []
+  if (el.rotation) transforms.push(`rotate(${el.rotation}deg)`)
+  if (el.flipX) transforms.push('scaleX(-1)')
+  if (el.flipY) transforms.push('scaleY(-1)')
+  return `position:absolute;left:${x};top:${y};width:${w};height:${h};z-index:${el.zIndex ?? 1};box-sizing:border-box;${
+    transforms.length ? `transform:${transforms.join(' ')};transform-origin:center center;` : ''
+  }`
+}
+
+function renderElementHtml(el: CanvasKitElement, ctx: MergeContext, unit: 'mm' | 'px'): string {
+  const box = elBoxStyle(el, unit)
+  let inner = ''
+  if (el.type === 'text') {
+    const text = esc(mergeTemplateText(el.text, ctx))
+    const vertical = el.textDirection === 'vertical'
+    inner = `<div style="${box}display:flex;align-items:center;justify-content:flex-start;font-size:${el.fontSize}pt;font-family:${esc(
+      el.fontFamily
+    )};color:${esc(el.color)};white-space:pre-wrap;word-break:break-word;overflow:hidden;${
+      vertical ? 'writing-mode:vertical-rl;text-orientation:upright;' : ''
+    }">${text}</div>`
+  } else if (el.type === 'image' || el.type === 'seal') {
+    const src = esc(resolveAsset(el.src))
+    inner = `<div style="${box}display:flex;align-items:center;justify-content:center;"><img src="${src}" alt="" style="max-width:100%;max-height:100%;object-fit:contain"/></div>`
+  } else if (el.type === 'shape') {
+    const bg = esc(el.background || 'transparent')
+    const opacity = el.opacity != null ? `opacity:${el.opacity};` : ''
+    inner = `<div style="${box}${opacity}background:${bg};border-radius:${el.shape === 'circle' ? '50%' : '0'};"></div>`
+  } else {
+    return ''
+  }
+
+  if (el.link?.href) {
+    const href = esc(mergeTemplateText(el.link.href, ctx))
+    const target = el.link.target === '_self' ? '_self' : '_blank'
+    const rel = target === '_blank' ? ' noopener noreferrer' : ''
+    return `<a href="${href}" target="${target}" rel="${rel.trim()}" style="display:contents;text-decoration:none;color:inherit;">${inner}</a>`
+  }
+  return inner
+}
+
+/** 生成自包含 HTML 字符串（Banner 投放用） */
+export function buildCanvasHtml(doc: CanvasKitDoc, options: ExportHtmlOptions = {}): string {
+  const ctx = (options.context || {}) as MergeContext
+  const unit = options.forceUnit || doc.canvas.unit || (doc.mode === 'banner' ? 'px' : 'mm')
+  const size = canvasSize(doc, unit)
+  const showBorder = doc.canvas.showBorder !== false && doc.mode !== 'banner'
+  const border = showBorder
+    ? `border:${doc.canvas.borderWidthMm || 0.35}mm solid ${esc(doc.canvas.borderColor || '#334155')};`
+    : 'border:none;'
+  const bg = doc.canvas.backgroundImage
+    ? `background-image:url(${esc(doc.canvas.backgroundImage)});background-size:cover;background-position:center;`
+    : `background:${esc(doc.canvas.background || 'transparent')};`
+  const els = sortCanvasElements(doc.elements || [])
+    .map((el) => renderElementHtml(el, ctx, unit))
+    .join('\n')
+
+  const title = esc(options.title || 'Banner')
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8"/>
+<meta name="viewport" content="width=device-width,initial-scale=1"/>
+<title>${title}</title>
+<style>
+  html,body{margin:0;padding:0;background:#f8fafc;}
+  .qiu-canvas-banner{position:relative;overflow:hidden;margin:0 auto;${border}${bg}
+    width:${size.w}${size.unit};height:${size.h}${size.unit};}
+  a{color:inherit;}
+</style>
+</head>
+<body>
+<div class="qiu-canvas-banner">
+${els}
+</div>
+</body>
+</html>`
+}
+
+export function downloadCanvasHtml(doc: CanvasKitDoc, options: ExportHtmlOptions = {}) {
+  const html = buildCanvasHtml(doc, options)
+  const blob = new Blob([html], { type: 'text/html;charset=utf-8' })
+  downloadBlob(blob, options.fileName || `banner-${Date.now()}.html`)
+  return blob
+}

package/components/QiuCanvasKit/export/pdf.ts

@@ -0,0 +1,48 @@
+/**
+ * 画布导出：PDF（单页，基于 html2canvas + jspdf）
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+import { jsPDF } from 'jspdf'
+import { exportElementToPng, downloadBlob } from './png'
+
+export type ExportPdfOptions = {
+  fileName?: string
+  /** mm */
+  widthMm?: number
+  heightMm?: number
+  scale?: number
+}
+
+export async function exportElementToPdf(
+  el: HTMLElement,
+  options: ExportPdfOptions = {}
+): Promise<Blob> {
+  const png = await exportElementToPng(el, { scale: options.scale ?? 2 })
+  const dataUrl = await blobToDataUrl(png)
+  const w = options.widthMm ?? 210
+  const h = options.heightMm ?? 297
+  const pdf = new jsPDF({
+    orientation: w > h ? 'landscape' : 'portrait',
+    unit: 'mm',
+    format: [w, h],
+  })
+  pdf.addImage(dataUrl, 'PNG', 0, 0, w, h)
+  return pdf.output('blob')
+}
+
+export async function downloadElementPdf(el: HTMLElement, options: ExportPdfOptions = {}) {
+  const blob = await exportElementToPdf(el, options)
+  downloadBlob(blob, options.fileName || `canvas-${Date.now()}.pdf`)
+  return blob
+}
+
+function blobToDataUrl(blob: Blob): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader()
+    reader.onload = () => resolve(String(reader.result || ''))
+    reader.onerror = () => reject(reader.error)
+    reader.readAsDataURL(blob)
+  })
+}

package/components/QiuCanvasKit/export/png.ts

@@ -0,0 +1,50 @@
+/**
+ * 画布导出：PNG（基于 DOM 节点 html2canvas）
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+import html2canvas from 'html2canvas'
+
+export type ExportPngOptions = {
+  fileName?: string
+  scale?: number
+  backgroundColor?: string | null
+}
+
+export async function exportElementToPng(
+  el: HTMLElement,
+  options: ExportPngOptions = {}
+): Promise<Blob> {
+  const canvas = await html2canvas(el, {
+    scale: options.scale ?? 2,
+    backgroundColor: options.backgroundColor === undefined ? '#ffffff' : options.backgroundColor,
+    useCORS: true,
+    logging: false,
+  })
+  return new Promise((resolve, reject) => {
+    canvas.toBlob(
+      (blob) => {
+        if (!blob) reject(new Error('PNG export failed'))
+        else resolve(blob)
+      },
+      'image/png',
+      1
+    )
+  })
+}
+
+export function downloadBlob(blob: Blob, fileName: string) {
+  const url = URL.createObjectURL(blob)
+  const a = document.createElement('a')
+  a.href = url
+  a.download = fileName
+  a.click()
+  URL.revokeObjectURL(url)
+}
+
+export async function downloadElementPng(el: HTMLElement, options: ExportPngOptions = {}) {
+  const blob = await exportElementToPng(el, options)
+  downloadBlob(blob, options.fileName || `canvas-${Date.now()}.png`)
+  return blob
+}

package/components/QiuCanvasKit/index.ts

@@ -0,0 +1,20 @@
+/**
+ * QiuCanvasKit — 统一证件 / 桌签 / Banner 画布套件
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+export { default as QiuCanvasEditor } from './QiuCanvasEditor.vue'
+export { default as QiuCanvasRenderer } from './QiuCanvasRenderer.vue'
+export { default as QiuCanvasDataModulesPanel } from './components/DataModulesPanel.vue'
+
+export * from './types'
+export * from './modules/dataRegistry'
+export * from './modules/merge'
+export * from './modules/badgeCompat'
+export * from './presets/badge'
+export * from './presets/banner'
+export * from './export/png'
+export * from './export/pdf'
+export * from './export/html'
+export { resolveAssetUrl } from './assetUrl'

package/components/QiuCanvasKit/modules/badgeCompat.ts

@@ -0,0 +1,84 @@
+/**
+ * 证件套打：扁平行 → 合并表（兼容旧 API）
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+import { mapFlatRowToContext } from './dataRegistry'
+import type { MergeContext } from '../types'
+
+function deriveSchoolShortName(schoolName: string): string {
+  let name = String(schoolName ?? '').trim()
+  if (!name) return ''
+  name = name.replace(/\s+/g, '')
+  name = name.replace(/^[中国中华人民共和國共和国]+/, '')
+  const adminPrefix =
+    /^(?:[^省特别行政区]+省|内蒙古自治区|广西壮族自治区|宁夏回族自治区|新疆维吾尔自治区|西藏自治区|北京市|天津市|上海市|重庆市|香港特别行政区|澳门特别行政区|台湾省|[^市]+市|[^区县旗]+区|[^区县旗]+县|[^区县旗]+旗|[^镇乡街道]+镇|[^镇乡街道]+乡|[^镇乡街道]+街道)/
+  let stripped = true
+  while (stripped && name) {
+    stripped = false
+    const next = name.replace(adminPrefix, '')
+    if (next !== name) {
+      name = next
+      stripped = true
+    }
+  }
+  return name || schoolName.trim()
+}
+
+/** 将接口返回的一条证件记录转为占位符合并表（扁平，兼容旧模板） */
+export function flattenBadgeForMerge(
+  b: Record<string, unknown>,
+  competitionNameFallback?: string
+): Record<string, string> {
+  const cn =
+    (b.competition_name != null ? String(b.competition_name) : '') || (competitionNameFallback ?? '')
+  const schoolName = String(b.school_name ?? '')
+  const schoolShortName =
+    String(b.school_short_name ?? b.school_name_short ?? '').trim() || deriveSchoolShortName(schoolName)
+  return {
+    competition_name: cn,
+    student_name: String(b.student_name ?? ''),
+    competition_no: String(b.competition_no ?? ''),
+    school_name: schoolName,
+    school_short_name: schoolShortName,
+    age_group: String(b.age_group ?? ''),
+    competition_room: String(b.competition_room ?? ''),
+    seat_no: String(b.seat_no ?? ''),
+    floor: String(b.floor ?? ''),
+    teacher_name: String(b.teacher_name ?? ''),
+    date: String(b.date ?? b.competition_date ?? ''),
+    session: String(b.session ?? b.competition_session ?? ''),
+    enroll_teacher_name: String(b.enroll_teacher_name ?? ''),
+    teacher_phone: String(b.teacher_phone ?? ''),
+    signup_teacher_name: String(b.signup_teacher_name ?? ''),
+    signup_teacher_phone: String(b.signup_teacher_phone ?? ''),
+    signup_teacher_department: String(b.signup_teacher_department ?? ''),
+    signup_teacher_position: String(b.signup_teacher_position ?? ''),
+    signup_teacher_id_card: String(b.signup_teacher_id_card ?? ''),
+    signup_teacher_email: String(b.signup_teacher_email ?? ''),
+    signup_teacher_username: String(b.signup_teacher_username ?? ''),
+    venue_name: String(b.venue_name ?? ''),
+    venue_address: String(b.venue_address ?? ''),
+    competition_daily_start: String(b.competition_daily_start ?? ''),
+    competition_daily_end: String(b.competition_daily_end ?? ''),
+  }
+}
+
+export function flattenDeskLabelForMerge(
+  row: Record<string, unknown>,
+  competitionNameFallback?: string
+): Record<string, string> {
+  return flattenBadgeForMerge(row, competitionNameFallback)
+}
+
+/** 扁平行 → 嵌套 context（推荐套打入口） */
+export function mapRowToContext(
+  row: Record<string, unknown>,
+  competitionNameFallback?: string
+): MergeContext {
+  const flat = flattenBadgeForMerge(row, competitionNameFallback)
+  return mapFlatRowToContext(flat, competitionNameFallback)
+}
+
+export { deriveSchoolShortName }

package/components/QiuCanvasKit/modules/dataRegistry.ts

@@ -0,0 +1,207 @@
+/**
+ * 画布数据模块注册：内置模块 + 自定义合并
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+import type { DataModuleDef, MergeContext } from '../types'
+
+/** 旧扁平 key → module.field（兼容期） */
+export const LEGACY_FLAT_KEY_MAP: Record<string, string> = {
+  competition_name: 'competition.name',
+  student_name: 'student.name',
+  competition_no: 'student.competition_no',
+  school_name: 'school.name',
+  school_short_name: 'school.short_name',
+  age_group: 'student.age_group',
+  competition_room: 'classroom.name',
+  seat_no: 'classroom.seat_no',
+  floor: 'classroom.floor',
+  teacher_name: 'teacher.name',
+  date: 'competition.date',
+  session: 'competition.session',
+  enroll_teacher_name: 'teacher.enroll_name',
+  teacher_phone: 'teacher.phone',
+  signup_teacher_name: 'teacher.signup_name',
+  signup_teacher_phone: 'teacher.signup_phone',
+  signup_teacher_department: 'teacher.signup_department',
+  signup_teacher_position: 'teacher.signup_position',
+  signup_teacher_id_card: 'teacher.signup_id_card',
+  signup_teacher_email: 'teacher.signup_email',
+  signup_teacher_username: 'teacher.signup_username',
+  venue_name: 'classroom.venue_name',
+  venue_address: 'classroom.venue_address',
+  competition_daily_start: 'competition.daily_start',
+  competition_daily_end: 'competition.daily_end',
+}
+
+export const BUILTIN_DATA_MODULES: DataModuleDef[] = [
+  {
+    id: 'student',
+    label: '学生',
+    builtin: true,
+    enabled: true,
+    fields: [
+      { key: 'name', label: '姓名' },
+      { key: 'competition_no', label: '参赛编号' },
+      { key: 'age_group', label: '年龄段' },
+    ],
+    sample: { name: '张三', competition_no: 'A001', age_group: '中班' },
+  },
+  {
+    id: 'teacher',
+    label: '教师',
+    builtin: true,
+    enabled: true,
+    fields: [
+      { key: 'name', label: '监考教师' },
+      { key: 'phone', label: '手机' },
+      { key: 'enroll_name', label: '带队教师' },
+      { key: 'signup_name', label: '报名教师' },
+      { key: 'signup_phone', label: '报名教师手机' },
+      { key: 'signup_department', label: '报名教师部门' },
+      { key: 'signup_position', label: '报名教师职务' },
+      { key: 'signup_id_card', label: '报名教师身份证' },
+      { key: 'signup_email', label: '报名教师邮箱' },
+      { key: 'signup_username', label: '报名教师账号' },
+    ],
+    sample: { name: '李老师', phone: '13800000000', signup_name: '王老师' },
+  },
+  {
+    id: 'classroom',
+    label: '教室',
+    builtin: true,
+    enabled: true,
+    fields: [
+      { key: 'name', label: '考场/教室' },
+      { key: 'seat_no', label: '座位号' },
+      { key: 'floor', label: '楼层' },
+      { key: 'venue_name', label: '场地名称' },
+      { key: 'venue_address', label: '场地地址' },
+    ],
+    sample: { name: '301 教室', seat_no: '12', floor: '3F' },
+  },
+  {
+    id: 'school',
+    label: '学校',
+    builtin: true,
+    enabled: true,
+    fields: [
+      { key: 'name', label: '学校全称' },
+      { key: 'short_name', label: '学校简称' },
+    ],
+    sample: { name: '示范幼儿园', short_name: '示范园' },
+  },
+  {
+    id: 'competition',
+    label: '比赛',
+    builtin: true,
+    enabled: true,
+    fields: [
+      { key: 'name', label: '比赛名称' },
+      { key: 'date', label: '比赛日期' },
+      { key: 'session', label: '场次' },
+      { key: 'daily_start', label: '当天开始' },
+      { key: 'daily_end', label: '当天结束' },
+    ],
+    sample: { name: '示例比赛', date: '2026-08-16', session: '上午场' },
+  },
+]
+
+export function cloneBuiltinModules(): DataModuleDef[] {
+  return BUILTIN_DATA_MODULES.map((m) => ({
+    ...m,
+    fields: m.fields.map((f) => ({ ...f })),
+    sample: m.sample ? { ...m.sample } : undefined,
+  }))
+}
+
+/** 合并内置 + 模板/业务传入模块 */
+export function resolveDataModules(
+  override?: DataModuleDef[] | null,
+  docModules?: DataModuleDef[] | null
+): DataModuleDef[] {
+  const map = new Map<string, DataModuleDef>()
+  for (const m of cloneBuiltinModules()) map.set(m.id, m)
+  for (const m of override || []) {
+    const prev = map.get(m.id)
+    map.set(m.id, prev ? { ...prev, ...m, fields: m.fields?.length ? m.fields : prev.fields } : { ...m })
+  }
+  for (const m of docModules || []) {
+    const prev = map.get(m.id)
+    map.set(m.id, prev ? { ...prev, ...m, fields: m.fields?.length ? m.fields : prev.fields } : { ...m })
+  }
+  return [...map.values()].filter((m) => m.enabled !== false)
+}
+
+export function placeholderToken(moduleId: string, fieldKey: string) {
+  return `{{${moduleId}.${fieldKey}}}`
+}
+
+export function listInsertableFields(modules: DataModuleDef[]) {
+  const out: { moduleId: string; moduleLabel: string; key: string; label: string; token: string }[] = []
+  for (const m of modules) {
+    for (const f of m.fields) {
+      out.push({
+        moduleId: m.id,
+        moduleLabel: m.label,
+        key: f.key,
+        label: f.label,
+        token: placeholderToken(m.id, f.key),
+      })
+    }
+  }
+  return out
+}
+
+/** 用模块 sample 拼预览上下文 */
+export function sampleContextFromModules(modules: DataModuleDef[]): MergeContext {
+  const ctx: MergeContext = {}
+  for (const m of modules) {
+    ctx[m.id] = { ...(m.sample || {}) }
+  }
+  return ctx
+}
+
+/**
+ * 旧扁平行 → 嵌套 context（套打时）
+ * 同时保留扁平 key，便于兼容旧模板。
+ */
+export function mapFlatRowToContext(
+  row: Record<string, unknown>,
+  competitionNameFallback?: string
+): MergeContext {
+  const flat: Record<string, string> = {}
+  for (const [k, v] of Object.entries(row)) {
+    if (v == null) continue
+    flat[k] = String(v)
+  }
+  if (!flat.competition_name && competitionNameFallback) {
+    flat.competition_name = competitionNameFallback
+  }
+  const ctx: MergeContext = { ...flat }
+  for (const [flatKey, path] of Object.entries(LEGACY_FLAT_KEY_MAP)) {
+    const [mod, field] = path.split('.')
+    const val = flat[flatKey] ?? ''
+    if (!ctx[mod] || typeof ctx[mod] === 'string') ctx[mod] = {}
+    ;(ctx[mod] as Record<string, string>)[field] = val
+  }
+  return ctx
+}
+
+export function createCustomModule(label: string, fields?: DataModuleDef['fields']): DataModuleDef {
+  const id = `custom_${Date.now().toString(36)}`
+  return {
+    id,
+    label: label || '自定义模块',
+    builtin: false,
+    enabled: true,
+    fields: fields?.length
+      ? fields
+      : [
+          { key: 'name', label: '名称' },
+          { key: 'value', label: '值' },
+        ],
+    sample: { name: '示例', value: '123' },
+  }
+}

package/components/QiuCanvasKit/modules/merge.ts

@@ -0,0 +1,71 @@
+/**
+ * 模板占位符合并：支持 {{module.field}} 与旧扁平 {{student_name}}
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+import type { MergeContext } from '../types'
+import { LEGACY_FLAT_KEY_MAP } from './dataRegistry'
+
+function lookupPath(ctx: MergeContext, path: string): string {
+  const parts = path.split('.').filter(Boolean)
+  if (parts.length === 1) {
+    const v = ctx[parts[0]]
+    if (v == null) return ''
+    if (typeof v === 'string') return v
+    return ''
+  }
+  if (parts.length >= 2) {
+    const mod = ctx[parts[0]]
+    if (mod && typeof mod === 'object') {
+      const v = (mod as Record<string, string>)[parts[1]]
+      return v != null && v !== '' ? String(v) : ''
+    }
+  }
+  return ''
+}
+
+function resolveToken(ctx: MergeContext, raw: string): string {
+  const key = String(raw || '').trim()
+  if (!key) return ''
+
+  // 新式：module.field
+  if (key.includes('.')) {
+    const nested = lookupPath(ctx, key)
+    if (nested) return nested
+  }
+
+  // 扁平：student_name
+  const flat = ctx[key]
+  if (typeof flat === 'string' && flat !== '') return flat
+
+  // 旧扁平 → 新路径
+  const mapped = LEGACY_FLAT_KEY_MAP[key]
+  if (mapped) {
+    const via = lookupPath(ctx, mapped)
+    if (via) return via
+  }
+
+  return ''
+}
+
+/**
+ * 合并模板文本。
+ * context 可为嵌套模块对象，也可混入扁平 string 字段。
+ */
+export function mergeTemplateText(text: string, context: MergeContext | Record<string, string>): string {
+  if (!text) return ''
+  const ctx = context as MergeContext
+  return text.replace(/\{\{\s*([a-zA-Z0-9_.]+)\s*\}\}/g, (_, k: string) => resolveToken(ctx, k))
+}
+
+/** @deprecated 使用 mergeTemplateText；保留旧名兼容 */
+export function mergeBadgeText(text: string, data: Record<string, string>) {
+  return mergeTemplateText(text, data)
+}
+
+export function sortCanvasElements<T extends { zIndex?: number }>(els: T[]): T[] {
+  return [...els].sort((a, b) => (a.zIndex ?? 0) - (b.zIndex ?? 0))
+}
+
+export { sortCanvasElements as sortBadgeElements }

package/components/QiuCanvasKit/presets/badge.ts

@@ -0,0 +1,67 @@
+/**
+ * 证件场景默认占位符列表（旧扁平 key，兼容）
+ * @author qiuye
+ * @email yjk150@qq.com
+ * @date 2026-08-16
+ */
+export const BADGE_PLACEHOLDER_KEYS = [
+  'competition_name',
+  'student_name',
+  'competition_no',
+  'school_name',
+  'school_short_name',
+  'age_group',
+  'competition_room',
+  'seat_no',
+  'floor',
+  'teacher_name',
+  'date',
+  'session',
+  'enroll_teacher_name',
+  'teacher_phone',
+  'signup_teacher_name',
+  'signup_teacher_phone',
+  'signup_teacher_department',
+  'signup_teacher_position',
+  'signup_teacher_id_card',
+  'signup_teacher_email',
+  'signup_teacher_username',
+  'venue_name',
+  'venue_address',
+  'competition_daily_start',
+  'competition_daily_end',
+] as const
+
+export type BadgePlaceholderKey = (typeof BADGE_PLACEHOLDER_KEYS)[number]
+
+export const BADGE_PLACEHOLDER_LABELS: Record<string, string> = {
+  competition_name: '比赛名称',
+  student_name: '学生姓名',
+  competition_no: '参赛编号',
+  school_name: '学校',
+  school_short_name: '学校简称',
+  age_group: '年龄段',
+  competition_room: '考场/教室',
+  seat_no: '座位号',
+  floor: '楼层',
+  teacher_name: '监考教师',
+  date: '比赛日期',
+  session: '场次',
+  enroll_teacher_name: '报名/带队教师（扩展）',
+  teacher_phone: '教师手机（扩展）',
+  signup_teacher_name: '报名教师姓名',
+  signup_teacher_phone: '报名教师手机',
+  signup_teacher_department: '报名教师部门',
+  signup_teacher_position: '报名教师职务',
+  signup_teacher_id_card: '报名教师身份证',
+  signup_teacher_email: '报名教师邮箱',
+  signup_teacher_username: '报名教师账号',
+  venue_name: '场地名称',
+  venue_address: '场地地址',
+  competition_daily_start: '比赛当天开始时间',
+  competition_daily_end: '比赛当天结束时间',
+}
+
+export const DESK_LABEL_PLACEHOLDER_KEYS = BADGE_PLACEHOLDER_KEYS
+export type DeskLabelPlaceholderKey = BadgePlaceholderKey
+export const DESK_LABEL_PLACEHOLDER_LABELS: Record<string, string> = BADGE_PLACEHOLDER_LABELS