clean-architecture-backend-template/docs/superpowers/packages/httpclient/README.md

보존 안내 — 이 파일은 저장소 루트 httpclient-superpowers-package/ 에 있던 납품 패키지의 README다. 2026-08-15 문서 정리에서 설계서·계획서는 docs/superpowers/specs/ 와 docs/superpowers/plans/ 로 통합했고, 실행 불가 상태였던 validate_httpclient_docs.py 는 제거했다. 아래 본문은 납품 시점의 기록이므로 제거된 파일을 가리키는 문장은 더 이상 유효하지 않다.

HTTP Client Superpowers 설계 패키지

이 패키지는 Java/Spring 외부 HTTP Client 플랫폼 설계 심층 리서치를 기반으로 작성한 설계서와 구현 계획서다.

파일

• docs/superpowers/specs/2026-08-08-httpclient-platform-design.md
• docs/superpowers/plans/2026-08-08-httpclient-platform-implementation-plan.md
• VALIDATION.md
• validate_httpclient_docs.py

구현 기준

• Java 21
• Gradle Kotlin DSL
• 공통 API는 Spring Framework 6.2 기준
• Spring Framework 7.0 호환성 검증
• Apache HttpClient 5 + RestClient
• JDK HttpClient + RestClient
• Reactor Netty + WebClient
• Jetty HTTP/3 Experimental

실제 Backend Skeleton 저장소가 제공되지 않았으므로 package 경로와 Gradle 구조는 설계서의 명시적 구현 가정이다. 구현 전 저장소의 기존 convention과 root package에 맞춰 경로만 조정하고 공개 계약과 정책 의미론은 유지한다.