← AI Chat / Tutor 프로젝트

AI Chat / Tutor

설계와 구현의 판단을 담은 기록 20편

전체 기술 기록 ↗

AI Chat / Tutor의 기술 기록

12

HTTP Tests & Runtime Contracts

테스트의 응답과 실제 API의 응답이 달랐다

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

글 읽기
테스트 fixture와 실제 API 응답 계약의 일치 여부 — 글의 주제를 표현한 생성 이미지
13

Context & Cache

요약 이후의 문맥과 캐시 경계를 맞추기

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

글 읽기
접힌 앞부분과 펼친 뒷부분으로 표현한 문맥의 요약과 보존 — 글의 주제를 표현한 생성 이미지
14

Queue & Deduplication

완료 기록과 중복 차단의 수명을 나누기

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

글 읽기
완료 기록과 중복 실행 차단의 서로 다른 보관 수명 — 글의 주제를 표현한 생성 이미지
16

File Lifetime & Recovery Policy

첨부 파일이 만료된 대화를 다시 열 때

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

글 읽기
대화 기록과 외부 첨부 파일의 서로 다른 수명 — 글의 주제를 표현한 생성 이미지
17

Streaming & Persistence Order

첨부 메타데이터보다 먼저 실행된 파일 준비 콜백

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

글 읽기
첨부 메타데이터 준비와 파일 콜백의 실행 순서 — 글의 주제를 표현한 생성 이미지