qcast-api/.claude/memory/feedback_proactive_middle_server.md
2026-05-06 15:39:34 +09:00

16 lines
1.3 KiB
Markdown

---
name: Middle server DTO updates — act, don't just notify
description: qcast-api is the middle server (QSP API → qcast-api → qcast-front). When QSP or front contract changes, modify qcast-api DTOs directly in the same session
type: feedback
---
아키텍처: **QSP API → qcast-api(중간 서버) → qcast-front**. QSP 응답이나 프론트 요청 스키마가 바뀌면 qcast-api DTO를 통과해야 하므로 DTO 수정이 반드시 필요하다. "통보 템플릿"만 만들고 DTO 수정을 미루지 말 것.
**Why:** qcast-api 자체가 중간 서버다. 외부 통보할 "다른 팀의 서버"가 따로 있지 않다. 사용자가 한 번 물어봤을 때 통보문만 주고 DTO 수정을 미루면, 다음 날 사용자가 "DTO에 추가해야 하는 거 아닌가?"라고 다시 물어 같은 작업을 두 번 하게 된다. 사용자 피드백(2026-04-22): "어제 명령했을 때는 추가 안 하고, 내가 오늘 다시 물으니깐 추가하면 일을 두번 하게 만들어."
**How to apply:**
- QSP 응답 변경 → `dto/` 하위 Response DTO 필드 추가
- 프론트 요청 변경 → `dto/` 하위 Request DTO 필드 추가
- 분석 후 바로 Edit으로 반영, "반영할까요?" 재확인 없이 진행
- 통보 템플릿은 QSP 백엔드 팀 쪽에만 해당 (qcast-api 내부는 직접 수정)