23. OOP పిల్లర్స్ — ఇన్హెరిటెన్స్, ఎన్‌క్యాప్సులేషన్ & పాలిమార్ఫిజమ్

from abc import ABC, abstractmethod

# అబ్‌స్ట్రాక్ట్ ఇంటర్‌ఫేస్ కాంట్రాక్ట్
class PaymentGateway(ABC):
    def __init__(self, merchant_name: str):
        self.merchant_name = merchant_name

    @abstractmethod
    def authorize(self, amount: float) -> bool:
        """చెల్లింపును ఆథరైజ్ చేసే విధానం."""
        pass

    @abstractmethod
    def execute_payment(self, amount: float) -> bool:
        """నగదు బదిలీ జరిపే విధానం."""
        pass

# 1. UPI గేట్‌వే
class UPIPayment(PaymentGateway):
    def __init__(self, merchant_name: str, upi_vpa: str):
        super().__init__(merchant_name)
        self.upi_vpa = upi_vpa

    def authorize(self, amount: float) -> bool:
        print(f"📱 UPI VPA [{self.upi_vpa}] కి ₹{amount} పిన్ రిక్వెస్ట్ పంపబడింది.")
        return True

    def execute_payment(self, amount: float) -> bool:
        print(f"✅ UPI ద్వారా ₹{amount:,.2f} చెల్లింపు విజయవంతమైంది! మర్చంట్: {self.merchant_name}")
        return True

# 2. Credit Card గేట్‌వే
class CreditCardPayment(PaymentGateway):
    def __init__(self, merchant_name: str, card_last4: str):
        super().__init__(merchant_name)
        self.card_last4 = card_last4

    def authorize(self, amount: float) -> bool:
        print(f"💳 కార్డ్ *{self.card_last4} కి 3D-Secure OTP ధృవీకరణ పూర్తయింది.")
        return True

    def execute_payment(self, amount: float) -> bool:
        print(f"✅ క్రెడిట్ కార్డుతో ₹{amount:,.2f} వసూలు చేయబడింది! మర్చంట్: {self.merchant_name}")
        return True

# పాలిమార్ఫిక్ క్లయింట్ ఫంక్షన్
def process_order_checkout(gateway: PaymentGateway, total_amount: float):
    print("
--- ఆర్డర్ చెక్అవుట్ ప్రాసెస్ మొదలైంది ---")
    if gateway.authorize(total_amount):
        gateway.execute_payment(total_amount)

# పరీక్షించడం
upi = UPIPayment("భారత్ మార్ట్", "balaji@okaxis")
card = CreditCardPayment("భారత్ మార్ట్", "8821")

process_order_checkout(upi, 1499.0)
process_order_checkout(card, 8950.0)

# బేస్ క్లాస్
class BaseEmployee:
    def __init__(self, emp_id: str, name: str, base_salary: float):
        self.emp_id = emp_id
        self.name = name
        self._salary = base_salary

    @property
    def salary(self):
        return self._salary

    @salary.setter
    def salary(self, value):
        if value < 20000.0:
            raise ValueError("కనీస వేతనం ₹20,000 కన్నా తక్కువ ఉండకూడదు!")
        self._salary = value

    def calculate_annual_ctc(self) -> float:
        return self._salary * 12

# సాఫ్ట్‌వేర్ ఇంజనీర్ సబ్‌క్లాస్
class SoftwareEngineer(BaseEmployee):
    def __init__(self, emp_id: str, name: str, base_salary: float, tech_stack: list):
        super().__init__(emp_id, name, base_salary)
        self.tech_stack = tech_stack

    def calculate_annual_ctc(self) -> float:
        base_annual = super().calculate_annual_ctc()
        tech_allowance = 50000.0  # టెక్నాలజీ అలవెన్స్
        return base_annual + tech_allowance

# మేనేజర్ సబ్‌క్లాస్
class EngineeringManager(BaseEmployee):
    def __init__(self, emp_id: str, name: str, base_salary: float, team_size: int):
        super().__init__(emp_id, name, base_salary)
        self.team_size = team_size

    def calculate_annual_ctc(self) -> float:
        base_annual = super().calculate_annual_ctc()
        mgmt_bonus = self.team_size * 25000.0  # ప్రతి టీమ్ మెంబర్‌కు బోనస్
        return base_annual + mgmt_bonus

# టెస్టింగ్
dev = SoftwareEngineer("DEV101", "రాహుల్ వర్మ", 75000.0, ["Python", "Docker", "AWS"])
mgr = EngineeringManager("MGR001", "సుస్మిత", 120000.0, team_size=8)

print(f"👨‍💻 {dev.name} వార్షిక CTC: ₹{dev.calculate_annual_ctc():,.2f}")
print(f"👩‍💼 {mgr.name} వార్షిక CTC: ₹{mgr.calculate_annual_ctc():,.2f}")

# =====================================================================
# చాప్టర్ 23 ప్రాజెక్ట్: Enterprise Multi-Tier Logistics Shipping Pipeline
# కాన్సెప్ట్స్: ABC Contracts, super(), Property Validation, Polymorphism
# =====================================================================
from abc import ABC, abstractmethod
import datetime

# 1. అబ్‌స్ట్రాక్ట్ కార్గో షిప్పింగ్ బేస్ క్లాస్
class BaseShipment(ABC):
    def __init__(self, tracking_id: str, origin: str, dest: str, weight_kg: float):
        self.tracking_id = tracking_id
        self.origin = origin
        self.dest = dest
        self._weight_kg = weight_kg
        self.created_at = datetime.datetime.now()

    @property
    def weight_kg(self):
        return self._weight_kg

    @weight_kg.setter
    def weight_kg(self, value):
        if value <= 0:
            raise ValueError("కార్గో బరువు సున్నా కన్నా ఎక్కువ ఉండాలి!")
        self._weight_kg = value

    @abstractmethod
    def calculate_cost(self) -> float:
        """ప్రతి రవాణా విధానం స్వంత ధర లెక్కించే లాజిక్."""
        pass

    @abstractmethod
    def estimated_delivery_days(self) -> int:
        """డెలివరీకి పట్టే రోజుల అంచనా."""
        pass

# 2. రోడ్ లాజిస్టిక్స్ (సర్ఫేస్ డెలివరీ)
class RoadSurfaceShipment(BaseShipment):
    def __init__(self, tracking_id: str, origin: str, dest: str, weight_kg: float, distance_km: float):
        super().__init__(tracking_id, origin, dest, weight_kg)
        self.distance_km = distance_km

    def calculate_cost(self) -> float:
        base_rate = 50.0  # ప్రారంభ ఛార్జ్
        cost = base_rate + (self.weight_kg * 12.0) + (self.distance_km * 3.5)
        return cost

    def estimated_delivery_days(self) -> int:
        return max(2, int(self.distance_km / 400) + 1)

# 3. ఎయిర్ కార్గో (ఎక్స్‌ప్రెస్ డెలివరీ)
class AirExpressShipment(BaseShipment):
    def __init__(self, tracking_id: str, origin: str, dest: str, weight_kg: float, is_hazardous: bool = False):
        super().__init__(tracking_id, origin, dest, weight_kg)
        self.is_hazardous = is_hazardous

    def calculate_cost(self) -> float:
        flat_air_surcharge = 500.0
        haz_fee = 1200.0 if self.is_hazardous else 0.0
        return flat_air_surcharge + haz_fee + (self.weight_kg * 65.0)

    def estimated_delivery_days(self) -> int:
        return 1  # నెక్స్ట్ డే ఎక్స్‌ప్రెస్

# 4. సెంట్రల్ లాజిస్టిక్స్ డిస్పాచర్ ఇంజిన్ (పాలిమార్ఫిక్ ప్రాసెసర్)
class LogisticsDispatcher:
    def __init__(self, hub_name: str):
        self.hub_name = hub_name
        self.manifest = []

    def dispatch_cargo(self, shipment: BaseShipment):
        # పాలిమార్ఫిజమ్: shipment రకం ఏదైనా సంబంధం లేకుండా calculate_cost() పనిచేస్తుంది
        cost = shipment.calculate_cost()
        days = shipment.estimated_delivery_days()
        self.manifest.append(shipment)
        
        print(f"📦 [ట్రాకింగ్: {shipment.tracking_id}] డిస్పాచ్ అయింది!")
        print(f"   • రకం: {shipment.__class__.__name__}")
        print(f"   • మార్గం: {shipment.origin} -> {shipment.dest} (బరువు: {shipment.weight_kg} KG)")
        print(f"   • షిప్పింగ్ ఛార్జ్: ₹{cost:,.2f} | అంచనా డెలివరీ: {days} రోజు(లు)")
        print("-" * 65)

    def print_manifest_summary(self):
        print(f"
==================== {self.hub_name} మానిఫెస్ట్ సారాంశం ====================")
        total_freight_cost = sum(s.calculate_cost() for s in self.manifest)
        total_weight = sum(s.weight_kg for s in self.manifest)
        print(f"మొత్తం పార్సిల్స్: {len(self.manifest)}")
        print(f"మొత్తం కార్గో బరువు: {total_weight:,.2f} KG")
        print(f"మొత్తం షిప్పింగ్ రాబడి (Revenue): ₹{total_freight_cost:,.2f}")
        print("========================================================================
")


# =====================================================================
# పైప్‌లైన్ సిమ్యులేషన్
# =====================================================================
dispatcher = LogisticsDispatcher("హైదరాబాద్ సెంట్రల్ లాజిస్టిక్స్ హబ్")

# వివిధ రకాల రవాణా ఆర్డర్లు
shipment1 = RoadSurfaceShipment("TRK-HYD-001", "హైదరాబాద్", "విజయవాడ", weight_kg=25.0, distance_km=275.0)
shipment2 = AirExpressShipment("TRK-AIR-909", "హైదరాబాద్", "ముంబై", weight_kg=8.5, is_hazardous=False)
shipment3 = AirExpressShipment("TRK-AIR-910", "హైదరాబాద్", "న్యూఢిల్లీ", weight_kg=15.0, is_hazardous=True)

# డిస్పాచ్ ప్రాసెసింగ్
dispatcher.dispatch_cargo(shipment1)
dispatcher.dispatch_cargo(shipment2)
dispatcher.dispatch_cargo(shipment3)

# మొత్తం హబ్ సారాంశం
dispatcher.print_manifest_summary()