Engine¶

Engine은 DADP의 런타임 실행 모듈이다. 단건, 배치, 스트림 암복호화 요청을 처리하고, Hub에서 동기화된 정책과 키 메타데이터를 실행 시점에 적용한다.

주요 책임¶

단건, 배치, 스트림 암복호화 실행
동기화된 정책과 키 메타데이터 적용
런타임 캐시 유지
실행 이벤트와 통계 생성

런타임 모델¶

Engine은 정책 원본을 직접 소유하지 않는다. 대신 Hub에서 분배된 상태를 로컬 런타임 캐시로 유지한다. 이 구조 덕분에 실행 요청은 매번 Hub를 왕복하지 않고도 처리될 수 있다.

Engine이 중요한 이유¶

Wrapper, Direct API, DB UDF는 진입 경계가 다르며, 기본 실행 주체는 Engine이다. 현재 구현에서는 Wrapper가 일부 경로에서 선택적으로 local crypto를 수행할 수 있지만, Engine은 여전히 가장 넓은 실행 범위와 fallback 경로를 담당한다. 따라서 Engine 상태는 단일 모듈 상태를 넘어 전체 실행면의 기준선에 가깝다.

운영 해석¶

Engine 문제는 다음에 직접 영향을 준다.

실시간 암복호화 요청
배치 처리
스트림 처리
세 연동 경로의 공통 실행 결과

Engine 장애 또는 캐시 불일치는 Wrapper만의 문제, DB UDF만의 문제처럼 보일 수 있지만 실제로는 공통 실행면 문제일 수 있다.

운영자가 주의할 점¶

생존 확인과 캐시 정합성 확인을 분리한다.
/api/health만 보고 정상이라고 결론내리지 않는다.
sync-check와 round trip을 함께 봐야 한다.