72 · 문서화 — 퍼블리셔
- 작성일: 2026-09-25 · readme 153 줄(「문서화 — 퍼블리셔」)에 답한다
- 상태(2026-09-25 · 전체 스프린트 뒤): 섰다 —
verify/pack.sh가 배포물에서 자료·비밀을 막는다(점검 통과). 남은 것은 마지막 절.
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. 아직 없는 것
- 배포한 적이 없다. 점검 여덟을 돌리는 스크립트도 없다.
verify/secret_audit.py가 섰다(관문 1) — 붉음 0 · 주의 71 · 미끼 7 · readme 알림 13.- 판 매기는 규칙을 정하지 않았다(날짜판·의미판 중 무엇을 쓸지는 운영이 정한다). </content>