Writing / 기술 기록

판단의 이유를
남깁니다.

설계와 구현, 운영 과정에서 내린 판단과 선택의 근거.
무엇을 바꿨고, 어디까지 확인했는지 씁니다.

문제에서 판단까지

HTTP Tests & Runtime Contracts작성일 2026.05.18

응답 직렬화가 없는 테스트 앱과 문자열 ID를 넣는 팩토리가 실제 API 문제를 가렸습니다. 독립 챗봇 브랜치의 부팅 설정·DTO·저장 타입을 맞추고, 실제 생성 경로를 쓰는 검증의 범위를 다룹니다.

Deployment & Retry State작성일 2026.05.14

오래된 HTML의 청크 오류에서 앱이 다시 뜰 때마다 재시도 횟수를 지웠습니다. 경로·시간별 예산을 부팅 너머로 유지하고, 문서 교체와 자산 보존이 맡는 일을 나눕니다.

Context & Cache작성일 2026.05.10

요약 뒤의 대화를 최근 메시지 창으로 자르면 문맥에 빈 구간이 생길 수 있습니다. 경계 이후 전체 이력과 저장된 질문을 같은 규칙으로 조립하고, 날짜를 캐시 표시 뒤에 둡니다.

Display Policy & Derived Data작성일 2026.05.06

성적 미반영 배지를 켜는 선택이 과제 재적재까지 일으켰습니다. 표시와 적재 조건을 나눠 불필요한 보정 경로를 없애고, 남은 재계산의 완료 유지 정책과 인덱스 비용을 살펴봅니다.

Quota & Async Jobs작성일 2026.05.02

이미 받은 생성 작업은 완료 카운터에 아직 없었습니다. 본인 진행 작업의 예상량을 총량·개인 판단에 더하고, 추정 사용량과 원자적인 예약이 다른 이유를 설명합니다.

Queue & Deduplication작성일 2026.04.29

날짜 기반 잡 ID는 완료 뒤 같은 날의 재투입도 막을 수 있었습니다. 질문 분석 브랜치의 자동·백필 경로에서 진행 중 중복을 합치고, 완료 뒤에도 남는 대상 선정 조건을 살펴봅니다.

AI Analysis & Aggregation작성일 2026.04.25

헤비유저의 인원 비율과 질문 비중은 다릅니다. 질문 분석 기능에서 집계 단위·KST 날짜·주의 임계값을 코드로 정하고, 모델에 전달한 숫자와 해석의 책임을 나눕니다.

Batch Queries & Cache Lifecycle작성일 2026.04.21

LearningX 종합성적부는 일괄 조회와 함께 이 호출이 채운 캐시만 정리하도록 바뀌었습니다. 이후 커스텀 객체 동일성 수정을 이어 살피고, 캐시 범위와 중복 로그인 선택이 결과 일치에 주는 조건을 설명합니다.

File Lifetime & Recovery Policy작성일 2026.04.16

저장된 대화와 외부 파일 ID는 서로 다른 수명을 가집니다. 특정 파일 부재 오류를 대화 비활성화와 새 대화 이동으로 연결하고, 상태 저장 실패·오류 문구·만료 설정 경계값의 한계를 살펴봅니다.

Streaming & Persistence Order작성일 2026.04.11

파일 업로드가 성공해도 병합 대상인 첨부 배열이 아직 없으면 제공자 ID가 메시지에 남지 않습니다. 공통 경로에서 메타데이터를 먼저 저장하고, 앞당겨진 오류 경계와 외부 업로드의 부분 실패를 설명합니다.