Skip to content

docs: 반 이동 기록 — 네비게이터가 어느 반에서 언제 왔는지 보고, 옛 반 출석을 새 반 출석부에 표시 - #511

Merged
seeunrosypark merged 2 commits into
betafrom
feat/group-move-log
Nov 19, 2026
Merged

seeunrosypark merged 2 commits into
betafrom
feat/group-move-log

Conversation

@seeunrosypark

Copy link
Copy Markdown
Contributor

요약

반을 옮기면 기록이 남지 않아서, 네비게이터는 크루가 어느 반에서 언제 왔는지 알 수 없었습니다. 반을 지우면 반 이름까지 사라집니다. 반 이동을 새 표에 기록하고, 출석부와 출석률 규칙을 정한 기획·스펙 PR 입니다. 코드는 바꾸지 않았습니다.

결정 배경: docs/share/2026-11-19-group-move-log.md

정한 것

  • 새 표 STUDY_PARTICIPANT_GROUP_MOVE: 반이 실제로 바뀐 명부 행마다 한 줄을 남깁니다. 옛 반·새 반의 ID와 그때 이름, 옮긴 시각, 옮긴 캡틴이 들어갑니다. 반 이동과 같은 트랜잭션에 쓰고, 반에 FK를 걸지 않아서 반을 지워도 남습니다.
    • 운영 감사 로그(ADMIN_AUDIT_LOG)를 쓰지 않는 이유는 share 문서에 적었습니다. 감사 로그에는 IP 같은 민감 기록이 있고, 보관 기한이 개인정보 정책에 묶여 있으며, 반 ID를 담을 칸이 없습니다.
  • 보는 사람: 네비게이터와 캡틴만 봅니다. 크루가 출석부를 열면 이동 정보가 응답에 오지 않습니다.
  • 옮긴 캡틴: 기록만 하고 어떤 응답에도 넣지 않습니다.
  • 새 반 출석부: 옛 반 기록을 같은 회차 번호의 칸에 「A반」 표시와 함께 보여 줍니다. 이 칸은 고칠 수 없습니다. 출석 행은 옮기지 않습니다.
  • 옛 반 출석부: 옮겨 간 크루를 참여 중단처럼 흐린 줄과 「B반으로 이동」 칩으로 남깁니다.
  • 출석률
    • 개인 출석률(출석부 줄, 내 스터디, 완주 점수판): 있었던 반을 모두 합산합니다.
    • 반 평균: 그 반에서 기록된 것만 셉니다.
    • 스터디 전체와 대시보드: 반을 옮기지 않았을 때와 같은 값이 나옵니다.

변경 사항

  • docs/share/2026-11-19-group-move-log.md(새 문서)와 share 목록
  • docs/erd/STUDY_PARTICIPANT_GROUP_MOVE.md(새 문서). ERD README에 표를 추가했고, STUDY_PARTICIPANT.md의 「반 이동 이력」 미확정 항목을 닫았습니다.
  • specs/study-group/spec.md: 반 이동 단계에 기록 규칙을 넣고, 「시작 뒤 반 이동」 미결 항목을 닫았습니다.
  • specs/attendance/spec.md: 반별 구간 산식, groupMoves·movedOut·recordedGroupName·otherGroupAttendances 필드, 가져온 칸을 저장하면 400
  • specs/my-studies/spec.md, specs/dashboard/spec.md: 같은 출석률 규칙

확인 필요 (share 「해석」)

  1. 크루가 출석부를 보면 가져온 칸 없이 출석률 숫자만 받습니다.
  2. 가져온 칸은 새 반에서 고칠 수 없습니다. 고칠 때는 옛 반 출석부에서 고칩니다.
  3. [NEEDS CLARIFICATION] 크루 「내 스터디」 회차 격자에 옛 반 회차도 그릴지 정하지 않았습니다.

다음 PR

  • Story PRD(네비게이터 출석 수정, 캡틴 출석명부)와 playground 프로토타입
  • 백엔드: V60 표, 반 이동 기록 쓰기, AttendanceRateCalculator 구간 계산, 명부 응답 필드, 테스트
  • core-front·back-office-front 출석부 표시

체크리스트

Self Review

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

테스트

  • Stage 에서 테스트했다 (해당 없음, 문서만)
  • 단위/통합 테스트를 추가 또는 업데이트했다 (구현 PR에서)
  • 기존 테스트가 깨지지 않는다 (코드 변경 없음, node scripts/check-dev-scope.mjs 통과)

보안 (PUBLIC 레포)

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

기타

  • 스키마 변경 시 V{n}__*.sql 마이그레이션을 같이 넣었다 (구현 PR에서 V60)
  • 관련 문서(ERD, 스펙)를 업데이트했다
  • 01-planning/stories/** 또는 frontend/apps/playground/**/spec.ts 를 건드렸다면 pnpm --filter playground export-specs --check 통과 확인 (건드리지 않음)

팀 공유

  • 팀이 알아야 할 결정이 생겼다 → docs/share/2026-11-19-group-move-log.md

🤖 Generated with Claude Code

seeunrosypark and others added 2 commits November 19, 2026 21:13
- share 11-19: 새 표 STUDY_PARTICIPANT_GROUP_MOVE 에 반 이동을 남긴다 (감사 로그를 쓰지 않는 이유 포함)
- ERD: 새 표 문서, STUDY_PARTICIPANT 의 반 이동 이력 미확정 닫음
- study-group: 반 이동 단계에서 기록 한 줄 (반 이름 복사, 옮긴 캡틴은 응답에 안 냄)
- attendance: 출석률을 반별 구간으로, 명부 조회에 groupMoves · movedOut (네비게이터 · 캡틴만)
- my-studies · dashboard: 같은 구간 규칙

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- 개인 출석률 · 완주 점수판은 있었던 반의 구간을 모두 합산, 반 평균은 그 반 구간만
- 새 반 출석부가 옛 반 기록을 회차 번호로 맞춰 「A반」 표시와 함께 보여 준다 (출석 행은 옮기지 않음)
- attendance: recordedGroupName · otherGroupAttendances, 가져온 칸 저장은 400
- share 11-19: 이전 결정과 달라진 점, 해석 3개

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@seeunrosypark
seeunrosypark merged commit 7029cdb into beta Nov 19, 2026
5 checks passed
@seeunrosypark
seeunrosypark deleted the feat/group-move-log branch November 19, 2026 12:35
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