decision matrix

선택 기준은 호출 방식, 데이터 접근, 지연 시간, 실패 처리다

기능 이름보다 요청이 실제로 무엇을 해야 하는지가 런타임 선택을 결정한다.

선택지호출 방식데이터 접근실패 처리
API Routefetch/외부 HTTP서버 비밀키, DB 가능status code와 JSON 계약
Server Actionform/action 호출DB 변경 + cache revalidate폼 오류, optimistic UI 조정
Edge Function요청 초입 자동 실행가벼운 토큰/헤더 중심Node route로 fallback
Node RuntimeAPI/Action 내부 런타임Node SDK와 트랜잭션timeout, retry, log

판정 순서

Node 전용 의존성 확인 -> 요청 초입 분기 여부 -> 데이터 신선도와 실패 응답 -> p95/p99 지연 시간 측정 순서로 결정한다.