<aside> 🧭 권장 안전 기본값 반영 · Convention 2026-07-27.5. 확인된 코드·문서·Git 근거만 유지하고, 실제 장애·운영 성과·수치·조직 맥락은 근거가 없으면 제외했습니다. 실제 Notion UI의 목차 링크와 Full width 확인 전에는 진행 중 검수본으로 유지합니다.

</aside>

0. 결론: 범용 LMS를 확장한 것이 아니라 제품에 필요 없는 계층을 제거했다

영상센터의 콘텐츠 단위는 강의 과정이 아니라 영상 하나였다. 그래서 LectureProduct 아래 Section, Chapter, Media를 계속 유지하는 대신 Product 공통 정보와 영상 전용 세부 모델(ProductVideo 1:1 subtype)만 남겼다. 장바구니·가격·주문·결제·시청 권리 같은 판매 구조는 재사용했다.

이 결정의 핵심은 “더 추상적인 모델”이 아니다. 제품이 실제로 다루는 단위에 모델을 맞추되, 이미 검증된 거래 구조까지 다시 만들지 않는 경계를 정한 것이다.

유지한 것 바꾼 것 판단 기준
Product·Price·Order·Payment·Entitlement Lecture 계층 → ProductVideo 거래 규칙은 재사용
Category·Translation·Attachment 영상 중심 관계와 응답 표시·검색 요구에 맞춤
구독 Policy 가격 추론 → accessType 가격과 접근 의미 분리

1. 문서 목적 / 생성 배경

이식된 LMS 모델은 LectureProduct → Section → Chapter → Media의 네 단계와 ChapterProgress를 전제로 했다. 반면 1단계 요구사항은 영상 한 개가 목록·검색·구매·시청의 한 단위였다. 사용하지 않는 계층을 남기면 생성·조회 API와 운영 화면이 제품에 없는 개념을 계속 설명해야 했다.

erDiagram
  LectureProduct ||--o{ LectureSection : contains
  LectureSection ||--o{ LectureChapter : contains
  LectureChapter ||--o{ LectureMedia : plays
  LectureChapter ||--o{ LectureChapterProgress : tracks

  Product ||--o| ProductVideo : extends
  ProductVideo }o--|| Category : major
  ProductVideo }o--o| Category : minor
  Product ||--o{ ProductPrice : prices
  Product ||--o{ Entitlement : grants

2. 처음 떠올린 방식과 찝찝했던 지점

가장 안전해 보이는 선택은 Lecture 계층을 그대로 두고 영상 한 개를 Section 하나, Chapter 하나, Media 하나로 포장하는 방식이다. schema migration은 작지만 모든 영상마다 의미 없는 중간 row와 join이 생기고, 신규 개발자는 그 계층이 제품 규칙인지 이식 흔적인지 구분하기 어렵다.

반대편의 완전 교체안은 Video를 독립된 도메인 묶음(aggregate)으로 새로 만들고 판매 구조까지 분리하는 것이다. 의미는 깔끔하지만 가격·주문·결제·환불·권한 흐름을 함께 재작성해야 했다. 최종안은 양쪽 비용 사이에서 Product 공통 정보를 유지하고 영상 전용 세부 모델만 평탄화했다.

3. 선택지를 비교하면서 정리한 판단

선택지 장점 한계 판정
Lecture 계층 유지 DB 변경 최소 제품에 없는 계층·join·운영 용어가 남음 제외
Video와 commerce 완전 분리 도메인 의미가 단순 가격·주문·결제·권한 재작성 범위 과다
Product + ProductVideo 1:1 commerce 재사용과 영상 평탄화 모든 영상 조회에 1:1 join 채택

4. 최종 구조 / 책임 경계

flowchart LR
  Product[Product\n공통 상태·번역] --> ProductVideo[ProductVideo\n영상 메타·접근 타입]
  Product --> Price[ProductPrice\n단건·구독 가격]
  Product --> Order[Cart / Order / Payment]
  Product --> Entitlement[Entitlement\n스페셜 구매권]
  ProductVideo --> Category[Category]
  ProductVideo --> Engagement[Engagement / Reaction]
  Product --> Watch[WatchHistory\n시청 사실]

Product는 판매·노출의 공통 헤더, ProductVideo는 Vimeo asset id·길이·카테고리·접근 타입·카운터를 소유한다. 사용자별 조회와 좋아요는 별도 원장에 남기고 ProductVideo의 count는 목록 정렬용 counter cache로 둔다. WatchHistory는 접근권 자체가 아니라 재생 사실과 당시 권한 출처를 보존한다.

5. 설계 계획과 실제 DB 변경(migration)을 분리해서 본다

ADR에는 lecture_products rename과 하위 테이블 drop 계획이 적혀 있다. 그러나 저장소의 실제 통합 초기 migration은 처음부터 product_videos를 생성한다. 또한 이름이 rename_lecture_domain_to_video인 후속 migration은 테이블을 바꾸지 않고 attachment.domain_type의 레거시 값만 VIDEO로 정리한다.

flowchart TD
  ADR[ADR 계획\nLecture 계층 rename/drop] --> Init[통합 초기 migration\nproduct_videos 직접 생성]
  Init --> Attachment[attachment domain 값\nLECTURE 계열 → VIDEO]
  Attachment --> Vimeo[Vimeo URL → asset id backfill]
  Vimeo --> Reactions[engagement/reaction 추가]
  Reactions --> Access[accessType 명시·backfill]
  Access --> Watch[시청 진행·권한 출처 보강]