various: HTTP server; migrate to cobra pattern for repository

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: Ifac6e992b77dfaf92e3059944aa871f16a6a6964

config.example.yaml

@@ -0,0 +1,56 @@
+# Watchdog Analytics Configuration Example
+
+site:
+  # Your site's primary domain (required)
+  domain: "example.com"
+
+  # Salt rotation for IP hashing (optional, default: daily)
+  # Options: "daily", "hourly"
+  salt_rotation: "daily"
+
+  # Which dimensions to collect
+  collect:
+    pageviews: true
+    country: true
+    device: true
+    # Referrer collection mode: "off", "domain"
+    # "domain" - collect only the domain part (e.g., "google.com")
+    # "off" - don't collect referrer data
+    referrer: "domain"
+
+  # Custom events to track (optional)
+  custom_events:
+    - "signup"
+    - "purchase"
+    - "download"
+
+  # Path normalization options
+  path:
+    # Remove query strings from paths (e.g., /page?id=1 -> /page)
+    strip_query: true
+    # Remove fragments from paths (e.g., /page#section -> /page)
+    strip_fragment: true
+    # Collapse numeric segments to :id (e.g., /user/123 -> /user/:id)
+    collapse_numeric_segments: true
+    # Maximum number of path segments to keep
+    max_segments: 5
+    # Normalize trailing slashes (e.g., /page/ -> /page)
+    normalize_trailing_slash: true
+
+# Cardinality limits to prevent metric explosion
+limits:
+  # Maximum number of unique paths to track
+  max_paths: 10000
+  # Maximum number of unique referrer sources to track
+  max_sources: 500
+  # Maximum events per minute (for rate limiting, not yet implemented)
+  max_events_per_minute: 1000
+
+# Server configuration
+server:
+  # Address to listen on
+  listen_addr: ":8080"
+  # Prometheus metrics endpoint
+  metrics_path: "/metrics"
+  # Event ingestion endpoint
+  ingestion_path: "/api/event"