📌 설계 목적

본 프로젝트의 API는

프론트엔드와 백엔드 간의 명확한 역할 분리와

기능 확장 및 유지보수를 고려하여

RESTful API 설계 원칙을 기반으로 설계하였다.

번역, 요약, 용어 설명, 음성 처리 등

각 기능을 독립적인 API 엔드포인트로 분리하고,

일관된 요청·응답 구조를 통해 안정적인 서비스 운영을 목표로 한다.

🧱 설계 원칙

• RESTful API 설계
  • 리소스 중심 URL 설계
  • HTTP Method를 통한 행위 구분
• Stateless 구조
  • 모든 요청은 독립적으로 처리
  • 인증 정보는 JWT 토큰 기반으로 전달
• 프론트엔드–백엔드 분리
  • UI와 비즈니스 로직 분리
  • 다양한 클라이언트(Web, Bot 등) 확장 가능
• 기능 단위 API 분리
  • 번역 / 요약 / 용어 / 음성 처리 API 독립 구성

🔁 API 구조 개요

• 기능별 라우터 분리

  /translate
  /summarize
  /term/explain
  
  /auth/register
  /auth/login
  /auth/logout
  /auth/forgot
  /auth/reset
  /auth/find-user-id
  
  /users/me
  /users/password
  /users/withdraw
  
  /chat
  /chat/sessions
  /chat/sessions/recent
  /chat/sessions/search
  /chat/sessions/messages
  
  /projects
  /projects/{project_session_id}
  /projects/{project_session_id}/chat-sessions
  /projects/{project_session_id}/chat-sessions/{chat_session_id}
  
  /feedback
  
  /summarize/pdf
  /translate/pdf
  
  /summarize/pptx
  /translate/pptx
  
  /memo
  /memo/{memo_id}
  
  

📥 요청(Request) 설계

• JSON 기반 통신