문제 원인

• --reload가 개발용 재기동 프로세스를 하나 더 띄움
• 기존 uvicorn 프로세스가 종료되지 않고 남음
• 보안 프로그램이 포트를 다시 차단
• 노트북 절전/화면 잠금 이후 네트워크 바인딩이 꼬임

해결책

• 실사용 배포는 --reload 없이 실행
• 포트 충돌 시 기존 프로세스를 먼저 kill
• 고정 포트 표준을 팀에서 정함 (예: 8502, 8512, 8522)
• Windows 방화벽 인바운드 허용 규칙 생성
• 절전 모드 해제 또는 전원 옵션 조정

Nginx 역할

• 외부 요청을 받아 내부 앱으로 전달
• 하나의 포트(80/443) 뒤에 여러 서비스 연결
• /report, /chat, /dashboard 식으로 경로 분기
• 정적 파일/압축/접속 로그 관리

장점

• 동료는 주소 하나만 기억하면 됨
• 앱 포트가 바뀌어도 Nginx 설정만 손보면 됨
• 사내 공유용 서비스 구조가 훨씬 안정적
• 나중에 인증/접근통제도 확장 가능

개인 PC의 한계

• PC를 끄면 서비스 종료
• 포트/IP 문제 반복
• 담당자 부재 시 중단
• 로그·백업·접근제어가 약함

팀 서버의 장점

• 고정 주소로 안정 운영
• 매일 배치/자동 보고 가능
• 여러 앱을 한 곳에서 통합 운영
• 팀 자산으로 인수인계 가능

하드웨어 권장

• CPU: i5 / Ryzen 5 이상
• RAM: 16GB 이상 (권장 32GB)
• SSD: 500GB 이상 (권장 1TB)
• 유선 LAN, 가능하면 UPS

OS/기본 패키지

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git vim htop net-tools ufw nginx
sudo apt install -y python3-pip python3-venv
sudo apt install -y docker.io docker-compose-v2
sudo systemctl enable docker nginx

운영 원칙

• 서비스는 터미널이 아니라 systemd로 실행
• 앱 앞단은 Nginx로 통합
• 접속 로그 / 에러 로그 / 배치 로그 저장
• 백업 스케줄 필수

관리 명령 예

sudo systemctl start myapp
sudo systemctl stop myapp
sudo systemctl restart myapp
sudo systemctl status myapp

sudo journalctl -u myapp -f

문제

• 3개월 지나면 과거 데이터가 사라짐
• 분기/반기/연간 비교가 어려움
• 개선 효과를 장기적으로 증명하기 어려움

서버가 있으면 가능

• 매일 CUBIC에서 추출 → 팀 서버 DB 적재
• 6개월·1년·3년 장기 보관
• 불량 코드/라인/제품별 장기 추세 분석
• AI 요약과 자동 보고의 품질 향상

지금 상태: 저장소

• 파일은 쌓이지만 활용은 사람 손에 의존
• 검색/집계/시각화가 느림
• 자동 보고·자동 분석이 없음
• “큰 창고” 역할은 하지만 시스템은 아님

서버로 전환 시: 팀 플랫폼

• 웹 조회 / 조건 검색 / 대시보드 제공
• 일일/주간 자동 리포트 생성
• 품질팀 공용 URL로 서비스화
• 장기 데이터 기반 AI 분석 가능

Codex가 대신해줄 수 있는 것

• Ubuntu 설치 후 기본 패키지 명령 정리
• Nginx / FastAPI / Docker 설치 명령 작성
• systemd 서비스 파일 생성
• 로그 확인 명령, 재시작 명령 정리
• 에러 로그를 읽고 수정 방향 제안

사람이 꼭 해야 하는 것

• IP/포트/경로 같은 실제 운영값 확인
• 보안/권한/사내 정책 최종 판단
• 배포 후 실제 접속 테스트
• 중요 데이터 백업 여부 확인
• “이대로 운영해도 되나” 최종 승인