Files
api2/docs/policy/interfaces-and-operations.md
T

83 lines
3.9 KiB
Markdown

# 정책서: 인터페이스/도메인/운영
## 인터페이스별 역할
- 메인 서비스(`alist.co.kr`)
- 교재/자료, 스마트 콘텐츠, 지원 센터, 마이페이지, 교사 지원 서비스 중심
- 캠퍼스 메인(`a-campus.co.kr`)
- 서비스 소개, 이용 방법, 체험하기, 캠퍼스 진입
- 캠퍼스 교사용(`class.a-campus.co.kr`)
- 강좌/학생/학습/알림/수업준비/캠퍼스 관리 중심
- 캠퍼스 학생용(`student.a-campus.co.kr`)
- 오늘 학습, 셀프 스터디, 나의 학습, 알림방 중심
- 백오피스/CMS(`admin.alist.co.kr`)
- 운영 관리, 교재/콘텐츠/CMS, 파트너, 홍보, 문의, 통계 관리
## 교사용 I/F 핵심 메뉴
- 강좌 관리
- 학생 관리
- 학습 관리
- 소통방
- 수업 준비
- 마이페이지
- 역할에 따라 가맹 캠퍼스 관리, 캠퍼스 관리, 공지 관리 등 추가 메뉴 노출
## 학생용 I/F 핵심 메뉴
- 오늘 학습
- 셀프 스터디
- 나의 학습
- 알림방
- 마이페이지
- 학생만 `학습 교재 추가`, `교재 추가` 같은 자기주도학습 확장 기능 사용 가능
## 백오피스/CMS 핵심 메뉴
- 관리자/권한 관리
- 메뉴 관리
- 파트너/유통업체 관리
- A*List/A★캠퍼스 메인 관리
- 팝업, 이벤트, FAQ, 세미나, 게시판, 1:1 문의
- 교재 분류/레벨 메타 관리
- 교재 관리, 캠퍼스 서비스 교재 관리
- 콘텐츠 저작/관리, 온라인 콘텐츠 관리, 제휴사 콘텐츠 관리
- 학습 관리, 통계 관리
## 도메인 정책
- 메인 서비스와 캠퍼스 서비스 도메인을 분리한다
- 캠퍼스 생성 시 개인화 도메인을 제공한다
- 기본 URL 구조는 `/home/...`, 임대/개인화 URL 구조는 `/{campusId}/...` 이다
- 학생용 기본 자기주도학습 화면은 `student.a-campus.co.kr/home` 이다
- 개인화 도메인은 서버 부하 분산, 확장성, 운영 편의성을 고려한 정책이다
## 캠퍼스 개인화 도메인 개발 정책
- 정책서에는 Next.js 자동 라우팅 + 미들웨어 + 템플릿 파일 자동 생성 방식이 예시로 제시된다
- 핵심 요구사항은 다음과 같다
- 관리자에서 캠퍼스 ID 등록 시 개인화 경로가 반영될 것
- 캠퍼스 ID별 로고/헤더/GNB 스타일을 동적으로 적용할 것
- 허용된 캠퍼스 ID만 접근 가능하도록 제어할 것
- 기본 사용자와 임대/브랜드 사용자의 URL 흐름을 분리할 것
## 서버/소프트웨어 구성
- Web / WAS / DB / File Storage / Legacy / 관리 서버를 분리한 구성을 기본으로 본다
- 정책서 권장 스택
- Web: Linux, Apache 2.4, Node.js / Next.js
- WAS: Linux, Apache/Tomcat 9.x, JDK/OpenJDK, Spring Boot, Gradle, MyBatis, Swagger
- DB: Linux, MariaDB 10.6 이상
- Legacy 서버는 기존 회원 로그인 연계와 앱 유지 목적상 일정 기간 병행 운영한다
## 데이터 이관 정책
- 교재 정보, 수업 자료, e-Book, 온라인 PPT, 레벨테스트, 문항, 내신 수행평가, 세미나, 교재 소개 등은 재구조화 후 이관 대상이다
- 기존 회원 DB는 품질 이슈와 암호화 방식 차이로 직접 이관이 어렵다
- 기존 앱 화면, 일부 ASP 기반 화면, 구 LMS 학습 이력은 신규 구조와 차이가 커서 병행 운영 또는 별도 연계가 필요하다
- 온라인 PPT는 변환기(PPT to HTML)를 거쳐 탑재한다
## 서비스 오픈 정책
- 개발
- 알파 테스트
- 베타 테스트
- 서비스 오픈 및 운영
- 일정 기간 기존 서비스 시스템 병행 운영
## 개발 해석 포인트
- 정책서의 화면 메뉴는 단순 네비게이션이 아니라 권한/역할/도메인 경계 정의에 가깝다
- 도메인과 URL 구조는 운영 정책과 강하게 연결돼 있으므로 하드코딩보다 설정/데이터 기반 관리가 적합하다
- 레거시 병행 운영과 최초 로그인 연동은 회원 기능 수정 시 항상 영향 범위를 같이 봐야 한다