실제 개인정보 처리 사실을 구조화해, 누락과 모순을 찾고 검토 가능한 개인정보처리방침 초안을 만드는 로컬 우선 워크스페이스입니다.
PolicyWeave는 범용 법률 문구를 임의로 채우는 생성기가 아닙니다. 운영자가 확인한 서비스 사실을 단계별로 입력하면 수집 항목, 처리 목적, 보유 기간, 제3자 제공, 국외 이전과 담당자 정보를 서로 연결하고, 공개 전에 다시 확인해야 할 지점을 보여 줍니다.
PolicyWeave의 출력은 법률 자문, 준법 보장 또는 인증이 아닙니다. 공개 전 개인정보보호책임자 또는 적절한 법률 전문가의 검토가 필요합니다.
| 사용자 | PolicyWeave가 돕는 일 |
|---|---|
| 웹·앱 운영자 | 실제 서비스의 개인정보 처리 흐름을 빠짐없이 정리하고 검토본을 만든다. |
| 개인정보보호 책임자 | 입력 사실, 누락 경고와 검토 필요 항목을 한 흐름에서 확인한다. |
| 제품·개발 팀 | 정책 문구보다 먼저 구조화된 처리 사실과 책임 경계를 합의한다. |
| 통합·유지보수 담당자 | 정책 데이터 모델, 제품 요구사항과 결정 기록을 저장소에서 추적한다. |
현재 소스는 다음 7단계 작성 흐름을 구현합니다.
- 서비스 정보
- 수집 항목
- 처리 목적
- 보유 기간
- 제3자 제공
- 국외 이전
- 개인정보 보호 담당자
선택한 수집 항목에는 수집 경로와 처리 목적을 별도로 기록할 수 있습니다. 필수 사실이 없거나 처리 목적이 비어 있으면 검토본이 이를 숨기지 않고 차단 또는 검토 경고로 드러내며, 경고에서 원인이 있는 입력 단계로 돌아갈 수 있습니다. 작성 내용은 실시간 검토본에 반영되고 모바일·키보드 사용도 고려합니다. 현재 schema-v1 JSON 초안은 로컬로 내보내고, 정확한 검증과 준비 상태 재계산을 통과한 경우에만 다시 열 수 있습니다.
미리보기의 검토 요약 다운로드는 미완료 초안에서도 policyweave-review.txt를 로컬로 내려받기 시작합니다. TXT에는 정규화된 서비스 이름/허용 URL, 제품 정의 준비 상태, 7단계 완료 상태, 순서를 보존한 필수 확인 코드와 권장 항목이 담깁니다. 처리 목적·수집 경로 값, 보유 기간, 제공/이전 수령자·국가, 담당자 연락처와 전체 사실은 담지 않습니다. 서비스 식별정보는 남을 수 있으므로 파일 보관·전달 범위를 직접 확인하세요.
같은 입력은 같은 TXT를 만들며 타임스탬프를 추가하지 않습니다. 검토 요약 형식 v1과 사실 스키마 v1은 발행 버전이나 승인 표시가 아닙니다. TXT는 JSON 초안 복원 파일·공개 정책·법률 자문·저장 완료 증거를 대체하지 않습니다. JSON 확인 중에는 버튼이 잠기며, 실패하면 현재 작성 상태를 유지하고 재시도를 안내합니다. 현재 후보의 전체 검증과 독립 승인 상태는 로컬 증거 기록에서 별도로 구분합니다.
현재 제품은 소스로 평가하는 초기 개발 버전입니다. 패키지 메타데이터 0.1.0은 게시된 릴리스를 뜻하지 않습니다. 아직 GitHub 릴리스가 없으므로 검토 중인 소스와 배포 가능한 제품을 구분해 사용하세요.
아래 명령은 package.json과 package-lock.json이 함께 있는 구현 작업 트리의 루트에서 실행합니다. 두 파일이 없는 문서 전용 체크아웃에서는 실행할 수 없습니다. CI는 Node.js 22 환경에서 설치·검증하며, 이 안내는 전역 npm 패키지 설치나 호스팅 서비스 이용 절차가 아닙니다.
npm ci
npm run dev터미널에 표시되는 127.0.0.1 주소를 같은 기기의 브라우저에서 여세요. 개발 서버는 기본적으로 이 기기의 IPv4 루프백에서만 수신합니다. 종료할 때는 터미널에서 Ctrl+C를 누르세요. 이 설정은 LAN 공개나 운영 배포를 위한 인증·TLS·접근 제어를 제공하지 않습니다.
빌드 결과를 로컬에서 살펴보려면 다음을 실행합니다. 미리보기 역시 루프백에서만 수신하며 운영 서버를 대신하지 않습니다.
npm run build
npm run preview검증:
npm run lint
npm test
npm run build
npx playwright install chromium
npm run test:e2enpm ci는 체크인된 package-lock.json을 사용합니다. 이 저장소는 private: true 패키지이므로 npm 배포물을 제품 릴리스로 간주하지 않습니다.
PolicyWeave가 책임지는 것은 운영자가 입력한 개인정보 처리 사실의 구조화, 검토 지원, 결정적인 검토본 생성입니다.
PolicyWeave는 다음을 권위 있게 판단하지 않습니다.
- 실제 서비스가 어떤 SDK·쿠키·데이터를 사용하는지 자동 추측
- 특정 처리의 법적 적법성에 대한 최종 판단
- 동의가 필요한지 여부를 모든 상황에 동일하게 결정
- 법률 자문, 규제기관 판단, 인증 또는 감사 의견 대체
- 아직 구현되지 않은 정적 공개 URL·호스팅 백엔드를 현재 기능처럼 표시
향후 공개·버전 이력·영속화가 추가되더라도, 사람이 확인한 처리 사실과 책임자 검토가 자동 생성 문구보다 우선합니다.
운영자가 확인한 처리 사실
│
▼
7단계 구조화 편집
│
├── 필수 사실/관계 검증
├── 차단 오류와 검토 경고
└── 원인 단계로 이동
│
▼
실시간 개인정보처리방침 검토본
│
▼
책임자·법률 검토 후 별도 공개 결정
현재 브라우저 애플리케이션은 작성과 검토 경험에 집중합니다. PRD에 기록된 정적 공개 URL, 버전 영속화와 배포 계약은 후속 제품 작업이며 현재 구현으로 과장하지 않습니다.
PolicyWeave는 개인정보처리방침을 만들기 위해 불필요한 실제 개인정보를 수집하도록 설계하지 않습니다. 정책 작성에는 서비스의 처리 범주와 운영 사실을 입력하고, 사람·고객의 실제 민감 값을 데모나 문서에 복사하지 않는 것이 기본 원칙입니다.
보안 및 신뢰 경계는 보안 및 개인정보 기준와 기술 문서에서 관리합니다. 새 저장·호스팅·외부 연동 기능은 별도의 인증·권한·감사·tenant 경계를 갖추기 전까지 현재 기능으로 취급하지 않습니다.
- 제품 요구사항 — 사용자 문제, MVP, 비목표와 성공 기준
- 기술 요구사항 — 구현 및 품질 계약
- 아키텍처 — 제품 책임과 기술 경계
- ADR-0001: Policy as Data — 핵심 설계 결정
- ADR-0005: 로컬 schema-v1 초안 복원 — 신뢰하지 않는 로컬 파일의 fail-closed 복원 결정
- ADR-0006: 로컬 최소 TXT 검토 요약 — 출력 최소화와 다운로드 실패 경계
- 제품·기술 Gap baseline — 아직 닫히지 않은 상용화 Gap과 완료 증거
- 공개 문서 홈 — 저장소 문서 탐색 시작점
- 변경 이력
동작을 바꾸는 변경은 해당 사용자 흐름의 회귀 테스트와 문서 계약을 함께 갱신해야 합니다. 작업 전 AGENTS.md와 CLAUDE.md를 읽고, 최소한 다음 검증이 동일한 head에서 통과하는지 확인합니다.
npm run lint
npm test
npm run buildnpm test는 의존성 없는 로컬 시작·보안 링크 검사 후 기존 Vitest를 실행합니다. 해당 검사만 실행하려면 node --test tests/local_preview_contract.mjs를 사용하세요. 설정 검사는 실제 서버 수신, 브라우저 E2E 또는 전체 보안 검증을 대신하지 않습니다. 변경 이유와 증거 범위는 로컬 미리보기 수리 기록에 있습니다.
통과한 로컬 명령이나 PR branch 자체는 배포·인증·규제 준수 또는 게시 릴리스의 증거가 아닙니다.
PolicyWeave의 ContextualWisdomLab 원저작 소스와 문서는 MIT License로 제공됩니다. npm 의존성, 표준 문서, 외부 서비스·자산은 각각의 라이선스와 이용 조건을 유지하며 이 저장소의 MIT grant가 이를 재라이선스하지 않습니다. 상업적 사용과 배포에 적합하지 않은 inbound 소프트웨어·자산은 제품 의존성으로 반입하지 않습니다.