4:1 모니터 그룹 수업 만들기
— 수업 일정 관리 단계별 가이드

마지막 업데이트 2026-11-03

dev 서버 https://ppi-1376-dev.dubuhealth.in/main/class-mgmt 기준. 아동 4명과 진행자 1명이 한 시간대에 함께 하는 수업을 만드는 순서를 정리했다. 코드(apps/web, develop bc408f4b)를 근거로 작성했고, dev 화면에서 직접 따라 해 보지는 않았다. (2026-10-28)

1. 만들 구성 한눈에 보기

아동 A/guest
아동 B/guest
아동 C/guest
아동 D/guest
진행자 1명/monitor-dashboard에서 4명의 카드를 동시에 모니터링
커스텀 그룹 같은 날짜 · 같은 시간대 · 아동 4명 + 진행자 1명

2. 전체 흐름

0아동 4명 그룹 설정→ 1수업 4개 추가→ 2새 커스텀 그룹→ 3나머지 3명 배정→ 4진행자 지정→ 5입장 확인

3. 단계별 안내

0

아동 4명을 '그룹 모니터링'으로 설정

/main/user → 아동 선택 → 수정 → 수업 설정
  1. 수업 유형에 음성을 체크한다. 빠지면 저장할 때 "그룹 수업은 음성 기반이므로, 수업 유형 '음성'이 필수입니다." 알림이 뜬다.
  2. 모니터링 유형을 그룹으로 바꾸고 저장한다.
  3. 나머지 3명도 똑같이 설정한다.
/main/user · 수업 설정
수업 유형
☑ 음성   ☐ 텍스트
모니터링 유형
그룹 ▾
그룹 모니터링은 음성 필수

이 설정이 없으면 수업 목록에 배정 버튼이 나오지 않는다(childIsGroup 조건).

1

아동 4명의 수업을 같은 날짜·시간으로 추가

/main/class-mgmt → 오늘 수업 탭 → 우측 상단 「수업 추가」
  1. 아동 선택에서 아동 A를 검색해 선택한다.
  2. 날짜와 시간을 고른다. 4명 모두 같은 값이어야 한다.
  3. 그룹 아동이라 진행자 선택칸 대신 "그룹 수업 — 진행자가 자동으로 배정됩니다."가 보인다. 그대로 저장한다.
  4. B·C·D도 같은 날짜·시간으로 반복한다.
수업 추가 모달
아동 선택
아동 A
날짜
2026-10-28
시간
16:00
그룹 수업 — 진행자가 자동으로 배정됩니다.
저장
2

첫 아동으로 새 커스텀 그룹 만들기

수업 목록 → 아동 A 행의 그룹 열 「배정」 → 그룹 배정 모달
  1. 아동 A 행에서 배정을 누른다.
  2. 모달 아래쪽의 새 커스텀 그룹을 누른다. 그 시간대에 아동 A가 들어간 커스텀 그룹이 생긴다.
  3. 일반그룹 자동배정은 누르지 않는다. 일반 그룹은 2~3명이 한계라 4:1을 만들 수 없다.
GROUP ASSIGNMENT
배정할 그룹을 선택하세요
이 시간대에 선택할 수 있는 그룹이 없습니다
일반그룹 자동배정
새 커스텀 그룹
3

나머지 3명을 같은 커스텀 그룹에 배정

아동 B·C·D 행마다 「배정」 → 커스텀 그룹 섹션에서 2단계 그룹 선택
  1. B 행의 배정을 누르고, 커스텀 그룹 섹션에서 아동 A가 들어 있는 카드를 선택한다.
  2. C와 D도 같은 카드를 선택한다.
  3. 카드 오른쪽의 현재인원/정원명을 확인한다. 4번째 아동인 D를 넣을 때 정원이 4 이상이어야 한다.
GROUP ASSIGNMENT · 커스텀 그룹
커스텀 그룹 진행자 미배정3/4명
아동 A · 아동 B · 아동 C
커스텀 그룹 …2/2명
정원이 가득 차 선택할 수 없습니다
4

진행자(모니터) 1명 지정

수업 목록의 보라색 그룹 헤더 행
  1. 그룹 헤더에 커스텀 배지, 4명, 진행자 이름(또는 미배정)이 보인다.
  2. 진행자 이름 부분을 클릭하면 「커스텀 그룹 진행자 변경」 모달이 열린다.
  3. 그 시간에 가능한 진행자 중 1명을 골라 저장한다.
수업 목록 · 그룹 헤더
커스텀 G-xxxx  4명진행자 이름 ▸
↳ 커스텀 그룹 진행자 변경 모달
5

입장 확인

진행자: /monitor-dashboard · 아동: /guest
  • 진행자는 /monitor-dashboard로 들어간다. 정규 시간표 기준으로 시작 15분 전부터 들어갈 수 있다.
  • 바로 테스트하려면 수업 목록의 접속 우회 정책 → 임시 개방을 설정한다. 기존 시간표를 무시하고 설정한 임시 시간에 모니터 대시보드가 열린다.
  • 아동 4명은 각자 /guest로 입장한다. 진행자 화면에 카드 4개가 보이면 성공이다.

4. 왜 커스텀 그룹이어야 하나 — 정원 비교

일반 그룹
최대 2~3명
커스텀 그룹
1~10명 (설정값)
구분일반 그룹 (AUTO)커스텀 그룹 (CUSTOM)
정원2 또는 3 (서버 설정)1~10 중 서버 설정값, 기본 2
만드는 방법배정 모달 「일반그룹 자동배정」배정 모달 「새 커스텀 그룹」 또는 툴바 「1:1→커스텀 일괄」
정원을 넘겨 배정하면커스텀 그룹 전환 확인 모달이 뜬다카드가 비활성화된다(선택 불가)
진행자 변경자동 배정그룹 헤더의 진행자 이름 클릭

근거: apps/web/lib/class-group-capacities.ts의 normalizeGroupCapacities. auto는 2·3만 허용하고, custom은 1~10 정수만 허용하며, 범위를 벗어나면 기본값 2로 돌아간다.

5. 막혔을 때

증상원인조치
그룹 열과 「배정」 버튼이 안 보인다로그인 계정이 admin 역할이 아니다admin 계정으로 다시 로그인한다
admin인데 특정 아동만 「배정」이 없다아동의 모니터링 유형이 개별이거나, 수업이 예정(scheduled) 상태가 아니다0단계 설정과 수업 상태를 확인한다
4번째 아동에서 "정원이 가득 차 선택할 수 없습니다"dev 서버의 커스텀 정원이 3 이하다dev 서버의 그룹 정원 설정(maxChildrenByGroupType.custom)을 4 이상으로 올린다
모달에 2단계 그룹이 안 보인다날짜나 시간이 다르다. 후보는 같은 시간대 그룹만 보여 준다수업 추가 때 넣은 날짜·시간을 확인한다
진행자가 대시보드에 못 들어간다시작 15분 전이 아니다「접속 우회 정책 → 임시 개방」을 설정한다

6. 지름길 — 이미 1:1 수업이 여러 개라면

툴바의 1:1→커스텀 일괄을 누르면 화면에 있는 그룹 배정 가능한 1:1 수업을 시간대별 커스텀 그룹으로 한 번에 묶는다. 이 경우에도 커스텀 정원 제한은 똑같이 적용된다.

체크리스트

관련 문서