[G1-Sync] Manual knowledge update
This commit is contained in:
Antigravity Agent
@@ -2,107 +2,183 @@
|
||||
id: wiki-2026-0508-엔터프라이즈-소프트웨어-시스템-설계
|
||||
title: 엔터프라이즈 소프트웨어 시스템 설계
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: [P-Reinforce-AUTO-CB60AE]
|
||||
aliases: [Enterprise Software Design, Enterprise Architecture]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.9
|
||||
tags: [auto-reinforced]
|
||||
verification_status: applied
|
||||
tags: [enterprise, architecture, systems-design, scalability]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-04-20
|
||||
github_commit: "[P-Reinforce] Continuous Worker - 엔터프라이즈 소프트웨어 시스템 설계"
|
||||
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
tech_stack:
|
||||
language: unspecified
|
||||
framework: unspecified
|
||||
language: java
|
||||
framework: spring-boot
|
||||
---
|
||||
|
||||
# [[엔터프라이즈 소프트웨어 시스템 설계|엔터프라이즈 소프트웨어 시스템 설계]]
|
||||
# 엔터프라이즈 소프트웨어 시스템 설계
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
> 엔터프라이즈 소프트웨어 시스템 설계는 비즈니스 요구사항을 충족하고 시간이 지남에 따라 시스템이 확장 및 유지보수될 수 있도록 돕는 견고하고 탄력적인 소프트웨어 기반의 청사진입니다 [1, 2]. 이는 관심사의 분리(SoC), 모듈화, 클린 아키텍처 등의 핵심 원칙을 통해 복잡한 시스템을 관리 가능한 단위로 분할하여 기술 부채를 최소화합니다 [1, 3, 4]. 결과적으로 잘 설계된 아키텍처는 개발 속도를 높이고, 독립적인 테스트를 가능하게 하며, 급변하는 비즈니스 환경에 시스템이 유연하게 적응할 수 있도록 지원합니다 [1, 5, 6].
|
||||
## 매 한 줄
|
||||
> **"매 large-scale, mission-critical, long-lived"**. 매 enterprise software 의 multi-team / multi-decade scale 의 system 의 design — 매 reliability, security, compliance, integration 의 first-class concern. 매 2026 의 cloud-native + 매 legacy mainframe 의 hybrid 의 reality.
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
**엔터프라이즈 설계의 핵심 원칙**
|
||||
* **관심사의 분리 ([[_뇌와 팔다리의 분리_ - 관심사의 분리 (Separation of Concerns)|Separation of Concerns]], SoC):** 복잡한 시스템을 작고 관리하기 쉬운 모듈로 분해하여, 각 부분이 단일 관심사나 기능에만 집중하도록 조직하는 소프트웨어 공학의 가장 기본적인 원칙입니다 [4, 7]. 이를 통해 모듈 간의 결합도(Coupling)는 낮추고 응집도(Cohesion)는 높여 코드의 가독성, 유지보수성, 그리고 독립적인 테스트 가능성을 획기적으로 향상시킵니다 [8-10].
|
||||
* **SOLID 원칙:** 객체 지향 프로그래밍에서 시스템을 유연하고 이해하기 쉽게 만드는 5가지 핵심 설계 원칙(단일 책임, 개방/폐쇄, 리스코프 치환, 인터페이스 분리, 의존성 역전)입니다 [11, 12]. 이 중 단일 책임 원칙과 인터페이스 분리 원칙은 관심사의 분리 개념에서 직접적으로 파생되었습니다 [13, 14].
|
||||
* **DRY (Don't Repeat Yourself) 원칙:** 시스템 내에서 동일한 비즈니스 규칙이나 논리의 중복을 추상화하여 한 곳에서만 관리하도록 함으로써 유지보수의 효율성을 높입니다 [15, 16].
|
||||
## 매 핵심
|
||||
|
||||
**주요 아키텍처 패턴**
|
||||
* **클린 아키텍처 (Clean [[Architecture|Architecture]]):** 비즈니스 로직과 애플리케이션 규칙을 시스템의 중심에 두고, 데이터베이스, 웹 프레임워크, UI 등 외부 기술적 세부사항으로부터 완전히 격리하는 철학입니다 [2, 17-19]. 소스 코드의 의존성이 항상 안쪽(고수준의 정책)으로만 향하도록 강제하는 '의존성 규칙(Dependency Rule)'을 준수하여 외부 에이전시의 변경이 핵심 업무 규칙에 영향을 주지 않도록 보호합니다 [20-22].
|
||||
* **계층형 아키텍처 (Layered Architecture):** 애플리케이션을 프레젠테이션, 비즈니스 로직, 데이터 액세스 등의 수평적 계층으로 나누어 관심사를 분리하는 전통적인 엔터프라이즈 패턴입니다 [23, 24].
|
||||
* **마이크로서비스 아키텍처 (Microservices Architecture):** 거대한 모놀리식(Monolithic) 시스템을 특정 비즈니스 역량에 집중하는 작고 자율적인 서비스들의 집합으로 분할합니다 [25-27]. 각 서비스는 독립적인 배포, 확장, 기술 스택 선택이 가능하여 개발의 민첩성을 제공합니다 [25, 28].
|
||||
* **도메인 주도 설계 (Domain-Driven Design, DDD):** 복잡한 비즈니스 로직을 구현하기 위해 도메인 전문가와 개발자가 공유하는 '보편적 언어(Ubiquitous Language)'를 구축하고, 대규모 도메인을 '바운디드 컨텍스트(Bounded Context)'로 나누어 시스템을 모델링하는 접근법입니다 [29, 30].
|
||||
* **이벤트 기반 아키텍처 (Event-Driven Architecture):** 시스템 컴포넌트들이 이벤트를 비동기적으로 생성하고 소비하며 통신하는 구조로, 구성 요소 간의 결합도를 낮추고 실시간 데이터 처리와 높은 확장성을 지원합니다 [31, 32].
|
||||
### 매 Enterprise 의 specific concerns
|
||||
- **Scale**: 매 thousands of concurrent users, TB+ data.
|
||||
- **Longevity**: 매 10-30년 의 lifespan — 매 maintainability 의 critical.
|
||||
- **Compliance**: 매 SOX, GDPR, HIPAA, PCI-DSS.
|
||||
- **Integration**: 매 N legacy system 의 talk to.
|
||||
- **Multi-team**: 매 Conway's law — 매 org structure 가 architecture 의 reflect.
|
||||
|
||||
**확장성 및 품질 관리를 위한 실무 접근법**
|
||||
* **관점 지향 프로그래밍 (AOP):** 로깅, 보안, 트랜잭션 등 시스템 전체에 흩어진 횡단 관심사(Cross-Cutting Concerns)를 별도의 모듈(Aspect)로 분리하여 코드 중복을 제거하고 유지보수성을 높입니다 [33-35].
|
||||
* **테스트 주도 개발(TDD) 기반의 설계:** TDD는 AI 시스템처럼 복잡하고 비결정적인 시스템에서도 모듈성과 명확한 인터페이스를 강제하여, 설계 초기부터 독립적으로 테스트하고 유지보수할 수 있는 아키텍처를 구축하도록 유도합니다 [6, 36, 37].
|
||||
* **마이크로 프론트엔드 (Micro [[Frontend|Frontend]]s):** 백엔드의 마이크로서비스 개념을 프론트엔드에 적용하여, 거대한 웹 UI를 여러 팀이 독립적으로 개발, 테스트, 배포할 수 있는 작은 모듈로 분할함으로써 프론트엔드의 복잡성을 관리합니다 [38-40].
|
||||
### 매 Architecture layers (전통)
|
||||
1. **Presentation** — UI / API.
|
||||
2. **Application** — orchestration, use cases.
|
||||
3. **Domain** — business logic.
|
||||
4. **Infrastructure** — persistence, messaging, external.
|
||||
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
|
||||
- **과거 데이터와의 충돌:** 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
|
||||
- **정책 변화:** Programming & Language 분야의 자동 자산화 수행.
|
||||
### 매 2026 modern stack
|
||||
- **Frontend**: React / Next.js, micro-frontends.
|
||||
- **API**: GraphQL Federation, gRPC, REST.
|
||||
- **Service**: Microservices (Java/Spring Boot, Go, Kotlin).
|
||||
- **Data**: PostgreSQL, Kafka, Snowflake / Databricks.
|
||||
- **Platform**: Kubernetes, Istio, ArgoCD.
|
||||
- **Observability**: OpenTelemetry, Datadog, Grafana.
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
- **Related Topics:** [[관심사의 분리 (Separation of Concerns)|관심사의 분리 (Separation of Concerns]], 클린 아키텍처 (Clean Architecture), 마이크로서비스 아키텍처, 도메인 주도 설계 (DDD), [[SOLID 원칙|SOLID 원칙]]
|
||||
- **Projects/Contexts:** 넷플릭스 코스모스 플랫폼 (Netflix Cosmos Platform), 넷플릭스 마이크로서비스 마이그레이션, 스포티파이 마이크로 프론트엔드 (Spotify Micro Frontends)
|
||||
- **Contradictions/Notes:**
|
||||
- **아키텍처 도입의 트레이드오프:** 마이크로서비스는 독립적인 배포와 혁신을 돕지만, 서비스 간 분산 통신 구현, 여러 서비스에 걸친 요청 처리의 어려움, 메모리 사용량 증가 등 새로운 운영 및 개발 복잡성을 수반합니다 [41-43].
|
||||
- **관심사 분리의 부작용:** 시스템의 결합도를 낮추고 모듈성을 높이기 위한 관심사의 분리도 지나치게 미세하게 적용할 경우, 성능 오버헤드, 함수 호출 깊이 증가, 조율을 위한 과도한 인디렉션(indirection) 발생 등 오버엔지니어링으로 이어져 오히려 가독성과 디버깅을 어렵게 만들 수 있습니다 [44-46].
|
||||
- **TDD에 대한 오해:** AI 프로젝트 등에서 TDD가 실험 및 개발 주기를 늦춘다는 일반적인 오해가 있으나, 실제 사례(예: Spotify, Netflix)에 따르면 TDD를 통한 올바른 아키텍처 설계는 조기에 오류를 포착하여 오히려 개발 속도를 가속화합니다 [47].
|
||||
### 매 Cross-cutting concerns
|
||||
- AuthN/AuthZ (OAuth2, OIDC, mTLS)
|
||||
- Audit logging
|
||||
- Distributed tracing
|
||||
- Rate limiting, circuit breakers
|
||||
- Multi-tenancy
|
||||
|
||||
---
|
||||
*Last updated: 2026-04-18*
|
||||
## 💻 패턴
|
||||
|
||||
---
|
||||
### 매 Hexagonal architecture
|
||||
```java
|
||||
// 매 Domain — 매 framework 의존 X
|
||||
public class OrderService {
|
||||
private final OrderRepository repo; // port
|
||||
private final PaymentGateway payment; // port
|
||||
|
||||
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
|
||||
|
||||
**언제 이 지식을 쓰는가:**
|
||||
- *(TODO)*
|
||||
|
||||
**언제 쓰면 안 되는가:**
|
||||
- *(TODO)*
|
||||
|
||||
## 🧪 검증 상태 (Validation)
|
||||
|
||||
- **정보 상태:** needs_review
|
||||
- **출처 신뢰도:** A
|
||||
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
|
||||
|
||||
## 🧬 중복 검사 (Duplicate Check)
|
||||
|
||||
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
|
||||
- **처리 방식:** UPDATE (자동 정규화)
|
||||
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
|
||||
|
||||
## 🕓 변경 이력 (Changelog)
|
||||
|
||||
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|
||||
|------|-----------|-----------|--------|
|
||||
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
|
||||
|
||||
## 💻 코드 패턴 (Code Patterns)
|
||||
|
||||
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
|
||||
|
||||
```text
|
||||
# TODO
|
||||
public Order place(PlaceOrderCommand cmd) {
|
||||
var order = Order.create(cmd);
|
||||
payment.charge(cmd.payment());
|
||||
return repo.save(order);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준 (Decision Criteria)
|
||||
### 매 CQRS + Event Sourcing
|
||||
```java
|
||||
// Command side
|
||||
@Component
|
||||
class OrderCommandHandler {
|
||||
public void handle(PlaceOrder cmd) {
|
||||
var events = OrderAggregate.place(cmd);
|
||||
eventStore.append(cmd.orderId(), events);
|
||||
bus.publish(events);
|
||||
}
|
||||
}
|
||||
|
||||
**선택 A를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
// Query side
|
||||
@Component
|
||||
class OrderProjection {
|
||||
@KafkaListener(topics = "order-events")
|
||||
public void on(OrderPlaced e) { readModel.upsert(e); }
|
||||
}
|
||||
```
|
||||
|
||||
**선택 B를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
### 매 Saga (distributed transaction)
|
||||
```java
|
||||
@Saga
|
||||
public class OrderSaga {
|
||||
@StartSaga
|
||||
public void on(OrderPlaced e) {
|
||||
send(new ReserveInventory(e.orderId()));
|
||||
}
|
||||
|
||||
**기본값:**
|
||||
> *(TODO)*
|
||||
@SagaEventHandler
|
||||
public void on(InventoryReserved e) {
|
||||
send(new ChargePayment(e.orderId()));
|
||||
}
|
||||
|
||||
## ❌ 안티패턴 (Anti-Patterns)
|
||||
@SagaEventHandler
|
||||
public void on(PaymentFailed e) {
|
||||
send(new ReleaseInventory(e.orderId()));
|
||||
end();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
### 매 Strangler fig (legacy migration)
|
||||
```yaml
|
||||
# 매 Gateway routing — 매 old → new 의 incremental
|
||||
routes:
|
||||
- path: /api/orders/*
|
||||
backend: new-order-service # 매 migrated
|
||||
- path: /api/billing/*
|
||||
backend: legacy-mainframe # 매 still legacy
|
||||
```
|
||||
|
||||
### 매 Multi-tenancy 의 patterns
|
||||
```java
|
||||
// 매 Row-level — 매 cheapest
|
||||
@Entity
|
||||
class Order {
|
||||
@Column UUID tenantId;
|
||||
// 매 every query 의 tenant filter
|
||||
}
|
||||
|
||||
// 매 Schema-per-tenant — 매 isolation
|
||||
DataSource ds = tenantRouter.resolve(currentTenant());
|
||||
|
||||
// 매 DB-per-tenant — 매 strongest, costliest
|
||||
```
|
||||
|
||||
### 매 BFF (Backend for Frontend)
|
||||
```yaml
|
||||
services:
|
||||
bff-mobile: # 매 mobile 최적화 payload
|
||||
bff-web: # 매 web 최적화
|
||||
bff-partner: # 매 B2B integration
|
||||
# 매 모두 매 동일 backend service 의 aggregate
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| 매 startup, ≤10 dev | 매 Modular monolith |
|
||||
| 매 scale-up, multi-team | 매 Microservices + DDD |
|
||||
| 매 legacy 의 modernization | 매 Strangler fig |
|
||||
| 매 strict audit / replay | 매 Event sourcing |
|
||||
| 매 read-heavy + complex write | 매 CQRS |
|
||||
|
||||
**기본값**: 매 modular monolith 부터 → 매 pain point 별 의 carve out.
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[소프트웨어 아키텍처]] · [[Distributed Systems]]
|
||||
- 변형: [[Microservices]] · [[Event-Driven Architecture]] · [[Service-Oriented Architecture]]
|
||||
- 응용: [[ERP 시스템]] · [[Banking Core]] · [[E-commerce Platforms]]
|
||||
- Adjacent: [[Domain-Driven Design]] · [[Hexagonal Architecture]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: 매 large-scale system design interview / RFC / ADR 작성 시.
|
||||
**언제 X**: 매 small CRUD app — 매 over-engineering 의 risk.
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **Distributed monolith**: 매 microservice 의 모양 의 만 갖춘 의 tight coupling.
|
||||
- **Big bang rewrite**: 매 legacy 의 한 번에 의 replace — 매 거의 fail.
|
||||
- **Anemic domain**: 매 logic 의 service layer 의 만 — 매 domain object 의 의 data bag.
|
||||
- **Shared database**: 매 microservice 간 의 DB 공유 → 매 hidden coupling.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified — Martin Fowler, *Patterns of Enterprise Application Architecture*; Eric Evans, *Domain-Driven Design*; Sam Newman, *Building Microservices* (2nd ed).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — enterprise architecture patterns + 2026 stack |
|
||||
|
||||
Reference in New Issue
Block a user