Files
SubMiner/backlog/tasks/task-156 - Fix-docs-site-Plausible-geo-attribution-through-analytics-worker.md
2026-03-10 19:47:16 -07:00

1.5 KiB

id, title, status, assignee, created_date, updated_date, labels, dependencies, priority
id title status assignee created_date updated_date labels dependencies priority
TASK-156 Fix docs-site Plausible geo attribution through analytics worker In Progress
2026-03-11 02:19 2026-03-11 02:44
docs-site
analytics
medium

Description

Investigate and fix missing city/region data for docs.subminer.moe visits in Plausible. The docs site already proxies analytics events to worker.subminer.moe, so the remaining work is to verify and correct the worker-side forwarding contract Plausible needs for geolocation.

Acceptance Criteria

  • #1 The analytics worker forwards Plausible event requests in a way that preserves the original client IP information needed for location attribution.
  • #2 The docs-site analytics flow remains proxied through worker.subminer.moe after the fix.
  • #3 Coverage or documentation records the worker-side header/forwarding requirement for Plausible geo reporting.

Implementation Notes

Worker implementation lives in /home/sudacode/projects/blog-proxy, not in the SubMiner repo.

Patched worker.js to forward client IP via x-forwarded-for/x-real-ip from cf-connecting-ip (fallbacks retained) and added worker.test.js regression coverage.

Local verification in blog-proxy: node --test worker.test.js passes. Deployment not performed in this session.