How codergogh/seoul-ev-data-platform works
서울 전동화 입지 인사이트 플랫폼은 서울 3개 구의 도로·차량등록·충전기 데이터를 수집해 품질을 검증하고, 충전소 우선 검토 지역을 산출해 웹에 공개합니다. 운영 DAG는 재처리, 품질 모니터링, SLA 감시, 보존 정리와 백업을 지원합니다. 웹은 분석 결과와 운영 화면을 제공하며 OAuth 로그인과 역할별 접근을 적용합니다. DAG 간 주요 흐름은 README를 근거로 표시했고, 일부 DAG와 웹 기능은 구현을 읽지 않아 관계를 문서 근거로만 그렸습니다.
Main entry points: ev03_mart_integration.py 지표·품질 관문 · ev02_registration_monthly.py 등록 수집 · db.py SQL·트랜잭션 접근 · App.tsx 웹 앱 라우팅
Components 27
수집·분석
운영·품질
게시·저장
- 분석 데이터베이스
- SQL·트랜잭션 접근
plugins/common/db.py - 웹 데이터 게시
dags/ev14_web_publish.py
분석 웹
인증·권한
- 세션·프로필
web/src/auth/AuthContext.tsx - 역할 판정
web/src/auth/roles.ts - Supabase 인증
web/src/auth/supabase.ts
Other components
- 분석 사용자
- 공공 데이터 API
- Vercel 웹
- Slack
Connections 40
- 공공 데이터 API → 도로 수집: 도로 관측 제공
- 공공 데이터 API → 등록 수집: 등록 자료 제공
- 공공 데이터 API → 충전기 수집: 충전소 자료 제공
- 도로 수집 → 분석 데이터베이스: 수집 적재
- 등록 수집 → 분석 데이터베이스: 월 스냅샷 적재
- 충전기 수집 → 분석 데이터베이스: 일 스냅샷 적재
- 수요 보조 → 분석 데이터베이스: 주간 스냅샷 적재
- 도로-동 매핑 → 분석 데이터베이스: 매핑 버전 적재
- 분석 데이터베이스 → 지표·품질 관문: 입력 조회
- 등록 수집 → 지표·품질 관문: Asset 알림
- 도로-동 매핑 → 지표·품질 관문: Asset 알림
- 지표·품질 관문 → 분석 데이터베이스: 마트 교체
- 지표·품질 관문 → 웹 데이터 게시: 게시 Asset
- 충전기 수집 → 웹 데이터 게시: 공급 Asset
- 웹 데이터 게시 → Vercel 웹: 데이터 게시
- 도로 수집 → SQL·트랜잭션 접근: DB 접근
- 등록 수집 → SQL·트랜잭션 접근: DB 접근
dags/ev02_registration_monthly.py - 등록 수집 → 실행·품질 기록: 실행 기록
dags/ev02_registration_monthly.py - 수요 보조 → SQL·트랜잭션 접근: DB 접근
dags/ev05_demand_aux_weekly.py - 수요 보조 → 실행·품질 기록: 품질 기록
dags/ev05_demand_aux_weekly.py - 지표·품질 관문 → SQL·트랜잭션 접근: SQL 실행
dags/ev03_mart_integration.py - 지표·품질 관문 → 실행·품질 기록: 실행·품질 기록
dags/ev03_mart_integration.py - SQL·트랜잭션 접근 → 분석 데이터베이스: 트랜잭션 읽기·쓰기
plugins/common/db.py - 실행·품질 기록 → SQL·트랜잭션 접근: 기록 저장
plugins/common/ops.py - 재처리 진입점 → 등록 수집: 재실행 요청
- 재처리 진입점 → 지표·품질 관문: 재실행 요청
- 품질 모니터 → Slack: 품질 리포트
- SLA 감시 → Slack: 기한 알림
- 보존 정리 → 분석 데이터베이스: 조건부 삭제
- DB 백업 → 분석 데이터베이스: 백업·복원
- 분석 사용자 → 웹 앱 라우팅: 결과 조회
- 웹 앱 라우팅 → 웹 데이터 로더: 데이터 로드
web/src/App.tsx - 웹 데이터 로더 → 분석 화면: 결과 데이터 제공
web/src/data.ts - 웹 앱 라우팅 → 운영 화면: 화면 분기
web/src/App.tsx - 분석 화면 → 지역 지도: 지도 표시
web/src/pages/RegionDetail.tsx - 분석 화면 → 웹 데이터 로더: 지역 데이터 조회
web/src/pages/RegionDetail.tsx - 웹 앱 라우팅 → 세션·프로필: 인증 상태 조회
web/src/App.tsx - 세션·프로필 → Supabase 인증: 인증·프로필 조회
web/src/auth/AuthContext.tsx - 세션·프로필 → 역할 판정: 역할 타입 사용
web/src/auth/AuthContext.tsx - 웹 앱 라우팅 → 역할 판정: 화면 접근 판정
web/src/App.tsx