initial commit — cassandra v0.1

Containerised macro-strategy dashboard: 4-panel web UI (indicators,
portfolio, flash news, AI strategic log), MariaDB store, hourly
ingestion jobs, OpenRouter-backed AI analysis.

Ports the four prototype scripts in the parent dir (market_pulse,
flash_news, trading212, strategic_log) into async services backed by a
persistent DB and served via FastAPI + Jinja2 + HTMX. APScheduler runs
as a separate compose service for crash-safety and easier restarts.

Portfolio composition + position names come live from Trading 212;
news per-ticker headlines reuse those names. Tone (NOVICE/INTERMEDIATE/
PRO) and analysis style (DRY/SPECULATIVE) are env-configurable and
stored on each log row so historical entries show what produced them.

Default model is deepseek/deepseek-v4-flash (overridable via env).
Light/dark theme toggle, sans-serif for prose surfaces, monospace for
data. Bearer-token auth, OpenRouter monthly cost cap, RSS feeds auto-
disabled on consecutive failures.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

app/routers/pages.py

@@ -0,0 +1,80 @@
+"""HTML page routes — server-rendered Jinja2 with HTMX-driven partial refresh."""
+from __future__ import annotations
+
+from datetime import date, datetime, timezone
+
+from fastapi import APIRouter, Depends, Request
+from fastapi.responses import HTMLResponse
+from sqlalchemy import desc, func, select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.auth import require_token
+from app.config import get_settings, load_groups
+from app.db import get_session
+from app.models import StrategicLog
+from app.templates_env import templates
+
+router = APIRouter(dependencies=[Depends(require_token)])
+
+
+@router.get("/", response_class=HTMLResponse)
+async def dashboard(request: Request):
+    s = get_settings()
+    groups = load_groups(s.BASELINE_TOML, s.PORTFOLIO_TOML)
+    return templates.TemplateResponse(
+        request,
+        "dashboard.html",
+        {"groups": list(groups.keys()), "anchor": s.CASSANDRA_ANCHOR_DATE},
+    )
+
+
+@router.get("/news", response_class=HTMLResponse)
+async def news_page(request: Request):
+    return templates.TemplateResponse(request, "news.html", {})
+
+
+async def _resolve_log_date(session: AsyncSession, day: str | None) -> date:
+    """If `day` is YYYY-MM-DD use it; else fall back to the date of the most
+    recent generated log; else today."""
+    if day:
+        try:
+            return datetime.strptime(day, "%Y-%m-%d").date()
+        except ValueError:
+            pass
+    latest = (await session.execute(
+        select(StrategicLog.generated_at)
+        .order_by(desc(StrategicLog.generated_at))
+        .limit(1)
+    )).scalar_one_or_none()
+    if latest is not None:
+        return latest.date() if hasattr(latest, "date") else latest
+    return datetime.now(timezone.utc).date()
+
+
+def _log_page_context(target: date) -> dict:
+    s = get_settings()
+    return {
+        "selected_iso": target.isoformat(),
+        "selected_month": target.strftime("%Y-%m"),
+        "current_tone": s.CASSANDRA_TONE.upper(),
+        "current_analysis": s.CASSANDRA_ANALYSIS.upper(),
+    }
+
+
+@router.get("/log", response_class=HTMLResponse)
+async def log_page(
+    request: Request,
+    session: AsyncSession = Depends(get_session),
+):
+    target = await _resolve_log_date(session, None)
+    return templates.TemplateResponse(request, "log.html", _log_page_context(target))
+
+
+@router.get("/log/{day}", response_class=HTMLResponse)
+async def log_page_day(
+    request: Request,
+    day: str,
+    session: AsyncSession = Depends(get_session),
+):
+    target = await _resolve_log_date(session, day)
+    return templates.TemplateResponse(request, "log.html", _log_page_context(target))