notParsec / 문서전체 문서

생성 코드·템플릿

make_plan_data.py

design/make_plan_data.py

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

"""Author the design catalogue. This is a plan, not the remote-control implementation."""
import json
from pathlib import Path
from plan_extension import extend
from settings_catalog import catalogue
from ui_audit_catalog import extend as extend_ui
from server_plan_extension import extend as extend_server, catalogue as server_catalogue
from password_plan_extension import extend as extend_password
from parity_plan_extension import extend as extend_parity

ROOT = Path(__file__).resolve().parent
phases = [
 ('M0','기반과 검증 환경','프로젝트·측정·프로토콜·신뢰 모델을 먼저 고정한다.'),
 ('M1','LAN 영상 연결','현재 NVIDIA 호스트에서 캡처한 화면을 다른 Windows PC에 표시한다.'),
 ('M2','실제 원격 조작','키보드·마우스·오디오·기본 UI를 연결해 개인용 첫 버전을 완성한다.'),
 ('M3','장시간 사용과 복구','손실·장치 변경·재접속 상황에서도 지연과 자원 사용을 제한한다.'),
 ('M4','인터넷·연결 관리 서버','직접 IP/개인 VPN과 장치 목록·승인 서버를 구현하고, 자동 NAT 통과와 relay를 선택 확장한다.'),
 ('M5','확장과 동등 기능','다중 GPU·고급 영상·가상 장치·편의 기능을 선택적으로 확장한다.'),
]
features=[]
def add(id,phase,title,why,implementation,acceptance,deps=(),module='',reuse='',risk=''):
    features.append(dict(id=id,phase=phase,title=title,description=why,implementation=implementation,
        acceptance=acceptance,dependencies=list(deps),module=module,reuse=reuse,risk=risk))

add('F01','M0','Rust workspace와 재현 가능한 빌드','호스트·클라이언트가 같은 메시지·설정 정의를 사용하도록 프로젝트를 나눈다.',
 'host, client, core, protocol, platform-win, codec, transport, audio, input, telemetry crate로 구성한다. rust-toolchain.toml과 Cargo.lock을 고정하고 unsafe 코드를 Windows/FFI 모듈에 집중한다.',
 ['Windows x64에서 clean checkout 후 cargo build --locked 성공','core/protocol의 cargo test 및 rustfmt/clippy 통과'],module='workspace',reuse='Rust 표준 도구·windows-rs')
add('F02','M0','장치·코덱 지원 진단','RTX 3070 호스트와 아직 확인하지 않은 클라이언트의 실제 지원 범위를 확인한다.',
 'DXGI adapter LUID, 출력 해상도·DPI, NVENC codec/format, MF decoder와 D3D11 장치 사용 가능 여부를 조사한다. 하드웨어 부재를 소프트웨어 경로로 숨기지 않고 진단한다.',
 ['RTX 3070과 선택한 물리 모니터가 진단 결과에 표시','클라이언트 H.264 하드웨어 decode 지원/실패 이유가 표시'],['F01'],'platform-win','DXGI·NVENC·Media Foundation API','가상 모니터가 기본 출력으로 잘못 선택되지 않도록 한다.')
add('F03','M0','재사용·복구 코드 출처와 버전 기록','공개 코드와 디컴파일 기반 복구 코드의 근거·수정·검증을 추적한다.',
 '공개 코드는 저장소·commit·라이선스를, 복구 코드는 바이너리 hash·함수 주소·추정 타입·이용 권한·검증 fixture를 기록한다. 확인한 복구 C/Rust 로직을 자체 모듈에 통합하는 경로도 포함한다.',
 ['링크되는 crate/네이티브 라이브러리·복구 코드의 출처와 버전 기록','복구 가능성·컴파일 가능성·동작 검증·이용 조건을 별도 판정하고 미검증 의사 코드를 그대로 링크하지 않음'],['F01'],'build / vendor / recovered','공개 라이브러리·검증한 복구 C/Rust 코드')
add('F04','M0','자체 프로토콜과 입력 한도','버전이 다른 두 프로그램과 잘못된 패킷을 예측 가능하게 처리한다.',
 '제어 메시지의 version/capabilities와 미디어 40바이트 헤더를 문서화한다. total_len·fragment 수·연결 epoch를 검증하고 decode 이전에 메모리·시간 한도를 적용한다.',
 ['버전 불일치가 명확한 오류로 종료','잘못된 길이·중복·역순·지연 조각에 메모리 상한 유지'],['F01'],'protocol','자체 schema / 제한된 크기의 직렬화')
add('F05','M0','프레임 추적과 시험 장치','지연이 어디서 생기는지 수치로 확인할 수 있게 한다.',
 'frame_id와 각 단계의 단조 시각, 큐 깊이, drop, RTT를 기록한다. 가상 캡처·코덱·전송 입력과 seed가 고정된 loss/reorder 주입기를 둔다.',
 ['단계별 p50/p95와 drop 이유를 출력','서로 다른 PC의 시각을 동기화 오차 없이 직접 빼지 않음'],['F01','F04'],'telemetry / tests','tracing 및 자체 테스트 harness')
add('F06','M0','장치 신뢰·페어링 설계','다른 장치가 연결되었을 때 화면과 입력을 허용할 대상을 결정한다.',
 '호스트·클라이언트의 장기 키를 만들고 대역 외 비교한 fingerprint를 양쪽에 고정한다. Windows DPAPI로 키를 보호하며 새 키는 자동 신뢰하지 않는다. 0-RTT 제어 요청은 금지한다.',
 ['확인한 장치만 세션 생성 가능','위조·변경된 fingerprint와 만료된 임시 승인이 거부됨'],['F01','F04'],'core / platform-win','rustls·검증된 키 생성·DPAPI','인증서 검증을 무조건 성공시키는 개발용 우회를 제품 경로에 넣지 않는다.')

add('F07','M1','DXGI 화면 캡처','Windows 데스크톱의 현재 프레임을 GPU texture로 획득한다.',
 'Desktop Duplication의 AcquireNextFrame/ReleaseFrame을 RAII로 감싼다. 원본 texture는 전용 pool에 GPU 복사한 뒤 반환하고, 미디어 worker가 COM·D3D context를 소유한다.',
 ['선택 모니터의 변하는 화면을 연속 획득','timeout·access lost·종료 시 acquired frame이 남지 않음'],['F02','F05'],'platform-win::capture','windows-rs / DXGI','GPU 복사 1회와 CPU raw readback은 서로 다르다. 무복사를 미리 약속하지 않는다.')
add('F08','M1','색 변환과 GPU surface pool','캡처의 BGRA 화면을 코덱 입력에 맞게 변환한다.',
 'D3D11 video processor 또는 shader로 BGRA→NV12를 변환한다. 초기 SDR BT.709 및 range를 명시하고 encode가 끝나기 전 surface를 재사용하지 않는다.',
 ['색상표·텍스트·회색 계조의 변환 검증','측정 중 원시 프레임의 GPU→CPU readback 0회'],['F07'],'platform-win::gpu','D3D11 API·자체 shader')
add('F09','M1','NVENC H.264 인코딩','현재 RTX 3070에서 하드웨어 압축을 수행한다.',
 'NVENC C ABI의 얇은 Rust wrapper를 작성한다. low-latency 설정, B-frame 0, IDR 요청, SPS/PPS 전송, bitrate 재설정과 flush를 포함한다. 지원 capability를 먼저 질의한다.',
 ['1080p60 테스트 패턴 인코드와 decoder 입력 생성','IDR 요청·종료·재시작 때 surface/bitstream 자원 누수 없음'],['F03','F08'],'codec::nvenc','NVIDIA SDK 헤더·허용된 샘플','SDK/헤더별 사용 조건을 고정된 버전에서 확인한다.')
add('F10','M1','암호화된 QUIC 연결','LAN의 두 개인 PC 사이에 인증된 전송 연결을 만든다.',
 'Quinn + rustls로 양쪽 장치 신뢰를 검증하고 M1 CLI의 host 일회 승인을 받은 뒤 영상을 허용한다. 제어·입력은 reliable stream, 영상·오디오는 QUIC DATAGRAM으로 구분한다. 앱 ALPN을 고정한다.',
 ['서로 신뢰한 두 PC만 연결하며 host 승인 전 영상 전송 없음','제어 메시지 왕복과 datagram loss/역순 시험 통과'],['F04','F06'],'transport::quic','Quinn·rustls','QUIC은 NAT 통과나 미디어 재조립을 자동 제공하지 않는다.')
add('F11','M1','영상 조각화·재조립','한 영상 프레임을 MTU에 맞게 보내고 기한 내에 모은다.',
 'max_datagram_size에서 앱 헤더를 뺀 길이로 조각화한다. 재조립은 epoch/frame_id로 분리하고 4MiB/프레임·16MiB/연결·100ms 기한을 시작값으로 제한한다.',
 ['중복·역순 조각에서도 완전한 프레임만 decoder에 전달','만료·비정상 길이·구형 epoch의 프레임 폐기'],['F04','F09','F10'],'protocol / transport','Quinn DATAGRAM + 자체 재조립')
add('F12','M1','하드웨어 영상 디코딩','클라이언트에서 H.264를 GPU 출력으로 복원한다.',
 'Media Foundation MFT와 D3D11 device manager를 사용한다. 실제 hardware MFT 및 DXGI surface 출력을 진단하고 format change·drain·IDR 대기를 구현한다.',
 ['클라이언트에서 hardware MFT 및 GPU surface 경로 확인','해상도 변경·불완전 GOP 후 정상 IDR에서 복구'],['F02','F11'],'codec::mf-decoder','Windows Media Foundation','소프트웨어 fallback은 진단용으로만 명시적으로 선택한다.')
add('F13','M1','D3D11 화면 표시','복원된 texture를 실제 창에 맞춰 표시한다.',
 '독립 Win32 영상 HWND에 D3D11 swapchain으로 표시한다. UI와 resize 이벤트를 교환하며 aspect ratio·letterbox·색 범위를 처리한다.',
 ['리사이즈·최소화·전체화면에서 화면 왜곡 없음','표시되지 않는 창에서 GPU 작업이 무한 누적되지 않음'],['F12'],'client / platform-win::renderer','DXGI swapchain','egui의 wgpu texture와 즉시 공유하는 최적화는 초기 범위에서 제외한다.')
add('F14','M1','큐 상한·프레임 만료·기본 속도 조절','느린 단계 하나가 전체 영상 지연을 계속 늘리지 못하게 한다.',
 'capture→encode는 최신 프레임 우선 2개, decode→present는 2개로 시작한다. encoded P-frame 폐기 시 GOP 의존성을 고려해 IDR을 요청한다. 전송 rate와 큐 한도를 둔다.',
 ['송신보다 느린 링크에서 큐 길이가 제한값을 넘지 않음','혼잡 해소 후 오래된 영상이 연속 재생되지 않음'],['F05','F09','F10','F13'],'core::scheduler','자체 bounded queue·Quinn 전송 통계')
add('F15','M1','손실 감지와 IDR 복구','영상 조각이 유실되었을 때 화면을 다시 정상화한다.',
 '불완전 프레임을 버리고 decoder 참조 상태가 깨지면 keyframe을 요청한다. IDR 요청을 병합·rate-limit하며 기본은 프레임 기한 이후 재전송하지 않는다.',
 ['1% 무작위 손실과 100ms burst에서 연결 유지','정상 링크 복귀 후 요청한 IDR부터 정상 화면 복구'],['F11','F12','F14'],'core::video-recovery','자체 상태 머신','시험 목표이며 실측 성능 보장은 아니다.')
add('F16','M1','LAN 영상 마일스톤 검증','화면이 나오는 데서 끝내지 않고 첫 기능 묶음을 합격시킨다.',
 '호스트/클라이언트 CLI를 제공하고 1080p60·SDR·H.264·유선 LAN 시나리오로 10분 시험한다. 단일 PC loopback은 별도 표시하며 두 PC 결과를 대체하지 않는다.',
 ['두 PC 10분 시험에서 crash·지속적 메모리 증가 없음','성능 표에 측정 장치·bitrate·RTT·실제 fps·단계 p95 기록'],['F13','F14','F15'],'host / client / tests','자체 실행·측정 도구')

add('F17','M2','세션 승인·연결 수명','화면 보기와 입력 권한을 명시적으로 관리한다.',
 'Idle→Pairing→Negotiating→Streaming→Recovering→Stopping 상태를 정의한다. 세션 1개를 우선 지원하고 host 측 보기/제어 승인 및 즉시 종료를 제공한다.',
 ['승인 전 화면·오디오·입력 전달이 없음','종료 시 worker·입력·네트워크 자원이 순서대로 정리'],['F06','F10','F16'],'core::session','자체 상태 머신')
add('F18','M2','키보드·마우스 원격 입력','클라이언트의 조작을 호스트의 승인된 세션에 전달한다.',
 'scan code·mouse button·wheel·relative delta는 ordered reliable input stream으로 전달한다. absolute move만 sequence가 있는 최신 상태 datagram을 쓴다. button 전이에 클릭 좌표를 함께 넣어 채널 간 순서 차이를 보정한다. host는 권한 검증 후 SendInput을 호출한다.',
 ['키 조합·휠·드래그·상대 마우스 동작 확인','중복·오래된 move packet으로 좌표가 되돌아가지 않음'],['F04','F17'],'input','Windows SendInput','일반 권한에서 UAC secure desktop·더 높은 integrity 창 입력은 지원 범위 밖이다.')
add('F19','M2','입력 해제·heartbeat·로컬 중단','연결이 끊긴 뒤 키나 버튼이 눌린 채 남는 문제를 막는다.',
 'pressed-set을 host가 추적한다. 포커스 상실·권한 회수·세션 종료·heartbeat 만료 시 release-all을 실행한다. host의 로컬 종료 단축키를 둔다.',
 ['Ctrl/Shift·마우스 버튼을 누른 채 연결을 끊어도 해제','연결 종료 후 입력이 추가 주입되지 않음'],['F18'],'input / core','자체 상태·watchdog')
add('F20','M2','커서·DPI·좌표 변환','클릭 위치와 보이는 커서가 화면 배율과 맞도록 한다.',
 '영상의 content rect와 host monitor 좌표를 변환한다. cursor shape/position 메시지로 원격 커서를 표시하며 이중 커서와 letterbox 클릭을 처리한다.',
 ['100%/150% DPI와 letterbox에서 9점 클릭 정합','커서 모양 변경과 모니터 원점이 음수인 배치 검증'],['F07','F13','F18'],'input / renderer','DXGI pointer metadata')
add('F21','M2','WASAPI 시스템 오디오 캡처','호스트에서 재생하는 소리를 클라이언트로 전달할 입력을 만든다.',
 'WASAPI loopback을 전용 audio worker에서 캡처하고 silence·device format을 처리한다. 48kHz stereo로 변환하고 고정 sample-count 블록을 만든다.',
 ['호스트 재생음·무음 전환이 연속된 타임스탬프로 캡처','기본 장치 형식이 달라도 sample count와 채널이 맞음'],['F02','F17'],'audio::capture','WASAPI API')
add('F22','M2','Opus 인코딩·오디오 전송','음성을 낮은 대역폭으로 전송한다.',
 'libopus C ABI를 얇게 감싼다. 초기 48kHz stereo·5/10ms 프레임 중 검증된 값을 사용하며 sequence/sample count를 DATAGRAM 헤더에 기록한다.',
 ['왕복 encode/decode sample 수 검증','소실 packet과 중복 packet이 재생 큐를 깨뜨리지 않음'],['F03','F10','F21'],'audio::opus','공개 libopus / BSD 계열','Rust wrapper 자체의 라이선스도 별도 확인한다.')
add('F23','M2','오디오 지터 버퍼·재생','네트워크 도착 간격을 흡수하고 영상과 재생 흐름을 맞춘다.',
 'WASAPI 출력에 bounded jitter buffer와 Opus PLC를 연결한다. under/overrun을 기록하고 시작값 20–60ms 범위에서 재생 버퍼를 조절한다.',
 ['loss/reorder 중 crash 없이 PLC/폐기 기록','10분 재생에서 큐 증가·점진적인 오디오 지연 누적 없음'],['F05','F22'],'audio::playback','libopus PLC·WASAPI')
add('F24','M2','호스트·클라이언트 UI와 설정','IP 입력부터 연결 종료까지 개인 사용 흐름을 제공한다.',
 'Rust egui/eframe로 장치 신뢰·모니터·bitrate·fps·오디오·입력 권한을 표시한다. 영상은 별도 D3D11 창에서 렌더링하고 설정은 schema version이 있는 파일로 저장한다.',
 ['첫 페어링→승인→영상·음성·조작→종료를 UI로 수행','잘못된 설정 복구와 단축키로 세션 종료 가능'],['F16','F17','F19','F20','F23'],'client-ui / host-ui','egui / eframe')
add('F25','M2','개인용 첫 버전 합격 시험','일상적인 원격 작업이 가능한 최소 묶음을 확인한다.',
 '두 Windows PC에서 30분 영상·오디오·입력 시험, 연결 강제 종료, host 승인 거부, 키 해제 시험을 수행하고 재현 방법을 남긴다.',
 ['30분 연결과 10회 연결/종료에서 자원·입력 상태 정상','기능 미지원과 실패 이유가 UI·로그에 표시'],['F24'],'tests / delivery','로컬 실행 패키지·수동 검증 기록')

add('F26','M3','동적 bitrate·fps 조절','대역폭 변화에 따라 화질과 지연을 조절한다.',
 'RTT·loss·송신 queue age를 측정해 제한된 주기로 bitrate를 바꾼다. Quinn의 혼잡 제어를 대체하지 않고 그 위의 encoder 입력률을 조절한다.',
 ['링크 제한을 절반으로 낮춰도 queue age가 무한 증가하지 않음','회복 시 bitrate가 급격히 진동하지 않음'],['F14','F15','F25'],'core::rate-control','Quinn stats + NVENC reconfigure')
add('F27','M3','모니터·GPU·오디오 장치 변경 복구','잠금 해제나 화면·소리 장치 변경 후 재시작 없이 복구한다.',
 'access lost·display mode change·device removed를 구분해 generation을 올리고 pipeline을 재구성한다. audio 기본 장치 변경 때 큐와 시간을 재설정한다.',
 ['모니터 해상도 변경과 오디오 장치 변경 각 10회','복구 후 이전 generation의 texture/packet 사용 없음'],['F25'],'platform-win / core','Windows 장치 이벤트')
add('F28','M3','연결 끊김·재연결','네트워크가 잠시 사라져도 명확하게 상태를 회복한다.',
 '기존 세션의 입력을 해제하고 bounded backoff로 재접속한다. 인증 재검증, 새 epoch, IDR 재시작, 오디오 큐 초기화를 수행한다.',
 ['네트워크 5초 중단 후 복구 경로 시험','변경된 host 키에는 자동 재연결하지 않음'],['F19','F25'],'core / transport','자체 연결 수명')
add('F29','M3','지연·부하 프로파일링','최적화 전후 차이를 같은 조건에서 비교한다.',
 'CPU/GPU 단계별 비용과 queue age를 저장한다. 초기 목표는 유선 LAN에서 처리 단계 합 p95 30ms 이하로 두되 네트워크·디스플레이 스캔아웃을 별도 기록한다.',
 ['동일 설정의 baseline과 변경 후 결과 비교','glass-to-glass 수치는 별도 광학/고속 촬영 시험 없이 주장하지 않음'],['F05','F25'],'telemetry','ETW/GPU 도구·자체 trace','30ms는 제안한 목표이며 Parsec 분석에서 얻은 실측값이 아니다.')
add('F30','M3','개인용 업데이트·복구 가능한 실행 패키지','새 버전으로 바꿨다가 실패하면 이전 버전으로 돌아갈 수 있게 한다.',
 '서버 자동 업데이트 대신 버전별 zip과 설정 마이그레이션/rollback부터 지원한다. 로컬 신뢰 저장소는 일반 설정과 분리한다.',
 ['새 버전 실행 실패 후 이전 버전으로 복귀','설정 마이그레이션 실패 시 원본 보존'],['F25'],'build / core','표준 zip·서명 검증은 후속')

add('F31','M4','개인 VPN 또는 직접 IP 연결','별도 계정 서버 없이 외부 네트워크에서 내 PC에 접속한다.',
 '기존 개인 VPN이 제공하는 peer IP에 QUIC 연결한다. endpoint와 포트는 설정으로 관리하며 VPN 설치 자체는 이 기능의 구현 범위에서 분리한다.',
 ['서로 다른 인터넷 회선의 두 PC에서 VPN 경유 접속','VPN을 사용해도 앱의 장치 인증과 입력 승인이 유지'],['F25','F28'],'transport / UI','사용자가 선택한 개인 VPN','VPN 제품 선정·가입은 별도 결정이다.')
add('F32','M4','자체 rendezvous·STUN·직접 연결 시도','VPN 없이 두 장치의 접속 후보를 교환한다.',
 '최소한의 장치 인증·후보 교환 서버와 STUN 탐색을 설계한다. UDP punch 후 같은 신뢰 모델의 QUIC을 연결한다. UPnP는 선택 가능한 보조 수단이다.',
 ['같은 NAT·다른 NAT·직접 연결 실패 사례를 구별','성공률을 실제 시험한 네트워크 표본과 함께 기록'],['F28','F31'],'optional-server / transport','표준 STUN/ICE 라이브러리는 선정 단계에서 검증')
add('F33','M4','암호화 유지 relay fallback','직접 연결이 불가능할 때 중계 경로를 제공한다.',
 '개인 relay에 UDP datagram을 투명 중계하여 end-to-end QUIC 인증을 유지한다. token·세션 만료·트래픽 quota를 두고 미디어 평문을 relay에서 처리하지 않는다.',
 ['직접 UDP가 안 되는 시험 환경에서 relay 연결','relay 과금 가능 트래픽과 접속 오류 표시'],['F32'],'optional-server / relay','별도 소형 Rust relay','TCP/TLS-only 네트워크 대응은 지연 특성이 다른 추가 설계다.')

add('F34','M5','AMD AMF·Intel VPL 인코더','다른 GPU에서도 같은 프로그램을 사용한다.',
 'VideoEncoder 수명 계약에 AMF/VPL backend를 추가한다. format·capability·device loss·reconfigure를 backend별로 검증한다.',
 ['AMD·Intel 실제 장치에서 동일한 codec 계약 시험','지원하지 않는 설정이 명확히 거부됨'],['F03','F09','F27'],'codec','AMF·VPL 공식 API','현재 RTX 3070만으로 합격 판정할 수 없다.')
add('F35','M5','고해상도·고주사율·HEVC·HDR','작업 환경에 따라 해상도와 색 정확도를 확장한다.',
 '4K/120Hz/HEVC/HDR을 각각 capability flag로 협상한다. HDR은 10-bit surface·metadata·색 공간·클라이언트 display 지원을 함께 추가한다.',
 ['각 조합에 대한 encoder/decoder/display 지원 표 작성','HDR→SDR과 unsupported 조합에서 오색상 출력 방지'],['F26','F27','F29'],'codec / renderer','제조사 코덱 API','모든 GPU가 모든 codec·색 형식을 지원하지 않는다.')
add('F36','M5','다중 모니터·동시 스트림','호스트의 여러 화면을 선택하거나 동시에 본다.',
 'stream_id별 capture·codec 상태와 전체 bitrate 예산을 관리한다. 모니터 좌표·DPI·커서 매핑을 화면별로 유지한다.',
 ['배율이 다른 두 모니터의 전환·동시 표시','한 스트림 재설정이 다른 스트림을 종료시키지 않음'],['F20','F26','F27'],'core / capture / UI','기존 pipeline의 stream별 인스턴스')
add('F37','M5','클립보드·파일 전송','개인 작업에 필요한 텍스트와 파일을 주고받는다.',
 '명시적으로 켠 세션에서만 클립보드를 동기화한다. 파일 전송은 미디어와 별도의 reliable stream, 크기/경로 확인, 중단 및 이어받기를 둔다.',
 ['클립보드 echo loop와 임의 경로 덮어쓰기 방지','큰 파일 전송 중 영상 제어가 유지됨'],['F17','F25'],'transfer','Windows clipboard·파일 API')
add('F38','M5','게임패드 전달','클라이언트의 패드 상태를 호스트에 가상 장치로 전달한다.',
 '입력 수집과 virtual gamepad backend를 분리한다. 유지보수 가능한 공개 드라이버 후보를 별도로 선정하고 장치 연결/해제·rumble을 정의한다.',
 ['버튼·축·해제·재연결이 실제 게임에서 동작','driver가 없을 때 다른 입력 기능이 정상 유지'],['F19','F25'],'input::gamepad','공개 driver의 라이선스·서명·유지보수 검토','ViGEm은 종료된 프로젝트다. Parsec VUSB를 그대로 포함하는 계획은 아니다.')
add('F39','M5','헤드리스 가상 디스플레이','모니터가 연결되지 않아도 화면을 제공한다.',
 'IddCx/UMDF 기반 공개 샘플을 출발점으로 별도 가상 디스플레이 모듈을 설계한다. 설치·서명·해제와 실제 display mode 지원을 검증한다.',
 ['물리 모니터 없는 환경에서 캡처 가능','driver 제거·실패 시 Windows 디스플레이 설정 복구'],['F27','F36'],'drivers / platform-win','Microsoft IddSample 등 별도 선정','driver signing/test mode는 실제 개발 시 명시적인 환경 선택이 필요하다.')
add('F40','M5','로그인 전 서비스·자동 접속','사용자 로그인 수명과 분리된 개인 호스트 실행을 지원한다.',
 '일반 사용자 host를 먼저 안정화한 뒤 service broker를 분리한다. session 0에서 캡처하지 않고 활성 사용자 session agent를 실행하며 IPC ACL을 제한한다.',
 ['로그인·로그아웃·사용자 전환에서 agent 중복 없음','일반 입력 권한을 넘어서는 동작은 별도 지원 범위로 명시'],['F19','F27','F28','F30'],'service / host-agent','Windows service/session API')
add('F41','M5','브라우저 클라이언트','설치 없이 브라우저에서 접속할 수 있는 경로를 추가한다.',
 'native QUIC 프로토콜을 브라우저가 바로 읽는다고 가정하지 않는다. WebRTC 기반 별도 backend의 미디어·DTLS/SRTP·입력 채널을 설계한다.',
 ['지원 브라우저의 codec·입력·오디오 제약 표','native 경로와 분리된 end-to-end 상호 운용 시험'],['F32','F33'],'transport::webrtc / web-client','표준 WebRTC 라이브러리 별도 선정','usrsctp만 붙여서 완성되는 기능이 아니다.')
add('F42','M5','USB·펜·웹캠 전달','고급 장치의 이벤트와 미디어를 원격 PC에 전달한다.',
 'USB redirection, pen pressure/tilt, virtual camera를 각각 독립 모듈로 분해한다. 첫 버전 구현 뒤 실제 필요한 장치부터 범위를 좁힌다.',
 ['각 장치별 driver/API·권한·지연 요구사항을 먼저 명세','선택한 실제 장치의 연결·해제·재연결 시험'],['F25','F27','F40'],'virtual-devices','공개 API와 라이선스가 확인된 별도 구현','범위가 크므로 이 항목 선택은 세부 설계부터 시작하는 뜻이다.')
add('F43','M5','선택적 FEC·기한 내 재전송','불안정한 네트워크에서 화면 복구의 품질을 개선한다.',
 'loss 모델을 측정한 뒤 parity/FEC와 제한된 NACK 중 필요한 전략을 추가한다. frame deadline과 GOP 의존성, redundancy의 대역폭 비용을 함께 계산한다.',
 ['같은 loss trace에서 기준 버전보다 freeze 또는 복구 시간이 개선','안정 링크에서 지연·대역폭의 과도한 손실 없음'],['F15','F26','F29'],'transport / core::recovery','검증된 FEC 라이브러리 후보 조사')
add('F44','M5','Sunshine·Moonlight 재사용 타당성 실험','완성된 스트리밍 코드를 활용하는 경로가 시간을 줄이는지 비교한다.',
 '개인용 GPL-3.0 fork 또는 일부 모듈 이식을 검토한다. Windows capture·NVENC·pacing과 Moonlight decode를 비교하며 Rust 이식 시 ABI·출처·변경 파일을 남긴다.',
 ['고정 commit의 원형 build와 두 PC baseline 확보','재사용할 파일·유지할 라이선스·Rust 경계·대체할 F 기능을 명시'],['F02','F03','F05'],'reuse-spike','Sunshine / Moonlight GPL-3.0','선택은 포팅 타당성 실험이다. 기존 전체 프로토콜과 자체 QUIC을 자동 혼합하지 않는다.')
add('F45','M5','RustDesk fork 타당성 실험','Rust 기반 기존 원격 데스크톱을 수정하는 경로를 비교한다.',
 'RustDesk core·capture·input과 Flutter UI의 경계를 조사한다. AGPL 네트워크 이용자 조건과 별도 상용 구성요소를 구분하고 변경 범위를 산정한다.',
 ['오픈소스 판 고정 commit으로 원형 build 검증','자체 Rust 설계와 fork 중 선택할 근거·영향 기능 목록 작성'],['F02','F03','F05'],'reuse-spike','RustDesk / AGPL-3.0','Rust로 작성됐다는 이유로 기존 media pipeline이 목표 latency를 충족한다고 가정하지 않는다.')

extend(add,features)
extend_ui(add,features)
extend_server(add,features)
extend_password(add,features)
settings=catalogue()
ui_audit=json.loads((ROOT/'ui-text-catalog.json').read_text(encoding='utf-8'))
for flow in ui_audit['flows']:
    if flow['id']=='U30':
        flow.update(result='개인용 대체', features=['F80','F81','F82'], finding='원본은 Parsec 계정 로그인 화면이다. 자체 앱은 계정 로그인/MFA를 만들지 않고 접속 대상 PC 비밀번호 입력·실패·재시도 UI로 대체한다.')
    elif flow['id']=='U31':
        flow.update(result='개인용 대체', features=['F06','F82'], finding='계정 재인증/로그아웃 UI는 구현하지 않는다. 장치 등록/해제, 접속 비밀번호 변경, 연결 종료로 대체하며 원본 텍스트는 분석 근거로 보존한다.')
sources=[
 ('implementation','현재 구현과 실행 방법','../IMPLEMENTATION.md','실제 QUIC 비밀번호 CLI·Ubuntu 서버 기반; 영상/GUI/API 통합은 미완료'),
 ('control-server','연결 관리 서버 상세 설계','CONTROL_SERVER.ko.md','F71–F79 · API·DB·권한·WSS·세션·배포·통합 합격'),
 ('home-server','홈서버 운영·VPN·VPS 설명','homeserver-architecture.html','공인 IP·UDP 포트포워딩 환경의 배치·개념·회선 계산'),
 ('ui-audit','전체 UI 텍스트·누락 재검토','UI_TEXT_AUDIT.ko.md','화면별 대응·새 기능·복구 근거·미확인 범위'),
 ('ui-text-evidence','UI 문자열·함수 참조 원본','../analysis/parsec/research/ui/ui-text-evidence.json','전체 후보·호출 지점·loader/installer·PE resource 검사'),
 ('settings-report','설정·Privacy·복구 코드 분석','SETTINGS_AND_RECOVERY.ko.md','139개 등록 레코드·173개 화면별 키·163개 감사 항목'),
 ('settings-evidence','바이너리 설정 추출 근거','../analysis/parsec/research/settings/settings-evidence.json','원본 hash·테이블 주소·타입·기본값·범위·호출 함수'),
 ('acknowledgements','Parsec 공식 공개 의존성 목록','https://parsec.app/acknowledgements','App 12개 · Website/Backend는 개인용 엔진의 필수 구성 목록이 아님'),
 ('analysis','기존 Parsec 심층 분석','../analysis/parsec/OPEN_SOURCE_DEEP_ANALYSIS.ko.md','로컬 정적 분석 · 2026-09-15'),
 ('functions','검토한 함수 38개','../analysis/parsec/research/REVIEWED_FUNCTIONS.md','로컬 함수·공개 소스 대응'),
 ('windows','Rust for Windows','https://github.com/microsoft/windows-rs','Windows API 바인딩 · MIT / Apache-2.0'),
 ('quinn','Quinn','https://github.com/quinn-rs/quinn','Rust QUIC · MIT / Apache-2.0'),
 ('datagram','Quinn Connection API','https://docs.rs/quinn/0.11.12/quinn/struct.Connection.html','DATAGRAM은 비신뢰·비순서, 크기 한도 조회'),
 ('rustls','rustls license','https://github.com/rustls/rustls/blob/main/LICENSE-MIT','실제 채택 버전의 전체 license를 기록'),
 ('nvenc','NVIDIA Video Codec SDK','https://developer.nvidia.com/video-codec-sdk','NVENC·NVDEC API 및 개별 SDK 조건'),
 ('dxgi','Desktop Duplication API','https://learn.microsoft.com/en-us/windows/win32/direct3ddxgi/desktop-dup-api','Windows 캡처 API'),
 ('mf','D3D11 video decoding in Media Foundation','https://learn.microsoft.com/en-us/windows/win32/medfound/supporting-direct3d-11-video-decoding-in-media-foundation','GPU decode 연동'),
 ('opus','Opus COPYING','https://github.com/xiph/opus/blob/main/COPYING','BSD 계열; 배포 시 notice 조건'),
 ('matoya','libmatoya LICENSE','https://github.com/snowcone-ltd/libmatoya/blob/952f2a22bdb4cf832db110c00aa3e57952358eae/LICENSE','MIT; 공개 4.0 소스만 재사용 후보'),
 ('egui','egui','https://github.com/emilk/egui','Rust UI · MIT / Apache-2.0'),
 ('sunshine','Sunshine','https://github.com/LizardByte/Sunshine','host 구현·공식 저장소'),
 ('sunshine-license','Sunshine GPL-3.0','https://github.com/LizardByte/Sunshine/blob/master/LICENSE','§2 비배포 사용·수정; §5–6 전달 조건'),
 ('moonlight','Moonlight Qt','https://github.com/moonlight-stream/moonlight-qt','client 구현·GPL-3.0'),
 ('moonlight-license','Moonlight LICENSE','https://github.com/moonlight-stream/moonlight-qt/blob/master/LICENSE','저장소 license 원문'),
 ('rustdesk','RustDesk','https://github.com/rustdesk/rustdesk','Rust core·Flutter UI'),
 ('agpl','RustDesk AGPL-3.0','https://github.com/rustdesk/rustdesk/blob/master/LICENCE','§13 수정본의 원격 네트워크 이용자 소스 제공 조건'),
 ('parsec-terms','Parsec / Unity Cloud 약관','https://unity.com/legal/cloud-terms-of-service','2026-06-30 갱신; 개인 사용이 전용 코드 재사용 허락이라는 뜻은 아님'),
 ('vigem','ViGEmBus','https://github.com/nefarius/ViGEmBus','프로젝트 종료·archive 상태'),
]
sources += [(w['id'],{'advanced':'공식 고급 설정','windows':'Windows 앱 설정','privacy':'Privacy Mode','vdd':'VDD 개요','vdd-advanced':'VDD 고급 설정'}[w['id']],w['url'],'공식 설정 자료; 설치본과 버전 차이를 구분') for w in settings['sources']]

plan=dict(schemaVersion=1,planVersion='2026-09-20.5',compatiblePlanVersions=['2026-09-20.4','2026-09-20.3','2026-09-20.2','2026-09-20.1'],title='notParsec · Rust 개발 설계',
    assumptions=['개인 소유·관리 Windows x64 PC 두 대','호스트 GPU: 로컬 조회에서 NVIDIA GeForce RTX 3070 확인','클라이언트 GPU·Windows 버전은 M0 진단에서 확정','비공개·비배포·개인 용도, 동시 세션 1개','초기 목표: 1080p60 SDR / H.264 / stereo / 키보드·마우스','자체 host/client 프로토콜; Parsec 서버 호환은 목표에 포함하지 않음'],
    phases=[dict(id=i,title=t,description=d) for i,t,d in phases],features=features,settings=settings,uiAudit=ui_audit,
    uiNewFeatureIds=[f'F{i}' for i in range(64,71)],serverPlan=server_catalogue(),
    accessPolicy=dict(userAccounts=False,passwordRequired=True,passwordOwner='접속 대상 PC (host)',controlServerOS='Ubuntu',featureIds=['F80','F81','F82']),
    defaultSelected=[f['id'] for f in features if f['phase'] in ('M0','M1','M2')],
    sources=[dict(id=i,title=t,url=u,note=n,checked='2026-09-20') for i,t,u,n in sources])
extend_parity(plan)
ROOT.mkdir(exist_ok=True)
(ROOT/'plan-data.json').write_text(json.dumps(plan,ensure_ascii=False,indent=2),encoding='utf-8')
print(f'{len(features)} features, {len(plan["defaultSelected"])} default selected')