{ "schemaVersion": 1, "project": "portway", "documentId": "PW-PLAN-001", "revision": "001-06", "updatedAt": "2026-10-05", "timezone": "Asia/Seoul", "summary": "Rust 첫 구현: 폴더 CLI·임시 주소·WS 중계·8MiB 웹 전송·터널 관리/로그. Linux 실제 서버·에이전트 30개 통합 검사, 통합 콘솔/파일 웹 27개 브라우저 검사와 Windows x86_64 MSVC 교차 검사 통과. 모든 요구의 전체 수용 기준은 미완료. 2026-10-05 사용자의 전체 서비스 설치 후 공개 TLS·세 서비스 실행과 공개 경로 20개 검사를 확인했다. Windows CLI 실기·외부망 파일 왕복·대용량 스트리밍/재개와 인증된 운영자 검증은 남아 있다.", "requirements": { "PW-001": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/bin/portway.rs", "crates/portway/src/protocol.rs" ], "evidence": [ "evidence/runtime-validation.json", "evidence/windows-cross-check.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증. Windows x86_64 MSVC 전체 target cargo check 통과(EXE 링크·실행 미실행).", "updatedAt": "2026-10-04", "notes": "Rust CLI serve 구현. Linux 실제 실행 검증. Windows 실행/설치 미검증." }, "PW-002": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/bin/portway.rs", "crates/portway/src/protocol.rs" ], "evidence": [ "evidence/runtime-validation.json", "evidence/windows-cross-check.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증. Windows x86_64 MSVC 전체 target cargo check 통과(EXE 링크·실행 미실행).", "updatedAt": "2026-10-04", "notes": "별도 agent token-file와 WSS 서버 선택 구현. 장치별 등록·폐기와 OS 자격증명 보관 미구현." }, "PW-003": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-004": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/bin/portway.rs", "crates/portway/src/protocol.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "Ctrl+C/콘솔 종료 경로 구현. CLI status 명령·OS 서비스 수명은 미구현." }, "PW-005": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/bin/portway.rs", "crates/portway/src/protocol.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "별도 에이전트 프로세스 2개 동시 공유를 검증. 단일 프로세스 관리 기능은 후속." }, "PW-006": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/bin/portway.rs", "crates/portway/src/protocol.rs" ], "evidence": [ "evidence/runtime-validation.json", "evidence/windows-cross-check.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증. Windows x86_64 MSVC 전체 target cargo check 통과(EXE 링크·실행 미실행).", "updatedAt": "2026-10-04", "notes": "아웃바운드 WebSocket 실제 왕복 검증. 실제 Windows 외부망 WSS/TLS는 미검증." }, "PW-007": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "96비트 난수 label과 SQLite UNIQUE·영구 이름 기록. 새 실행은 새 주소. 생성 멱등성·충돌 재시도·DNS사전검사 미구현." }, "PW-008": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-009": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json", "evidence/learning-document/operations-observation.json", "evidence/learning-document/operations-live-verification.json", "evidence/learning-document/certificate-user-confirmation.json" ], "testedEnvironment": "Ubuntu 운영 서버의 읽기 전용 서비스 상태·loopback readiness·공개 HTTPS 검사. 사용자 발급/갱신 로그와 독립 공개 TLS 검증 구분. Windows CLI·외부망 파일 왕복 미검증.", "updatedAt": "2026-10-05", "notes": "Host 격리·엄격한 suffix 검증 구현. 2026-10-05 19:55 KST 사용자 설치 후 세 서비스 active/enabled, 터널 readiness의 빈 본문 200, 새 한 단계 공유 이름의 시스템 신뢰·이름·유효기간 TLS 검증, apex/wildcard SAN과 미등록 공유 404를 확인했다. 공개 경로 20개 검사는 통과했지만 요구 전체의 악성 Host/전달 헤더·다단계 이름·활성 공유 라우팅 및 Windows 외부망 인수시험을 대신하지 않는다." }, "PW-010": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "공유TTL·ping/pong·종료/단절/서버 재시작 fail-closed. 자동 재연결·동일 주소 복구 미구현." }, "PW-011": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/bin/portway.rs", "crates/portway/src/protocol.rs" ], "evidence": [ "evidence/runtime-validation.json", "evidence/windows-cross-check.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증. Windows x86_64 MSVC 전체 target cargo check 통과(EXE 링크·실행 미실행).", "updatedAt": "2026-10-04", "notes": "v1 JSON 요청ID와 단일 WS 계약. 초기 파일당 8MiB bounded buffer. 전송별 스트림·취소/재개 미구현." }, "PW-012": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "crates/portway/src/files.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "정렬된 폴더 목록·크기/종류와 한글 경로 검증. 폴더 1,000항목 상한. 페이지 분할 미구현." }, "PW-013": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "crates/portway/src/files.rs" ], "evidence": [ "evidence/runtime-validation.json", "evidence/windows-cross-check.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증. Windows x86_64 MSVC 전체 target cargo check 통과(EXE 링크·실행 미실행).", "updatedAt": "2026-10-04", "notes": "cap-std 디렉터리 capability·경로/예약명/링크 제한. Linux 탈출·hardlink 시험. Windows TOCTOU/NTFS 실기 미검증. Windows 전용 핸들 검사 코드의 교차 컴파일 통과." }, "PW-014": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "crates/portway/src/files.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "SHA-256 확인 후 attachment 다운로드, 파일당 8MiB. 대용량 스트리밍은 미구현." }, "PW-015": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-016": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "crates/portway/src/files.rs", "crates/portway/web/app.js" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "웹 기본 업로드와 SHA-256 검증. 초기 파일당 8MiB; 대용량/재개 미구현." }, "PW-017": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-018": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "crates/portway/src/files.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "동일 디렉터리 임시파일→sync→no-clobber hardlink commit, 기존 파일 보존 시험. crash/Windows잠금 실기 미검증." }, "PW-019": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-020": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-021": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "crates/portway/web/app.js" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "정적 웹 파일 탐색·상위 이동·읽기/쓰기·키 입력 화면. 현재 로그인은 메모리 Bearer, 폴더별 1,000항목 한도." }, "PW-022": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-023": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "crates/portway/web/app.js" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "접근키 오류·권한·종료·대용량·충돌 메시지. 모든 Windows/망 오류 시나리오 미검증." }, "PW-024": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-025": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "서버 admin/agent/공유 방문자 키 분리. 초기 운영자 공유 agent token. 다중 소유자 계정·장치별 등록 미구현." }, "PW-026": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "읽기 전용 기본값·쓰기 opt-in·TTL 60초~8시간. 사용자별 세부 ACL 미구현." }, "PW-027": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "crates/portway/web/app.js" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "관리/파일 hostname 분리, 메모리 Bearer, CSP·nosniff·첨부 다운로드. SSO/방문자 세션 재발급 미구현." }, "PW-028": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "인증 전 본문 수집 차단·파일 8MiB·서버 전체 전송4·agent연결16 상한. 속도·디스크 quota와 부하 측정은 후속." }, "PW-029": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "콘솔 stop과 기존 공유 키 즉시 거부·agent 종료 검증. 장치별 credential 폐기 미구현." }, "PW-030": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "../n3m-console/src/lib.rs", "../n3m-console/web/admin.js" ], "evidence": [ "evidence/console-integration.json" ], "testedEnvironment": "Linux loopback 실제 notparsec/Portway/콘솔 + Chromium. 공개 DNS/TLS/운영 이전·Windows 실기 미검증.", "updatedAt": "2026-10-04", "notes": "중앙 콘솔 전체 활성 터널 목록·요청/전송량·stop UI와 내부 API. 공개 도메인 이관 및 세부 정책 UI 대기." }, "PW-031": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "SQLite 요청 성공/거부·admin_stop 기록, 7일/최대10,000행 제한. 별도 감사 보존·수집 실패 복구저널 미구현." }, "PW-032": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-033": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "../n3m-console/src/lib.rs", "../n3m-console/web/admin.js" ], "evidence": [ "evidence/deployment-validation.json", "evidence/deployment-blocked.json", "evidence/release-validation.json" ], "testedEnvironment": "Linux 설치 코드 경계시험·격리 Nginx 설정검사. 운영 미적용.", "updatedAt": "2026-10-04", "notes": "전용서비스·nginx·토큰분리·설치/롤백 코드와 경계시험. root/DNS/TLS 미준비로 실제 운영 미적용." }, "PW-034": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "relay는 파일 본문을 DB/디스크에 저장하지 않음. 현재 전송별 bounded buffer; 큰 파일 스트리밍·dump운영정책 후속." }, "PW-035": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "loopback health와 상태/전송계수 구현. 외부망 readiness·성능 metrics·부하시험 미구현." }, "PW-036": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs" ], "evidence": [ "evidence/runtime-validation.json", "evidence/windows-cross-check.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증. Windows x86_64 MSVC 전체 target cargo check 통과(EXE 링크·실행 미실행).", "updatedAt": "2026-10-04", "notes": "Linux 실서버/실agent 통합 시험과 Chromium 검증 진행. 실제 Windows/다른 인터넷 회선 미검증." }, "PW-037": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-038": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-039": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-040": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null }, "PW-041": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "../n3m-console/src/lib.rs", "../n3m-console/web/admin.js" ], "evidence": [ "evidence/console-integration.json" ], "testedEnvironment": "Linux loopback 실제 notparsec/Portway/콘솔 + Chromium. 공개 DNS/TLS/운영 이전·Windows 실기 미검증.", "updatedAt": "2026-10-04", "notes": "sibling Rust console service와 제한된 localhost 어댑터 구현. notparsec DB·키·장치API 소유권 유지." }, "PW-042": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "../n3m-console/src/lib.rs", "../n3m-console/web/admin.js" ], "evidence": [ "evidence/console-integration.json" ], "testedEnvironment": "Linux loopback 실제 notparsec/Portway/콘솔 + Chromium. 공개 DNS/TLS/운영 이전·Windows 실기 미검증.", "updatedAt": "2026-10-04", "notes": "기존 관리 화면 소스 이관·관리 Bearer 확인→별도 Portway토큰으로 호출. 운영 DNS/TLS/root 설치 대기." }, "PW-043": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "../n3m-console/src/lib.rs", "../n3m-console/web/admin.js" ], "evidence": [ "evidence/console-integration.json" ], "testedEnvironment": "Linux loopback 실제 notparsec/Portway/콘솔 + Chromium. 공개 DNS/TLS/운영 이전·Windows 실기 미검증.", "updatedAt": "2026-10-04", "notes": "전체 활성 터널 상태·누적 요청/바이트와 주기갱신. 연결/전송 세부 실시간 구독 미구현." }, "PW-044": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "../n3m-console/src/lib.rs", "../n3m-console/web/admin.js" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "stop만 구현: 신규 요청 차단과 WS 종료. 권한·만료 변경/ACK 추적은 후속." }, "PW-045": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "../n3m-console/src/lib.rs", "../n3m-console/web/admin.js" ], "evidence": [ "evidence/runtime-validation.json" ], "testedEnvironment": "Linux x86_64 loopback. 각 요구의 부분 경로만 검증; Windows/외부 DNS·TLS/운영 설치 미검증.", "updatedAt": "2026-10-04", "notes": "직접 peer와 설정된 proxy IP분리·위조 전달 헤더 무시 시험. GeoIP/ASN·신뢰 Cloudflare 범위 미구현." }, "PW-046": { "implementation": "in_progress", "verification": "partial", "codeLocations": [ "crates/portway/src/server.rs", "../n3m-console/src/lib.rs", "../n3m-console/web/admin.js" ], "evidence": [ "evidence/console-integration.json" ], "testedEnvironment": "Linux loopback 실제 notparsec/Portway/콘솔 + Chromium. 공개 DNS/TLS/운영 이전·Windows 실기 미검증.", "updatedAt": "2026-10-04", "notes": "최근 로그 조회 API/콘솔 목록. 검색·필터·내보내기는 미구현." }, "PW-047": { "implementation": "planned", "verification": "not_run", "codeLocations": [], "evidence": [], "testedEnvironment": null, "updatedAt": null } }, "serviceName": "N3M Tunnels", "consoleLabel": "Tunnels", "publicDomain": "tunnels.n3m.kr", "namingDecision": { "id": "ADR-08", "decidedAt": "2026-10-05", "reason": "사용자 확정 서비스명·콘솔 표기·공개 도메인 반영. 제품 기능 상태 및 과거 시험 증빙은 변경하지 않음.", "canonicalCommands": [ "tunnels", "tunnels-server" ], "compatibilityIdentifiers": [ "portway project/crate/path", "portway and portway-server executable aliases", "PORTWAY_* environment variables", "portway service/state account", "PW-PLAN-001 / PW requirement IDs", "portway:review:v1", "review JSON project=portway" ], "documentationValidation": "evidence/naming-validation-001-04.json" }, "operationsObservation": { "checkedAt": "2026-10-05 19:55 KST", "source": "evidence/learning-document/operations-live-verification.json", "previousSource": "evidence/learning-document/operations-observation.json", "console": "Service active/enabled; public HTML/JS/CSS matches installed app; health and authentication boundary checks passed", "tunnelsApexDns": "Cloudflare proxy addresses observed at 19:09 KST; public readiness returns expected empty 200 at 19:55 KST", "randomWildcardProbe": "New one-label hostname resolved and passed system trust, validity and hostname TLS verification", "certificateRenewalConfiguration": "User-provided TUNNELS_CERTIFICATE_READY confirms issuance/renewal dry-run; public certificate independently verified afterward", "publicWildcardTls": "TLS 1.3 verified; SAN tunnels.n3m.kr and *.tunnels.n3m.kr; unregistered share 404", "tunnelsService": "portway active/enabled; loopback 18081 expected empty 200", "rootInstallation": "User completed all-services installation; independent read-only checks passed", "publicChecks": "20/20 passed", "remaining": "Authenticated operator and actual Windows agent/external-network file round trip remain unverified" } }