README

cms-orbit/lms는 Orbit 관리자 엔진 위에 TutorLMS 스타일의 학습 관리(LMS) 도메인을 더하는 패키지입니다. 코스 → 섹션 → 레슨/퀴즈 구조와 수강신청·진도 관리를 Orbit Entity 기반 관리자 화면으로 제공합니다.

이 패키지는 TutorLMS의 기능/구조를 참고해 Orbit 규약으로 새로 구현한 것으로, 원본 코드를 포함하지 않습니다.

단계별 로드맵

단계	내용	상태
Phase 1 — Core LMS	코스/섹션/레슨/퀴즈/수강신청/진도, 강사·수강생	✅ 4.0.0
Phase 2 — 오픈마켓형 수익화	코스 가격·주문·쿠폰·강사 커미션/매출/정산	✅ 4.1.0
Phase 3 — 참여 기능	Q&A·리뷰·과제·수료증	✅ 4.1.0
Phase 4 — 공개 프론트엔드	코스 카탈로그·강의 플레이어·체크아웃·학생 대시보드 (호스트로 publish되는 스캐폴딩)	✅ 4.1.0

오픈마켓(마켓플레이스)

독립 강사가 코스를 판매하고 플랫폼이 커미션을 가져가는 모델입니다. CheckoutService가 주문 → 강사/플랫폼 수익 분배 → 결제 시 수강 등록을 처리합니다. 커미션 기본값은 lms.marketplace.commission_rate(기본 80%, 코스별 commission_rate로 재정의). 관리자 Marketplace 섹션에서 주문·쿠폰·매출·정산을, Engagement 섹션에서 리뷰·Q&A·과제·수료증을 관리합니다.

공개 프론트엔드 스캐폴딩

php artisan lms:install-frontend        # 덮어쓰기: --force
npm run build                            # 또는 npm run dev

코스 카탈로그(/courses), 코스 상세, 강의 플레이어(/learn/...), 체크아웃, 학생 대시보드(/my-courses)의 React/Inertia 페이지와 공개 컨트롤러·라우트를 호스트로 게시합니다. 라라벨 스타터킷처럼 게시 후에는 호스트가 소유·자유롭게 수정합니다. 체크아웃 스캐폴딩은 데모용으로 즉시 결제 완료 처리하므로, 프로덕션에서는 CheckoutController::store()의 표시된 지점에 실제 결제 게이트웨이를 연결하세요.

요구사항

PHP ^8.4
Laravel ^13.0
cms-orbit/core ^4.5

설치

composer require cms-orbit/lms
php artisan migrate

백엔드(엔티티·마이그레이션·메뉴·권한)는 패키지 auto-discovery로 설치만으로 자동 등록됩니다. 호스트 파일 수정이 필요 없습니다.

도메인 모델

Course (lms_courses) — 제목, 슬러그, 강사(user), 난이도, 상태, 카테고리, 소요시간
CourseSection (lms_course_sections) — 코스 내 정렬된 섹션(TutorLMS의 "topic")
Lesson (lms_lessons) — 섹션 내 동영상/텍스트 단위, is_preview 무료 미리보기
Quiz / QuizQuestion — 단일/복수/참거짓 문항(options·correct JSON)
Enrollment (lms_enrollments) — 수강생의 코스 등록, 진도율·상태
LessonProgress (lms_lesson_progress) — 레슨별 완료. Enrollment::recalculateProgress()가 이를 집계해 진도율/완료를 갱신

설정

config('lms.user_model')로 강사/수강생 user 모델을 지정합니다(기본: 앱의 인증 user 모델). 설정을 게시하려면:

php artisan vendor:publish --tag=lms-config

드립 콘텐츠 & 플레이어 옵션

코스에서 드립을 켜고(drip_enabled) 방식(drip_type)을 고릅니다: 수강 후 N일, 특정 날짜, 순차(이전 레슨 완료), 선수 레슨. 레슨별로 drip_days/drip_date/ drip_prerequisite_id를 설정하며 Lesson::isUnlockedFor($enrollment)가 잠금을 판정합니다(무료 미리보기는 항상 열림). 플레이어는 코스별 옵션(탐색 불가, 빨리감기 불가, 자동재생, 완료 후 진행)을 지원하며 스캐폴딩 플레이어가 네이티브 비디오에서 이를 적용합니다.

이수증 & GUI 빌더 (관리자)

이수증 빌더는 Orbit 관리자 엔티티입니다. Engagement → Certificate Templates에서 템플릿을 만들고, 편집 화면의 커스텀 ReactField(lms-certificate-builder) 캔버스에서 텍스트/플레이스홀더를 드래그 배치합니다. 이 컴포넌트는 패키지가 소유하며 frontend.json의 registrations로 자동 등록됩니다(설치 후 php artisan orbit:frontend-sync && npm run build; cms-orbit/core ^4.0.12 필요).

{{student_name}}·{{course_title}}·{{instructor_name}}·{{issued_date}}· {{serial}} 치환을 지원합니다. CertificateService::issue()로 완료 수강에 발급하고 renderHtml()로 인쇄/PDF용 HTML을 렌더합니다. 학생은 스토어프론트의 /certificates/{id}에서 자신의 이수증을 보고 인쇄합니다.

강사 대시보드

/instructor(게시된 스캐폴딩)에서 강사별 코스·수강생·매출(총/정산가능/정산완료)· 최근 리뷰·Q&A를 확인합니다(InstructorDashboardService).

업데이트 노트

4.6.0

cms-orbit/core ^4.5 → ^4.6: core 4.6.0 이 OrbitAccess 라우팅 리졸버와 여러 관리자 화면 수정(PostgreSQL 500, strict mode, orbit:install 의 OrbitProvider 미등록)을 담고 있습니다.
GitHub Actions 워크플로 추가: php 8.4·8.5 로 composer validate 와 pint --test 를 돌리는 ci.yml, 그리고 태그의 composer.json version 이 태그명과 일치하는지 확인하는 release-guard.yml. Packagist 는 불일치 태그를 조용히 무시합니다.
위성 패키지의 CI 는 cms-orbit/core 를 Packagist 게시본으로 받으므로, "지금 게시된 core 와 이 패키지의 제약이 함께 해석되는가" 까지 같이 검증합니다.
pint 포맷 정규화: pint --test 를 CI 게이트로 걸려면 기존 코드가 설정에 맞아야 해서 함께 정규화했습니다. 순수 포맷 변경이며 동작은 바뀌지 않습니다.

4.5.0

laravel/framework ^11.0 || ^12.0 || ^13.0 → ^13.0: Laravel 13 전용으로 좁혔습니다.
cms-orbit/core ^4.4 → ^4.5.
왜 좁혔나: Pest 5 를 채택한 4.4.0(패키지별 4.1.0)부터 pest-plugin-laravel 5 가 laravel/framework ^13.23 을 요구해, 이 저장소의 테스트가 Laravel 13 으로만 해석됩니다. 즉 Laravel 11·12 호환성을 더 이상 검증할 수 없는 상태로 그 범위를 광고하고 있었습니다. 검증되지 않는 지원 범위를 제약에 남겨두지 않기로 했습니다.
Laravel 11·12 사용자는 업그레이드가 필요합니다. 이번 변경은 실제로 지원 구성을 제거하므로, php 하한 상향과 달리 소비자에게 직접 영향이 있습니다. Laravel 13 으로 올리거나 이전 버전에 머물러야 합니다.

4.4.0

php 제약 ^8.3 → ^8.4: php 8.3 환경에서는 더 이상 설치되지 않습니다.
cms-orbit/core ^4.1 → ^4.4.
생산 의존은 하나도 바뀌지 않았습니다. php 하한 상향으로 새로 받게 된 패키지는 Pest 5 계열(require-dev)뿐입니다. cms-orbit 전 패키지의 직접 의존 20개를 최신판과 전수 대조했고, 나머지 18개는 이미 php ^8.3 에서 최신을 받고 있었습니다. 이번 상향은 기능 확보가 아니라 장기 정리 목적입니다.
소비자의 Laravel 11·12 지원은 유지됩니다 (laravel/framework ^11.0 || ^12.0 || ^13.0).

4.3.1

php 제약 ^8.3 복구: 게시된 태그는 모두 ^8.3 이었으나 main 에서 ^8.2 로 내려가 있었습니다. Laravel 13 은 php ^8.3 을 요구하므로 php ^8.2 + laravel/framework ^13 조합은 php 8.2 환경에서 조용히 Laravel 11 을 설치합니다.
laravel/pint ^1.14 → ^1.30 (1.30 이 php ^8.3 을 요구).
릴리스 파이프라인 도입: .githooks/pre-push 가 composer.json 의 version 필드와 태그명이 어긋난 태그의 푸시를 차단합니다. cms-orbit/core 의 4.0.8 태그가 version: 4.0.7 로 만들어져 Packagist 가 아무 오류 없이 그 태그를 무시했고, 4.0.8 이 게시되지 않은 사실을 아무도 알지 못한 사고가 있었습니다. bin/release <버전> 이 version 갱신·검증·커밋·태그·푸시를 한 동작으로 묶어 이 드리프트를 원천 차단하고, cms-orbit/* 의존이 실제로 Packagist 에 게시되어 있는지 Composer 리졸버로 확인합니다. 저장소를 클론해 composer install 하면 core.hooksPath 가 자동 설정됩니다.

License

MIT

cms-orbit / lms

Maintainers

Package info

Statistics

Security