sirini/tsboard
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.
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 & AppsREADME.md
Original๐ชถ TSBOARD
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
- ํ์ฌ DB, ์
๋ก๋์
.env๋ฅผ ๋ณ๋ ์์น์ ๋ฐฑ์ ํฉ๋๋ค. npm run runtime:download๋ก ๊ณ ์ ๋ ํ๋ณด GOAPI ๋ฐํ์์ ์ค์นํฉ๋๋ค.- ํ๋ณด ๋ฐ์ด๋๋ฆฌ์
install์ ์คํํด ์ฌ์คํ ๊ฐ๋ฅํ migration์ ์ ์ฉํฉ๋๋ค. - PM2์ GOAPI ์คํ ๊ฒฝ๋ก๋ฅผ ํ๋ณด๋ก ๋ฐ๊พธ๊ณ readiness๋ฅผ ํ์ธํฉ๋๋ค.
dist๋ฅผ ๊ต์ฒดํ๊ณcontract:check์ ์ฃผ์ ํ๋ฉด์ ํ์ธํฉ๋๋ค.- ์คํจํ๋ฉด ์ด์ ์ ์ ๋น๋์ ์ด์ 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์์ ๊ฐ๊ฐ ํ์ธํ ์
์์ต๋๋ค.