Skip to content

Conversation

@chichoon
Copy link
Member

No description provided.

@github-actions
Copy link

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

@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @chichoon, I'm Gemini Code Assist1! 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장 "아키텍처 분해"에 대한 학습 노트를 추가합니다. 이 노트는 아키텍처를 분해하는 다양한 전략과 코드베이스의 균형을 평가하는 데 사용되는 추상도 및 불안정도와 같은 핵심 개념을 소개합니다.

Highlights

  • 아키텍처 분해 전략: 컴포넌트 기반 분해와 전술적 분기라는 두 가지 주요 아키텍처 분해 전략에 대해 설명합니다.
  • 추상도와 불안정도: 코드베이스의 균형을 나타내는 추상도와 불안정도의 개념, 그리고 메인 시퀀스로부터의 거리를 통해 이상적인 컴포넌트 균형을 평가하는 방법을 다룹니다.
  • 실용적 적용에 대한 논의: 추상도, 불안정도와 같은 수학적 요소들이 실제 개발에서 컴포넌트의 추상성 및 안정성을 판별하는 데 얼마나 실용적인지에 대한 논의점을 제시합니다.

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

@chichoon chichoon added 2026 Software Architecture: The Hard Parts 소프트웨어 아키텍처: The Hard Parts, 분산 아키텍처를 위한 모던 트레이드오프 분석 labels Jan 20, 2026
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

소프트웨어 아키텍처 2판 4장 '아키텍처 분해'에 대한 요약 정리를 추가하신 PR 잘 보았습니다. 아키텍처 분해의 핵심 개념인 컴포넌트 기반 분해, 전술적 분기, 그리고 추상도와 불안정도에 대해 잘 정리해주셨습니다. 리뷰에서는 내용의 정확성과 일관성을 높이기 위한 몇 가지 제안을 드렸습니다. '애플리케이션'과 '모놀리식' 용어의 표기를 일관되게 수정하고, '메인 시퀀스'의 기울기에 대한 사실 관계를 바로잡는 내용을 포함했습니다. 또한, 일부 문장을 더 명확하게 다듬는 것을 제안했습니다. 전반적으로 내용 정리가 잘 되어 있으며, 제안된 수정 사항들을 반영하면 더욱 완성도 높은 요약이 될 것 같습니다.

### 개요

- 컴포넌트 기반 분해
- 어플리케이션의 논리적 구성 요소 단위 (컴포넌트 단위) 를 추출하고 이를 이용하여 아키텍처를 구성
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

'어플리케이션'과 '애플리케이션' 표기가 혼용되고 있습니다. 9행에서는 '애플리케이션'으로 올바르게 작성하셨으므로, 일관성을 위해 '어플리케이션'을 '애플리케이션'으로 수정하는 것이 좋겠습니다.

Suggested change
- 어플리케이션의 논리적 구성 요소 단위 (컴포넌트 단위) 를 추출하고 이를 이용하여 아키텍처를 구성
- 애플리케이션의 논리적 구성 요소 단위 (컴포넌트 단위) 를 추출하고 이를 이용하여 아키텍처를 구성


- 메인 시퀀스로부터의 거리
- 추상도와 불안정도 사이의 이상적인 관계
- x절편, y절편, 기울기 1의 직선
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

메인 시퀀스(Main Sequence)는 추상도(A) + 불안정도(I) = 1의 관계를 나타내는 선으로, 기울기가 -1입니다. 현재 기울기 1로 잘못 기재되어 있어 수정이 필요합니다.

Suggested change
- x절편, y절편, 기울기 1의 직선
- x절편, y절편, 기울기 -1의 직선


### 컴포넌트 기반 분해

- 컴포넌트 단위의 폴더구조 및 파일로 디렉터리를 구성 및 각 코드 분리
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

문장이 다소 어색하게 읽힙니다. '폴더구조'와 '디렉터리'가 중복 사용되었고, '구성 및 각 코드 분리'라는 표현도 자연스럽지 않습니다. "컴포넌트 단위로 디렉터리 구조를 구성하고 코드를 분리"와 같이 좀 더 명확하고 간결하게 수정하는 것을 제안합니다.

Suggested change
- 컴포넌트 단위의 폴더구조 및 파일로 디렉터리를 구성 및 각 코드 분리
- 컴포넌트 단위로 디렉터리 구조를 구성하고 코드를 분리

- 서로간의 의존성 때문에 추출에 한계가 있는 경우
- A팀, B팀이 서로 각각 코드베이스 사본을 복사한 후, 각자의 팀에 필요한 코드만 남기고 나머지를 삭제하는 기법
- 이렇게 하면 각 파트별 큰 구조는 유지하면서 모놀리식 구조를 덩어리로 쪼갤 수 있다
- 분해보다 상대적으로 쉽지만 모놀리스 코드의 흔적이 계속 남아있을 가능성이 있다
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

'모놀리식'과 '모놀리스' 표기가 혼용되고 있습니다. 43행, 50행 등 다른 곳에서는 '모놀리식'으로 사용하셨으므로, 일관성을 위해 '모놀리스'를 '모놀리식'으로 수정하는 것이 좋겠습니다.

Suggested change
- 분해보다 상대적으로 쉽지만 모놀리스 코드의 흔적이 계속 남아있을 가능성이 있다
- 분해보다 상대적으로 쉽지만 모놀리식 코드의 흔적이 계속 남아있을 가능성이 있다

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

2026 Software Architecture: The Hard Parts 소프트웨어 아키텍처: The Hard Parts, 분산 아키텍처를 위한 모던 트레이드오프 분석

Projects

None yet

Development

Successfully merging this pull request may close these issues.

<소프트웨어 아키텍처 The Hard Parts> sprint 1, chapter 4, 5, 총 72페이지, 2026-01-23

2 participants