# 기기 관리 콘솔 · Tailscale 시각 규칙 적용 작성일: 2026-09-26. 범위는 [웹 기기 관리 페이지](https://remote.n3m.kr/)다. 사용자가 제공한 Tailscale 콘솔 화면, 계산된 CSS, HTML DOM을 먼저 분석하고 notParsec의 기존 관리 기능에 시각 규칙을 적용했다. Tailscale의 제품 기능이나 계정 체계, 네트워크 프로토콜을 도입한 작업은 아니다. ## 1. 근거와 적용 범위 | 자료 | 관찰한 내용 | 한계 | |---|---|---| | 첨부 PNG, 2860 × 1359 | 밝은 고정 사이드바, 열린 본문, 검색 도구막대, 평평한 기기 표, 상태 점, 행 메뉴, 하단 설치 안내 | 화면 크기는 이미지 픽셀이다. CSS 너비·배율과 같다고 단정하지 않았다. | | 첨부 계산 스타일 | 중성·파랑·초록·위험 색상 토큰, 글꼴 목록, 기본 14px 글자 크기, 그림자, light 색상 체계 | 첨부 시점의 계산 결과다. 다른 테마·버전을 추정하지 않았다. | | 첨부 HTML DOM | `w-60` 사이드바, `h-14` 브랜드 줄, `h-9` 버튼, 본문 `lg:pt-8 lg:px-10`, 표와 설치 패널의 구조 | 일부 클래스의 실제 스타일 정의는 첨부에 없다. 이름과 화면을 함께 대조했다. | 첨부 파일의 SHA-256과 추출값은 [검증 기록](evidence/admin-console-design.json)에 고정했다. DOM에 보인 1.102.4는 등록된 Tailscale 기기의 앱 버전이며 웹 콘솔 버전으로 사용하지 않았다. 자료에 있던 계정 이메일·기기 이름·주소와 외부 스크립트는 제품에 복사하지 않았다. 이 화면은 자체 Ubuntu 서버 운영을 위한 **E02** 범위다. 사용자가 이번에 직접 요청한 Tailscale 스타일은 이 관리자 웹에만 적용한다. Windows Parsec 150-104a 기준의 데스크톱 앱·플로팅 메뉴·미디어 책임 구조를 바꾸는 근거가 아니다. Parsec 기준 코어 SHA-256은 `8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f`이며, 웹 콘솔을 이 바이너리에서 복원했다고 주장하지 않는다. HTML·CSS·JS는 직접 작성한 notParsec 구현이다. ## 2. 추출한 디자인 규칙 | 항목 | 첨부에서 확인한 규칙 | notParsec 적용 | |---|---|---| | 배경 | 본문 `#ffffff`, 앱 배경 gray-100 `#f7f5f4` | 흰 본문, 따뜻한 회색 사이드바 | | 텍스트 | gray-800 `#232222`, muted gray-500 `#706e6d` | 제목·기기명은 진하게, 보조 설명·ID·갱신 시각은 회색 | | 경계 | gray-200 `#eeebea`, 입력·버튼 gray-300 `#dad6d5` | 표는 행 구분선만 사용, 컨트롤에는 얇은 테두리 | | 주요 동작 | blue-500 `#4b70cc`, hover blue-600 `#3f5db3` | 로그인·등록 승인·앱 다운로드 진입 | | 상태 | green-300 `#1ea672`, 위험 red-600 `#940821` | 온라인은 초록 점+문자, 거절·등록 해제는 위험 색 | | 글자 | Inter 우선 시스템 글꼴, 14px/1.4286, 자간 -.015em | 같은 기본 규칙과 한국어 시스템 대체 글꼴. 외부 폰트 요청 없음 | | 간격 | 4px 배수, 버튼 36px, 표 안팎 여백 분리 | 8/12/16/24/32/40px 간격, 제목 28px, 보조 설명 12–13px | | 탐색 | 고정 왼쪽 탐색, 56px 브랜드 줄, 회색 선택 행 | 데스크톱 240px 사이드바, 중간 너비 208px, 모바일 상단 탐색 | | 표 | 굵은 기기명, 보조 정보, 작은 상태 표시, `…` 행 메뉴 | 카드 목록을 표로 전환. 이름/ID·호스트 허용·연결 상태·관리 | | 아이콘 | 작은 단색 선 아이콘, 색보다 위치·문구로 역할 설명 | 18px, 1.7px 둥근 선의 자체 SVG. 로고·상표 그림은 복제하지 않음 | | 패널 | 6px 컨트롤 곡률, 12px 안내 패널, 작은 그림자 | 로그인·다운로드·행 메뉴만 경계와 제한된 그림자 사용 | 사이드바·색·간격·정보 밀도를 같은 규칙으로 맞췄다. 언어, 사용 가능한 필드, 실제 기능이 달라 픽셀 단위 복제나 동일 제품 화면으로 기록하지 않는다. 첨부되지 않은 모바일 화면은 같은 토큰을 사용해 접근성과 기능 보존을 기준으로 구성했다. ## 3. 기존 기능을 어떻게 배치했나 | notParsec 기능 | 새 위치와 표현 | 보존한 동작 | |---|---|---| | 관리자 로그인 | 탐색 메뉴 없는 독립 로그인 화면, 중앙의 notParsec 로그인 폼 | 관리자 비밀번호 인증, 15분 세션, 메모리 내 토큰 | | 등록 기기 목록 | 본문 첫 기기 표 | 등록 해제 기기는 제외, 5초 주기 갱신 | | 기기 식별 | 굵은 이름 + 접힌 ID | 펼치면 전체 ID를 선택·확인할 수 있음 | | 호스트 접속 허용 | 기기 행의 스위치와 상태 설명 | 기존 hosting API 사용. PC 앱 실행·접속 비밀번호 필요 | | 온라인 상태 | 초록/회색 점과 온라인/오프라인 문자 | 서버의 실제 online 필드 사용. 접속 대기 상태와 구분 | | 등록 해제 | 각 기기의 `…` 펼침 메뉴 | 기존 확인창과 서버 측 키 차단 유지 | | 신규 등록 승인·거절 | 표 아래 승인 대기 영역, 사이드바에 요청 수 | 전체 ID, 만료 시각, 승인 전 확인창 유지 | | 앱 다운로드 | `/#downloads` 별도 화면, 사이드바와 상단 버튼에서 이동 | macOS·Windows·Linux 선택, 실제 게시된 파일명·크기·검증. Linux는 게시 준비 중 | | 설치·다운로드 명령 | 다운로드 / 명령어 탭과 설치 안내 단계 | SHA-256, 명령어 복사, DMG·EXE·기존 tar.gz 안내 유지 | | 문서 | 사이드바 문서 링크 | 기존 `/document` 문서 허브 | | 계정 관리 | 로그인 후 사이드바에서 여는 별도 화면 | 현재 비밀번호 확인 후 변경, 모든 기존 관리자 로그인 해제 | 추가한 검색은 이미 받아온 등록 목록의 **이름·ID를 화면에서 거르는 기능**이다. 서버 검색이나 새 디바이스 속성을 만들지 않는다. 총 기기 수와 검색 결과 수를 구분하며, 승인 요청은 검색어 때문에 숨겨지지 않는다. 최초 디자인 적용 당시 API에는 기기별 OS·앱 버전·IP·소유자·태그가 없었으므로 Tailscale 표의 해당 열을 흉내 내어 채우지 않았다. Network/Apps/Services/DNS/Users/Access controls/Logs/구독/클라우드/컨테이너/내보내기 메뉴도 추가하지 않았다. 원격 접속 자체는 기존 PC 앱에서 수행한다. ## 4. 상호작용과 접근성 - 로그인 전에는 사이드바·탭·기기 페이지 제목을 숨기고 중앙 로그인 폼만 표시한다. 최초 HTML부터 이 상태를 적용해 메뉴가 잠깐 보이지 않는다. 로그인 성공 후 관리 화면을 표시하고, 로그아웃·인증 만료 시 독립 로그인 화면으로 돌아가 목록·다운로드 정보·설치 안내·검색어를 지운다. - 기기 이름은 계속 `textContent`로 생성한다. 이름에 HTML이 들어 있어도 실행하지 않는다. SVG는 고정 경로로 직접 만들고 외부 스크립트나 아이콘 라이브러리를 불러오지 않는다. - 표의 열 제목, 검색 입력의 이름, 스위치 역할과 상태, 전체 ID 펼치기, 관리 메뉴 이름을 보조 기술에 제공한다. 색상만으로 온라인 상태를 구별하지 않는다. - 행 메뉴는 Enter/Space로 열고 Escape로 닫는다. 바깥 클릭으로도 닫힌다. 메뉴 내부에서 Escape를 누르면 해당 기기의 메뉴 버튼으로 포커스를 돌린다. - 동일한 응답이면 5초마다 DOM을 다시 만들지 않는다. 데이터가 변경되어 다시 그릴 때에도 기기 ID를 기준으로 펼침 상태와 가능한 키보드 포커스를 보존한다. - 휴대폰에서는 사이드바를 상단 탐색으로 전환하고, 상태를 기기명 아래로 배치한다. 표·전체 ID·다운로드 명령이 페이지 너비를 밀어내지 않게 한다. - CSP, 로그인 만료 처리, API 인증, 다운로드 무결성 검사, 배포 중 파일 교체 감지, 명령어의 비밀번호 미포함 처리는 유지한다. ## 5. 검증과 비교 결과 첨부 화면의 규칙과 구현 화면을 직접 대조했다. 고정 탐색·따뜻한 중성 색·작은 제목·평평한 표·상태 점·행 메뉴·하단 다운로드 패널을 적용했다. 자체 기능에 맞춰 열과 항목을 바꿨으며, 첨부 화면과 다른 기능 범위를 분명히 남겼다. 별도 임시 DB와 실제 서버를 쓰는 Chromium 시험으로 로그인, 승인·거절·등록 해제, 기기 인증, 온라인, 호스팅 켜기·끄기, 검색, 전체 ID, 키보드 메뉴와 자동 갱신 포커스, 악성 이름의 안전한 표시, 로그아웃을 확인했다. Windows 다운로드와 Mac 양쪽 아키텍처의 인증·해시·파일 교체·명령 복사·OS 선택 회귀도 확인했다. 설치 파일 시험에는 실행하지 않는 임시 파일을 사용했다. 1920px·1280px 데스크톱과 390px 모바일 화면을 캡처하고 가로 넘침과 JS 오류를 확인했다. 실제 Mac Safari·Windows Edge 실기와 스크린 리더 사용성은 별도 미검증이다. 현재 시험은 Parsec 원본 기능 완성이나 Tailscale 모든 화면과의 일치를 의미하지 않는다. F76의 parity는 `different`, 구현은 `partial`을 유지한다. 정확한 실행 결과와 게시 검증은 [검증 기록](evidence/admin-console-design.json)을 따른다. 관리 페이지는 서버에 내장된 HTML·CSS·JS를 빌드해 게시한다. 이 변경으로 PC 앱 바이너리나 다운로드 버전을 교체하지 않는다. ## 6. 변경 파일과 관련 문서 - `apps/control-server/web/admin.html`: 탐색·기기 표·승인·다운로드의 실제 페이지 템플릿. - `apps/control-server/web/admin.css`: 첨부에서 추출한 토큰, 컴포넌트·반응형 규칙. - `apps/control-server/web/admin.js`: 안전한 행 생성, ID·메뉴 펼침, 검색, 갱신 시 포커스 유지. - `scripts/test_admin_browser.cjs`: 기존 기능 회귀에 검색·펼침·키보드·갱신 검증 추가. - [기존 관리자·Computers 설계](ADMIN_AND_COMPUTERS_UI.ko.md): 기존 인증·호스팅 API와 데스크톱 UI 범위. - [다운로드·설치 안내](APP_DOWNLOAD_AND_INSTALL.ko.md), [Mac DMG 설치](MAC_DMG_INSTALL.ko.md). 문서는 Markdown 원본과 검증 JSON, development-status 원장을 수정하고 기존 생성기·게시 경로로 HTML을 만든다. 생성 HTML만 수정하거나 기존 사용자 선택·수동 진행 상태를 덮어쓰지 않는다. ## 후속 · PC 운영체제 정보 같은 날 추가 사용자 요청으로 앱의 실제 OS 정보를 수집하는 기능과 운영체제 열을 구현했다. [수집·표시·호환성·게시 상태](DEVICE_OS_INFORMATION.ko.md)를 따른다. 처음 적용 시점에 없었던 API 정보를 추정해 표시한 것이 아니다. ## 후속 · 독립 로그인 화면 사용자 요청에 따라 로그인 전에는 좌측 메뉴·탭·기기 제목 없이 중앙 로그인 폼만 보여준다. 최초 HTML에 로그인 상태의 레이아웃을 지정해 스크립트 실행 전에도 관리 메뉴가 보이지 않는다. 로그인 성공 시 관리 화면으로 전환하며, 로그아웃과 인증 만료는 다시 같은 로그인 화면으로 돌아간다. 잘못된 비밀번호 안내도 로그인 폼 위에 표시한다. 실제 임시 서버에서 기존 관리자 기능 회귀와 1440px·390px 중앙 정렬, 가로 넘침 없음, 스크립트 실행 전 표시, 로그인 성공·실패·로그아웃·인증 만료를 확인했다. 인증 만료 화면 시험은 devices API의 401 응답을 브라우저에서 재현했다. 이 화면은 E02 관리자 웹의 사용자 지정 요구이며 Parsec 원본 로그인 화면을 복제했다는 뜻은 아니다. ## 후속 · 계정 관리 사용자 요청으로 로그인 후 **계정 관리** 화면과 관리자 비밀번호 변경 기능을 추가했다. 기존 관리자 인증을 사용하고 현재 비밀번호 확인과 전체 세션 무효화를 수행한다. [사용법·처리·원본과의 구분·검증](ADMIN_ACCOUNT.ko.md)을 따른다. ## 후속 · 다운로드 화면 분리 사용자 제공 ngrok 설치 화면을 참고해 앱 다운로드를 독립 화면으로 분리했다. 번호·세로선으로 연결된 운영체제 선택 → 다운로드/명령어 → 설치 안내 구조이며 macOS·Windows·Linux만 표시한다. Linux 공개 파일은 아직 미연결로 명확히 표시한다. [구성·기존 처리 보존·원본과의 구분·검증](ADMIN_DOWNLOAD_PAGE.ko.md)을 따른다. 위 하단 패널 설명은 초기 구현 이력이다.