vkc-visa-assessment-engine

设计并实现 Viet K-Connect 签证评估引擎（基于数据库驱动的规则集 JSON 架构 + 版本控制 + 生效日期）。代码中不包含任何硬编码规则。可用于构建 /api/visa/assess 接口，以及管理员对规则集的管理。

SKILL.md

--- frontmatter

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 / categories
•visa_transition_rules: fromVisa→toVisa ruleset JSON + version + effectiveFrom + status(pending|active)
•visa_assessment_models: score→percent mapping / weights JSON + version + status
•visa_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 + save visa_assessments)
•
Admin:
- •Manage visa_catalog
- •Create/update visa_transition_rules (pending)
- •Activate a ruleset version (switch to active)
- •Manage visa_assessment_models version and activation

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)