장기 방문자 통계 추가 v1.7.7

docs/homepage-widget.md

@@ -20,6 +20,9 @@ Homepage가 Docker 컨테이너에서 실행 중이면 `localhost`는 Homepage
 | `todayPageViews` | number | 오늘 페이지뷰 |
 | `totalPageViews` | number | 전체 누적 페이지뷰 |
 | `visitorsLast7Days` | number | 최근 7일 방문자 합계 |
+| `visitorsLast30Days` | number | 최근 30일 방문자 합계 |
+| `visitorsLast180Days` | number | 최근 180일(약 6개월) 방문자 합계 |
+| `visitorsLast365Days` | number | 최근 365일(1년) 방문자 합계 |
 | `pageViewsLast30Days` | number | 최근 30일 페이지뷰 |
 | `onlineNow` | number | 최근 90초 안에 활동한 접속자 |
 | `loggedInNow` | number | 현재 접속자 중 로그인 회원 |
@@ -44,7 +47,7 @@ Homepage가 Docker 컨테이너에서 실행 중이면 `localhost`는 Homepage
     widget:
       type: customapi
       url: https://sori.studio/api/homepage-widget
-      refreshInterval: 30000
+      refreshInterval: 300000 # 5분
       mappings:
         - field: todayVisitors
           label: 오늘 방문자
@@ -118,6 +121,18 @@ mappings:
     label: 최근 7일 방문
     format: number
     suffix: 명
+  - field: visitorsLast30Days
+    label: 최근 30일 방문
+    format: number
+    suffix: 명
+  - field: visitorsLast180Days
+    label: 최근 6개월 방문
+    format: number
+    suffix: 명
+  - field: visitorsLast365Days
+    label: 최근 1년 방문
+    format: number
+    suffix: 명
   - field: pageViewsLast30Days
     label: 최근 30일 조회
     format: number
@@ -157,3 +172,5 @@ curl https://sori.studio/api/homepage-widget
 ```
 
 응답이 정상인데 Homepage에 값이 나오지 않으면 Homepage 컨테이너 내부에서 해당 URL에 접근할 수 있는지 먼저 확인한다.
+
+방문 기간 통계는 일별 집계 테이블에서 최근 7·30·180·365일을 한 번에 합산한다. Homepage를 개인용으로 간헐적으로 확인한다면 `refreshInterval: 300000`(5분) 또는 `600000`(10분)으로 두면 충분하다.