avls.crowny.org W4 — 분석 엔진 + 운전자 스코어링 + API v2

날짜: 2026-05-02 서비스: avls.crowny.org:9736

개요

AVLS v2.0 고도화 4주차 작업. 운전자 스코어링, 이상 탐지, 경로 최적화(TSP), 연료 분석, REST API v2를 추가했다.

무엇을 했는지

서버 (server.js → 2085줄)

1. DriverScoring 클래스: 과속/급제동/공회전/안정주행 기반 0~100점 + A~F 등급
2. AnomalyDetector 클래스: 속도 편차(2.5σ), 급정지(50km/h↓), GPS 편차, 위험 연료
3. nearestNeighborTSP: 최근접 이웃 TSP 근사 알고리즘으로 경로 최적화
4. 연료 분석 API: 차량별 소비율 추정, 잔여 시간 예측, 주유 권장
5. API v2: 필터(status/type/search/minSpeed/maxFuel) + 정렬 + 페이지네이션

UI (web/index.html → 1870줄)

1. 분석 탭: 스코어링/이상탐지/연료분석 3개 뷰
2. 스코어링 UI: 원형 점수 링, 감점 항목 상세, 등급 표시
3. 이상탐지 UI: 심각도 배지, 타입별 상세 설명, 프레임 번호
4. 연료분석 UI: KPI 4개 + 차량별 연료 바 + 소비율/잔여 시간

한선씨 동반

• avls-스코어링.한선 — 운전점수 계산 + 등급 판정 + 이상 탐지

새 API 엔드포인트

GET  /api/scoring            전체 운전자 스코어링
GET  /api/scoring/:id        개별 운전자 점수
GET  /api/anomalies          전체 차량 이상 탐지
GET  /api/anomalies/:id      개별 차량 이상 탐지
POST /api/optimize/route     경로 최적화 (TSP 근사)
GET  /api/optimize/fleet     차량 순회 최적화
GET  /api/fuel/analysis      연료 분석
GET  /api/v2/vehicles        API v2 (필터/정렬/페이지네이션)

관련 파일

• /Users/ef/crowny-avls/server.js — 메인 서버 (2085줄)
• /Users/ef/crowny-avls/web/index.html — SPA 대시보드 (1870줄)
• /Users/ef/crowny-avls/avls-스코어링.한선
• /Users/ef/crowny-avls/CLAUDE.md — 프로젝트 문서 (업데이트됨)

잔여 이슈

• W5: 멀티테넌트 데이터 격리, SSO 역할기반 접근, 백업/복원, 스트레스 테스트, 한선씨 네이티브 서버