No description
d20e6d667e
코드 리딩으로는 나오지 않는 결함들이다. 서버를 실제로 띄우고 브라우저로 케이스 화면을 열어서 찾았다. ## 1. 서버가 기동조차 하지 않았다 (납품 치명) COPYRIGHTER_AUTH_TOKEN 없이 실행하면 경고 문구 안의 em dash 가 한국어 Windows 콘솔(cp949)에서 UnicodeEncodeError 를 일으켜, 포트를 바인딩하기도 전에 프로세스가 죽었다. 납품 대상이 정확히 그 환경이다. 기동 진단 문자열을 ASCII 로 바꾸고, stdout/stderr 를 errors="replace" 로 재설정한다. 진단 메시지가 기동을 막을 수 있어서는 안 된다 — 죽는 것은 프로세스가 아니라 표현 불가능한 문자여야 한다. ## 2. 요약이 모델이 본 적 없는 근거를 인용했다 (거버넌스) 프롬프트는 MAX_PROMPT_EVIDENCE 로 잘리는데 source_urls / source_evidence_ids 는 여전히 전체 증거에서 뽑혔다. 실측: 79행짜리 케이스가 12행만 읽은 요약을 만들고 화면에는 "연결 근거 78건" 이 떴다. 정책 검사는 통과했고 숫자는 허구였다. 앞선 커밋의 입력 경계는 이 구멍의 절반만 막았다. 이제 연결 근거는 검증된 claim 이 실제로 인용한 행이고, 인용이 하나도 살아남지 못하면 모델에게 보여준 행으로 폴백한다. verified 도 이제 "요약이 검증됐다" 를 뜻한다 — 이전에는 "케이스에 증거가 있다" 의 재진술이었다. ## 3. 조작 감지 지표가 저장되지 않았다 grounded_claims / dropped_claims 를 evidence.data 에는 넣었으나 _evidence_payload 에 매핑하지 않아 영속화되지 않았다. 모델이 지어내기 시작해도 아무도 볼 수 없는 상태였다. ## 4. 클라이언트가 서버의 그룹 분류를 무시했다 서버가 group=provenance 를 보내는데 app.js 의 evidenceGroupFor 가 자체 매핑으로 internal 로 재분류했다. 배관 목록에 서버 쪽만 넣고 클라이언트 쪽을 빠뜨렸다. 증거 출처 필터 드롭다운에도 항목이 없었다. ## 5. 기본 모델이 두 곳에서 서로 달랐다 OllamaGenerateLlmClient.__init__ 는 qwen2.5:3b-instruct(미설치), env_clients 는 qwen2.5:7b. 런타임 404 가 날 때까지 아무것도 실패하지 않았다. 클라이언트가 값을 소유하고 env_clients 가 재수출하도록 바꿔 드리프트를 구조적으로 막는다. ## 실렌더 확인 결과 - 출처 표기 그룹이 자체 섹션으로 렌더 (제목/건수/설명/칩) - 요약이 [E1, E2, ...] 인용이 붙은 한국어 2단으로 렌더 - sourceIds 78 -> 10, verified=True, grounded=2 dropped=0 - qwen2.5:7b 6.0초, initialRiskScore 21/low vs 실시간 100/high 분기 확인 pytest 534 passed. |
||
|---|---|---|
| docs | ||
| src/rights_filter | ||
| tests | ||
| web/operator-gui | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| package.json | ||
| README.md | ||
| requirements-dev.txt | ||
| requirements.txt | ||
| run_copyrighter_server.py | ||
POSA Copyrighter
이미지 저작권 위험을 자동 분석하고, 운영자가 콘솔에서 근거를 확인해 승인 / 보류 / 반려를 판정하는 폐쇄망(air-gapped) 운영 도구입니다.
- 분석 서버: 제출 이미지를 분석해 위험도·근거를 산출하고 SQLite에 저장
- 운영자 콘솔: 심사 큐, 근거 검토, 판정, 지식 DB, 감사 로그를 제공하는 단일 페이지 웹 GUI
- 외부 근거 검색: Naver 검색, Google Vision/Custom Search, 로컬 LLM(Ollama) 연동(선택)
요구 사항
- Python 3.13
- 런타임 서드파티 의존성은 이미지 처리 라이브러리뿐입니다(지연 로딩):
numpy,opencv-python-headless,pillow
폐쇄망(air-gapped) 원칙: 모든 의존성·자산은 빌드/스테이징 머신에서 미리 받아 오프라인 휠로 설치합니다. 대상 서버는 설치·실행 시 인터넷에 접근하지 않습니다. 자세한 절차는
docs/operations/offline-install.md를 참고하세요.
설치
# 개발 머신 (온라인) — 의존성 설치
pip install -r requirements.txt # 런타임
pip install -r requirements-dev.txt # 테스트 포함
# 폐쇄망 대상 — 오프라인 휠로 설치 (예시)
pip install --no-index --find-links wheelhouse -r requirements.txt
.env.example를 복사해 .env를 만들고 필요한 값(인증 토큰, 검색 API 키 등)을 채웁니다. 키를 비워 두면 해당 외부 검색은 자동으로 비활성화됩니다.
cp .env.example .env
실행
python run_copyrighter_server.py
# 옵션은 런처에 그대로 전달됩니다
python run_copyrighter_server.py --host 127.0.0.1 --port 9500
python -m rights_filter.server로 직접 실행하려면src/가 import 경로에 있어야 합니다 (PYTHONPATH=src, Windows PowerShell 은$env:PYTHONPATH="src"). 런처는 이 경로 설정과 작업 디렉터리 고정을 대신 해 주므로run_copyrighter_server.py사용을 권장합니다.
주요 옵션: --host, --port, --db(SQLite 경로), --images(제출 이미지 폴더), --static(운영자 GUI 경로), --env(.env 경로).
기본값으로 실행하면 http://127.0.0.1:9500 에서 운영자 콘솔이 열립니다.
보안:
COPYRIGHTER_AUTH_TOKEN이 비어 있으면 데이터 라우트가 인증 없이 열립니다. 단일 호스트 개발 환경 외에는 반드시 토큰을 설정하세요.
프로젝트 구조
src/rights_filter/ 분석·서버·통합·도메인 로직 (Python)
server/ http.server 기반 API + 정적 파일 서빙, SQLite 저장소
analysis/ 이미지 분석·위험도 산출
integrations/ Naver / Google / LLM 어댑터
web/operator-gui/ 운영자 콘솔 (정적 SPA: index.html, app.js, styles.css)
tests/ pytest 테스트
operator_gui/ 운영자 GUI 정적 검증 + Playwright E2E
docs/ 기획·설계·운영 문서
테스트
# 전체
python -m pytest
# 운영자 GUI E2E (Playwright)
playwright install chromium # 빌드 머신에서 1회 — 브라우저 바이너리는 오프라인 번들에 포함
python -m pytest tests/operator_gui/
- 브라우저(E2E) 테스트는 Playwright/Chromium이 없으면 자동으로 건너뜁니다(
importorskip+ graceful skip). - 운영자 워크벤치는
tests/operator_gui/pages/의 Page Object(OperatorWorkbench)와conftest.py의 공용 픽스처를 사용합니다.