docs: team/팀을 retro-room/회고방으로 용어 통일 (#65) #68

catturtle123 · 2026-01-31T09:22:31Z

Summary

API 명세서에서 "팀(Team)" 용어를 "회고방(Retro Room)"으로 통일
에러 코드 TEAM → RETRO로 변경
필드명 teamId → retroRoomId, teamName → retroRoomName으로 변경

Changes

README.md

팀(Team) 섹션을 회고방(Retro Room)으로 변경
API 엔드포인트 /api/v1/teams → /api/v1/retro-rooms
에러 코드 체계에서 TEAM 제거, RETRO로 통합

각 API 명세서

파일	변경 내용
012-retrospect-detail.md	teamId → retroRoomId, TEAM4031 → RETRO4031
014-retrospect-participant-create.md	TEAM4031 → RETRO4031, "팀" → "회고방"
015-retrospect-participants-list.md	TEAM4031 → RETRO4031, "팀" → "회고방"
018-retrospect-references-list.md	TEAM4031 → RETRO4031, "팀" → "회고방"
022-retrospect-analysis.md	"팀당" → "회고방당", "팀원" → "참여자"
023-retrospect-search.md	teamName → retroRoomName, "팀" → "회고방"
025-response-like-toggle.md	TEAM4031 → RETRO4031, "팀 멤버" → "회고방 멤버"
026-response-comments-list.md	TEAM4031 → RETRO4031, "팀 멤버" → "회고방 멤버"
027-response-comment-create.md	TEAM4031 → RETRO4031, "팀" → "회고방"

코드 (error.rs)

TEAM4004 주석을 RETRO4004로 수정

Test plan

문서 용어 통일 확인
빌드 성공 확인

closes #65

🤖 Generated with Claude Code

Summary by CodeRabbit

API Changes
- Renamed primary analysis field from "teamInsight" to "insight" across responses and schemas.
Improvements
- Consolidated insight storage and removed the prior team identifier from retrospective data handling.
Documentation
- Standardized wording: replaced "레트로룸" with "회고방", clarified many endpoint titles/descriptions, and adjusted API tag/endpoint annotations for auth and member flows.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

## API 명세서 변경 - README.md: 팀(Team) 섹션을 회고방(Retro Room)으로 변경 - 에러 코드 TEAM → RETRO로 통일 - teamId → retroRoomId, teamName → retroRoomName - "팀" → "회고방" 용어 통일 ## 코드 변경 - error.rs: TEAM4004 주석을 RETRO4004로 수정 ## 수정된 파일 - docs/api-specs/README.md - docs/api-specs/012-retrospect-detail.md - docs/api-specs/014-retrospect-participant-create.md - docs/api-specs/015-retrospect-participants-list.md - docs/api-specs/018-retrospect-references-list.md - docs/api-specs/022-retrospect-analysis.md - docs/api-specs/023-retrospect-search.md - docs/api-specs/025-response-like-toggle.md - docs/api-specs/026-response-comments-list.md - docs/api-specs/027-response-comment-create.md Co-Authored-By: Claude Opus 4.5 <[email protected]>

coderabbitai · 2026-01-31T09:22:37Z

Warning

Rate limit exceeded

@catturtle123 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 3 minutes and 44 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, 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 have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📝 Walkthrough

Walkthrough

Renamed analysis field team_insight/teamInsight to insight across DTOs, entity, service, AI prompts, and tests; removed team_id from the retrospect entity; updated API docs/comments and error message text to use "회고방" terminology.

Changes

Cohort / File(s)	Summary
Retrospect Entity & DTO `codes/server/src/domain/retrospect/entity/retrospect.rs`, `codes/server/src/domain/retrospect/dto.rs`	Renamed `team_insight` → `insight`; removed `team_id` from the retrospect entity; updated `AnalysisResponse` field name and related schema/comments.
Retrospect Service & Logic `codes/server/src/domain/retrospect/service.rs`	Replaced uses of `team_insight` with `insight`, removed `team_id` handling, and updated create/update/read paths and conditional logic referencing analysis state.
Retrospect Handlers & API Docs `codes/server/src/domain/retrospect/handler.rs`	Updated many API doc comments, titles, and response messages to use "회고방" instead of previous terminology; no control-flow changes.
AI Prompts & AI Service Tests `codes/server/src/domain/ai/prompt.rs`, `codes/server/src/domain/ai/service.rs`, `codes/server/tests/ai_analysis_live_test.rs`	Changed system prompt/sample output JSON key `teamInsight` → `insight`; updated tests and assertions, and adjusted AnalysisResponse struct usage in tests.
Auth / Member Docs & Annotations `codes/server/src/domain/auth/handler.rs`, `codes/server/src/domain/member/handler.rs`, `codes/server/src/main.rs`	Adjusted endpoint titles, doc comments, and OpenAPI/utoipa tags (e.g., Member → Auth); no signature or behavior changes.
Errors & Messages `codes/server/src/utils/error.rs`	Reworded documentation comments and error message text to use "회고방" terminology; no runtime behavior changes.
Tests & Examples `codes/server/...`	Updated tests, examples, and assertions across the codebase to reflect renamed field (`insight`) and revised AI prompt/sample JSON.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

Poem

🐇 I hopped through structs, fields anew,
swapped team_insight for simply "insight" true,
team_id drifted off like clover gone,
docs now whisper "회고방" at dawn,
small tidy changes — a celebratory yawn.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly describes the main change: unifying terminology from 'team/팀' to 'retro-room/회고방' across documentation and code.
Linked Issues check	✅ Passed	Code changes comprehensively address linked issue `#65` objectives by renaming team references to retro-room/회고방, updating error codes (TEAM→RETRO), and unifying field names throughout.
Out of Scope Changes check	✅ Passed	All code changes are directly scoped to the terminology unification objective. Field renames (team_insight→insight), error code updates, and documentation revisions align with issue `#65` goals.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch docs/65-rename-retro-room

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

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

Co-Authored-By: Claude Opus 4.5 <[email protected]>

) - retrospect.rs: team_insight → insight, team_id → retro_room_id - dto.rs: team_insight → insight - service.rs: 관련 필드 및 주석 업데이트 - prompt.rs: AI 프롬프트 JSON 필드명 teamInsight → insight - ai/service.rs: 테스트 코드 필드명 업데이트 Co-Authored-By: Claude Opus 4.5 <[email protected]>

- 016-retrospect-draft-save.md: TEAM4031 → RETRO4031 - 020-retrospect-responses-list.md: TEAM4031 → RETRO4031 - 022-retrospect-analysis.md: teamInsight → insight Co-Authored-By: Claude Opus 4.5 <[email protected]>

- retrospect.rs: retro_room_id 필드 제거 (retrospect_room_id만 유지) - service.rs: 회고 생성 시 retro_room_id 설정 제거 DB 컬럼명은 retrospect_room_id 유지, API에서는 camelCase로 retroRoomId 노출 Co-Authored-By: Claude Opus 4.5 <[email protected]>

- teamId → retroRoomId - team_id → retro_room_id - TEAM4031 → RETRO4031 - TEAM4041 → RETRO4041 - TEAM4004 → RETRO4004 - TeamAccessDenied → RetroRoomAccessDenied Co-Authored-By: Claude Opus 4.5 <[email protected]>

- handler.rs: Swagger 설명 "팀 멤버" → "회고방 멤버" - service.rs: 주석 "팀 멤버십" → "회고방 멤버십" - docs/reviews: 기술 용어 "팀 멤버/접근" → "회고방 멤버/접근" 자연어(팀원, 팀 인사이트 등)는 사용자 facing 콘텐츠로 유지 Co-Authored-By: Claude Opus 4.5 <[email protected]>

- teamName → retroRoomName - team_insight → insight - 팀 소속/정보/내/명/ID → 회고방 소속/정보/내/명/ID - member_team → member_retro_room - TeamNotFound → RetroRoomNotFound "팀원"은 자연어 콘텐츠로 유지 Co-Authored-By: Claude Opus 4.5 <[email protected]>

- teamInsight → insight - 팀 멤버/관리자 → 회고방 멤버/관리자 - 팀 전체/레벨 → 회고방 전체/레벨 - 팀 이름 → 회고방 이름 - 해당 팀의 → 해당 회고방의 Co-Authored-By: Claude Opus 4.5 <[email protected]>

coderabbitai

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

codes/server/src/domain/retrospect/dto.rs (1)

609-615: ⚠️ Potential issue | 🟠 Major

Update test file to match AnalysisResponse field rename.

AnalysisResponse field changed from team_insight to insight. The test struct in codes/server/tests/ai_analysis_live_test.rs (line 23) still references the old field name and will fail deserialization. Update the struct definition and all field accesses to use insight instead.

- prompt.rs: "팀 인사이트" → "인사이트" - reviews: not_team_member → not_retro_room_member - reviews: → team 경로 → → retro_room 경로 - reviews: team 테이블 → retro_room 테이블 Co-Authored-By: Claude Opus 4.5 <[email protected]>

- 005-team-join.md → 005-retro-room-join.md - 010-team-retrospects-list.md → 010-retro-room-retrospects-list.md - team-api.md → retro-room-api.md Co-Authored-By: Claude Opus 4.5 <[email protected]>

- 004-auth-logout.md → 029-auth-logout.md - README.md: API-004 → API-029 참조 수정 - 003-auth-token-refresh.md: API-004 → API-029 참조 수정 Co-Authored-By: Claude Opus 4.5 <[email protected]>

- api-012-retrospect-detail.md → 012-retrospect-detail.md - api-013-retrospect-delete.md → 013-retrospect-delete.md - api-016-retrospect-draft-save.md → 016-retrospect-draft-save.md - api-017-retrospect-submit.md → 017-retrospect-submit.md - api-019-retrospect-storage.md → 019-retrospect-storage.md - api-020-retrospect-responses-list.md → 020-retrospect-responses-list.md - api-021-retrospect-export.md → 021-retrospect-export.md - api-023-retrospect-search.md → 023-retrospect-search.md - api-025-response-like-toggle.md → 025-response-like-toggle.md - api-028-exit-service.md → 028-exit-service.md Co-Authored-By: Claude Opus 4.5 <[email protected]>

- 004-auth-logout.md → 029-auth-logout.md - 010-retro-room-retrospects.md 삭제 (010-retro-room-retrospects-list.md와 중복) Co-Authored-By: Claude Opus 4.5 <[email protected]>

- 회고 룸 생성 API → (API-004) - 회고 룸 참여 API → (API-005) - 회고 생성 API → (API-011) Co-Authored-By: Claude Opus 4.5 <[email protected]>

- handler.rs: Swagger 설명 통일 - dto.rs: 검증 메시지 및 주석 통일 - service.rs: 주석 및 에러 메시지 통일 - error.rs: 에러 설명 통일 Co-Authored-By: Claude Opus 4.5 <[email protected]>

모든 API를 "기능 API (API-XXX)" 형식으로 통일 - API-006: 참여 중인 회고방 목록 조회 → 회고방 목록 조회 API (API-006) - API-007: 회고방 순서 변경 → 회고방 순서 변경 API (API-007) - API-008: 회고방 이름 변경 → 회고방 이름 변경 API (API-008) - API-009: 회고방 삭제 → 회고방 삭제 API (API-009) - API-010: 회고방 내 회고 목록 조회 → 회고방 내 회고 목록 조회 API (API-010) Co-Authored-By: Claude Opus 4.5 <[email protected]>

Auth API 형식 통일: - [API-001] 소셜 로그인 → 소셜 로그인 API (API-001) - [API-002] 회원가입 → 회원가입 API (API-002) - [API-003] 토큰 갱신 → 토큰 갱신 API (API-003) - [API-004] 로그아웃 → 로그아웃 API (API-029) Member API: - [API-028] 서비스 탈퇴 → 서비스 탈퇴 API (API-028) - tag "Member" → "Auth"로 변경 Co-Authored-By: Claude Opus 4.5 <[email protected]>

catturtle123 · 2026-01-31T10:30:45Z

@coderabbitai review

coderabbitai · 2026-01-31T10:30:50Z

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

github-actions · 2026-01-31T12:17:59Z

Terraform Format 🖌 `failure`

Terraform Init ⚙️ `success`

Terraform Validate 🤖 `success`

Terraform Plan 📖 `success`

Show Plan

Acquiring state lock. This may take a few moments...
data.aws_route53_zone.main: Reading...
aws_vpc.main: Refreshing state... [id=vpc-06e337fe8c72d274b]
aws_s3_bucket.terraform_state: Refreshing state... [id=web-team-3-tf-state-v2]
aws_dynamodb_table.terraform_lock: Refreshing state... [id=web-team-3-tf-lock-v2]
aws_db_parameter_group.main: Refreshing state... [id=web-team-3-dev-mysql8-params]
data.aws_ami.ubuntu_2404: Reading...
data.aws_route53_zone.main: Read complete after 1s [id=Z093699513LDAGIAMRGKU]
data.aws_ami.ubuntu_2404: Read complete after 1s [id=ami-0130d8d35bcd2d433]
aws_internet_gateway.main: Refreshing state... [id=igw-0e141727ecff126ee]
aws_route_table.private: Refreshing state... [id=rtb-0355eb582b4ff3dd2]
aws_subnet.public[1]: Refreshing state... [id=subnet-07e38fbb8cfadc882]
aws_subnet.public[0]: Refreshing state... [id=subnet-0efa7ca9b8d1e451d]
aws_subnet.private[1]: Refreshing state... [id=subnet-02884b8d343ff25a5]
aws_subnet.private[0]: Refreshing state... [id=subnet-007a290b1fdb51067]
aws_security_group.ec2: Refreshing state... [id=sg-0b5c350188ea252e5]
aws_route_table.public: Refreshing state... [id=rtb-0dad63dad02ddc5ff]
aws_security_group.rds: Refreshing state... [id=sg-03705313b48995086]
aws_route_table_association.public[0]: Refreshing state... [id=rtbassoc-099953f254a4d5809]
aws_route_table_association.public[1]: Refreshing state... [id=rtbassoc-03c01253dea21ea7b]
aws_s3_bucket_public_access_block.terraform_state: Refreshing state... [id=web-team-3-tf-state-v2]
aws_instance.app: Refreshing state... [id=i-09f54da883306a39e]
aws_s3_bucket_server_side_encryption_configuration.terraform_state: Refreshing state... [id=web-team-3-tf-state-v2]
aws_s3_bucket_versioning.terraform_state: Refreshing state... [id=web-team-3-tf-state-v2]
aws_route_table_association.private[1]: Refreshing state... [id=rtbassoc-0d27850a8a6e94ba5]
aws_route_table_association.private[0]: Refreshing state... [id=rtbassoc-06218dad0b08de21c]
aws_db_subnet_group.main: Refreshing state... [id=web-team-3-dev-db-subnet-group]
aws_db_instance.main: Refreshing state... [id=db-CDWN44WOQ6PTQFDBPY6KNBS2ME]
aws_eip.app: Refreshing state... [id=eipalloc-0b8749a716be29355]
aws_route53_record.api: Refreshing state... [id=Z093699513LDAGIAMRGKU_api.moaofficial.kr_A]

No changes. Your infrastructure matches the configuration.

Terraform has compared your real infrastructure against your configuration
and found no differences, so no changes are needed.

Pushed by: @catturtle123, Action: pull_request

- withdraw API가 Auth로 이동하여 Member 태그 불필요 Co-Authored-By: Claude Opus 4.5 <[email protected]>

jsoonworld

코드 리뷰 - team/팀을 retro-room/회고방으로 용어 통일

안녕하세요 준환님! 전체적으로 용어 통일 작업이 체계적으로 잘 진행되었습니다 👍

몇 가지 확인 사항과 제안을 각 파일에 코멘트로 남겼으니 확인 부탁드립니다.

요약

✅ 에러 코드 TEAM → RETRO 변경 완료
✅ 프롬프트 teamInsight → insight 변경 완료
✅ 파일명 정리 및 중복 제거 완료
⚠️ 일부 주석/문서 확인 필요 (아래 코멘트 참조)

수고하셨습니다!

jsoonworld · 2026-01-31T13:19:06Z

codes/server/src/domain/ai/prompt.rs

 ## 분석 방법

-### 1. 팀 인사이트 (teamInsight)
+### 1. 인사이트 (insight)


👍 teamInsight → insight로 변경 잘 되었습니다!

한 가지 확인 부탁드릴 점이 있는데요, dto.rs의 AnalysisResponse 구조체에서도 team_insight 필드가 insight로 변경되었는지 확인해주시면 좋겠습니다.

프롬프트와 DTO 필드명이 일치해야 AI 응답 파싱이 정상적으로 동작할 것 같아요.

확인 감사합니다! dto.rs의 AnalysisResponse에서도 insight로 변경되어 있습니다. 프롬프트와 DTO가 일치합니다. ✅

jsoonworld · 2026-01-31T13:20:24Z

codes/server/src/domain/retrospect/dto.rs

 pub struct AnalysisResponse {
    /// 회고방 전체를 위한 AI 분석 메시지
-    pub team_insight: String,
+    pub insight: String,


👍 team_insight → insight로 필드명 변경 잘 되었습니다!

prompt.rs의 JSON 예시("insight": ...)와 일치하도록 수정해주셔서 AI 응답 파싱이 정상적으로 동작할 것 같습니다.

감사합니다! 프롬프트, DTO, 테스트 모두 insight로 통일되어 있습니다. ✅

jsoonworld · 2026-01-31T13:20:26Z

codes/server/src/utils/error.rs

        }

-        // retro_room_orders 필드 검증 실패 시 TEAM4004 반환
+        // retro_room_orders 필드 검증 실패 시 RETRO4004 반환


✅ 주석을 RETRO4004로 업데이트 해주셨네요! 에러 코드 통일이 잘 되었습니다.

감사합니다! 에러 코드 통일 확인되었습니다. ✅

jsoonworld · 2026-01-31T13:20:39Z

codes/server/src/domain/retrospect/handler.rs

 // ============================================

-/// 회고 룸 생성 API
+/// 회고방 생성 API (API-004)


👍 Swagger 문서 제목 형식 통일 깔끔합니다!

`"기능 API (API-XXX)"` 형식으로 일관되게 정리해주셔서 API 문서 가독성이 좋아졌습니다.

감사합니다! API 문서 가독성 향상을 위해 형식을 통일했습니다. ✅

jsoonworld · 2026-01-31T13:20:48Z

codes/server/src/domain/retrospect/service.rs

        req: RetroRoomCreateRequest,
    ) -> Result<RetroRoomCreateResponse, AppError> {
-        // 1. 회고 룸 이름 중복 체크
+        // 1. 회고방 이름 중복 체크


👍 주석에서 "회고 룸" → "회고방" 용어 통일 잘 되었습니다!

서비스 레이어의 주석들이 도메인 용어와 일관되게 유지되어 좋네요.

감사합니다! 도메인 용어 일관성을 유지하기 위해 주석도 함께 정리했습니다. ✅

jsoonworld · 2026-01-31T13:20:50Z

codes/server/src/domain/retrospect/service.rs

    /// - 답변이 존재하지 않으면 RES4041 (404) 반환
-    /// - 회고방 멤버가 아니면 TEAM4031 (403) 반환
+    /// - 회고방 멤버가 아니면 RETRO4031 (403) 반환
    async fn find_response_for_member(


✅ 헬퍼 함수 주석도 `TEAM4031` → `RETRO4031`로 업데이트 해주셨네요!

에러 코드와 주석이 일치하여 코드 가독성이 좋습니다.

감사합니다! 에러 코드와 주석 일치 확인되었습니다. ✅

jsoonworld · 2026-01-31T13:20:53Z

codes/server/src/domain/auth/handler.rs

 }

-/// [API-004] 로그아웃
+/// 로그아웃 API (API-029)


💡 확인 요청: 로그아웃 API 번호가 `API-004` → `API-029`로 변경되었는데, 혹시 다른 API가 004번을 사용하게 되어서인지 궁금합니다.

docs/api-specs/에서도 `029-auth-logout.md`로 파일이 있는지 확인해주시면 좋겠습니다!

확인 감사합니다! 🙏

docs/api-specs/029-auth-logout.md 파일이 존재하는 것을 확인했습니다. API 번호 체계가 정리되면서 로그아웃이 029번으로 재배정되었습니다. 다른 API들과 번호가 겹치지 않도록 조정된 결과입니다.

jsoonworld · 2026-01-31T13:21:00Z

codes/server/src/domain/member/handler.rs

        (status = 500, description = "서버 내부 오류", body = ErrorResponse)
    ),
-    tag = "Member"
+    tag = "Auth"


👍 탈퇴 API를 `Member` → `Auth` 태그로 이동한 것이 합리적입니다!

인증/계정 관련 기능이 한 곳에 모이게 되어 Swagger UI에서 API 구조가 더 명확해질 것 같습니다.

감사합니다! 인증/계정 관련 기능을 Auth 태그로 통합했습니다. ✅

jsoonworld · 2026-01-31T13:21:04Z

codes/server/src/domain/ai/service.rs

        assert!(result.is_ok());
        let analysis = result.unwrap();
-        assert_eq!(analysis.team_insight, "팀이 잘했습니다");
+        assert_eq!(analysis.insight, "팀이 잘했습니다");


👍 테스트 코드에서도 `team_insight` → `insight`로 일관되게 변경해주셨네요!

DTO, 프롬프트, 테스트가 모두 일치하여 AI 응답 파싱이 정상적으로 동작할 것입니다.

감사합니다! 추가로 CodeRabbit이 지적한 ai_analysis_live_test.rs 파일도 insight로 변경하여 커밋했습니다. (a5f6d22) ✅

jsoonworld · 2026-01-31T13:21:06Z

codes/server/src/domain/retrospect/handler.rs

        (status = 400, description = "잘못된 요청 (responseId가 1 미만)", body = ErrorResponse),
        (status = 401, description = "인증 실패", body = ErrorResponse),
-        (status = 403, description = "팀 멤버가 아닌 유저가 좋아요 시도", body = ErrorResponse),
+        (status = 403, description = "회고방 멤버가 아닌 유저가 좋아요 시도", body = ErrorResponse),


👍 "팀 멤버" → "회고방 멤버"로 Swagger 에러 설명이 통일되었습니다!

API 문서 전반에 걸쳐 용어가 일관되게 유지되어 좋습니다.

감사합니다! API 문서 전반에 걸쳐 용어 일관성을 유지하도록 정리했습니다. ✅

jsoonworld · 2026-01-31T13:21:08Z

codes/server/src/utils/error.rs

    Conflict(String),

-    /// RETRO4041: 회고 룸 없음 (404)
+    /// RETRO4041: 회고 회고방 없음 (404)


💬 사소한 피드백: 주석이 "회고 회고방 없음"으로 되어 있는데, 혹시 "회고방 없음"으로 수정하시면 어떨까요?

```rust
/// RETRO4041: 회고방 없음 (404)
```

타이핑 실수인 것 같아서 말씀드립니다!

좋은 지적 감사합니다! 🙏

타이핑 실수 수정했습니다.

/// RETRO4041: 회고방 없음 (404)

커밋: 6ec6c42

jsoonworld · 2026-01-31T13:21:42Z

codes/server/src/domain/retrospect/entity/retrospect.rs

    pub retrospect_id: i64,
    pub title: String,
-    pub team_insight: Option<String>,
+    pub insight: Option<String>,


👍 Entity에서 team_insight → insight 필드명 변경 완료!

team_id 필드도 제거되어 retrospect_room_id만 남게 되었네요. DB 스키마와 코드가 일관되게 정리된 것 같습니다.

감사합니다! Entity와 DTO가 일관되게 정리되었습니다. ✅

jsoonworld · 2026-01-31T13:21:44Z

docs/api-specs/022-retrospect-analysis.md

  "message": "회고 분석이 성공적으로 완료되었습니다.",
  "result": {
-    "teamInsight": "이번 회고에서 팀은 목표 의식은 분명했지만, 에너지 관리 측면에서 아쉬움이 있었습니다.",
+    "insight": "이번 회고에서 팀은 목표 의식은 분명했지만, 에너지 관리 측면에서 아쉬움이 있었습니다.",


👍 API 문서에서도 `teamInsight` → `insight`로 일관되게 변경되었습니다!

코드(DTO, Entity)와 문서가 동기화되어 좋습니다.

감사합니다! 코드와 문서가 동기화되도록 함께 수정했습니다. ✅

jsoonworld · 2026-01-31T13:21:46Z

docs/api-specs/README.md

 | API-003 | POST | `/api/v1/auth/token/refresh` | 토큰 리프레시 | [003-auth-token-refresh.md](./003-auth-token-refresh.md) |
-| API-004 | POST | `/api/v1/auth/logout` | 로그아웃 | [004-auth-logout.md](./004-auth-logout.md) |
+| API-029 | POST | `/api/v1/auth/logout` | 로그아웃 | [029-auth-logout.md](./029-auth-logout.md) |



👍 API 경로 변경 일관성 좋습니다!

`/api/v1/teams` → `/api/v1/retro-rooms`로 엔드포인트가 통일되었고, `teamId` → `retroRoomId`로 Path Parameter도 변경되었네요.

감사합니다! 엔드포인트와 Path Parameter 모두 통일했습니다. ✅

jsoonworld · 2026-01-31T13:21:48Z

docs/api-specs/README.md

 | AUTH | 인증 | AUTH4001, AUTH4002, AUTH4003 |
-| TEAM | 팀 | TEAM4001, TEAM4031, TEAM4041, TEAM4091 |
-| RETRO | 회고 | RETRO4001, RETRO4031, RETRO4041 |
+| RETRO | 회고/회고방 | RETRO4001, RETRO4031, RETRO4041, RETRO4091 |


👍 에러 코드 체계 정리 잘 되었습니다!

`TEAM` 접두사가 제거되고 `RETRO`로 통합되어 에러 코드 도메인이 명확해졌네요:

`RETRO4001`: 회고방 이름 길이 초과

`RETRO4031`: 회고방 접근 권한 없음

`RETRO4041`: 회고/회고방 없음

`RETRO4091`: 회고방 이름 중복

감사합니다! TEAM 접두사를 제거하고 RETRO로 통합하여 에러 코드 도메인을 명확하게 정리했습니다. ✅

- AnalysisResponse 구조체 필드명 변경 - 프롬프트 예시 JSON 키 변경 - 검증 출력 메시지 변경 Co-Authored-By: Claude Opus 4.5 <[email protected]>

catturtle123 · 2026-01-31T13:22:39Z

CodeRabbit이 지적한 ai_analysis_live_test.rs 파일의 team_insight → insight 필드명 변경을 완료했습니다. ✅

변경 내용:

AnalysisResponse 구조체 필드명 변경
프롬프트 예시 JSON 키 변경
검증 출력 메시지 변경

커밋: a5f6d22

- "회고 회고방 없음" → "회고방 없음" Co-Authored-By: Claude Opus 4.5 <[email protected]>

catturtle123 · 2026-01-31T13:26:45Z

@jsoonworld 수정해야할 리뷰 모두 완료하였습니다!

catturtle123 and others added 8 commits January 31, 2026 18:28

🐛 fix: TEAM4031 주석을 RETRO4031로 수정

94e3c76

Co-Authored-By: Claude Opus 4.5 <[email protected]>

coderabbitai bot reviewed Jan 31, 2026

View reviewed changes

catturtle123 and others added 3 commits January 31, 2026 19:14

🏗️ structure: reviews 파일명 team → retro-room 변경 (#65)

7c0e5f4

- 005-team-join.md → 005-retro-room-join.md - 010-team-retrospects-list.md → 010-retro-room-retrospects-list.md - team-api.md → retro-room-api.md Co-Authored-By: Claude Opus 4.5 <[email protected]>

🏗️ structure: API 번호 중복 해결 (004 → 029 auth-logout) (#65)

81087cc

- 004-auth-logout.md → 029-auth-logout.md - README.md: API-004 → API-029 참조 수정 - 003-auth-token-refresh.md: API-004 → API-029 참조 수정 Co-Authored-By: Claude Opus 4.5 <[email protected]>

catturtle123 force-pushed the docs/65-rename-retro-room branch from 583f719 to 81087cc Compare January 31, 2026 10:18

catturtle123 and others added 6 commits January 31, 2026 19:20

🏗️ structure: reviews 중복 번호 정리 (api-spec 기준) (#65)

0c088a2

- 004-auth-logout.md → 029-auth-logout.md - 010-retro-room-retrospects.md 삭제 (010-retro-room-retrospects-list.md와 중복) Co-Authored-By: Claude Opus 4.5 <[email protected]>

📝 docs: Swagger API 번호 추가 (#65)

889f981

- 회고 룸 생성 API → (API-004) - 회고 룸 참여 API → (API-005) - 회고 생성 API → (API-011) Co-Authored-By: Claude Opus 4.5 <[email protected]>

📝 docs: 레트로룸/회고 룸 → 회고방 용어 통일 (#65)

8cb154f

- handler.rs: Swagger 설명 통일 - dto.rs: 검증 메시지 및 주석 통일 - service.rs: 주석 및 에러 메시지 통일 - error.rs: 에러 설명 통일 Co-Authored-By: Claude Opus 4.5 <[email protected]>

catturtle123 self-assigned this Jan 31, 2026

catturtle123 requested a review from jsoonworld January 31, 2026 11:52

catturtle123 force-pushed the docs/65-rename-retro-room branch from b8b9413 to 7307b77 Compare January 31, 2026 12:18

📝 docs: 빈 Member 태그 제거 (#65)

c6b36aa

- withdraw API가 Auth로 이동하여 Member 태그 불필요 Co-Authored-By: Claude Opus 4.5 <[email protected]>

jsoonworld reviewed Jan 31, 2026

View reviewed changes

🐛 fix: ai_analysis_live_test.rs에서 team_insight → insight 필드명 통일

a5f6d22

- AnalysisResponse 구조체 필드명 변경 - 프롬프트 예시 JSON 키 변경 - 검증 출력 메시지 변경 Co-Authored-By: Claude Opus 4.5 <[email protected]>

📝 docs: error.rs 주석 오타 수정

6ec6c42

- "회고 회고방 없음" → "회고방 없음" Co-Authored-By: Claude Opus 4.5 <[email protected]>

jsoonworld approved these changes Jan 31, 2026

View reviewed changes

catturtle123 merged commit 3a5157c into dev Jan 31, 2026
3 checks passed

catturtle123 deleted the docs/65-rename-retro-room branch January 31, 2026 13:50

docs: team/팀을 retro-room/회고방으로 용어 통일 (#65) #68

docs: team/팀을 retro-room/회고방으로 용어 통일 (#65) #68

Uh oh!

Conversation

catturtle123 commented Jan 31, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

README.md

각 API 명세서

코드 (error.rs)

Test plan

Summary by CodeRabbit

Uh oh!

coderabbitai bot commented Jan 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Rate limit exceeded

Walkthrough

Changes

Estimated code review effort

Poem

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

catturtle123 commented Jan 31, 2026

Uh oh!

coderabbitai bot commented Jan 31, 2026

Uh oh!

github-actions bot commented Jan 31, 2026

Terraform Format 🖌 failure

Terraform Init ⚙️ success

Terraform Validate 🤖 success

Terraform Plan 📖 success

Uh oh!

jsoonworld left a comment

Choose a reason for hiding this comment

코드 리뷰 - team/팀을 retro-room/회고방으로 용어 통일

요약

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

catturtle123 commented Jan 31, 2026 •

edited by coderabbitai bot

Loading

coderabbitai bot commented Jan 31, 2026 •

edited

Loading

Terraform Format 🖌 `failure`

Terraform Init ⚙️ `success`

Terraform Validate 🤖 `success`

Terraform Plan 📖 `success`