기술 제안서

Loafacto Hub의 운영 효율과 확장성을 높이기 위한 기술 방향을 정리한 제안입니다.

1. 제안 배경

• 현재 기능은 빠른 변화에 대응해야 하며, 사용자/운영자/관리자 역할이 모두 분리되어야 합니다.
• AI 기능 도입 시도 시에도 운영 안정성과 보안 경계는 별도로 유지해야 합니다.

2. 핵심 아키텍처

Frontend

• Vue 3 + Vite + Vuetify
• 라우트별 권한 분기(사용자/운영자/관리자)
• API 호출 계층에서 공통 토큰/에러 처리

Backend

• FastAPI 기반 API 서버
• 인증/인가, 도메인 서비스, 통합 로그 API 분리
• 스트리밍 응답(SSE) 지원 설계

운영 인프라

• Reverse proxy(nginx/Traefik)
• 시스템 서비스(systemd)로 백그라운드 상시 운영
• 빌드 산출물 정적 서빙 + API 라우팅 분리

3. 기술 선택 근거

• Vue/Vite: 빠른 개발 체감과 문서 정합성 유지
• FastAPI: Python 생태계의 확장성 및 비동기 처리 대응
• PostgreSQL/백엔드 저장소 조합: 인증/로그/메타데이터 집중 처리
• 문서형 구조의 공통화: VitePress 기반 기술 문서 운영

4. 위험요소 및 대응

• Mixed Content, CORS: 배포 템플릿에 HTTPS 규칙 고정
• 모듈 누락/서비스 미기동: systemd 상태 점검 자동화
• 역할 오용: 권한별 메뉴/라우팅 강제화 및 감사 로그

5. 일정안 (예시)

1. 기반 정비(안정성): 인증/라우팅/배포 템플릿 통일
2. 운영 문서 정합성: 문서 카테고리 및 링크 정렬
3. 모니터링 보강: 에러/로그 조회 UX 개선
4. AI 기능 단계적 확장: 내부 테스트 후 운영 적용

6. 기대 효과

• 운영 대응 속도 향상
• 배포/릴리스 일관성 개선
• 문서 기반 협업 품질 향상
• 신규 기능 통합 시 위험도 감소