엔티티 - Client Device

누구 또는 무엇인가

Client Device는 chemical의 데스크톱 경로에서 등록, heartbeat, 강제 업데이트, revoke 대상이 되는 관리형 클라이언트 디바이스 엔티티입니다. 소스 기준으로는 CLIENT_DEVICE, CLIENT_UPDATE_LOG, /clients/register, /clients/{device_id}/heartbeat, /clients 계열 API와 함께 읽을 수 있습니다.

관련성

이 엔티티는 chemical이 순수 브라우저 SaaS만이 아니라 Tauri 기반 데스크톱 운영 경로도 갖는다는 점을 보여줍니다. 특히 CBI 보호, 버전 강제, 접속 차단 같은 운영 요구사항이 단순 사용자 계정만으로는 처리되지 않고 실제 디바이스 단위까지 내려간다는 점이 중요합니다.

관련 소스

• 도메인 - Chemical
• 소스 - Chemical Spec
• repo-local raw/imports/chemical-spec.md

관련 개념

• 개념 - BFF 인증
• 개념 - 테넌트 격리
• 엔티티 - Chemical BFF Service
• 엔티티 - Chemical Regulation SaaS
• 비교 - BFF 인증 vs 클라이언트 직접 JWT
• 비교 - 브라우저 세션 경로 vs 관리형 클라이언트 경로

메모

• 이 엔티티의 핵심은 로그인 여부보다 운영 관리 가능성입니다.
• active, revoked, update_required 같은 상태는 단순 접속 상태가 아니라 운영 정책 강제 수단입니다.
• 웹 사용자 계정과 달리 기기 버전, 마지막 heartbeat, 업데이트 이력을 같이 관리합니다.