Claude-51124 46baeaff91 docs: 개발 참조 문서 추가 (reference/)

- API 엔드포인트 정리 (api_endpoints.md)
- 인프라 정보 정리 (infrastructure.md)
- 환경변수 정리 (environment_variables.md)
- 배포 파이프라인 정리 (deployment_pipelines.md)
- 상수/설정값 정리 (constants.md)
- 네이밍 컨벤션 정리 (naming_conventions.md)
- 로깅 규칙 정리 (logging_rules.md)

목적: 개발 시 중복/오류 방지, 빠른 참조
모든 문서 100줄 이하 유지, 파일:줄번호 참조 사용

2025-12-06 13:28:46 +09:00

2.7 KiB

Raw Blame History

인프라 참조

작성일: 2025-12-06 목적: 서버/포트/네트워크 정보 빠른 참조

서버 구성

서버	IP	역할	주요 서비스
51123	192.168.219.45	메인 서버	nginx, Gitea, auth-server, robeing-gateway, frontend-base, PostgreSQL
51124	192.168.219.52	로빙/스킬 서버	rb8001, robeing-monitor, skill-*, ChromaDB

참고: AGENTS.md:78-81, DOCS/book/300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md:27-30

포트 매핑

51123 서버

서비스	포트	프로토콜	설명
nginx	80, 443	HTTP/HTTPS	웹 서버
Gitea	3000	HTTP	Git 저장소
robeing-gateway	8100	HTTP	API 게이트웨이
frontend-base	8000	HTTP	관리자 대시보드
auth-server	9000	HTTP	인증 서버
PostgreSQL	5432	TCP	데이터베이스
Neo4j	7687	TCP	그래프 DB

51124 서버

서비스	포트	프로토콜	설명
rb8001	8001	HTTP	메인 로빙 서비스
robeing-monitor	9024	HTTP	모니터링 서비스
skill-email	8501	HTTP	이메일 스킬
skill-news	8505	HTTP	뉴스 스킬
skill-slack	8502	HTTP	Slack 스킬
skill-rag-file	8508	HTTP	RAG 파일 스킬
skill-calendar	8512	HTTP	캘린더 스킬
skill-embedding	8511	HTTP	임베딩 스킬
skill-publish	-	HTTP	퍼블리싱 스킬
ChromaDB	8000	HTTP	벡터 DB

참고: AGENTS.md:78-81, 각 서비스 docker-compose.yml

네트워크 플로우

배포 플로우

로컬 개발 → Gitea 푸시 → Actions (51123) → SSH (51124) → git pull → docker 재시작

참고: AGENTS.md:83-85

Admin Dashboard 라우팅

사용자 → nginx (51123) → robeing-gateway (8100) → frontend-base (8000)

참고: AGENTS.md:88-92

API 프록시

Frontend → nginx (/gateway/) → Gateway (8100) → 각 서비스

SSH 접속

서버	SSH 포트	사용자	용도
51124	51124	admin	배포 (Gitea Actions)

참고: AGENTS.md:28-29, Gitea Actions 워크플로우

데이터베이스

DB	서버	포트	데이터베이스명	사용자
PostgreSQL	51123	5432	main_db	robeings
Neo4j	51123	7687	-	neo4j
ChromaDB	51124	8000	-	-

참고: DOCS/book/300_architecture/database/tables.md

업데이트: 서버/포트 변경 시 즉시 반영

2.7 KiB Raw Blame History