[
{
"id": "PW-001",
"category": "CLI",
"title": "현재 폴더에서 공유 시작",
"description": "Windows 터미널에서 tunnels serve 또는 tunnels serve <경로>로 폴더 하나를 선택하고 접속 URL, 권한, 만료 시각을 표시한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [],
"acceptance": "공백·한글이 있는 로컬 폴더에서 실행해 선택한 루트가 표시되고, 존재하지 않는 경로는 URL 발급 전에 실패한다.",
"verification": "T-PW-001",
"origin": "user",
"component": "agent / Windows CLI"
},
{
"id": "PW-002",
"category": "CLI",
"title": "서버 선택과 장치 자격증명",
"description": "Linux N3M Tunnels 제어 주소 tunnels.n3m.kr과 장치 등록 정보를 설정한다. 관리 진입점은 console.n3m.kr로 통합하며 agent credential은 콘솔 세션과 구분한다. Windows Credential Manager 또는 사용자 범위 DPAPI로 장치 비밀을 보관한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-001"
],
"acceptance": "재실행 시 등록을 재사용하고 로그·설정 출력에 비밀이 나타나지 않으며 폐기한 장치는 재접속하지 못한다.",
"verification": "T-PW-002",
"origin": "proposal",
"component": "agent / Windows CLI"
},
{
"id": "PW-003",
"category": "CLI",
"title": "Windows 배포 실행파일",
"description": "사용자가 별도 개발 도구 없이 실행할 수 있는 Windows x64 패키지, 체크섬, 버전 정보, 설치·제거 안내를 제공한다. 서명 방식은 배포 전 결정한다. 수동 버전 교체 시 배포 서명·버전·hash를 확인하고 실패 시 이전 정상 버전으로 복원한다. 자동 업데이트는 별도 후속 결정이다.",
"phase": "M3",
"priority": "P0",
"dependsOn": [
"PW-036"
],
"acceptance": "깨끗한 Windows 시험 환경에서 다운로드한 배포파일의 체크섬을 확인하고 설치·실행·종료·제거 절차가 성공한다. 변조/서명 오류 패키지를 거부하고 수동 교체 실패 후 기존 정상 버전과 설정을 복구한다.",
"verification": "T-PW-003",
"risk": "코드 서명 방식과 Windows 배포 검증은 미완료다. 서비스 도메인은 tunnels.n3m.kr, 통합 관리 도메인은 console.n3m.kr로 확정됐다.",
"origin": "user",
"component": "agent / Windows CLI"
},
{
"id": "PW-004",
"category": "CLI",
"title": "상태 조회와 종료",
"description": "실행 중 URL·연결 상태·전송 상태를 확인하고 Ctrl+C 또는 stop 명령으로 공유를 종료한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-006",
"PW-029"
],
"acceptance": "종료 뒤 새 목록·전송 요청이 거절되고 기존 전송이 명세한 취소 결과로 종료되며 종료 코드는 문서와 일치한다.",
"verification": "T-PW-004",
"origin": "user",
"component": "agent / Windows CLI"
},
{
"id": "PW-005",
"category": "CLI",
"title": "복수 폴더의 독립 공유",
"description": "여러 터미널에서 별개 폴더를 독립 터널로 공유하고 각 권한·URL·종료 범위를 분리한다.",
"phase": "M2",
"priority": "P1",
"dependsOn": [
"PW-004",
"PW-007"
],
"acceptance": "동일 Windows 사용자로 두 폴더를 공유한 뒤 하나를 종료해도 다른 공유는 계속 동작하며 상대 루트에 접근할 수 없다.",
"verification": "T-PW-005",
"origin": "proposal",
"component": "agent / Windows CLI"
},
{
"id": "PW-006",
"category": "터널",
"title": "아웃바운드 역방향 연결",
"description": "Windows 에이전트가 Linux relay의 TLS 443으로 먼저 연결한다. 사용자는 공유기 포트 개방 없이 다른 네트워크의 브라우저에서 접속한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-002",
"PW-009",
"PW-025"
],
"acceptance": "공유기 포트 전달과 Windows 수신 포트 개방 없이 서로 다른 네트워크의 브라우저에서 인증 후 파일 목록·다운로드가 성공한다.",
"verification": "T-PW-006",
"risk": "기업 프록시·TLS 검사 환경 지원은 별도 호환성 시험 결과로 확정한다.",
"origin": "user",
"component": "server Control·Relay + agent"
},
{
"id": "PW-007",
"category": "터널",
"title": "임의 주소 발급",
"description": "공유 시작 요청에 서버가 난수 이름을 만들고 이름 DB의 고유 제약으로 충돌 없이 배정한다. 소유자·기기·터널 generation·만료에 결속하고 agent 준비와 활성 경로 확인 후 URL을 표시한다. 실행 시도별 중복 방지 키로 재시도를 처리한다. 폐기 이름의 영속 기록과 일반 로그 보존기간을 분리하고 타인에게 재배정하지 않는 정책을 정의한다. 멱등 결과는 공유 수명과 재시도 유예 동안 유지하며 만료 키의 요약 기록으로 늦은 재시도를 새 할당 대신 명시 오류로 처리한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-006"
],
"acceptance": "동시 요청·강제 난수 충돌·응답 유실 재시도에서 이름 중복이나 중복 터널이 없다. READY 실패/timeout을 준비 완료로 표시하지 않는다. 새 실행은 새 임의 URL을 받으며 과거 이름은 난수/예약 API 양쪽과 DB 복원 후에도 재배정되지 않는다. URL을 아는 것만으로 파일을 읽을 수 없다. 멱등 결과 보존 경계와 만료 키 재시도에서 새 활성 공유가 생기지 않는다.",
"verification": "T-PW-007",
"origin": "user",
"component": "server Control·Relay + agent"
},
{
"id": "PW-008",
"category": "터널",
"title": "사용자 지정 하위 주소",
"description": "소유자가 지정한 이름을 예약해 같은 URL로 재공유한다. 예약과 온라인 상태를 분리하고 예약 충돌·금지 이름·재사용 정책을 정의한다. 예약 소유권과 활성 공유 수명을 분리한다. 완전히 종료 후 같은 이름을 새 공유에 쓰면 새 generation·방문자 권한을 발급하며 폐기된 임의 이름은 예약할 수 없다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-007",
"PW-025"
],
"acceptance": "두 계정의 같은 이름 동시 예약 중 하나만 성공하고 타인이 소유한 주소를 가져올 수 없으며 재연결이 기존 소유권을 유지한다. 종료 후 재공유에서 과거 세션/전송 권한을 거부하고 폐기된 임의 주소의 이름 예약도 거부한다.",
"verification": "T-PW-008",
"risk": "tunnels.n3m.kr 도메인은 확정됐다. 지정 이름 기능의 실제 공개 사용은 DNS/TLS 운영 적용과 예약 소유권 시험 후 검증한다.",
"origin": "user",
"component": "server Control·Relay + agent"
},
{
"id": "PW-009",
"category": "터널",
"title": "DNS·TLS와 호스트 라우팅",
"description": "console.n3m.kr은 중앙 관리, tunnels.n3m.kr은 agent 제어, *.tunnels.n3m.kr은 공유별 주소로 구성하고 remote.n3m.kr 기존 서비스를 유지한다. 운영자가 wildcard DNS와 한 단계 공유 이름 및 apex용 TLS 인증서 범위를 준비한다. 공유마다 DNS/인증서를 발급하지 않으며 DNS는 공개 게이트웨이, 검증된 Host/:authority 경로표는 실제 터널을 선택한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [],
"acceptance": "정상 공유 이름은 유효한 HTTPS로 열리고 임의 Host·미등록 이름·잘못된 인증서를 사용하는 연결은 거절된다. 서로 다른 새 이름을 DNS 변경 없이 공개 진입점에서 해석하고 올바른 터널로 전달한다. 등록되지 않은 이름·임의 전달 헤더·다단계 이름/TLS 불일치·별도 DNS 레코드 우선순위를 시험하고 다른 터널로 fallback하지 않는다.",
"verification": "T-PW-009",
"origin": "proposal",
"component": "server Control·Relay + agent"
},
{
"id": "PW-010",
"category": "터널",
"title": "임대·재연결·오프라인 상태",
"description": "공유 최대 expires_at과 짧은 heartbeat/연결 lease, DNS 캐시 TTL을 구분한다. 통신 단절은 RECONNECTING으로 접근을 차단하고 만료 전 재인증한 같은 논리 터널은 URL·generation을 유지한다. 재연결마다 connection epoch를 증가시켜 이전 연결을 배제한다. 명시 종료·철회·공유 만료는 자동 복구하지 않는다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-006",
"PW-007"
],
"acceptance": "네트워크/제어 연결 단절과 lease 만료 시 오프라인·재연결을 표시한다. 동일 공유의 유효한 복구는 같은 URL을 쓰고 활성 연결은 하나다. 서버 재시작 뒤 인증 전 온라인 복원과 명시 종료/만료 후 재접속을 거부한다. DNS 캐시가 남아도 폐기 터널 접근은 불가하다.",
"verification": "T-PW-010",
"origin": "proposal",
"component": "server Control·Relay + agent"
},
{
"id": "PW-011",
"category": "터널",
"title": "버전이 있는 제어·전송 계약",
"description": "WSS 제어 메시지와 전송별 데이터 연결을 분리하는 초안을 검증한다. 요청 ID·기한·크기 제한·취소·오류 코드·일회용 전송 권한을 명시한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-006"
],
"acceptance": "지원하지 않는 버전·중복 전송 권한·초과 크기 메시지가 거절되고 대용량 전송 중 상태 조회와 종료 명령이 정해진 시간 안에 처리된다.",
"verification": "T-PW-011",
"risk": "WebSocket의 기본 기능을 독립 스트림 다중화로 오인하지 않는다. 전송별 연결 방식은 M1 실험 후 확정한다.",
"origin": "proposal",
"component": "server Control·Relay + agent"
},
{
"id": "PW-012",
"category": "파일",
"title": "폴더 목록과 파일 메타데이터",
"description": "공유 루트 아래 폴더 탐색, 이름·유형·크기·수정 시각, 정렬 및 대규모 목록 페이지 처리를 지원한다. 현재 폴더 전체의 이름 필터를 지원하며 현재 화면 페이지만 검색하지 않는다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-011",
"PW-013"
],
"acceptance": "한글·공백·빈 폴더·많은 파일이 있는 시험 폴더를 탐색하고 페이지 이동에서 문서화한 일관성 정책에 맞는 결과를 얻는다. 여러 페이지에 흩어진 이름 일치 항목이 검색되고 하위 폴더까지 재귀 검색하는 것으로 오인되지 않는다.",
"verification": "T-PW-012",
"origin": "user",
"component": "fs-windows + protocol + web"
},
{
"id": "PW-013",
"category": "보안",
"title": "Windows 공유 루트 경계",
"description": "경로 탈출·절대/UNC 경로·대체 데이터 스트림·예약 이름을 차단하고 junction·symlink·reparse point는 기본 거부한다. 문자열 검사만으로 안전 판정을 끝내지 않는다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [],
"acceptance": "인코딩된 상위 경로·ADS·장치 이름·junction·검사 직후 경로 교체 시험에서 루트 밖 파일의 조회·읽기·쓰기·생성이 모두 실패한다.",
"verification": "T-PW-013",
"risk": "Windows 핸들 기반 경로 검증과 TOCTOU 방어는 별도 설계·공격 시험의 출시 차단 항목이다.",
"origin": "proposal",
"component": "agent + server + fs-windows + web"
},
{
"id": "PW-014",
"category": "파일",
"title": "단일 파일 스트리밍 다운로드",
"description": "파일 전체를 메모리에 올리지 않고 브라우저까지 전송한다. 파일명·길이·Content-Disposition을 안전하게 처리하고 로컬 원본 변화를 감지한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-012",
"PW-025",
"PW-034"
],
"acceptance": "0바이트·한글 이름·4GiB 이상 파일을 내려받아 원본 해시와 비교하고 전송 도중 원본 변경 시 조용히 손상된 성공 결과를 반환하지 않는다.",
"verification": "T-PW-014",
"origin": "user",
"component": "fs-windows + protocol + web"
},
{
"id": "PW-015",
"category": "파일",
"title": "다운로드 재개와 조건부 읽기",
"description": "HTTP Range·If-Range 또는 동등한 버전 검증으로 중단된 다운로드를 안전하게 재개한다. 파일 변화 시 기존 조각을 혼합하지 않는다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-014"
],
"acceptance": "연결을 끊은 뒤 같은 버전 파일은 나머지 바이트로 재개하고 변경된 버전은 재개 거절 또는 처음부터 재다운로드하여 최종 해시가 일치한다.",
"verification": "T-PW-015",
"origin": "proposal",
"component": "fs-windows + protocol + web"
},
{
"id": "PW-016",
"category": "파일",
"title": "브라우저 파일 업로드",
"description": "쓰기 권한 사용자가 브라우저에서 선택하거나 끌어놓은 파일을 Windows 공유 루트 안에 업로드한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-013",
"PW-018",
"PW-026",
"PW-027",
"PW-028"
],
"acceptance": "한글 이름·0바이트·큰 파일을 업로드해 Windows에서 원본 해시를 확인하고 읽기 전용 사용자의 업로드는 쓰기 전에 거절한다.",
"verification": "T-PW-016",
"origin": "user",
"component": "fs-windows + protocol + web"
},
{
"id": "PW-017",
"category": "파일",
"title": "업로드 재개·취소·임시파일 정리",
"description": "분할 전송 ID·오프셋·조각 검증과 만료를 정의하고 재접속 후 계속 업로드한다. 임시파일은 에이전트 로컬에만 둔다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-016"
],
"acceptance": "전송 중 브라우저·망·에이전트 재시작 시험에서 합의한 재개 범위를 충족하고 중복 조각이 중복 저장되지 않으며 만료·취소 파일이 정리된다.",
"verification": "T-PW-017",
"origin": "proposal",
"component": "fs-windows + protocol + web"
},
{
"id": "PW-018",
"category": "파일",
"title": "충돌과 원자적 업로드 완료",
"description": "기존 이름은 기본 거절하고 명시한 정책에서만 덮어쓰기 또는 이름 변경을 허용한다. 임시파일 검증 후 같은 볼륨의 최종 이름으로 완료한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-013",
"PW-011"
],
"acceptance": "동일 이름 동시 업로드·로컬 수정·디스크 부족·프로세스 종료 시 기존 정상 파일이 보존되고 미완료 파일이 완료 목록에 노출되지 않는다.",
"verification": "T-PW-018",
"origin": "proposal",
"component": "fs-windows + protocol + web"
},
{
"id": "PW-019",
"category": "파일",
"title": "폴더 생성",
"description": "쓰기 권한 사용자가 웹에서 새 하위 폴더를 만들 수 있게 한다. Windows 이름 규칙과 기존 항목 충돌을 처리한다.",
"phase": "M2",
"priority": "P1",
"dependsOn": [
"PW-016"
],
"acceptance": "허용된 이름으로 폴더를 만든 뒤 Windows에서 확인하고 중복 이름·예약 이름·권한 없는 생성은 명확한 오류를 반환한다.",
"verification": "T-PW-019",
"origin": "proposal",
"component": "fs-windows + protocol + web"
},
{
"id": "PW-020",
"category": "파일",
"title": "이름 변경·이동·삭제 확장",
"description": "클라우드 드라이브에 가까운 파일 관리 범위를 후속 확장한다. 파괴적 작업 권한·확인·로컬 변경 충돌·삭제 복구 정책을 먼저 결정한다.",
"phase": "M3",
"priority": "P1",
"dependsOn": [
"PW-018",
"PW-026",
"PW-031"
],
"acceptance": "각 작업의 권한·동시 수정·대상 소실·실패 복구 시험을 통과하고 문서화된 삭제 정책과 실제 동작이 일치한다.",
"verification": "T-PW-020",
"risk": "휴지통 지원 여부와 복구 보장 범위는 미정이며 MVP의 업로드·다운로드와 구분한다.",
"origin": "proposal",
"component": "fs-windows + protocol + web"
},
{
"id": "PW-021",
"category": "웹",
"title": "웹 파일 탐색 화면",
"description": "데스크톱 브라우저에서 로그인, breadcrumb 폴더 이동, 목록 정렬, 다운로드 및 권한·만료 표시를 제공한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-012",
"PW-014"
],
"acceptance": "대상 Windows 브라우저에서 키보드만으로 로그인·하위 폴더 이동·파일 다운로드가 가능하고 긴 이름이 작업 버튼을 가리지 않는다.",
"verification": "T-PW-021",
"origin": "user",
"component": "web + 파일 API"
},
{
"id": "PW-022",
"category": "웹",
"title": "전송 큐와 진행 표시",
"description": "복수 파일 업로드 선택, 파일별 진행·속도·상태, 취소·재시도와 이름 충돌 안내를 제공한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-016",
"PW-017",
"PW-021"
],
"acceptance": "성공·실패가 섞인 복수 전송에서 각 상태를 구별할 수 있고 실패 파일만 재시도하며 취소한 전송의 진행 표시가 완료로 바뀌지 않는다.",
"verification": "T-PW-022",
"origin": "user",
"component": "web + 파일 API"
},
{
"id": "PW-023",
"category": "웹",
"title": "오프라인·만료·권한 오류 안내",
"description": "호스트 꺼짐, 재연결 중, 링크 만료, 접근 거절, 저장공간 부족과 예상하지 못한 실패를 구별해 안내한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-010",
"PW-021",
"PW-028"
],
"acceptance": "각 실패 상태를 주입했을 때 원인에 맞는 안내와 가능한 다음 행동이 표시되고 로컬 절대 경로나 비밀이 오류에 노출되지 않는다.",
"verification": "T-PW-023",
"origin": "proposal",
"component": "web + 파일 API"
},
{
"id": "PW-024",
"category": "웹",
"title": "폴더·복수 항목 다운로드 확장",
"description": "폴더 또는 여러 파일을 선택한 다운로드와 묶음 생성 방식을 후속 제공한다. 압축 계산 위치와 중단·재개 범위는 먼저 검증한다.",
"phase": "M3",
"priority": "P2",
"dependsOn": [
"PW-015",
"PW-028"
],
"acceptance": "중첩 폴더 묶음의 상대 경로·파일 해시가 일치하고 대규모 묶음에서 제한된 메모리·취소·파일 변경 정책이 지켜진다.",
"verification": "T-PW-024",
"risk": "묶음 다운로드 재개는 일반 단일 파일 Range 지원과 동일하게 보장되지 않는다.",
"origin": "proposal",
"component": "web + 파일 API"
},
{
"id": "PW-025",
"category": "보안",
"title": "소유자·장치·방문자 인증 분리",
"description": "터널 소유자, 등록 장치, 파일 방문자의 자격과 권한을 분리한다. 기본 공유는 인증 필요 상태이며 URL만으로 접근권을 부여하지 않는다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-009"
],
"acceptance": "미인증·다른 소유자·폐기 장치가 파일 또는 관리 API를 사용할 수 없고 권한 없는 요청은 원본 접근 전에 거절된다.",
"verification": "T-PW-025",
"origin": "proposal",
"component": "agent + server + fs-windows + web"
},
{
"id": "PW-026",
"category": "보안",
"title": "읽기·쓰기 권한과 공유 만료",
"description": "읽기 전용·업로드 허용을 구분하고 만료되는 방문자 초대 권한을 제공한다. 서버 권한은 에이전트에서 허용한 최대 권한을 넘지 못한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-025",
"PW-029"
],
"acceptance": "읽기 전용 초대로 업로드·변경 API 호출이 실패하고 만료 후 새 요청과 재개 요청이 거절되며 에이전트의 읽기 전용 제한을 서버 설정으로 확대할 수 없다.",
"verification": "T-PW-026",
"origin": "proposal",
"component": "agent + server + fs-windows + web"
},
{
"id": "PW-027",
"category": "보안",
"title": "웹 세션·업로드 콘텐츠 격리",
"description": "호스트 한정 Secure·HttpOnly 쿠키, CSRF 방어, Origin 검증, CSP, 파일명 이스케이프를 적용한다. 임의 업로드 파일은 애플리케이션 origin에서 실행하지 않는다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-021",
"PW-025"
],
"acceptance": "외부 origin의 상태변경 요청·세션을 이용한 WebSocket 연결이 거절되고 HTML·SVG·스크립트 이름의 파일로 다른 사용자의 세션에서 코드가 실행되지 않는다.",
"verification": "T-PW-027",
"origin": "proposal",
"component": "agent + server + fs-windows + web"
},
{
"id": "PW-028",
"category": "보안",
"title": "크기·동시성·속도·저장공간 제한",
"description": "계정·터널·전송별 동시성, 파일 크기, 속도, 대기열, 임시 저장량과 디스크 여유 한도를 제한하고 역압력을 적용한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-011",
"PW-034"
],
"acceptance": "느린 소비자·동시 업로드·초과 크기·디스크 부족 시험에서 정해진 자원 한도를 넘지 않고 서버와 다른 공유의 기본 요청이 계속 처리된다.",
"verification": "T-PW-028",
"risk": "성능 수치는 M1 계측 후 시험 환경과 함께 확정한다.",
"origin": "proposal",
"component": "agent + server + fs-windows + web"
},
{
"id": "PW-029",
"category": "보안",
"title": "공유·세션·장치 즉시 철회",
"description": "소유자 또는 관리자가 공유·초대·장치 접근을 철회하면 새 작업과 진행 중인 전송 권한을 종료한다. 이미 받은 사본은 회수할 수 없음을 표시한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-025",
"PW-011"
],
"acceptance": "철회 후 새 요청·재개·재연결이 거절되고 진행 중인 전송이 문서화한 철회 지연 한도 안에 취소된다.",
"verification": "T-PW-029",
"origin": "proposal",
"component": "agent + server + fs-windows + web"
},
{
"id": "PW-030",
"category": "관리",
"title": "서버 전체 터널의 중앙 관리 화면",
"description": "console.n3m.kr의 n3m-console에서 서버 관리자가 모든 계정의 열린 N3M Tunnels 터널과 종료 이력을 한 화면에서 조회·관리한다. notparsec 관리 진입점을 함께 제공하되 remote.n3m.kr 기존 서비스를 유지한다. 일반 소유자는 자기 장치·터널·주소·정책만 관리한다. 전체/소유자/호스트/상태/주소 검색과 상세 화면을 제공한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-008",
"PW-010",
"PW-026",
"PW-029",
"PW-032"
],
"acceptance": "서로 다른 두 소유자의 터널을 관리자는 모두 조회·중지할 수 있고 일반 소유자는 상대 터널의 목록·상세·로그·내보내기·제어에 접근할 수 없다. 터널 상세에서 세션·전송·로그·정책·변경 이력으로 이동한다.",
"verification": "T-PW-030",
"origin": "user",
"component": "n3m-console + N3M Tunnels Control management API"
},
{
"id": "PW-031",
"category": "관리",
"title": "접근·전송·관리 감사 기록과 보존",
"description": "요청·논리 파일전송·agent 연결·관리 변경을 별도 이벤트 종류로 기록하고 ID로 연결한다. 허용·거절·실패·취소를 모두 남기며 토큰·쿠키·비밀번호·파일 본문·절대경로는 제외한다. 세부 로그·집계·감사의 보존 기간과 용량 한도를 운영자가 정한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-025",
"PW-029"
],
"acceptance": "인증 실패·전송 중단·재개·관리자 변경을 event/request/transfer/action ID로 연결한다. 비밀·본문 누출이 없고 보존 만료 기록이 정책대로 삭제된다. 로그 조회/내보내기·보존 설정 변경도 감사하며 일반 역할은 감사 원문을 임의 수정·삭제할 수 없다.",
"verification": "T-PW-031",
"origin": "user",
"component": "server Control + web 관리"
},
{
"id": "PW-032",
"category": "관리",
"title": "관리자·소유자·조회 역할과 운영 한도",
"description": "관리자 최초 생성·권한 부여/회수 절차와 서버 전체 관리 권한을 정의한다. 일반 소유자와 조회 전용 운영자의 범위를 구분하고 로그 열람/내보내기·정책 변경 권한을 분리한다. 계정·기기·예약 수·전송·대역폭 상한을 관리한다. 관리 권한 자체가 파일 본문 열람권한을 자동 부여하지 않는다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-025",
"PW-027",
"PW-028"
],
"acceptance": "미인증/파일 공유 세션의 관리 호출과 일반 사용자의 서버 전체·관리자 전용 권한 호출을 거부한다. 소유자는 자기 터널의 허용된 관리 동작을 사용할 수 있다. 관리자 최초 등록과 회수 뒤 기존 세션·실시간 구독·내보내기 권한이 폐기된다. 조회 전용 역할은 제어를 못 하고 동시 요청도 계정 상한을 넘지 않는다.",
"verification": "T-PW-032",
"origin": "user",
"component": "server Control + web 관리"
},
{
"id": "PW-033",
"category": "운영",
"title": "Linux 설치·재시작·업그레이드·복구",
"description": "서비스 시작·종료, 설정 검증, DB 이관·백업·복구, TLS 갱신, 버전 호환성과 되돌리기 절차를 제공한다.",
"phase": "M3",
"priority": "P0",
"dependsOn": [
"PW-011",
"PW-030"
],
"acceptance": "깨끗한 Linux 환경 설치와 재부팅 후 정상 시작을 확인하고 백업 복구·실패한 업그레이드 복구에서 소유권·예약·철회 상태가 유지된다.",
"verification": "T-PW-033",
"origin": "user",
"component": "deploy + server + 배포 검증"
},
{
"id": "PW-034",
"category": "운영",
"title": "파일 무보관 중계와 데이터 경계",
"description": "중앙 서버는 계정·장치·예약·정책 등 메타데이터를 저장하고 파일은 제한된 버퍼로만 중계한다. 프록시 임시파일·본문 로그도 점검한다. 초기 구조는 TLS 구간 암호화이며 종단간 암호화를 주장하지 않는다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-011"
],
"acceptance": "대용량 업로드·다운로드 및 실패 후 서버·프록시 디스크에 파일 본문이 남지 않고 메모리가 문서화한 한도 안에 유지되는지 계측한다.",
"verification": "T-PW-034",
"risk": "서버 운영자는 TLS 종단에서 파일 내용을 볼 수 있다. 별도 E2EE 요구가 생기면 브라우저·드라이브 호환성을 재설계해야 한다.",
"origin": "proposal",
"component": "deploy + server + 배포 검증"
},
{
"id": "PW-035",
"category": "운영",
"title": "건강 상태·계측·부하 시험",
"description": "활성 터널, 전송량·실패율·지연, 메모리·파일 핸들·디스크 여유, 인증서 만료를 관측하고 용량 한계를 기록한다.",
"phase": "M3",
"priority": "P0",
"dependsOn": [
"PW-028",
"PW-031",
"PW-033"
],
"acceptance": "정상·포화·relay 재시작·호스트 단절 상황을 계측으로 구별하고 재현 가능한 부하 보고서에 환경·동시 수·처리량·자원 최고값을 남긴다.",
"verification": "T-PW-035",
"origin": "proposal",
"component": "deploy + server + 배포 검증"
},
{
"id": "PW-036",
"category": "운영",
"title": "Windows·브라우저·망 경계 회귀 시험",
"description": "Windows 실제 파일시스템, 대상 브라우저, 서로 다른 네트워크에서 핵심 경로와 공격·실패 사례를 지속 검증하고 요구 ID에 증거를 연결한다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-013",
"PW-014",
"PW-027",
"PW-029"
],
"acceptance": "출시 대상 요구마다 시험 결과·버전·환경·증거 파일을 연결하고 Windows 실기 검증이 없는 기능은 검증 완료로 집계하지 않는다.",
"verification": "T-PW-036",
"origin": "proposal",
"component": "deploy + server + 배포 검증"
},
{
"id": "PW-037",
"category": "운영",
"title": "호스트 절전·잠금·로컬 접근 오류",
"description": "Windows 잠금·절전·재개·로그아웃·공유 폴더 삭제·파일 잠금·ACL 거절을 처리한다. 호스트가 꺼지면 파일을 사용할 수 없다는 모델을 안내한다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-010",
"PW-017",
"PW-023"
],
"acceptance": "절전·재개와 파일 독점 잠금·ACL 거절을 주입해 손상 없이 실패·재연결하고 꺼진 호스트를 온라인 또는 파일 누락으로 잘못 표시하지 않는다.",
"verification": "T-PW-037",
"origin": "proposal",
"component": "deploy + server + 배포 검증"
},
{
"id": "PW-038",
"category": "드라이브",
"title": "Windows 네트워크 드라이브 실현성 조사",
"description": "웹 MVP 이후 WebDAV/WebClient와 전용 Windows 파일시스템 클라이언트를 비교한다. 서비스 지원·파일 크기·인증·Office 잠금·캐시·재연결을 실기로 검증한다.",
"phase": "M4",
"priority": "P0",
"dependsOn": [
"PW-017",
"PW-033",
"PW-037"
],
"acceptance": "지원할 Windows 버전별 매핑·큰 파일·재연결·인증·Office 편집 결과를 표로 남기고 채택 방식과 제약을 근거로 결정한다.",
"verification": "T-PW-038",
"risk": "WebDAV는 호환성 가설이며 Windows 기본 네트워크 드라이브 연결이 아직 입증되지 않았다.",
"origin": "user",
"component": "후속 drive adapter + fs-windows"
},
{
"id": "PW-039",
"category": "드라이브",
"title": "탐색기 드라이브 연결",
"description": "선정한 방식으로 다른 네트워크 Windows 클라이언트가 공유를 탐색기 드라이브로 연결·해제하고 읽기·쓰기를 수행한다.",
"phase": "M4",
"priority": "P0",
"dependsOn": [
"PW-038",
"PW-026",
"PW-029"
],
"acceptance": "지원 환경에서 드라이브 문자 연결·목록·다운로드·업로드·연결 해제가 성공하고 읽기 전용·만료·철회가 웹과 같은 정책으로 적용된다.",
"verification": "T-PW-039",
"origin": "user",
"component": "후속 drive adapter + fs-windows"
},
{
"id": "PW-040",
"category": "드라이브",
"title": "드라이브 잠금·충돌·오프라인 의미",
"description": "Windows 파일 잠금·임시 저장·이름 변경·캐시 무효화와 재연결 정책을 정의한다. 웹과 드라이브 동시 수정의 충돌을 처리한다.",
"phase": "M4",
"priority": "P0",
"dependsOn": [
"PW-039",
"PW-020"
],
"acceptance": "웹·탐색기·로컬 앱 동시 수정과 Office 저장 시험에서 조용한 덮어쓰기·부분 파일 성공이 없고 오프라인 동작이 문서와 일치한다.",
"verification": "T-PW-040",
"risk": "일반 로컬 디스크와 동일한 POSIX/Win32 의미를 자동으로 보장하지 않는다.",
"origin": "proposal",
"component": "후속 drive adapter + fs-windows"
},
{
"id": "PW-041",
"category": "통합",
"title": "통합 콘솔과 서비스 경계 계약",
"description": "console.n3m.kr의 별도 n3m-console 프로젝트에 notparsec와 N3M Tunnels의 중앙 관리를 통합한다. remote.n3m.kr 기존 서비스는 유지하고 N3M Tunnels는 tunnels.n3m.kr 및 *.tunnels.n3m.kr로 제어·공유를 제공한다. 관리 API는 서비스별 인증·권한·오류·버전 계약으로 연결하며 파일 중계·DB·agent 비밀은 N3M Tunnels 경계에 둔다.",
"phase": "M1",
"priority": "P0",
"dependsOn": [
"PW-009",
"PW-025"
],
"acceptance": "로컬 계약 시험에서 console→N3M Tunnels 관리 호출의 인증과 권한을 검사하고 외부 위조 identity 헤더를 거부한다. 콘솔 장애가 기존 remote endpoint 설정이나 N3M Tunnels의 파일 경로를 변경하지 않는다. 운영 전환 전후 remote 기존 접속·다운로드·문서 동작과 새 console/tunnels HTTPS를 각각 확인한다.",
"verification": "T-PW-041",
"risk": "통합은 사용자 확정 요구다. 현재 DNS 등록·TLS·시스템 서비스 설치가 남아 있어 로컬 계약 검증과 운영 적용을 분리한다.",
"origin": "user",
"component": "n3m-console service adapter + N3M Tunnels Control + notparsec management boundary"
},
{
"id": "PW-042",
"category": "통합",
"title": "console.n3m.kr 관리 인증·화면 통합",
"description": "console.n3m.kr에서 중앙 관리자가 notparsec와 N3M Tunnels 관리 기능에 접근한다. 콘솔 사용자 세션과 서버 간 서비스 credential, N3M Tunnels agent와 파일 방문자 인증을 구분한다. 전체 터널 조회·중지·접근 로그를 관리 API로 제공하며 공유 도메인에 관리 쿠키나 notparsec 내부 키를 노출하지 않는다.",
"phase": "M2",
"priority": "P0",
"dependsOn": [
"PW-041",
"PW-032"
],
"acceptance": "관리자·조회자·일반 소유자의 로그인/로그아웃/권한 철회와 관리 API 호출을 시험한다. 공개 파일 세션으로 콘솔에 진입할 수 없고 console 자격증명이 파일 본문 열람권한으로 오용되지 않는다. remote.n3m.kr 기존 서비스는 유지하며 console과 tunnels의 공개 DNS/TLS·설치·회귀 증빙을 남긴다.",
"verification": "T-PW-042",
"risk": "통합 구현은 필수다. 첫 구현은 기존 notparsec 관리자 Bearer 검증과 N3M Tunnels 별도 서비스 토큰을 사용한 단일 관리자 범위다. 다중 소유자·조회자 역할, DNS/TLS와 기존 remote 회귀는 확인한 계약 범위만 구현 완료로 기록한다.",
"origin": "user",
"component": "n3m-console Rust web/BFF + N3M Tunnels management API"
},
{
"id": "PW-043",
"title": "전체 터널·접속·전송 실시간 현황",
"description": "터널별 소유자·주소·기기·앱 버전·연결 및 파일서비스 상태·시작/만료·heartbeat·마지막 관측 시각, 활성 세션/전송·속도·누적량·오류 집계를 제공한다. 연결 상태와 접근 정책, 방문자 세션과 데이터 연결 수를 구분한다.",
"dependsOn": [
"PW-030",
"PW-031"
],
"acceptance": "두 소유자와 여러 터널/전송을 만들어 전체 집계와 필터가 실제 상태에 맞는다. 예약만 된 이름·전송별 WSS는 온라인 터널/방문자로 중복 계산하지 않는다. 수집 단절 시 값 0 대신 마지막 관측·지연/미확인을 표시한다.",
"origin": "user",
"category": "관리",
"phase": "M2",
"priority": "P0",
"verification": "T-PW-043",
"component": "server Control·Relay·이벤트 저장 + web 관리"
},
{
"id": "PW-044",
"title": "중앙 차단·종료·정책 변경과 적용 확인",
"description": "전체 터널의 접근 일시차단/재허용·강제 종료·세션/전송 취소·권한/만료/한도·IP 정책을 제어한다. action ID, generation, 정책 version, 중복방지로 서버 적용과 agent 확인 결과를 따로 추적한다. 오프라인 PC 기동과 로컬 허용 범위 확대는 제공한다고 약속하지 않는다. IP 정책 상세는 IPv4/IPv6 CIDR 지원·명시적 차단 우선·허용 목록이 있으면 일치 필수·활성 IP 정책에서 원본 IP 미확인은 거부하는 제안이다.",
"dependsOn": [
"PW-030",
"PW-029",
"PW-026",
"PW-032",
"PW-045"
],
"acceptance": "관리자가 진행 전송 중인 터널을 차단하면 신규 접근과 전송이 정책대로 종료된다. 단절 agent는 확인 대기/timeout으로 표시하며 서버 차단은 유지한다. 중복 요청과 과거 generation 명령은 새 터널에 재적용하지 않고 동시 변경은 충돌을 반환한다. IP 정책 활성화 시 허용/차단 CIDR·중첩·미확인·위조 헤더 입력을 검사하고 인증 성공만으로 IP 제한을 우회할 수 없다.",
"origin": "user",
"category": "관리",
"phase": "M2",
"priority": "P0",
"verification": "T-PW-044",
"component": "server Control·Relay·이벤트 저장 + web 관리"
},
{
"id": "PW-045",
"title": "접속 원본 IP·추정 위치·클라이언트 조회",
"description": "방문자 client IP와 수신 peer IP, agent 출발 IP를 구분하고 IP 산출 근거/신뢰 프록시 revision을 남긴다. 국가·지역·도시·ASN/통신사와 User-Agent의 브라우저/OS를 추정값으로 표시하며 인증 주체 또는 익명과 연결한다.",
"dependsOn": [
"PW-009",
"PW-025",
"PW-031"
],
"acceptance": "직접 접속·신뢰 프록시·다중 프록시·IPv6·위조 전달 헤더를 시험해 원본 IP와 산출 근거가 맞고 신뢰되지 않은 CF/XFF 값으로 위조할 수 없다. GeoIP 실패·사설 IP는 미확인으로 남고 VPN 위치·User-Agent·공유 비밀번호로 실명이나 정확한 실제 위치를 단정하지 않는다.",
"origin": "user",
"risk": "IP 위치는 추정이며 동일 IP가 같은 사람을 의미하지 않는다. GeoIP 공급자·라이선스·갱신 정책은 미결정이다.",
"category": "관리",
"phase": "M2",
"priority": "P0",
"verification": "T-PW-045",
"component": "server Control·Relay·이벤트 저장 + web 관리"
},
{
"id": "PW-046",
"title": "중앙 요청·파일 전송 로그 검색과 내보내기",
"description": "기간·터널·소유자·주체·IP·국가/ASN·동작·결과로 요청/전송/연결/감사 이력을 검색하고 상세 시각·방향·바이트·소요시간·거부/오류 원인·관측 지점을 조회한다. cursor 페이지 처리와 권한 있는 JSON/CSV 내보내기를 제공한다.",
"dependsOn": [
"PW-031",
"PW-032",
"PW-045"
],
"acceptance": "동일 논리 전송의 재개·완료·취소·오류를 같은 transfer ID로 연결하고 전송 생성 전 인증/권한 거절은 request/event ID로 추적한다. 서로 다른 전송은 합치지 않으며 필터·페이지·내보내기 결과가 일치한다. 권한 없는 터널 로그와 숨김 필드가 노출되지 않고 CSV 수식 주입과 비밀 유출을 막는다. 로그 화면에 상위 edge 미수집 범위를 표시한다.",
"origin": "user",
"category": "관리",
"phase": "M2",
"priority": "P0",
"verification": "T-PW-046",
"component": "server Control·Relay·이벤트 저장 + web 관리"
},
{
"id": "PW-047",
"title": "실시간 로그 구독·수집 공백·저장 장애 처리",
"description": "인증된 SSE 등으로 로그와 상태를 갱신하고 event cursor 재연결·중복 제거·snapshot 재조회·누락 구간을 처리한다. 수집 위치·지연·용량 제한·유실 건수를 표시하며 정책상 미수집과 장애를 구분한다. 비긴급 정책 변경은 감사 저장 실패 시 거부하고 긴급 차단/종료는 우선 실행 후 별도 복구 기록을 시도한다.",
"dependsOn": [
"PW-031",
"PW-043",
"PW-046"
],
"acceptance": "브라우저/서버 재시작·네트워크 단절·cursor 보존기간 초과·DB/디스크 부족·이벤트 폭주에서 중복과 공백이 표시된다. 긴급 차단은 로그 장애에도 유지하며 복구 기록 실패는 감사 미기록으로 드러낸다. 관리자 권한 철회/로그아웃 후 열린 스트림도 중단하고 기존 관측값을 0으로 바꾸지 않는다.",
"origin": "proposal",
"risk": "외부 CDN/WAF·DNS·TLS 단계에서 끝난 시도는 별도 관측 연동 전까지 전체 수집을 보장하지 않는다.",
"category": "관리",
"phase": "M2",
"priority": "P0",
"verification": "T-PW-047",
"component": "server Control·Relay·이벤트 저장 + web 관리"
}
]
데이터·검증 자료
portway/requirements.json
design/portway/requirements.json