Skip to content

[feat] 층별 학생 출석 일괄 조회 API - #271

Merged
Fresh-Banana merged 1 commit into
developfrom
feat/floor-student-attendance
Oct 30, 2026
Merged

Fresh-Banana merged 1 commit into
developfrom
feat/floor-student-attendance

Conversation

@Fresh-Banana

@Fresh-Banana Fresh-Banana commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

✨ 작업 내용

관리자 전개도에서 학생 이름·출석 여부를 보려고 호실마다 명단을 요청하던 흐름을 층 전체 한 번의 요청으로 지원합니다.

  • GET /api/v1/room/floor/students?floor=3&purpose=DORMITORY 추가(기본 용도 DORMITORY).
  • { floor, purpose, rooms: [{ dormitoryRoom, students }] }로 반환하며 학생 항목은 기존 /room/attendance와 같은 student_id, student_name, student_class, student_number, attended입니다.
  • 층 전체를 단일 scalar projection SQL로 조회합니다. 호실 번호순, 학생 이름·학번·내부 id 순으로 정렬하고 로그인 전 동기화된 학생도 포함합니다.
  • Swagger와 별도 하네스 계약·검증 기록을 추가했습니다.

🔍 리뷰 시 참고사항

  • 기존 /room/floor 집계 응답의 호환성을 유지하기 위해 별도 엔드포인트를 선택했습니다.
  • 기존 AdminVerifier로 관리자 권한을 먼저 확인합니다. 학생 조회는 403 ADMIN_ONLY, 비로그인은 401입니다.
  • 호실 상세와 동일하게 DataGSM 학생 id가 없는 학생은 제외합니다. student_id는 내부 DB id가 아닙니다.
  • 요청 용도와 오늘 운영일(08:00 KST 경계)의 현재 출석만 읽습니다. 다른 용도·지난 운영일·수동 미출석을 출석으로 보지 않습니다.
  • 관련 REQ: UI-001·002, AUTH-003, ATT-001·007. 새 컨트롤러/서비스/실제 PostgreSQL 테스트 12개를 추가했습니다. Hibernate 통계로 조회 SQL 1개·엔티티 추가 로딩 0개를 확인했습니다.
  • ./gradlew.bat build --console=plain 통과: 680 통과, 실패 0, 기존 실서버 AI·부하 테스트 2개 비활성(총 682개). PostgreSQL 17·Redis 7을 별도 로컬 Compose 프로젝트로 실행했습니다.
  • Windows Microsoft JDK 25.0.4.1의 C2 CompilerThread access violation 때문에 로컬 검증에만 JAVA_TOOL_OPTIONS=-XX:TieredStopAtLevel=1을 사용했습니다. 서버·CI JVM 설정은 변경하지 않았습니다.
  • npm run harness:check 20개 및 OpenAPI YAML 파싱·내부 참조 검사 통과. 브라우저 E2E·실제 학교 API·운영 배포는 미검증입니다.
  • 하네스 변경은 Start-Up-harness#39에 별도 커밋했습니다. 이 PR에는 서브모듈 포인터만 갱신했습니다.

✅ 체크리스트

  • 문서(README, .env.example 등) 변경이 필요한 경우 작성 또는 수정했나요?
  • 작업한 코드가 정상적으로 동작하는 것을 직접 확인했나요?
  • 필요한 경우 테스트 코드를 작성하거나 수정했나요?
  • Merge 대상 브랜치를 올바르게 설정했나요?
  • PR에 관련 없는 작업이 포함되지 않았나요?
  • 적절한 라벨과 리뷰어를 설정했나요?

📎 관련 이슈

@Fresh-Banana Fresh-Banana added the feature 새로운 기능 추가 label Oct 30, 2026
@Fresh-Banana
Fresh-Banana requested a review from wook10 October 30, 2026 04:23
@Fresh-Banana
Fresh-Banana merged commit 9542dd5 into develop Oct 30, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature 새로운 기능 추가

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants