Car

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

프로젝트 성격

Car는 차량 모뎀/게이트웨이에서 받은 상태를 수집해 DB에 저장하고, 웹 화면과 API에서 최신 상태와 명령 실행 결과를 제공하는 내부 차량 관리 서비스입니다.

모뎀에서 제공되는 값의 한계가 있으므로 도어 잠김, 경계, 시동, 공조 상태는 여러 필드를 조합해 해석합니다. 통신사 사용량은 DB 수집값과 T world 기준 보정값을 함께 사용합니다.

주요 기능

• 차량 상태 수집과 저장
• 차량 상태 API
• 허용된 차량 명령 TCP 전송
• monitor 화면과 AJAX 상태 갱신
• 사용량/요금 표시와 보정 metadata
• TCP 실패 reason과 마지막 수신 지연 표시
• 도어/경계/시동/공조 상태 해석
• service worker와 PWA icon 제공

주요 API

• api.php?action=status: 차량 상태 조회
• api.php?action=command: 차량 명령 전송
• monitor.php?mode=ajax: monitor 상태 AJAX
• monitor.php?mode=usage: 데이터 사용량 AJAX

구성

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

데이터/저장소

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

처리 흐름

1. collector_se.php가 차량 상태를 수집해 DB에 저장합니다.
2. monitor.php는 상태 AJAX와 사용량 AJAX를 분리해 갱신합니다.
3. 제어 요청은 token/IP 정책을 검증합니다.
4. 명령 코드를 허용 목록과 대조합니다.
5. TCP 게이트웨이로 전송하고 결과와 실패 reason을 반환합니다.

주요 함수/모듈

• common.php: secret 로드와 공통 DB/API 함수
• api.php: 상태 조회와 명령 전송
• monitor.php: 화면 렌더링과 AJAX 응답
• collector_se.php: 상태 수집과 중복 실행 방지

보안

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

운영 체크포인트

• 차량 TCP 실패 reason과 마지막 수신 지연을 확인합니다.
• 명령별 rate limit과 감사 로그를 유지합니다.
• 통신사 기준 데이터 사용량 보정값을 주기적으로 확인합니다.