Skip to content

feat: 관리자 전개도 호실 카드에 학생 이름과 출석 여부를 보임 (#394) - #398

Merged
wook10 merged 3 commits into
developfrom
wook10/issue-394
Nov 1, 2026
Merged

wook10 merged 3 commits into
developfrom
wook10/issue-394

Conversation

@wook10

@wook10 wook10 commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

내용

  • 전개도 호실 카드에 호실을 누르지 않아도 학생 이름과 출석 여부를 보인다. 출석은 연두 점과 중립 글자, 미출석은 빈 회색 고리와 흐린 글자이며 화면 낭독기는 이름 출석/미출석으로 읽는다. 순서는 호실 상세와 같은 이름순이다.
  • 서버 GET /api/v1/room/floor/students?floor=&purpose=&date=(CheckUp-server#271)를 층 현황(/room/floor)과 함께 받아 호실에 붙인다. 호실마다 부르지 않고 30초·화면 복귀 갱신(DEC-103)과 지난 날짜 조회(DEC-113)에 이름도 함께 반영된다.
  • 명단 API만 실패하면 이름 없이 예전처럼 번호·인원만 보인다(서버 배포 전에도 전개도가 깨지지 않음). 명단이 있는 호실은 인원도 명단에서 세어 카드 색·인원과 이름 점이 어긋나지 않는다.
  • 배치: 모든 기기에서 2열 2줄, 왼쪽 위 정렬. 긴 이름은 말줄임. 큰 컴퓨터 화면은 글자만 키운다. 높이 620px 이하 화면(휴대폰 가로 포함)은 이름을 숨긴다.
  • 호실 상세는 카드에 있는 명단으로 바로 연다(명단이 없을 때만 호실 명단을 따로 받음). 수동 저장 뒤 카드 이름 표시도 바로 바뀐다.
  • 날짜·층을 바꾼 뒤 새 현황이 오기 전 남아 있는 이전 카드는 누를 수 없게 했다. 이전 날짜 명단에 오늘의 수정이 붙거나 저장 결과가 다른 날짜 화면에 들어가던 문제(#395부터)를 막는다.
  • 목업 이름을 겹치지 않게 바꿨다(성×이름 조합, 고정 시드 섞기).
  • 명세 반영: REQ-UI-001, DEC-115(새), DEC-066 일부 대체, 진행 기록.

확인 필요

  • 이름 2줄이 잘리지 않게 패드 행 최소 높이를 52px→72px로 올렸다. 1024×768 같은 패드 가로 화면과 375×667·360×740 휴대폰은 전개도가 약간 스크롤된다(DEC-066 일부 대체).
  • 360~390px 폭 휴대폰에서 4글자 이름은 말줄임될 수 있다.
  • 카드 인원은 명단 기준이라 DataGSM id가 없는 학생은 빠진다(호실 상세와 같은 기준).
  • 카드 색(전원 출석 라임·일부 미출석 회색)은 디자인 리뷰 제안(강조 뒤집기)을 택하지 않고 REQ-UI-001 그대로 두었다.

검사

  • web: npm run check(lint·타입·포맷·테스트 723개·빌드) 통과, npm run harness:check 통과.
  • 헤드리스 Chrome으로 확인용 페이지(/admin/state-demo/preview-frame/home)를 17가지 크기 × 3·4·5층에서 측정: 가로 넘침·카드 밖 이름 잘림 없음.
  • 같은 페이지에서 상세 열기·수정 저장 반영·층 탭·지난 날짜 조회 전용·받는 중 클릭 차단을 직접 조작해 확인.
  • 미검증: 실서버·운영 배포의 새 API 응답, 실제 기기 화면, 5~6인실, 브라우저에서의 30초 자동 갱신(단위 테스트로만 확인).
  • 새로 추가한 "받는 중 클릭 차단" 테스트가 npm run check 첫 실행에서 한 번 실패했고 이후 4회 재실행은 모두 통과했다. 원인은 확인하지 못했다.

Closes #394

- 이름을 모든 기기에서 2열 2줄, 왼쪽 위 정렬로 두고 출석은 연두 점, 미출석은 회색 고리로 표시
- 명단 API만 실패하면 이름 없이 인원만 보이고, 명단이 있으면 인원도 명단에서 세어 점과 맞춤
- 호실 상세는 카드 명단으로 바로 열고, 새 날짜·층을 받는 동안 이전 카드는 누를 수 없게 함
- 패드 행 최소 72px, 높이 620px 이하 화면은 이름을 숨김, 스켈레톤 행 높이 맞춤
- 목업 이름을 겹치지 않게 만들고 REQ-UI-001·DEC-114 반영
develop의 #396이 DEC-114를 먼저 사용해 이 PR의 결정을 DEC-115로 옮기고 관련 참조를 고쳤다.
@wook10
wook10 merged commit 425dd98 into develop Nov 1, 2026
7 of 8 checks passed
@wook10
wook10 deleted the wook10/issue-394 branch November 1, 2026 12:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants