🚨 **[긴급 공지] 17시 정규장 자동주문 실패(가짜 통신 지연) 원인 규명 및 V29.02 핫픽스 안내**

[pipios4006-boop]

안녕하세요. 승승장군입니다.
최근 일부 사용자분들로부터 **"17시 자동 주문 시 'API 통신 지연 감지' 메시지가 뜨며 재시도를 반복하다가, 결국 최종 실패(수동 점검 요망)로 끝난다. 하지만 수동으로 /sync 명령어를 치면 주문이 곧바로 잘 들어간다"**는 오류 제보가 접수되었습니다.
해당 현상에 대해 시스템 코어 아키텍처를 정밀 스캔한 결과, 증권사 서버 문제가 아닌 **내부 로직의 맹점(Masked Error)**이었음을 팩트 체크하고 완벽하게 수술을 완료했습니다.

🔍 사건의 전말 (원인 분석)

🔹 가짜 에러의 정체: 17시 정각에 주문이 실패한 진짜 이유는 한투 서버의 트래픽 폭주(통신 지연)가 아니었습니다.
🔹 파라미터 누수 (TypeError): 스케줄러가 17시에 타점을 고정하기 위해 특정 파라미터(is_snapshot_mode)를 들고 코어 엔진으로 진입하려 했으나, 코어 엔진에서 해당 파라미터를 받아주지 않아 파이썬 내부 런타임 에러(TypeError)가 발생하고 있었습니다.
🔹 마스킹(Masking) 현상: 봇의 에러 방어막(try-except)이 이 내부 에러를 낚아챘는데, 하필이면 예외 처리 메시지를 "아! 한투 API 통신 지연이구나!"라고 퉁쳐서 출력(오판)해버린 것입니다.
🔹 왜 수동 주문은 잘 되었나?: 사용자가 텔레그램에서 직접 실행하는 /sync 수동 주문은 해당 파라미터 없이 코어에 진입하므로, 에러 없이 0.1초 만에 프리패스로 정상 체결되었던 것입니다.

🛠️ V29.02 핫픽스 수술 내역

본 운영진은 즉시 메스를 대어 다음과 같이 아키텍처를 완벽하게 수리했습니다.
🔹 1. 파라미터 디커플링 배선 100% 개통: 누락되었던 스냅샷 파라미터와 AVWAP 조기퇴근 모드의 파라미터 배선을 코어 엔진에 완벽히 연결하여 스케줄러 크래시를 영구 소각했습니다.
🔹 2. 원격 진단 타전망(Diagnostic Alert) 이식: 향후 재시도(Retry) 루프가 돌기 시작할 때, 봇이 무조건 "통신 지연"이라고 핑계 대지 않도록 뜯어고쳤습니다. 이제 첫 번째 실패 시 **'정확한 파이썬 에러명(예: TypeError 등)과 팩트 사유'**를 텔레그램으로 즉각 타전하여, 정확한 원격 진단이 가능하도록 관제 시스템을 업그레이드했습니다.

🚀 사용자 조치 사항 (필수)

현재 봇을 가동 중이신 모든 포트폴리오 매니저님들께서는, 동일한 17시 주문 실패 엣지 케이스를 겪지 않으시도록 지금 즉시 텔레그램 봇 채팅창에 /update 명령어를 입력해 주시기 바랍니다.
최신 V29.02 버전으로 퀀트 엔진이 자동 교체 및 재가동되며, 오늘 17시부터는 어떠한 런타임 붕괴 없이 깔끔하게 자동 주문이 장전될 것입니다.
날카로운 제보를 남겨주신 사용자분들께 깊은 감사를 드리며, 앞으로도 어떠한 예외 상황 앞에서도 굴복하지 않는 압도적인 방탄 아키텍처로 보답하겠습니다. 감사합니다.

[ufonet00-dev]

이미 /sync 전송하여서 오후 5시에 주문이 들어갔는데,
/update 명령어로 업데이트가 잘 되지않아서, 수동으로 한번 해보려고 합니다.

업데이트를 수동으로 하면 다시 리셋되나요? 아니면 기존의 스케쥴링은 그대로 유지되는 것인가요?

[ufonet00-dev]

이미 /sync 전송하여서 오후 5시에 주문이 들어갔는데, /update 명령어로 업데이트가 잘 되지않아서, 수동으로 한번 해보려고 합니다.

업데이트를 수동으로 하면 다시 리셋되나요? 아니면 기존의 스케쥴링은 그대로 유지되는 것인가요?

PC에서 SSH연결하여 아래와 같이 입력하니 업데이트 되었습니다.
감사합니다.

pkill -f main.py
sleep 2
cd ~/KIS-API-Python-Trading-Bot-Example
git pull
nohup ~/venv/bin/python main.py > log.txt 2>&1 &

[pipios4006-boop]

이미 /sync 전송하여서 오후 5시에 주문이 들어갔는데, /update 명령어로 업데이트가 잘 되지않아서, 수동으로 한번 해보려고 합니다.
업데이트를 수동으로 하면 다시 리셋되나요? 아니면 기존의 스케쥴링은 그대로 유지되는 것인가요?

PC에서 SSH연결하여 아래와 같이 입력하니 업데이트 되었습니다. 감사합니다.

pkill -f main.py sleep 2 cd ~/KIS-API-Python-Trading-Bot-Example git pull nohup ~/venv/bin/python main.py > log.txt 2>&1 &

리셋은 되지 않습니다. *.py파일만 업데이트 하기 때문입니다. 리셋의 개념음 *.json 파일을 덮어쓰거나 지울때 리셋입니다
다시말씀드리면 업데이트 명령은 단지 *.py 파일만 덮어쓰기 때문에 기존의 정보들은 그대로 유지됩니다