Umami, 바이브 코딩으로 대체 가능?

Umami 대신 쓸 가벼운 웹 방문 통계를 만든다. 스크립트 수집, 봇 제외, 기간별 방문·인기 페이지 대시보드까지가 범위다.
스택은 Node.js 22, Hono, PostgreSQL 16, 순수 CSS 와 Chart 없이 만든 표·막대 그래프로 고정하고 다른 분석 도구는 붙이지 않는다.
로컬에서는 `npm install && npm run dev` 한 번으로 대시보드(/dashboard)와 수집 엔드포인트(/api/collect)가 함께 뜨게 한다.
수집 원본은 events 테이블, 하루 요약은 daily_stats 테이블에 두고 기간별 방문과 인기 페이지를 CSV 로 내보낸다.
DATABASE_URL, COLLECT_SITE_ID, DASHBOARD_PASSWORD, SESSION_SECRET, STATS_TZ=Asia/Seoul 을 .env 에서 읽고 .env.example 만 커밋한다.
사이트에 붙일 tracker.js 를 만들어 페이지뷰 시 경로, 유입 도메인, 화면 크기, 언어만 보내게 한다.
서버는 이벤트를 저장할 때 사용자 에이전트와 유입 도메인으로 봇을 걸러내고 같은 방문자의 30분 안 재방문을 같은 세션으로 묶는다.
대시보드는 오늘·7일·30일 방문과 인기 페이지, 유입 상위 도메인, 기기 종류를 표와 막대로 보여 준다.
매일 새벽 예약 작업이 하루 요약을 만들고 6개월이 지난 원본 이벤트 행을 지운다.
수집된 데이터가 아직 없을 때의 빈 상태 화면, 요약을 계산하는 동안의 로딩 표시, 수집 엔드포인트가 거부했을 때의 오류 안내를 만든다.
수집 엔드포인트는 IP당 분당 120회로 제한하고 페이로드 크기와 경로 형식을 검사하며 잘못된 요청은 400으로 돌려보낸다.
대시보드는 비밀번호 로그인과 HttpOnly 세션 쿠키로 막고 조회는 로그인한 사용자만 하게 한다.
방문자 IP 는 저장하지 않고 국가 판정에만 쓰며, 쿠키도 심지 않는다는 점을 README 와 개인정보 안내에 적는다.
수집량 경고가 필요하면 카카오 알림톡이나 문자 대신 Resend 이메일로 보낸다.
사용량이 늘어 유료로 돌린다면 금액은 원화(₩)로 표시하고, 국내 결제 PG 연동은 가맹 심사가 필요하므로 범위에서 빼고 자체 호스팅으로만 쓴다.
화면 문구와 날짜 표기는 한국어(Asia/Seoul)로 하고 기간 표시는 2026년 10월 17일 (토) 오후 9:40 형식으로 적는다.
6개월이 지난 원본 이벤트와 30일이 지난 방문자 세션 기록은 자동 삭제하고, 삭제 기준과 요청 처리 방법을 개인정보 안내에 적는다.
봇 판정 규칙, 세션 30분 경계 계산, 하루 요약 집계에 대한 단위 테스트와 수집부터 대시보드 확인까지 한 바퀴 도는 통합 테스트를 Vitest 로 작성한다.
README 에는 실행 명령, .env 항목, tracker.js 붙이는 방법, DB 백업, 수집 항목과 보관 기간을 적는다.
회원가입 페이지, 요금 청구 화면, 광고·제3자 추적 스크립트, 히트맵 수집은 넣지 않는다.
퍼널 리포트, 목표 전환 추적, 여러 사이트 팀 권한, 앱·서버 로그 수집은 일부러 뺀다.
마지막으로 npm test 로 봇 판정과 세션 경계 테스트를 돌려 통과를 확인하고 실행한 명령을 순서대로 적는다.