feat: Introduce core API routes for city data, history, authentication, and payments, along with a new frontend dashboard utility file.

frontend/lib/dashboard-utils.ts

@@ -1339,19 +1339,23 @@ export function getHistorySummary(
       ? row.date < cityLocalDate
       : row.date < new Date().toISOString().slice(0, 10);
   });
+  const comparableSettledData = settledData.filter((row) => {
+    const actual = toFinite(row.actual);
+    const deb = toFinite(row.deb);
+    return actual != null && deb != null;
+  });
 
   let hits = 0;
   const debErrors: number[] = [];
   const modelErrors: Record<string, number[]> = {};
 
-  settledData.forEach((row) => {
+  comparableSettledData.forEach((row) => {
     const actual = toFinite(row.actual);
     const deb = toFinite(row.deb);
-    if (actual != null && deb != null) {
-      debErrors.push(Math.abs(actual - deb));
-      if (wuRound(actual) === wuRound(deb)) {
-        hits += 1;
-      }
+    if (actual == null || deb == null) return;
+    debErrors.push(Math.abs(actual - deb));
+    if (wuRound(actual) === wuRound(deb)) {
+      hits += 1;
     }
 
     const forecasts = row.forecasts || {};
@@ -1389,7 +1393,7 @@ export function getHistorySummary(
   let debWinDaysVsBest = 0;
   let debVsBestComparableDays = 0;
   if (bestModelName) {
-    settledData.forEach((row) => {
+    comparableSettledData.forEach((row) => {
       const actual = toFinite(row.actual);
       const deb = toFinite(row.deb);
       const bestModelVal = toFinite(row.forecasts?.[bestModelName]);
@@ -1430,7 +1434,7 @@ export function getHistorySummary(
       : null,
     mgms: recentData.map((row) => row.mgm ?? null),
     recentData,
-    settledCount: settledData.length,
+    settledCount: comparableSettledData.length,
     actuals: recentData.map((row) => row.actual),
   };
 }

web/routes.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import json
 import os
 from datetime import datetime, timedelta
 from typing import Optional
@@ -48,6 +49,29 @@ from web.core import (
 
 router = APIRouter()
 
+_SETTLEMENT_HISTORY_CACHE: Optional[dict] = None
+
+
+def _load_settlement_history() -> dict:
+    global _SETTLEMENT_HISTORY_CACHE
+    if _SETTLEMENT_HISTORY_CACHE is not None:
+        return _SETTLEMENT_HISTORY_CACHE
+
+    project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+    history_path = os.path.join(
+        project_root,
+        "artifacts",
+        "probability_calibration",
+        "settlement_history.json",
+    )
+    try:
+        with open(history_path, "r", encoding="utf-8") as handle:
+            payload = json.load(handle)
+        _SETTLEMENT_HISTORY_CACHE = payload if isinstance(payload, dict) else {}
+    except Exception:
+        _SETTLEMENT_HISTORY_CACHE = {}
+    return _SETTLEMENT_HISTORY_CACHE
+
 
 def _parse_snapshot_dt(value: object) -> Optional[datetime]:
     raw = str(value or "").strip()
@@ -198,8 +222,11 @@ async def city_history(request: Request, name: str):
     project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
     history_file = os.path.join(project_root, "data", "daily_records.json")
     data = load_history(history_file)
+    settlement_history = _load_settlement_history()
+    settlement_city_data = settlement_history.get(city, {})
 
-    if city not in data:
+    city_data = data.get(city, {}) if isinstance(data.get(city, {}), dict) else {}
+    if not city_data and not isinstance(settlement_city_data, dict):
         source = str(CITIES.get(city, {}).get("settlement_source") or "metar").strip().lower()
         return {
             "history": [],
@@ -207,10 +234,20 @@ async def city_history(request: Request, name: str):
             "settlement_source_label": SETTLEMENT_SOURCE_LABELS.get(source, source.upper()),
         }
 
-    city_data = data[city]
+    settlement_city_data = settlement_city_data if isinstance(settlement_city_data, dict) else {}
     out = []
-    for day, rec in sorted(city_data.items()):
+    all_days = sorted(set(city_data.keys()) | set(settlement_city_data.keys()))
+    for day in all_days:
+        rec = city_data.get(day, {})
+        if not isinstance(rec, dict):
+            rec = {}
+        settlement_rec = settlement_city_data.get(day, {})
+        if not isinstance(settlement_rec, dict):
+            settlement_rec = {}
+
         act = rec.get("actual_high")
+        if act is None:
+            act = settlement_rec.get("max_temp")
         deb = rec.get("deb_prediction")
         mu = rec.get("mu")
         snapshots = load_snapshot_rows_for_day(city, day)