소프트웨어 아키텍처 The Hard Parts 2주차 - 김종필

[jongfeel]

논의 주제는 챕터 5에 적었습니다.

[github-actions]

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

[gemini-code-assist]

Summary of Changes

Hello @jongfeel, 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"의 챕터 4와 5에 대한 개인적인 학습 요약, 리뷰 및 논의 주제를 추가합니다. 아키텍처 분해의 기본 개념과 평가 지표부터 컴포넌트 기반 분해 패턴의 실제 적용 사례와 네임스페이스 설계에 대한 깊이 있는 성찰까지, 소프트웨어 아키텍처의 핵심 원칙과 실용적인 접근 방식을 탐구합니다.

Highlights

• 아키텍처 분해 논의 확장: 챕터 4에서 소프트웨어 아키텍처의 평가 지표와 모듈성, 커플링 등 핵심 개념을 에드워드 요던, 래리 콘스탄틴, 로버트 마틴과 같은 거장들의 저서와 연결하여 깊이 있게 다루었습니다.
• 컴포넌트 기반 분해 패턴 고찰: 챕터 5에서는 컴포넌트 기반 분해 패턴에 대한 상세한 리뷰를 통해 C# 네임스페이스 설계 경험을 되돌아보고, 책에서 제시하는 모범 사례에 맞춰 향후 설계를 개선하겠다는 의지를 표명했습니다.
• 실용적인 분해 기법 강조: 컴포넌트 분해 기법이 현실적이고 구체적이며 실용적이라는 점을 높이 평가하며, 특히 '진흙잡탕'과 같은 거대한 시스템을 점진적으로 분해하는 6단계 방법론의 유용성을 강조했습니다.

🧠 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.

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은 "소프트웨어 아키텍처 The Hard Parts" 4장과 5장의 요약 내용을 추가합니다. 책 내용에 대한 깊은 고민이 담긴 좋은 요약입니다. 전반적인 가독성을 높이고 몇 가지 오타를 수정하기 위해 아래와 같이 몇 가지 제안을 드립니다.

[TaeHyoungKwon]

여객기 사이즈 라고 하기엔 책 기준 끝판왕으로 보여서, 그정돈 아닌거 같고 현재 기준으론 농구공 정도인데, 꽤나 큰 농구공으로 볼 수 있을거 같습니다(10년 묵은 레거시라..) 파이썬 코드베이스를 자바 스프링 코드베이스로 비즈니스 도메인 단위로 패키지(이 책 기준 컴포넌트)를 나눠서 AI 이용해서 재구현 하는 작업을 하고 있습니다

[chichoon]

작년 말에 리팩터링했던 레거시는 골프공은 아니더라도 야구공 ~ 농구공 수준 (나름 기준을 정해서 잘 쪼갰다) 은 된다고 생각했는데

불과 3개월만에 레거시가 되어서 재리팩토링을 하니 작년 말 코드 정도면 마을버스 정도는 되는 것 같습니다

하위 서비스로 쪼개야 했음에도 불구하고 (예를 들면, 고양이, 강아지, 호랑이, 독수리) 특성이 같다는 이유만으로 뭉쳐놨더니 (=> 동물 서비스로 뭉뚱그려 분류)

세부적으로는 서로 다른 화면임에도 불구하고 의존성과 내부 예외 분기가 너무 심해서 (날개 달린 동물에 대한 예외처리, 냉온동물에 대한 예외처리 등) 새로운 기능이 추가될때마다 예외처리로 만원버스가 되어버렸습니다

지금은 다시 농구공 사이즈로 회귀하려고 쪼개는 중입니다..