Files
niro-gen5w/docs/PUBLICATION_KO.md
T

38 lines
3.0 KiB
Markdown

# 공개 범위와 출처
## 별도 공개 저장소
기존 비공개 운영 저장소의 `.git`·이력·설정·리모트를 복사하지 않고 새 이력으로 시작합니다. 이 저장소를 운영 배포의 기준선으로 사용하지 않습니다.
## 초기 공개 소스의 출처
| 공개 모듈 | 성격 | 시험 입력 |
|---|---|---|
| `HscanRpmDecoder` | 개인 프로젝트에서 작성한 수신 프레임 검증·RPM 해석 코드 | 프로그램으로 생성한 합성 프레임 |
| `WeatherRefreshGate` | 직접 작성한 요청 admission·재사용·실패 backoff 상태기계 | 합성 monotonic 시각 |
| `WeatherRefreshCounters` | 직접 작성한 요청/완료 계수와 파일 교체 로직 | 시험 임시 디렉터리 |
| `NiroMqttKeepalive` | 직접 작성한 MQTT keepalive 시간 추적 | 합성 시각 |
| `NiroRawSnappy` | 직접 작성한 raw Snappy literal encoder | 합성 바이트열 |
| 과거 V038 차속 생성기 | 입력 해시·명령 창·변경 범위를 검사하는 직접 작성한 도구 | 합성 이미지, 제조사 원본 없음 |
Java namespace는 원래 코드의 `com.chaegeon.niro`를 유지합니다. 이는 운영 서버 주소나 차량 식별값이 아닙니다. 시험의 CAN envelope·메시지 번호·단위는 설명을 위한 계약 정보이며 실차 capture 전체를 포함하지 않습니다.
내비 예제에는 호환성 검사용 짧은 명령 값과 직접 작성한 wrapper가 있습니다. 제조사 라이브러리 자체·디컴파일 전체·지도·완성 패치 바이너리는 제공하지 않습니다. 대상 파일을 소유한다는 사실만으로 모든 변경·배포 권한이 생기는 것은 아니므로 적용 가능성과 이용 조건은 각자가 확인해야 합니다.
외부 프로젝트는 관련 링크로 소개할 뿐, NEMESIS·Leafia·gen5w-utils의 소스·바이너리를 초기 공개본에 가져오지 않았습니다. 향후 외부 코드를 추가하면 원래 라이선스와 변경·출처를 별도로 기록해야 합니다.
## 제외한 것
- 제조사 펌웨어·지도·APK·ODEX·라이브러리 원본 및 수정 전체 배포물
- 차량의 실제 GPS·주행 기록·전화번호·VIN·차량 고유 식별자
- API 키·비밀번호·SSH 개인키·MQTT 인증정보·공유 원문 token
- 실차·운영 서버의 원문 로그·DB·백업·내부 주소·배포 설정
- 차량 자동 접속·재부팅·실제 명령 실행·ECU 쓰기 기능
- 이전 비공개 Git 이력과 운영 배포 파일
## 공개 검사
`tools/check_publication.py`는 공개 허용 파일 목록과 기본 비밀값·금지 산출물을 검사합니다. Git이 초기화돼 있으면 추적 파일과 이력의 정체성도 확인합니다. 이 검사는 모든 개인정보·저작권·보안 문제를 자동 판별하는 감사가 아닙니다.
새 파일을 추가하려면 내용을 검토한 뒤 허용 목록을 명시적으로 갱신해야 합니다. `.gitignore`만 바꿔 이미 추적된 파일이나 과거 이력이 사라진다고 가정하지 않습니다.