Software Engineering (3) 썸네일형 리스트형 OpenAPI Specification(OAS) : API 문서화의 게임 체인저 오늘은 API 개발과 문서화를 혁신적으로 바꿔놓은 **OpenAPI Specification(OAS)**에 대해 깊이 있게 알아보겠습니다.혹시 아직도 API 문서를 Word나 Notion에서 수동으로 작성하고 계신가요? 그렇다면 이 글이 여러분의 개발 인생을 바꿔드릴 수도 있습니다! 🤔 OAS가 뭔데?OpenAPI Specification(이전에는 Swagger Specification이라고 불렸음)은 REST API를 기술하기 위한 표준 규격입니다. 쉽게 말해서, API가 어떻게 동작하는지를 사람과 기계가 모두 이해할 수 있는 형태로 문서화하는 방법이에요.🏗️ 건축 설계도면 : 건물 = OAS 스펙 : API건축가가 설계도면을 보고 건물의 구조를 파악하듯이, 개발자는 OAS 문서를 보고 API의 모.. [DDD]바운디드 컨텍스트(Bounded Context)란? 바운디드 컨텍스트(Bounded Context)는 무엇인가요? 비지니스를 개념화 시키는 것이 모델링이며, 우리가 모델링을 할때 도메인을 정의를 통해서 모델링을 하게됩니다. 앞서 상품, 청구 각각의 도메인을 정의할때 각각은 서로 구분되어지는 경계 즉 Boundary가 있고, Boundary를 묶을때 의미(Context)가 동일하고 유사한 것들끼리 묶은 활동을 우리는 바운디드 컨텍스트를 정의 한다고 할수 있습니다. 바운디드 컨텍스트의 범위는 어디까지 일까요? 유사한것들 끼리 나누지만 유사의 정도가 차이 있으므로, 아래그림 처럼 경계를 더 크거나 더 작게 나눌 수 있습니다. 바운디드 컨텍스트는 어디까지 비지니스 환경이나 시스템 개발 환경에 따라 전략적으로 판단해서 나눌수 있으므로 정답은 없습니다. 예를들어 상.. [DDD] 도메인 주도 디자인(Domain Driven Design)의 시작 : 도메인 정의 Domain Driven Design 에서 말하는 '도메인'(Domain)을 사용하지만, 실무에서도 업무의 구분 등의 목적으로 '도메인' 이라는 용어를 자주 사용합니다. 시스템 혹은 회사의 비지니스를 잘 안다고 가정한다면, SW Arch. 관점에서 Biz. 상세하게 구조화 하고 분류 해야 할 필요가 있습니다. 이 단위가 도메인이라고 생각하면 될 것 같습니다. 20년째 제가 운영/개발을 하고 있는 통신 Biz. BSS 시스템에서도 도메인이라는 용어를 사용하고 있었습니다. "오더, 상품, 청구, 수납, 자원 등등.. " 또는 쇼핑몰 시스템이라면 "회원(고객)관리, 상품관리, 주문/계약, 파트너 관리 .. " 역시 이미 내부적으로 기능의 응집도와 결합도를 고민해서 나름의 작은 덩어리를 만들어서 사용하고 있을 .. 이전 1 다음
