Tech

๐Ÿ› ๏ธ [์ง€๊ธˆ์—ฌ๊ธฐ / NOW HERE] Full-Stack Technical Specification

byํƒํ—˜๋Œ€์žฅ
2026๋…„ 3์›” 20์ผ

์ด ํ”„๋กœ์ ํŠธ[์ง€๊ธˆ์—ฌ๊ธฐ / 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

์˜๊ฒฌ์„ ๋‚จ๊ธฐ๋ ค๋ฉด ๋กœ๊ทธ์ธ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.

NO COMMENTS YET.