문제: 설계서·계획서·납품 패키지·증거·학습 문서와 ADR이 기록이라는 표시 없이 지금 문서처럼 읽힌다. 상태 칸이 설계서 72개 중 40개, 계획서는 거의 없고, 있어도 Approved·확정·Accepted.처럼 값이 제각각이며 영어다. 고른 방법: docs/design, docs/history, docs/adr, docs/notification/adr의 .md 246개 맨 위에 같은 모양의 머리 블록을 단다. 칸은 상태·작성일· 요약(한국어 한 문장)·현재 정본, 대체됐으면 대체됨이다. 블록은 표시 줄 두 개로 감싸서 빼면 원문 바이트가 그대로 돌아온다(246개 모두 대조함). - 종류는 폴더가 정하고 둘째 줄에 적는다(plans/evidence는 증거). - 상태는 원래 상태 줄을 고정 어휘로 바꾼 값이다. 상태 줄이 없는 설계서와 체크 상자가 다 표시되지 않은 계획서는 「확인 안 함」. capability-status.md 제거 표로 지운 것이 확인된 설계서 다섯은 「폐기」, 2026-07-20 하네스 설계·계획과 production capability platform 설계는 「대체됨」이다. - 현재 정본은 구조 정리로 옮겨질 수 있는 src/messaging·src/grpc 대신 docs/ 쪽 문서나 옮기지 않는 leaf README를 가리킨다. docs/README.md에 「문서 수명과 언어」「기록 문서의 머리 블록」「문서와 코드를 같은 변경에서 고친다」를 더하고, 파생 서비스 안내에 머리 블록 충돌 가능성을 적었다. 버린 대안: H1 제목 아래에 블록을 두는 안은 보기에는 낫지만 빼는 규칙이 파일마다 달라져 원문 복원이 기계적이지 않다. 「종류」 칸을 따로 두는 안은 폴더와 같은 정보를 두 번 쓰게 한다. 위험·한계: 「확인 안 함」 설계서 38개, 계획서 51개는 지금 유효한지 아무도 판정하지 않았다. 요약은 제목·목표 줄을 보고 쓴 것이라 본문을 끝까지 읽지 않았다. 납품 패키지 셋의 MANIFEST.sha256는 이제 맞지 않는다 (납품 당시 바이트의 해시이고, 블록을 빼면 다시 맞는다). 리뷰 폴더에는 아직 머리 블록을 달지 않았다. 검증: 머리 블록을 뺀 내용과 HEAD 원본 246개 일치, check-work-docs.py rc=0, --links docs·README.md·CLAUDE.md·AGENTS.md 깨진 링크 0.
58 lines
3.3 KiB
Markdown
58 lines
3.3 KiB
Markdown
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
|
> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
|
|
|
- 상태: 보관
|
|
- 작성일: 2026-08-11
|
|
- 요약: Redis 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다.
|
|
- 현재 정본: `docs/redis/support-matrix.md`
|
|
<!-- 머리 블록 끝 -->
|
|
|
|
> **보존 안내** — 이 파일은 저장소 루트 `redis-superpowers-package/` 에 있던 납품 패키지의 README다.
|
|
> 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고,
|
|
> 이 패키지에는 검증 스크립트가 없었다.
|
|
> 아래 본문은 납품 시점의 기록이므로 제거된 파일을 가리키는 문장은 더 이상 유효하지 않다.
|
|
|
|
# Redis Wrapper 및 Typed API 설계 패키지
|
|
|
|
이 패키지는 Spring 기반 Backend Skeleton에서 Redis 자료구조와 명령을 폭넓게 제공하기 위한 설계서와 구현 계획서다.
|
|
|
|
## 문서
|
|
|
|
- `docs/superpowers/specs/2026-08-07-redis-wrapper-typed-api-design.md`
|
|
- 범위와 비지원 범위
|
|
- Redis 버전·배포 모드
|
|
- 모듈과 의존 규칙
|
|
- 자료구조별 동기·Reactive Typed API
|
|
- R1~R4 명령 노출 정책
|
|
- permit·budget·Raw Gateway·Admin Plane
|
|
- namespace·직렬화·TTL·timeout·retry·오류·관측성·ACL
|
|
- Standalone·Sentinel·Cluster
|
|
- 테스트·CI·완료 정의
|
|
|
|
- `docs/superpowers/plans/2026-08-07-redis-wrapper-typed-api-implementation-plan.md`
|
|
- 27개 구현 작업
|
|
- 작업별 생성·수정 파일
|
|
- 작업 간 입력·출력 인터페이스
|
|
- 실패 테스트, 실행 명령, 최소 구현, 통과 검증, 커밋
|
|
- Redis 7.2·7.4·8.2·8.10 및 Sentinel·Cluster 테스트 작업
|
|
|
|
- `VALIDATION.md`
|
|
- 문서 구조와 계획 완전성에 대한 정적 검증 결과
|
|
|
|
## 핵심 결정
|
|
|
|
1. classic Redis 자료구조는 최대한 Typed API로 제공한다.
|
|
2. 고비용·Blocking·다중 키 명령은 permit와 `OperationBudget`을 요구한다.
|
|
3. Typed API에 아직 없는 R1·R2 명령은 승인형 Raw Gateway로 제공한다.
|
|
4. 운영 명령은 별도 Admin Plane, 파괴적 명령은 SDK 차단으로 분리한다.
|
|
5. command catalog는 Redis 공식 metadata에서 생성하고 조직 정책을 오버레이한다.
|
|
6. 동기와 Reactive API를 정식 지원하고 같은 내부 async primitive를 공유한다.
|
|
7. 일반·Blocking·Transaction·Pub/Sub·Admin 연결을 격리한다.
|
|
8. timeout 후 write는 자동 재시도하지 않고 실행 결과 불명을 표현한다.
|
|
|
|
## 적용 전제
|
|
|
|
현재 Backend Skeleton 저장소가 첨부되지 않아 경로와 Gradle 구조는 목표 구조로 확정했다. 실제 저장소에 적용할 때 기존 package naming, convention plugin, dependency management가 더 강한 기준을 이미 갖고 있다면 구조적 계약은 유지하면서 해당 규칙에 맞춘다.
|
|
|
|
입력 Markdown이 참조한 309행 Excel 워크북은 현재 작업 공간에 존재하지 않았다. 따라서 정확한 command matrix는 구현 과정에서 `COMMAND DOCS`, `COMMAND INFO`, `COMMAND GETKEYSANDFLAGS`를 읽어 재생성하고 정책 오버레이를 적용하도록 설계했다.
|