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

[jongfeel]

최근에 아키텍처 관련 책을 많이 읽고 하다 보니 읽는 것 자체는 어렵지 않은데 실무에서 아직도 다 분석하고 적용해 보지 못한 게 너무 많아서 더 많은 경험을 쌓아야 겠다는 생각이 드네요.

---

Commit 메시지 내용대로 pull request 제목 만들어지는데 제가 작년까지는 그렇게 pull request를 생성했었습니다.
올해는 다들 제목을 통일해서 올리시니 저도 맞춰서 올려 보는 방향으로 했습니다.

[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 2nd Edition' 스터디의 첫 3개 챕터에 대한 요약 및 리뷰 내용을 추가합니다. 아키텍처 의사결정 기록(ADR)의 실제 적용 경험, 아키텍처 퀀텀을 통한 마이크로서비스의 필요성 이해, 그리고 모듈성 높은 아키텍처에서의 시험성 확보 방안 등 핵심 아키텍처 개념에 대한 저자의 깊이 있는 통찰과 경험을 공유합니다. 이는 아키텍처 학습 및 실무 적용에 대한 이해를 돕는 데 기여할 것입니다.

Highlights

• 아키텍처 의사결정 기록 (ADR) 경험 공유: 첫 번째 챕터에서는 아키텍처 의사결정 기록(ADR)의 중요성과 실제 프로젝트에서의 적용 경험을 공유하며, ADR이 프로젝트 중반 이후 '왜?'라는 질문에 대한 해답을 제공하고 새로운 팀원에게 유용하다는 점을 강조합니다.
• 아키텍처 퀀텀과 마이크로서비스 이해: 두 번째 챕터에서는 '아키텍처 퀀텀'이라는 개념을 통해 마이크로서비스가 필요한 이유를 아키텍처 특성(확장성, 보안 등) 관점에서 설명하며, 기존의 응집도/결합도 관점보다 더 깊이 있는 이해를 제공합니다.
• 모듈성 및 시험성 확보 방안: 세 번째 챕터에서는 아키텍처 모듈성, 특히 시험성(Testability)에 대해 다룹니다. 서비스 간 동적 연결로 인한 커플링이 시험성을 저해할 수 있음을 지적하고, 의존적인 서비스에 대한 Mock 객체 생성을 대안으로 제시합니다.

🧠 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

소프트웨어 아키텍처 The Hard Parts 1주차 스터디 내용 잘 보았습니다. ADR, 아키텍처 퀀텀, 모듈성에 대한 경험과 생각을 잘 정리해주셨네요. 전체적으로 내용이 좋지만, 몇몇 파일에서 발견된 사소한 오타나 띄어쓰기 오류를 수정하여 가독성을 높이는 것을 제안합니다. 자세한 내용은 각 파일에 남긴 리뷰 코멘트를 참고해주세요.

[dhlee3994]

기대되네요 👍

[chichoon]

책의 극초반이라 그런지 ADR 에 대해 짤막하게 소개정도만 하고 넘어가서 중요성을 크게 느끼지 못했는데 (...), 멘토님 예시로 미리 선행학습하면 좋을 것 같네요

[GeunJuLEE]

그냥 느낌으로 어떤 아키텍처가 현 시점에 그리고 미래를 위해 베스트다 이렇게 만 생각했지, ADR을 작성 해본적은 없는거 같네요

[chichoon]

아키텍처 퀀텀이라는 용어가 저는 모듈이나 컴포넌트처럼 잘게 쪼갤 수 있는 독립적인 구조 단위로 이해하면서 읽었는데 이렇게 생각하니 아키텍처의 중요성에 대해서 (평소에 아키텍처에 크게 관심을 가지지 않은 초보 입장에서) 해당 챕터 이해가 수월했는데

의외로 자주 쓰이는 용어는 아닌가 보네요

[GeunJuLEE]

그냥 느낌으로 어떤 아키텍처가 현 시점에 그리고 미래를 위해 베스트다 이렇게 만 생각했지, ADR을 작성 해본적은 없는거 같네요