private/ — LMCache Storage Stack 작업 공간
LMCache 의 SSD I/O 스택을 FDP / HC-SSD / io_uring 활용 관점에서 분석하고,
거기서 도출한 upstream 기여(PR·이슈)를 준비하는 개인 작업 폴더이다.
초기에는 분석/노트만 쌓았으나, 현재는 raw_block 성능 PR(#3636 등)·FDP PoC 검증까지
실제 작업 산출물을 포함한다. 자체 git repo 이며, 변경 이력은 CHANGELOG.md 에 누적한다.
진입점 (먼저 읽어라)
tasks/todo/00_overview.md— 아이템 status·우선순위 SSOT (AREA-N ID). "지금 무엇이 어디까지" 는 여기.tasks/index.md— repo 전체 "무엇을·어디에" 작업 맵 (목표 기준 트랙·디렉터리).CHANGELOG.md— 날짜 역순 변경 이력. 최근 작업 맥락 파악용.goal.txt— 회사 입장과 업무 정의 ("우리 = Storage 회사, LMCache = AI 인프라 접점").architecture-review.md·docs/lmcache_overview.md— 아키텍처 핵심 인사이트 · 코드베이스 지도.
문서 위치 규칙 (한 줄)
분석·배경·외부 PR 분석 = docs/notes/ / 내 PR 작업 산출물 = work/<트랙>/<작업단위>/ / 아이템 status = tasks/todo/00_overview.md.
디렉터리 구조
private/
├── README.md ← (이 파일)
├── CHANGELOG.md ← 변경 이력 (날짜 역순)
├── CLAUDE.md ← private/ 작업 룰 (인덱스 동기화·CHANGELOG 갱신)
├── goal.txt ← 회사 입장 / 업무 정의
├── architecture-review.md ← 아키텍처 Q&A 정리
├── contributors.md ← Samsung 동료 + 담당 영역 맵
├── tasks/ ← 작업 맵 + todo 원장
│ ├── index.md ← repo 전체 작업 맵(목표 기준)
│ └── todo/ ← 00_overview.md(아이템 status SSOT)·discovery/·priority-landscape/·status-meta/
├── work/ ← 내 PR 작업 산출물 (트랙 → 작업단위 폴더 → 파일)
│ ├── raw_block/ ← put-many-batch·dispatch-rollback·batched-remove·recovery·_misc (+ README 성과보드)
│ ├── fdp/ ← FDP PoC 검증 (01~05 단계, status.md)
│ ├── checkpoint/ ← HC-SSD checkpoint overflow (RB-9) 검증·repro
│ ├── reviews/ ← PR 리뷰 노트 (cr-*)
│ └── wiki/ ← 팀 위키 공유용 정제 문서
├── docs/
│ ├── TODO.md ← 초기 분석 TODO (작업 중심은 tasks/ 로 이동)
│ ├── lmcache_overview.md ← 코드베이스 지도
│ └── notes/ ← 분석·배경 노트 (모듈 분석·raw_block 분석·외부 PR #3274 분석)
├── refs/ ← 참조 자료 (FDP/TCO 한국어 번역, PR #3274 분석)
├── raw/ ← 원문 자료 (PDF/docx/메일 등 손대지 않는 입력물)
├── background/ ← 학습용 background 지식 메모 (INDEX.md)
├── tracking/ ← 외부 PR/이슈 추적 dated 스냅샷 (INDEX.md)
├── personal/ ← 개인 정리(아키텍처 리뷰, Daejun 질문 초안 등)
├── deprecated/ ← 폐기/중복/superseded 문서 (원래 상대경로 보존). 인덱싱·CHANGELOG 대상 아님
└── _archive/ ← 폐기된 초기 작업 (참조용)
분석 렌즈 (L1~L4)
모듈 분석 노트는 다음 4개 관점으로 작성한다 (자세한 내용은 docs/TODO.md §0):
| # | 렌즈 | 묻는 질문 |
|---|---|---|
| L1 | Contract | 인터페이스/추상 클래스, 입출력, invariant, 호출 순서 |
| L2 | I/O 경로 | read/write 발생 지점, host buffer ↔ device ↔ disk 흐름 |
| L3 | FDP / HC-SSD 삽입 지점 | placement_id, RUH, stream hint, offload hook 후보 |
| L4 | io_uring 활용 방식 | ring 위치, queue depth, 배치 정책, op 종류, registered buffer |