Alphea App

작업 내용¶

운영 중인 Lambda 프록시의 인수인계 문서와, 향후 Lambda 외 플랫폼(Rust/Node 서버)으로 포팅할 때 참조할 구현 가이드를 작성한다.

HANDOVER.md (현행 Lambda 운영·장애 대응 문서)¶

• 존재 이유(3가지): API 키 보호 + 시스템 프롬프트 보호 + 홍콩 리전 우회
• 아키텍처 다이어그램, 핵심 3가지 동작 (인증 / 스트리밍 트릭 / 프롬프트 캐싱)
• 엔드포인트 계약, 배포·재배포 절차, 환경 변수 매트릭스
• 흔한 장애 패턴 5종, 스모크 테스트 명령
• 설계 결정 기록 (why, not what)
• 알려진 한계 & TODO (레이트 리미팅, Node 22 승격 등)
• 인수 체크리스트 7항목

docs/anthropic-proxy-guide.md (포팅 가이드)¶

• Request/Response TypeScript 타입 정의 (클라이언트·서버 공유 가능 스키마)
• HTTP 상태 코드 매핑
• messages.stream() + finalMessage() 패턴 원리와 Node/Rust 예시
• 시스템 프롬프트 주입 + cache_control: ephemeral 캐싱 구조
• 프롬프트 로딩 전략 4가지 비교 (빌드 동봉 / env / S3 / DB)
• 프롬프트 인젝션 방어 개요
• 서버 구현 샘플: Express(Node), Axum+reqwest+eventsource-stream(Rust) with Cargo.toml
• 검증 체크리스트 (캐시 히트 증명 포함), 흔한 함정 테이블

수용 기준¶

• 신규 서버 개발자가 HANDOVER.md 만 읽고 배포·장애 대응 가능
• 포팅 가이드 만으로 Rust/Node 서버 스켈레톤 재현 가능
• 두 문서 모두 docs/AXI_instructions.md 가 진실의 원천임을 명시

관련 파일¶

• infra/lambda/anthropic-proxy/HANDOVER.md
• docs/anthropic-proxy-guide.md

의존성¶

• Task A, B 선행 (문서가 참조하는 인프라 실체가 먼저 있어야 함)

커밋 메시지 (예)¶

docs: anthropic-proxy 인수인계 및 포팅 가이드 문서 작성 fixes #<N_D>