docs: README.md 수정

Author: ArpaAP

client/README.md

@@ -1,22 +1,18 @@
 # 체스 클라이언트 기능명세
 
 - 여러 화면과 다이얼로그가 존재. 추후 확장성을 고려해야함.
-- 모든 화면은 가장자리에 테두리가 존재함.
 - 서버와의 연동을 고려하여 확장성 고려해서 제작 (서버와의 통신은 common/PROTOCOL.md 참조)
 - 유니코드 문자를 사용한다는 점을 고려
-- 프로덕션 레벨에 준하는 수준으로 제작 (단, 너무 많은 기능을 구현하지는 말것 (점진적으로 개발 예정이므로))
 
 ## 구현된 기능
 
 ### 🎮 메인 화면
 - 게임 시작, 옵션, 종료 메뉴가 존재하고 게임 시작 메뉴에서 다이얼로그로 유저이름을 입력받음
-- 키보드 (1, 2, 3) 또는 마우스로 메뉴 선택 가능
-- SIGINT(Ctrl+C) 신호 무시로 의도치 않은 종료 방지
 
 ### 🔍 매칭 화면
 - 매칭이 시작되면 매칭 대기 중 메시지가 표시되고 업타임을 보여줌
 - 취소 버튼(ESC)을 누르면 취소됨
-- 매칭이 완료되면 게임 화면으로 이동 (현재는 5초 후 자동 이동)
+- 매칭이 완료되면 게임 화면으로 이동
 
 ### ♟️ 게임 화면
 - 체스 보드가 왼쪽에 표시되고, 오른쪽에 채팅과 게임 메뉴가 표시됨
@@ -26,142 +22,30 @@
 - 선택된 기물은 하이라이트로 표시
 
 #### 📢 채팅 시스템
-- 채팅 메시지가 표시되고, 시스템 메시지 지원
-- 최대 50개 메시지 저장, 12개까지 화면에 표시
-- 오래된 메시지는 자동으로 제거
-
-#### 🎯 게임 메뉴
-- 기권, 무승부 제안, 게임 저장, 메인으로 돌아가기 기능
-- 현재 턴 표시
-- 키보드 단축키 지원 (1-4번)
+- 채팅 메시지가 표시되고, 시스템 메시지 또한 표시
 
 ### 🎨 UI/UX 특징
-- 유니코드 체스 기물 사용 (♔♕♖♗♘♙♚♛♜♝♞♟)
 - 체스판 흑백 칸 색상 구분
+- 현재 턴 표시
 - 선택된 기물과 칸 하이라이트
-- 테두리가 있는 윈도우 기반 UI
 - 반응형 레이아웃
 
 ## 빌드 및 실행
 
-### 요구사항
-- Linux 환경
-- 최소 터미널 크기: 90x25
-- ncurses 라이브러리 (ncursesw)
-- pthread 라이브러리
-
 ### 빌드 방법
 ```bash
 # 루트 디렉터리에서
-./build.sh client
-
-# 또는 클라이언트만 빌드
-cd build
 make client
+
+# 또는
+./build.sh client
 ```
 
 ### 실행 방법
 ```bash
 # 빌드 완료 후
-./build/client/client
-
-# 또는 build 디렉터리에서
-cd build/client
-./client
-```
-
-## 사용법
-
-### 메인 화면
-1. `1` 키 또는 마우스 클릭으로 게임 시작
-2. 사용자명 입력 다이얼로그에서 닉네임 입력
-3. `3` 키 또는 `q`로 프로그램 종료
-
-### 매칭 화면
-- 자동으로 상대방을 찾습니다 (현재는 5초 후 시연용 게임 시작)
-- `ESC` 키로 매칭 취소 가능
-
-### 게임 화면
-- **기물 선택**: 체스판의 기물을 마우스로 클릭
-- **기물 이동**: 선택된 기물을 다른 위치로 클릭하여 이동
-- **선택 해제**: 같은 기물을 다시 클릭
-- **게임 메뉴**: 
-  - `1`: 기권
-  - `2`: 무승부 제안
-  - `3`: 게임 저장 (미구현)
-  - `4` 또는 `ESC`: 메인 화면으로 돌아가기
-- **채팅**: `Enter` 키로 간단한 인사말 전송
-
-## 향후 구현 예정 기능
-- [ ] 실제 서버 연동
-- [ ] 완전한 체스 규칙 구현 (캐슬링, 앙파상, 프로모션 등)
-- [ ] 실시간 채팅 입력
-- [ ] PGN 형식 게임 저장/불러오기
-- [ ] 타이머 기능
-- [ ] 게임 리플레이
-- [ ] 옵션 설정 화면
-
-## 파일 구조
-```
-client/
-├── main.c              # 메인 프로그램 파일
-├── game_state.h        # 게임 상태 관리 헤더
-├── game_state.c        # 게임 상태 관리 구현
-├── CMakeLists.txt      # 빌드 설정
-└── README.md           # 이 파일
-```
-
-# ♟️ Multiplayer Chess Game (멀티플레이 체스 게임)
-
-2025-1 시스템프로그래밍 001분반 1팀 팀프로젝트
-
-Linux에서 C로 구현된 터미널 기반 멀티플레이어 체스 게임입니다. 컴파일하는 동안 가벼운 체스 게임을 즐기고 싶은 개발자를 위해 설계되었습니다 — GUI 오버헤드 없이 순수한 CLI의 매력을 경험하세요.
-
-## 🔍 로그 시스템
-
-ncurses를 사용하는 환경에서는 표준 출력이 보이지 않기 때문에, 파일 기반 로그 시스템을 구현했습니다.
-
-### 로그 파일 위치
-- **클라이언트 로그**: `logs/chess_client_[PID].log` (프로젝트 루트의 logs 폴더)
-
-### 로그 레벨
-- `DEBUG`: 상세한 디버그 정보
-- `INFO`: 일반 정보 메시지  
-- `WARN`: 경고 메시지
-- `ERROR`: 오류 메시지
-- `FATAL`: 심각한 오류 메시지
-
-### 실시간 로그 모니터링
-
-1. **별도 터미널에서 로그 확인**:
-   ```bash
-   # 실시간 로그 모니터링 (권장)
-   ./watch_logs.sh
-   
-   # 또는 직접 tail 사용
-   tail -f logs/chess_client_[PID].log
-   ```
-
-2. **특정 레벨만 필터링**:
-   ```bash
-   # 에러만 보기
-   tail -f logs/chess_client_[PID].log | grep ERROR
-   
-   # 워닝 이상만 보기  
-   tail -f logs/chess_client_[PID].log | grep -E "(WARN|ERROR|FATAL)"
-   ```
-
-3. **로그 파일 검색**:
-   ```bash
-   # 특정 함수의 로그만 보기
-   grep "connect_to_server" logs/chess_client_[PID].log
-   
-   # 네트워크 관련 로그만 보기
-   grep -i "network\|connect\|socket" logs/chess_client_[PID].log
-   ```
-
-### 개발자를 위한 팁
+./run.sh client
 
-- 클라이언트를 실행하기 전에 다른 터미널에서 `./watch_logs.sh`를 실행하세요
-- 문제가 발생하면 로그 파일에서 `ERROR`나 `FATAL` 메시지를 확인하세요
-- 네트워크 연결 문제는 `connect_to_server` 함수 로그를 확인하세요
+# 또는
+./run.sh client -h 192.168.1.100 -p 8080
+```

server/README.md

@@ -1,147 +1,31 @@
 # 🔧 Chess Server
 
-Linux에서 C로 구현된 멀티플레이어 체스 게임의 서버 컴포넌트입니다.
+멀티플레이어 체스 게임의 서버
 
 ## 🚀 빌드 및 실행
 
 ### 빌드
 ```bash
 # 서버만 빌드
-./build.sh server
+make server
 
-# 전체 빌드
-./build.sh
+# 또는
+./build.sh server
 ```
 
 ### 실행
 ```bash
 # 기본 포트(8080)로 서버 실행
-./build/server/server
+./run.sh server
 
 # 특정 포트로 서버 실행
-./build/server/server --port 9090
-```
-
-## 📋 로그 시스템
-
-서버는 콘솔에 색상이 있는 로그를 직접 출력합니다. 별도의 로그 파일을 생성하지 않으며, 실시간으로 서버 상태를 확인할 수 있습니다.
-
-### 로그 출력 특징
-- **실시간 콘솔 출력**: 서버 실행 시 터미널에 바로 표시
-- **색상 구분**: 로그 레벨별로 다른 색상 적용
-- **상세한 정보**: 타임스탬프, 파일명:라인번호, 함수명 포함
-
-### 로그 레벨
-- `DEBUG`: 상세한 디버그 정보 (네트워크 이벤트, 메시지 처리 등)
-- `INFO`: 일반 정보 메시지 (클라이언트 연결, 게임 시작 등)
-- `WARN`: 경고 메시지 (매칭 실패, 잘못된 요청 등)
-- `ERROR`: 오류 메시지 (네트워크 오류, 처리 실패 등)
-- `FATAL`: 심각한 오류 메시지 (서버 종료 필요한 오류)
-
-### 🎨 색상 구분
-
-- 🔴 **빨간색**: ERROR, FATAL 메시지
-- 🟡 **노란색**: WARN 메시지  
-- 🟢 **초록색**: INFO 메시지
-- 🔵 **파란색**: DEBUG 메시지
-- 🔵 **하늘색**: 타임스탬프
-- 🟣 **자주색**: 파일명:라인번호
-- ⚪ **회색**: 함수명
-
-### 로그 출력 예시
-
-```
-[2025-06-03 20:16:58] [INFO] main.c:41 main() - Chess server starting... (PID: 159598)
-[2025-06-03 20:16:58] [DEBUG] server_network.c:55 create_and_bind_listener() - Socket created: fd=3
-[2025-06-03 20:16:58] [INFO] server_network.c:161 event_loop() - Starting event loop...
-[2025-06-03 20:17:20] [INFO] server_network.c:156 handle_new_connection() - New client connected: fd=7
-[2025-06-03 20:17:21] [INFO] ping.c:18 handle_ping_message() - Ping received from fd=7: Hello Server!
-[2025-06-03 20:17:25] [INFO] match_manager.c:178 add_player_to_matching() - Player Alice(fd=7) added to waiting queue
+./run.sh server -p 8081
 ```
 
 ## 🏗️ 아키텍처
 
 ### 핵심 컴포넌트
 
 1. **server_network.c**: epoll 기반 네트워크 이벤트 처리
-2. **protocol.c**: protobuf 메시지 직렬화/역직렬화
-3. **match_manager.c**: 매칭 시스템 및 게임 관리
-4. **handlers/**: 메시지 타입별 처리 핸들러들
-5. **common/logger.c**: 스레드 안전 로그 시스템 (콘솔 출력)
-
-## 🛠️ 개발자 가이드
-
-### 실시간 로그 모니터링
-
-서버 실행 시 터미널에서 실시간으로 로그를 확인할 수 있습니다:
-
-```bash
-# 서버 실행 - 로그가 실시간으로 콘솔에 출력됨
-./build/server/server --port 8080
-```
-
-### 디버깅 팁
-
-1. **서버 시작 시 로그 확인**:
-   ```bash
-   # 서버 실행하면 초기화 과정이 로그로 표시됨
-   ./build/server/server
-   ```
-
-2. **연결 문제 진단**:
-   - 클라이언트 연결 시 `New client connected` 메시지 확인
-   - 네트워크 에러 시 빨간색 ERROR 메시지 확인
-
-3. **매칭 시스템 디버깅**:
-   - 매칭 요청 시 `Match request from player` 메시지 확인
-   - 게임 시작 시 `Match found! Game started` 메시지 확인
-
-### 성능 모니터링
-
-```bash
-# 동시 연결 수 확인
-netstat -an | grep :8080 | grep ESTABLISHED | wc -l
-
-# 서버 프로세스 리소스 사용량
-ps aux | grep server
-```
-
-## 🐛 문제 해결
-
-### 일반적인 문제들
-
-1. **포트 이미 사용 중**:
-   ```bash
-   # 포트 사용 프로세스 확인
-   lsof -i :8080
-   
-   # 다른 포트로 실행
-   ./build/server/server --port 9090
-   ```
-
-2. **메모리 누수 디버깅**:
-   ```bash
-   # valgrind로 메모리 검사
-   valgrind --leak-check=full ./build/server/server
-   ```
-
-### 로그를 통한 문제 진단
-
-서버 실행 중 터미널에서 다음 항목들을 확인하세요:
-
-- **초기화 과정**: 서버 시작 시 나타나는 INFO 메시지들
-- **클라이언트 연결**: `New client connected` 메시지
-- **매칭 시스템**: 매칭 요청과 게임 생성 관련 메시지
-- **에러 메시지**: 빨간색으로 표시되는 ERROR/FATAL 메시지
-
-### 로그 출력 리다이렉션
-
-필요한 경우 로그를 파일로 저장할 수 있습니다:
-
-```bash
-# 모든 출력을 파일로 저장
-./build/server/server 2>&1 | tee server_output.log
-
-# 에러만 파일로 저장
-./build/server/server 2> server_errors.log
-``` 
+2. **match_manager.c**: 매칭 시스템 및 게임 관리
+3. **handlers/**: 메시지 타입별 처리 핸들러들