Initial LinkLog implementation

backend/app/core/config.py

@@ -0,0 +1,35 @@
+from dataclasses import dataclass
+import os
+from pathlib import Path
+
+
+BASE_DIR = Path(__file__).resolve().parent.parent.parent
+DB_PATH = BASE_DIR / 'data' / 'linklog.db'
+
+
+@dataclass
+class Settings:
+    app_name: str = os.getenv('LINKLOG_APP_NAME', 'LinkLog')
+    database_url: str = os.getenv('LINKLOG_DATABASE_URL', f'sqlite:///{DB_PATH}')
+    secret_key: str = os.getenv('LINKLOG_SECRET_KEY', 'dev-secret-key-change-me')
+    token_expiry_days: int = int(os.getenv('LINKLOG_TOKEN_EXPIRY_DAYS', '30'))
+    tracking_params: list[str] = None
+
+    def __post_init__(self):
+        if self.tracking_params is None:
+            default_tracking_params = [
+                'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
+                'utm_id', 'utm_name', 'gclid', 'fbclid', 'dclid', 'msclkid', 'mc_cid',
+                'mc_eid', 'igshid', 'ga_source', 'ga_medium', 'ga_campaign', 'ga_place',
+                'campaignid', 'hsa_cr', 'hsa_cam', 'hsa_grp', 'hsa_ad', 'hsa_src',
+                'hsa_acc', 'hsa_net', 'hsa_mt', 'hsa_kw', 'hsa_ver', 'hsa_tgt',
+            ]
+            configured_params = os.getenv('LINKLOG_TRACKING_PARAMS')
+            self.tracking_params = (
+                [item.strip() for item in configured_params.split(',') if item.strip()]
+                if configured_params
+                else default_tracking_params
+            )
+
+
+settings = Settings()

backend/app/core/security.py

@@ -0,0 +1,25 @@
+from datetime import datetime, timedelta, timezone
+from hashlib import sha256
+
+from backend.app.core.config import settings
+
+
+def hash_token(token: str) -> str:
+    return sha256(token.encode('utf-8')).hexdigest()
+
+
+def token_expires_at() -> datetime:
+    return datetime.now(timezone.utc) + timedelta(days=settings.token_expiry_days)
+
+
+def clean_url(url: str) -> str:
+    from urllib.parse import parse_qsl, urlsplit, urlunsplit
+
+    parts = urlsplit(url)
+    if not parts.query:
+        return url
+
+    params = parse_qsl(parts.query, keep_blank_values=True)
+    filtered = [(k, v) for k, v in params if k not in settings.tracking_params]
+    new_query = '&'.join(f'{k}={v}' if v != '' else k for k, v in filtered)
+    return urlunsplit((parts.scheme, parts.netloc, parts.path, new_query, parts.fragment))