car/README.md

Car

차량 상태 조회, TCP 명령 전송, 모니터링, 데이터 사용량 표시를 제공하는 PHP 기반 차량 서비스입니다.

주요 기능

• 차량 상태를 수집하고 DB에 저장합니다.
• 허용된 차량 명령만 TCP 게이트웨이로 전송합니다.
• 모니터링 화면은 상태 AJAX와 사용량 AJAX를 분리해 갱신 비용을 낮춥니다.
• 데이터 사용량과 요금 표시, 보정 metadata를 제공합니다.
• TCP 실패 reason과 마지막 수신 지연을 응답 meta로 확인할 수 있습니다.
• 도어/경계/시동/공조 상태를 제한된 모뎀 값 기반으로 해석합니다.
• T world 사용량 보정값과 DB 수집 사용량을 함께 표시합니다.

주요 API

• api.php?action=status
• api.php?action=command
• monitor.php?mode=ajax
• monitor.php?mode=usage

구성

• api.php: 차량 상태/제어 API
• monitor.php: 모니터링 화면과 AJAX 응답
• common.php: 외부 secret 로드와 공통 DB/API 함수
• collector_se.php: 상태 수집 CLI/cron
• sw.js: service worker
• assets/: 아이콘과 정적 자산

데이터/저장소

• 차량 상태, 명령 로그, 차트용 상태 기록 DB 테이블
• 사용량 수집값과 월별 보정 기준
• /home/seo/secret/car.php: TCP, DB, token, 허용 IP 설정

Secret

실행 설정은 /home/seo/secret/car.php에서 로드합니다. 이 파일은 저장소에 포함하지 않습니다.

TCP 설정, DB 접속 정보, API token, 허용 IP 정책은 외부 secret으로 유지합니다.

보안

• 차량 API는 API token 또는 허용 IP 정책을 사용합니다.
• 차량 제어 명령은 허용된 명령 코드로 제한합니다.
• Secret 파일은 저장소 밖에서 제한된 권한으로 유지합니다.
• 실제 제어 명령은 최신 상태 조회와 명령 검증 이후에만 전송합니다.