Python 서비스에서 API, 데이터흐름, 배치 작업을 개선하고 운영합니다.

배경 · 문제

뉴스 매체와 거래소 공지 수집, AI 요약 자동 발행이 멈춰 있었지만 예외를 출력만 하고 넘기는 코드 때문에 실패가 모니터링에 드러나지 않았습니다. 작업이 성공한 것처럼 보이는 상태에서 실제 수집·발행 경로를 확인해야 했습니다.

결정 · 구현

• 실패를 볼 수 있도록 전환 — 예외를 삼키던 핸들러 130여 곳을 로깅으로 전환하고, 수집 회차 전체의 실패가 드러나도록 기록 기준을 정리했습니다.
• 수집 경로 복구 — 뉴스 매체와 거래소 공지의 실패 원인을 각각 확인해 수정하고, 수집 회차 전체의 실패가 드러나도록 로깅 기준을 정리했습니다.
• AI 요약 발행 경로 수정 — AI 요약 호출을 OpenAI Responses API로 이전하고 응답 형식을 JSON 스키마로 강제해 발행 경로를 다시 연결했습니다.

결과

뉴스 매체 수집 수정은 운영 배포 후 중단됐던 매체의 수집 재개를 확인했으며, 일부 기사 누락은 추가 대응 중입니다. 거래소 공지 2곳은 운영 서버의 정상 수집을 확인했습니다. AI 요약 자동 발행도 운영 재개했습니다.

배경 · 문제

포인트 후원을 하면 후원 표시 댓글이 자동으로 달려야 하는데, 월 30~60%가 사라지고 있었습니다. 오류 알림 하나 없이 간헐적으로만 발생해 재현이 어려웠고, 기능이 출시된 2025년 8월 이후 10개월간 원인이 규명되지 않은 채 남아 있던 문제였습니다.

결정 · 구현

• 원인 규명 — DB 복제 지연 — 후원 저장은 원본 DB에서, 댓글을 다는 백그라운드 작업의 조회는 읽기 전용 복제 DB에서 일어나고 있었습니다. 복제 반영이 조금이라도 늦으면 방금 저장된 후원을 찾지 못해 조용히 실패한다는 것을 코드와 로그 추적으로 규명했습니다.
• 조회 경로 고정 — 후원 직후의 조회는 복제본이 아닌 원본 DB를 바라보도록 고정해, 복제 지연이 결과에 영향을 주지 못하게 했습니다.
• 커밋 후 발송 보장 — 후원 저장을 트랜잭션으로 묶고, 댓글·알림 발송은 저장이 완전히 끝난 뒤에만 실행되도록 순서를 보장했습니다. 그래도 실패하는 경우를 대비한 자동 재시도 안전망도 더했습니다.

결과

2026.06 배포 후 2026.09까지 3개월간 재발 0건을 확인했습니다. 같은 원인으로 누락되던 라이브 공지글도 같은 진단을 적용해 해결했습니다.

배경 · 문제

2018년부터 운영 요구에 맞춰 기능이 덧붙어 온 어드민(운영자용 관리 도구) 백엔드는 API 형식·시간 표기·권한 처리가 기능마다 달랐습니다. 같은 기능이 중복으로 등록돼 있고, 화면에 필요 없는 데이터까지 응답에 실려 나갔으며, 한국시간과 표준시(UTC)가 뒤섞여 시간이 잘못 표시되는 버그도 남아 있어, 새 기능을 붙일 때마다 같은 문제를 반복해 다뤄야 했습니다.

결정 · 구현

• API 응답 형식 표준화 — 화면에 실제로 필요한 데이터만 내려보내도록 응답을 정리해 불필요·민감 정보 노출을 없애고, 오류 응답 형식을 하나로 통일했습니다.
• 시간 표기 통일 — 모든 날짜·시간 값을 세계 표준시(UTC) 기준으로 통일하고, 한국시간으로 잘못 저장되던 데이터를 바로잡아 시간 오표시 버그를 제거했습니다.
• 회원 조회 성능 개선 — 회원 조회 API를 항목별로 분리하고 페이지네이션과 N+1 쿼리 제거를 적용해 조회 성능을 대폭 개선했습니다.
• 중복 · 레거시 정리 — 중복으로 등록돼 있던 레거시 관리자 API 경로 72개를 제거해 보안 위험과 혼선을 줄였습니다.
• 신규 관리 기능 개발 — 본인인증(KYC) 관리, 멤버십 표시 개편, 신고 게시글 일괄 숨김(대량 처리 속도 개선), 이용 제한 단계별 자동 승급과 변경 이력 기록을 새로 구현했습니다.

결과

API 응답과 시간 표기를 통일하고 중복 관리자 경로 72개를 정리했습니다. 가장 느리던 회원 조회는 Postman 반복 호출에서 5초 넘게 걸리던 응답을 300ms 이내로 줄였습니다.

배경 · 문제

webOS 기기의 펌웨어를 사용자가 USB나 서비스센터 없이 네트워크로 직접 업데이트(OTA)할 수 있어야 했습니다. 하지만 펌웨어 전체 용량이 약 2GB에 달해, 느린 가정용 네트워크에서는 다운로드에만 8시간가량 걸려 실사용이 어려웠습니다.

결정 · 구현

• 델타(차등) 업데이트 도입 — 기존 펌웨어와 새 펌웨어의 차이만 계산해 최소 용량의 경량 펌웨어를 생성하는 모듈을 개발했습니다.
• 펌웨어 보안 처리 — 암호화된 펌웨어를 기기에서 안전하게 복호화하는 모듈을 구현했습니다.
• 서버 통신 설계 — MQTT로 기기가 주기적으로 서버와 통신하며 새 업데이트 여부를 확인하도록 설계했습니다.
• 기존 자산 재활용 — 모바일 사업부의 델타 생성 도구를 webOS 환경에 맞게 이식해 개발 기간을 단축하고 범용성을 확보했습니다.

결과

업데이트 용량을 약 2GB에서 10MB 수준으로, 다운로드 시간을 8시간에서 20분 이내로 줄여, 느린 네트워크 환경에서도 안정적인 원격 업데이트를 가능하게 했습니다.