Skip to content
Projects

sirini/tsboard has 108 GitHub stars and 12 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and 0 in 15 days. Last checked 2026-11-17 02:43 UTC. Last push 2026-08-30.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
0
in 15 days
0
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Community Management System

Web & Apps

README.md

Original

๐Ÿชถ TSBOARD

version license stars

TSBOARD๋Š” ์ž‘์€ ์„œ๋ฒ„์™€ ์‚ฌ๋‚ด๋ง์—์„œ๋„ ๊ฐ€๋ณ๊ฒŒ ์šด์˜ํ•  ์ˆ˜ ์žˆ๋Š” SPA ์ปค๋ฎค๋‹ˆํ‹ฐ ํ”„๋ŸฐํŠธ์—”๋“œ์ž…๋‹ˆ๋‹ค. Vue 3, shadcn-vue ์Šคํƒ€์ผ ์ปดํฌ๋„ŒํŠธ์™€ GOAPI๋ฅผ ์‚ฌ์šฉํ•˜๋ฉฐ, ๊ฒŒ์‹œํŒยท์‚ฌ์ง„ยท๋ธ”๋กœ๊ทธยท๊ฑฐ๋ž˜ ์ฝ˜ํ…์ธ ๋ฅผ Reddit๊ณผ ๊ฐ™์€ ํ•˜๋‚˜์˜ ์Šค๋ ˆ๋“œ ์ค‘์‹ฌ ํ™”๋ฉด์œผ๋กœ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

๋ฌธ์„œ ๊ธฐ์ค€: 2026-08-28 ยท ํ†ตํ•ฉ ๋ฒ„์ „: TSBOARD/GOAPI 1.3.0 ยท API contract: 1

TSBOARD๋Š” NUBO์˜ ์ „์‹ ์ด์ง€๋งŒ v1.3.0๋ถ€ํ„ฐ ์—ญํ• ์ด ๋ถ„๋ช…ํžˆ ๋‹ค๋ฆ…๋‹ˆ๋‹ค. NUBO๊ฐ€ SSR, SEO์™€ ์Šคํ‚จ ์ƒํƒœ๊ณ„๋ฅผ ํฌํ•จํ•œ ์™„์„ฑํ˜• ์ปค๋ฎค๋‹ˆํ‹ฐ ๋นŒ๋”๋ผ๋ฉด, TSBOARD๋Š” ๊ณ ์ •๋œ ํ•œ ๊ฐ€์ง€ UI๋ฅผ ์ •์  ํŒŒ์ผ๋กœ ๋ฐฐํฌํ•˜๋Š” ์ž‘์€ ๋Œ€์•ˆ์ž…๋‹ˆ๋‹ค. ๋‘ ํ”„๋กœ์ ํŠธ๋Š” ๊ฐ™์€ GOAPI ๊ณ„์•ฝ์„ ์‚ฌ์šฉํ•˜์ง€๋งŒ ์„œ๋กœ์˜ ์†Œ์Šค๋‚˜ ๋นŒ๋“œ ๊ฒฐ๊ณผ๋ฅผ ์ˆ˜์ •ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

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

  • Redditํ˜• ํ™ˆ ํ”ผ๋“œ, ์ปค๋ฎค๋‹ˆํ‹ฐ ๋ชฉ๋ก, ๊ฒŒ์‹œ๋ฌผ ์Šค๋ ˆ๋“œ์™€ ์ค‘์ฒฉ ๋Œ“๊ธ€
  • ์ผ๋ฐ˜ ๊ฒŒ์‹œํŒ, ๊ฐค๋Ÿฌ๋ฆฌ, ๋ธ”๋กœ๊ทธ, ์›น์ง„๊ณผ ์ค‘๊ณ ๊ฑฐ๋ž˜ ๋ฐ์ดํ„ฐ ์ง€์›
  • ๊ธ€์“ฐ๊ธฐยท์ˆ˜์ •, Tiptap 3 ๋ณธ๋ฌธ ํŽธ์ง‘, ์ด๋ฏธ์ง€ ์‚ฝ์ž…, ์ฒจ๋ถ€ํŒŒ์ผ๊ณผ ๋กœ์ปฌ ์ž„์‹œ ์ €์žฅ
  • HttpOnly ์ฟ ํ‚ค ๋กœ๊ทธ์ธ, ์„ธ์…˜ ์ž๋™ ๊ฐฑ์‹ , ์ด๋ฉ”์ผ ์ธ์ฆยท์ดˆ๋Œ€ ๊ฐ€์ž…๊ณผ OAuth ๋กœ๊ทธ์ธ
  • ํ”„๋กœํ•„, ์‚ฌ์šฉ์ž ์ฐจ๋‹จยท์‹ ๊ณ , ์•Œ๋ฆผ๊ณผ 1:1 ๋ฉ”์‹œ์ง€
  • ์‚ฌ์šฉ์žยท๊ฒŒ์‹œํŒยท๊ถŒํ•œยท์‹ ๊ณ ยท์ฝ˜ํ…์ธ ยทResend ๋‹จ์ฒด ๋ฉ”์ผ์„ ๊ด€๋ฆฌํ•˜๋Š” ๋Œ€์‹œ๋ณด๋“œ
  • ๋ฐ˜์‘ํ˜• ๋ชจ๋ฐ”์ผ UI์™€ light/dark ํ…Œ๋งˆ
  • ํ•œ๊ตญ์–ด๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ์ œ๊ณตํ•˜๋ฉฐ ํ—ค๋”์—์„œ ํ•œ๊ตญ์–ด/์˜์–ด๋ฅผ ์ฆ‰์‹œ ์ „ํ™˜ํ•˜๋Š” ๊ตญ์ œํ™” UI
  • ํ•œ๊ตญ์–ด Pretendard Variable, ์˜๋ฌธ Google Sans Flex์™€ ๊ฐ•์กฐ์šฉ Oswald๋ฅผ ์ž์ฒด ํ˜ธ์ŠคํŒ…

TSBOARD๋Š” ์˜๋„์ ์œผ๋กœ ๋‹ค์Œ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

  • SSR, ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ, sitemap๊ณผ ๊ฒ€์ƒ‰์—”์ง„ ์ „์šฉ HTML
  • ์„ค์น˜ยท๊ต์ฒด ๊ฐ€๋Šฅํ•œ ์Šคํ‚จ ๋˜๋Š” NUBO Market
  • GOAPI์™€ ๋‹ค๋ฅธ ๋…์ž ๋ฐฑ์—”๋“œ ๊ณ„์•ฝ

NUBO์™€ ์„ ํƒ ๊ธฐ์ค€

ํ•ญ๋ชฉ TSBOARD 1.3 NUBO 1.3
๋ Œ๋”๋ง Vite SPA, ์ •์  dist Nuxt SSR/Nitro
์›น ํ”„๋กœ์„ธ์Šค ์—†์Œ. Nginx๊ฐ€ ์ •์  ํŒŒ์ผ ์ œ๊ณต Node.js ํ”„๋กœ์„ธ์Šค ํ•„์š”
UI ๊ณ ์ • Redditํ˜• shadcn-vue UI ๊ธฐ๋Šฅ๋ณ„ ์Šคํ‚จ๊ณผ Market
SEO ๊ธฐ๋ณธ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๋งŒ ์ œ๊ณต SSR, ๊ณต๊ฐœ ์ฝ˜ํ…์ธ  ์ƒ‰์ธ ๊ณ ๋ ค
์„œ๋ฒ„ ์ž์› ์ž‘๊ฒŒ ์œ ์ง€ํ•˜๊ธฐ ์‰ฌ์›€ ๋” ๋งŽ์€ ๊ธฐ๋Šฅ๊ณผ ๋Ÿฐํƒ€์ž„ ์ž์›
๋ฐฑ์—”๋“œ GOAPI 1.3.0 / contract 1 GOAPI 1.3.0 / contract 1

๊ณต๊ฐœ ์ฝ˜ํ…์ธ ์˜ ๊ฒ€์ƒ‰ ๋…ธ์ถœ๊ณผ ์Šคํ‚จ ๊ต์ฒด๊ฐ€ ์ค‘์š”ํ•˜๋ฉด NUBO๊ฐ€ ๋งž์Šต๋‹ˆ๋‹ค. ์ •์  ํ˜ธ์ŠคํŒ…, ์ œํ•œ๋œ ์„œ๋ฒ„ ์ž์›, ์‚ฌ๋‚ด ์ปค๋ฎค๋‹ˆํ‹ฐ์ฒ˜๋Ÿผ SPA์˜ ๋‹จ์ˆœํ•จ์ด ๋” ์ค‘์š”ํ•œ ๊ฒฝ์šฐ TSBOARD๋ฅผ ์„ ํƒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์‹คํ–‰ ๊ตฌ์กฐ

๊ตฌ์„ฑ ๊ธฐ๋ณธ๊ฐ’ ์—ญํ• 
Nginx 80, 443 dist์™€ ์—…๋กœ๋“œ ํŒŒ์ผ ์ œ๊ณต, /goapi ์ค‘๊ณ„
Vite ๊ฐœ๋ฐœ ์„œ๋ฒ„ 3000 ๊ฐœ๋ฐœ ์ค‘ SPA์™€ GOAPI ํ”„๋ก์‹œ
GOAPI 127.0.0.1:3003 DB, ์ธ์ฆ, ๊ฒŒ์‹œ๋ฌผ, ๋ฉ”์ผ๊ณผ ํŒŒ์ผ ์ฒ˜๋ฆฌ
MySQL/MariaDB 3306 ์˜์† ๋ฐ์ดํ„ฐ

๋ธŒ๋ผ์šฐ์ €๋Š” ํ•ญ์ƒ ๊ฐ™์€ origin์˜ /goapi๋ฅผ ํ˜ธ์ถœํ•ฉ๋‹ˆ๋‹ค. GOAPI ๋ณดํ˜ธ API๋Š” Authorization ํ—ค๋”๋ฅผ ์ฝ์œผ๋ฏ€๋กœ SPA๋Š” ๋กœ๊ทธ์ธ ๋˜๋Š” ์„ธ์…˜ ๊ฐฑ์‹  ์‘๋‹ต์˜ ์•ก์„ธ์Šค ํ† ํฐ์„ ๋ฉ”๋ชจ๋ฆฌ์—๋งŒ ๋ณด๊ด€ํ•ด ์š”์ฒญ์— ์ฃผ์ž…ํ•ฉ๋‹ˆ๋‹ค. ์ƒˆ๋กœ๊ณ ์นจ ๋’ค์—๋Š” HttpOnly ๊ฐฑ์‹  ์ฟ ํ‚ค๋กœ ์•ก์„ธ์Šค ํ† ํฐ์„ ๋‹ค์‹œ ๋ฐœ๊ธ‰๋ฐ›์Šต๋‹ˆ๋‹ค. ์ธ์ฆ ํ† ํฐ์€ localStorage์— ์ €์žฅํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์š”๊ตฌ ์‚ฌํ•ญ

  • Node.js 22.13 ์ด์ƒ๊ณผ npm
  • ๊ณต์‹ ๋Ÿฐํƒ€์ž„ ๋‹ค์šด๋กœ๋“œ๋ฅผ ์‚ฌ์šฉํ•  ๊ฒฝ์šฐ Ubuntu 22.04 ์ด์ƒ x86-64 Linux
  • GOAPI 1.3.0, API contract 1
  • MySQL 8 ๋˜๋Š” MariaDB
  • ์šด์˜ ํ™˜๊ฒฝ์˜ Nginx์™€ TLS ์ธ์ฆ์„œ
  • ๊ณต์‹ Ubuntu์šฉ GOAPI๋ฅผ ์ง์ ‘ ๋งŒ๋“ค ๊ฒฝ์šฐ Docker์™€ Buildx

GOAPI์˜ ๊ณต์‹ prebuilt ๋ฒ”์œ„๋Š” Ubuntu 22.04 ์ด์ƒ x86-64์ž…๋‹ˆ๋‹ค. CGO์™€ libvips๊ฐ€ ํฌํ•จ๋˜๋ฏ€๋กœ ์ž„์˜์˜ go build ๋Œ€์‹  GOAPI ์ €์žฅ์†Œ์˜ ๊ณ ์ •๋œ ๋นŒ๋“œ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

๊ฐœ๋ฐœ ์‹œ์ž‘

git clone https://github.com/sirini/tsboard.git
git clone https://github.com/sirini/goapi.git
cd tsboard
npm ci
cp env.sample .env

.env์˜ DB, ๊ด€๋ฆฌ์ž์™€ ๋น„๋ฐ€ํ‚ค ๊ฐ’์„ ๋จผ์ € ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค. ์‹ค์ œ ์šด์˜ DB๋ฅผ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ ์‚ฌ์šฉํ•˜์ง€ ๋งˆ์„ธ์š”.

TSBOARD 1.3.0๊ณผ ๊ณ„์•ฝ์ด ๋งž๋Š” ๊ณต์‹ GOAPIยทlibvips ๋Ÿฐํƒ€์ž„์„ ๋จผ์ € ๊ฒ€์ฆํ•œ ๋’ค ๋‚ด๋ ค๋ฐ›์Šต๋‹ˆ๋‹ค. ์ด ๋ช…๋ น์€ NUBO 1.3.0 Linux amd64 ๋ฆด๋ฆฌ์Šค์— ๊ณ ์ •๋˜์–ด ์žˆ์œผ๋ฉฐ bin/goapi, lib, licenses/sharp-libvips๋ฅผ NUBO์™€ ๊ฐ™์€ ๊ตฌ์กฐ๋กœ ์ค€๋น„ํ•ฉ๋‹ˆ๋‹ค.

npm run runtime:download -- --dry-run
npm run runtime:download
./bin/goapi install
./bin/goapi

๋‹ค์šด๋กœ๋”๋Š” runtime-sources.json์— ๊ธฐ๋ก๋œ ๋ฆด๋ฆฌ์Šค ํฌ๊ธฐ์™€ SHA-256, ๋‚ด๋ถ€ manifest์™€ ํŒŒ์ผ๋ณ„ checksum, Linux amd64 ELF ํ˜•์‹์„ ๋ชจ๋‘ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์šด๋กœ๋“œ ์บ์‹œ์™€ ์„ค์น˜ ์˜์ˆ˜์ฆ์€ .tsboard์— ๋‘๋ฉฐ, ์˜์ˆ˜์ฆ ์—†์ด ์ด๋ฏธ ์กด์žฌํ•˜๊ฑฐ๋‚˜ ์„ค์น˜ ๋’ค ์ˆ˜์ •๋œ ๋Ÿฐํƒ€์ž„์€ ์ž๋™์œผ๋กœ ๋ฎ์–ด์“ฐ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ด์ „ ๊ฐœ๋ฐœ ๊ตฌ์กฐ์ธ goapi-runtime๋„ ์‚ญ์ œํ•˜๊ฑฐ๋‚˜ ๋ณ€๊ฒฝํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. DB migration, SPA ๋นŒ๋“œ์™€ ํ”„๋กœ์„ธ์Šค ์žฌ์‹œ์ž‘์€ ๋ณ„๋„ ์ž‘์—…์ž…๋‹ˆ๋‹ค.

๊ณต์‹ ๋ฐ”์ด๋„ˆ๋ฆฌ ๋Œ€์‹  GOAPI ์†Œ์Šค์—์„œ ์ง์ ‘ ๋งŒ๋“ค ๋•Œ๋„ ๋ฐ˜๋“œ์‹œ GOAPI ์ €์žฅ์†Œ์˜ ./scripts/build-ubuntu22.sh๋ฅผ ์‚ฌ์šฉํ•˜๊ณ  ์ถœ๋ ฅ ๊ฒฝ๋กœ๋ฅผ ๊ฐ๊ฐ ../tsboard/bin/goapi, ../tsboard/lib, ../tsboard/licenses/sharp-libvips๋กœ ์ง€์ •ํ•ฉ๋‹ˆ๋‹ค. ์ž„์˜์˜ ํ˜ธ์ŠคํŠธ go build ๊ฒฐ๊ณผ๋ฅผ ๊ณต์‹ ๋Ÿฐํƒ€์ž„์œผ๋กœ ์‚ฌ์šฉํ•˜์ง€ ๋งˆ์„ธ์š”.

๋‹ค๋ฅธ ํ„ฐ๋ฏธ๋„์—์„œ SPA๋ฅผ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

npm run dev

๊ธฐ๋ณธ API๋Š” http://127.0.0.1:3003์ž…๋‹ˆ๋‹ค. ์ด๋ฏธ ์‹คํ–‰ ์ค‘์ธ ์›๊ฒฉ ๊ฐœ๋ฐœ API๋ฅผ ํ”„๋ก์‹œํ•˜๋ ค๋ฉด ํ”„๋ŸฐํŠธ ์†Œ์Šค๋ฅผ ๋ฐ”๊พธ์ง€ ์•Š๊ณ  ๋‹ค์Œ์ฒ˜๋Ÿผ ์ง€์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

TSBOARD_API_TARGET=https://dev.example.com npm run dev

์„ค์ •

ํ”„๋ŸฐํŠธ์—”๋“œ

tsboard.config.ts๋Š” ๊ณต๊ฐœ๋œ ๋นŒ๋“œ ์„ค์ •์ž…๋‹ˆ๋‹ค.

๊ฐ’ ์„ค๋ช…
version, apiContract GOAPI์™€ ์ผ์น˜ํ•ด์•ผ ํ•˜๋Š” ์ œํ’ˆยท๊ณ„์•ฝ ๋ฒ„์ „
apiBase ๋ธŒ๋ผ์šฐ์ €๊ฐ€ ํ˜ธ์ถœํ•  same-origin API ๊ฒฝ๋กœ
siteName, tagline, domain ์‚ฌ์ดํŠธ ํ‘œ์‹œ ์ •๋ณด
uploadLimit ์—๋””ํ„ฐ๊ฐ€ ์—…๋กœ๋“œ ์ „์— ๊ฒ€์‚ฌํ•˜๋Š” ํ•ฉ๊ณ„ ํฌ๊ธฐ
oauth ๋กœ๊ทธ์ธ ํ™”๋ฉด์— ํ‘œ์‹œํ•  ์ œ๊ณต์ž

๋น„๋ฐ€ํ‚ค๋ฅผ ์ด ํŒŒ์ผ์ด๋‚˜ VITE_* ๋ณ€์ˆ˜์— ๋„ฃ์ง€ ๋งˆ์„ธ์š”. Vite๊ฐ€ ๋ธŒ๋ผ์šฐ์ € ๋ฒˆ๋“ค์— ํฌํ•จํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

GOAPI

env.sample์€ GOAPI 1.3.0์šฉ ํ…œํ”Œ๋ฆฟ์ž…๋‹ˆ๋‹ค. ํ•ต์‹ฌ ๋ณ€๊ฒฝ ์‚ฌํ•ญ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

  • GOAPI_DOMAIN, GOAPI_BASE, GOAPI_HOST๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฉ”์ผ์€ Gmail SMTP๊ฐ€ ์•„๋‹ˆ๋ผ Resend๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • SIGNUP_MODE๋Š” verified_email, invite_only, disabled ์ค‘ ํ•˜๋‚˜์ž…๋‹ˆ๋‹ค.
  • ์‹ค์ œ ์—…๋กœ๋“œ ๊ฒฝ๋กœ ๋ณ€์ˆ˜ ์ด๋ฆ„์€ GOAPI ๊ณ„์•ฝ์— ๋”ฐ๋ผ NUBO_UPLOAD_DIR์ž…๋‹ˆ๋‹ค.
  • JWT_SECRET_KEY์™€ SYNC_SECRET_KEY๋Š” ์„œ๋กœ ๋‹ค๋ฅธ ๋ฌด์ž‘์œ„ ๊ฐ’์ด์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

.env์—๋Š” DB ๋น„๋ฐ€๋ฒˆํ˜ธ์™€ API ํ‚ค๊ฐ€ ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค. Git์— ์ถ”๊ฐ€ํ•˜๊ฑฐ๋‚˜ ์›น ๊ณต๊ฐœ ๊ฒฝ๋กœ์—์„œ ๋‚ด๋ ค๋ฐ›์„ ์ˆ˜ ์žˆ๊ฒŒ ๋‘์ง€ ๋งˆ์„ธ์š”.

๊ฒ€์ฆ

npm run format:check
npm run lint
npm test
npm run build

์‹คํ–‰ ์ค‘์ธ ์„œ๋ฒ„๊ฐ€ ์ •ํ™•ํ•œ GOAPI ๋ฒ„์ „๊ณผ ์‘๋‹ต ๊ตฌ์กฐ๋ฅผ ์ œ๊ณตํ•˜๋Š”์ง€๋„ ๊ฒ€์‚ฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

npm run contract:check -- https://example.com/goapi

๊ฒ€์‚ฌ๋Š” /version, ์ œํ’ˆ ์ •๋ณด, ๋ฉ”๋‰ด, ๊ฐ€์ž… ์ •์ฑ…, ์ฒซ ๊ฒŒ์‹œํŒ๊ณผ ์ธ์ฆ๋˜์ง€ ์•Š์€ ์„ธ์…˜ ์‘๋‹ต์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ๊ด€๋ฆฌ์ž ๋Œ€์‹œ๋ณด๋“œ๋„ TSBOARD์™€ GOAPI ๋ฒ„์ „ ๋˜๋Š” API contract๊ฐ€ ๋‹ค๋ฅด๋ฉด ๊ฒฝ๊ณ ํ•ฉ๋‹ˆ๋‹ค.

ESLint๋Š” src์˜ ํŒŒ์ผ์„ 400์ค„ ์ดํ•˜, ํ•จ์ˆ˜๋Š” 100์ค„ ์ดํ•˜๋กœ ์ œํ•œํ•ฉ๋‹ˆ๋‹ค. ์ƒ์„ฑ ํŒŒ์ผ์ธ package-lock.json๊ณผ ์„ค๋ช… ๋ฌธ์„œ๋Š” ์ด ์†Œ์Šค ์ฝ”๋“œ ์ œํ•œ์˜ ๋Œ€์ƒ์ด ์•„๋‹™๋‹ˆ๋‹ค.

ํ”„๋กœ๋•์…˜ ๋นŒ๋“œ

npm ci
npm run format:check
npm run lint
npm test
npm run build

dist๋Š” Nginx๊ฐ€ ์ง์ ‘ ์ œ๊ณตํ•˜๋Š” ์ •์  SPA์ž…๋‹ˆ๋‹ค. Node.js ์›น ํ”„๋กœ์„ธ์Šค๋‚˜ npm run preview๋ฅผ ์šด์˜ ์„œ๋ฒ„์—์„œ ๊ณ„์† ์‹คํ–‰ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

server {
    server_name example.com;
    root /var/www/tsboard/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /goapi/ {
        proxy_pass http://127.0.0.1:3003/goapi/;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    location /upload/ {
        alias /var/lib/tsboard/upload/;
    }
}

try_files ... /index.html์€ ์ƒˆ๋กœ๊ณ ์นจํ•œ SPA ๊ฒฝ๋กœ๋ฅผ Vue Router์— ๋Œ๋ ค์ฃผ๊ธฐ ์œ„ํ•ด ๋ฐ˜๋“œ์‹œ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. ๋น„๊ณต๊ฐœ ์›๋ณธ ์ฒจ๋ถ€ํŒŒ์ผ์€ ๊ณต๊ฐœ alias์— ๋‘์ง€ ๋ง๊ณ  GOAPI์˜ /board/original ๋‹จ๊ธฐ ์ „์†ก ๊ฒฝ๋กœ๋ฅผ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์œ„ ์˜ˆ์‹œ๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค๋ฉด NUBO_UPLOAD_DIR=/var/lib/tsboard/upload๋„ ๊ฐ™์€ ๊ฒฝ๋กœ๋กœ ์„ค์ •ํ•˜์„ธ์š”.

PM2๋กœ GOAPI ์‹คํ–‰

GOAPI ๋Ÿฐํƒ€์ž„๊ณผ ์—…๋กœ๋“œ, .env๋ฅผ ๊ต์ฒด ๊ฐ€๋Šฅํ•œ dist ๋ฐ–์— ๋‘ก๋‹ˆ๋‹ค.

cd /var/www/tsboard
NUBO_ENV_FILE=/var/www/tsboard/.env \
  pm2 start ./bin/goapi --name tsboard-goapi --cwd /var/www/tsboard
pm2 save

์ƒˆ GOAPI๋ฅผ ์ ์šฉํ•˜๊ธฐ ์ „์—๋Š” DB์™€ ์—…๋กœ๋“œ๋ฅผ ์„œ๋ฒ„ ๋ฐ–์— ๋ฐฑ์—…ํ•ฉ๋‹ˆ๋‹ค. ๋Ÿฐํƒ€์ž„์„ ์ž„์‹œ ๊ฒฝ๋กœ์—์„œ ๊ฒ€์ฆํ•˜๊ณ  ์žฌ์‹คํ–‰ ๊ฐ€๋Šฅํ•œ migration์„ ๋จผ์ € ์ ์šฉํ•œ ๋’ค ํ”„๋กœ์„ธ์Šค๋ฅผ ์ „ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

NUBO_ENV_FILE="$PWD/.env" ./bin/goapi install
pm2 restart tsboard-goapi --update-env
npm run contract:check -- https://example.com/goapi

์•ˆ์ „ํ•œ ์—…๋ฐ์ดํŠธ ์ˆœ์„œ

git pull --ff-only
npm ci
npm run runtime:download -- --dry-run
npm run format:check
npm run lint
npm test
npm run build
  1. ํ˜„์žฌ DB, ์—…๋กœ๋“œ์™€ .env๋ฅผ ๋ณ„๋„ ์œ„์น˜์— ๋ฐฑ์—…ํ•ฉ๋‹ˆ๋‹ค.
  2. npm run runtime:download๋กœ ๊ณ ์ •๋œ ํ›„๋ณด GOAPI ๋Ÿฐํƒ€์ž„์„ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.
  3. ํ›„๋ณด ๋ฐ”์ด๋„ˆ๋ฆฌ์˜ install์„ ์‹คํ–‰ํ•ด ์žฌ์‹คํ–‰ ๊ฐ€๋Šฅํ•œ migration์„ ์ ์šฉํ•ฉ๋‹ˆ๋‹ค.
  4. PM2์˜ GOAPI ์‹คํ–‰ ๊ฒฝ๋กœ๋ฅผ ํ›„๋ณด๋กœ ๋ฐ”๊พธ๊ณ  readiness๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  5. dist๋ฅผ ๊ต์ฒดํ•˜๊ณ  contract:check์™€ ์ฃผ์š” ํ™”๋ฉด์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  6. ์‹คํŒจํ•˜๋ฉด ์ด์ „ ์ •์  ๋นŒ๋“œ์™€ ์ด์ „ GOAPI ๋Ÿฐํƒ€์ž„์œผ๋กœ ๋˜๋Œ๋ฆฝ๋‹ˆ๋‹ค. ์ ์šฉ๋œ DB migration์€ ์‚ญ์ œํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

git pull, npm ์„ค์น˜, ํ”„๋ŸฐํŠธ ๋นŒ๋“œ์™€ ํ”„๋กœ์„ธ์Šค ์žฌ์‹œ์ž‘์€ ์„œ๋กœ ๋‹ค๋ฅธ ์‹คํŒจ ์ง€์ ์ž…๋‹ˆ๋‹ค. ํ•œ ์ค„ ๋ช…๋ น์œผ๋กœ ๋ฌถ์ง€ ์•Š์œผ๋ฉด ์–ด๋А ๋‹จ๊ณ„์—์„œ ๋ฉˆ์ท„๋Š”์ง€ ํ™•์ธํ•˜๊ณ  ์•ˆ์ „ํ•˜๊ฒŒ ๋ณต๊ตฌํ•˜๊ธฐ ์‰ฝ์Šต๋‹ˆ๋‹ค.

ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ

bin/goapi          # ๊ณ ์ • ๋ฆด๋ฆฌ์Šค์—์„œ ๊ฒ€์ฆํ•œ GOAPI ์‹คํ–‰ ํŒŒ์ผ(๋กœ์ปฌ ์ƒ์„ฑ)
lib/               # GOAPI๊ฐ€ ์‚ฌ์šฉํ•˜๋Š” libvips ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ(๋กœ์ปฌ ์ƒ์„ฑ)
runtime-sources.json # TSBOARD ๋ฒ„์ „์— ๊ณ ์ •๋œ ๊ณต์‹ ๋Ÿฐํƒ€์ž„ ์ถœ์ฒ˜์™€ checksum
scripts/           # ๊ณ„์•ฝ ๊ฒ€์‚ฌ์™€ ๋Ÿฐํƒ€์ž„ ๋‹ค์šด๋กœ๋“œยท๊ฒ€์ฆ ๋„๊ตฌ
src/
โ”œโ”€โ”€ api/          # GOAPI contract 1 ํด๋ผ์ด์–ธํŠธ
โ”œโ”€โ”€ components/   # shadcn-vue ์Šคํƒ€์ผ UI์™€ ๊ธฐ๋Šฅ ์ปดํฌ๋„ŒํŠธ
โ”œโ”€โ”€ i18n/         # ํ•œ๊ตญ์–ดยท์˜์–ด ๋ฉ”์‹œ์ง€ ์นดํƒˆ๋กœ๊ทธ
โ”œโ”€โ”€ layouts/      # SPA์™€ ๊ด€๋ฆฌ์ž ๋ ˆ์ด์•„์›ƒ
โ”œโ”€โ”€ lib/          # API ์„ธ์…˜, HTML ์ •ํ™”, ํฌ๋งคํŒ…๊ณผ ํ…Œ์ŠคํŠธ
โ”œโ”€โ”€ pages/        # ํ™ˆ, ์ธ์ฆ, ๊ฒŒ์‹œํŒ, ํ”„๋กœํ•„๊ณผ ๊ด€๋ฆฌ์ž ํ™”๋ฉด
โ”œโ”€โ”€ router/       # history-mode Vue Router
โ”œโ”€โ”€ stores/       # Pinia ์ธ์ฆยทํ™ˆ ์ƒํƒœ
โ”œโ”€โ”€ styles/       # Tailwind 4 ์ƒ‰์ƒ ํ† ํฐ๊ณผ ๋ณธ๋ฌธ ์Šคํƒ€์ผ
โ””โ”€โ”€ types/        # GOAPI ์‘๋‹ตยท์š”์ฒญ ํƒ€์ž…

shadcn-vue๋Š” ์™„์„ฑ๋œ ๋Ÿฐํƒ€์ž„ ํŒจํ‚ค์ง€๊ฐ€ ์•„๋‹ˆ๋ผ ํ”„๋กœ์ ํŠธ๊ฐ€ ์†Œ์œ ํ•˜๋Š” ์ปดํฌ๋„ŒํŠธ ์ฝ”๋“œ ๋ฐฉ์‹์œผ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. src/components/ui๋ฅผ ์ˆ˜์ •ํ•˜๋ฉด TSBOARD์˜ ๊ณ ์ • UI๊ฐ€ ๋ฐ”๋€Œ๋ฉฐ ๋ณ„๋„ ์Šคํ‚จ ๋ ˆ์ด์–ด๋Š” ์—†์Šต๋‹ˆ๋‹ค.

๋ณธ๋ฌธ ๊ธ€๊ผด์€ ํ˜„์žฌ ์–ธ์–ด์— ๋”ฐ๋ผ Pretendard Variable ๋˜๋Š” Google Sans Flex๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ๋กœ๊ณ ์™€ ์ž‘์€ ๋Œ€๋ฌธ์ž ๋ ˆ์ด๋ธ”์—๋Š” Oswald๋ฅผ ์ ์šฉํ•˜๋ฉฐ, ๋ชจ๋“  woff2๋ฅผ src/assets/fonts์—์„œ ์ œ๊ณตํ•ด Google Fonts์— ๋Ÿฐํƒ€์ž„ ์š”์ฒญ์„ ๋ณด๋‚ด์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋ณด์•ˆ๊ณผ ๋ฐ์ดํ„ฐ

  • API ์š”์ฒญ์€ credentials: same-origin์œผ๋กœ ๊ฐฑ์‹  ์ฟ ํ‚ค๋ฅผ ์ „์†กํ•˜๊ณ  ๋ฉ”๋ชจ๋ฆฌ์˜ ์•ก์„ธ์Šค ํ† ํฐ์„ Bearer ํ—ค๋”์— ๋„ฃ์Šต๋‹ˆ๋‹ค.
  • 401 ์‘๋‹ต์€ ํ•œ ๋ฒˆ์˜ ๊ณต์œ  refresh ์š”์ฒญ์œผ๋กœ ๋ณ‘ํ•ฉํ•˜๋ฉฐ, ์‹คํŒจํ•˜๋ฉด ๋กœ๊ทธ์ธ ํ™”๋ฉด์œผ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.
  • ๊ฒŒ์‹œ๋ฌผ๊ณผ ๋Œ“๊ธ€ HTML์€ DOMPurify๋กœ ์ •ํ™”ํ•œ ๋’ค ๋ Œ๋”๋งํ•ฉ๋‹ˆ๋‹ค.
  • ์™ธ๋ถ€ ๋งํฌ์—๋Š” noopener noreferrer๋ฅผ ์ ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ์—…๋กœ๋“œ ํฌ๊ธฐ๋Š” ๋ธŒ๋ผ์šฐ์ €์—์„œ ๋จผ์ € ํ™•์ธํ•˜์ง€๋งŒ ์ตœ์ข… ๊ถŒํ•œ๊ณผ ์šฉ๋Ÿ‰ ํŒ์ •์€ GOAPI๊ฐ€ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  • ์šด์˜ DB, .env, Resend/OpenAI/Firebase ์ž๊ฒฉ ์ฆ๋ช…๊ณผ ์›๋ณธ ์—…๋กœ๋“œ๋Š” ์ €์žฅ์†Œ์— ํฌํ•จํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋ณด์•ˆ ๋ฌธ์ œ๋Š” ๊ณต๊ฐœ ์ด์Šˆ์— ๋น„๋ฐ€๊ฐ’์ด๋‚˜ ์žฌํ˜„ ๊ฐ€๋Šฅํ•œ ๊ณต๊ฒฉ ๋ฐ์ดํ„ฐ๋ฅผ ์˜ฌ๋ฆฌ์ง€ ๋ง๊ณ  ์ €์žฅ์†Œ ์†Œ์œ ์ž์—๊ฒŒ ๋น„๊ณต๊ฐœ๋กœ ์ „๋‹ฌํ•ด ์ฃผ์„ธ์š”.

๊ด€๋ จ ํ”„๋กœ์ ํŠธ

  • NUBO: SSR, SEO์™€ ์Šคํ‚จ์„ ํฌํ•จํ•œ ์™„์„ฑํ˜• ํ›„์† ํ”„๋กœ์ ํŠธ
  • GOAPI: TSBOARD์™€ NUBO๊ฐ€ ๊ณต์œ ํ•˜๋Š” GoFiber ๋ฐฑ์—”๋“œ
  • nubohub.org: NUBO ์šด์˜ ์‚ฌ์ดํŠธ
  • tsboard.dev: TSBOARD ์šด์˜ ์‚ฌ์ดํŠธ

๋ผ์ด์„ ์Šค

์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์ฝ”๋“œ๋Š” MIT License๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค. ํฌํ•จ๋œ ๊ธ€๊ผด์˜ ๋ผ์ด์„ ์Šค๋Š” src/assets/fonts/LICENSE-Pretendard.txt, OFL-GoogleSansFlex.txt, OFL-Oswald.txt์—์„œ ๊ฐ๊ฐ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.