73 · 문서화 — 운영자

0. 운영자가 정하는 것 — 값 전부

★★★ 이 저장소에서 값을 정하는 사람은 운영자다. 코드도 Claude 도 아니다. 00 §8 의 키 목록이 곧 운영자의 결정 목록이다.

묶음 무엇을 정하나
인프라 브로커·토픽·캐시 주소·수명·IPC 소켓
걷이 어디를 · 얼마나 깊이 · 얼마나 크게 · 몇 개씩
원격 어느 호스트 · 어느 계정 · 자격 참조 · 대기·재시도
자동 갱신 켤 것인가 · 얼마나 자주 · 무엇을 신호로
학습 백엔드·장치·회차·정밀도 · 승격·되돌림 조건
협의체 참여자 · 정족 · 무엇을 밖으로 보내나
얼굴 테마·색·명암비·글꼴·주소·포트

1. 첫 설치 — 순서

1. dnarna doctor                  무엇이 있고 무엇이 없는지 본다
2. config 를 만든다               gen_conf_example.py 가 만든 example 을 채운다
3. 자격은 참조로 넣는다            env:이름 · file:경로 (값을 파일에 적지 않는다 — 80 §3)
4. dnarna catalog scan --dry-run  계획만 본다
5. dnarna catalog scan            돌린다
6. verify/run_all.sh              초록/붉음/건너뜀 세 수를 본다

★★ 2 번에서 example 을 손으로 고치지 않는다 — example 은 생성물이다. 값은 운영자의 설정 파일(또는 env)에 넣는다.

2. 이 호스트의 지금 상태 (2026-09-25 실측)

자원 상태 운영자가 할 일
redis 있다(6379) 그대로 쓴다
kafka 없다 띄울지 정한다 — 없으면 로컬 로그로 돈다(01 §6)
ainsbusd 확인 안 함 소켓 자리·framing 심볼 확인(10 §2)
ollama 있다(모델 9 · embeddinggemma 포함) 임베더·추론 주소를 cfg 에
변환 도구 LibreOffice·hwp5txt·PyMuPDF·pptx·docx·openpyxl·tesseract·ffmpeg 있다 갈래별 도구 대응을 cfg 에
faiss 없다 벡터 색인 길을 정한다(설치할지 · 전수 비교로 갈지)
내부망([가림]·.45) ping 무응답 차단인지 부재인지 확인이 필요하다
이 저장소 git 이다(2026-09-25 개시 · core.quotepath=false) 자료 2.2 GB 를 이력에 넣을지 정한다(12 §1 · 지금은 빼 두었다)

3. 매일 보는 것 넷

무엇 어디서 무엇이 나쁜 신호인가
걷이 결과 catalog stats 못 본 것이 갑자기 늘었다 = 원천이 끊겼거나 도구가 죽었다
건너뜀 수 run_all.sh 건너뜀이 늘면 관문이 실제로 재는 범위가 줄었다
세대 learn 기록 승격이 자꾸 미달 → 잼 기준이나 자료를 본다
사건 수 진실원 읽기가 사건을 내고 있지 않은가

★★★ 「0 건」을 성공으로 읽지 않는다. 걷이 0 건은 거의 항상 끊긴 마운트다(09 §3).

4. 멈추는 법 · 되돌리는 법

상황 하는 일
자동 갱신을 멈춘다 nvr.watch.enabled 끔 — 다음 바퀴가 안 뜬다
지금 도는 굽기를 끊는다 중단 — 중간 산출은 승격되지 않는다
나쁜 세대가 승격됐다 learn rollback — 부모로 돌아간다(08 §6)
캐시가 이상하다 캐시를 버린다. 진실원에서 다시 선다(01 §7)
자료를 잘못 걷었다 대장에서 표시로 뺀다(원본은 건드리지 않는다)

5. 하지 말아야 할 것 다섯

1. example 을 손으로 고쳐 값을 넣는다        → 생성물이라 다음 빌드에 지워진다
2. 자격을 설정 파일에 값으로 적는다          → 80 §3
3. 「빠르게」 하려고 검사를 끈다              → 대조군이 그것을 잡는다
4. 캐시에 직접 쓴다                          → 유일 writer 규약
5. 원격 걷이를 계획 없이 돌린다              → 남의 운영 기계를 두드린다

6. 아직 없는 것