[DOCS/#97] 거래내역 동기화 API 개발용 명시

[seamooll]

🔗 Related Issue

• Closes [DOCS] 구 거래내역 동기화 API 명세 업데이트 #97

📝 Summary

거래내역 동기화 API가 금융사 연동 API로 통합되어 현재 사용되지 않는 API임을 명세합니다.

🔄 Changes

• API 변경 (추가/수정)
• 데이터 및 도메인 변경 (DB, 비즈니스 로직)
• 설정 또는 인프라 관련 변경
• 리팩토링

💬 Questions & Review Points

📸 API Test Results (Swagger)

✅ Checklist

• API 테스트 완료
• 테스트 결과 사진 첨부
• 빌드 성공 확인 (./gradlew build)

[gemini-code-assist]

Summary of Changes

Hello @seamooll, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 '거래내역 동기화' API의 문서를 업데이트하여 해당 엔드포인트가 현재 개발용으로만 사용되며 실제 서비스에서는 활용되지 않음을 명확히 합니다. 이는 해당 기능이 더 광범위한 금융사 연동 API로 통합되었기 때문입니다. 이번 변경으로 API 사용에 대한 혼란을 줄이고 문서의 정확성을 높이는 데 기여합니다.

Highlights

• API 문서 업데이트: 기존의 '거래내역 동기화' API가 실제 서비스에서 사용되지 않으며, 금융사 연동 API로 통합되었음을 문서에 명시했습니다.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog

• src/main/java/org/umc/valuedi/domain/ledger/controller/LedgerControllerDocs.java
  • 거래내역 동기화 API의 @Operation 어노테이션 내 summary와 description을 수정하여 개발용임을 명시하고 실제 서비스에서의 사용 여부를 설명했습니다.

Activity

• 이 PR에는 아직 활동이 없습니다.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

이번 PR은 거래내역 동기화 API가 더 이상 사용되지 않음을 명시하기 위해 Swagger 문서를 업데이트하는 변경사항을 담고 있습니다. API가 사용되지 않음을 명확히 하는 것은 좋은 방향입니다. 다만, OpenAPI 명세의 표준적인 방법을 사용하여 API가 deprecated 되었음을 표시하는 것을 제안합니다. 아래에 관련 코멘트를 남겼습니다.

[gemini-code-assist]

API가 더 이상 사용되지 않고 삭제될 예정임을 명시하는 것은 좋은 변경입니다. 이를 더 명확하게 표현하기 위해 @Operation 어노테이션에 deprecated = true 속성을 추가하는 것을 권장합니다. 이렇게 하면 Swagger UI에서 해당 API가 시각적으로 deprecated 처리되어 (예: 취소선) 개발자가 더 쉽게 인지할 수 있습니다.

Suggested change

	@Operation(summary = "[개발용] 거래내역 동기화", description = "금융사 연동 API로 통합되어 실제 서비스에서는 사용되지 않습니다. 추후 테스트 후 삭제 예정입니다.")
	@Operation(summary = "[개발용] 거래내역 동기화", description = "금융사 연동 API로 통합되어 실제 서비스에서는 사용되지 않습니다. 추후 테스트 후 삭제 예정입니다.", deprecated = true)