notParsec / 문서전체 문서

설명·설계 문서

notParsec 개발 착수 지시

design/ALL_FEATURES_DEVELOPMENT.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

설계 버전: 2026-09-21.6 작업 폴더: D:\SoftwareDev\notParsec 우선 기준: AGENTS.md, design/PARSEC_PARITY.ko.md, design/parity-policy.json, design/NEXT_PARITY_IMPLEMENTATION.md 근거 문서: design/ARCHITECTURE.ko.md, design/CONTROL_SERVER.ko.md, design/UI_TEXT_AUDIT.ko.md, design/SETTINGS_AND_RECOVERY.ko.md, design/plan-data.json

개인용·비공개·비배포 Parsec 재현 프로그램을 Rust 중심으로 구현해줘. Parsec 원본 재현이 제품 목표다. 기능·설정·배치·문구·상태·아키텍처를 편의상 새로 만들거나 제외하지 않는다. 기준은 보관한 Windows Parsec 150-104a와 hash다. 최신 공식 문서나 다른 버전의 동작은 기준과 구분한다. 허용 차이는 parity-policy.json의 E01–E04와 사용자가 이후 명시한 변경뿐이다. 전체 선택은 과거 설계의 임의 변경을 승인한 것이 아니다. 같은 notparsec.exe에서 다른 PC 연결·내 PC 호스팅·설정을 제공한다. 내부 모듈 분리를 사용자용 EXE 분리로 바꾸지 않는다. 각 작업은 원본 근거 → 대응 기능/설정/UI → 구현 위치 → 차이/예외 → 동일 조건 비교 시험 순서로 수행한다. 근거가 없으면 미확인으로 기록하고 먼저 분석한다. 82개 기능·163개 설정·39개 UI 흐름은 현재 조사 색인이다. Parsec 전체를 완전히 조사했다는 뜻이 아니며, 원본에서 발견한 누락 기능은 근거와 함께 추가한다. 원본의 레이아웃·상태별 화면을 같은 DPI·크기·언어·버전으로 관찰하고 비교한다. 문자열 추출만으로 배치나 실제 동작을 검증했다고 하지 않는다. QUIC·기존 자체 GUI·fork 전환·파일 전송 확대는 원본 일치 미검증이다. 확인된 원본 동작 또는 명시 예외 없이 최종 사양으로 채택하지 않는다. 공개 코드·디컴파일 의사 코드·복구 코드·Rust 재작성을 구분하고 hash/함수/타입 추정/변경/차등 시험을 기록한다. 접근할 수 없는 원본 소스·서버 구조는 동일하다고 보장하지 않는다. 완료하려면 development-status.json의 parity가 matched 또는 exception_verified이고 원본 근거·비교 결과·예외 범위가 있어야 한다. 빌드/자체 테스트/통합 앱 실행만으로 Parsec 일치를 선언하지 않는다. 사용자 계정 가입·로그인·로그아웃은 구현하지 않는다. 접속 대상 PC별 비밀번호를 매 연결마다 입력하고 host가 검증한 뒤에만 영상·입력을 허용한다. 연결 관리 서버는 Ubuntu에서 실행한다. 현재 QUIC 인증·egui GUI·서버 API는 기존 구현이다. 원본과의 일치나 예외 범위를 확인한 뒤 사용하고 자체 선택을 원본 아키텍처로 취급하지 않는다. 아래 선택은 이번 작업 묶음이다. 최종 목표는 확인 가능한 원본 전체이며 미선택/MVP는 최종 제외 사유가 아니다. 확인된 구조 불일치의 교정을 우선한다. 공개 코드뿐 아니라 디컴파일 기반 복구 C/Rust 로직도 범위에 포함한다. 원본 hash·함수 주소·추정 타입·이용 조건·검증 상태를 기록하고, 검증한 로직부터 자체 모듈로 통합해줘. 원본 DLL 로딩이나 미검증 의사 코드의 즉시 링크를 기능 구현 완료로 취급하지 말고, Parsec의 계정/구독 검사를 변경하는 작업으로 대체하지 않는다. 하드웨어를 요구하는 검증은 mock/단일 PC 시험으로 완료 처리하지 말고 미검증 조건을 기록해줘. 기존 구현은 design/development-status.json과 VERIFICATION.md의 근거를 먼저 확인해 중복 작업을 피한다. 매 개발 작업 후 해당 기능의 구현·검증·통합 상태, 남은 작업, 근거와 확인일을 갱신하고 python design/build_plan.py로 HTML을 다시 생성해줘. F44/F45는 원본 대응 부품 조사다. 다른 제품으로의 전환이나 새로운 사용자 기능 도입을 허용하지 않는다.

선택 ID: F01, F02, F03, F04, F05, F06, F07, F08, F09, F10, F11, F12, F13, F14, F15, F16, F17, F18, F19, F20, F21, F22, F23, F24, F25, F26, F27, F28, F29, F30, F31, F32, F33, F34, F35, F36, F37, F38, F39, F40, F41, F42, F43, F44, F45, F46, F47, F48, F49, F50, F51, F52, F53, F54, F55, F56, F57, F58, F59, F60, F61, F62, F63, F64, F65, F66, F67, F68, F69, F70, F71, F72, F73, F74, F75, F76, F77, F78, F79, F80, F81, F82 기록상 완료: 없음 착수 가능한 항목: F01 차단 표시: 없음 완료 표시는 사용자 기록이므로 실제 코드·시험 근거를 확인할 것.

구현 기록 기준: 2026-09-21 / progress-7 같은 Windows notparsec.exe의 연결·호스팅, 공유 기기 프로필과 기존 데이터 보존 이전을 구현했습니다. 동일 앱의 양방향 loopback 인증을 검증했습니다. Ubuntu 서버는 별도로 유지합니다. 실제 두 PC·전체 원본 화면 대조·영상/오디오/입력은 남아 있습니다. 구현 기록 F01: doing — 11개 Cargo 패키지. Windows 사용자용 notparsec.exe에 양쪽 역할을 통합하고 Ubuntu 서버를 별도 유지했습니다. 새 release에서 역할별 EXE를 제외했습니다. 기존 v0.1.0-ci.1의 원격 CI/게시 검증을 보존하고 통합 앱용 CI 경로를 갱신했습니다. 원본 대조: different 남은 작업: PARSEC_PARITY: 같은 release hash의 실제 두 PC 검증·원본 화면/상태·서비스 수명 비교 (loopback만 확인) / 별도 clean 환경에서 재현 확인 / v0.1.0-ci.2 통합 앱 태그의 CI·게시 결과와 새 Windows artifact 실행 확인 구현 기록 F02: doing — RTX 3070·물리 픽셀 모니터 열거, hardware MFT 등록 목록과 NVENC API 버전 진단을 구현했습니다. 원본 대조: unreviewed 남은 작업: 실제 H.264 하드웨어 디코딩 시험 / 두 번째 PC와 실패 장치에서 지원 판정 확인 구현 기록 F03: doing — 467개 외부 Cargo package와 728개 상위 notice를 기록했습니다. WSS 의존성을 추가하고 Linux 대소문자 구분에 따른 notice 누락을 수정했습니다. 전체 대상·개발 의존성을 포함하며 실제 링크별 감사는 남아 있습니다. 원본 대조: unreviewed 남은 작업: 내장 native 코드·하위 라이선스 검토 / 실제 링크 단위의 출처 감사와 복구 코드 이용 조건 판정 구현 기록 F04: doing — 인증 메시지에 더해 40바이트 미디어 헤더·epoch·조각/프레임 상한·역순/중복/만료 거부를 구현했습니다. 원본 대조: unreviewed 남은 작업: 입력·세션 제어 wire 정의 / network/fuzz 및 버전 호환 시험 구현 기록 F05: doing — 캡처 획득 대기의 p50/p95와 재조립 완료·중복·만료·폐기·구형 프레임 계수를 추가했습니다. 원본 대조: unreviewed 남은 작업: 인코딩·송수신·디코딩·표시 단계 추적 / 통합 측정·고정 테스트 패턴·clock 오차 기록 구현 기록 F06: doing — 호스트 cert pin과 별도 Ed25519 장치 등록·API 키 인증·DPAPI 보호 저장을 구현했습니다. 원본 대조: unreviewed 남은 작업: 장치 키와 QUIC peer/session 연결 / 양쪽 권한·서버 철회 ACK/lease 통합 구현 기록 F07: doing — Desktop Duplication으로 실제 60프레임을 획득하고 GPU 내 복사/RAII 반환을 확인했습니다. 원본 대조: unreviewed 남은 작업: 지속 캡처 worker·encoder 연결 / access lost·hotplug·잠금·종료 실패 주입 시험 구현 기록 F10: doing — 실제 QUIC/TLS 연결과 인증 메시지 왕복, 0-RTT 비활성화까지 구현했습니다. 원본 대조: unreviewed 남은 작업: 미디어 datagram 경로·호스트 세션 승인 통합 / 서로 다른 물리 PC와 datagram loss/역순 시험 구현 기록 F11: doing — MTU 분할과 중복·역순 재조립, 상충 조각·구형 epoch·만료 frame 거부를 구현·시험했습니다. 원본 대조: unreviewed 남은 작업: 실제 QUIC datagram 및 decoder 연결 / 손실/역순 링크와 IDR 복구 통합 구현 기록 F14: doing — 재조립 대기를 4프레임/16MiB·100ms로 제한하고 만료 프레임의 재진입을 차단했습니다. 원본 대조: unreviewed 남은 작업: capture/encode/send/decode/present 큐 상한 / 실제 느린 링크에서 pacing·복구 검증 구현 기록 F24: doing — 동일 Desktop 객체에서 Computers와 Settings Client/Host를 제공하고 양방향 인증·취소·호스팅 수명을 시험했습니다. 전체 원본 화면 배치는 미검증입니다. 원본 대조: different 남은 작업: PARSEC_PARITY: 같은 release hash의 실제 두 PC 검증·원본 화면/상태·서비스 수명 비교 (loopback만 확인) / 실제 영상 창·입력과 통합 / 다중 DPI·접근성·다른 Windows PC 검증 구현 기록 F44: doing — Sunshine·Moonlight 고정 commit을 내려받아 캡처·코덱·의존성·프로토콜 경계를 검토했습니다. 원본 대조: unreviewed 남은 작업: 원형 전체 소스/submodule 빌드 / 동일 두 PC baseline과 채택 파일/대체 F 기능 확정 구현 기록 F45: doing — RustDesk 고정 commit을 내려받아 캡처·코덱·의존성·프로토콜 경계를 검토했습니다. 원본 대조: unreviewed 남은 작업: 원형 전체 소스/submodule 빌드 / 동일 두 PC baseline과 채택 파일/대체 F 기능 확정 구현 기록 F46: doing — 문자열·설정 테이블·함수 참조와 복구 후보를 추출했습니다. 독립 복구 함수의 Rust 통합은 아직 없습니다. 원본 대조: unreviewed 남은 작업: 복구 후보별 타입·fixture·실패 경계 확정 / 복구한 C/Rust 함수 실행 시험과 자체 모듈 통합 구현 기록 F47: doing — 비밀 없는 UI 설정 스키마 1·원자 저장·손상 복구와 163개 읽기 전용 설정 카탈로그를 구현했습니다. 원본 대조: unreviewed 남은 작업: 163개 실행 설정의 형식·범위·적용 시점 구현 / 실제 media/driver 설정 반영 검증 구현 기록 F64: doing — 같은 앱의 Computers에서 기존 기기 등록·목록·검색·수동 presence를 제공합니다. 하나의 프로필을 공유하며 원본 Connect/WSS 흐름은 아직 미완료입니다. 원본 대조: different 남은 작업: PARSEC_PARITY: 같은 release hash의 실제 두 PC 검증·원본 화면/상태·서비스 수명 비교 (loopback만 확인) / 기기 상세·공유/정렬·원클릭 연결 통합 / WSS 실시간 갱신과 두 번째 PC 검증 구현 기록 F67: doing — 인증서 확인·비밀번호 입력·대기·취소·오류·시간 만료 GUI를 구현하고 실제 QUIC으로 시험했습니다. 원본 대조: unreviewed 남은 작업: 영상 세션 연결 상태·재연결 통합 / NAT/relay 실패와 네트워크 단절 UI 구현 기록 F68: doing — GUI에서 로컬 GPU·모니터 진단 결과를 조회하고 JSON으로 내보낼 수 있습니다. 원본 대조: unreviewed 남은 작업: 실시간 미디어 성능 지표·그래프 / 운영 콘솔·로그 비밀 제거와 성능 검증 구현 기록 F70: doing — UI 설정 손상 시 기존 파일을 보존하고 기본값과 오류 안내로 시작합니다. 원본 대조: unreviewed 남은 작업: 그래픽 초기화 실패 시 최소 복구 화면 / 업데이트·rollback·다른 OS 상태 검증 구현 기록 F71: doing — 운영 systemd와 기존 Nginx를 설치하고 공개 health·인증·body/rate 상한, Linux Rust 기기 CLI의 HTTPS 호환을 확인했습니다. 원본 대조: unreviewed 남은 작업: Windows host/client와 새 WSS·세션 API 통합 검증 / 필수 설정 오류와 내부 장애 readiness의 전체 운영 조건 검증 구현 기록 F72: doing — 운영 schema 3 DB의 일관 백업·재설치·동일 release 복원/rollback과 강제 종료 자동 복구를 확인했습니다. 이전 schema 2 binary 복원은 격리 시험도 통과했습니다. 원본 대조: unreviewed 남은 작업: 운영과 분리된 DB 잠금·디스크 용량 부족/쓰기 실패 주입 검증 / 실제 장치 데이터가 있는 운영 버전 업그레이드·복원 검증 구현 기록 F73: doing — 공개 HTTPS에서 Ed25519 등록·인증·challenge 재사용 거부·폐기와 실제 Linux Rust CLI를 확인했습니다. 검증용 키/기기는 별도 상태에서 정리했습니다. 원본 대조: unreviewed 남은 작업: 최신 Windows EXE 재빌드와 실제 Windows 기기 키 등록 / 장치 키 회전은 기존 장치 폐기+새 키 등록 방식 구현 기록 F74: doing — 공개 Cloudflare/Nginx WSS의 101 upgrade·snapshot·revision/generation 재연결·철회 이벤트·폐기 연결 종료를 확인했습니다. 실제 30초 presence 만료도 재검증했습니다. 원본 대조: unreviewed 남은 작업: Windows GUI 자동 presence·재동기화 연결 / capability/접속 불가 사유 UI 구현 기록 F75: doing — 공개 HTTPS에서 승인·서명 ticket·peer 증명·단일 소비·비밀번호 대기 gate를 확인했습니다. 세션 지속/재시작과 철회는 실제 WSS로 검증했습니다. 원본 대조: unreviewed 남은 작업: Windows peer 키 증명과 QUIC 비밀번호 gate 통합 / 실제 양쪽 미디어 상태 보고 구현 기록 F76: doing — 공개 API/WSS에서 host grant 철회 후 세션 종료·장치 폐기 후 연결 종료와 인증 거부를 확인했습니다. Windows의 실제 미디어 집행은 남았습니다. 원본 대조: unreviewed 남은 작업: Windows 입력/미디어 종료 watchdog 및 실제 단절 집행 / 초대 API와 GUI 권한 관리 구현 기록 F77: doing — 승인된 참가자만 명시 IP/UDP 후보를 교환하고 TTL/세대/주소/개수·probe 계약 상한을 시험했습니다. 원본 대조: unreviewed 남은 작업: Windows 같은 UDP socket의 제한된 probe 구현 / 실제 공유기 포트포워딩/외부 회선 직접 연결 / STUN/hole punching/relay 별도 후속 구현 기록 F78: doing — systemd·기존 Nginx·공개 HTTPS/WSS·백업 timer 실행·로그 회전·동일 release rollback·SIGKILL 자동 복구·Certbot 기존 4개 SAN 갱신 dry-run을 운영 배치에서 확인했습니다. 원본 대조: unreviewed 남은 작업: 실제 재부팅 후 자동 시작 검증 / DB 잠금·용량 부족/쓰기 실패·장시간 proxy timeout 검증 / 별도 매체/서버의 외부 재해 복구 백업 구성 구현 기록 F79: doing — 설치된 systemd/Nginx와 별도 검증 DB로 공개 인증·WSS·세션/ticket·철회·재시작·실제 Linux Rust CLI를 확인했습니다. 두 물리 Windows PC 시험과 구분합니다. 원본 대조: unreviewed 남은 작업: 실제 두 Windows PC와 별도 외부 회선 / 영상·오디오·입력 및 실제 host lease 집행 / 30분 세션·10회 접속/종료·양쪽 UI 상태 일치 구현 기록 F80: validation — 비밀번호 초기 설정·변경, Argon2id, DPAPI 보호와 인증서 보존이 구현되어 단위·실제 CLI 시험을 통과했습니다. 원본 대조: unreviewed 남은 작업: 다른 Windows PC/사용자에서 초기 설정·보호 저장·복구 확인 / 완성된 장치 신뢰 흐름과 통합 검증 후 전체 완료 판정 구현 기록 F81: doing — 매 연결의 비밀번호 확인, 호스트 전체 실패 제한, 동시 검증 제한을 CLI에서 시험했습니다. 원본 대조: unreviewed 남은 작업: 실제 영상·입력 시작 전 인증 gate 연결 / 미전송·취소·relay 경로·연결 종료를 포함한 통합 검증 구현 기록 F82: doing — 계정 없는 동일 앱의 대상 PC 비밀번호 인증, 호스팅 설정, 기기 키/설정 보존 이전과 충돌 선택을 구현·시험했습니다. 원본 대조: different 남은 작업: PARSEC_PARITY: 같은 release hash의 실제 두 PC 검증·원본 화면/상태·서비스 수명 비교 (loopback만 확인) / 기기 선택에서 원격 영상 세션까지 연결 / IME·스크린리더·다른 PC에서 사용성 검증 위 구현 기록은 사용자 수동 상태와 별도이며 최신 코드·시험 결과로 확인할 것.

연결 관리 서버는 선택된 F71–F79와 CONTROL_SERVER.ko.md의 API·DB·권한·WSS·ticket·운영 계약에 따라 Rust로 구현한다. 홈서버 공인 IP·UDP 포트포워딩 가능 조건을 사용한다. F32 자동 NAT와 F33 relay는 선택됐을 때 구현하며, 명시 endpoint/개인 VPN 경로만으로 먼저 통합 시험할 수 있다. 서버의 실제 두 PC·외부 회선 시험과 백업 복원 결과를 별도로 보고하고 API mock 성공만으로 F79를 완료 표시하지 않는다.

M0 기반과 검증 환경

M1 LAN 영상 연결

M2 실제 원격 조작

M3 장시간 사용과 복구

M4 인터넷·연결 관리 서버

M5 고급 기능·원본 동등성

추가 요구사항

전체 착수 요청. 서버는 Ubuntu 24.04.4 LTS, Intel N100, x86_64. 실제 Ubuntu SSH 인증과 두 번째 Windows PC 검증은 남아 있음.

명시적으로 선택한 설정·감사 항목

각 마일스톤이 끝나면 실제 완료한 ID, 검증 결과, 아직 미검증인 장치·조건을 보고해줘.