source: Klonkt/src/services/StatsService.js@ d549549

main
Last change on this file since d549549 was d549549, checked in by roboburr <roboburr@…>, 3 months ago

Statistics module (Phase 3): cookie-free tracking + premium stats page

Counters: posts.view_count, audio_tracks.play_count, stat_daily
(pageviews/day) + stat_visitor_day (unique visitors via daily rotating
salted hash of IP+UA, never stored → no cookie, no consent needed).
StatsService records pageview on home + post-view (skips admins), play on
the initial player stream fetch. /admin/stats (god-only +
premiumUnlocked-gated): cards + 14-day cookie-free bar chart
(visitors/views) + top posts/tracks. Dashboard button is premium-gated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@…>

  • Property mode set to 100644
File size: 4.5 KB
Line 
1// StatsService — cookievrije statistieken (premium-module).
2//
3// Tellers: posts.view_count, audio_tracks.play_count, en per dag/site het aantal
4// pageviews (stat_daily) + unieke bezoekers (stat_visitor_day).
5//
6// Unieke bezoekers ZONDER cookie: een sha256 van IP+UA+dag-salt. De salt roteert
7// elke dag en wordt nooit langer bewaard → je kunt iemand niet over dagen heen
8// volgen, het ruwe IP wordt niet opgeslagen. Geen persistente identifier, geen
9// toestemmingsbanner nodig (Plausible/Fathom-aanpak).
10
11import crypto from 'node:crypto';
12import db from '../config/database.js';
13import { getSetting, setSetting } from './SettingsService.js';
14
15function today() {
16 return new Date().toISOString().slice(0, 10); // YYYY-MM-DD (UTC)
17}
18
19// Dagelijks roterende salt (gecachet in proces, persistent in app_settings zodat
20// een herstart binnen dezelfde dag dezelfde salt houdt).
21let _salt = null, _saltDay = null;
22function dailySalt() {
23 const d = today();
24 if (_salt && _saltDay === d) return _salt;
25 let stored = getSetting('stat_salt', null);
26 if (!stored || getSetting('stat_salt_day', null) !== d) {
27 stored = crypto.randomBytes(16).toString('hex');
28 setSetting('stat_salt', stored);
29 setSetting('stat_salt_day', d);
30 }
31 _salt = stored; _saltDay = d;
32 return stored;
33}
34
35function visitorHash(req) {
36 const ip = (req && (req.ip || (req.socket && req.socket.remoteAddress))) || '';
37 const ua = (req && req.headers && req.headers['user-agent']) || '';
38 return crypto.createHash('sha256').update(dailySalt() + '|' + ip + '|' + ua).digest('hex').slice(0, 32);
39}
40
41// De eigenaar/beheerder niet meetellen — anders inflate je je eigen cijfers.
42function isOperator(req) {
43 const u = req && req.session && req.session.user;
44 return !!(u && (u.role === 'god' || u.role === 'admin'));
45}
46
47// Lazy prepares — tabellen bestaan pas ná initializeDatabase(); dit module wordt
48// geïmporteerd vóór die call.
49let _s = null;
50function stmts() {
51 if (_s) return _s;
52 _s = {
53 bumpDaily: db.prepare(`
54 INSERT INTO stat_daily (site_id, day, pageviews) VALUES (?, ?, 1)
55 ON CONFLICT(site_id, day) DO UPDATE SET pageviews = pageviews + 1
56 `),
57 addVisitor: db.prepare('INSERT OR IGNORE INTO stat_visitor_day (site_id, day, visitor_hash) VALUES (?, ?, ?)'),
58 bumpPost: db.prepare('UPDATE posts SET view_count = COALESCE(view_count, 0) + 1 WHERE id = ?'),
59 bumpTrack: db.prepare('UPDATE audio_tracks SET play_count = COALESCE(play_count, 0) + 1 WHERE id = ?'),
60 };
61 return _s;
62}
63
64export function recordPageview(siteId, req) {
65 if (!siteId || isOperator(req)) return;
66 try {
67 const d = today();
68 stmts().bumpDaily.run(siteId, d);
69 stmts().addVisitor.run(siteId, d, visitorHash(req));
70 } catch { /* statistieken mogen nooit een request breken */ }
71}
72
73export function recordPostView(post, req) {
74 if (!post || !post.id || isOperator(req)) return;
75 try {
76 stmts().bumpPost.run(post.id);
77 recordPageview(post.site_id, req);
78 } catch {}
79}
80
81export function recordPlay(trackId) {
82 if (!trackId) return;
83 try { stmts().bumpTrack.run(trackId); } catch {}
84}
85
86// Instance-brede statistieken (solo = de site, hub = alle sites samen).
87export function getStats(days = 14) {
88 const pvMap = Object.fromEntries(
89 db.prepare('SELECT day, SUM(pageviews) AS pv FROM stat_daily GROUP BY day').all().map((r) => [r.day, r.pv]),
90 );
91 const visMap = Object.fromEntries(
92 db.prepare('SELECT day, COUNT(*) AS v FROM stat_visitor_day GROUP BY day').all().map((r) => [r.day, r.v]),
93 );
94 const series = [];
95 for (let i = days - 1; i >= 0; i--) {
96 const dt = new Date();
97 dt.setUTCDate(dt.getUTCDate() - i);
98 const d = dt.toISOString().slice(0, 10);
99 series.push({ day: d, pageviews: pvMap[d] || 0, visitors: visMap[d] || 0 });
100 }
101 const totals = {
102 pageviews: series.reduce((s, r) => s + r.pageviews, 0), // laatste N dagen
103 visitors: series.reduce((s, r) => s + r.visitors, 0), // som van dag-uniques (cookieless kan niet anders)
104 plays: db.prepare('SELECT COALESCE(SUM(play_count), 0) AS n FROM audio_tracks').get().n,
105 postViews: db.prepare('SELECT COALESCE(SUM(view_count), 0) AS n FROM posts').get().n,
106 };
107 const topPosts = db.prepare(`
108 SELECT title, slug, COALESCE(view_count, 0) AS views FROM posts
109 WHERE status = 'published' ORDER BY view_count DESC, published_at DESC LIMIT 5
110 `).all();
111 const topTracks = db.prepare(`
112 SELECT title, COALESCE(play_count, 0) AS plays FROM audio_tracks
113 ORDER BY play_count DESC LIMIT 5
114 `).all();
115 return { totals, series, topPosts, topTracks, days };
116}
Note: See TracBrowser for help on using the repository browser.