docs(okf): replace GoatCounter proposal with own SQLite tracker
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
261cf17e52
commit
8e1ea495c4
9 files changed
+67
-54
No files matched your search
@@ -14,6 +14,7 @@ generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
|
||||
| `GET /` and static paths | Serves the Nuxt build, embedded with `go:embed` |
|
||||
| `GET /api/events` | SSE stream: full state on connect, then each change |
|
||||
| `POST /api/fall/{chapter}` | Allowlist, cooldown, rate limit, then calls the chapter's `/fall` |
|
||||
| every route | Counted by the tracker |
|
||||
|
||||
# Reading cluster state
|
||||
|
||||
@@ -42,6 +43,22 @@ The same stream feeds the life map and the developer view.
|
||||
- Send `Content-Type: text/event-stream` and flush after every message.
|
||||
- Send a comment line (`: ping`) every 30 seconds so idle connections are not closed.
|
||||
|
||||
# Tracker
|
||||
|
||||
Middleware that counts page views, PDF downloads and falls. See [decision](/decisions/own-tracker.md).
|
||||
|
||||
```sql
|
||||
CREATE TABLE counts (day TEXT, event TEXT, n INTEGER, PRIMARY KEY (day, event));
|
||||
-- event: 'view:/', 'pdf', 'fall:example', ...
|
||||
INSERT INTO counts VALUES (?, ?, 1) ON CONFLICT DO UPDATE SET n = n + 1;
|
||||
```
|
||||
|
||||
- Daily totals only. No IP addresses, no cookies, no personal data.
|
||||
- Skip requests whose user agent looks like a bot.
|
||||
- SQLite file on a small `local-path` volume. Deployment strategy `Recreate`,
|
||||
so two gateway pods never write the file at the same time.
|
||||
- Read the numbers with `sqlite3` or a small admin route later; no dashboard in v1.
|
||||
|
||||
# Resources
|
||||
|
||||
64Mi memory limit with `GOMEMLIMIT=50MiB`, 100m CPU. See [server budget](/architecture/server-budget.md).
|
||||
|
||||
Reference in new issue
Block a user