notParsec / 문서전체 문서

데이터·검증 자료

portway/standards-research.json

design/portway/standards-research.json

출처: N3M Tunnels 공개 문서 snapshot · 원문 다운로드

{
  "researched_on": "2026-10-04 Asia/Seoul",
  "purpose": "N3M Tunnels 한국어 HTML 계획서의 항공우주 기술문서 작성 원칙 및 기술 근거",
  "recommended_claim": "S1000D의 모듈·식별·개정·적용성 관리 개념과 NASA 요구사항 추적·검증 방법을 프로젝트 규모에 맞춰 적용한 기술계획서. 한국어 문체에는 ASD-STE100의 명료성 원칙을 참고한다.",
  "compliance_boundary": "현재 산출물은 한국어 HTML 및 구조화 원천 데이터다. S1000D Issue 6 XML 스키마·프로젝트 BREX에 대한 적합성 검증, 정식 CSDB 교환, 정식 IETP 적합성 검증 또는 항공 인증을 수행한 결과가 아니다. 영어 통제언어 표준 ASD-STE100의 한국어 적합성을 주장하지 않는다.",
  "sources": [
    {
      "id": "STD-01",
      "title": "S1000D Issue 6 공식 배포 구성",
      "url": "https://users.s1000d.org/ProductDescription.aspx?ProductID=35",
      "facts": "공식 페이지가 Issue 6을 Current Issue로 표시하며 Issue 6.A patch, XML schema package, Business Rules Template, Default BREX 등을 포함한다. Bike 예제를 처리할 수 있다는 사실만으로 적합성이 입증되지 않는다고 명시한다.",
      "use": "참조 판본 Issue 6 및 6.A patch를 명시하되 완전 준수는 별도 검증 대상으로 둔다."
    },
    {
      "id": "STD-02",
      "title": "S1000D Getting Started — 데이터 모듈 및 CSDB",
      "url": "https://s1000d.org/?page_id=2",
      "facts": "데이터 모듈은 독립 정보 단위이며 식별·상태 부분과 내용 부분으로 구성한다. 식별·상태 정보는 관리, 적용성, 품질보증, 검색에 사용한다. XML 모듈을 CSDB에 관리하며 S1000D는 CSDB의 구체적 기능을 정의하지 않는다.",
      "use": "모듈별 식별번호, 개정, 상태, 적용 대상, 출처, 본문을 관리하고 동일 원천에서 HTML을 생성한다. 프로젝트 식별번호를 공식 S1000D DMC라고 부르지 않는다."
    },
    {
      "id": "STD-03",
      "title": "ASD-STE100 공식 소개 및 현재 판본",
      "url": "https://www.asd-ste100.org/about_STE.html",
      "facts": "ASD-STE100은 영어 기술문서 독자의 이해를 돕는 통제 자연언어 표준이다. Issue 9 발표일은 2025-01-15다.",
      "use": "한국어에는 한 문장 한 의미, 같은 개념 같은 용어, 행위자·조건·행위·결과 분리 등 프로젝트 작성규칙을 만든다. STE 영어 어휘/문법 준수로 표시하지 않는다.",
      "access_note": "공식 검색 결과의 본문으로 확인. 직접 열기는 도구에서 실패함."
    },
    {
      "id": "STD-04",
      "title": "ASD-STE100 Downloads — Issue 9",
      "url": "https://www.asd-ste100.org/STE_downloads.html",
      "facts": "현재 공식 사본 요청 대상은 Issue 9, January 2025로 표시된다. AI 산출물이 그럴듯하다는 사실과 검증된 표준 적합성은 구분해야 한다는 안내가 있다.",
      "use": "영문 매뉴얼을 추가할 때 정식 표준 사본과 검토 절차를 마련한다.",
      "access_note": "공식 검색 결과의 본문으로 확인. 직접 열기는 도구에서 실패함."
    },
    {
      "id": "STD-05",
      "title": "NASA Systems Engineering Handbook Appendix D — Requirements Verification Matrix",
      "url": "https://www.nasa.gov/reference/appendix-d-requirements-verification-matrix/",
      "facts": "요구사항 작성 시 검증 방법을 식별한다. 검증 매트릭스의 각 shall 요구사항에는 고유 식별자와 출처가 필요하다.",
      "use": "요구사항마다 출처, 책임 모듈, 시험 ID, 판정 기준, 결과/증빙을 연결한다. 제안·보류 항목은 승인된 필수 요구사항과 구분한다."
    },
    {
      "id": "STD-06",
      "title": "NASA Systems Engineering Handbook Appendix I — V&V Plan Outline",
      "url": "https://www.nasa.gov/reference/appendix-i-verification-and-validation-plan-outline/",
      "facts": "요구사항 양방향 추적, 시스템/하위 요소 아키텍처, 검증·확인 책임, 분석·검사·시연·시험, 통합 단계별 검증 및 결과 관리의 개요를 제공한다. verification은 요구사항 충족, validation은 고객 기대 충족을 다룬다.",
      "use": "V 형태의 단계 대응도는 이 프로젝트의 자체 적용 도식으로 표시한다. 사용자 시나리오↔실사용 확인, 시스템 요구↔종단 시험, 인터페이스↔통합 시험, 모듈 설계↔단위 시험을 연결한다."
    },
    {
      "id": "TECH-01",
      "title": "Microsoft — Deprecated features for Windows client",
      "url": "https://learn.microsoft.com/en-us/windows/whats-new/deprecated-features",
      "facts": "Webclient (WebDAV) Service는 2023년 11월 deprecated 항목이며 기본 시작되지 않는다고 명시한다. Deprecated는 더 이상 능동 개발하지 않고 미래 제거 가능성이 있다는 뜻이며 이미 제거됐다는 뜻은 아니다.",
      "use": "향후 Explorer 네트워크 드라이브를 기본 WebDAV만으로 보장하지 않는다. 대상 Windows 빌드 시험과 대체 마운트 기술 비교를 계획한다."
    },
    {
      "id": "TECH-02",
      "title": "Microsoft — Using the WebDAV Redirector",
      "url": "https://learn.microsoft.com/en-us/iis/publish/using-webdav/using-the-webdav-redirector",
      "facts": "문서상 WebDAV 드라이브 매핑은 WebClient에 의존한다. FileSizeLimitInBytes 기본값은 50,000,000 bytes, BasicAuthLevel 기본값 1은 SSL 웹사이트에만 Basic 인증을 허용한다. 문서의 적용 예시는 Vista/7/8 및 Server 2008/2012 시기이며 마지막 갱신은 2022-08-23다.",
      "use": "50 MB를 모든 최신 Windows에서 실측된 한계로 쓰지 말고 기존 구현의 호환성 검증 항목으로 기록한다. 레지스트리 완화를 기본 설치 절차로 제안하지 않는다."
    },
    {
      "id": "TECH-03",
      "title": "RFC 9110 — HTTP Semantics",
      "url": "https://www.rfc-editor.org/rfc/rfc9110.html",
      "facts": "Range, If-Range, ETag와 206 응답으로 부분 전송을 다룬다. If-Range 검증자가 다르면 전체 새 표현을 전송하는 의미이며 약한 ETag는 If-Range에 사용할 수 없다.",
      "use": "다운로드 재개 시 파일 변동 여부를 검증하고 다른 버전의 바이트를 합치지 않도록 시험한다."
    },
    {
      "id": "TECH-04",
      "title": "tus resumable upload protocol 1.0.0",
      "url": "https://tus.io/protocols/resumable-upload",
      "facts": "HTTP 기반 재개 가능한 업로드 프로토콜. HEAD로 Upload-Offset을 확인하고 PATCH로 남은 바이트를 전송한다. 인증과 권한 부여는 서버 구현 책임이다.",
      "use": "웹 업로드 재개 후보. 서버/에이전트가 오프셋을 영속 관리하며 인증·루트 제한·할당량·원자적 파일 확정은 별도 설계한다."
    },
    {
      "id": "TECH-05",
      "title": "RFC 6455 — WebSocket Protocol",
      "url": "https://www.rfc-editor.org/rfc/rfc6455.html",
      "facts": "WebSocket은 양방향 통신이며 wss는 TLS를 사용한다. 일반적으로 TLS WebSocket은 443을 사용한다. 특정 클라이언트 인증 방식은 프로토콜이 정하지 않는다.",
      "use": "에이전트의 외부로 시작하는 TLS 연결 후보 근거다. 네트워크 정책 우회를 보장하는 근거가 아니며 프록시/단절/재연결을 시험한다."
    },
    {
      "id": "TECH-06",
      "title": "Tokio 공식 튜토리얼",
      "url": "https://tokio.rs/tokio/tutorial"
    },
    {
      "id": "TECH-07",
      "title": "axum WebSocket API",
      "url": "https://docs.rs/axum/latest/axum/extract/ws/"
    },
    {
      "id": "TECH-08",
      "title": "Nginx WebSocket proxying",
      "url": "https://nginx.org/en/docs/http/websocket.html"
    },
    {
      "id": "TECH-09",
      "title": "Nginx proxy buffering",
      "url": "https://nginx.org/en/docs/http/ngx_http_proxy_module.html"
    },
    {
      "id": "TECH-10",
      "title": "Microsoft reparse points",
      "url": "https://learn.microsoft.com/en-us/windows/win32/fileio/reparse-points-and-file-operations"
    },
    {
      "id": "TECH-11",
      "title": "Microsoft CreateFile",
      "url": "https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilea"
    },
    {
      "id": "TECH-12",
      "title": "OWASP WebSocket security",
      "url": "https://cheatsheetseries.owasp.org/cheatsheets/WebSocket_Security_Cheat_Sheet.html"
    },
    {
      "id": "TECH-13",
      "title": "OWASP File Upload",
      "url": "https://cheatsheetseries.owasp.org/cheatsheets/File_Upload_Cheat_Sheet.html"
    },
    {
      "id": "TECH-14",
      "title": "Microsoft Windows credential handling",
      "url": "https://learn.microsoft.com/en-us/windows/win32/secbp/handling-passwords"
    },
    {
      "id": "ADM-SRC-01",
      "title": "Cloudflare Tunnel — Observability",
      "url": "https://developers.cloudflare.com/tunnel/observability/",
      "facts": "2026-10-04 확인. 관리 화면은 Healthy/Inactive/Down/Degraded 상태를 구분한다. 이 상태는 cloudflared와 Cloudflare 네트워크 사이 연결만 설명하며, Healthy여도 내부 서비스가 응답하지 않을 수 있다. 대시보드 Live logs와 원격 로그 스트리밍, 커넥터별 필터, 이벤트 종류·심각도·샘플링 필터를 제공한다.",
      "use": "설계 제안: 중앙 목록에 모든 터널의 소유자·주소·호스트·공유명·권한·만료·최근 신호·연결 상태를 표시한다. 터널 연결 상태와 폴더 접근/파일 서비스 상태를 분리하고 마지막 관측 시간을 표시한다. Cloudflare의 4개 연결 구조·상태명을 N3M Tunnels 사양으로 복사하지 않는다. agent.connection 이벤트에는 agent_id, connection_id, 연결·재연결·종료 시각과 이유를 저장한다. 관리자 중지/재개/만료 연장/정책 변경은 별도 audit 이벤트에 수행자·변경 전후·결과를 기록한다. 이 사건 분류와 관리 동작은 N3M Tunnels 제안이며 인용 제품과 동일 구현이라는 뜻이 아니다."
    },
    {
      "id": "ADM-SRC-02",
      "title": "Cloudflare — Restoring original visitor IPs",
      "url": "https://developers.cloudflare.com/support/troubleshooting/restoring-visitor-ips/restoring-original-visitor-ips/",
      "facts": "2026-10-04 확인. Cloudflare 프록시 뒤의 원본 서버는 기본적으로 Cloudflare IP를 관측한다. CF-Connecting-IP로 방문자 IP를 복원할 수 있지만 공식 예시는 신뢰할 프록시 주소를 지정하며, Cloudflare 주소에서 오는 트래픽만 수락하지 않으면 헤더가 위조될 수 있다고 명시한다. Pseudo IPv4 설정에 따라 원 IPv6는 CF-Connecting-IPv6에 보존될 수 있다.",
      "use": "설계 제안: 즉시 연결 상대인 peer_ip와 검증한 client_ip를 구분한다. 직접 접속에서는 전달 IP 헤더를 신뢰하지 않는다. 등록한 프록시 경로에서만 해당 헤더를 파싱하고, 자체 릴레이는 외부의 동일 이름 헤더를 제거·재작성한다. 프록시가 여러 개인 경우 검증한 홉 체인만 사용하며 X-Forwarded-For의 첫 값만 무조건 채택하지 않는다. ip_source와 trusted_proxy_chain을 기록하고 내부 전달 메타데이터는 인증된 채널로 전송한다. 위조 헤더·직접 원본 접근·IPv6·프록시 누락을 검증 항목에 추가한다. IP는 인증 사용자 신원을 대체하지 않는다."
    },
    {
      "id": "ADM-SRC-03",
      "title": "ngrok — Traffic Inspector",
      "url": "https://ngrok.com/docs/obs/traffic-inspection",
      "facts": "2026-10-04 확인. ngrok은 로컬 에이전트 검사 화면과 중앙 대시보드 Traffic Inspector를 구분한다. 중앙 화면은 검색과 보관 기능을 제공한다. 기본은 요청·응답 메타데이터 저장이며, 요청·응답 파라미터·헤더·본문 전체 캡처는 별도 활성화한다. 전체 캡처에는 크기 제한과 잘림이 있고 민감한 데이터가 포함될 수 있다.",
      "use": "설계 제안: N3M Tunnels는 중앙 요청 조회를 기본 기능으로 계획한다. request_id/tunnel_id/actor_id/시각/메서드/정규화 경로/결과/상태코드/수신·송신 바이트/지연/client_ip/분석된 User-Agent를 필터·검색한다. HTTP request와 논리적인 파일 transfer는 구분한다. 재개 업로드·Range 다운로드는 여러 request_id를 한 transfer_id로 연결하며 실제 완료·취소·실패 상태를 별도로 기록한다. 요청 수를 접속자 수 또는 파일 개수로 표시하지 않는다. 파일 본문·인증값·쿠키·비밀 query는 기본 수집에서 제외하고, 경로도 권한별 마스킹한다. 원문 캡처/재전송 기능은 이번 요구로 자동 추가하지 않는다. 보관기간·내보내기·로그 조회 권한·접근 감사는 N3M Tunnels의 독립 정책으로 정한다."
    },
    {
      "id": "ADM-SRC-04",
      "title": "Cloudflare Logs — HTTP requests dataset",
      "url": "https://developers.cloudflare.com/logs/logpush/logpush-job/datasets/zone/http_requests/",
      "facts": "2026-10-04 확인. HTTP 요청 데이터는 ClientIP/국가/도시/ASN, 요청 메서드·경로·User-Agent, EdgeResponseStatus, OriginResponseStatus, RayID 및 보안 동작 등을 별도 필드로 제공한다. OriginResponseStatus=0은 원본 응답을 받지 않고 edge가 응답한 경우 등을 나타내며, 그 값만으로 오류 여부를 판단할 수 없다. 헤더 수집은 별도 설정 필드다.",
      "use": "설계상 추론: N3M Tunnels 릴레이·에이전트 로그만으로 외부 CDN/WAF에서 차단되거나 TLS/DNS 단계에서 끝난 시도를 모두 관측할 수 없다. 요청 로그에 관측 지점(edge/relay/agent), correlation_id, origin_reached, failure_stage를 두고 edge 로그 연동 여부·수집 지연·보관 범위·누락/샘플링 여부를 표시한다. edge 연동 전에는 '릴레이에 도달한 요청 기준'으로 화면 범위를 설명한다. edge 미수집 상태의 0건을 '접속 시도 없음'으로 단정하지 않는다. edge 응답과 원본 응답을 분리해 자체 차단·권한 거부·터널 단절·파일 읽기 실패를 구분하고 내부 하위 요청을 방문자 요청으로 중복 집계하지 않는다."
    },
    {
      "id": "ADM-SRC-05",
      "title": "MaxMind — Geolocation accuracy",
      "url": "https://support.maxmind.com/knowledge-base/articles/maxmind-geolocation-accuracy",
      "facts": "2026-10-04 확인. IP 지리위치 정확도는 국가·네트워크·IPv4/IPv6·ISP 등에 따라 달라지고 100%를 보장하지 않는다. 특정 개인·가구·도로 주소를 확인할 만큼 정밀하지 않다. VPN/프록시에서는 사용자가 아닌 중계 서버의 위치가 나타날 수 있다. 도시 정보가 없을 때 더 넓은 지역 정보로 대체하고, 도시 데이터의 정확도 반경을 고려하도록 안내한다.",
      "use": "설계 제안: '어디서 접근'은 관측 IP·추정 국가/지역·도시·ASN/네트워크·클라이언트 표시와 인증 사용자 식별자를 함께 제공한다. 위치에는 'IP 기반 추정'을 표시하고 상세 지역이 없으면 미확인 또는 국가 수준으로 표시한다. 데이터 제공자·DB 판본/조회 시각·가능한 정확도 반경을 보존한다. 지도는 확정된 개인 위치나 GPS 핀으로 표현하지 않는다. 국가별 통계의 미확인 항목을 누락하지 않으며, 위치 정보만으로 사용자 신원이나 정확한 체류 장소를 결론짓지 않는다."
    },
    {
      "id": "ADDR-SRC-01",
      "title": "ngrok — How does ngrok's Gateway work?",
      "url": "https://ngrok.com/docs/gateway/how-it-works",
      "facts": "2026-10-04 확인. ngrok cloud는 endpoint URL로 인터넷 요청을 받는다. 서비스 옆의 agent가 cloud로 안전한 외부 방향의 지속 TLS 연결을 만들고, endpoint로 받은 트래픽을 그 연결을 통해 agent와 로컬 서비스로 전달한다. 이 문서는 임시 이름의 생성 알고리즘이나 실행마다 주소가 바뀐다는 정책을 정하지 않는다.",
      "use": "N3M Tunnels 설계 제안: Windows에서 폴더를 지정하면 agent가 관리 서버에 인증하고 relay로 외부 연결을 만든다. 서버는 사용 가능한 이름을 임대하고 hostname→tunnel_id→활성 agent 연결 매핑을 등록한 뒤 URL을 반환한다. 외부 브라우저의 요청은 릴레이에 도착하고 Host/:authority의 정규화된 이름으로 매핑을 찾은 뒤 권한을 검사해 연결된 agent로 전달한다. Windows 공인 IP를 주소에 등록할 필요는 없으나 agent의 외부 통신은 허용돼야 한다. 신규 임시 이름, 충돌 검사, 만료/폐기, 같은 세션 재연결, 예약 별칭은 N3M Tunnels 자체 정책으로 표시한다. ngrok의 플랜·주소 수명 정책을 그대로 따른다고 서술하지 않는다."
    },
    {
      "id": "ADDR-SRC-02",
      "title": "Cloudflare DNS — Wildcard DNS records",
      "url": "https://developers.cloudflare.com/dns/manage-dns-records/reference/wildcard-dns-records/",
      "facts": "2026-10-04 확인. wildcard DNS는 많은 하위 이름을 같은 자원으로 해석하도록 설정할 수 있다. 정확한 이름의 레코드나 위임 등이 있으면 wildcard보다 우선한다. DNS wildcard의 일치는 TLS 인증서 wildcard와 동일한 한 단계 규칙이 아니며 구체적인 기존 레코드에 영향을 받는다.",
      "use": "N3M Tunnels 설계 제안: 운영자가 관리하는 share.example.com 하위에 *.share.example.com을 미리 공인 릴레이/로드밸런서로 연결한다. a7k9.share.example.com과 team.share.example.com 모두 같은 입구에 도착하고, 관리 서버의 주소 임대와 릴레이 라우팅 등록이 실제 공유를 구분한다. 이 전제에서는 주소 발급마다 도메인을 구매하거나 개별 DNS 레코드를 추가하지 않는다. wildcard DNS에 이름이 해석돼도 미등록·만료 이름에는 공유를 제공하지 않는다. 하위 경로 방식 https://files.example.com/s/a7k9는 DNS wildcard 없이도 가능하며, 이는 사용자 주소 형식 선택이다."
    },
    {
      "id": "ADDR-SRC-03",
      "title": "Let's Encrypt — Challenge Types, DNS-01",
      "url": "https://letsencrypt.org/docs/challenge-types/",
      "facts": "2026-10-04 확인. DNS-01은 _acme-challenge 아래 TXT 값으로 도메인 DNS 제어권을 검증하며 wildcard 인증서 발급을 지원한다. HTTP-01으로는 wildcard 인증서를 발급하지 않는다. 발급과 갱신 자동화에 DNS API 등을 사용할 수 있고, DNS 자격증명은 좁은 권한이나 별도 검증 서버로 보호하도록 안내한다.",
      "use": "N3M Tunnels 설계 제안: 운영자가 미리 *.share.example.com 인증서를 발급·설치하고 유효하게 자동 갱신한다. 그 인증서 범위 안에서 공유 이름만 추가할 때는 공유마다 인증서를 새로 발급하지 않는다. 이는 관리 도메인·DNS 제어권·인증서·TLS 종료 릴레이가 준비돼 있다는 전제다. 키를 Windows agent에 배포할 필요 없이 릴레이가 브라우저 TLS를 종료하고 agent 연결은 별도 TLS로 보호한다. 외부 사용자 소유 도메인 연결은 별도의 소유권 확인·DNS·인증서 수명 관리가 필요하다."
    },
    {
      "id": "ADDR-SRC-04",
      "title": "IETF RFC 9525 — Service Identity in TLS, Section 6.3",
      "url": "https://www.rfc-editor.org/rfc/rfc9525.html#section-6.3",
      "facts": "TLS 인증서의 wildcard는 왼쪽 끝의 한 레이블 전체여야 하며 정확히 한 레이블에만 일치한다. RFC는 이 일치 규칙을 DNS wildcard 동작과 혼동하지 말라고 구분한다. 따라서 *.share.example.com은 a7k9.share.example.com을 커버하지만 a.b.share.example.com과 share.example.com 자체에는 일치하지 않는다.",
      "use": "N3M Tunnels 설계 제안: 임시 이름과 지정 별칭은 share.example.com 바로 아래의 단일 레이블로 제한한다. apex나 다단계 이름이 필요해지면 별도 SAN/인증서 설계를 적용한다. wildcard 인증서는 연결 상대의 이름을 검증하는 수단이며, 공유가 존재하는지·누가 접근 가능한지·어느 agent로 보낼지는 중앙 임대 기록과 릴레이가 별도로 결정한다. DNS가 해석되거나 인증서가 유효하다는 이유만으로 공유 접근을 허용하지 않는다."
    }
  ],
  "application_matrix": [
    {
      "principle": "독립 정보 모듈",
      "reference": "STD-02",
      "implementation": "개요, 운용, 요구사항, 아키텍처, 인터페이스, 검증, 장애대응 모듈에 고정 ID",
      "limit": "자체 모듈 코드, S1000D DMC 아님"
    },
    {
      "principle": "식별·상태·개정·적용성",
      "reference": "STD-02",
      "implementation": "문서 ID/개정/언어/발행일/수정사유/소유자/대상 버전/검토 상태",
      "limit": "현재 문서는 계획 초안, 제품 구현과 검증은 별도"
    },
    {
      "principle": "공통 원천 및 업무 규칙",
      "reference": "STD-01, STD-02",
      "implementation": "구조화 카탈로그+상태+템플릿에서 HTML 재생성, ID·참조·상태 검증",
      "limit": "프로젝트 작성 규칙이며 정식 CSDB/BREX XML 구현 아님"
    },
    {
      "principle": "통제된 문체",
      "reference": "STD-03, STD-04",
      "implementation": "짧은 문장·일관된 용어·동작 단위 단계·전제/결과 표시",
      "limit": "한국어 작성 규칙, ASD-STE100 준수 주장 안 함"
    },
    {
      "principle": "요구사항 추적성",
      "reference": "STD-05",
      "implementation": "사용자 필요→요구사항 ID→구성요소→시험→증빙을 양방향 연결",
      "limit": "제안은 제안으로 보존, 자동 완료 처리 금지"
    },
    {
      "principle": "검증/실사용 확인 분리",
      "reference": "STD-06",
      "implementation": "분석 A/검사 I/시연 D/시험 T, 외부망 실사용 시나리오 별도",
      "limit": "NASA 자체 사업 요구사항이나 항공 인증 부여 아님"
    }
  ],
  "suggested_document_metadata": {
    "document_id": "PW-PLAN-001",
    "revision": "001-04",
    "status": "확정 명칭 반영 · 제품 부분 구현",
    "language": "ko-KR",
    "issued_on": "2026-10-05",
    "applicability": "N3M Tunnels 웹 우선 단계; Windows 호스트/브라우저 사용자; Linux 중앙 서버 후보",
    "responsible_owner": "프로젝트 소유자",
    "approval": "미승인 기술 제안 포함",
    "classification": "외부 공개 가능한 계획 정보",
    "source_of_truth": "프로젝트 카탈로그·상태 원천 데이터",
    "change_reason": "N3M Tunnels 명칭·콘솔 표기·tunnels.n3m.kr과 호환 식별자 반영"
  },
  "suggested_module_order": [
    "문서통제: 식별·개정·적용성·변경표·참조 판본",
    "프로젝트 개요와 사용자 운용 개념(CONOPS)",
    "범위와 단계: 웹 우선 / 네트워크 드라이브 후속 / notparsec 통합 선택",
    "요구사항 및 구현 현황: 필터·상태·의존성·담당·검증 근거",
    "시스템 구조: 경계·책임·신뢰영역·제어/파일 데이터 흐름",
    "인터페이스 계약: CLI·관리 API·터널·파일 API·상태기계",
    "기술 선택과 결정 기록: 근거·대안·제약·미확정 항목",
    "개발 단계와 종료 기준: 시제품·웹 MVP·운영·드라이브·선택 통합",
    "검증 계획과 요구사항 추적 매트릭스",
    "위험·장애대응·운영절차·공개 범위·용어·출처"
  ],
  "suggested_diagrams": [
    "CONOPS: Windows 폴더→CLI→URL 발급→외부 브라우저→다운로드/업로드→종료",
    "배치도: Windows NAT 경계 / 공인 TLS 릴레이 / 관리서버·DB / 외부 클라이언트",
    "시퀀스: 에이전트 로그인·외부 연결·주소 예약·파일 요청·스트리밍·취소",
    "상태기계: 로컬 준비→인증→접속→게시→재연결→폐기/만료",
    "데이터 흐름: 파일 내용과 관리 메타데이터 및 인증 경계",
    "V 매핑: 사용자 시나리오↔실사용 확인, 요구↔종단 시험, 계약↔통합 시험",
    "단계 의존성: 웹 MVP 이후 드라이브 검증과 선택적 notparsec 연동",
    "선택 통합: 독립 identity/provider adapter와 감사 이벤트 연결, 파일/세션 모델 직접 결합 방지"
  ],
  "writing_rules": [
    "필수 요구는 '시스템은 [조건]에서 [측정 가능한 결과]를 제공해야 한다'로 쓰고 하나의 ID에는 하나의 판정 가능한 요구를 둔다.",
    "검증 전 성능 숫자는 제안 목표로 표시한다. 구현 상태와 기술 결정 상태를 분리한다.",
    "상태는 미착수/진행/구현/검증완료/보류/차단처럼 정의하고 검증완료에는 시험일·환경·증빙을 요구한다.",
    "사용자 요구/설계 제안/표준 사실/미확인 사항을 명시한다.",
    "제품 동작이 아직 없으므로 계획서 작성 완료를 제품 기능 완료로 집계하지 않는다.",
    "경고·주의는 실제 데이터 유실·노출 위험이 있는 절차에만 붙이고 위험과 예방 행동을 구체적으로 쓴다.",
    "절차 모듈은 목적·전제·입력·단계·예상 결과·실패 시 복구를 동일한 순서로 쓴다."
  ],
  "naming_decision": {
    "id": "ADR-08",
    "date": "2026-10-05 Asia/Seoul",
    "service_name": "N3M Tunnels",
    "console_label": "Tunnels",
    "public_domain": "tunnels.n3m.kr",
    "plural_service": "Tunnels",
    "singular_entity": "tunnel",
    "terms": {
      "Share": "공유 대상 폴더와 권한",
      "Agent": "로컬 PC에서 서버 연결을 여는 프로그램",
      "Endpoint": "공개 접속 주소",
      "Session": "인증된 접근 또는 연결의 수명"
    },
    "rationale": "서비스와 관리 메뉴는 여러 터널을 다루므로 복수형 Tunnels를 사용한다. 파일 공유와 드라이브 연결은 각각 현재 용도와 후속 기능으로 구분한다.",
    "prior_research_refs": [
      "ADM-SRC-01",
      "ADDR-SRC-01"
    ],
    "scope": "프로젝트 명칭 결정이며 기존 제품의 구현/프로토콜/상표 사용 허가를 의미하지 않는다."
  },
  "research_history_note": "researched_on과 sources의 사실·조회일은 2026-10-04 조사 기록이다. 현재 명칭은 2026-10-05 naming_decision을 따른다. suggested_module_order·suggested_diagrams는 조사 당시 제안으로, 현행 범위는 요구 카탈로그와 계획 본문이 우선한다."
}