프로젝트 배경
1) 문제점 위시켓 "통신 3사 인터넷 전화 연동 미들웨어 개발" 공고(예산 1,000만 원) 수주를 위해 "유사 프로젝트 경험"을 구두가 아닌 동작하는 코드로 증명해야 했습니다. 실 통신사 API는 사업자 계약 없이 접근이 불가하여 CID 수집·녹취 파일·실시간 전송·모니터링까지 전 범위를 입증할 레퍼런스가 없는 상황이었습니다. 2) 프로젝트 목표 Docker Compose 단일 명령으로 기
프로젝트 성과
REST + WebSocket 이중 엔드포인트 완전 구현
총 13개 엔드포인트(REST 11개 + WebSocket 2개) 구현 완료.
Swagger UI 자동 생성 포함. 공고가 요구한 두 전송 방식을 환경변수 토글로 모두 커버.
Swagger UI 자동 생성 포함. 공고가 요구한 두 전송 방식을 환경변수 토글로 모두 커버.
pytest 3개 파일 전부 Pass
adapters·api·recordings 3개 테스트 파일 전원 통과.
Mock 실패 모드(3회 재시도 + 최종 실패 로그 적재) 플로우까지 자동 검증 완료.
Mock 실패 모드(3회 재시도 + 최종 실패 로그 적재) 플로우까지 자동 검증 완료.
실연동 전환 비용 최소화 (파일 1개 + 코드 1줄)
어댑터 파일 신규 추가 + main.py 1줄 등록으로 실 통신사 전환 가능.
5단계 체크리스트로 KT 센트릭스 기준 전환 절차 README 문서화.
5단계 체크리스트로 KT 센트릭스 기준 전환 절차 README 문서화.
Docker Compose 단일 명령 5개 서비스 즉시 기동
backend·frontend·postgres·asterisk·mock-receiver 5개 서비스를
`docker compose up` 한 줄로 완전 실행 가능한 데모 스택 구성.
`docker compose up` 한 줄로 완전 실행 가능한 데모 스택 구성.
핵심 기능
진행 단계
요구 분석 · 아키텍처 설계
2026.04.
공고 요구사항 3가지(CID 수집·실시간 전송·모니터링) 분석 후
Asterisk AMI 채택 근거와 Adapter Pattern 인터페이스 설계. Docker Compose 서비스 구성 확정.
Asterisk AMI 채택 근거와 Adapter Pattern 인터페이스 설계. Docker Compose 서비스 구성 확정.
프로젝트 상세
1) 포트폴리오 소개 통신 3사(KT·LGU+·SKB) 인터넷 전화 연동 미들웨어를 실 API 없이도 동작하는 코드로 구현한 수주 대응용 풀스택 데모입니다. Asterisk AMI를 CTI API의 구조적 원형으로 활용하고 Carrier Adapter Pattern을 적용해 어댑터 파일 1개만 교체하면 실 통신사 연동으로 전환되는 프로덕션 수준 아키텍처를 구현했습니다. Docker Compose 단







