SIENTIAPDE-1182

Remove deprecated files and configurations

- Deleted coverage.sh, Dockerfile, docker-compose.yml, email.html, input_sample.json, and Makefile as part of the cleanup process.
- Updated README.md to reflect the removal of these components and provide a clearer overview of the project structure and functionality.
- Added module-level docstrings to orchestrator, activities, and workflows for improved documentation and clarity on system architecture.

orchestrator/utils/converters.py

@@ -1,6 +1,23 @@
 def parse_frequency(frequency: str) -> int:
     """
-    Parse frequency string to seconds
+    Parse frequency string into seconds for Temporal schedule intervals.
+
+    This function converts human-readable frequency strings into seconds
+    for use in Temporal schedule configurations. Supports seconds, minutes,
+    hours, and days notation.
+
+    Args:
+        frequency (str): Frequency string with suffix:
+            - 's' for seconds (e.g., '30s')
+            - 'm' for minutes (e.g., '5m') 
+            - 'h' for hours (e.g., '2h')
+            - 'd' for days (e.g., '1d')
+
+    Returns:
+        int: Frequency converted to seconds
+
+    Raises:
+        ValueError: If frequency format is invalid
     """
     if frequency.endswith("s"):
         return int(frequency[:-1])

orchestrator/utils/email_builder.py

@@ -6,6 +6,18 @@ import re
 
 
 class EmailBuilder:
+    """
+    HTML email template builder for notification emails.
+
+    This class handles the generation of HTML email content from notification
+    data using Jinja2 templates. It supports different email types (alerts,
+    reports) and notification levels (ERROR, WARNING, INFO) with customizable
+    templates and parameter replacement.
+
+    Args:
+        logger (Logger): Application logger instance for error reporting
+    """
+
     def __init__(self, logger: Logger):
         self.logger = logger