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