72 · 문서화 — 퍼블리셔


0. 퍼블리셔가 맡는 것

무엇을 · 어디로 · 무엇을 빼고 내보내는가. 만드는 일이 아니라 내보내는 일이다.

★★★ 이 저장소에서 퍼블리셔의 첫 책임은 「자료가 따라 나가지 않게 하는 것」이다. 자료 12,963 건은 회사 자산이다: 장비 SDK(제조사 제공) · 보안서버 소스 · 구성도 · 작업 기록.

1. 배포물 목록 — 무엇을 내보내나

배포물 담기는 것 담기지 않는 것
소스 묶음 코드 · docs/ · config/*.example 값이 든 설정 · 로그 · 자료
py 실행물 코드 + 필요한 의존 같음
네이티브 실행물 빌드 산출 같음
포장(AppImage) 위의 것 한 덩이 자료 절대 금지(61 §4)

2. 내보내기 전 점검 여덟

1. 값이 든 설정 파일이 섞였나          config/*.conf  → 빼야 한다
2. 로그가 섞였나                       경로·계정이 남는다
3. 자료가 섞였나                       cctv/ · 고성능저장장치/ 가 배포물에 있으면 중단
4. 비밀 감사가 초록인가                verify/secret_audit.py
5. example 이 생성물과 같은가          gen_conf_example.py 를 다시 돌려 견준다
6. 판 문자열이 맞는가                  --version 이 실제 판을 찍나
7. 격리에서 같은 지문인가              포장 안/밖 지문 일치
8. 문서 링크가 살아 있나               verify/doc_links.py

★★★ 3 번에서 걸리면 배포를 멈춘다. 실수로 한 번 나가면 되돌릴 수 없다.

3. 판 매기기

규약 왜
판은 빌드가 넣는다 코드가 문자열을 박으면 반드시 낡는다
판에 트랙을 적는다 연동·독립형·네이티브 중 무엇인지
판에 cfg 지문을 적지 않는다 설정은 배포물이 아니다
바뀐 것 목록(changelog)은 커밋에서 짓는다 손으로 적으면 빠진다

4. 외부로 내보내는 다른 길 — 더 조심할 자리

길 규약
외부 AI 협의체 nvr.council.egress.policy 가 기본으로 막는다(13 §5)
논문·특허 조회 우리 자료를 질의에 넣지 않는다 — 낱말만 보낸다(52 §3)
형제 저장소 쓰지 않는다(읽기만)
바깥 저장소·클라우드 하지 않는다. 필요하면 사람이 정한다

★★ 작업물은 저장소 주인의 것이다. 어디로 보낼지를 도구가 정하지 않는다.

5. 배포 뒤 남겨야 하는 것

남기는 것 왜
무엇을 언제 어디로 되짚을 수 있어야 한다
그때의 판·지문 「그 판에서만 나는 문제」를 재현한다
점검 여덟의 결과 다음 배포가 같은 것을 다시 본다

6. 아직 없는 것