cash-flow-forecaster

# Cash Flow Forecaster ## Business Case ### Problem Statement Poor cash flow management causes issues: - Insufficient funds for payments - Missed early payment discounts - Inaccurate financial projections - Difficulty in financing negotiations ### Solution Generate cash flow forecasts from schedule and cost data, including S-curve projections and payment timing analysis. ### Business Value - **Financial planning** - Accurate funding requirements - **Vendor relations** - Timely payments - **Financing** - Support loan draw schedules - **Decision support** - Cash position awareness ## Technical Implementation ```python import pandas as pd import numpy as np from datetime import datetime, date, timedelta from typing import Dict, Any, List, Optional, Tuple from dataclasses import dataclass, field from enum import Enum class CashFlowType(Enum): """Cash flow types.""" INFLOW = "inflow" OUTFLOW = "outflow" class PaymentTerms(Enum): """Standard payment terms.""" NET_30 = 30 NET_45 = 45 NET_60 = 60 NET_90 = 90 MILESTONE = 0 PROGRESS = 0 @dataclass class CostItem: """Cost item for cash flow.""" item_id: str description: str total_amount: float start_date: date end_date: date payment_terms: PaymentTerms distribution: str = "linear" # linear, front_loaded, back_loaded, s_curve retention_percent: float = 0.10 category: str = "" @dataclass class PaymentSchedule: """Scheduled payment.""" pa...