This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

타워 소개 페이지와 로그인 진입 개편

작성일: 2026-10-09, 한국 시간.

원인

기존 첫 화면은 로그인 화면이나 관리 콘솔이었습니다. 서비스를 처음 보는 사람은 기능과 사용 흐름을 파악하기 어려웠습니다.

사용자는 타워 첫 화면에 소개 페이지를 만들고, 로그인을 오른쪽 맨 위에 배치하도록 요청했습니다. 제작한 Celine 한국어 소개 영상도 같은 페이지에 넣도록 요청했습니다.

해결 방법

배포한 화면

• /과 /index.html은 로그인 없이 볼 수 있는 서비스 소개입니다.
• 우측 상단 로그인에서 /login으로 이동합니다. 이미 인증한 브라우저는 콘솔로 들어갑니다.
• 직원 PC 검사, 중앙 검토, 파일 재검사와 증적을 세 가지 기능으로 설명합니다.
• 발견 → 판독 → 검토·조치 → 재검사 → 기록 순서로 처리 흐름을 보여 줍니다.
• 설치 안내, 공개 소스, 개발 출처, 서버 관리 안내로 연결합니다.
• 설치 파일·OS 지원 조건과 1,000대 장기 운영 목표를 구분합니다.
• 직원 정보와 탐지 발췌가 모이는 서버를 보호해야 한다는 안내를 표시합니다.

소개 페이지는 운영 API와 실시간 연결을 열지 않습니다. 로그인 또는 운영 화면에서 소개로 돌아올 때 기존 화면·타이머·실시간 연결·원문 열람 권한을 정리합니다.

영상

완성 영상을 /media/discovery-introduction.mp4에 배치했습니다. 소개 화면의 플레이어와 영상 파일 링크는 같은 서버를 사용합니다. 영상 재생 오류가 나면 사용자가 선택할 수 있는 외부 영상 링크를 표시합니다.

• Celine 한국어 나레이션.
• 220.672초, 약 3분 41초.
• 1280×960, 4:3.
• 자동 재생 없음. preload="none"으로 재생 전 영상 전송을 막습니다.
• 페이지를 떠나 로그인으로 이동하면 재생 중인 영상도 정지합니다.
• 영상은 Git에 넣지 않습니다. 별도 배치 방법을 문서화했습니다.

원본 SHA-256:

27ff68d55ed113b3d3697f19816decb68904038380152faa83ed4458041f5391

로그인과 기존 콘솔

기존 7초 로그인 연출은 로그인하지 않은 상태에서 처음 들어올 때만 표시합니다. 소개 화면에서는 재생하지 않습니다.

같은 탭에서 로그인 화면이나 인증된 콘솔을 새로고침할 때도 반복하지 않습니다. Esc로 건너뛰는 기능은 추가하지 않았습니다.

첫 관리자 생성, 구형 관리자 키 접속과 보호된 경로의 로그인 진입을 유지합니다. 늦게 도착한 인증·로그인 응답은 사용자가 돌아간 소개 페이지를 덮어쓰지 않습니다.

hash 모드에서 로그인 뒤 경로를 바꿀 때 검색 조건이 지워지는 문제도 수정했습니다. 현재 문서 URL의 hash만 변경해 모의 인증 설정과 문서 위치를 유지합니다.

공개본에는 공통 UI를 반영했습니다. 공개 실행형의 첫 관리자 자동 설정은 별도 변경으로 유지했습니다. 기존 공개 EXE와 에이전트 릴리즈 바이너리를 덮어쓰지 않았습니다.

확인 결과

검사	결과
비로그인 소개	공개 화면 표시. 운영 API 요청 0개. 사이드바·운영 화면 숨김
재생 전 전송	MP4 요청 0개
로그인 위치	320·390·768·1024·1440px에서 우측 상단 유지
화면 크기	위 5개 폭에서 가로 넘침 없음. 영상 비율 4:3 유지
접근성 자동 검사	소개 화면의 axe WCAG 2 A/AA·2.1 AA 태그에서 위반 0건. 전체 접근성 인증은 아님
영상 재생	Chromium에서 실제 재생. 길이·해상도 확인
인증 전환	7초 최초 연출, Esc 후 유지, 로그인, 새로고침, 로그아웃, 소개 복귀 통과
늦은 응답	지연된 인증·로그인 응답 뒤에도 소개 화면 유지
초기 설정·경로	첫 관리자 생성, 구형 관리자 키, 보호 경로, /index.html, hash 모드 이동 통과
공개본	같은 소개·인증 검사와 자동 첫 관리자 설정 검사 통과
탐지 검토 회귀	확인 필요·AI 오탐·표본·조치와 사람 판정 분리 검사 통과
증적 화면 회귀	재검증 이력·실패 사유·직원 필터·해시·모바일 검사 통과
운영 주소	HTML·JS·CSS·포스터 HTTP 200 및 배포 파일 일치
운영 영상	HTTP Range 206, video/mp4, 원본 SHA-256 일치
운영 브라우저	소개·영상 재생·로그인 진입·소개 복귀·모바일 확인. JS 오류 없음

합성 API 응답을 사용하는 브라우저 검사는 tower/tools/introduction-ui.test.cjs에 저장했습니다. 운영 주소 검사는 로그인 제출이나 쓰기 API 없이 수행했습니다. 운영 직원 정보를 조회하거나 운영 DB에 테스트 등록 데이터를 만들지 않았습니다.

Playwright와 @axe-core/playwright가 설치된 환경에서 SPA 경로를 지원하는 테스트 서버를 준비합니다. 아래 명령의 출처를 해당 테스트 서버로 지정합니다.

TOWER_TEST_ORIGIN=http://127.0.0.1:8909 node tower/tools/introduction-ui.test.cjs

공개본의 자동 첫 관리자 설정을 검사하려면 TOWER_TEST_DESKTOP=1을 추가합니다.

이 검사는 UI 동작을 확인한 결과입니다. Windows Home의 실제 PC 시험이나 목표 장비에서의 1,000대 장기 운영 검증은 포함하지 않습니다.

제안사항

새 설치 환경에는 소개 영상을 별도로 배치하세요. Git clone만으로는 MP4가 포함되지 않습니다.

서비스 운영자는 서버 관리·백업 안내를 확인해야 합니다. 추가 필수 개발은 없습니다.

원문: 공개 소스 cedbd06. 문서 갱신일 2026-10-12.