소프트웨어 아키텍처 the hard parts sprint 5 - 김종필

[jongfeel]

마지막 스프린트를 남겨 둔 시점에서 점점 소프트웨어 아키텍처에 대한 이미지가 명확하게 정리되고 머리속에 자리잡혀 가는 느낌이 강하게 드네요.

읽기 전에는 어려울 것 같고 양이 많아서 귀찮아서 대충하면 안되는데 라는 불안감이 좀 있었는데
지금은 그런 불안한 감정 보다는 읽기 잘했다는 느낌이 더 강하게 자리잡고 있습니다.

Close #618

[github-actions]

우측에 있는 Projects, Milestone, Development를 확인 후 할당 해주세요~! 🙇

[gemini-code-assist]

Summary of Changes

Hello, 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은 '소프트웨어 아키텍처 the hard parts' 책의 10장, 11장, 12장에 대한 저자의 학습 내용을 문서화합니다. 분산 시스템 아키텍처의 핵심 개념인 분산 데이터 접근, 분산 워크플로우 관리, 트랜잭션 사가 패턴에 대한 이해를 정리하고, 저자의 개인적인 통찰과 질문을 공유하여 해당 주제에 대한 깊이 있는 탐구를 보여줍니다. 이를 통해 저자는 소프트웨어 아키텍처에 대한 전반적인 이해를 더욱 명확히 하고 있습니다.

Highlights

• 분산 데이터 접근 검토 추가: '소프트웨어 아키텍처 the hard parts' 책의 10장 '분산 데이터 접근'에 대한 요약 및 리뷰가 추가되었습니다. 데이터 도메인 패턴과 마이크로서비스 원칙에 대한 고민이 담겨 있습니다.
• 분산 워크플로우 관리 검토 추가: '소프트웨어 아키텍처 the hard parts' 책의 11장 '분산 워크플로우 관리'에 대한 요약 및 리뷰가 추가되었습니다. 오케스트레이션과 코레오그래피 개념이 정리되어 있습니다.
• 트랜잭션 사가 검토 추가: '소프트웨어 아키텍처 the hard parts' 책의 12장 '트랜잭션 사가'에 대한 요약 및 리뷰가 추가되었습니다. 다양한 사가 패턴의 종류와 적용 방식, 그리고 논의 주제가 포함되어 있습니다.

🧠 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

• 2026/Fundamentals_of_Software_Architecture_2nd_Edition/jongfeel/Chapter10_Distributed_Data_Access.md
  • 10장 '분산 데이터 접근'에 대한 리뷰가 추가되었으며, 데이터 도메인 패턴과 마이크로서비스 원칙에 대한 저자의 생각이 포함되었습니다.
• 2026/Fundamentals_of_Software_Architecture_2nd_Edition/jongfeel/Chapter11_Managing_Distributed_Workflows.md
  • 11장 '분산 워크플로우 관리'에 대한 리뷰가 추가되었으며, 오케스트레이션과 코레오그래피 개념이 요약되었습니다.
• 2026/Fundamentals_of_Software_Architecture_2nd_Edition/jongfeel/Chapter12_Transactional_Sagas.md
  • 12장 '트랜잭션 사가'에 대한 리뷰가 추가되었으며, 다양한 사가 패턴의 종류, 적용 방식, 그리고 논의 주제가 상세히 설명되었습니다.

Activity

• 이 PR은 이슈 #618을 닫습니다.
• 10장 리뷰는 이슈 #1631 및 관련 코멘트 https://github.com/jongfeel/BookReview/issues/1631#issuecomment-3980056208와 연결됩니다.
• 11장 리뷰는 이슈 #1632 및 관련 코멘트 https://github.com/jongfeel/BookReview/issues/1632#issuecomment-3984800990와 연결됩니다.
• 12장 리뷰는 이슈 #1635 및 관련 코멘트 https://github.com/jongfeel/BookReview/issues/1635#issuecomment-3998087301와 연결됩니다.
• '소프트웨어 아키텍처 the hard parts' 책의 스프린트 5 작업의 일환으로 진행되었습니다.

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은 '소프트웨어 아키텍처의 어려운 부분들' 책의 10, 11, 12장에 대한 요약 문서를 추가하는 내용입니다. 전반적으로 각 챕터의 핵심 내용을 잘 정리해주셨습니다. 리뷰 중 몇 가지 사소한 개선점을 발견했습니다. 모든 마크다운 파일 끝에 개행 문자가 누락되어 있어 추가를 제안했으며, 가독성을 높이기 위해 일부 문장에서 문법적인 수정을 제안했습니다. 제안된 변경 사항들을 확인해 보시고 반영해 주시면 감사하겠습니다.

_{Note: Security Review has been skipped due to the limited scope of the PR.}

[TaeHyoungKwon]

워낙 케이스가 다양하다보니, 일반화해서 딱 말하긴 힘든데 통신 방식의 경우는 요청에 대한 응답이 필요 없고, 비즈니스 로직 외의 부가적인 작업이라면, 비동기를 사용하고 그 외에는 동기를 사용하는쪽으로 합니다

일관성 방식은 어떤 비즈니스로직을 처리하느냐에 따라서, 최종 일관성으로 처리할지, 원자적 일관성으로 처리할지 매번 상황마다 판단을 다르게 하는거 같은데, 단순히 비즈니스 로직 뿐아니라, 팀의 레거시로 남아있는 관습이나 기존 설계 구조 등도 영향을 미치는거 같습니다

조정 방식은 저희 회사 기준으론, 팀 구조 대로 MS가 나뉘어 있고, 각각 책임 지는 형태로 되어있다보니, 자연스레 크레오그래피 기준으로만 MSA 를 구성 하고 있습니다

아마도, 조직구조가 계층 구조를 가지도록 변경되서, 전체 워크 플로우를 관장해서 처리하는 팀이 생긴 다면, 오케스트레이션도 생기지 않을까? 생각됩니다