Skip to content

fix(discord-attendance): 회차 종료를 시각으로 판정한다 — 지난 회차에 출석이 찍히던 문제 - #477

Closed
seeunrosypark wants to merge 6 commits into
betafrom
fix/meeting-end-by-time
Closed

seeunrosypark wants to merge 6 commits into
betafrom
fix/meeting-end-by-time

Conversation

@seeunrosypark

@seeunrosypark seeunrosypark commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

요약

STUDY_MEETING.END_AT 을 쓰는 운영 경로가 없어 한 번 연 회차가 영원히 「진행 중」이었습니다. 그래서 다음 주 !출석체크 가 지난 회차에 출석을 덧찍고, 이번 회차는 열지 않았습니다. 종료를 저장하지 않고 시각으로 계산하도록 바꿉니다.

결정 기록: docs/share/2026-11-17-meeting-end.md (A~E 다섯 방식 비교 · B 채택)

변경 사항

  • StudyMeeting.endsAt() 추가 — END_AT ?? max(SCHEDULED_AT, START_AT) + 120분
    • 늦게 연 회차는 연 시각부터, 일찍 연 회차는 예정 시각부터 셉니다
    • 길이는 StudyMeeting.DURATION 상수 하나 (core-front MEETING_MIN 과 같은 120분)
  • isInProgress() → isInProgress(now) — 시작했고 endsAt 이 안 지났다
  • DiscordAttendanceService.pickMeeting 이 now 로 판정
  • 문서: ERD STUDY_MEETING 상태 표(MISSED 의 여유 = 2시간 창으로 확정), specs/discord-attendance 회차 판정 규칙·경계 표

테스트

테스트 내용
DiscordAttendanceServiceTest 재현 지난주 회차를 운영과 같은 경로(schedule() → start())로 열어 두고 이번 주 체크 → 이번 주 회차가 열린다. 수정 전 코드에서 expected: 2L but was: 1L 로 실패하는 것을 확인했습니다
DiscordAttendanceServiceTest 경계 연 지 130분 뒤 체크 → noMeeting, 소급 입력 없음
StudyMeetingTest 119분 진행 중 / 120분 종료 · 늦게 연 회차 · 일찍 연 회차 · 안 연 회차 · END_AT 우선

./gradlew clean build --no-build-cache 통과 (전체 테스트 · spotless).

리뷰 때 봐 주세요

  • 120분보다 오래 모이는 반은 2시간 뒤 !출석체크 가 noMeeting 이 됩니다. 그런 반이 있으면 DURATION 값을 조정하면 됩니다.
  • 화면(core-front meetingEnd())은 여전히 scheduledAt + 120분 으로 계산합니다. 늦게 연 회차만 서버와 값이 다릅니다. 서버가 endsAt 을 내려 줄지는 share 문서 질문 3 으로 남겨 두었습니다.

체크리스트

Self Review

  • 내 코드를 직접 리뷰했다
  • 불필요한 console.log / println / 디버그 코드를 제거했다
  • 변수·함수 이름이 의도를 명확히 드러낸다
  • 에러 핸들링이 빠진 경로가 없다

테스트

  • Stage 에서 테스트했다 — 디스코드 봇 연동이 필요해 아직 못 했습니다
  • 단위/통합 테스트를 추가 또는 업데이트했다
  • 기존 테스트가 깨지지 않는다 (./gradlew test)

보안 (PUBLIC 레포)

  • 시크릿·토큰·API 키·PII 가 코드에 없다
  • .env 파일이 커밋에 포함되지 않았다

기타

  • 스키마 변경 없음 (END_AT 컬럼은 그대로 둔다)
  • 관련 문서(ERD, 스펙)를 업데이트했다

팀 공유

  • 팀이 알아야 할 결정이 생겼다 → docs/share/2026-11-17-meeting-end.md

🤖 Generated with Claude Code

END_AT 을 쓰는 운영 경로가 없어 한 번 연 회차가 영원히 「진행 중」이었다.
그래서 다음 주 !출석체크 가 지난 회차를 골라 출석을 덧찍고, 이번 회차는 열리지 않았다.

- StudyMeeting.endsAt(): END_AT ?? max(예정 시각, 실제 시작) + 120분
- isInProgress() → isInProgress(now): 시작했고 endsAt 이 안 지났다
- DiscordAttendanceService.pickMeeting 이 now 로 판정
- 재현 테스트(지난주 회차가 열린 채 이번 주 체크) + 120분 경계 테스트
- ERD STUDY_MEETING 상태 표 · discord-attendance 스펙 반영, 결정 기록 docs/share/2026-11-17-meeting-end.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@seeunrosypark

Copy link
Copy Markdown
Contributor Author

@titaniper @j7hwang 스터디 미팅 종료되지 않는 문제가 있어 수정했습니다. 확인 부탁드립니다.

@seeunrosypark seeunrosypark left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

셀프 리뷰

판정 변경 자체는 단순하고, 재현 테스트가 수정 전 실패 → 수정 후 통과하는 것까지 확인했습니다. 다만 아래 1번은 머지 전에 고치는 게 좋겠습니다.

1. 기존 테스트 하나가 이름과 다른 이유로 통과합니다 (고칠 것)

DiscordAttendanceServiceTest.java:168 진행_중인_회차가_2개여도_거절하지_않고_가장_최근에_시작한_것을_고른다

  • older 회차를 3시간 전에 시작한 것으로 만듭니다.
  • 이번 변경 뒤로는 3시간 전에 연 회차는 이미 끝난 회차(120분 경과)입니다.
  • 그래서 지금은 「진행 중 2개 중 최근 것」이 아니라 「진행 중이 1개뿐이라서」 7번이 골라집니다. 테스트가 지키려던 규칙(보이스 채널 둘 · 최근 시작 우선)을 더는 검증하지 못합니다.
  • 고칠 방향: older 를 minus(90, MINUTES) 처럼 120분 안으로 당깁니다. 이 줄은 diff 밖이라 인라인 대신 여기 적습니다.

2. 화면과 서버의 종료 기준이 늦게 연 회차에서만 다릅니다 (알고 넘어감)

  • 서버: max(예정, 시작) + 120분 / core-front meetingEnd(): 예정 + 120분
  • 예정보다 늦게 연 회차만 화면이 먼저 「끝남」으로 봅니다. share 문서 질문 3으로 남겨 두었고, 이 PR 범위는 아닙니다.

3. 배포 직후 동작 변화 (확인 필요)

  • 지금 열린 채로 남아 있는 지난 회차들은 배포 순간 전부 「끝남」이 됩니다. 의도한 변화이고 마이그레이션은 필요 없습니다.
  • 다만 이미 지난 회차에 덧찍힌 출석은 이 PR이 고치지 않습니다. 운영에서 !출석체크 를 두 회차 이상 쓴 반이 있는지 확인이 필요합니다.

확인한 것 (문제 없음)

  • now == endsAt 경계는 끝난 회차로 봅니다 — isBefore 라 맞고, 119/120분 테스트가 지킵니다.
  • 끝난 회차는 isNotStarted() 가 false 라 「시작할 회차」 후보로 다시 열리지 않습니다 → noMeeting. 서비스 테스트(130분)가 지킵니다.
  • isInProgress() 를 쓰던 곳은 pickMeeting 하나뿐이라 시그니처 변경 영향이 없습니다.
  • 스키마 변경 없음. END_AT 이 생기면 계산값보다 우선합니다.

Comment thread docs/erd/STUDY_MEETING.md Resolved
먼저 연 회차를 3시간 전으로 두면 회차 길이(120분)가 지나 끝난 회차가 된다.
그러면 진행 중이 1개뿐이라 「최근 시작 우선」 규칙을 검증하지 못한 채 통과한다.
90분 전으로 당기고, 진행 중임을 테스트 안에서 확인한다 (#477 셀프 리뷰).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@seeunrosypark

Copy link
Copy Markdown
Contributor Author

셀프 리뷰 1번 반영했습니다 — 0227960. 먼저 연 회차를 3시간 전 → 90분 전으로 당기고, 테스트 안에서 older.isInProgress(now) 가 true 인지 먼저 확인합니다. 이제 진행 중 회차 2개 중 최근 것을 고르는 규칙을 실제로 검증합니다. DiscordAttendanceServiceTest 15개 통과.

seeunrosypark and others added 3 commits November 17, 2026 23:20
#477 셀프 리뷰 반영.
- DiscordAttendanceService.MEETING_PICK_WINDOW → StudyMeeting.OPEN_WINDOW · isOpenable(now)
  ERD 의 MISSED 판정이 같은 값을 쓰므로 api 모듈이 아니라 도메인에 둔다
- core-front MEETING_MIN 주석에 서버 StudyMeeting.DURATION 과 같아야 한다고 적는다
- isOpenable 경계 테스트 (±2h 포함 · 2h+1s 밖 · 이미 연 회차)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
beta 에 같은 버그를 고친 #423(시작 4시간 뒤 END_AT = 지금으로 닫기)이 있었다.
판정은 이 PR 의 시각 계산(isInProgress(now), 120분)으로 두고, #423 의 닫기는 기록용으로 살린다.
- MEETING_CLOSE_WINDOW(4h) 블록 → StudyMeeting.closeIfOver(now): END_AT 에 지금이 아니라 endsAt 을 적는다
  (지금을 적으면 일주일 뒤 닫힌 회차의 실제 종료가 일주일 뒤로 찍히고, 화면이 그 동안 진행 중으로 그린다)
- #423 테스트를 120분 기준으로 고치고 END_AT = 시작 + 120분을 단언한다
- 재현 · 130분 경계 테스트를 회차 번호 응답(studyMeetingNumber · verifyMarkedOn)에 맞춰 다시 넣는다
- docs/share README 는 beta 행을 모두 살리고 이 건을 맨 끝에 둔다
- ERD END_AT 설명 · discord-attendance 스펙 · share 문서를 합친 방식으로 고친다

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@seeunrosypark

Copy link
Copy Markdown
Contributor Author

셀프 리뷰 반영 · beta 충돌 해결

리뷰 반영

  • 1번(진행 중 2개 테스트) — 0227960
  • 2시간 창을 도메인 StudyMeeting.OPEN_WINDOW · isOpenable(now) 로 옮김, core-front MEETING_MIN 주석에 서버 상수 연결 — 8fb61aa

충돌 해결 — beta 의 #423 과 합쳤습니다 (ebabfef)
beta 에 같은 버그를 고친 #423(11-07)이 이미 있었습니다. !출석체크 때 시작 4시간이 지난 진행 중 회차에 END_AT = 지금 을 써서 닫는 방식입니다. 그대로 합치면 4시간 닫기는 120분 판정 때문에 절대 실행되지 않는 코드가 됩니다. 그래서 이렇게 합쳤습니다.

./gradlew clean build --no-build-cache 통과 (전체 테스트 · spotless).

#423 작성자께: 4시간 → 120분으로 판정이 바뀌고, 닫을 때 기록하는 시각이 달라졌습니다. 의도와 다른 점이 있으면 알려 주세요.

@github-actions

github-actions Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

DB 구조 · studyclub-engineering:backend

beta @ f607914 와 같습니다 — DB 구조 변경 없음.

Prober 에서 ERD 보기

docs/share/README.md 표에서 11-17(회차 종료) 줄과 beta 의 11-18(UI 부품) 줄을 날짜순으로 둘 다 둔다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@seeunrosypark

Copy link
Copy Markdown
Contributor Author

닫습니다.

리뷰 요청드렸던 분들 감사합니다.

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.

1 participant