feat: 약관 동의 관리 추가

[parkjuyeong0312]

변경 내용

• 현재 약관 조회 API(GET /api/agreements/current)와 약관 원문 리소스를 추가했습니다.
• Google 로그인 요청에 약관 동의 여부를 반영하고, 신규 가입/재동의 필요 사용자 검증을 추가했습니다.
• 사용자 약관 동의 버전/시각을 users에 저장하고 재동의 API(POST /api/users/me/agreements)를 추가했습니다.
• 약관/정책 문서와 docs/ai/features.md, docs/ai/erd.md를 갱신했습니다.
• dev 병합 충돌 해결 중 V1__init.sql 변경을 제거하고 약관 컬럼 추가를 V1.9__add_user_agreements.sql로 분리했습니다.

변경 이유

• 회원 가입 및 약관 변경 시점에 서버 기준 현재 약관 동의 이력을 남기기 위해서입니다.
• 프론트가 약관 버전을 직접 보내지 않고 백엔드 설정과 서버 시간을 기준으로 동의 상태를 관리하기 위해서입니다.
• 초기 마이그레이션 파일을 수정하지 않고 신규 Flyway 버전으로 스키마 변경을 반영하기 위해서입니다.

테스트

• ./gradlew build
• /review-code-against-docs 스킬로 검증
• 그 외 수동 검증: /write-api-specs 기준으로 REST 어노테이션/DTO 계약 확인, /checking-md-conflicts 기준으로 Markdown 참조·중복 규칙 확인

체크리스트

• PR 제목이 커밋 컨벤션 형식을 따른다.
• 변경 사유를 PR 설명에 기록했다.
• 테스트 방법과 결과를 기록했다.
• 문서 변경이 필요한 경우 반영했다.

하네스 변경 체크리스트

• CLAUDE.md(AGENTS.md) 변경이 포함되어 있는가?
• 변경 사유가 PR 설명에 기록되어 있는가?
• 기존 규칙과 충돌하지 않는가?
• 팀원에게 변경 사항을 공유했는가?

[coderabbitai]

Warning

Review limit reached

@parkjuyeong0312, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 14 minutes and 19 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: ee29886f-2b58-4060-b01e-c6eb0ab41db4

📥 Commits

Reviewing files that changed from the base of the PR and between afa2ad9 and de890e4.

📒 Files selected for processing (38)

• docs/ai/README.md
• docs/ai/erd.md
• docs/ai/features.md
• docs/legal/policy-preparation.md
• docs/policy/copyright-policy.md
• docs/policy/operation-policy.md
• docs/policy/operator-info.md
• docs/policy/privacy-policy.md
• docs/policy/terms-of-service.md
• docs/superpowers/plans/2026-06-08-backend-agreements.md
• docs/superpowers/specs/2026-06-08-backend-agreements-design.md
• src/main/java/com/howaboutus/backend/agreements/config/AgreementProperties.java
• src/main/java/com/howaboutus/backend/agreements/controller/AgreementController.java
• src/main/java/com/howaboutus/backend/agreements/controller/dto/AgreementCurrentResponse.java
• src/main/java/com/howaboutus/backend/agreements/controller/dto/AgreementDocumentResponse.java
• src/main/java/com/howaboutus/backend/agreements/service/AgreementService.java
• src/main/java/com/howaboutus/backend/agreements/service/dto/AgreementDocumentResult.java
• src/main/java/com/howaboutus/backend/agreements/service/dto/AgreementVersions.java
• src/main/java/com/howaboutus/backend/auth/controller/AuthController.java
• src/main/java/com/howaboutus/backend/auth/controller/dto/GoogleLoginRequest.java
• src/main/java/com/howaboutus/backend/auth/service/AuthService.java
• src/main/java/com/howaboutus/backend/common/config/SecurityConfig.java
• src/main/java/com/howaboutus/backend/common/error/ErrorCode.java
• src/main/java/com/howaboutus/backend/user/controller/UserAgreementController.java
• src/main/java/com/howaboutus/backend/user/controller/dto/AcceptAgreementsRequest.java
• src/main/java/com/howaboutus/backend/user/entity/User.java
• src/main/java/com/howaboutus/backend/user/service/UserService.java
• src/main/resources/agreements/privacy-policy.md
• src/main/resources/agreements/terms-of-service.md
• src/main/resources/application.yaml
• src/main/resources/db/migration/V1.9__add_user_agreements.sql
• src/test/java/com/howaboutus/backend/agreements/controller/AgreementControllerTest.java
• src/test/java/com/howaboutus/backend/agreements/service/AgreementServiceTest.java
• src/test/java/com/howaboutus/backend/auth/AuthIntegrationTest.java
• src/test/java/com/howaboutus/backend/auth/controller/AuthControllerTest.java
• src/test/java/com/howaboutus/backend/auth/service/AuthServiceTest.java
• src/test/java/com/howaboutus/backend/user/controller/UserAgreementControllerTest.java
• src/test/java/com/howaboutus/backend/user/service/UserServiceTest.java

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud