notParsec / 문서전체 문서

설명·설계 문서

Parsec 재현 기준 · 설계와 구현의 우선 계약

design/PARSEC_PARITY.ko.md

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

이 문서의 목차

확인일: 2026-09-25 · parity-3 · 사용자 지시: 명시한 변경 외에는 가능한 모든 기능·코드 동작·레이아웃·아키텍처를 Parsec과 동일하게 따른다. 임의 기능을 창작하지 않는다.

이 문서는 과거의 자체 원격 데스크톱 설계 제안보다 우선한다. 기존 소스와 시험 결과는 실제 구현 이력으로 보존한다. 기존 구현이 있다는 이유로 그 구조를 목표 사양으로 인정하지 않는다. 사용자 요구가 바뀌면 예외와 영향 범위를 먼저 기록한다.

1. 비교할 원본을 고정한다

2. 사용자가 명시한 차이만 유지한다

정확한 예외 ID·범위와 생성 지시문 원본은 parity-policy.json에 있다.

ID 명시된 변경 허용 범위
E01 계정 가입·로그인·로그아웃 제거, 대상 PC별 비밀번호 해당 인증과 필요한 UI만 변경. 다른 기능의 자동 삭제 근거가 아님
E02 개인 Ubuntu 홈서버·Nginx·n3m.kr 자체 연결 관리 서버와 운영. 원본 비공개 서버의 내부 구현이 같다는 주장 금지
E03 Rust 중심·비공개·비배포 개인 사용 언어·빌드 도구·필요 FFI. 기능·레이아웃 축소의 근거가 아님
E04 동일한 Windows EXE에서 양쪽 역할 같은 앱에서 접속·호스팅. 필요한 설정 데이터·서비스·드라이버의 별도 파일까지 금지한 것으로 해석하지 않음
E05 Linux·macOS 호환 확장 필요한 OS별 캡처·입력·미디어·패키지 포트. 원본과의 차이 및 미검증 범위를 별도 기록
E06 이미지 클립보드·드래그앤드롭 2026-09-25 명시 요청. 유니코드 텍스트 원본 근거와 이미지/파일 확장을 구별. 파일 관리자·이어받기 등으로 확대하지 않음

이 예외를 이유로 자동 NAT를 VPN 전용으로 바꾸거나, 원본의 접속 흐름을 인증서 파일 수동 교환으로 고정하거나, UI를 새 대시보드로 바꾸지 않는다. 자체 서버 운영에 필수인 관리 기능은 E02에 근거를 연결하고 원본 제품 기능과 구분한다. 필요한 차이가 확인되지 않으면 추정 구현을 확대하지 않는다.

계정 의존 기능·결제·Teams·친구/공유 등의 과거 '범위 제외' 기록도 재검토한다. E01 때문에 그대로 실행할 수 없는 흐름은 해당 예외의 영향과 미결정을 기록한다. 개인용이라는 설명만으로 나머지 기능 전체를 없애지 않는다. 원본 서비스/구독 검사를 변경하는 행위로 자체 앱 구현을 대신하지 않는다.

2026-09-25 추가 요청 E05: Linux·macOS 호환을 확장한다. 원본의 OS별 지원 범위와 자체 포트를 구분하며 초기 호환 구현에 검증 범위를 기록한다. 기존 Windows 요구와 기능 대조를 대체하지 않는다.

3. 모든 항목에 원본 대응표를 붙인다

F ID, 설정 키, U ID를 연결하는 대조 기록을 작성한다. 서로 같은 기능의 근거를 중복 세지 않는다. 기존 설명은 원본 사실과 자체 제안이 혼재하므로 모두 재검토 대상이다.

필수 필드 기록할 내용
대상 F ID, 설정 키/U ID, 원본 버전·플랫폼·해시
원본 근거 파일·함수 주소·호출 관계·원문 또는 직접 관찰한 화면/실행 결과
원본 사양 입력, 기본값·범위, 표시 조건, 상태 전이, 적용 시점, 성공/실패/취소/복구, 수명·권한
구현 대응 소스 경로·함수·공유 모듈·프로세스/서비스/드라이버 경계
차이 동일 / 관찰된 불일치 / 미확인 / 명시 예외 ID와 정확한 범위
비교 시험 같은 조건의 원본·자체 앱 입력과 결과, 화면 비교, 실패·경계 사례, 재현 명령
판정 원본 대조 전 / 불일치 / 일치 확인 / 명시 예외 검증, 남은 조건

문자열이 있다는 사실은 기능의 동작이나 화면 위치를 증명하지 않는다. 원본 함수 주소를 써 놓은 것만으로 복구 코드가 같다고 판정하지 않는다.

4. 레이아웃도 합격 조건이다

5. 코드·아키텍처도 출처와 비교가 필요하다

공개 소스 재사용, 디컴파일 의사 코드, 타입/수명을 복원한 코드, Rust 재작성을 구별한다. 각 단위에 원본 hash·함수·공개 저장소 revision·이용 조건·타입 추정·오류 경로·변경 내용을 남긴다. 가능한 함수는 같은 입력으로 결과와 상태 변화·자원 해제를 비교한다. 부동소수점·타이밍 차이는 실제 관찰을 근거로 범위를 정한다.

복구되지 않은 이름·주석·타입을 원본이라고 쓰지 않는다. 소스가 없는 서버 내부 DB·서비스 분할·wire schema와 완전히 동일하다고 보장하지 않는다. Rust 재작성은 C/C++ 원본 소스와 바이트 단위로 같은 코드가 아니며, E03 아래에서 검증한 동작과 책임 구조를 추적한다.

코어의 host/client/UI, 로더/업데이트, 서비스와 사용자 세션, IPC, capture/encode/decode/render, audio/input, BUD/전송, VDD/VUSB의 관계를 대조한다. 새 프로세스·UI 프레임워크·프로토콜·큐 정책을 편의만으로 확정하지 않는다. 기존 Quinn/rustls와 egui는 현재 구현 기술이며 원본 구조 재현의 합격 증거가 아니다.

6. 지금 바로잡을 차이

현재 항목 판정 다음 작업
사용자 앱 경계 progress-7에서 동일 EXE·프로필 통합 구현 교정 기록. F01/F24/F64/F82의 실제 두 PC·원본 화면/상태 대조는 남음
자체 4개 화면 GUI 원본 레이아웃 미검증 F24/F63/F64/F67/F70: 원본 화면/상태/배치 대조 후 수정
QUIC 고정, 직접 주소·인증서 파일 교환 기존 인증 시험 경로, 원본 일치 미검증 F04/F10/F31–F33/F81: BUD/접속 흐름 근거 및 E01/E02 영향과 비교. 최종 흐름으로 자동 채택 금지
F37 이미지·드롭 전달 텍스트는 원본 함수 확인, 이미지/파일 원본 범위는 미확인 E06 요청 범위로 구현. 처리·제한·검증을 따르고 이어받기 등으로 확대하지 않음
F44/F45 Sunshine/Moonlight/RustDesk 전환 자체 대안 제안 부품 근거 조사로 제한. 원본 제품 구조를 다른 제품으로 치환하지 않음
'개인용이므로 제외'한 설정·UI 제외 근거 재검토 F47/F63: E01–E06 영향인지, 원본 내부 상태인지, 미관찰인지 개별 판정
1080p60·단일 세션만으로 완료 초기 시험 조건 HDR/4:4:4/멀티모니터/Privacy/VDD/입력·오디오 등 원본 항목 누락 없이 계속 대조
Ubuntu 자체 서버 E02 구현 공개된/관찰 가능한 접속 동작과 자체 운영 시험을 구분. 원본 서버 소스 복원으로 표시 금지

7. 체크와 완료를 구별한다

기존 브라우저의 체크는 다음 작업 묶음 선택이다. 선택 해제가 원본 기능을 최종 제품에서 제외한다는 뜻은 아니다. 모든 원본 기능이 전체 목표이고, 82개 색인 밖의 발견 항목도 누락 목록에 기록한다. 기존 메모·수동 완료 표시는 보존한다.

development-status.json의 각 F ID에 parity를 둔다. status는 unreviewed(원본 대조 전), different(불일치), matched(일치 확인), exception_verified(명시 예외 검증)다. sourceEvidence는 원본 근거, comparisonEvidence는 비교 결과, exceptionIds는 E01–E06 범위다. 지원 빌드/운영 항목은 해당 예외에 대한 검증을 기록하고 Parsec 원본과 동일하다고 표시하지 않는다.

전체 done에는 기존 구현·시험·통합·선행 완료에 더해 matched 또는 exception_verified가 필요하다. 양쪽 근거 파일이 없거나 예외 ID가 없으면 완료를 거부한다. 혼합 항목은 비교 보고서에 일치 부분과 예외 부분을 각각 설명한다. 기준 버전이 바뀌면 영향 항목을 다시 대조한다. 자동 검사는 근거의 구조·존재를 검사할 뿐 실제 일치의 진실성을 대신 심사하지 않는다.

8. 착수와 보고 순서

  1. 이 계약과 원본 대응표를 읽고 현재 항목의 원본 사양을 확인한다.
  2. 미확인·불일치·명시 예외를 분리한다. 불확실한 영역을 임의 사양으로 채우지 않고 관찰/분석을 진행한다.
  3. 확인된 불일치를 먼저 수정한다. 통합 앱을 기능 확장이 아닌 원래 요구 수정으로 처리한다.
  4. 동일 조건에서 원본과 비교하고, 하드웨어/외부망 등 실행하지 못한 조건은 남긴다.
  5. 기능별 parity와 구현 기록, 차이와 다음 분석을 갱신한다. 생성 지시문과 HTML도 같은 기준으로 재생성한다.

다음 구현에 전달할 문서: NEXT_PARITY_IMPLEMENTATION.md. 동일 앱 교정 구현은 progress-7 기록을 따르며 원본 전체 대조 완료를 뜻하지 않는다.