subcontractor-payment-tracker

# Subcontractor Payment Tracker ## Business Case ### Problem Statement Subcontractor payments require careful management: - Complex payment schedules - Lien waiver tracking - Compliance documentation - Cash flow coordination ### Solution Comprehensive subcontractor payment tracking with lien waiver management, compliance monitoring, and payment scheduling. ## Technical Implementation ```python import pandas as pd from datetime import datetime, date, timedelta from typing import Dict, Any, List, Optional from dataclasses import dataclass, field from enum import Enum class PaymentStatus(Enum): SCHEDULED = "scheduled" INVOICED = "invoiced" APPROVED = "approved" PAID = "paid" HELD = "held" DISPUTED = "disputed" class WaiverType(Enum): CONDITIONAL_PROGRESS = "conditional_progress" UNCONDITIONAL_PROGRESS = "unconditional_progress" CONDITIONAL_FINAL = "conditional_final" UNCONDITIONAL_FINAL = "unconditional_final" @dataclass class LienWaiver: waiver_id: str waiver_type: WaiverType through_date: date amount: float received_date: Optional[date] file_path: str = "" @dataclass class SubcontractorPayment: payment_id: str subcontractor_id: str invoice_number: str invoice_date: date amount: float retention_held: float status: PaymentStatus scheduled_date: date paid_date: Optional[date] = None check_number: str = "" lien_waiver: Optional[LienWaiver] = None notes: str ...