Tech
๐ ๏ธ [์ง๊ธ์ฌ๊ธฐ / NOW HERE] Full-Stack Technical Specification
์ด ํ๋ก์ ํธ[์ง๊ธ์ฌ๊ธฐ / NOW HERE]๋ Google ์์ฝ์์คํ ์ ์ค์ฌ์ผ๋ก ํ์ดํผ-๋ก์ปฌ ๋ฐ์ดํฐ์ AI๋ฅผ ๊ฒฐํฉํ ์ ํ์ ์ธ Modern RAG(Retrieval-Augmented Generation) ์ํคํ ์ฒ๋ฅผ ๋ฐ๋ฅด๊ณ ์์ต๋๋ค.
[์ง๊ธ์ฌ๊ธฐ / NOW HERE] ๋ฐ๋ก๊ฐ๊ธฐ
๐ ๏ธ [์ง๊ธ์ฌ๊ธฐ / NOW HERE] Full-Stack Technical Specification
1. Frontend (User Experience)
- Framework: Next.js 14+ (App Router) - ์๋ฒ ์ฌ์ด๋ ๋ ๋๋ง(SSR)๊ณผ ํด๋ผ์ด์ธํธ ์ฌ์ด๋ ๋ ๋๋ง(CSR)์ ํ์ด๋ธ๋ฆฌ๋๋ก ์ด์ฉํ์ฌ SEO์ ์ค์๊ฐ์ฑ์ ๋ชจ๋ ํ๋ณด.
- Deployment Mode: Standalone Mode - ํ๋ก๋์ ํ๊ฒฝ์์ ์ฉ๋์ ์ต์ํํ๊ณ ์คํ ์๋๋ฅผ ๊ทน๋ํํ ์ต์ ํ ๋น๋ ๋ฐฉ์.
- Styling: Tailwind CSS - ์ ํธ๋ฆฌํฐ ํผ์คํธ ํ๋ ์์ํฌ๋ฅผ ์ฌ์ฉํ์ฌ ๊ณ ์ UI ๊ฐ๋ฐ ๋ฐ ์ ์ง๋ณด์ ํจ์จ ์ฆ๋.
- Animation: Framer Motion - ํญ ์ ํ, ๋ชจ๋ฌ ํ์ ๋ฑ ๋ค์ดํฐ๋ธ ์ฑ ์์ค์ ๋งค๋๋ฌ์ด UX ์ ๊ณต.
- Auth: NextAuth.js (Google Provider) - ์์ ํ ๊ตฌ๊ธ ์์ ๋ก๊ทธ์ธ ๋ฐ ์ธ์ ๊ด๋ฆฌ.
- cons: Lucide React - ๊ฐ๋ณ๊ณ ์ผ๊ด๋ ๋ฒกํฐ ์์ด์ฝ ๋ผ์ด๋ธ๋ฌ๋ฆฌ.
2. Backend (Core Logic)
- Framework: Python 3.10+ FastAPI - ๋น๋๊ธฐ(Asynchronous) ์ฒ๋ฆฌ์ ํนํ๋ ์ด๊ณ ์ ์น ํ๋ ์์ํฌ.
- Task Scheduler: APScheduler - ๋งค์ผ ์์ 30์ผ ๊ฒฝ๊ณผ ๋ฐ์ดํฐ๋ฅผ ์๋ ์ญ์ (TTL)ํ๋ ๋ฐฑ๊ทธ๋ผ์ด๋ ์์ปค.
- ORM: SQLAlchemy - ํ์ด์ฌ ๊ฐ์ฒด ์งํฅ ๋ฐฉ์์ ๋ฐ์ดํฐ๋ฒ ์ด์ค ๋ชจ๋ธ๋ง ๋ฐ ์ฟผ๋ฆฌ ์ต์ ํ.
- Server: Uvicorn - ๊ณ ์ฑ๋ฅ ASGI ์๋ฒ๋ฅผ ํตํด PM2 ๊ธฐ๋ฐ์ ๋ฉํฐ ํ๋ก์ธ์ค ์ด์ฉ.
3. AI & Data (Intelligence)
- Reasoning: Google Gemini 1.5 Flash - ๋์ ์ค๊ณ(Itinerary), ์๋ ์๋ฌธ ๋ฒ์ญ, ์ค์๊ฐ ์ง๋ฌธ ๋ต๋ณ(Chat)์ ์ํํ๋ ๊ณ ์ ์ถ๋ก ๋ชจ๋ธ.
- Vectorizing: Vertex AI Text-Embedding-004 - ๋ค๊ตญ์ด ๋์์ด ๊ฐ๋ฅํ ๊ณ ์ฐจ์ ๋ฒกํฐ ์๋ฒ ๋ฉ ๋ชจ๋ธ์ ์ฌ์ฉํ์ฌ ๊ฒ์ ์ ํ๋ ๊ทน๋ํ.
- RAG Engine: ์ฌ์ฉ์ ์ง๋ฌธ๊ณผ ๊ฐ์ฅ ์ ์ฌํ ๋ก์ปฌ ๋ฐ์ดํฐ๋ฅผ ๋ฒกํฐ ๊ฒ์ํ์ฌ AI์๊ฒ ์ปจํ ์คํธ๋ก ์ ๊ณตํ๋ ์ง๋ฅํ ๊ฐ์ด๋ ๋ก์ง.
4. Database (Storage)
- RDBMS: PostgreSQL 15+ - ๋๊ท๋ชจ ๋ฐ์ดํฐ ์ฒ๋ฆฌ์ ์์ ์ ์ธ ์คํ์์ค ๋ฐ์ดํฐ๋ฒ ์ด์ค.
- Vector Search: pgvector - PostgreSQL ํ์ฅ์ ํตํด ๊ณ ์ฐจ์ ์๋ฒ ๋ฉ ๋ฒกํฐ ๊ฐ์ ์ฝ์ฌ์ธ ์ ์ฌ๋ ๊ฒ์์ DB ์์ง ๋ ๋ฒจ์์ ์ํ.
5. Infrastructure & DevOps (Deployment)
- OS/VM: GCP (Google Cloud Platform) VM Instance.
- Web Server: Nginx (Reverse Proxy) - ํฌํธ๋ฅผ /api-now/ ๊ฒฝ๋ก๋ก ํตํฉ ๋ผ์ฐํ ๋ฐ SSL(HTTPS) ์ฒ๋ฆฌ.
- Process Manager: PM2 - ๋ฌด์ค๋จ ์๋น์ค ์ด์ ๋ฐ ํ๊ฒฝ ๋ณ์ ๊ธฐ๋ฐ์ ํ๋ก์ธ์ค ์๋ช ์ฃผ๊ธฐ ๊ด๋ฆฌ.
- Protocol: SSH Tunneling - ๋ก์ปฌ ๊ฐ๋ฐ ํ๊ฒฝ๊ณผ ๋ฆฌ๋ชจํธ DB ๊ฐ์ ๋ณด์ ์ฐ๊ฒฐ.
6. Global SEO (Market Strategy)
- Standard: Schema.org JSON-LD (Event) - ๊ตฌ๊ธ ๊ฒ์ ๊ฒฐ๊ณผ์ ํ์ฌ ๋ ์ง, ์ฅ์, ์ด๋ฏธ์ง๊ฐ ๋ ธ์ถ๋๋ ๋ฆฌ์น ์ค๋ํซ ์ ์ฉ.
- Localization: Hreflang / Metadata Alternates - ํ๊ตญ์ด(ko)์ ์์ด(en)์ ์ต์ ํ๋ ๋ฉํํ๊ทธ ๋ฐ ์ธ์ด๋ณ ๊ฒฝ๋ก ์ต์ ํ.
์์ฝํ์๋ฉด:
"์ง๊ธ์ฌ๊ธฐ"๋ Next.js์ ๊ฐ๋ ฅํ UI์ FastAPI์ ๋น ๋ฅธ ๋ฐ์ดํฐ ์ฒ๋ฆฌ, ๊ทธ๋ฆฌ๊ณ Google Gemini์ ์ง๋ฅํ ๋์ ์ค๊ณ๋ฅผ PostgreSQL/pgvector ์์ ์์ฐฉ์ํจ ์ต์ฒจ๋จ ํ์ดํผ-๋ก์ปฌ AI ์๋น์ค์ ๋๋ค.
# ์ง๊ธ์ฌ๊ธฐ# ๊ธฐ์ ์คํ# FullStack# RAG# Framework# GlobalSEO# SEO# Standalone Mode# Next.js 14+# ์์ฝ์์คํ
COMMENTS
์๊ฒฌ์ ๋จ๊ธฐ๋ ค๋ฉด ๋ก๊ทธ์ธ์ด ํ์ํฉ๋๋ค.