Files

T

Antigravity Agent 9a135bd19d docs(10_Wiki): Topic_Business/General/Graphic/Programming을 Topics/ 하위로 이동

최상위 10_Wiki/Topic_*였던 4개 카테고리 폴더를 10_Wiki/Topics/Topic_* 로 재배치.
콘텐츠 변경 없음(순수 폴더 이동) — Topics/ 하위 나머지 폴더는 이미 지난 커밋에서
전부 정리된 상태(잔존 항목은 에이전트 운영 상태 및 사용자가 보존을 요청한
업데이트0615/무제 3.canvas 뿐).

2026-07-05 00:44:01 +09:00

4.7 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack

title

소프트웨어 아키텍처 베스트 프랙티스

매 한 줄

"매 best practice는 매 context-bound이며, 매 trade-off 의 명시 없이 적용 시 매 cargo cult로 전락한다". Fowler / Vernon / Newman의 매 distillation은 매 boundary 의 명확화, 매 dependency 의 inversion, 매 deployment 의 independence를 매 핵심으로 본다.

매 핵심

매 SOLID at architecture level

SRP: 매 service 매 single business capability.
OCP: 매 plugin / 매 extension point.
LSP: 매 contract-based versioning.
ISP: 매 client-specific API (BFF).
DIP: 매 ports & adapters.

매 Cloud-native principles (12-factor + extensions)

매 stateless processes.
매 config via env.
매 backing services as attached resources.
매 disposability (fast startup, graceful shutdown).
매 logs as event streams.
매 health endpoints (/healthz, /readyz).
매 telemetry by default (OpenTelemetry).

매 응용

매 deployment 독립성으로 매 release cadence 향상.
매 boundary 명확화로 매 team autonomy.
매 observability 매 ship-time guarantee.

💻 패턴

Health endpoint (Spring Boot)

@RestController
class HealthController {
    @GetMapping("/healthz") // liveness
    ResponseEntity<?> live() { return ResponseEntity.ok().build(); }

    @GetMapping("/readyz") // readiness
    ResponseEntity<?> ready(DataSource ds) {
        try (var c = ds.getConnection()) {
            c.prepareStatement("SELECT 1").execute();
            return ResponseEntity.ok().build();
        } catch (Exception e) {
            return ResponseEntity.status(503).build();
        }
    }
}

Circuit breaker (Resilience4j)

CircuitBreaker cb = CircuitBreaker.of("payment",
    CircuitBreakerConfig.custom()
        .failureRateThreshold(50)
        .slowCallDurationThreshold(Duration.ofSeconds(2))
        .waitDurationInOpenState(Duration.ofSeconds(30))
        .build());

Supplier<Receipt> guarded = CircuitBreaker
    .decorateSupplier(cb, () -> paymentClient.charge(req));
return Try.ofSupplier(guarded).recover(t -> Receipt.queued()).get();

Outbox pattern (Postgres + Debezium)

BEGIN;
INSERT INTO orders (id, status) VALUES ($1, 'CONFIRMED');
INSERT INTO outbox (aggregate_id, type, payload)
  VALUES ($1, 'OrderConfirmed', $2);
COMMIT;
-- Debezium reads outbox table → publishes to Kafka

Idempotency key (REST)

@app.post("/payments")
def charge(req: ChargeReq, idempotency_key: str = Header(...)):
    cached = redis.get(f"idem:{idempotency_key}")
    if cached:
        return json.loads(cached)
    result = process(req)
    redis.setex(f"idem:{idempotency_key}", 86400, json.dumps(result))
    return result

Feature flag (LaunchDarkly-style)

if (await flags.isEnabled("new-checkout", { userId })) {
  return newCheckout(cart);
}
return legacyCheckout(cart);

매 결정 기준

상황	Approach
매 cross-service consistency	Outbox + Kafka
매 retry safety	Idempotency key
매 cascading failure 방지	Circuit breaker
매 zero-downtime release	Feature flag + blue/green
매 schema evolution	Backward-compatible (additive) only

기본값: 매 12-factor + OpenTelemetry + idempotency.

🔗 Graph

🤖 LLM 활용

언제: 매 best practice 의 trade-off 설명 / 매 idempotency key generation. 언제 X: 매 specific SLA tuning — 매 production data 기반 결정 필요.

❌ 안티패턴

Cargo cult microservices: 매 boundary 없이 매 split.
Distributed transaction: 매 2PC across services.
Shared database: 매 service 간 매 schema 공유.
Dual write: 매 outbox 없이 매 DB + Kafka 동시 write.

🧪 검증 / 중복

Verified (Newman, Building Microservices 2e; Vernon, Implementing DDD; Fowler, Patterns of Enterprise Application Architecture).
신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — 매 outbox / circuit breaker / idempotency 추가

4.7 KiB Raw Blame History