vkc-visa-assessment-engine
设计和实现越南 K-Connect 签证评估引擎(数据库驱动的规则集 JSON 模式 + 版本控制 + 有效日期)。代码中没有硬编码规则。用于构建 /api/visa/assess 和管理规则集管理。
📖 中文导读:设计和实现越南 K-Connect 签证评估引擎(数据库驱动的规则集 JSON 模式 + 版本控制 + 有效日期)。代码中没有硬编码规则。用于构建 /api/visa/assess 和管理规则集管理。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: vkc-visa-assessment-engine description: Design and implement the Viet K-Connect visa assessment engine (DB-driven ruleset JSON schema + versioning + effective dates). No hardcoded rules in code. Use for building /api/visa/assess and admin ruleset management. metadata: short-description: Visa assessment engine (DB-driven)
VKC Visa Assessment Engine (P1)
Goal
Provide “비자변경 가능성(%)” outputs at scale (cover target-customer visas) while keeping maintenance data-driven:
- rules/weights live in DB (versioned + effective dates)
- code is a stable evaluator + storage + admin activation workflow
Non‑negotiable
- No hardcoding rules in TypeScript. Rules belong to DB rows as JSON.
Core data model (minimum)
visa_catalog: visa codes / labels / categoriesvisa_transition_rules:fromVisa→toVisaruleset JSON +version+effectiveFrom+status(pending|active)visa_assessment_models: score→percent mapping / weights JSON + version + statusvisa_assessments: user assessment history (probabilityPercent,grade,missing,risks,createdAt)
Required interfaces
- Ruleset JSON schema (validate before activation)
.codex/skills/vkc-visa-assessment-engine/references/ruleset-schema.json
- API response schema (persist + return)
.codex/skills/vkc-visa-assessment-engine/references/response-schema.json
API + admin workflow (recommended)
- User:
POST /api/visa/assess(auth + 1/day + savevisa_assessments)
- Admin:
- Manage
visa_catalog - Create/update
visa_transition_rules(pending) - Activate a ruleset version (switch to active)
- Manage
visa_assessment_modelsversion and activation
- Manage
STEP3 visa registry (SoT)
- “전체 커버” visa code registry lives in:
docs/STEP3_SOT_RESOURCES.md - Implementation rule: registry is complete first → rulesets are filled in iteratively (v1→vN)