# Roomfit V2 — 개념 사전

> 코드 곳곳에 흩어진 도메인 용어를 한 곳에 모은 reference.
> 새 사람 합류 시 먼저 읽고, 회의에서 단어 충돌하면 여기로 돌아온다.

## 읽기 순서

1. **[roomfit-physics.md](roomfit-physics.md)** — 기기가 무엇인지부터.
   `icmd`, `ifb`, `fLoad`, `weightMode`, `region`, `driveStatus`.
   여기를 모르면 뒤를 못 읽는다.

2. **[data-hierarchy.md](data-hierarchy.md)** — MCU 50ms raw → Session까지 5단계 계층.
   `MotionSample → Rep → Set → Entry → Session`.
   "운동 한 번 하면 어떤 데이터가 어디에 쌓이나"의 답.

3. **[vbt-metrics.md](vbt-metrics.md)** — Velocity-Based Training 지표.
   `MCV / MPV / PCV / Force / Power / Work / Impulse / RFD`.
   `LVP / e1RM / MVT` 추론 모델.

4. **[fatigue-load.md](fatigue-load.md)** — 피로/부하 관리.
   `RPE / RIR / sRPE / Hooper / ACWR / Monotony / NM Readiness`.

5. **[storage-model.md](storage-model.md)** — Supabase 테이블, RLS, MV.
   "어떤 컬럼이 어떤 도메인 개념을 담고 있나"의 답.

## 명명 규칙

- **단위는 필드명에 박는다**: `meanConcentricVelocityMmps`, `concentricWorkJ`, `peakForceKg`.
- **side는 항상 L/R 분리**: 좌우 모터가 독립이라 모든 raw 메트릭이 L/R 쌍.
- **"VBT 모드"** = `Normal / Eccentric / Elastic` (속도가 사용자 effort의 직접 지표).
- **"비-VBT 모드"** = `Isokinetic / Hydraulic / Vibration` (속도가 컨트롤러 영향 받음). VBT 메트릭은 `null`.

## 안 다루는 것

- BLE 프로토콜 — `docs/reference/bluetooth-protocol.md`
- MCU 패킷 포맷 — `docs/reference/mcu-protocol.md`
- 펌웨어 IAP/DFU — `docs/reference/mcu-source/` + GitHub Issue #13
- Rep detection 알고리즘 내부 — `docs/reference/rep-detection-research.md`

이 문서는 "**개념과 의미**"만, 프로토콜·알고리즘 디테일은 `docs/reference/`로.