OpenAPI & Serialization
생성한 API 타입도 실제 응답과 다를 수 있다
문서와 응답 직렬화는 서로 다른 필드 목록을 읽습니다. DTO 메타데이터 비교와 생성물 재생성 검사를 나누고, 필드 집합의 일치가 실제 HTTP 계약까지 증명하지 않는 이유를 설명합니다.
글 읽기
Writing / 프로젝트 기술 기록
설계와 구현의 판단을 담은 기록 20편
전체 기술 기록 ↗OpenAPI & Serialization
문서와 응답 직렬화는 서로 다른 필드 목록을 읽습니다. DTO 메타데이터 비교와 생성물 재생성 검사를 나누고, 필드 집합의 일치가 실제 HTTP 계약까지 증명하지 않는 이유를 설명합니다.
글 읽기
HTTP Tests & Runtime Contracts
응답 직렬화가 없는 테스트 앱과 문자열 ID를 넣는 팩토리가 실제 API 문제를 가렸습니다. 독립 챗봇 브랜치의 부팅 설정·DTO·저장 타입을 맞추고, 실제 생성 경로를 쓰는 검증의 범위를 다룹니다.
글 읽기
Context & Cache
요약 뒤의 대화를 최근 메시지 창으로 자르면 문맥에 빈 구간이 생길 수 있습니다. 경계 이후 전체 이력과 저장된 질문을 같은 규칙으로 조립하고, 날짜를 캐시 표시 뒤에 둡니다.
글 읽기
Queue & Deduplication
날짜 기반 잡 ID는 완료 뒤 같은 날의 재투입도 막을 수 있었습니다. 질문 분석 브랜치의 자동·백필 경로에서 진행 중 중복을 합치고, 완료 뒤에도 남는 대상 선정 조건을 살펴봅니다.
글 읽기
AI Analysis & Aggregation
헤비유저의 인원 비율과 질문 비중은 다릅니다. 질문 분석 기능에서 집계 단위·KST 날짜·주의 임계값을 코드로 정하고, 모델에 전달한 숫자와 해석의 책임을 나눕니다.
글 읽기
File Lifetime & Recovery Policy
저장된 대화와 외부 파일 ID는 서로 다른 수명을 가집니다. 특정 파일 부재 오류를 대화 비활성화와 새 대화 이동으로 연결하고, 상태 저장 실패·오류 문구·만료 설정 경계값의 한계를 살펴봅니다.
글 읽기
Streaming & Persistence Order
파일 업로드가 성공해도 병합 대상인 첨부 배열이 아직 없으면 제공자 ID가 메시지에 남지 않습니다. 공통 경로에서 메타데이터를 먼저 저장하고, 앞당겨진 오류 경계와 외부 업로드의 부분 실패를 설명합니다.
글 읽기
NestJS & Test Boundaries
튜터 resolver는 JWT 가드가 채운 로그인 값을 읽으므로 등록 순서가 동작 조건입니다. 항상 통과하는 가드 mock이 가린 의존을 실제 메타데이터 검사로 드러내고, 구성 검사와 HTTP 검증을 구분합니다.
글 읽기
NestJS & Module Boundaries
튜터 API 키의 존재를 묻는 가드가 루트 앱 모듈에 의존해 워커·예약 작업의 의존성을 넓혔습니다. 설정 조회로 그 연결을 제거하고, 남은 순환 처리와 실제 기동 검증의 범위를 나눕니다.
글 읽기
SSO & Session Boundaries
LMS의 짧은 JWT는 로그인 입력으로 사용하고, AI Chat에서는 서버 쿠키 세션을 유지했습니다. URL 토큰 교환과 세션 저장, 후속 CSRF·LTI 변경의 경계를 설명합니다.
글 읽기