j dZddlmZmZmZddlmZddlmZm Z ddl mZ ddl m Z mZdeedefd Zd ed ed ed edef dZdedede efdZdefdZddedededefdZddededefdZddeededefdZy)z Dashboard utility functions for Aimantis hotel management platform. Provides reusable helper functions for: - Occupancy night calculations - Channel name normalization - Date utilities - Query optimization helpers )date timedeltatimezone)Decimal)OptionalList)r)CHANNEL_DISPLAY_NAMESDEFAULT_CHANNEL_NAMEplatformreturnc|stS|jj}d|vry|tvr t|StjD] \}}||vs |cStS)a Normalize platform/channel name to user-friendly display name. Args: platform: Raw platform string from booking (e.g., "airbnb", "Booking") Returns: Normalized display name (e.g., "Airbnb", "Booking.com", "Direct") experiaExpedia)r lowerstripr items)r platform_lowerkey display_names $/backend/dashboard/services/utils.pynormalize_channel_namersu ##^^%++-NN"..$^44388:\ .  ; check_in check_out window_start window_endcht||}t||}||z j}td|S)a Calculate number of nights a booking overlaps with a given date window. This is the core occupancy calculation function used across all occupancy metrics. Args: check_in: Booking check-in date check_out: Booking check-out date window_start: Start of the analysis window (inclusive) window_end: End of the analysis window (exclusive) Returns: Number of overlapping nights (0 if no overlap) r)maxmindays)rrrreffective_start effective_end overlap_dayss rcalculate_overlapping_nightsr$3s9,(L1O :.M!O399L q, rstartendcdg}|}||kr&|j||tdz }||kr&|S)z Generate a list of dates from start to end (exclusive). Args: start: Start date (inclusive) end: End date (exclusive) Returns: List of date objects )r )appendr)r%r&datescurrents rget_date_ranger,Qs@ EG C- W9!$$ C- Lrc*tjS)z{ Get today's date using Django's timezone utilities. Returns: Current date in the active timezone )django_timezone localdaterr get_todayr1ds  $ $ &&r numerator denominatordefaultc|dk(r|S||z S)a Safely divide two numbers, returning default if denominator is zero. Args: numerator: The dividend denominator: The divisor default: Value to return if denominator is zero Returns: Division result or default value rr0)r2r3r4s r safe_divider6nsa { ""rvaluedecimalsct||S)z Round occupancy percentage to specified decimal places. Args: value: Occupancy percentage decimals: Number of decimal places (default: 0 for integer) Returns: Rounded occupancy percentage )roundr7r8s rround_occupancyr<s  !!rc2|ytt||S)z Safely convert Decimal to float with rounding. Args: value: Decimal value decimals: Number of decimal places Returns: Rounded float value )floatr:r;s rdecimal_to_floatr@s } uh' ((rN)r>)r))__doc__datetimerrrdecimalrtypingrr django.utilsr.dashboard.constantsr r strrintr$r,r1r?r6r<r@r0rrrJs/.!4K Xc] s >        <$Td4j&'4'#5#u#u#u#" "5 "C " " )HW- ) )U )r