Files

T

koriweb d8a80f6272 chore(wiki): dangling 링크 canonical 정규화 (768파일/1200건)

이름만 다른(표기 변형) [[위키링크]]를 대상 문서의 canonical 제목으로 치환해
끊겼던 1,200개 링크를 연결. 제목/파일명 정규화 일치만 적용하고 별칭 매칭은
과병합 위험으로 제외(애매성 가드). 원본은 _link_reconcile_backup/ 에 백업.
도구: Datacollect/scripts/link_reconcile_apply.mjs

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-08 12:24:15 +09:00

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

Integration Architecture Diagrams

매 한 줄

"매 system 의 external collaborators (services, APIs, queues, DBs) 의 visual mapping 의 통한 boundary + flow 의 communication". 매 Brown 의 C4 model (2018) 의 Context/Container level, 매 ArchiMate 의 application/technology layer, 매 modern 의 diagrams-as-code (Mermaid, Structurizr, D2) 의 dominant.

매 핵심

매 Diagram 종류

System Context (C4 L1): 매 system + users + external systems.
Container (C4 L2): 매 deployable units (web, api, db, queue).
Component (C4 L3): 매 container 내부 의 logical block.
Sequence: 매 time-ordered 의 message flow.
Data Flow Diagram (DFD): 매 process / store / external entity / flow.
Deployment: 매 infra topology (regions, VPCs, nodes).

매 Notation

C4 (simple, opinionated).
ArchiMate (enterprise, exhaustive).
UML deployment / component (legacy but valid).
Custom (Mermaid + emoji label).

매 응용

Onboarding doc — 매 new hire 의 system map.
ADR 의 visual aid.
Threat modeling (STRIDE) 의 trust boundary 의 mark.

💻 패턴

C4 System Context (Mermaid)

C4Context
  title System Context — Order Platform
  Person(customer, "Customer", "Buys products")
  System(order, "Order Platform", "Handles order lifecycle")
  System_Ext(stripe, "Stripe", "Payment processor")
  System_Ext(shipping, "ShipEngine", "Shipping carrier API")
  System_Ext(email, "SendGrid", "Transactional email")
  Rel(customer, order, "Places order", "HTTPS")
  Rel(order, stripe, "Charges card", "REST")
  Rel(order, shipping, "Creates shipment", "REST")
  Rel(order, email, "Sends confirmation", "SMTP API")

C4 Container (Structurizr DSL)

workspace {
  model {
    user = person "Customer"
    order = softwareSystem "Order Platform" {
      web = container "Web App" "Next.js 15"
      api = container "API" "Node.js / Fastify"
      db  = container "Postgres" "RDS" "Database"
      cache = container "Redis" "ElastiCache"
      queue = container "Kafka" "MSK"
    }
    user -> web "Uses" "HTTPS"
    web -> api "JSON/HTTPS"
    api -> db "SQL"
    api -> cache "RESP"
    api -> queue "produces"
  }
  views { container order { include * autolayout lr } }
}

Sequence — Distributed Transaction (Mermaid)

sequenceDiagram
  participant C as Client
  participant O as Order API
  participant P as Payment
  participant I as Inventory
  participant K as Kafka
  C->>O: POST /orders
  O->>I: Reserve stock
  I-->>O: OK (reservation_id)
  O->>P: Charge card
  P-->>O: success
  O->>K: publish OrderCreated
  O-->>C: 201 Created
  Note over K: Async fanout to Shipping, Email, Analytics

Data Flow Diagram (D2)

direction: right
customer: Customer { shape: person }
api: Order API
db: Postgres { shape: cylinder }
queue: Kafka { shape: queue }
analytics: Analytics WH { shape: cylinder }

customer -> api: POST /order
api -> db: INSERT
api -> queue: OrderCreated
queue -> analytics: stream

Deployment (PlantUML)

@startuml
!include <C4/C4_Deployment>
Deployment_Node(aws, "AWS us-east-1") {
  Deployment_Node(eks, "EKS cluster") {
    Container(api, "Order API", "Node.js")
  }
  Deployment_Node(rds, "RDS Multi-AZ") {
    ContainerDb(db, "Postgres 16")
  }
}
Rel(api, db, "TLS")
@enduml

Trust Boundary (Threat Model overlay)

flowchart LR
  subgraph Public[Public Internet]
    U[User]
  end
  subgraph DMZ
    LB[ALB / WAF]
  end
  subgraph Private[Private VPC]
    API[Order API]
    DB[(Postgres)]
  end
  U -- TLS 1.3 --> LB
  LB -- mTLS --> API
  API --> DB
  classDef boundary stroke-dasharray: 5 5
  class Public,DMZ,Private boundary

매 결정 기준

상황	Approach
Quick wiki diagram	Mermaid (GitHub renders inline)
Versioned + reviewed	Structurizr DSL or PlantUML in repo
Enterprise governance	ArchiMate (Archi tool)
Generated from code	terraform-graph, kroki, arkade
Threat modeling	DFD + trust boundaries (Microsoft TMT)

기본값: 매 C4 model — Context + Container 의 minimum, diagrams-as-code 의 (Mermaid / Structurizr).

🔗 Graph

부모: Software-Architecture
변형: C4 Model (Architecture Documentation)
응용: Mermaid · Structurizr · PlantUML · D2
Adjacent: ADR · Threat-Modeling

🤖 LLM 활용

언제: diagram 의 Mermaid/D2 source 의 generate, existing diagram 의 explanation, missing actor 의 detect. 언제 X: 매 enterprise architecture 의 governance decision (human + tool standard 필요).

❌ 안티패턴

PowerPoint architecture: PNG screenshot 의 stale, source 의 X.
Box-and-line soup: 매 label 없이 arrow 의 multitude.
Mixing levels: Context 의 component-level detail 의 cram.
No legend: 매 reader 의 notation 의 guess.
Aspirational diagram: actual deployment 의 mismatch — 매 onboarding 의 misleading.

🧪 검증 / 중복

Verified (Brown "Software Architecture for Developers", c4model.com, ArchiMate 3.2 spec).
신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — integration architecture diagrams 의 full content

5.7 KiB Raw Blame History