Files
Bkk1234 2504c39305 analytics: privacy-first search stats (Umami-style), #/stats page
- ui/analytics.js: cookie-less local-first tracker (localStorage), DNT/GPC
  honoured, opt-out switch, term sanitiser (email/@handle/long digits stripped),
  900ms debounce, caps 300 terms / 200 views / 120 days
- optional Umami-compatible beacon (window.AT_ANALYTICS endpoint+siteId),
  disabled by default: no third-party requests unless the owner configures it
- #/stats view: KPIs, 14-day CSS bar chart, top terms, top route/stop pages,
  no-result terms, privacy panel, JSON export, clear, opt-out
- hooks: busStop search apply(), stopDetail route filter, hashchange pageviews
- i18n th/en (395 keys each), credits section, sw.js precache + VERSION 2026.09.27.105
2026-11-03 00:07:57 +07:00

325 lines
13 KiB
JavaScript

/* ============================================================
analytics.js — สถิติการค้นหา/การเปิดหน้า แบบไม่ระบุตัวตน
------------------------------------------------------------
แนวคิดเดียวกับ Umami (privacy-first analytics) แต่ทำฝั่งเบราว์เซอร์ล้วน
เพราะ repo นี้ไม่มี backend:
• ไม่มีคุกกี้ · ไม่มี fingerprint · ไม่เก็บ IP/UA
• ไม่มีรหัสผู้ใช้ถาวร — session id สุ่มใหม่ทุกแท็บ (sessionStorage, ตายกับแท็บ)
• เคารพ Do Not Track + Global Privacy Control + สวิตช์ปิดของผู้ใช้เอง
• ข้อมูลรวมอยู่ในเครื่องนี้ (localStorage) — ค่าเริ่มต้น "ไม่ส่งออกเน็ตเลย"
• ถ้าเจ้าของเว็บตั้ง endpoint Umami เอง (window.AT_ANALYTICS) จึงจะส่ง:
payload ตรงสเปก Umami /api/send (type=event) — ไม่มีอะไรเพิ่มนอกรอบนั้น
API
Analytics.search({ q, scope, results }) ← เรียกได้ทุกคีย์สโตว์ม (debounce 900ms ให้เอง)
Analytics.pageview() ← ผูก hashchange ให้อัตโนมัติแล้ว
Analytics.view(kind, id) ← เปิดรายละเอียดสาย/ป้าย
Analytics.report() ← ข้อมูลสำหรับหน้า #/stats
Analytics.exportJSON() / clear() / optOut(bool) / isOptedOut()
ความเป็นส่วนตัวของ "คำค้น" (สำคัญ):
- ตัดอีเมล · @handle · เลขยาว ≥5 หลัก (เบอร์โทร/เลขบัตร) ออกก่อนบันทึก
- จำกัด 60 ตัวอักษร · รวมช่องว่าง · ตัวอักษรละตินเป็นตัวเล็ก
- คำที่สั้นกว่า 2 ตัวอักษรไม่บันทึก
- เก็บแค่ "คำ + จำนวนครั้ง + เวลาล่าสุด" ไม่ผูกกับใคร
============================================================ */
(function () {
'use strict';
var KEY = 'at_stats_v1';
var OPTOUT_KEY = 'at_stats_optout';
var SESSION_KEY = 'at_stats_sid';
var MAX_TERMS = 300; /* จำนวนคำค้นที่เก็บ */
var MAX_VIEWS = 200; /* จำนวนหน้า/สาย/ป้ายที่เก็บ */
var MAX_DAYS = 120; /* เก็บรายวัน 120 วัน */
var TERM_MAX_LEN = 60;
var DEBOUNCE_MS = 900;
var DAY_MS = 86400000;
/* ---------- ความยินยอม ---------- */
function cfg() { return window.AT_ANALYTICS || {}; }
function dntOn() {
var d = navigator.doNotTrack || window.doNotTrack || navigator.msDoNotTrack;
if (d === '1' || d === 'yes' || d === 'on') return true;
if (navigator.globalPrivacyControl === true) return true; /* GPC */
return false;
}
function optedOut() {
try { return localStorage.getItem(OPTOUT_KEY) === '1'; }
catch (e) { return true; } /* storage ปิด = ไม่เก็บ */
}
function tracking() { return !dntOn() && !optedOut(); }
/* ---------- helpers ---------- */
function now() { return Date.now(); }
function dayKey(ts) {
var d = new Date(ts);
var m = ('0' + (d.getMonth() + 1)).slice(-2);
var day = ('0' + d.getDate()).slice(-2);
return d.getFullYear() + '-' + m + '-' + day;
}
/* ทำคำค้นให้ปลอดภัยก่อนบันทึก */
function cleanTerm(q) {
var s = String(q == null ? '' : q).replace(/\s+/g, ' ').trim();
if (!s) return '';
s = s
.replace(/[\w.+-]+@[\w-]+\.[\w.-]+/g, ' ') /* อีเมล */
.replace(/@[\w.]+/g, ' ') /* @handle */
.replace(/\d{5,}/g, ' ') /* เบอร์โทร/เลขยาว */
.replace(/\s+/g, ' ')
.trim()
.toLowerCase();
if (s.length > TERM_MAX_LEN) s = s.slice(0, TERM_MAX_LEN);
return s;
}
/* ---------- storage ---------- */
function blank() {
return { v: 1, since: now(), days: {}, terms: {}, empty: {}, views: {} };
}
function read() {
try {
var raw = localStorage.getItem(KEY);
if (!raw) return blank();
var d = JSON.parse(raw);
if (!d || typeof d !== 'object' || d.v !== 1) return blank();
d.days = d.days || {}; d.terms = d.terms || {}; d.empty = d.empty || {}; d.views = d.views || {};
return d;
} catch (e) { return blank(); }
}
function write(d) {
try { localStorage.setItem(KEY, JSON.stringify(d)); } catch (e) { /* เงียบ */ }
}
/* ตัดข้อมูลเกินเพดาน (เก่าสุดก่อน) — กัน localStorage บวม */
function cap(map, max) {
var keys = Object.keys(map);
if (keys.length <= max) return false;
keys.sort(function (a, b) { return ((map[a] && map[a][1]) || 0) - ((map[b] && map[b][1]) || 0); });
var cut = keys.length - max;
for (var i = 0; i < cut; i++) delete map[keys[i]];
return true;
}
function bump(map, key, ts, max) {
if (!key) return;
var e = map[key];
map[key] = [(e && Number(e[0])) || 0, ts];
map[key][0] += 1;
cap(map, max);
}
function pruneDays(d, ts) {
var cut = dayKey(ts - (MAX_DAYS - 1) * DAY_MS);
Object.keys(d.days).forEach(function (k) { if (k < cut) delete d.days[k]; });
}
function day(d, ts) {
var k = dayKey(ts);
if (!d.days[k]) d.days[k] = { pv: 0, q: 0, nores: 0 };
return d.days[k];
}
/* ---------- ส่งออก Umami (ถ้าเจ้าของเว็บตั้งค่า) ---------- */
var sid = null;
function sessionId() {
if (sid) return sid;
try {
sid = sessionStorage.getItem(SESSION_KEY);
if (!sid) {
sid = Math.random().toString(36).slice(2) + now().toString(36);
sessionStorage.setItem(SESSION_KEY, sid);
}
} catch (e) { sid = 'anon'; }
return sid;
}
function send(name, data) {
var c = cfg();
if (!c || !c.endpoint || !c.siteId) return; /* ค่าเริ่มต้น: ไม่ส่งที่ไหน */
var body = {
type: 'event',
payload: {
website: c.siteId,
hostname: location.hostname,
url: location.pathname + location.hash,
referrer: document.referrer || '',
title: document.title || '',
language: navigator.language || '',
screen: (screen.width || 0) + 'x' + (screen.height || 0),
event_name: name,
event_data: data || {}
}
};
var url = String(c.endpoint).replace(/\/+$/, '') + '/api/send';
try {
var blob = new Blob([JSON.stringify(body)], { type: 'application/json' });
if (navigator.sendBeacon && navigator.sendBeacon(url, blob)) return;
fetch(url, { method: 'POST', body: JSON.stringify(body), keepalive: true,
headers: { 'Content-Type': 'application/json' } }).catch(function () {});
} catch (e) { /* ไม่ให้ analytics ทำให้หน้าเว็บพัง */ }
}
/* ---------- บันทึก ---------- */
var pending = null; /* { q, scope, results, timer } */
var lastPV = { key: '', ts: 0 };
var lastView = { key: '', ts: 0 };
function recordSearch(q, scope, results) {
var term = cleanTerm(q);
if (!term || term.replace(/\s/g, '').length < 2) return;
var ts = now();
var d = read();
var bucket = day(d, ts);
bucket.q += 1;
if (results === 0) { bucket.nores += 1; bump(d.empty, term, ts, MAX_TERMS); }
else bump(d.terms, term, ts, MAX_TERMS);
pruneDays(d, ts);
write(d);
if (tracking()) send('search', { term: term, scope: scope || '', results: results });
}
function flush() {
if (!pending) return;
var p = pending;
pending = null;
clearTimeout(p.timer);
recordSearch(p.q, p.scope, p.results);
}
function parseHash() {
var raw = (location.hash || '').replace(/^#/, '');
var path = raw.split('?')[0];
return path.split('/').filter(Boolean);
}
function trackViewOnce(kind, id) {
if (!id) return;
var key = kind + ':' + id;
var ts = now();
if (lastView.key === key && ts - lastView.ts < 1200) return;
lastView = { key: key, ts: ts };
var d = read();
bump(d.views, key, ts, MAX_VIEWS);
write(d);
if (tracking()) send('view', { kind: kind, id: String(id) });
}
var Analytics = {
/* นับการเปิดหน้า (เก็บเฉพาะตัวเลขรายวัน — ไม่เก็บว่าใคร) */
pageview: function () {
if (!tracking()) { flush(); return; }
var seg = parseHash();
var key = seg.join('/') || 'home';
var ts = now();
if (lastPV.key === key && ts - lastPV.ts < 1200) return; /* ป้องกันนับซ้ำตอน langchange */
lastPV = { key: key, ts: ts };
var d = read();
day(d, ts).pv += 1;
pruneDays(d, ts);
write(d);
if (seg[0] === 'routes' && seg[1]) trackViewOnce('route', decodeURIComponent(seg[1]));
else if (seg[0] === 'stops' && seg[1]) trackViewOnce('stop', decodeURIComponent(seg[1]));
if (tracking()) send('pageview', { path: '/' + key });
},
/* เรียกได้ทุกครั้งที่ผลค้นเปลี่ยน — debounce 900ms ให้เหลือ 1 คำต่อการพิมพ์ */
search: function (opts) {
if (!tracking()) return;
var o = opts || {};
var q = String(o.q == null ? '' : o.q);
if (!cleanTerm(q) || cleanTerm(q).replace(/\s/g, '').length < 2) return;
if (pending) clearTimeout(pending.timer);
pending = {
q: q,
scope: o.scope || '',
results: (typeof o.results === 'number') ? o.results : null,
timer: setTimeout(flush, DEBOUNCE_MS)
};
},
view: function (kind, id) { if (tracking()) trackViewOnce(kind, id); },
/* ---------- รายงานสำหรับหน้า #/stats ---------- */
report: function () {
var d = read();
var ts = now();
function rows(map, n, fn) {
var arr = Object.keys(map).map(function (k) {
var e = map[k] || [];
return fn(k, Number(e[0]) || 0, Number(e[1]) || 0);
}).filter(function (r) { return r.count > 0; });
arr.sort(function (a, b) { return b.count - a.count || b.last - a.last; });
return arr.slice(0, n || 10);
}
var days = Object.keys(d.days).sort().slice(-14).map(function (k) {
var v = d.days[k];
return { date: k, pageviews: v.pv || 0, searches: v.q || 0, noResult: v.nores || 0 };
});
var pv = 0, q = 0, nores = 0;
Object.keys(d.days).forEach(function (k) {
pv += d.days[k].pv || 0; q += d.days[k].q || 0; nores += d.days[k].nores || 0;
});
return {
since: d.since || ts,
totals: { pageviews: pv, searches: q, noResult: nores,
terms: Object.keys(d.terms).length, views: Object.keys(d.views).length },
days: days,
topTerms: rows(d.terms, 12, function (k, c, l) { return { term: k, count: c, last: l }; }),
topEmpty: rows(d.empty, 8, function (k, c, l) { return { term: k, count: c, last: l }; }),
topViews: rows(d.views, 12, function (k, c, l) {
var at = k.indexOf(':');
return { kind: k.slice(0, at), id: k.slice(at + 1), count: c, last: l };
})
};
},
exportJSON: function () { return JSON.stringify(read(), null, 2); },
clear: function () {
try { localStorage.removeItem(KEY); } catch (e) {}
pending = null;
lastPV = { key: '', ts: 0 };
lastView = { key: '', ts: 0 };
},
optOut: function (on) {
if (pending) { clearTimeout(pending.timer); pending = null; }
try { localStorage.setItem(OPTOUT_KEY, on ? '1' : '0'); } catch (e) {}
},
isOptedOut: function () { return optedOut() || dntOn(); },
tracking: tracking,
cleanTerm: cleanTerm,
_key: KEY
};
window.Analytics = Analytics;
/* ---------- ต่อท่ออัตโนมัติ ---------- */
window.addEventListener('hashchange', function () { Analytics.pageview(); });
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', function () { Analytics.pageview(); });
} else {
Analytics.pageview();
}
})();