마지막 업데이트 2026-11-03
https://ppi-1376-dev.dubuhealth.in/main/class-mgmt 기준. 아동 4명과 진행자 1명이 한 시간대에 함께 하는 수업을 만드는 순서를 정리했다. 코드(apps/web, develop bc408f4b)를 근거로 작성했고, dev 화면에서 직접 따라 해 보지는 않았다. (2026-10-28)admin 역할 계정에만 보인다(canManageClassGroups).n/정원명의 정원이 4 이상이어야 한다.음성을 체크한다. 빠지면 저장할 때 "그룹 수업은 음성 기반이므로, 수업 유형 '음성'이 필수입니다." 알림이 뜬다.그룹으로 바꾸고 저장한다.이 설정이 없으면 수업 목록에 배정 버튼이 나오지 않는다(childIsGroup 조건).
현재인원/정원명을 확인한다. 4번째 아동인 D를 넣을 때 정원이 4 이상이어야 한다.4명, 진행자 이름(또는 미배정)이 보인다./monitor-dashboard로 들어간다. 정규 시간표 기준으로 시작 15분 전부터 들어갈 수 있다./guest로 입장한다. 진행자 화면에 카드 4개가 보이면 성공이다.| 구분 | 일반 그룹 (AUTO) | 커스텀 그룹 (CUSTOM) |
|---|---|---|
| 정원 | 2 또는 3 (서버 설정) | 1~10 중 서버 설정값, 기본 2 |
| 만드는 방법 | 배정 모달 「일반그룹 자동배정」 | 배정 모달 「새 커스텀 그룹」 또는 툴바 「1:1→커스텀 일괄」 |
| 정원을 넘겨 배정하면 | 커스텀 그룹 전환 확인 모달이 뜬다 | 카드가 비활성화된다(선택 불가) |
| 진행자 변경 | 자동 배정 | 그룹 헤더의 진행자 이름 클릭 |
근거: apps/web/lib/class-group-capacities.ts의 normalizeGroupCapacities. auto는 2·3만 허용하고, custom은 1~10 정수만 허용하며, 범위를 벗어나면 기본값 2로 돌아간다.
| 증상 | 원인 | 조치 |
|---|---|---|
| 그룹 열과 「배정」 버튼이 안 보인다 | 로그인 계정이 admin 역할이 아니다 | admin 계정으로 다시 로그인한다 |
| admin인데 특정 아동만 「배정」이 없다 | 아동의 모니터링 유형이 개별이거나, 수업이 예정(scheduled) 상태가 아니다 | 0단계 설정과 수업 상태를 확인한다 |
| 4번째 아동에서 "정원이 가득 차 선택할 수 없습니다" | dev 서버의 커스텀 정원이 3 이하다 | dev 서버의 그룹 정원 설정(maxChildrenByGroupType.custom)을 4 이상으로 올린다 |
| 모달에 2단계 그룹이 안 보인다 | 날짜나 시간이 다르다. 후보는 같은 시간대 그룹만 보여 준다 | 수업 추가 때 넣은 날짜·시간을 확인한다 |
| 진행자가 대시보드에 못 들어간다 | 시작 15분 전이 아니다 | 「접속 우회 정책 → 임시 개방」을 설정한다 |
툴바의 1:1→커스텀 일괄을 누르면 화면에 있는 그룹 배정 가능한 1:1 수업을 시간대별 커스텀 그룹으로 한 번에 묶는다. 이 경우에도 커스텀 정원 제한은 똑같이 적용된다.
음성 + 모니터링 유형 그룹으로 설정했다4명이 보인다