[global] 구현 스펙 및 프로젝트 흐름 가이드 추가 - #127
Merged
Merged
Conversation
|
Contributor
Author
|
/review |
exijn
reviewed
Sep 9, 2026
exijn
reviewed
Sep 9, 2026
exijn
reviewed
Sep 9, 2026
gradle-wrapper.properties의 실제 배포 버전과 어긋나 있던 8.11.1 표기를 9.4.0으로 맞춥니다. Claude-Session: https://claude.ai/code/session_011yR7DyHQJNJmK3exTUMjcJ
WashingBan 관련 서비스 3종은 단일 메서드 컨벤션에 따라 execute(...)만 노출하므로, 인터페이스 예시와 컨트롤러 호출부를 실제 구현에 맞춥니다. Claude-Session: https://claude.ai/code/session_011yR7DyHQJNJmK3exTUMjcJ
createBlockExtensionNotification()은 연장 전용 타입을 사용하므로, CANCELLATION_BLOCKED 재사용이라는 설명과 예시 코드를 실제 구현에 맞춥니다. Claude-Session: https://claude.ai/code/session_011yR7DyHQJNJmK3exTUMjcJ
exijn
approved these changes
Sep 10, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
개요
작성 후 저장소에 반영되지 않은 채 로컬에 남아 있던 문서 4건을 추가하였습니다. 기능 스펙 3건과 프로젝트 전반의 흐름을 설명하는 가이드 1건이며, 코드 변경은 없습니다.
본문
프로젝트 흐름 가이드
docs/project-overview.md를 추가하였습니다. 저장소를 처음 접하는 사람을 위해 요청 하나가Controller→Service→Repository를 거치는 흐름과, SmartThings 연동으로 예약 상태가 자동 전이되는 구조를 정리하였습니다.구현 스펙
이미 머지된 기능들의 설계 결정 근거를 남기기 위해 스펙 문서 3건을 추가하였습니다. 기존
docs/spec-admin-penalty.md,docs/spec-admin-proxy-reservation.md와 같은 형식이며, 각 문서의 대상 구현이 현재 코드에 존재함을 확인하였습니다.docs/spec-forced-stop-washing.md— 관리자가 호실 단위로 신규 예약을 무기한 차단하는 기능입니다.WashingBan엔티티 도입 근거와, 기존 활성 예약은 유지한 채 신규 생성만 차단하기로 한 결정을 담았습니다.docs/spec-user-role-change.md—PATCH /api/v2/admin/users/{id}/role설계입니다. 승격과 강등을 단일 엔드포인트로 통합한 이유와 자기 자신 변경 금지, 동일role거부, 마지막ADMIN보호 세 가지 안전 가드를 정리하였습니다.docs/spec-extend-cancellation-block.md— 48시간 취소 차단 기간을 일 단위로 연장하는 기능입니다. 남은 TTL에 누적 추가하는 방식과CANCELLATION_BLOCKED알림 타입을 재사용한 판단을 다룹니다.커밋 분리
문서마다 대상 도메인이 달라
docs(global),docs(admin),docs(user),docs(reservation)네 개 커밋으로 나누었습니다.https://claude.ai/code/session_013RVjxtwAQdfJzGk5ebXS7E