docs(okf): replace GoatCounter proposal with own SQLite tracker

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Noel SabiaandClaude Opus 5.5 committed 2026-10-11 14:43:34 +02:00
1 parent 261cf17e52
commit 8e1ea495c4
9 files changed
+67 -54

No files matched your search

-38
View File
@@ -1,38 +0,0 @@
---
type: Decision
title: GoatCounter over Umami for analytics
description: Proposed; GoatCounter gives cookie-free open source analytics in about 30 MB, where Umami needs Postgres and about 300-400 MB.
tags: [decision, analytics, resources]
status: draft
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
---
# Proposal
Self-host GoatCounter in namespace `cv` instead of Umami. Needs Noel's
approval as new tooling.
# Why
| | Umami | GoatCounter |
|---|---|---|
| Runtime | Node app | Single Go binary |
| Database | Postgres | SQLite file |
| Memory | ~300-400 MB with Postgres | ~30 MB |
| Cookie-free, no consent banner | Yes | Yes |
| Custom events | Yes | Yes |
| License | Open source | Open source |
On a [4 GB shared server](/architecture/server-budget.md), Umami alone would
match the whole CV budget.
# Track
- Page views.
- PDF CV downloads.
- Falls per chapter.
# Details
One Deployment, 64Mi limit, SQLite on a small `local-path` volume. No backup:
losing analytics hurts nobody.
+1 -4
View File
@@ -3,13 +3,10 @@
* [v1 scope](v1-scope.md) - What the first public version keeps and what moves to later phases.
* [Accept home-server downtime in v1](accept-downtime-v1.md) - v1 serves everything from the home server; if it is down, the whole site is down.
* [Static Nuxt served by the gateway](static-nuxt-in-gateway.md) - Nuxt is generated to static files and embedded in the gateway image instead of running as its own pod.
* [Own analytics tracker on SQLite](own-tracker.md) - Analytics are counted by Noel's own code in the gateway and stored as daily totals in SQLite; no third-party tracker, no Postgres.
* [CI/CD on Gitea Actions](ci-on-gitea.md) - The existing Gitea instance and runner on the home server build, scan, deploy and version the project.
* [Knowledge bundle lives at the repository root](bundle-at-root.md) - The repository root is the OKF bundle root; any other markdown file there needs frontmatter to stay conformant.
# Proposed
* [GoatCounter over Umami for analytics](goatcounter-over-umami.md) - Proposed; GoatCounter gives cookie-free open source analytics in about 30 MB, where Umami needs Postgres and about 300-400 MB.
# Open
* [Open questions](open-questions.md) - Decisions still to make, with the release that needs each answer.
-1
View File
@@ -15,6 +15,5 @@ generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
| Which Gitea release-please action, exact name | 0.1.0 | None, Noel names it |
| Staging for k6 in CI: namespace or separate cluster | 1.2.0 | Namespace `cv-staging` on the same cluster |
| MCP scope: read-only or read plus `/fall` | 1.1.0 | Read plus `/fall`, same limits as visitors |
| Approve GoatCounter for analytics | 0.9.0 | None, needs Noel |
| Approve PyTorch for the language model | 1.5.0 | None, needs Noel |
| Approve NumPy (or similar) for the own autograd engine | 1.13.0 | None, needs Noel |
+36
View File
@@ -0,0 +1,36 @@
---
type: Decision
title: Own analytics tracker on SQLite
description: Analytics are counted by Noel's own code in the gateway and stored as daily totals in SQLite; no third-party tracker, no Postgres.
tags: [decision, analytics, sqlite, go]
status: stable
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
verified: { by: human:noel, at: 2026-10-11T12:15:30Z }
---
# Decision
Write the tracker as middleware in the [gateway](/architecture/gateway.md).
Store daily totals in SQLite via `modernc.org/sqlite` (pure Go, no cgo).
SQLite is approved tooling.
# Why
- The gateway already sees every page view, PDF download and fall. No
tracking script, nothing for ad blockers to block.
- About 5 MB of memory, no extra pod. GoatCounter would need ~30 MB, Umami
with Postgres ~300-400 MB, on a [4 GB shared server](/architecture/server-budget.md).
- A learning project: owning the code is the point.
# Rejected
| Option | Why not |
|---|---|
| Umami | Needs Postgres, ~300-400 MB |
| GoatCounter | Fine, but Noel wants his own |
| Postgres for the own tracker | ~40-60 MB for a table of counters |
| Cloudflare analytics only | Cannot count falls or PDF downloads |
# Revisit when
Noel wants to learn Postgres. The schema is plain SQL, so the move is small.