1. 프로젝트 개요
종로구 집회 알림톡 - 카카오톡 기반 실시간 집회 정보 서비스
카카오톡 챗봇을 통해 종로구 지역의 집회 정보를 실시간으로 제공하고, 사용자 경로 기반 맞춤 알림을 전송하는 비즈니스 서비스

2. 배경 및 문제정의
현황 분석
- 종로구 일평균 유동인구수: 2025년 기준 408,031명 (서울 생활 인구 현황)
- 종로구의 지난 6년간 집회 횟수: 67,640건 (경찰청 경찰백서)
- 연도별 집회 발생 추이: 2019년 13,864건에서 2024년 10,287건으로 지속적 발생 (연평균 약 11,273건, 월평균 약 939건)

문제 정의
- 집회의 성지 종로: 가장 많은 집회가 이루어지는 도시 1위인 중로구에서 집회 관련 정보를 쉽게 접근할 수 없음
- 종로구 일평군 유동인구수 408,031명, 지난 6년간 집회 발생 횟수 67,640건
- 그럼에도 사용자는 집회 정보를 위해 웹이나 앱을 방문하지 않으며 집회 정보를 확인하기 위해 모든 플랫폼을 방문하여 정보를 얻기에는 매우 번거로움

해결 방안
- 국민 대부분이 사용하는 메신저 1위 어플, 카카오톡을 통해 집회 정보 및 대중교통 통제 정보 제공
- 별도의 웹/앱 설치가 불필요하며 일방적 소통이 아닌 개인형 맞춤 정보 제공

3. 주요 기능
3-1. 사용자 채널 추가
- 카카오톡 자동 발송 메시지: 종로구 집회 알림톡 채널을 추가하게 되면, 카카오톡 메시지 수신 및 웰컴 메시지 전송
- 커스텀 메뉴 구성: 4개의 메뉴로 구성된 커스텀 메뉴 설정: 관심 경로, 관심 지역, 언어 설정, 실시간 집회 현황

3-2. 실시간 경로 기반 집회 감지 시스템
- 카카오 Mobility API 연동: 실제 보행 경로 계산
- Haversine 알고리즘: 500m 이내 집회 정밀 거리 계산
- 자동 알림: 경로상 집회 발견 시 카카오톡 Event API를 통한 즉시 푸시 알림
- 병렬 처리: 성능 최적화로 다수 사용자 경로 동시 확인

3-3. 집회 데이터 자동 크롤링 및 동기화
- 서울경찰청(SMPA) PDF 데이터 자동 수집 시스템 구축
- 스케줄링: APScheduler를 활용한 매일 오전 8시 30분 자동 업데이트
- 중복 제거: 스마트 데이터 중복 방지 로직 구현
- 실시간 동기화: 크롤링된 데이터를 데이터베이스에 자동 반영

3-4. 카카오톡 챗봇 및 알림 시스템 구현
- 챗봇 폴백 블록: 사용자 메시지 수신 및 자동 응답
- 스킬 블록: 경로 등록, 초기 설정, 집회 정보 조회 API 개발
- Event API: 실시간 푸시 알림 전송 (병렬 처리로 대량 알림 최적화)
- 웹훅: 채널 추가/차단 상태 실시간 동기화

3-5. 사용자 및 집회 데이터 관리 API
- 사용자 CRUD: 자동 등록, 경로 설정, 개인화 설정 (관심 버스 노선, 선호 언어)
- 집회 CRUD: 집회 정보 생성/조회/수정/삭제
- 카카오 지도 API 통합: 출발지/도착지 장소 검색 및 좌표 변환
- 상태 동기화: 웹훅을 통한 실시간 활성/비활성 사용자 관리

4. 기대 효과
4-1. 접근성 강화: 국민 대부분이 사용하는 카카오톡을 통해 별도 앱 설치 없이 집회 정보를 얻기 위해 웹과 앱을 방문해야 하는 번거로움 제거
4-2. 정보의 통합: 플랫폼별 제공하는 정보가 달라 정보를 얻기 위해 많은 시간을 할애해야 했던 문제 해결
4-3. 맞춤형 정보, 알림: 사용자는 카카오톡 채널이라는 보편화된 경험을 재사용하지만 실제 서비스 내에서 개인형 서비스를 경험
4-4. 확장 가능성: 종로 이외의 구역으로 서비스 확대, 교통, 생활안전, 행사 일정 등을 통한 정보 서비스