# LMS (MintSoft)

> LMS 는 학교 서버 한 대에 Docker 로 설치하는 설치형 학습 관리 시스템입니다. 학습자 앱, 교수 콘솔, 운영 콘솔과 실시간 수업으로 구성되며, 계정과 출결, 수업 자료가 학교 서버에 저장됩니다. MintSoft 가 만듭니다. 현재 버전은 0.2.0 입니다.

## 구성

- 학습자 앱: 학생이 과정의 문서와 영상을 학습하고 실시간 수업에 들어가는 화면
- 교수 콘솔: 교수자와 외부 강사가 수업을 열고 출석과 진도를 보는 화면
- 운영 콘솔: 학사·전산 담당자가 학과, 계정, 수강 배정, 자료를 관리하는 화면

## 기능

- 실시간 수업: 영상, 음성, 화면 공유, 채팅, 입장 비밀번호, 3D 자료 함께 보기
- 학습 자료: 문서, 영상, 3D 모델(GLB). 파일 하나의 상한은 300MB
- 교육과정과 진도: 과정에 학습 항목을 묶고 학생별·과목별 진도 확인
- 출석: 수업별 출석부, 학생별 출석률·체류 시간·결석 횟수
- 구성원과 권한: 운영자, 교수자, 외부 강사, 학습자 네 역할
- 학과: 구성원을 학과에 소속시키고 학과별로 필터

## 설치와 운영

- 설정은 `.env` 파일 하나, 설치는 `./scripts/install.sh` 한 번. 다시 돌려도 기존 데이터를 건드리지 않음
- 교내망 IP(사설 인증서 HTTPS) 또는 공인 도메인(자동 인증서) 두 가지 방식
- `./scripts/backup.sh`, `./scripts/restore.sh`, `./scripts/update.sh` 포함. 백업은 tar 파일 하나
- 설치 뒤에는 인터넷 연결 없이 동작(도메인 설치의 인증서 갱신 제외)

## 서버 사양

- 최소: CPU 4코어, 메모리 8GB, 디스크 40GB + 영상 용량
- 권장: CPU 8코어, 메모리 16GB, SSD 200GB 이상
- 운영체제: 64비트 Linux, Ubuntu 22.04/24.04 LTS 권장 (x86_64, arm64)
- 소프트웨어: Docker Engine 24 이상, Docker Compose 2.20 이상

## 사용 순서

1. 처음 로그인: 운영 콘솔을 열고 아이디 admin 과 설치할 때 정한 초기 비밀번호로 로그인한 뒤, 설정 화면에서 비밀번호를 바꿉니다.
2. 학과 만들기: 운영 콘솔의 학과 화면에서 학과 추가를 눌러 교수와 학생이 속할 학과를 만듭니다.
3. 교수·학생 계정 만들기: 교수·학생 화면에서 구성원 추가로 계정을 만들고 역할과 학과를 정합니다.
4. 교육과정과 수강 배정: 교육과정에서 과정과 학습 항목, 담당 교수를 정하고 수강 관리에서 과목별 수강생을 지정합니다.
5. 수업 개설: 교수 콘솔의 내 수업에서 수업 개설을 누르고, 학생 입장 링크를 복사해 학생에게 알립니다.
6. 수업 입장: 학생은 학습자 앱의 수업 메뉴나 받은 링크로 수업방에 들어갑니다.
7. 과정 학습: 학생은 학습 과정에서 수강 중인 과정의 문서와 영상을 순서대로 학습합니다.
8. 출석과 진도 확인: 교수는 출석 통계와 진도 현황에서 수업별 출석률과 학생별 진행 상황을 확인합니다.

## 자주 묻는 질문

### LMS 는 어떤 제품인가요?

학교 서버 한 대에 설치해 쓰는 학습 관리 시스템입니다. 학습자 앱, 교수 콘솔, 운영 콘솔 세 화면과 실시간 수업 기능으로 구성되며 MintSoft 가 만듭니다.

### 클라우드 서비스인가요, 설치형인가요?

설치형입니다. 학교가 보유한 Linux 서버에 Docker 로 설치하고, 계정과 출결, 수업 자료가 모두 그 서버에 저장됩니다.

### 어떤 서버가 필요한가요?

최소 사양은 CPU 4코어, 메모리 8GB, 디스크 40GB 와 영상 용량입니다. 권장 사양은 CPU 8코어, 메모리 16GB, SSD 200GB 이상입니다. 운영체제는 Ubuntu 22.04 또는 24.04 LTS 를 권장하고 Docker Engine 24 이상과 Docker Compose 2.20 이상이 필요합니다.

### 도메인이 없어도 설치할 수 있나요?

네. 교내망 IP 주소만으로 설치할 수 있고, 이때는 사설 인증서로 HTTPS 를 구성합니다. 공인 도메인이 있으면 프록시가 인증서를 받아 옵니다.

### 설치한 뒤에도 인터넷 연결이 필요한가요?

설치할 때만 이미지와 패키지를 받기 위해 인터넷이 필요합니다. 그 뒤로는 외부 연결 없이 동작합니다. 도메인으로 설치한 경우의 인증서 갱신만 예외입니다.

### 백업과 서버 이전은 어떻게 하나요?

백업 스크립트를 실행하면 데이터베이스, 올린 파일, 설정, 인증서가 tar 파일 하나로 나옵니다. 서비스를 멈추지 않고 받을 수 있고, 복원 스크립트로 같은 서버나 새 서버에 되돌립니다.

### 실시간 수업에서는 무엇을 할 수 있나요?

영상, 음성, 화면 공유와 채팅으로 수업을 진행합니다. 수업에 입장 비밀번호를 걸 수 있고 3D 자료를 수업방에 띄워 함께 볼 수 있습니다.

### 사용자 역할은 어떻게 나뉘나요?

운영자, 교수자, 외부 강사, 학습자 네 역할입니다. 운영자는 운영 콘솔, 교수자와 외부 강사는 교수 콘솔, 학습자는 학습자 앱을 씁니다.

## 링크

- [소개 페이지](https://lms.mint-soft.com/)
- [사용법](https://lms.mint-soft.com/#howto)
- [서버 사양](https://lms.mint-soft.com/#spec)
- [도입 문의 — MintSoft](https://www.mint-soft.com/contact/)