83 lines
3.9 KiB
Markdown
83 lines
3.9 KiB
Markdown
---
|
|
title: blog-topic / streaming-response-not-supported-archunit-ban
|
|
source_type: blog-topic
|
|
status: raw
|
|
related_branches: [feature-streaming-response-contract]
|
|
related_projects: [ca-tmpl]
|
|
tags: [blog-topic, ca-tmpl, api-design, testing, archunit, static-analysis, api-contract]
|
|
created: 2026-07-02
|
|
status_label: ready-for-canonical
|
|
target_audience: backend-engineer
|
|
inspiration_url:
|
|
archive_url:
|
|
---
|
|
|
|
# blog-topic: streaming-response-not-supported-archunit-ban
|
|
|
|
> Layer: `raw/blog-topics/` — 작업 중 나온 블로그 글감 원석. 최종 블로그는 canonical 정제 후 `wiki/blog/`에서 작성한다.
|
|
|
|
## Parent / 부모
|
|
|
|
- [[raw/branch-notes/feature-streaming-response-contract]] — server-push streaming 미지원 결정을 ArchUnit import-ban으로 강제한 branch에서 나온 글감.
|
|
|
|
## 트리거 / Trigger
|
|
|
|
- 트리거 유형: `branch-work`
|
|
- 트리거 날짜: 2026-07-02
|
|
- 트리거 연결 노트: [[raw/branch-notes/feature-streaming-response-contract]]
|
|
|
|
## 글감 / Topic seed
|
|
|
|
- 한 문장 요지: SSE/WebSocket을 지금 지원하지 않는다는 결정을 문서 선언에 그치지 않고 ArchUnit import-ban으로 고정한 이유를 정리한다.
|
|
- 예상 제목 후보:
|
|
- 지원하지 않는 기능도 architecture contract가 될 수 있다
|
|
- SSE/WebSocket 미지원 결정을 ArchUnit으로 강제하기
|
|
|
|
## 핵심 주장 후보 / Claim candidates
|
|
|
|
- 사실 후보:
|
|
- branch에 streaming 미지원 D1과 ArchUnit import-ban D3가 정리되어 있다 — 근거 후보: [[raw/branch-notes/feature-streaming-response-contract]] D1/D3 `:125-138`, DEM `:144-146`, ingest note `:253`.
|
|
- 경험 후보:
|
|
- 기존 `archunit-testcompileonly-fixture` topic은 fixture/classloading 함정에 가까워, 미지원 전략 자체는 별도 글감으로 분리할 수 있다.
|
|
- 의견/해석 후보:
|
|
- skeleton에서 미지원은 빈칸이 아니라 adoption boundary다. 지원하지 않는 surface도 의도적으로 차단해야 한다.
|
|
|
|
## Outline seed
|
|
|
|
1. "아직 안 씀"과 "지원하지 않음"은 다르다 — 후자는 contract로 표현할 수 있다.
|
|
2. import-ban rule의 장점 — 특정 framework API가 product surface로 새어 나오는 것을 막는다.
|
|
3. 예외와 경계 — download streaming 등 차단 제외 범위를 명확히 해야 한다.
|
|
|
|
## Canonical 전환 후보 / Canonical extraction candidates
|
|
|
|
- `wiki/projects/ca-tmpl/streaming-response-support.md` 후보:
|
|
- ca-tmpl streaming response 미지원 project decision과 ArchUnit rule.
|
|
- `wiki/concepts/streaming-response-patterns.md` 후보:
|
|
- SSE/WebSocket/long-polling/chunked response 선택 기준.
|
|
- 필요한 추가 검증:
|
|
- banned API 목록과 fixture/vacuous-pass 방지 테스트.
|
|
|
|
## Sources / 근거 후보
|
|
|
|
- [[raw/branch-notes/feature-streaming-response-contract]] — 미지원 결정과 ArchUnit guard 근거.
|
|
- [[raw/blog-topics/archunit-testcompileonly-fixture-annotation-pattern-2026-06-02]] — 인접한 fixture 함정 topic.
|
|
|
|
## 미해결 / Unknown
|
|
|
|
- 아직 확인해야 할 사실: `StreamingResponseBody` 다운로드 예외처럼 허용 surface가 있는지.
|
|
- 과장하면 안 되는 부분: streaming 기술 자체가 나쁘다고 쓰지 않는다. ca-tmpl skeleton scope에서 미지원으로 둔 결정이다.
|
|
- 블로그로 쓰기 전에 필요한 canonical 정제: project decision과 general streaming concept 분리.
|
|
|
|
## Decision / 처리 결정
|
|
|
|
- 액션: `promote-to-canonical`
|
|
- 이유: `wiki/projects/ca-tmpl/streaming-response-support.md` 에 streaming 미지원 + ArchUnit ban 글감으로 반영했다.
|
|
- 다음 단계: source canonical이 `verified` 상태이므로 이후 `blogify` 대상으로 삼을 수 있다. 단 streaming 기술 자체가 나쁘다는 결론으로 쓰지 않는다.
|
|
|
|
## Related / 관련
|
|
|
|
- 관련 branch: [[raw/branch-notes/feature-streaming-response-contract]]
|
|
- 관련 error:
|
|
- 관련 interview prep:
|
|
- derived blog: 생성 전. 생성 시 `wiki/blog/streaming-response-not-supported-archunit-ban-YYYY-MM-DD.md` 후보
|