docs(deploy): document PV/UV stats and real client IP via nginx realip

project.md

@@ -883,5 +883,13 @@ P0、P1、P2、P3、第 9 轮与第 10 轮已实施；P2 交付了只读本地
 2. 基于粉丝数的"破圈"维度（播放/入库时粉丝数、粉丝分段、UP 中位数）——数据已就绪，榜单未实现；
 3. P4（容器化 + 反代）继续保持可选。
 
+第 12 轮（2026-11-01）交付：**基础访问统计（PV/UV）**：
+
+1. 迁移 v7 新增 `visit(stat_date, ip, path, hits, first_at, last_at)` 聚合表；
+2. 前端 `sendBeacon` 埋点 `POST /api/visit`；服务端内存缓冲、每分钟批量落库，关闭时 flush；
+3. 来源 IP 兼容「域名直连公网 EIP / Cloudflare / EdgeOne」：nginx 用 realip 按 CDN 网段归一化到 `X-Real-IP`，应用仅在 socket 对端可信时采信（见 `deploy/nginx/`）；
+4. `/system` 系统状态页展示近 30 天 PV/UV 与 Top 页面；Web 只读边界放宽为显式 POST 白名单；
+5. 纯函数 `client_ip.py` 与内存缓冲 `web/visits.py` 均有离线单元测试。
+
 > 本地数据：第 9 轮起本地只保留可再生的预览库 `data/preview/app.db`（`tools/seed_preview_db.py` 生成），
 > 原 `data/app.db` 真实副本已删除；需要重新生成或恢复时，用 `--source data/backup/app-local-before-reseed-20261101.db`。