Beyond Entity
정확한 설계,
일관된 구현
코드의 브랜치, PR과 동기화된
데이터 및 프로세스 설계서 Git을 확인할 수 있습니다.
Intro: Petronas Towers
정확한 설계와 구현의 조화가 만든 걸작
- 설계자(시저 팰리)와 시공자는 서로 다른 기업
- 그럼에도 41·42층 스카이브릿지를 100% 정합 → 정확한 설계와 이를 충실히 따르는 구현이 성공의 핵심
소프트웨어 개발도 동일합니다.
단, 설계와 구현이 쉽게 어긋난다는 점만 다릅니다.
The Problem
소프트웨어 개발에서 반복적으로 발생하는 문제:
- 요구사항·기술 변경으로 설계 문서가 빠르게 낡아감
- 설계 문서와 실제 코드가 일치하지 않음 (Design–Implementation Drift)
- ERD, API 스펙 등이 서로 다른 버전으로 흩어짐
- 최신 상태를 아는 유일한 방법: 코드를 직접 분석
→ 설계는 있지만, '살아있는 설계'가 아니다.
Why This Matters Now
AI 코드 생성 시대, 설계의 신뢰성은 더욱 중요
- AI는 입력된 설계를 기준으로 코드를 생성
- 설계가 틀리면 AI의 코드도 틀림
- 설계·데이터 구조·I/O 정의 등 품질 요소가 설계에 집중됨
→ 설계와 구현을 연결하는 새로운 방법이 필요하다
Beyond Entity's Approach
설계를 문서가 아니라
'실행 가능한 자산'으로 만든다.
1. 모든 데이터를 ERD 방식으로 통합 정의
하나의 플랫폼에서 다음을 동일한 방식으로 모델링:
- RDB, Wide Column Storage, NoSQL
- Key-Value Store
- Log File, Data File
→ 이질적인 데이터를 하나의 구조 언어로 통합
2. 모든 Data Movement를 프로세스 다이어그램으로 정의
- ELT / ETL / Data Pipeline
- API
- Batch Job
- Internal Processor
→ 데이터가 어떻게 이동·변환·전달되는지 시각적으로 표현
3. 자동 Data Flow Map 시각화
- 엔티티 ↔ 프로세스 ↔ 엔티티 연결
- I/O 종속성 자동 파악
- 변경 영향도(Impact) 분석 가능
→ 데이터 흐름을 조직 전체가 한눈에 이해
4. AI 기반 코드 생성용 Markdown/JSON 자동 생성
AI가 필요한 모든 정보를 자동 출력:
- Input/Output 스키마
- 데이터 변환 및 예외 처리 규칙
- 엔티티 매핑 및 데이터 구조 정의
→ AI 코드 생성의 품질을 '설계로 통제'할 수 있는 구조
5. Git 기반 설계–구현 버전 매핑
설계서 파일이 아니라 Git Branch/Commit과 직접 연결:
- 릴리즈별 설계 추적
- 스프린트별 설계 변경 이력 자동 관리
- 코드와 설계의 Drift 제거
→ 설계는 코드와 동일한 버전 관리 프로세스를 거친다
Product Value
- Outdated 설계 문서 제거
- 데이터 & 프로세스 구조의 단일화
- AI 코드 생성 품질 안정화
- 변경 관리 비용 감소
- Dev, QA, DevOps, Data팀 간 협업 강화
Value Proposition
- 설계는 더 이상 "문서 산출물"이 아니다
- 설계는 "프로덕션 품질을 좌우하는 실행 자산"이다
개발과 운영의 품질을 근본적으로 끌어올리는
새로운 Engineering 기반 개발 문화를 제공
Conclusion
“소프트웨어 개발은 Art가 아니라 Engineering이다.”
페트로나스 타워의 스카이브릿지처럼,
정확한 설계와 이를 충실히 구현하는 과정이 성공의 본질입니다.
→ 조직 전체의 품질을 끌어올리는 새로운 표준
Beyond Entity
정확한 설계.
일관된 구현.
데이터 중심 Engineering의 새로운 기준.