[UNI-24] (어드민) 특정 버전의 지도 조회 API 개발

[thdgustjd1]

📝 PR 타입

• 기능 구현
• 기능 수정
• 버그 수정
• 리팩토링
• 인프라, 의존성, 환경 변수, 빌드 관련 코드 업데이트

🚀 변경 사항

특정 버전의 지도 조회 API

• 과거 시점의 노드,루트 정보 / 과거 시점의 주의,위험 요소 정보 / 변경된 주의,위험 요소 정보 / 삭제된 노드,루트 정보로 총 4가지 정보를 리턴합니다.

1. 과거 시점의 노드, 루트 정보 : 과거 시점의 루트를 조회하여 [UNI-100] refactor : 코어 루트 삭제에 따른 조회 로직 수정 #36 에서 구현한 로직을 재사용하였습니다.
2. 과거 시점의 주의,위험 요소 정보 : 과거 시점의 루트들의 주의/위험요소를 [UNI-10] feat: 위험&주의 요소 조회 API #6 에서 구현한 주의/위험요소 조회 로직을 재사용 하였습니다.
3. 변경된 주의,위험 요소 정보 : 변경사항을 비교하여 before/after를 제공하였습니다.
4. 삭제된 노드, 루트 정보 : 삭제된 루트(해당 버전 이후에 생성된 루트)를 조회하여 [UNI-100] refactor : 코어 루트 삭제에 따른 조회 로직 수정 #36 에서 구현한 로직을 재사용하였습니다.
   • 기존 로직은 모든 노드가 하나의 그래프 위에 있다고 가정한 상태에서의 BFS로직이었지만, 삭제된 루트들은 하나의 그래프가 아닐 수 있습니다. 이를 위해 MultiSource-BFS를 사용하여 두 개 이상의 그래프에서도 동작할 수 있도록 로직을 수정하였습니다.

• 최대한 기존 로직을 재사용하여 코드 중복을 피했습니다.

메서드명 수정

setCautionFactors는 List를 파라미터로 받아 Set에 할당하는 로직입니다. 이 로직의 동작과정을 고려하여 setCautionFactorsByList로 이름을 변경하였습니다.
setDangerFactors 역시 setDangerFactorsByList로 변경하였습니다.

💡 To Reviewer

테스트 케이스의 시각적 자료는 테스트케이스 에 정리할 예정입니다.

🧪 테스트 결과

테스트 코드 참고하시면 좋을 것 같습니다!

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Generate unit testing code for this file.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
  • @coderabbitai generate unit testing code for this file.
  • @coderabbitai modularize this function.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read src/utils.ts and generate unit testing code.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
  • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

• @coderabbitai pause to pause the reviews on a PR.
• @coderabbitai resume to resume the paused reviews.
• @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
• @coderabbitai full review to do a full review from scratch and review all the files again.
• @coderabbitai summary to regenerate the summary of the PR.
• @coderabbitai generate docstrings to generate docstrings for this PR. (Beta)
• @coderabbitai resolve resolve all the CodeRabbit review comments.
• @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
• @coderabbitai help to get help.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.

[thdgustjd1]

-구두 리뷰 완료-