vkc-docgen-template-engine

设计和实现Viet K-Connect文档生成模板引擎(数据库驱动的向导架构+ PDF渲染规范+历史记录+存储上传)。从2个模板开始,线性扩展到50个,不硬编码。

📖 中文导读:设计和实现Viet K-Connect文档生成模板引擎(数据库驱动的向导架构+ PDF渲染规范+历史记录+存储上传)。从2个模板开始,线性扩展到50个,不硬编码。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: vkc-docgen-template-engine description: Design and implement the Viet K-Connect document generation template engine (DB-driven wizard schema + PDF renderSpec + history + Storage upload). Start with 2 templates and scale linearly to 50 without hardcoding. metadata: short-description: Docgen template engine (DB-driven)

VKC Docgen Template Engine (P1)

Goal

Generate official-form PDFs (starting with unified application + international student part-time work package) from:

  • template schema (wizard fields/steps/i18n labels)
  • renderSpec (PDF mapping)
  • deterministic generator + storage history

Non‑negotiable

  • Templates are data-driven:
    • template schema and renderSpec stored in DB (versioned)
    • code is a stable renderer/evaluator

Core data model (minimum)

  • document_templates: (docType, purpose, version, schemaJson, renderSpecJson, isActive)
  • generated_documents: history + filePath + normalizedFieldsJson + timestamps
  • Storage: Supabase private bucket + signed URL download

Schemas / specs

  • Template schema JSON:
    • .codex/skills/vkc-docgen-template-engine/references/template-schema.json
  • PDF renderSpec reference:
    • .codex/skills/vkc-docgen-template-engine/references/pdf-render-spec.md

Integration points

  • UI uses WizardKit and drives fields from schemaJson.
  • API route POST /api/documents/generate:
    • auth + 1/day limit
    • load active template
    • validate payload
    • render PDF
    • upload to private storage
    • save history row

STEP3 templates (SoT)

  • Official originals + file IDs: docs/STEP3_SOT_RESOURCES.md
  • v1 doc types
    • docgen_unified: 통합신청서(신고서)
    • docgen_parttime: 유학생 시간제취업 패키지(시간제취업확인서 + 조건부 요건 준수 확인서 + 통합신청서 선택 포함)