📌“진도율 기반 콘텐츠 뷰, 단순한 목록 그 이상을 설계하다”

🗓 2025년 4월 30일

✍️ by 박찬희

---

🧭 기획의 시작: ‘단순 리스트’를 넘어, 사용자 맞춤 콘텐츠를 보여주려면

강의 플랫폼에서 “수강 중인 강의 페이지”는 단순한 콘텐츠 리스트로 끝나선 안 된다.

로그인한 사용자라면 진도율이, 비로그인 사용자라면 미리보기 정보만 보이도록 구성해야,

학습 동기 부여와 접근 흐름 제어가 동시에 가능해진다.

이번 구현은 이 철학에서 출발했다.

요구사항	구현 방향
✅ 강의 메타 정보 조회	강의명, 강사명, 소개, 썸네일 등을 상단에 표시
✅ 콘텐츠 리스트 출력	챕터 단위의 콘텐츠 리스트
✅ 사용자 진도율 반영	로그인 사용자의 수강 완료 여부 반영
✅ 비로그인 대응	로그인 없이도 콘텐츠 이름은 열람 가능하지만 진도는 숨김 처리

---

🧩 구조 설계: Controller → Service → DAO → Mapper 흐름

[LecturePlayController]
      ↓
[LecturePlayService]
      ↓
[LecturePlayDAO (MyBatis)]
      ↓
[Mapper XML: LectureMapper.xml]

• Controller: 요청 파싱, 로그인 세션 판별, JSP 전달
• Service: 로직 분기 (진도 반영 여부 등)
• DAO: 실제 SQL 실행
• Mapper: SQL 추상화

💡 주요 클래스 역할

클래스명	설명
LecturePlayController	/lecture/play 요청 핸들링, 로그인 여부 판단
LecturePlayService	진도 포함/미포함 로직 분기
LecturePlayDAO	콘텐츠 + 진도 데이터 조회 SQL 실행

---

🔧 핵심 코드 흐름

1️⃣ Controller에서 진도 분기

int lectureId = Integer.parseInt(req.getParameter("lectureId"));
UserDTO user = (UserDTO) req.getSession().getAttribute("user");

List<ContentDTO> contents = (user != null) ?
  dao.selectContentsWithProgress(lectureId, user.getUserId()) :
  dao.selectContentsByLectureId(lectureId);

→ 로그인 여부에 따라 다른 DAO 메서드 호출

→ 진도 필드(completed or progressRatio) 포함 여부 분기

---

2️⃣ JSP 출력: 진도 뱃지 렌더링

<c:forEach var="content" items="${contents}">
  <li>
    ${content.title}
    <c:if test="${content.completed}">
      <span class="badge">✔ 수강완료</span>
    </c:if>
  </li>
</c:forEach>

• 로그인한 경우 → 수강 완료 표시
• 비로그인한 경우 → 뱃지 생략

---

🧠 설계 고찰: 실무적인 분기와 퍼포먼스 대응

포인트	설명
🔐 세션 인증 처리	HttpSession.getAttribute("user")로 로그인 여부 판단
📦 DAO는 try-with-resources	세션 자동 close로 자원 누수 방지
🔄 SQL은 LEFT JOIN 최적화	콘텐츠 + 진도 테이블을 조인하여 한 번에 가져옴
🧱 Service 분리 이유	Controller는 흐름 제어, 비즈니스 판단은 Service로 분리
🎯 비로그인 경량화	진도 쿼리를 완전히 건너뜀 → DB 부하 감소

---

🧪 주요 테스트 시나리오

테스트 케이스	기대 동작
로그인 유저가 접속	콘텐츠 리스트 + 진도 뱃지 출력
비로그인 유저가 접속	콘텐츠 제목만 출력, 진도 정보 제외
존재하지 않는 강의 ID	404 혹은 사용자 안내 메시지
중복 콘텐츠	Mapper SQL에서 DISTINCT 또는 정렬 처리로 필터링

---

🧱 MyBatis Mapper 구조 예시

<select id="selectContentsWithProgress" resultMap="ContentMap">
  SELECT c.*, p.is_completed
  FROM content c
  LEFT JOIN progress p ON c.content_id = p.content_id AND p.user_id = #{userId}
  WHERE c.lecture_id = #{lectureId}
  ORDER BY c.order_num
</select>

• 진도 정보를 LEFT JOIN으로 한 번에 가져와 퍼포먼스 개선
• ContentDTO에 boolean completed 필드로 매핑

---

💬 면접 포인트 요약

항목	핵심 메시지
✅ MVC 분리	Controller는 흐름만, 로직은 Service, SQL은 DAO
✅ 퍼스널라이징 UI	진도율 기반 콘텐츠 렌더링
✅ 세션 인증 흐름	JSP에서 직접 인증하지 않고 Controller 단에서 분기
✅ 리소스 관리	SqlSession → try-with-resources 구조
✅ 테스트 시나리오 완비	유저 상태별 뷰 차이 검증 가능

---

✅ 회고 & 확장 방향

“이 페이지는 단순한 ‘콘텐츠 리스트’가 아니라,

사용자 행동을 반영한 개인화된 학습 뷰의 첫걸음이었다.”

이번 설계를 기반으로 다음과 같은 기능 확장이 가능하다:

• 📈 진도율에 따라 추천 강의 노출
• 🏅 전체 수강 완료 시 자동으로 인증서 발급
• 📊 관리자 대시보드에서 유저별 학습 통계 제공

---

“데이터를 어떻게 보여주느냐는 UX가 아니라 ‘시스템 아키텍처의 문제’였다.”

— 로그인 여부부터 SQL 조인 구조까지, 진짜 고민이 담긴 퍼스널라이징 설계.