feat: Implement a new terminal dashboard featuring an analytics panel, sparklines, and foundational UI components and utilities.

2026-03-08 04:53:38 +08:00
parent d26bce6358
commit d2107cbcbe
13 changed files with 1542 additions and 100 deletions
@@ -0,0 +1,357 @@
+// --- Polymarket Market Types ---
+
+export interface MarketBook {
+  best_bid: number;
+  best_ask: number;
+  bid_levels: [number, number][]; // [price, size]
+  ask_levels: [number, number][]; // [price, size]
+}
+
+export interface MarketToken {
+  outcome: string;
+  token_id: string;
+  implied_probability: number;
+  buy_price: number;
+  sell_price: number;
+  midpoint: number;
+  last_trade_price: number;
+  book?: MarketBook;
+}
+
+export interface Trade {
+  id: string;
+  price: number;
+  size: number;
+  side: "buy" | "sell";
+  timestamp: string;
+  timestamp_iso?: string | null;
+  outcome?: string | null;
+  asset?: string | null;
+  transaction_hash?: string | null;
+}
+
+export interface MarketSnapshot {
+  id: string;
+  question: string;
+  title: string;
+  slug: string;
+  event_slug: string;
+  condition_id: string;
+  target_date: string;
+  active: boolean;
+  closed: boolean;
+  archived: boolean;
+  enable_order_book: boolean;
+  liquidity: number;
+  volume: number;
+  start_date: string;
+  end_date: string;
+  tokens: MarketToken[];
+  recent_trades: Trade[];
+}
+
+export interface MarketPlatformData {
+  city: string;
+  target_date: string;
+  fetched_at: string;
+  market_count: number;
+  markets: MarketSnapshot[];
+  websocket: {
+    market_url: string;
+    asset_ids: string[];
+    condition_ids: string[];
+  };
+}
+
+// --- Official Weather Types (Aviation) ---
+
+export interface METARObservation {
+  source: string;
+  icao: string;
+  station_name: string;
+  timestamp: string;
+  observation_time: string;
+  current: {
+    temp: number;
+    max_temp_so_far: number;
+    max_temp_time: string;
+    dewpoint: number;
+    wind_speed_kt: number;
+    wind_dir: number;
+    visibility_mi: string | number;
+    wx_desc: string | null;
+    altimeter: number;
+    clouds: any[];
+  };
+  recent_temps: number[];
+  today_obs: any[];
+  recent_obs: any[];
+  unit: "celsius" | "fahrenheit";
+}
+
+export interface AviationWeatherData {
+  available: boolean;
+  source: string;
+  icao: string;
+  observation: METARObservation;
+}
+
+// --- Official Weather Types (Weather.gov) ---
+
+export interface WeatherGovPeriod {
+  name: string;
+  start_time?: string;
+  end_time?: string;
+  is_daytime?: boolean;
+  temperature: number;
+  temperature_unit: string;
+  wind_speed?: string;
+  wind_direction?: string;
+  short_forecast?: string;
+  detailed_forecast?: string;
+}
+
+export interface WeatherGovAlert {
+  id: string;
+  event: string;
+  severity: string;
+  certainty: string;
+  urgency: string;
+  headline: string;
+  onset: string;
+  expires: string;
+}
+
+export interface WeatherGovData {
+  available: boolean;
+  source: string;
+  city: string;
+  grid: any;
+  nearest_station: {
+    station_identifier?: string;
+    name?: string;
+    timezone?: string;
+    elevation_m?: number | null;
+  } | null;
+  latest_observation: {
+    station_identifier?: string;
+    temperature_c?: number | null;
+    dewpoint_c?: number | null;
+    wind_direction_deg?: number | null;
+    wind_speed_kmh?: number | null;
+    text_description?: string | null;
+    timestamp?: string;
+  } | null;
+  stations: any[];
+  forecast_periods: WeatherGovPeriod[];
+  hourly_periods: WeatherGovPeriod[];
+  active_alerts: WeatherGovAlert[];
+}
+
+export interface OfficialWeatherData {
+  city: string;
+  fetched_at: string;
+  aviation_weather?: AviationWeatherData;
+  weather_gov?: WeatherGovData;
+}
+
+// --- City List Types ---
+
+export interface CityInfo {
+  name: string;
+  display_name: string;
+  lat: number;
+  lon: number;
+  risk_level: "low" | "medium" | "high";
+  risk_emoji: string;
+  airport: string;
+  icao: string;
+  temp_unit: "celsius" | "fahrenheit";
+  is_major: boolean;
+}
+
+export interface CitiesResponse {
+  cities: CityInfo[];
+}
+
+// --- Full City Analysis Types ---
+
+export interface ModelComparison {
+  [key: string]: number | undefined;
+  "Open-Meteo"?: number;
+  ECMWF?: number;
+  GFS?: number;
+  ICON?: number;
+  GEM?: number;
+  JMA?: number;
+  MGM?: number;
+  NWS?: number;
+  Meteoblue?: number;
+}
+
+export interface DEBAnalysis {
+  prediction: number | null;
+  weights_info?: string;
+}
+
+export interface TrendInfo {
+  direction: string;
+  recent: Array<{ time: string; temp: number }>;
+  is_cooling: boolean;
+  is_dead_market: boolean;
+}
+
+export interface PeakInfo {
+  hours: string[];
+  first_h: number;
+  last_h: number;
+  status: string;
+}
+
+export interface CityAnalysis {
+  name: string;
+  display_name: string;
+  lat: number;
+  lon: number;
+  temp_symbol: string;
+  local_time: string;
+  local_date: string;
+  risk: {
+    level: string;
+    emoji: string;
+    airport: string;
+    icao: string;
+    distance_km: number;
+    warning: string;
+  };
+  current: {
+    temp: number | null;
+    max_so_far: number | null;
+    max_temp_time: string;
+    wu_settlement: number | null;
+    obs_time: string;
+    obs_age_min: number | null;
+    wind_speed_kt: number | null;
+    wind_dir: number | null;
+    humidity: number | null;
+    cloud_desc: string;
+    clouds_raw: Array<{ cover: string; base: number | null }>;
+    visibility_mi: number | null;
+    wx_desc: string | null;
+  };
+  mgm?: {
+    temp?: number | null;
+    time?: string;
+    today_high?: number | null;
+    today_low?: number | null;
+  };
+  forecast: {
+    today_high: number | null;
+    daily: any[];
+  };
+  multi_model: ModelComparison;
+  deb: DEBAnalysis;
+  probabilities: {
+    mu?: number | null;
+    distribution?: any[];
+  };
+  hourly?: any;
+  metar_recent_obs?: any[];
+  trend?: TrendInfo;
+  peak?: PeakInfo;
+  ai_analysis: string;
+  updated_at: string;
+}
+
+// --- Aggregated Detail Types ---
+
+export interface MarketScan {
+  available: boolean;
+  reason: string | null;
+  primary_market: any | null;
+  selected_date: string | null;
+  selected_condition_id: string | null;
+  selected_slug: string | null;
+  temperature_bucket: any | null;
+  model_probability: number | null;
+  market_price: number | null;
+  edge_percent: number | null;
+  signal_label: "BUY YES" | "BUY NO" | "MONITOR";
+  confidence: "low" | "medium" | "high";
+  yes_token: MarketToken | null;
+  no_token: MarketToken | null;
+  yes_buy: number | null;
+  yes_sell: number | null;
+  no_buy: number | null;
+  no_sell: number | null;
+  last_trade_price: number | null;
+  liquidity: number | null;
+  volume: number | null;
+  sparkline: number[];
+  recent_trades: Trade[];
+  websocket: any;
+}
+
+export interface CityDetail {
+  city: string;
+  fetched_at: string;
+  overview: {
+    name: string;
+    display_name: string;
+    icao: string;
+    airport: string;
+    lat: number;
+    lon: number;
+    local_time: string;
+    local_date: string;
+    temp_symbol: string;
+    current_temp: number | null;
+    deb_prediction: number | null;
+    risk_level: string;
+    risk_warning: string;
+    updated_at: string;
+  };
+  official: {
+    available: boolean;
+    metar: any;
+    weather_gov: WeatherGovData;
+    mgm: any;
+    mgm_nearby: any[];
+  };
+  timeseries: {
+    metar_recent_obs: any[];
+    metar_today_obs: any[];
+    hourly: any;
+    mgm_hourly: any[];
+    forecast_daily: any[];
+  };
+  models: ModelComparison;
+  probabilities: {
+    mu: number | null;
+    distribution: any[];
+  };
+  market_scan: MarketScan;
+  risk: any;
+  ai_analysis: string;
+  errors: Record<string, string>;
+}
+
+export interface CitySummary {
+  name: string;
+  display_name: string;
+  icao: string;
+  local_time: string;
+  temp_symbol: string;
+  current: {
+    temp: number | null;
+    obs_time: string;
+  };
+  deb: {
+    prediction: number | null;
+  };
+  risk: {
+    level: string;
+    warning: string;
+  };
+  updated_at: string;
+}
@@ -0,0 +1,49 @@
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/**
+ * Utility for merging tailwind classes safely.
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+
+/**
+ * Formats a number as a currency string.
+ */
+export function formatCurrency(value: number, decimals: number = 2) {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals,
+  }).format(value);
+}
+
+/**
+ * Formats a percentage from midpoint.
+ */
+export function formatPercent(value: number) {
+  return (value * 100).toFixed(1) + "%";
+}
+
+/**
+ * Converts Fahrenheit to Celsius.
+ */
+export function fToC(f: number) {
+  return ((f - 32) * 5) / 9;
+}
+
+/**
+ * Formats a date/time string to HH:MM:SS.
+ */
+export function formatTime(date: Date | string) {
+  const d = typeof date === "string" ? new Date(date) : date;
+  if (isNaN(d.getTime())) return String(date);
+  return d.toLocaleTimeString("zh-CN", {
+    hour12: false,
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+  });
+}