심환석

통화 한 건이 지나는 구간

1. 전화 수신

   인터폰 → Asterisk PBX → TypeScript Relay

2. STT

   Google STT, 전화망 8kHz 음성을 16kHz 스트림으로

3. 보조 전사

   필요한 정보가 빠졌을 때만, 같은 턴 원음을 Gemini가 다시 전사

4. 대화 제어

   상태 기반으로 동·호수와 방문 목적 확인

5. 출입 명령

   주차 관제 API

   상담원 인계

모니터링 웹 (SSE)

자동 허용보다 ‘모름’과 상담원 인계를 택한다.

• 전화 수신운영 반영

  프로세스는 살아 있는데 전화가 끊길 때

  PJSIP 등록 장애를 3단계 watchdog으로 자동 복구

• STT운영 반영

  전화망 8kHz 음성을 STT가 믿을 수 있는 16kHz 스트림으로 바꾸기

  리샘플링·VAD·20ms 페이싱·backpressure

• 보조 전사운영 반영

  STT가 놓친 정보만 같은 턴 원음으로 Gemini가 다시 듣게 하기

  확정된 값은 덮어쓰지 않음

  동·호수·방문 목적 보조 전사 574회 중 139회 빈 정보 보완

  2026.07.31–08.05 운영 로그

• 출입 명령운영 반영

  잘못 들은 동·호수가 출입 명령으로 이어지지 않게

  현장 허용 목록으로 두 번 검증

  외부 명령 응답 성공률 99.14% (3,461 / 3,491)

  관제 API 응답 기준이며 차단기의 물리적 개방을 잰 값은 아님

• TypeScript
• Node.js(Express)
• Asterisk(PJSIP·AudioSocket·AMI)
• Google Cloud STT·TTS
• Gemini
• SSE
• PM2·systemd

1.x에서 2.0으로 바꾼 것

	1.x 2025.05	2.0 2026.10
단지	1곳	여러 단지
서버	메인 서버 + 주차장 DB 폴링 서버(별도 프로세스)	통합 서버 1개
관리자 웹	DB 직접 접속, 인증 없음	서버 API 경유, 단지별 권한
운영	Windows + PM2	Docker Compose
앱	기존 API 25개 계약을 그대로 지켜 구버전 앱도 계속 동작

1.x는 노원 단지에서 운영 중, 2.0은 부천 단지 오픈을 준비 중(서버 구축·입출차 검증 완료, 2026.10).

테스트용 가짜 세대로 찍은 실제 앱 화면

• TypeScript
• Fastify
• zod
• PostgreSQL
• Drizzle
• Next.js
• Flutter
• Firebase(FCM·Remote Config)
• MSSQL 연동
• Docker Compose
• Caddy