api2/docs/policy/campus-and-learning.md

# 정책서: 캠퍼스/강좌/학습 흐름

## 캠퍼스 개요
- A★캠퍼스는 A*List 교재를 활용한 상호 교수·학습 활동을 위한 온라인 공간이다.
- 서비스 대상은 A*List 회원인 교사와 학생이며, 운영자는 캠퍼스 인터페이스와 관련 지원 기능을 제공한다.
- 캠퍼스 개인화 요소는 캠퍼스 명칭, 직접 접속 도메인, 로고, GNB 색상이다.

## 캠퍼스 생성 정책
- 캠퍼스 생성 주체는 교사 회원이다.
- 단일 캠퍼스형은 생성 즉시 운영 가능하다.
- 복합 캠퍼스형은 교사 생성 후 관리자 승인 절차를 거친 뒤 운영 가능하다.
- 관리자(Back Office)도 캠퍼스를 직접 생성할 수 있다.

## 캠퍼스 유형
- 단일 캠퍼스형: 1인 교사 공부방 또는 단일 학원형
- 복합 캠퍼스형: 동일 브랜드 하위 가맹 캠퍼스를 갖는 학원형

## 캠퍼스 계층 구조
- 캠퍼스
- 클래스
- 강좌(Lecture)

## 계층별 의미
- 캠퍼스: 운영 단위, 교재/교사/학생/설정 관리의 상위 개념
- 클래스: 교사 1인 기준의 운영 단위
- 강좌: 교재 + 복수 학생 기준의 실제 교수·학습 수행 단위

## 강좌 정책
- 강좌와 교재는 1:1 관계다
- 교재 1종은 단일 ISBN 한 권이 아니라 학습 연관성을 가진 교재 묶음일 수 있다
- 동일 학생이어도 교재가 바뀌면 새 강좌 생성
- 동일 교재여도 학생 구성이 바뀌면 새 강좌 생성
- 강좌 복사 기능을 제공하며 수업 중 강좌도 복사 가능하다
- Live 상태 강좌 수는 제한될 수 있고 종료 강좌를 포함한 총 강좌 수는 무제한이다

## 강좌 생명주기
- 강의 준비중
- 강의 중
- 강의 종료
- 학생 기준 상태로는 수강 대기중, 수강 중, 수강 종료가 별도로 존재한다

## 강좌 운영 규칙
- 강좌 생성 시 교재 선택, 학생 초대, 수업 코스 설계, 과제/평가 생성이 함께 이뤄진다
- 운영 중 학생 중도 초대가 가능하다
- 운영 중 학생 상태를 이용 중지 또는 수강 종료로 변경할 수 있다
- 학생이 운영 중간에 가입하면 이전 과제/평가도 미수행 상태로 제시한다
- 상태 변경 시 학생과 학부모에게 알림이 발송된다

## 교사 업무 흐름
- 캠퍼스 생성 또는 초대 가입
- 캠퍼스 개인화 설정
- 교재 선택 및 클래스/강좌 생성
- 학생/수강생 초대
- 타임라인 기반 수업 코스 설계
- 과제/평가 출제
- 제출 관리, 채점, 피드백
- 학습 현황 및 보고서 생성

## 학생/수강생 학습 흐름
- 초대 URL/초대 코드 기반 강좌 가입 또는 학생 회원 자기주도학습 시작
- 수업 참여
- 과제 수행 및 제출
- 평가 수행 및 제출
- 복습 및 자기주도학습
- 학습 결과/성취도 확인

## 과제/평가 정책
- 과제/평가는 강좌 단위로 출제한다
- 학생은 온라인 과제 뷰어 또는 온라인 학습 콘텐츠 뷰어에서 수행한다
- 제출 기한과 수행률 관리가 필요하다
- 교사는 채점 및 피드백을 입력한다
- 알림장, 이메일, 앱 푸시, SMS가 보조 수단으로 사용된다

## SMS 정책
- 캠퍼스 초대, 학습 알림, 보고서 발송 등에 SMS를 병행 사용할 수 있다
- SMS 수량은 캠퍼스 마스터가 구매/충전하는 구조다
- 발송 성공 시 수량이 차감된다
- 백오피스에서 수량 충전 기능을 제공한다

## 개발 해석 포인트
- 캠퍼스, 클래스, 강좌는 이름이 비슷하지만 역할이 다르므로 테이블/DTO/응답 모델을 명확히 분리해야 한다
- 강좌는 실제 학습 데이터와 과제/평가의 기준 단위이므로, API 설계 시 강좌 식별자를 중심으로 묶는 것이 자연스럽다
- 초대, 가입, 탈퇴, 종료, 상태 변경은 회원 상태와 강좌 소속 상태를 구분해 처리해야 한다