brain_dogfood/docs/Bug/20260420_readme_access_info.md

문서 개선: Linux 환경 접속 방법 추가 (README.md)

1. 개요 (버그/변경 내용)

• 사용자가 README.md에 서버 실행 방법은 있으나, 실제 접속 경로(URL) 정보가 부족함을 지적함.
• 특히 Linux 환경에서의 접속 포트(5093)와 외부 기기에서의 접속을 위한 IP 확인 방법 안내가 필요함.

2. 조치 사항

• README.md의 한국어/영어 섹션에 각각 '접속 방법(How to Access)' 항목을 추가함.
• brain.py 리팩토링: .env 파일의 PORT 및 DEBUG 환경 변수를 우선적으로 읽도록 수정함.
• 로컬 접속 주소: http://localhost:5093 (기본값) 안내.
• 외부 접속 주소: http://<서버 IP>:5093 (기본값) 안내.
• 포트 커스터마이징: .env에서 사용자가 원하는 포트를 설정할 수 기능 추가 및 README.md 가이드 보완.
• IP 확인 팁: Linux 터미널 명령 hostname -I를 이용한 내부 IP 확인 방법 추가.

3. 결과 및 검증

• README.md 파일에 해당 내용이 정상적으로 반영됨을 확인.
• brain.py의 실제 포트 설정(5093)과 일치함.

4. 향후 주의 사항

• 서버의 기본 포트를 변경할 경우, README.md와 brain.py를 함께 업데이트해야 함.
• 운영 환경(Linux)과 개발 환경(Windows)의 포트가 다르므로(5093 vs 5050), 가이드 작성 시 이를 명확히 구분하여 기술해야 함.