U vhEa@sdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddlmZdd lmZmZmZdd lmZmZGd d d eeeZGd ddeeeZGdddeeZdS)aA Adtlas Activities Models This module contains the activity tracking and audit logging models for the Adtlas DAI Management System. It provides comprehensive activity monitoring, user action tracking, and audit trail functionality. Features: - User activity tracking with detailed context - System event logging and monitoring - Activity categorization and filtering - Audit trail management with retention policies - Activity analytics and reporting - Real-time activity feeds Author: Adtlas Development Team Version: 1.0.0 Last Updated: 2025-01-27 )models)reversetimezone)RegexValidator) gettext_lazy ContentType)GenericForeignKey) UUIDModelTimestampedModelSoftDeleteModel)ActivityManagerActivityCategoryManagerc @sLeZdZdZejddededdZejddedd ged ed d Z ej ded eddZ ejddeddgededdZ ejddededdZ ejdededdZejdeded dZejd!ed"ed#dZejd$ejddd%ed&ed'd(ZGd)d*d*ZeZeZd+d,Zd-d.Zd/d0Zd4d2d3Zd1S)5ActivityCategoryas Activity Category model for organizing and classifying different types of activities. This model allows for better organization of activities by grouping them into logical categories such as authentication, content management, system administration, etc. Attributes: name (str): Human-readable name of the category code (str): Unique code for programmatic access description (str): Detailed description of the category color (str): Hex color code for UI representation icon (str): CSS icon class for UI representation is_system (bool): Whether this is a system-defined category is_active (bool): Whether this category is currently active retention_days (int): Number of days to retain activities in this category parent (ForeignKey): Parent category for hierarchical organization dTz Category Namez,Human-readable name of the activity category) max_lengthunique verbose_name help_text2z ^[a-z_]+$z,Code must be lowercase with underscores onlyz Category Codez=Unique code for programmatic access (e.g., 'auth', 'content'))rr validatorsrr Descriptionz?Detailed description of what activities belong to this categoryblankrrz#007bffz^#[0-9A-Fa-f]{6}$zColor must be a valid hex codeZColorz6Hex color code for UI representation (e.g., '#007bff'))rdefaultrrrzfas fa-activityZIconz:CSS icon class for UI representation (e.g., 'fas fa-user'))rrrrFzIs System Categoryz@Whether this is a system-defined category that cannot be deletedrrrz Is Activez)Whether this category is currently activeimzRetention DayszBNumber of days to retain activities in this category (0 = forever)selfchildrenzParent Categoryz-Parent category for hierarchical organization on_deletenullr related_namerrc@sNeZdZdZdgZedZedZej dgdej dgdej dgdgZ d S) zActivityCategory.MetaZactivities_categoriesnamezActivity CategoryzActivity Categoriescodefields is_active is_systemN __name__ __module__ __qualname__db_tableordering_rverbose_name_pluralrIndexindexesr4r41/var/www/html/Focus/src/apps/activities/models.pyMeta{s   r6cCs|jS)z/String representation of the activity category.)r$rr4r4r5__str__szActivityCategory.__str__cCstdd|jidS)z'Get the absolute URL for this category.zactivities:category_detailpkkwargsrr9r7r4r4r5get_absolute_urlsz!ActivityCategory.get_absolute_urlcCs8t|jjdd}|jjddD]}||q |S)z Get all child categories recursively. Returns: list: List of all child ActivityCategory instances T)r()listrfilterextendget_all_children)rrchildr4r4r5rAsz!ActivityCategory.get_all_childrenNcCs:|j}|dk r2ttj|d}|j|d}|S)a Get the count of activities in this category. Args: days (int, optional): Number of days to look back. If None, count all activities. Returns: int: Number of activities in this category N)days)created_at__gte) activitiesallrnow timedeltar?count)rrCqueryset cutoff_dater4r4r5get_activity_counts  z#ActivityCategory.get_activity_count)N)r+r,r-__doc__r CharFieldr0r$rr% TextField descriptioncolorZicon BooleanFieldr)r(PositiveIntegerFieldZretention_days ForeignKeyCASCADEparentr6Managerobjectsractiver8r=rArLr4r4r4r5r"s~      rc"@seZdZdZdedfdedfdedfded fd ed fd ed fdedfdedfdedfdedfdedfdedfdedfdedfdedfd ed!fd"ed#fd$ed%fd&ed'fd(ed)fd*ed+fd,ed-fd.ed/fd0ed1fd2ed3fd4ed5fd6ed7fd8ed9fd:ed;fded?fd@edAfg ZdBdCdDdEdFdGdHgZejdIej dJdJdKedLedMdNZ eje ej dJdJdKedOedPdNZ ej dQeedRedSdTZejedUedVdWZejeej dJdJedXedYdZZejdJdJed[ed\d]Zed^d_ZejdJdJed`edad]ZejdJedbedcddZej dedJedfedgdhZej didJedjedkdhZej dledJedmedndoZejdJedpedqdrZejdJedsedtddZej e!dJeduedvdwZ"ej#dJdJedxedyd]Z$e%Z&Gdzd{d{Z'e(d|d}Z)e(d~dZ*ddZ+ddZ,ddZ-ddZ.ddZ/ddZ0dddZ1e2dddZ3e2dddZ3e4ddZ5dS)Activitya Activity model for tracking user actions and system events. This model provides comprehensive activity tracking with support for categorization, detailed context, and audit trail functionality. Attributes: user (ForeignKey): User who performed the activity category (ForeignKey): Category this activity belongs to action (str): Type of action performed description (str): Human-readable description of the activity content_type (ForeignKey): Content type of the related object object_id (int): ID of the related object content_object (GenericForeignKey): Generic relation to any model ip_address (GenericIPAddressField): IP address of the user user_agent (str): User agent string from the request session_key (str): Session key for tracking user sessions request_path (str): URL path of the request request_method (str): HTTP method of the request is_successful (bool): Whether the activity completed successfully error_message (str): Error message if the activity failed metadata (JSONField): Additional metadata about the activity duration_ms (int): Duration of the activity in milliseconds ZLOGINZLoginZLOGOUTZLogoutZPASSWORD_CHANGEzPassword ChangeZPASSWORD_RESETzPassword ResetZACCOUNT_LOCKEDzAccount LockedZACCOUNT_UNLOCKEDzAccount UnlockedCREATEZCreateREADZReadUPDATEZUpdateDELETEDeleteZRESTOREZRestoreZUPLOADZUploadZDOWNLOADZDownloadZEXPORTZExportZIMPORTImportZCAMPAIGN_STARTzCampaign StartZ CAMPAIGN_STOPz Campaign StopZCAMPAIGN_PAUSEzCampaign PauseZCAMPAIGN_RESUMEzCampaign ResumeZ SYSTEM_BACKUPz System BackupZSYSTEM_RESTOREzSystem RestoreZSYSTEM_MAINTENANCEzSystem MaintenanceZCONFIGURATION_CHANGEzConfiguration ChangeZPERMISSION_GRANTEDzPermission GrantedZPERMISSION_REVOKEDzPermission RevokedZ ROLE_ASSIGNEDz Role AssignedZ ROLE_REMOVEDz Role RemovedZSECURITY_VIOLATIONzSecurity ViolationZREPORT_GENERATEDzReport GeneratedZANALYTICS_VIEWEDzAnalytics ViewedZ DATA_EXPORTEDz Data ExportedZOTHEROther)GETrb)POSTrc)PUTrd)PATCHre)r^r^)HEADrf)OPTIONSrg accounts.UserTrEUserz User who performed this activityr Categoryz!Category this activity belongs torActionz!Type of action that was performed)rchoicesrrrz+Human-readable description of what happenedrrz Content Typez'Type of object this activity relates to)r!r"rrrz Object IDz)ID of the object this activity relates tor"rrr content_type object_idz IP Addressz0IP address from which the activity was performedz User Agentz Browser/client user agent stringr(z Session Keyz&Session key for tracking user sessions)rrrriz Request Pathz$URL path where the activity occurred zRequest Methodz HTTP method used for the request)rrlrrrz Is Successfulz+Whether the activity completed successfullyrz Error Messagez$Error message if the activity failedMetadataz-Additional structured data about the activityrrrrz Duration (ms)z(Duration of the activity in millisecondsc @seZdZdZdgZedZedZej ddgdej ddgdej ddgdej d d gdej d gdej d gdej d gdej dgdgZ dS)z Activity.MetaZactivities_activitiesz -created_atrZZ Activitiesuserr&categoryactionrorp ip_address session_key is_successfulNr*r4r4r4r5r6s    r6cCs|jr|jdSdS)zCalculate duration in seconds.g@@N duration_msr7r4r4r5duration_secondss zActivity.duration_secondscCs*ddlm}||jdd}|j|kS)z3Check if activity is recent (within last 24 hours).rr)hours) django.utilsrrGrH created_at)rrcutoffr4r4r5 is_recents zActivity.is_recentcCs2|jr.|jr.z|jj|jdWSYdSXdS)zGet the related content object.)r9N)rorpget_object_for_this_typer7r4r4r5get_content_objects  zActivity.get_content_objectcCs6|jrt|jnd}|jd}|d|jd|S)z&String representation of the activity.Z Anonymousz%Y-%m-%d %H:%M - )rustrrstrftimerw)ruser_strZformatted_dater4r4r5r8s zActivity.__str__cCstdd|jidS)z'Get the absolute URL for this activity.zactivities:activity_detailr9r:r<r7r4r4r5r=szActivity.get_absolute_urlcCs0|jrt|jS|jr,|jjd|jdSdS)z Get a human-readable representation of the related object. Returns: str: String representation of the related object z (ID: )zNo related object)content_objectrror$rpr7r4r4r5get_object_displays  zActivity.get_object_displaycCsn|jdkrdS|jdkr$|jdS|jdkr@|jdddS|jd}|jdd}|d|ddSdS) z Get a human-readable representation of the activity duration. Returns: str: Formatted duration string NUnknownimsi`z.1fszm r{)rminutessecondsr4r4r5get_duration_displays     zActivity.get_duration_displaycCs.t|jtsi|_||j|<|jdgddS)z Add a key-value pair to the activity metadata. Args: key (str): Metadata key value: Metadata value (must be JSON serializable) metadata) update_fieldsN) isinstancerdictsave)rkeyvaluer4r4r5 add_metadatas  zActivity.add_metadataNcCst|jts|S|j||S)z Get a value from the activity metadata. Args: key (str): Metadata key default: Default value if key doesn't exist Returns: Metadata value or default )rrrget)rrrr4r4r5 get_metadatas zActivity.get_metadatac CsPddlm} |||||||| | d } |rB| j|| d<|j| d<|jjf| S)zLog an activity.rr) rurwrPrvrx user_agentryrzr|rorp)"django.contrib.contenttypes.modelsr rX get_for_modelr9create) clsrurwrPrvrrxrryrzr|r activity_datar4r4r5 log_activitys   zActivity.log_activityc Kst|tr8ztjj|d}Wntjk r6d}YnXi} |rn| |||jdd|j j |j |j d||||||p~d| pid| | } |r|| d<|jj f| S)a Convenience method to log an activity. Args: user: User who performed the activity action (str): Action type description (str): Activity description category: ActivityCategory instance or code content_object: Related model instance request: Django request object is_successful (bool): Whether the activity was successful error_message (str): Error message if failed metadata (dict): Additional metadata **kwargs: Additional fields to set on the activity Returns: Activity: Created activity instance )r%NHTTP_USER_AGENTr)rxrry request_pathrequest_method)rurwrPrvrz error_messagerr)rrrrXr DoesNotExistupdate_get_client_ipMETAsessionrypathmethodr) rrurwrPrvrrequestrzrrr;Z request_datarr4r4r5r s8     cCs0|jd}|r |dd}n |jd}|S)z Get the client IP address from the request. Args: request: Django request object Returns: str: Client IP address ZHTTP_X_FORWARDED_FOR,r REMOTE_ADDR)rrsplit)rZx_forwarded_foripr4r4r5rGs  zActivity._get_client_ip)N)rNNNNNTN) NNNNNNTNN)6r+r,r-rMr0ZACTION_CHOICESZHTTP_METHOD_CHOICESrrTSET_NULLrurrvrNrwrOrPr rorSrpr rGenericIPAddressFieldrxrryrrrRrzr JSONFieldrrBigIntegerFieldr|rrXr6propertyr}rrr8r=rrrr classmethodr staticmethodrr4r4r4r5rZsR                                4              :rZc @s^eZdZdZejededdZejdej dddeded d Z eje ej ddded ed d Z ej d ededdZej d ededdZej d ededdZej d ededdZej d ededdZejddededdZejddededdZejedededd ZGd!d"d"Zd#d$Zed%d&Zed'd(Zd)S)*ActivitySummarya Activity Summary model for storing aggregated activity statistics. This model stores pre-calculated activity statistics for improved performance when displaying activity analytics and reports. Attributes: date (DateField): Date for which the summary is calculated user (ForeignKey): User for user-specific summaries (optional) category (ForeignKey): Category for category-specific summaries (optional) total_activities (int): Total number of activities successful_activities (int): Number of successful activities failed_activities (int): Number of failed activities unique_users (int): Number of unique users (for global summaries) unique_ips (int): Number of unique IP addresses avg_duration_ms (float): Average activity duration in milliseconds peak_hour (int): Hour with the most activity (0-23) summary_data (JSONField): Additional summary statistics Datez)Date for which this summary is calculatedrmrhTZactivity_summariesrizs        ,