vkc-docgen-template-engine

设计并实现 Viet K-Connect 文档生成模板引擎（基于数据库驱动的向导式架构 + PDF 渲染规范 + 历史记录 + 存储上传功能）。先从 2 个模板入手，随后可线性扩展至 50 个模板，且全程无需硬编码。

SKILL.md

--- frontmatter

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: 유학생 시간제취업 패키지(시간제취업확인서 + 조건부 요건 준수 확인서 + 통합신청서 선택 포함)