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>

.env.example

@@ -0,0 +1,27 @@
+# Cassandra environment — copy to .env and fill in.
+# .env is mounted read-only into the containers; never commit real secrets.
+
+# --- Database (MariaDB) ---
+MARIADB_ROOT_PASSWORD=changeme-root
+MARIADB_DATABASE=cassandra
+MARIADB_USER=cassandra
+MARIADB_PASSWORD=changeme
+
+# --- API keys (mirror of the prototype .env) ---
+API_KEY=                  # Trading 212 API key
+SECRET_KEY=               # Trading 212 secret
+FRED_API_KEY=             # FRED economic data
+OPENROUTER_API_KEY=       # OpenRouter (AI log generation)
+
+# --- App ---
+CASSANDRA_TOKEN=          # Bearer token required if set; LAN-only no-auth if empty
+CASSANDRA_PORT=8000
+CASSANDRA_BASE_CURRENCY=GBP
+CASSANDRA_ANCHOR_DATE=2026-03-04   # YYYY-MM-DD; used by market_pulse anchor column
+CASSANDRA_MOCK=0          # 1 = serve canned fixtures, skip live APIs
+
+# --- AI log ---
+OPENROUTER_MODEL=deepseek/deepseek-v4-flash    # cheap & fast; swap to anthropic/claude-sonnet-4.6 or anthropic/claude-opus-4.7 for higher quality
+OPENROUTER_MONTHLY_CAP_USD=20
+CASSANDRA_TONE=INTERMEDIATE      # NOVICE | INTERMEDIATE | PRO
+CASSANDRA_ANALYSIS=SPECULATIVE   # DRY | SPECULATIVE