Front / Backend 와이어프레임

🏗️ 시스템 전체도

📱 FRONT — 7화면

🖥️ ADMIN — 5화면 (Basic Auth · 나만)

① 대시보드 /admin

② 리드 /admin/leads

③ 제휴 /admin/partners

④ 진행 /admin/registrations

⑤ 설정 /admin/settings

🗄️ DB 스키마 — 테이블 5개

-- ① 리드: 견적기에 들어온 모든 흔적 (중도이탈 포함)
CREATE TABLE leads (
  id            TEXT PRIMARY KEY,        -- uuid
  created_at    INTEGER NOT NULL,
  updated_at    INTEGER NOT NULL,
  hook          TEXT,                    -- 'h1'~'h5'  A/B 추적
  source        TEXT,                    -- search|customs|agency|assoc|direct
  referrer      TEXT,
  category      TEXT,                    -- cosmetic|food|supplement|device|goods|unknown
  sku_bucket    TEXT,                    -- '1-5'|'6-10'|'11-30'|'30+'
  voucher       TEXT,                    -- selected|planned|unknown
  step          INTEGER DEFAULT 1,       -- 1|2|3|4(완료)  ← 이탈 분석의 핵심
  company       TEXT,
  phone         TEXT,
  email         TEXT,
  memo          TEXT,
  status        TEXT DEFAULT 'new'       -- new|contacted|quoted|won|lost
);
CREATE INDEX idx_leads_status ON leads(status, updated_at);
CREATE INDEX idx_leads_voucher ON leads(voucher, step);

-- ② 견적: 계산 결과 스냅샷 (규칙이 바뀌어도 과거 견적은 그대로)
CREATE TABLE quotes (
  id            TEXT PRIMARY KEY,
  lead_id       TEXT NOT NULL REFERENCES leads(id),
  created_at    INTEGER NOT NULL,
  category      TEXT, sku_count INTEGER,
  total_krw     INTEGER,                 -- 총 비용
  voucher_krw   INTEGER,                 -- 정부 70% 부담분
  self_krw      INTEGER,                 -- 고객 실부담
  days_min      INTEGER, days_max INTEGER,
  rules_json    TEXT                     -- 계산 당시 규칙 원본 (재현용)
);

-- ③ 제휴처
CREATE TABLE partners (
  id            TEXT PRIMARY KEY,
  name          TEXT NOT NULL,
  type          TEXT,                    -- customs|forwarder|agency|assoc|media
  field         TEXT,                    -- 수행기관 분야 (겹침 판정용)
  contact       TEXT, phone TEXT, email TEXT,
  stage         TEXT DEFAULT 'listed',   -- listed|contacted|talking|partnered|dead
  intro_count   INTEGER DEFAULT 0,       -- 이 곳이 소개해준 건수 = 성과
  last_touch_at INTEGER, memo TEXT
);

-- ④ 계약 고객
CREATE TABLE clients (
  id            TEXT PRIMARY KEY,
  lead_id       TEXT REFERENCES leads(id),
  company       TEXT NOT NULL, biz_no TEXT,
  contract_at   INTEGER,
  amount_krw    INTEGER,
  channel       TEXT,                    -- direct|voucher  ← 수임한도 집계에 필수
  thai_holder   TEXT,                    -- 태국 등록 명의 보유처
  partner_id    TEXT REFERENCES partners(id)  -- 소개처
);

-- ⑤ 인허가 진행 (SKU 단위)
CREATE TABLE registrations (
  id            TEXT PRIMARY KEY,
  client_id     TEXT NOT NULL REFERENCES clients(id),
  product_name  TEXT NOT NULL, sku_code TEXT,
  doc_ingredients INTEGER DEFAULT 0,     -- 전성분표
  doc_cfs         INTEGER DEFAULT 0,     -- 판매증명서
  doc_translation INTEGER DEFAULT 0,
  doc_label       INTEGER DEFAULT 0,     -- 태국어 11항목
  doc_submitted   INTEGER DEFAULT 0,
  status        TEXT DEFAULT 'preparing',-- preparing|submitted|review|approved|rejected
  submitted_at  INTEGER, approved_at INTEGER,
  reject_reason TEXT
);

🔌 라우트 — 13개 (그중 /api/* 8개)

공개 API 5개는 인증 없음. 대신 레이트 리밋(IP당 분당 20회)만 겁니다.

⚙️ 견적 엔진 — 실제 조사값으로 만든 규칙표

이 표가 곧 코드입니다. ✓ 는 이 세션에서 확인한 값, ⚠ 는 설계값.

계산식

// 1밧 ≈ 42원 (설정에서 수정 가능)
const RULES = {
  cosmetic: {
    govFeeTHB: 1000,          // 제품당 ✓
    agencyTHB: 6000,          // SKU당 민간 대행 시세 ✓
    holderTHB: 18000,         // 명의 보유 연회비 ✓
    daysMin: 3, daysMax: 3,   // 서류 완비 후 영업일 ✓
    prepWeeks: 6,             // 서류 준비 포함 ⚠
    docs: ['전성분표','CFS','LOA','제조증명','라벨'],
    warn: '태국은 등록 명의 이전 절차가 없습니다'
  },
  device: { daysMin: 60, daysMax: 180, needs: ['ISO13485','CSDT(영문)'], hard: true },
  goods:  { govFeeTHB: 0, note: 'TISI 대상 아니면 인증 불필요 · 관세+VAT 7%' },
  // food, supplement …
}

function quote(category, skuCount) {
  const r = RULES[category]
  const cost   = (r.govFeeTHB + r.agencyTHB) * skuCount + r.holderTHB
  const service = SERVICE_FEE[category](skuCount)   // ⚠ 내 수수료 (설계값)
  const total   = (cost * THB_KRW) + service
  return {
    total,
    voucher: Math.round(total * 0.7),   // 중소기업 정부보조 70% ✓
    self:    Math.round(total * 0.3),
    daysMin: r.daysMin, daysMax: r.daysMax,
    docs: r.docs, warn: r.warn
  }
}

🚀 배포 구조 · 개발 순서

왜 이 스택인가 — 2026-08-29 결정

배포 구조

thai-permit.kr  (도메인 1개 · Workers 1개)

src/index.ts            ← Hono 앱 (라우트 13개)
public/                  ← 정적 자산 (Workers Assets)
  ├─ index.html          랜딩 (훅 ?h=1~5)
  ├─ quote.html          견적 3스텝 — 순수 JS
  └─ guide/*.html        ← 마크다운 빌드 스크립트 20줄

wrangler.jsonc
{
  "name": "thai-permit",
  "main": "src/index.ts",
  "compatibility_date": "2026-08-01",
  "assets": { "directory": "./public", "binding": "ASSETS" },
  "d1_databases": [{ "binding": "DB", "database_name": "thai-permit" }],
  "vars": { "THB_KRW": "42" }
}
// secrets (wrangler secret put)
//   TG_TOKEN, TG_CHAT       텔레그램 알림
//   ADMIN_USER, ADMIN_PASS  Basic Auth
//   ANTHROPIC_KEY           AI 처리

개발 순서 — 이 순서를 지켜야 낭비가 없습니다