피드로 돌아가기
ARO – A language where business logic reads like documentation
Dev.toDev.to
Backend

OpenAPI 기반 Contract-First 설계의 선언적 언어 ARO 구현

ARO – A language where business logic reads like documentation

Kris Simon2026년 4월 19일4advanced

Context

비즈니스 로직의 복잡성으로 인해 개발자와 비개발자 간의 커뮤니케이션 비용이 증가하는 문제 분석. 기존 API 개발 방식의 파편화된 라우팅 설정과 복잡한 에러 핸들링 구조를 개선하려는 목적.

Technical Solution

  • Action-Result-Preposition-Object의 단일 문법 패턴을 통한 비즈니스 로직의 문서화 수준 가독성 확보
  • OpenAPI Specification을 Single Source of Truth로 활용하여 Routing DSL 및 Decorator를 완전히 제거한 Contract-First 아키텍처 설계
  • Event-driven architecture를 내장하여 Event Name 기반의 자동 핸들러 바인딩을 통한 코드 결합도 최소화
  • LLVM 기반의 Native Compilation과 C ABI 공유를 통한 Swift, Rust, Python 등 다국어 Plugin 확장성 제공
  • 별도의 try-catch 없이 실패한 실행 문장 자체가 에러 메시지가 되는 단순화된 Error Philosophy 채택

- API 설계 시 OpenAPI 스펙을 먼저 정의하고 구현체와 강하게 결합하는 Contract-First 전략 검토 - 복잡한 비즈니스 도메인에서 로직을 선언적 패턴으로 추상화하여 커뮤니케이션 비용을 낮추는 방안 모색 - LLVM 및 C ABI를 활용한 다국어 플러그인 시스템 구축을 통한 언어별 강점 활용 설계 고려

원문 읽기