namespace qdr.app.studiou.orders2printpack.EmailStorage
{
    /// <summary>
    /// Enumeration representing the various states an email item can be in during processing.
    /// These states track the progression of an email item through the complete workflow
    /// from initial discovery to final delivery.
    /// </summary>
    public enum EmailStateEnum
    {
        /// <summary>
        /// Initial state when an email item is discovered and ready for processing.
        /// Items in this state have their directory scanned and metadata populated,
        /// but no processing operations have begun.
        /// </summary>
        Ready,
        
        /// <summary>
        /// The email item is currently being processed.
        /// This includes file compression and preparation for upload.
        /// Items in this state should not be modified by other operations.
        /// </summary>
        Processing,
        
        /// <summary>
        /// The compressed file is being uploaded to the Temporary Shared Storage.
        /// This state indicates active network operation in progress.
        /// Items in this state should not be reset or reprocessed.
        /// </summary>
        Uploading,
        
        /// <summary>
        /// The email is being prepared and sent to the recipient.
        /// This includes email template processing, personalization,
        /// and actual SMTP transmission.
        /// </summary>
        Sending,
        
        /// <summary>
        /// The email has been successfully sent to the recipient.
        /// This is a terminal success state - processing is complete.
        /// Files are typically moved to the "sent" directory.
        /// </summary>
        Sent,
        
        /// <summary>
        /// An error occurred during processing at any stage.
        /// Items in this state require manual intervention or can be reset
        /// to retry processing. The ErrorMessage property should contain
        /// details about what went wrong.
        /// </summary>
        Error
    }
}