U hO@sdZddlmZddlmZddlmZddlmZ ddl m Z ddl m Z mZmZeZGdd d ejZGd d d ejZGd d d ejZGdddejZGdddejZGdddejZGdddejZGdddejZdS)a! Adtlas Activities Serializers This module contains the Django REST Framework serializers for the activities app, providing comprehensive data serialization and validation for activity tracking, category management, and analytics functionality. Features: - Activity serialization with nested relationships - Category management serialization - Activity summary serialization - Custom validation and field handling - Optimized queries for performance Author: Adtlas Development Team Version: 1.0.0 Last Updated: 2025-01-27 )timezone) serializers)get_user_model) gettext_lazy) ContentType)ActivityActivityCategoryActivitySummaryc@s.eZdZdZeZGdddZddZdS)UserBasicSerializerao Basic user serializer for activity relationships. This serializer provides essential user information for activity records without exposing sensitive data. Fields: - id: User ID - email: User email address - first_name: User first name - last_name: User last name - full_name: Computed full name c@s*eZdZeZdddddgZddddgZdS)zUserBasicSerializer.Metaidemail first_name last_name full_nameN)__name__ __module__ __qualname__Usermodelfieldsread_only_fieldsrr=/var/www/html/Focus/src/apps/activities/api/v1/serializers.pyMeta1srcCs@|jr|jr|jd|jS|jr*|jS|jr6|jS|jSdS)z Get user's full name. Args: obj: User instance Returns: str: User's full name or email if name not available  N)r rr selfobjrrr get_full_name6s z!UserBasicSerializer.get_full_nameN) rrr__doc__rSerializerMethodFieldrrrrrrrr sr c@s>eZdZdZeZGdddZddZddZ dd Z d S) ActivityCategorySerializera. Serializer for activity categories. This serializer handles activity category data including validation, creation, and updates with proper field handling. Fields: - All ActivityCategory model fields - activity_count: Number of activities in this category c @s4eZdZeZddddddddd d g Zddd d gZd S) zActivityCategorySerializer.Metar namecode descriptioncoloricon is_active created_at updated_atactivity_countN)rrrrrrrrrrrrXsrcCst|d|jS)z Get the number of activities in this category. Args: obj: ActivityCategory instance Returns: int: Number of activities in this category r*)getattr activitiescountrrrrget_activity_count`s z-ActivityCategorySerializer.get_activity_countcCsB|r>tjj|d}|jr(|j|jjd}|r>tt d|S)z Validate category code uniqueness. Args: value: Category code value Returns: str: Validated code value Raises: ValidationError: If code already exists )r#)pkz)A category with this code already exists.) robjectsfilterinstanceexcluder/existsrValidationError_)rvaluequerysetrrr validate_codels z(ActivityCategorySerializer.validate_codecCs>|r|dsttd|r:t|dkr:ttd|S)z Validate color format. Args: value: Color value Returns: str: Validated color value Raises: ValidationError: If color format is invalid #z,Color must be in hex format (e.g., #FF5733).)z4Color must be in valid hex format (#RGB or #RRGGBB).) startswithrr5r6lenrr7rrrvalidate_colors z)ActivityCategorySerializer.validate_colorN) rrrrrr r*rr.r9r@rrrrr!Js   r!c@seZdZdZGdddZdS)ContentTypeSerializeraK Serializer for content types in activity relationships. This serializer provides content type information for activities that reference other model instances. Fields: - id: Content type ID - app_label: Application label - model: Model name - name: Human-readable name c@s(eZdZeZddddgZddddgZdS)zContentTypeSerializer.Metar app_labelrr"N)rrrrrrrrrrrrs rN)rrrrrrrrrrAs rAcseZdZdZeddZeddZeddZ e Z e Z e Ze jdddZGdddZdd Zd d Zd d ZfddZZS)ActivitySerializera Comprehensive serializer for activities. This serializer handles activity data with nested relationships, computed fields, and optimized queries for performance. Fields: - All Activity model fields - user: Nested user information - category: Nested category information - content_type: Nested content type information - object_display: Human-readable object representation - duration_display: Human-readable duration - time_ago: Relative time display T read_onlyget_action_displaysourcerEc@sPeZdZeZddddddddd d d d d ddddddgZddddd ddddg ZdS)zActivitySerializer.Metar useractionaction_displaycategoryr$ content_type object_idobject_display ip_address user_agent session_key is_successful error_message duration_msduration_displaymetadatar(time_agoN)rrrrrrrrrrrrs>rcCs|S)z Get human-readable representation of the related object. Args: obj: Activity instance Returns: str: Human-readable object representation get_object_displayrrrrrZs z%ActivitySerializer.get_object_displaycCsn|jdkrdS|jdkr$|jdS|jdkr@|jdddS|jd}|jdd}|d|ddSdS)z Get human-readable duration display. Args: obj: Activity instance Returns: str: Human-readable duration or None Nms`.1fsm rUrrminutessecondsrrrget_duration_displays     z'ActivitySerializer.get_duration_displaycCsddlm}||jtS)z Get relative time display for activity creation. Args: obj: Activity instance Returns: str: Relative time display r) timesince)django.utils.timesincerfr(rnow)rrrfrrr get_time_agos zActivitySerializer.get_time_agoc slt|}|jrdnd|d<|jrhz(t|jtrJddl}||j|d<Wn|jt fk rfYnX|S)z Customize the serialized representation. Args: instance: Activity instance Returns: dict: Serialized data SuccessFailedsuccess_displayrNrW) superto_representationrSrW isinstancestrjsonloadsJSONDecodeError TypeError)rr2datarq __class__rrrn s  z$ActivitySerializer.to_representation)rrrrr rIr!rLrArMrr rOrVrX CharFieldrKrrZrerirn __classcell__rrrvrrCs     rCc@sZeZdZdZejdddZejdddZGdddZddZ d d Z d d Z d dZ dS)ActivityCreateSerializeraj Serializer for creating new activities. This serializer handles activity creation with validation and automatic field population from request context. Fields: - Required: action, description - Optional: category, content_type, object_id, metadata - Auto-populated: user, ip_address, user_agent, session_key FT)required allow_nullc @s,eZdZeZddddddddd d d d g Zd S)zActivityCreateSerializer.MetarJr$ category_idcontent_type_idrNrSrTrUrWrPrQrRNrrrrrrrrrrr7srcCsH|dk rDztjj|dd}|WStjk rBttdYnX|S)a Validate category exists and is active. Args: value: Category ID Returns: int: Validated category ID Raises: ValidationError: If category doesn't exist or is inactive NT)r r'z.Invalid category ID or category is not active.)rr0get DoesNotExistrr5r6)rr7rLrrrvalidate_category_id?s  z-ActivityCreateSerializer.validate_category_idcCsF|dk rBztjj|d|WStjk r@ttdYnX|S)a Validate content type exists. Args: value: Content type ID Returns: int: Validated content type ID Raises: ValidationError: If content type doesn't exist Nr zInvalid content type ID.)rr0rrrr5r6r?rrrvalidate_content_type_idVs  z1ActivityCreateSerializer.validate_content_type_idcCsH|dr"|ds"ttd|drD|dsDttd|S)z Perform cross-field validation. Args: attrs: Validated attributes Returns: dict: Validated attributes Raises: ValidationError: If validation fails r~rNz5object_id is required when content_type is specified.z5content_type is required when object_id is specified.)rrr5r6)rattrsrrrvalidatemsz!ActivityCreateSerializer.validatecCsR|dd}|dd}|r.tjj|d|d<|rDtjj|d|d<tjjf|S)z Create activity with proper field mapping. Args: validated_data: Validated data Returns: Activity: Created activity instance r}Nr~rrLrM)poprr0rrrcreate)rvalidated_datar}r~rrrrs  zActivityCreateSerializer.createN) rrrrr IntegerFieldr}r~rrrrrrrrrrz's rzc@sReZdZdZeddZeddZe Z e Z GdddZ ddZ dd Zd S) ActivitySummarySerializera Serializer for activity summaries. This serializer handles activity summary data with nested relationships and computed fields for analytics. Fields: - All ActivitySummary model fields - user: Nested user information - category: Nested category information - success_rate: Computed success rate - avg_duration_display: Human-readable average duration TrDc @s@eZdZeZddddddddd d d d d g Zddddd d d gZdS)zActivitySummarySerializer.Metar daterIrLtotal_activitiessuccessful_activitiesfailed_activities success_rateavg_duration_msavg_duration_display unique_ipsr(r)N)rrrr rrrrrrrrs.rcCs|jdkrdS|j|jdS)z Calculate success rate percentage. Args: obj: ActivitySummary instance Returns: float: Success rate as percentage rgd)rrrrrrget_success_rates z*ActivitySummarySerializer.get_success_ratecCsr|jdkrdS|jdkr&|jddS|jdkrB|jdddS|jd}|jdd}|dd|ddSdS) z Get human-readable average duration display. Args: obj: ActivitySummary instance Returns: str: Human-readable duration or None Nr[z.0fr\r]r^r_r`)rrbrrrget_avg_duration_displays    z2ActivitySummarySerializer.get_avg_duration_displayN)rrrrr rIr!rLrr rrrrrrrrrrs   rc@s*eZdZdZeddZddZddZdS) ActivityBulkCreateSerializerz Serializer for bulk activity creation. This serializer handles bulk creation of activities for batch processing and import operations. Fields: - activities: List of activity data T)manycCsv|d}g}|D]X}|dd}|dd}|rBtjj|d|d<|rXtjj|d|d<|tf|qtj|S)z Create multiple activities in bulk. Args: validated_data: Validated data with activities list Returns: list: List of created activity instances r,r}Nr~rrLrM)rrr0rrappendr bulk_create)rrZactivities_datar, activity_datar}r~rrrrs   z#ActivityBulkCreateSerializer.createcCs0|sttdt|dkr,ttd|S)z Validate activities list. Args: value: List of activity data Returns: list: Validated activities data Raises: ValidationError: If validation fails z"At least one activity is required.rz/Cannot create more than 100 activities at once.)rr5r6r>r?rrrvalidate_activitiess  z0ActivityBulkCreateSerializer.validate_activitiesN)rrrrrzr,rrrrrrrs rc@seZdZdZejdddZeZejdddZ ejdddZ eZ ejdddZ eZ eZGdd d Zd d Zd d ZddZddZdS)ActivityExportSerializerz Serializer for activity export operations. This serializer provides a flattened representation of activities suitable for CSV/Excel export. Fields: - Flattened activity data with related object information z user.emailTrGz category.namezcontent_type.namerFc@s6eZdZeZddddddddd d d d d ddddgZdS)zActivityExportSerializer.Metar user_email user_namerJrK category_namer$content_type_namerNrOrPrSrlrUrVrTr(Nrrrrrr=s&rcCs\|js dS|jjr0|jjr0|jjd|jjS|jjr@|jjS|jjrP|jjS|jjSdS)z Get user's full name for export. Args: obj: Activity instance Returns: str: User's full name or email AnonymousrN)rIr rr rrrr get_user_nameFs z&ActivityExportSerializer.get_user_namecCs|S)z Get object display for export. Args: obj: Activity instance Returns: str: Object display string rYrrrrrZ\s z+ActivityExportSerializer.get_object_displaycCs|jr dSdS)z Get success status display for export. Args: obj: Activity instance Returns: str: Success status display rjrk)rSrrrrget_success_displayhs z,ActivityExportSerializer.get_success_displaycCsn|jdkrdS|jdkr$|jdS|jdkr@|jdddS|jd}|jdd}|d|ddSdS) z Get duration display for export. Args: obj: Activity instance Returns: str: Duration display Nr[r\r]r^r_r`rarbrrrrets     z-ActivityExportSerializer.get_duration_displayN)rrrrrrxrr rrrrOrKrlrVrrrZrrerrrrr)s    rN)r django.utilsrrest_frameworkrdjango.contrib.authrdjango.utils.translationrr6"django.contrib.contenttypes.modelsrapps.activities.modelsrrr rModelSerializerr r!rArCrzr Serializerrrrrrrs     *VsxFD