happybell80 8f514355b1 docs: auth-server 심층 분석 및 문서화 작업 트러블슈팅 추가

- auth-server 운영 상태 검토 및 PostgreSQL 스키마 분석
- 멀티테넌트 B2B 인증 허브로서의 역할 확인
- 전체 아키텍처 문서 통합 및 중복 제거
- 프로젝트 맥락 고려 중요성 교훈 반영

2025-07-29 21:13:25 +09:00

7.5 KiB

Raw Blame History

프론트엔드 재설계 및 GUI 공유 아키텍처 논의

날짜: 2025-07-29
작업자: happybell80 & Claude
관련 프로젝트: frontend-customer, 로빙 GUI 공유 시스템

오후 6시 7분

세션 시작 문제

Claude가 세션 시작 시 규칙을 제대로 따르지 않음. CLAUDE.md 재확인 후 규칙 준수.

교훈:

세션 시작 시 항상 CLAUDE.md 규칙 재확인 필요
간결한 응답 원칙 준수

오후 6시 30분

프론트엔드 커스터머 대대적 개편 계획

목표:

기존 React 기반 frontend-customer를 모바일 게임 UI처럼 개편
Merge Restaurant 스타일의 인터페이스 적용

현재 상태 분석:

프로젝트 구조
- React 18 + TypeScript + Vite
- Tailwind CSS + shadcn/ui
- 2가지 뷰 모드: 관리 대시보드, 캐릭터 대시보드
발견된 문제
- @shared/schema import 존재하지만 실제 파일 없음
- 이미지 경로 하드코딩
- API URL 환경변수 미사용

DOCS 문서 검토:

PERSONOS 프로토콜: 감정 공명, 상호기억 시스템
외부도구 아이템화 방안
PRD: 3개월 MVP 계획

오후 7시 00분

로빙 컨테이너 GUI 공유 아키텍처 설계

핵심 개념: 로빙이 컨테이너에서 실행하는 모든 GUI를 사용자가 웹으로 볼 수 있게 함

기술 스택:

VNC/noVNC 방식 (선택)
- Xvfb + x11vnc + noVNC
- Slack 인증 불필요
- 리소스: 300MB~1GB
레벨별 단계적 해금
- Lv.1-4: 스크린샷 (300-400MB)
- Lv.5-9: 반응형 스크린샷
- Lv.10-14: 영상 스트리밍 (500-700MB)
- Lv.15-19: 읽기 전용 VNC (800MB-1GB)
- Lv.20: 완전 제어 VNC (1GB+)

리소스 최적화:

qutebrowser, surf 등 경량 브라우저 사용
세션 수명 제한
독립 스킬 컨테이너 분리

오후 7시 20분

SaaS에서 독립 GUI로의 확장 전략

철학: 초기에는 SaaS API만 사용하다가 레벨업하면서 독립 GUI 도구 해금

단계별 확장:

Lv.1-4: Gmail, Notion API
Lv.5-9: Google Docs, Figma API
Lv.10-14: Playwright로 SaaS 화면 공유
Lv.15-19: PDF 리더, 로그 뷰어 등 독립 앱
Lv.20: LibreOffice, 터미널 도구

GUI 프레임 최적화:

창 관리자 없이 Xvfb 직접 실행
xdotool로 불필요한 UI 제거
이미지 크롭으로 콘텐츠만 추출

오후 7시 30분

웹 인터페이스 3분할 설계

데스크톱: GUI 화면 | 채팅창 | 상태창 (가로 3분할) 모바일: 슬라이드 전환 방식

기술 스택 비교:

React 기반 (권장)
- 게임풍 UI 구현 용이
- Framer Motion, Lottie 활용
Rails 기반
- 빠른 개발 가능
- GUI 스트리밍과 통합 어려움
- 복잡한 UI 표현 한계

결론: React + 애니메이션 라이브러리로 게임 스타일 UI 구현

교훈

GUI 공유는 리소스와 신뢰의 트레이드오프
- 레벨이 낮을 때는 최소한의 리소스로 관찰만
- 신뢰가 쌓이면 더 많은 리소스를 투자해 제어 권한 부여
SaaS 우선, GUI는 보조
- 대부분의 작업은 API로 해결 가능
- GUI 공유는 투명성과 신뢰 구축용
기술 스택은 목적에 맞게
- 게임풍 UI가 목표라면 React가 Rails보다 적합
- 하지만 핵심 기능은 기존 스택 유지 가능
점진적 확장이 핵심
- 한번에 모든 기능을 구현하지 말고 레벨별로 해금
- 리소스 사용량도 점진적으로 증가

오후 8시 00분

서버 구조 변경 및 auth-server 설정 수정

서버팀 메시지 내용:

51123 서버: nginx, Gitea, frontend-base, auth-server, PostgreSQL
51124 서버: 로빙 서비스들, 스킬 서비스들, ChromaDB
PostgreSQL은 51123 서버 호스트에서 실행 중
auth-server Docker 컨테이너가 호스트 PostgreSQL 연결 불가 문제

해결 작업:

auth-server의 docker-compose.yml 수정
- DATABASE_URL 기본값을 host.docker.internal 사용하도록 변경
- 이미 extra_hosts 설정은 있었음
서버 아키텍처 문서 업데이트
- server-architecture.md에 변경된 서버 구조 반영
- auth-server와 PostgreSQL이 51123에 추가된 것 문서화

실수 및 교훈:

Git 작업 시 디렉토리 구조 실수 반복
- ivada는 git 저장소가 아님, 각 하위 폴더가 개별 저장소
- cd 명령 전 현재 위치 확인 필수
CLAUDE.md에 디렉토리 구조 주의사항 추가함

오후 8시 10분

51123 서버 서비스 정리 및 auth-server 실행

서버 관리 작업 (admin@51123):

서비스 이전 작업:
- 51123에서 실행 중이던 서비스들 중지 및 제거:
  - skill-email → 51124로 이전
  - rb8001 → 51124로 이전
  - hj_rb10408_test → 51124로 이전
- Docker 이미지도 정리 완료
auth-server 실행 문제 해결:
- 문제: Docker 컨테이너에서 localhost가 호스트 PostgreSQL에 연결 불가
- 원인: 컨테이너 내부의 localhost는 컨테이너 자신을 가리킴
- 해결 과정:
  - docker-compose.yml에 host.docker.internal 설정 추가 (로컬 개발자 수행)
  - .env 파일의 DATABASE_URL도 host.docker.internal로 수정 (서버에서 직접 수정)
- 결과: auth-server 포트 9000에서 정상 실행 중
최종 51123 서버 상태:
- nginx (80/443) ✅
- Gitea (3000) ✅
- frontend-base (8000) ✅
- auth-server (9000) ✅
- PostgreSQL (5432) ✅
- Actions Runner ✅

교훈:

Docker 네트워킹: 컨테이너에서 호스트 서비스 접근 시 localhost 대신 host.docker.internal 사용
.env 파일은 gitignore에 있어 서버에서 직접 수정 필요
PostgreSQL은 이미 호스트에서 실행 중이므로 컨테이너 추가 불필요

오후 9시 00분

auth-server 심층 분석 및 문서화

배경: auth-server의 상태와 데이터베이스 스키마를 체계적으로 분석하고 전체 아키텍처 문서에 반영

작업 내용:

auth-server 운영 상태 검토:
- 컨테이너 정상 실행 확인 (포트 9000, healthy 상태)
- nginx를 통한 https://auth.ro-being.com 프록시 설정 확인
- JWT/OAuth 키 관리 상태 점검
PostgreSQL auth_db 스키마 분석:
- companies 테이블: 회사별 서브도메인 관리 (2개 회사 등록)
- slack_workspaces 테이블: Slack 봇 토큰 관리 (2개 워크스페이스 활성)
- 멀티테넌트 B2B SaaS 구조 확인
문서화 작업:
- auth-server-database-schema.md 신규 생성
- 00_아키텍쳐.md에 auth-server 섹션 추가
- 로빙_아키텍쳐_설계_경량.md 인증 관련 섹션 업데이트
- 중복 내용 제거하고 링크 연결 방식 적용

핵심 발견사항:

auth-server는 개별 사용자 인증이 아닌 회사별 Slack 봇 관리 특화 시스템
사용자 테이블 없이 JWT/세션 기반으로 인증 처리
OAuth 토큰은 파일 시스템에 저장하여 다른 로빙 서비스와 공유
로빙 프로젝트 특성상 토큰 공유가 필수적인 구조

실수 교정:

일반적인 보안 가이드(chmod 600) 제안했지만, 로빙 서비스간 토큰 공유 필요성 간과
CLAUDE.md에 "프로젝트 맥락 고려 필수" 규칙 추가하여 재발 방지

최종 결과:

auth-server 완전 문서화 및 아키텍처 문서 통합 완료
로빙 생태계에서 auth-server 역할 명확화
멀티테넌트 B2B 인증 허브로서의 정체성 확립

작성 완료: 2025-07-29 21:20

7.5 KiB Raw Blame History