# 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 파일은 저장소 밖에서 제한된 권한으로 유지합니다.
- 실제 제어 명령은 최신 상태 조회와 명령 검증 이후에만 전송합니다.