22. ఆబ్జెక్ట్ ఓరియెంటెడ్ ప్రోగ్రామింగ్ (OOP) బేసిక్స్ — Classes, Objects, __init__ & self

# చాప్టర్ 22: బ్యాంకింగ్ అకౌంట్ OOP మోడల్
class BankAccount:
    bank_name = "State Bank of Telugu"
    interest_rate = 0.04  # 4% వార్షిక వడ్డీ

    def __init__(self, account_no: str, holder_name: str, opening_balance: float = 1000.0):
        self.account_no = account_no
        self.holder_name = holder_name
        self.balance = opening_balance
        self.transactions = []

    def deposit(self, amount: float):
        if amount <= 0:
            print("❌ డిపాజిట్ మొత్తం పాజిటివ్‌గా ఉండాలి!")
            return False
        self.balance += amount
        self.transactions.append(f"+ ₹{amount:,.2f} జమ చేయబడింది")
        print(f"✅ ₹{amount:,.2f} డిపాజిట్ విజయవంతం. ప్రస్తుత బ్యాలెన్స్: ₹{self.balance:,.2f}")
        return True

    def withdraw(self, amount: float):
        if amount > self.balance:
            print(f"❌ విత్‌డ్రా విఫలం! ఖాతాలో తగినంత నగదు లేదు (బ్యాలెన్స్: ₹{self.balance:,.2f})")
            return False
        self.balance -= amount
        self.transactions.append(f"- ₹{amount:,.2f} డ్రా చేయబడింది")
        print(f"💸 ₹{amount:,.2f} విత్‌డ్రా సక్సెస్. మిగిలిన బ్యాలెన్స్: ₹{self.balance:,.2f}")
        return True

    def statement(self):
        print(f"
--- {BankAccount.bank_name} స్టేట్‌మెంట్: {self.holder_name} ({self.account_no}) ---")
        for tx in self.transactions:
            print("  *", tx)
        print(f"నికర నిల్వ (Net Balance): ₹{self.balance:,.2f}
")

# ఆబ్జెక్టులను సృష్టించి పరీక్షిద్దాం
acc1 = BankAccount("SB-10928", "రమేష్ వర్మ", 15000.0)
acc1.deposit(5000.0)
acc1.withdraw(3500.0)
acc1.withdraw(25000.0)  # విఫలమవుతుంది
acc1.statement()

import re

class Employee:
    company_name = "Hyderabad Tech Innovators"
    total_employees = 0

    def __init__(self, emp_id: str, name: str, role: str, salary: float):
        self.emp_id = emp_id
        self.name = name
        self.role = role
        self.salary = salary
        Employee.total_employees += 1

    # ఇన్స్టాన్స్ మెథడ్
    def apply_bonus(self, percentage: float):
        bonus_amount = self.salary * (percentage / 100)
        self.salary += bonus_amount
        print(f"🎉 {self.name} కి {percentage}% బోనస్ (₹{bonus_amount:,.2f}) లభించింది. కొత్త శాలరీ: ₹{self.salary:,.2f}")

    # క్లాస్ మెథడ్: ఆల్టర్నేటివ్ కన్‌స్ట్రక్టర్ (CSV డేటా నుండి ఆబ్జెక్ట్ సృష్టి)
    @classmethod
    def from_csv_line(cls, csv_line: str):
        parts = [p.strip() for p in csv_line.split(",")]
        emp_id, name, role, salary_str = parts
        return cls(emp_id, name, role, float(salary_str))

    # స్టాటిక్ మెథడ్: స్వతంత్ర ఈమెయిల్ వాలిడేటర్
    @staticmethod
    def is_valid_corp_email(email: str) -> bool:
        pattern = r"^[a-zA-Z0-9_.+-]+@techinnovators.com$"
        return bool(re.match(pattern, email))

# పరీక్షించడం
emp1 = Employee("EMP01", "సరిత", "Senior Architect", 125000.0)
emp2 = Employee.from_csv_line("EMP02, విక్రమ్ రాజ్, DevOps Lead, 110000.0")

emp1.apply_bonus(10)
print(f"మొత్తం ఉద్యోగుల సంఖ్య: {Employee.total_employees}")
print("ఈమెయిల్ సరియైనదా?:", Employee.is_valid_corp_email("vikram@techinnovators.com"))
print("వ్యక్తిగత జీమెయిల్ సరియైనదా?:", Employee.is_valid_corp_email("vikram@gmail.com"))

# =====================================================================
# చాప్టర్ 22 ప్రాజెక్ట్: Smart Autonomous Vehicle Fleet Engine
# ఫీచర్స్: Classes & Objects, Class Attributes vs Instance Attributes,
#          Alternative Factory Constructors (@classmethod), Utility Validators (@staticmethod)
# =====================================================================
import datetime

class AutonomousVehicle:
    fleet_name = "Cyberabad Smart EV Mobility"
    fleet_registry = []
    min_battery_threshold = 15.0  # 15% కన్నా తక్కువ ఉంటే రైడ్ ఆగిపోతుంది

    def __init__(self, vehicle_id: str, model: str, battery_percentage: float = 100.0):
        self.vehicle_id = vehicle_id
        self.model = model
        self.battery_percentage = max(0.0, min(100.0, battery_percentage))
        self.odometer_km = 0.0
        self.status = "IDLE"  # IDLE, IN_TRANSIT, CHARGING, MAINTENANCE
        self.trip_log = []
        
        # ఫ్లీట్ రిజిస్ట్రీలో ఈ ఆబ్జెక్ట్‌ను నమోదు చేయడం
        AutonomousVehicle.fleet_registry.append(self)

    # 1. ఇన్స్టాన్స్ మెథడ్: ట్రిప్ రన్ చేయడం
    def execute_trip(self, distance_km: float, destination: str):
        battery_required = distance_km * 0.45  # ప్రతి 1 కిమీ కి 0.45% ఛార్జింగ్ అవసరం
        
        if self.status != "IDLE":
            print(f"⚠️ [{self.vehicle_id}] రైడ్‌కు సిద్ధంగా లేదు! ప్రస్తుత స్థితి: {self.status}")
            return False

        if (self.battery_percentage - battery_required) < AutonomousVehicle.min_battery_threshold:
            print(f"❌ [{self.vehicle_id}] బ్యాటరీ సరిపోదు! అవసరమైనది: {battery_required:.1f}%, ఉన్నది: {self.battery_percentage:.1f}%")
            self.status = "CHARGING"
            return False

        # ట్రిప్ ప్రారంభం
        self.status = "IN_TRANSIT"
        self.battery_percentage -= battery_required
        self.odometer_km += distance_km
        
        trip_entry = {
            "destination": destination,
            "distance_km": distance_km,
            "battery_used": battery_required,
            "timestamp": datetime.datetime.now().strftime("%H:%M:%S")
        }
        self.trip_log.append(trip_entry)
        self.status = "IDLE"
        
        print(f"🚗 [{self.vehicle_id}] '{destination}' ట్రిప్ విజయవంతం! ప్రయాణ దూరం: {distance_km} KM. మిగిలిన బ్యాటరీ: {self.battery_percentage:.1f}%")
        return True

    # 2. ఇన్స్టాన్స్ మెథడ్: రీఛార్జ్ చేయడం
    def recharge(self, target_percentage: float = 100.0):
        print(f"⚡ [{self.vehicle_id}] ఛార్జింగ్ ప్రారంభమైంది... {self.battery_percentage:.1f}% నుండి {target_percentage:.1f}% కి")
        self.battery_percentage = target_percentage
        self.status = "IDLE"
        print(f"🔋 [{self.vehicle_id}] ఛార్జింగ్ పూర్తయింది. రైడ్‌కు సిద్ధం!")

    # 3. క్లాస్ మెథడ్: టెలిమెట్రీ JSON/డిక్షనరీ నుండి ఆబ్జెక్ట్ సృష్టించే ఫ్యాక్టరీ
    @classmethod
    def from_telemetry_dict(cls, data: dict):
        v_id = data.get("vid", "UNKNOWN")
        model = data.get("mod", "Standard EV")
        bat = float(data.get("bat", 100.0))
        return cls(v_id, model, bat)

    # 4. క్లాస్ మెథడ్: మొత్తం ఫ్లీట్ సారాంశ నివేదిక (Fleet Analytics)
    @classmethod
    def print_fleet_summary(cls):
        print("
" + "=" * 65)
        print(f"📊 {cls.fleet_name} — ఎగ్జిక్యూటివ్ ఫ్లీట్ రిపోర్ట్")
        print("=" * 65)
        print(f"మొత్తం యాక్టివ్ వాహనాలు: {len(cls.fleet_registry)}")
        total_kms = sum(v.odometer_km for v in cls.fleet_registry)
        avg_bat = sum(v.battery_percentage for v in cls.fleet_registry) / len(cls.fleet_registry) if cls.fleet_registry else 0.0
        
        print(f"మొత్తం ప్రయాణించిన దూరం: {total_kms:,.2f} KM")
        print(f"సగటు బ్యాటరీ శాతం: {avg_bat:.1f}%")
        print("-" * 65)
        for v in cls.fleet_registry:
            print(f"• ID: {v.vehicle_id:<8} | మోడల్: {v.model:<12} | బాటరీ: {v.battery_percentage:>5.1f}% | ఓడోమీటర్: {v.odometer_km:>6.1f} KM | స్టేటస్: {v.status}")
        print("=" * 65 + "
")

    # 5. స్టాటిక్ మెథడ్: వెహికల్ ID ఫార్మాట్ వాలిడేషన్ (ఉదా: EV-HYD-101)
    @staticmethod
    def validate_id_format(vid: str) -> bool:
        parts = vid.split("-")
        return len(parts) == 3 and parts[0] == "EV" and parts[1].isalpha() and parts[2].isdigit()


# =====================================================================
# సిమ్యులేషన్ మరియు టెస్టింగ్ డ్రైవర్
# =====================================================================
print("🚦 స్మార్ట్ ఆటోనమస్ ఫ్లీట్ సిమ్యులేషన్ ప్రారంభమవుతోంది...")

# ID వాలిడేషన్ పరిశీలన
test_id = "EV-HYD-901"
print(f"వెహికల్ ID '{test_id}' చెల్లుబాటు తనిఖీ: {AutonomousVehicle.validate_id_format(test_id)}")

# వాహనాల ఇన్స్టాన్షియేషన్ (డైరెక్ట్ & ఫ్యాక్టరీ మెథడ్)
v1 = AutonomousVehicle("EV-HYD-101", "Tesla Cyber", battery_percentage=90.0)
v2 = AutonomousVehicle("EV-HYD-102", "Tata Nexon EV", battery_percentage=30.0)
v3 = AutonomousVehicle.from_telemetry_dict({"vid": "EV-BLR-505", "mod": "MG ZS EV", "bat": 95.0})

# రైడ్ ఎగ్జిక్యూషన్లు
v1.execute_trip(25.0, "హైటెక్ సిటీ నుండి రాజీవ్ గాంధీ ఎయిర్‌పోర్ట్")
v2.execute_trip(45.0, "గచ్చిబౌలి నుండి రామంతాపూర్")  # బ్యాటరీ సరిపోక ఫెయిల్ అవుతుంది
v2.recharge(100.0)                                    # రీఛార్జ్ చేశాక మళ్లీ ట్రై చేద్దాం
v2.execute_trip(45.0, "గచ్చిబౌలి నుండి రామంతాపూర్")  # ఇప్పుడు సక్సెస్ అవుతుంది
v3.execute_trip(12.0, "ఎలక్ట్రానిక్ సిటీ కారిడార్")

# ఫ్లీట్ సారాంశ నివేదిక ముద్రణ
AutonomousVehicle.print_fleet_summary()