🛠️ 봉이 여행 eSIM — 개발 명세 (프론트·어드민 샘플)

// 데이터 흐름 [고객 프론트 client/src/pages/esim/] │ fetch /api/esim/* ▼ [Express routes/esim.js] ──▶ [services/esimProvider.js // 어댑터(Mock→실API)] │ │ ESIM_PROVIDER 플래그로 mock|cmlink|esimaccess 선택 ▼ ▼ [Supabase cs.esim_*] [공급사 API (CMLink/eSIM Access)] product·option·order products/plans/options/order │ ▼ [어드민 docs/esim-admin.html] // 상품 동기화·마진·주문/발급 현황

create table cs.esim_products ( id bigserial primary key, provider text, -- 'cmlink'|'esimaccess'|'mock' provider_pid text, -- 공급사 상품ID destination text, -- '일본','유럽 42개국' dest_type text, -- 'single'|'multiple' supplier text, carrier text, -- 'CMI-DW', 'Softbank/KDDI' keyword text, -- 검색용(도쿄;오사카…) is_active boolean default true, synced_at timestamptz ); create table cs.esim_options ( id bigserial primary key, product_id bigint references cs.esim_products, provider_oid text, -- 공급사 옵션ID(주문 시 사용) name text, -- '5일 / 완전 무제한' days int, data_type text, -- 'unlimited'|'fixed' quota_text text, is_unlimited boolean, wholesale_usd numeric, -- 도매(계약 후 채움, 없으면 null) fx_rate numeric, margin_rate numeric, -- 정책 fetch retail_krw int, -- 소매가(계산 or 수동) is_hotspot boolean, free_googlemap boolean, care_amount int -- 유심사 벤치 ); create table cs.esim_orders ( id bigserial primary key, customer_id bigint, option_id bigint references cs.esim_options, retail_krw int, status text, -- 'paid'|'provisioning'|'active'|'failed' provider_oid text, provider_order_id text, qr_url text, install_code text, -- LPA:1$... eSIM 프로파일 ordered_at timestamptz, activated_at timestamptz );

// res 200 { "data": [ { "id":1, "destination":"일본", "dest_type":"single", "from_krw":1500, "keyword":"도쿄;오사카" }, { "id":2, "destination":"유럽 42개국", "dest_type":"multiple", "from_krw":1700 } ] }

// res 200 { "data": [ { "id":11, "name":"5일 / 완전 무제한", "days":5, "data_type":"unlimited", "retail_krw":16100, "is_hotspot":true, "free_googlemap":true, "care_amount":300000 }, { "id":12, "name":"1일 / 2GB", "days":1, "data_type":"fixed", "retail_krw":2600 } ] }

// req { "option_id":11, "email":"user@x.com", "payment_token":"..." } // res 200 { "order_id":1001, "status":"active", "qr_url":"https://.../qr/1001.png", "install_code":"LPA:1$smdp..." }

// env ESIM_PROVIDER=mock|cmlink|esimaccess const providers = { mock, cmlink, esimaccess }; export const esim = providers[process.env.ESIM_PROVIDER || 'mock']; // --- mock 어댑터 (계약 전 전 기능 개발용) --- const mock = { async listDestinations() { return [{id:1,destination:'일본',from_krw:1500}]; }, async listOptions(destId) { return [{id:11,name:'5일/무제한',retail_krw:16100}]; }, async order(optionId, customer) { return { order_id: Date.now(), status:'active', qr_url:'https://mock/qr.png', install_code:'LPA:1$mock' }; }, async status(orderId) { return { status:'active' }; } }; // --- cmlink 어댑터 (계약 후: 실 API 호출로 동일 인터페이스 구현) --- const cmlink = { async listOptions(destId){ const r=await fetch(CMLINK_API+..., {headers:{Authorization:key}}); ... } // order/status 동일 시그니처 };

function OptionList({ destId }) { const [opts, setOpts] = useState([]); useEffect(() => { api.get(`/esim/products/${destId}/options`).then(r=>setOpts(r.data)); }, [destId]); return opts.map(o => ( <OptionCard key={o.id} title={o.name} price={o.retail_krw} badges={[o.free_googlemap&&'구글맵무료', o.care_amount&&'안심케어'].filter(Boolean)} onSelect={() => nav(`/esim/checkout?option=${o.id}`)} /> )); }