Skip to Content
CSO Web์†Œ๊ฐœ

CSO Web

CSO ์ •์‚ฐ ํฌํ„ธ โ€” B2B ์ œ์•ฝ ์ •์‚ฐ ์ˆ˜์ˆ˜๋ฃŒ ์กฐํšŒ ์‹œ์Šคํ…œ (v0.65.0)

๊ฐœ์š”

ํ•ญ๋ชฉ๋‚ด์šฉ
์ŠคํƒNext.js 14 (App Router) + TypeScript + Tailwind CSS + Radix UI
DBSupabase ์…€ํ”„ํ˜ธ์ŠคํŒ… (sb.dvsharp.com, PostgreSQL 15 + RLS)
ํ˜ธ์ŠคํŒ…Vercel (Primary) + Coolify (Secondary, cso.dvsharp.com)
์ธ์ฆ์ž์ฒด JWT (jose) + ์‚ฌ์—…์ž๋ฒˆํ˜ธ ๊ธฐ๋ฐ˜ ๋กœ๊ทธ์ธ
์ด๋ฉ”์ผResend API + SMTP ํ•˜์ด์›์Šค (๋“€์–ผ ํ”„๋กœ๋ฐ”์ด๋”)
๋ฒ„์ „v0.65.0

๋„๋ฉ”์ธ

  • CSO: ์œ„ํƒ์˜์—…(Commissioned Sales Organization) โ€” ์ œ์•ฝ์‚ฌ ๋Œ€์‹  ์˜์•ฝํ’ˆ์„ ์˜์—…ํ•˜๋Š” ์ˆ˜ํƒ์—…์ฒด
  • ์ •์‚ฐ์„œ: SIT์†”๋ฃจ์…˜์—์„œ ์ถ”์ถœํ•œ ์—‘์…€ ๋ฐ์ดํ„ฐ. 1ํ–‰ = 1๊ฑด์˜ ์ฒ˜๋ฐฉ/๊ฑฐ๋ž˜, ์ตœ๋Œ€ 47๊ฐœ ์ปฌ๋Ÿผ

์ฃผ์š” ๊ธฐ๋Šฅ

  • ์‚ฌ์—…์ž๋ฒˆํ˜ธ ๊ธฐ๋ฐ˜ ํšŒ์›๊ฐ€์ž… ๋ฐ ๊ตญ์„ธ์ฒญ NTS(National Tax Service) API ์ž๋™ ์ธ์ฆ
  • ์ •์‚ฐ์„œ ๋ฐ์ดํ„ฐ ์กฐํšŒ ๋ฐ ์—‘์…€ ๋‹ค์šด๋กœ๋“œ
  • CSO ๋งค์นญ (์—‘์…€ ์—…์ฒด๋ช… โ†” ํšŒ์› ์‚ฌ์—…์ž๋ฒˆํ˜ธ ๋งคํ•‘)
  • ํšŒ์› ๊ด€๋ฆฌ (๊ฐ€์ž… ์Šน์ธ/๊ฑฐ๋ถ€, ๋น„๋ฐ€๋ฒˆํ˜ธ ์ดˆ๊ธฐํ™”)
  • ๋ฉ”์ผ๋จธ์ง€ ์ผ๊ด„ ๋ฐœ์†ก (๊ฐœ์ธํ™” ๋ณ€์ˆ˜ ์น˜ํ™˜)
  • ์›”๋ณ„ ์ˆ˜์ˆ˜๋ฃŒ ํ•ฉ๊ณ„ ํ†ต๊ณ„
  • ๊ณต์ง€์‚ฌํ•ญ(Notice) ๊ด€๋ฆฌ ๋ฐ ๋ณ€์ˆ˜ ์น˜ํ™˜

์™ธ๋ถ€ ์—ฐ๋™

CSO ์ •์‚ฐ ํฌํ„ธ์€ ๋‹ค์Œ ์™ธ๋ถ€ ์„œ๋น„์Šค์™€ ์—ฐ๋™๋˜์–ด ์šด์˜๋ฉ๋‹ˆ๋‹ค.

๊ตญ์„ธ์ฒญ NTS API

์‚ฌ์—…์ž๋“ฑ๋ก๋ฒˆํ˜ธ ์ง„์œ„ํ™•์ธ API์ž…๋‹ˆ๋‹ค. ํšŒ์›๊ฐ€์ž… ์‹œ ์‚ฌ์—…์ž๋ฒˆํ˜ธ 10์ž๋ฆฌ๋ฅผ ์ž…๋ ฅํ•˜๋ฉด ๊ตญ์„ธ์ฒญ ๋ฐ์ดํ„ฐ๋กœ ์‹ค์‹œ๊ฐ„ ์ธ์ฆํ•˜์—ฌ ๊ณ„์†์‚ฌ์—…์ž/ํœด์—…์ž/ํ์—…์ž ์ƒํƒœ๋ฅผ ์ž๋™ ํŒ๋ณ„ํ•ฉ๋‹ˆ๋‹ค. ๊ณ„์†์‚ฌ์—…์ž๋งŒ ๊ฐ€์ž…์ด ํ—ˆ์šฉ๋ฉ๋‹ˆ๋‹ค.

HIRA API

๊ฑด๊ฐ•๋ณดํ—˜์‹ฌ์‚ฌํ‰๊ฐ€์›(Health Insurance Review and Assessment Service) API์ž…๋‹ˆ๋‹ค. ๋ณ‘์› ์ •๋ณด ์กฐํšŒ API์™€ ์•ฝ๊ตญ ์ •๋ณด ์กฐํšŒ API ๋‘ ๊ฐ€์ง€๋ฅผ ์‚ฌ์šฉํ•˜๋ฉฐ, ๊ฑฐ๋ž˜์ฒ˜ ์œ ํšจ์„ฑ ๊ฒ€์ฆ์— ํ™œ์šฉ๋ฉ๋‹ˆ๋‹ค.

์ด๋ฉ”์ผ ๋“€์–ผ ํ”„๋กœ๋ฐ”์ด๋”

์ด๋ฉ”์ผ ๋ฐœ์†ก์€ ๋‘ ๊ฐ€์ง€ ํ”„๋กœ๋ฐ”์ด๋”๋ฅผ ๋ณ‘ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

ํ”„๋กœ๋ฐ”์ด๋”์šฉ๋„ํŠน์ง•
Resend API์‹œ์Šคํ…œ ์ž๋™ ๋ฉ”์ผ (๊ฐ€์ž… ์•Œ๋ฆผ, ์Šน์ธ/๊ฑฐ๋ถ€, ๋น„๋ฐ€๋ฒˆํ˜ธ ์žฌ์„ค์ •)ํ™˜๊ฒฝ๋ณ€์ˆ˜ ์„ค์ •๋งŒ์œผ๋กœ ๋™์ž‘, ์•ˆ์ •์ 
SMTP ํ•˜์ด์›์Šค๋ฉ”์ผ๋จธ์ง€ ๋Œ€๋Ÿ‰ ๋ฐœ์†กํ ๊ธฐ๋ฐ˜ ์›Œ์ปค(PM2)๋กœ ์ˆœ์ฐจ ๋ฐœ์†ก, ๋ฐœ์†ก ๊ฐ„๊ฒฉ ์„ค์ • ๊ฐ€๋Šฅ

๊ด€๋ฆฌ์ž๋Š” ์‚ฌ์ดํŠธ ์„ค์ •์—์„œ ํ™œ์„ฑ ํ”„๋กœ๋ฐ”์ด๋”๋ฅผ ์ „ํ™˜ํ•˜๊ฑฐ๋‚˜ SMTP ์„œ๋ฒ„ ์ •๋ณด๋ฅผ ๋ณ€๊ฒฝํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

Supabase ์…€ํ”„ํ˜ธ์ŠคํŒ…

๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค๋Š” Oracle Cloud ์„œ๋ฒ„์— ์…€ํ”„ํ˜ธ์ŠคํŒ…๋œ Supabase(sb.dvsharp.com)๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. PostgreSQL 15 ๊ธฐ๋ฐ˜์ด๋ฉฐ, RLS(Row Level Security)๋กœ ์ผ๋ฐ˜ํšŒ์›์€ ์ž์‚ฌ ๋งค์นญ ๋ฐ์ดํ„ฐ๋งŒ ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ๋„๋ก ์ œ์–ด๋ฉ๋‹ˆ๋‹ค.

๋งค๋‰ด์–ผ

Last updated on