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/schemas.py

@@ -0,0 +1,73 @@
+"""Pydantic response shapes for the JSON API."""
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import BaseModel
+
+
+class QuoteOut(BaseModel):
+    symbol: str
+    source: str
+    label: str
+    group_name: str
+    price: float | None
+    currency: str | None
+    as_of: str | None
+    changes: dict | None
+    fetched_at: datetime
+    error: str | None = None
+
+
+class HeadlineOut(BaseModel):
+    source: str
+    category: str
+    title: str
+    url: str
+    published_at: datetime
+
+
+class JobStatus(BaseModel):
+    name: str
+    last_started: datetime | None = None
+    last_finished: datetime | None = None
+    status: str | None = None
+    error: str | None = None
+    items_written: int | None = None
+
+
+class HealthOut(BaseModel):
+    db: str  # "ok" | "down"
+    jobs: list[JobStatus]
+
+
+class StrategicLogOut(BaseModel):
+    generated_at: datetime
+    model: str
+    anchor_date: str | None
+    content: str
+    prompt_tokens: int | None
+    completion_tokens: int | None
+
+
+class PositionOut(BaseModel):
+    ticker: str
+    name: str | None
+    quantity: float | None
+    average_price: float | None
+    current_price: float | None
+    ppl: float | None
+    ppl_pct: float | None = None  # (current-avg)/avg * 100 — currency-neutral
+
+
+class PortfolioSummary(BaseModel):
+    name: str
+    snapshot_at: datetime | None
+    currency: str
+    total_value: float | None
+    cash: float | None
+    invested: float | None
+    total_cost: float | None = None
+    unrealized_ppl: float | None = None
+    realized_ppl: float | None = None
+    positions: list[PositionOut] = []