from typing import Optional, List, Dict, Any, Union from pydantic import BaseModel, Field class DashboardMetrics(BaseModel): processedToday: int = 0 needsReview: int = 0 lastExportAt: Optional[str] = None overallAccuracy: Optional[float] = None class ActivityItem(BaseModel): id: str title: str description: Optional[str] = None occurredAt: str status: str # "success" | "info" | "warning" | "error" class StatementSummary(BaseModel): id: str fileName: str bankName: Optional[str] = None uploadedAt: str transactionCount: int accuracy: Optional[float] = None status: str # "uploaded" | "processing" | "ready" | "review" | "exported" | "archived" | "failed" class UploadInitResponse(BaseModel): statementId: str uploadUrl: Optional[str] = None class ProcessingStage(BaseModel): key: str label: str status: str # "pending" | "active" | "completed" | "failed" progress: int = 0 class ProcessingState(BaseModel): statementId: str overallProgress: int estimatedSecondsRemaining: Optional[int] = None stages: List[ProcessingStage] ocrEnabled: bool = True multiEngine: bool = True confidenceScoring: bool = True validationChecks: bool = True status: Optional[str] = None class ReviewSession(BaseModel): statementId: str fileName: str bankName: Optional[str] = None pdfUrl: str uploadedAt: str uploadedBy: str = "system" class ReviewMetrics(BaseModel): totalTransactions: int needsAttention: int lowConfidence: int balanceIssues: int gapsDetected: int overallAccuracy: float class FlaggedTransaction(BaseModel): id: str severity: str # "high" | "medium" | "low" issueType: str pageNum: int confidence: Optional[float] = None amount: Optional[float] = None description: str statementId: str class HistoryRow(BaseModel): id: str fileName: str uploadedAt: str status: str transactionCount: int accuracy: Optional[float] = None exported: bool = False bankName: Optional[str] = None class AppSettings(BaseModel): ocrEnabled: bool = True confidenceThreshold: float = 0.7 autoExportEnabled: bool = False auditRetentionDays: int = 90 defaultExportFormat: str = "xlsx" extractLast3Months: bool = True