go

Dockerfile

@@ -1,8 +1,8 @@
 # Use the official Python 3.11 slim image
 FROM python:3.11-slim
 
-# Install system dependencies required for Math/Data libraries
-# libgomp1 is CRITICAL for scikit-learn & numpy parallelization to prevent segfaults
+# Install system dependencies required for Math/Data libraries AND PDF Generation
+# Added: libcairo2, libgdk-pixbuf-2.0-0 (CRITICAL for WeasyPrint/PDF generation)
 RUN apt-get update && apt-get install -y --no-install-recommends \
     curl \
     gcc \
@@ -10,6 +10,8 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     libgomp1 \
     libpango-1.0-0 \
     libpangoft2-1.0-0 \
+    libcairo2 \
+    libgdk-pixbuf-2.0-0 \
     libjpeg62-turbo-dev \
     libopenjp2-7-dev \
     libffi-dev \
@@ -18,14 +20,18 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     && rm -rf /var/lib/apt/lists/*
 
 # Set the working directory inside the container
+# Added: /app/temp_reports
 RUN mkdir -p /app/output \
     /app/chat_pdfs \
+    /app/temp_reports \
     /app/generated_charts \
     /app/cache
 
 # Create required directories with permissions
+# Added: /app/temp_reports
 RUN chmod -R 777 /app/output \
     /app/chat_pdfs \
+    /app/temp_reports \
     /app/generated_charts \
     /app/cache
 
@@ -51,5 +57,4 @@ RUN chown -R 1000:1000 /app && chmod -R 777 /app
 EXPOSE 7860
 
 # CMD: Run the python script directly.
-# This ensures the 'if __name__ == "__main__":' block in your code actually runs.
 CMD bash -c "while true; do curl -s https://code-api-executor.hf.space/ping >/dev/null && sleep 300; done & python controller.py"

controller.py

@@ -40,6 +40,8 @@ from csv_metadata_service import CsvDataRequest, CsvInfoRequest, CsvInfoResponse
 from download_messages_log_helper import ChatLogRequest, ChatLogResponse, generate_chat_pdf
 from extract_csv_metadata_service import extract_csv_metadata_logic
 from mongo_service import convert_oid, execute_mongo_operation, extract_database_name, sanitize_json_input
+from pdf_report_generation_helper import generate_and_upload_report
+from pdf_report_generation_model import ReportGenerationRequest, ReportGenerationResponse
 from pydantic_csv_analysis_model import AnalysisRequest, AnalysisResponse
 from pydantic_csv_charts_model import ChartExecutionPayload, ChartExecutionResponse
 from pydantic_migration_model import MigrationRequest, MigrationResponse
@@ -774,6 +776,51 @@ async def get_chat_log_endpoint(payload: ChatLogRequest, token: str = Depends(va
             except Exception as cleanup_error:
                 logger.warning(f"Failed to delete local PDF {generated_pdf_path}: {cleanup_error}")
 
+# --- PDF Report Generation ---
+@app.post("/api/generate_pdf_report", response_model=ReportGenerationResponse)
+async def generate_pdf_report_endpoint(
+    payload: ReportGenerationRequest, 
+    token: str = Depends(validate_token) # Assuming validate_token is defined in your main file
+):
+    """
+    Generates a PDF report, uploads it to Supabase via the helper, 
+    and returns the public URL.
+    """
+    request_id = str(uuid.uuid4())[:8]
+    
+    try:
+        # Convert Pydantic models to a list of dictionaries for the helper
+        # .model_dump() is for Pydantic v2, use .dict() for v1
+        config_content = [section.dict() for section in payload.sections]
+        
+        # Call the helper function directly.
+        # It handles generation, upload, and cleanup.
+        public_url = await generate_and_upload_report(
+            config_content=config_content,
+            file_name=payload.file_name,
+            chat_id=payload.chat_id,
+            title=payload.title,
+            subtitle=payload.subtitle,
+            author=payload.author,
+            department=payload.department,
+            output_dir="temp_reports"
+        )
+        
+        return ReportGenerationResponse(
+            success=True,
+            pdf_report_file_url=public_url,
+            file_name=f"{payload.file_name}.pdf" if not payload.file_name.endswith('.pdf') else payload.file_name,
+            request_id=request_id
+        )
+
+    except Exception as e:
+        logger.error(f"Report Generation Failed: {e}")
+        return ReportGenerationResponse(
+            success=False,
+            error=str(e),
+            request_id=request_id
+        )
+
 # --- Batch Handlers ---
 async def batch_parallel_handler(func, requests: List[Any], token: str):
     tasks = [func(req, token) for req in requests]

pdf_report_generation_helper.py

@@ -0,0 +1,115 @@
+import os
+import uuid
+import logging
+import asyncio
+from typing import List, Dict, Any
+from pdf_report_generation_service import Q4ReportGenerator
+from supabase_service import upload_file_to_supabase # Assuming this exists from your previous context
+
+logger = logging.getLogger(__name__)
+
+async def generate_and_upload_report(
+    config_content: List[Dict[str, Any]],
+    file_name: str,
+    chat_id: str,
+    title: str = "Analytics Report",
+    subtitle: str = "Generated Report",
+    author: str = "AI Assistant",
+    department: str = "Data Analytics",
+    output_dir: str = "temp_reports"
+) -> str:
+    """
+    Generates a PDF report from content configuration, uploads it to Supabase,
+    and returns the public URL. Cleans up temporary files afterwards.
+    """
+    
+    # 1. Setup paths
+    os.makedirs(output_dir, exist_ok=True)
+    
+    # Ensure filename ends with .pdf
+    if not file_name.endswith('.pdf'):
+        file_name += '.pdf'
+        
+    # Create a unique filename to prevent collisions locally
+    unique_id = str(uuid.uuid4())[:8]
+    local_filename = f"{os.path.splitext(file_name)[0]}_{unique_id}.pdf"
+    
+    # 2. Initialize Generator
+    generator = Q4ReportGenerator(
+        title=title,
+        subtitle=subtitle,
+        author=author,
+        department=department,
+        confidential=True
+    )
+    
+    # 3. Generate PDF (Blocking I/O, so we run it in a way that doesn't block main loop if called properly)
+    # In FastAPI, we'll wrap this whole function or the generation part in run_in_threadpool
+    success = generator.generate(
+        sections=config_content,
+        filename=local_filename,
+        output_dir=output_dir,
+        cover_page=True
+    )
+    
+    if not success:
+        raise Exception("Failed to generate PDF report locally.")
+        
+    local_file_path = os.path.join(output_dir, local_filename)
+    
+    try:
+        # 4. Upload to Supabase
+        # We use the original desired file_name for the upload (or unique if you prefer)
+        # Using unique name in cloud storage is usually safer
+        cloud_filename = f"{os.path.splitext(file_name)[0]}_{unique_id}.pdf"
+        
+        logger.info(f"Uploading {local_file_path} to Supabase as {cloud_filename}")
+        
+        public_url = await upload_file_to_supabase(
+            file_path=local_file_path,
+            file_name=cloud_filename,
+            chat_id=chat_id
+        )
+        
+        logger.info(f"Upload successful. URL: {public_url}")
+        
+        return public_url
+        
+    except Exception as e:
+        logger.error(f"Failed to upload report: {e}")
+        raise e
+        
+    finally:
+        # 5. Cleanup - Delete local PDF
+        if os.path.exists(local_file_path):
+            try:
+                os.remove(local_file_path)
+                logger.info(f"Deleted local file: {local_file_path}")
+            except Exception as e:
+                logger.warning(f"Failed to delete local file {local_file_path}: {e}")
+                
+        # 6. Cleanup - Delete downloaded images
+        # The generator class tracks images it downloaded
+        if hasattr(generator, 'downloaded_images'):
+            for img_uri in generator.downloaded_images:
+                # Convert URI back to path if needed (file://...)
+                if img_uri.startswith('file://'):
+                    img_path = img_uri[7:] # Simple strip, robust implementation depends on OS
+                    # On windows file:///C:/... might need handling
+                    if os.name == 'nt' and img_uri.startswith('file:///'):
+                        img_path = img_uri[8:]
+                    
+                    if os.path.exists(img_path):
+                        try:
+                            os.remove(img_path)
+                            logger.info(f"Deleted temp image: {img_path}")
+                        except Exception as e:
+                            logger.warning(f"Failed to delete image {img_path}: {e}")
+            
+            # Try to remove the images directory if empty
+            images_dir = os.path.join(output_dir, 'images')
+            if os.path.exists(images_dir):
+                try:
+                    os.rmdir(images_dir)
+                except:
+                    pass

pdf_report_generation_model.py

@@ -0,0 +1,27 @@
+from pydantic import BaseModel, Field
+from typing import List, Optional, Union, Dict, Any
+
+class ImageConfig(BaseModel):
+    url: str
+    caption: Optional[str] = "Figure"
+
+class ReportSection(BaseModel):
+    content: str
+    images: Optional[List[Union[str, ImageConfig]]] = []
+    page_break: Optional[bool] = False
+
+class ReportGenerationRequest(BaseModel):
+    chat_id: str
+    file_name: str = "Analysis_Report"
+    title: Optional[str] = "Analytics Performance Report"
+    subtitle: Optional[str] = "Generated Insights"
+    author: Optional[str] = "AI Assistant"
+    department: Optional[str] = "Data Analytics Team"
+    sections: List[ReportSection]
+
+class ReportGenerationResponse(BaseModel):
+    success: bool
+    pdf_report_file_url: Optional[str] = None
+    file_name: Optional[str] = None
+    error: Optional[str] = None
+    request_id: str

pdf_report_generation_service.py

@@ -0,0 +1,659 @@
+"""
+Professional Q4 Report Generator - Complete Working Version
+Generates executive-quality PDF reports with proper image rendering
+"""
+import markdown
+from weasyprint import HTML, CSS
+import requests
+import os
+from datetime import datetime
+from typing import List, Dict, Optional
+import logging
+from pathlib import Path
+
+# ---------------------------------------------------------
+# LOGGING CONFIGURATION
+# ---------------------------------------------------------
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(levelname)s - %(message)s',
+    datefmt='%Y-%m-%d %H:%M:%S'
+)
+logger = logging.getLogger(__name__)
+
+# ---------------------------------------------------------
+# EXECUTIVE Q4 REPORT THEME
+# ---------------------------------------------------------
+CSS_STYLE = """
+@page {
+    size: letter;
+    margin: 0.75in 0.75in 1in 0.75in;
+    
+    @top-center {
+        content: element(header);
+    }
+    
+    @bottom-center {
+        content: element(footer);
+    }
+}
+
+body {
+    font-family: 'Helvetica', Arial, sans-serif;
+    color: #1a1a1a;
+    line-height: 1.65;
+    font-size: 11pt;
+}
+
+.header {
+    position: running(header);
+    font-size: 9pt;
+    color: #666;
+    border-bottom: 1px solid #ddd;
+    padding-bottom: 6px;
+    margin-bottom: 20px;
+}
+
+.footer {
+    position: running(footer);
+    font-size: 9pt;
+    color: #666;
+    border-top: 1px solid #ddd;
+    padding-top: 6px;
+    text-align: center;
+}
+
+.footer::after {
+    content: "Page " counter(page) " of " counter(pages);
+}
+
+.confidential-mark {
+    color: #d32f2f;
+    font-weight: bold;
+    float: left;
+}
+
+.cover-page {
+    text-align: center;
+    padding-top: 3in;
+    page-break-after: always;
+}
+
+.cover-title {
+    font-size: 36pt;
+    font-weight: bold;
+    color: #003366;
+    margin-bottom: 0.5in;
+    letter-spacing: 1px;
+    line-height: 1.2;
+}
+
+.cover-subtitle {
+    font-size: 20pt;
+    color: #0055a5;
+    margin-bottom: 1.2in;
+    font-weight: 500;
+}
+
+.cover-meta {
+    font-size: 15pt;
+    color: #555;
+    margin-bottom: 0.25in;
+    line-height: 1.5;
+}
+
+.cover-date {
+    font-size: 12pt;
+    color: #888;
+    margin-top: 0.5in;
+}
+
+.cover-divider {
+    width: 3in;
+    height: 3px;
+    background: linear-gradient(to right, #003366, #0055a5);
+    margin: 0.5in auto;
+}
+
+h1 {
+    color: #003366;
+    font-size: 20pt;
+    border-bottom: 3px solid #0055a5;
+    padding-bottom: 10px;
+    margin-top: 28px;
+    margin-bottom: 18px;
+    page-break-after: avoid;
+    font-weight: bold;
+}
+
+h2 {
+    color: #0055a5;
+    font-size: 15pt;
+    margin-top: 22px;
+    margin-bottom: 14px;
+    page-break-after: avoid;
+    font-weight: 600;
+}
+
+h3 {
+    color: #333;
+    font-size: 13pt;
+    margin-top: 18px;
+    margin-bottom: 12px;
+    page-break-after: avoid;
+    font-weight: 600;
+}
+
+table {
+    width: 100%;
+    border-collapse: collapse;
+    margin: 18px 0;
+    font-size: 10pt;
+    page-break-inside: avoid;
+    box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+}
+
+thead {
+    background: linear-gradient(to bottom, #003366, #00264d);
+}
+
+th {
+    background-color: #003366;
+    color: white;
+    padding: 12px;
+    text-align: left;
+    font-weight: bold;
+    border: 1px solid #002244;
+    font-size: 10.5pt;
+}
+
+td {
+    padding: 10px 12px;
+    border: 1px solid #ddd;
+    line-height: 1.5;
+}
+
+tr:nth-child(even) {
+    background-color: #f8f9fa;
+}
+
+tr:nth-child(odd) {
+    background-color: #ffffff;
+}
+
+.highlight-box {
+    background-color: #e8f4f8;
+    border-left: 5px solid #0055a5;
+    padding: 16px 20px;
+    margin: 20px 0;
+    page-break-inside: avoid;
+    box-shadow: 0 2px 4px rgba(0,0,0,0.05);
+}
+
+.key-metric-box {
+    background: linear-gradient(135deg, #003366 0%, #0055a5 100%);
+    color: white;
+    border-radius: 8px;
+    padding: 18px 22px;
+    margin: 20px 0;
+    page-break-inside: avoid;
+    box-shadow: 0 3px 6px rgba(0,0,0,0.15);
+}
+
+.key-metric-box h3 {
+    color: white;
+    margin-top: 0;
+}
+
+blockquote {
+    border-left: 5px solid #003366;
+    margin-left: 0;
+    padding-left: 20px;
+    color: #333;
+    font-style: italic;
+    background-color: #f8f9fa;
+    padding: 14px 14px 14px 20px;
+    margin: 18px 0;
+    box-shadow: 0 1px 2px rgba(0,0,0,0.05);
+}
+
+.figure-container {
+    text-align: center;
+    margin: 24px 0;
+    page-break-inside: avoid;
+}
+
+.figure-container img {
+    max-width: 100%;
+    height: auto;
+    border: 1px solid #ddd;
+    padding: 8px;
+    background: white;
+    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+}
+
+.figure-caption {
+    font-size: 9.5pt;
+    color: #666;
+    margin-top: 10px;
+    font-style: italic;
+    font-weight: 500;
+}
+
+.executive-summary {
+    background-color: #f0f7ff;
+    border: 2px solid #0055a5;
+    padding: 20px;
+    margin: 24px 0;
+    page-break-inside: avoid;
+    border-radius: 5px;
+}
+
+.page-break {
+    page-break-after: always;
+}
+
+ul, ol {
+    margin: 14px 0;
+    padding-left: 28px;
+}
+
+li {
+    margin: 8px 0;
+    line-height: 1.6;
+}
+
+strong {
+    font-weight: 600;
+    color: #000;
+}
+"""
+
+# ---------------------------------------------------------
+# IMAGE HANDLING
+# ---------------------------------------------------------
+def fetch_image(url: str, output_dir: str) -> Optional[str]:
+    """
+    Download image from URL to persistent file for PDF rendering.
+    
+    Args:
+        url: The URL of the image
+        output_dir: Directory to save downloaded images
+        
+    Returns:
+        File URI string or None if failed
+    """
+    if not url.startswith(('http://', 'https://')):
+        if os.path.exists(url):
+            abs_path = os.path.abspath(url)
+            return Path(abs_path).as_uri()
+        return None
+    
+    try:
+        img_dir = os.path.join(output_dir, 'images')
+        os.makedirs(img_dir, exist_ok=True)
+        
+        headers = {
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36'
+        }
+        response = requests.get(url, headers=headers, timeout=15)
+        response.raise_for_status()
+        
+        # Determine file extension
+        content_type = response.headers.get('content-type', '')
+        ext = '.jpg'
+        if 'png' in content_type:
+            ext = '.png'
+        elif 'gif' in content_type:
+            ext = '.gif'
+        elif 'svg' in content_type:
+            ext = '.svg'
+        elif 'webp' in content_type:
+            ext = '.webp'
+        
+        timestamp = datetime.now().strftime('%Y%m%d_%H%M%S_%f')
+        filename = f'img_{timestamp}{ext}'
+        filepath = os.path.join(img_dir, filename)
+        
+        with open(filepath, 'wb') as f:
+            f.write(response.content)
+        
+        abs_path = os.path.abspath(filepath)
+        file_uri = Path(abs_path).as_uri()
+        
+        logger.info(f"Downloaded image: {url[:50]}... -> {filename}")
+        return file_uri
+        
+    except Exception as e:
+        logger.warning(f"Failed to download image: {url[:50]}... - {e}")
+        return None
+
+# ---------------------------------------------------------
+# Q4 REPORT GENERATOR CLASS
+# ---------------------------------------------------------
+class Q4ReportGenerator:
+    """Generates executive-quality Q4 reports using WeasyPrint."""
+    
+    def __init__(self, 
+                 title: str = "Q4 Performance Report",
+                 subtitle: str = None,
+                 author: str = None,
+                 department: str = None,
+                 date: str = None,
+                 header_text: str = None,
+                 confidential: bool = True):
+        self.title = title
+        self.subtitle = subtitle or "Fourth Quarter Analysis"
+        self.author = author or "Data Analytics Team"
+        self.department = department or "Analytics Department"
+        self.date = date or datetime.now().strftime("%B %d, %Y")
+        self.confidential = confidential
+        self.downloaded_images = []
+        
+        if header_text:
+            self.header_text = header_text
+        else:
+            parts = [self.department, self.subtitle]
+            self.header_text = " | ".join(parts)
+    
+    def _build_header(self) -> str:
+        return f'<div class="header">{self.header_text}</div>'
+    
+    def _build_footer(self) -> str:
+        footer_html = '<div class="footer">'
+        if self.confidential:
+            footer_html += '<span class="confidential-mark">CONFIDENTIAL</span>'
+        footer_html += '</div>'
+        return footer_html
+    
+    def _build_cover_page(self) -> str:
+        return f"""
+        <div class="cover-page">
+            <div class="cover-title">{self.title}</div>
+            <div class="cover-divider"></div>
+            <div class="cover-subtitle">{self.subtitle}</div>
+            <div class="cover-meta">{self.department}</div>
+            <div class="cover-meta">Prepared by: {self.author}</div>
+            <div class="cover-date">{self.date}</div>
+        </div>
+        """
+    
+    def _process_section(self, section: Dict, output_dir: str) -> str:
+        html = ""
+        
+        content = section.get("content", "")
+        if content:
+            html_content = markdown.markdown(
+                content,
+                extensions=['extra', 'sane_lists', 'tables', 'fenced_code']
+            )
+            html += f"<div class='section'>{html_content}</div>"
+        
+        images = section.get("images", [])
+        for img_data in images:
+            if isinstance(img_data, dict):
+                img_url = img_data.get("url", "")
+                caption = img_data.get("caption", "Figure: Visualization")
+            else:
+                img_url = img_data
+                caption = "Figure: Visualization"
+            
+            if img_url:
+                file_uri = fetch_image(img_url, output_dir)
+                if file_uri:
+                    self.downloaded_images.append(file_uri)
+                    html += f"""
+                    <div class="figure-container">
+                        <img src="{file_uri}" alt="{caption}">
+                        <div class="figure-caption">{caption}</div>
+                    </div>
+                    """
+        
+        if section.get("page_break", False):
+            html += '<div class="page-break"></div>'
+        
+        return html
+    
+    def generate(self, 
+                 sections: List[Dict], 
+                 filename: str = "Q4_Report.pdf",
+                 output_dir: str = "./output",
+                 cover_page: bool = True) -> bool:
+        try:
+            os.makedirs(output_dir, exist_ok=True)
+            output_path = os.path.join(output_dir, filename)
+            
+            logger.info(f"Starting Q4 report generation: {output_path}")
+            
+            body_html = ""
+            if cover_page:
+                body_html += self._build_cover_page()
+            
+            for idx, section in enumerate(sections):
+                logger.info(f"Processing section {idx + 1}/{len(sections)}")
+                body_html += self._process_section(section, output_dir)
+            
+            full_html = f"""
+            <!DOCTYPE html>
+            <html>
+            <head>
+                <meta charset="UTF-8">
+                <title>{self.title}</title>
+            </head>
+            <body>
+                {self._build_header()}
+                {self._build_footer()}
+                {body_html}
+            </body>
+            </html>
+            """
+            
+            logger.info("Rendering PDF with WeasyPrint...")
+            html_doc = HTML(string=full_html)
+            css_doc = CSS(string=CSS_STYLE)
+            
+            html_doc.write_pdf(output_path, stylesheets=[css_doc])
+            
+            abs_path = os.path.abspath(output_path)
+            file_size = os.path.getsize(output_path) / 1024
+            
+            print(f"\n{'='*70}")
+            print(f"✅ PDF GENERATED SUCCESSFULLY!")
+            print(f"{'='*70}")
+            print(f"📁 Location: {abs_path}")
+            print(f"📊 Size: {file_size:.2f} KB")
+            print(f"🖼️  Images: {len(self.downloaded_images)} embedded")
+            print(f"{'='*70}\n")
+            
+            return True
+            
+        except Exception as e:
+            logger.error(f"❌ Error generating report: {e}", exc_info=True)
+            return False
+
+# ---------------------------------------------------------
+# COMPLETE TEST CASE WITH FULL Q4 REPORT
+# ---------------------------------------------------------
+# if __name__ == "__main__":
+    
+#     q4_sections = [
+#         {
+#             "content": """
+# # Executive Summary
+
+# This report presents the comprehensive Q4 2025 performance analysis for our customer analytics division. The quarter demonstrated strong growth across key metrics with notable improvements in customer engagement and retention.
+
+# <div class="key-metric-box">
+
+# ### Key Q4 Highlights
+
+# - **Revenue Growth**: 23.4% increase over Q3 2025
+# - **Customer Acquisition**: 8,547 new customers (+18% QoQ)
+# - **Retention Rate**: 94.2% (industry-leading performance)
+# - **Data Quality Score**: 98.7% completeness
+
+# </div>
+
+# > "Q4 2025 marks our strongest quarter to date, with record-breaking performance across all major KPIs and successful implementation of our new customer engagement strategy."
+
+# ## Quarter at a Glance
+
+# The analytics team processed over 2.3 million customer interactions, generating actionable insights that drove strategic decisions across the organization.
+#             """
+#         },
+#         {
+#             "content": """
+# # Performance Metrics
+
+# ## Overall Q4 Performance
+
+# | Metric | Q4 2025 | Q3 2025 | Change | Target |
+# |--------|---------|---------|--------|--------|
+# | Total Revenue | $4.2M | $3.4M | +23.4% | $4.0M |
+# | New Customers | 8,547 | 7,243 | +18.0% | 8,000 |
+# | Active Users | 45,892 | 42,156 | +8.9% | 44,000 |
+# | Retention Rate | 94.2% | 92.8% | +1.4pp | 93.0% |
+# | Avg. Order Value | $127 | $118 | +7.6% | $120 |
+
+# <div class="highlight-box">
+
+# **Performance Assessment**: All key metrics exceeded quarterly targets, demonstrating the effectiveness of our data-driven strategy and customer-focused initiatives.
+
+# </div>
+
+# ## Channel Performance Analysis
+
+# The following visualization shows the distribution of customer orders across different channels in Q4 2025.
+#             """,
+#             "images": [
+#                 {
+#                     "url": "https://quickchart.io/chart?c={type:'bar',data:{labels:['Mobile App','Desktop Web','Mobile Web'],datasets:[{label:'Q4 Orders (%)',data:[52,35,13],backgroundColor:['rgba(0,51,102,0.8)','rgba(0,85,165,0.8)','rgba(52,152,219,0.8)']}]},options:{title:{display:true,text:'Q4 2025 Channel Distribution'},scales:{y:{beginAtZero:true,max:60}},plugins:{legend:{display:true}}}}",
+#                     "caption": "Figure 1: Customer Orders by Channel - Q4 2025"
+#                 }
+#             ],
+#             "page_break": True
+#         },
+#         {
+#             "content": """
+# # Customer Analytics Deep Dive
+
+# ## Demographic Insights
+
+# Our Q4 analysis reveals significant shifts in customer demographics and behavior patterns.
+
+# ### Age Distribution
+
+# | Age Group | Customers | % of Total | Avg. Spend | Growth (QoQ) |
+# |-----------|-----------|------------|------------|--------------|
+# | 18-24 | 8,234 | 17.9% | $89 | +22% |
+# | 25-34 | 15,678 | 34.2% | $142 | +15% |
+# | 35-44 | 12,456 | 27.1% | $156 | +11% |
+# | 45-54 | 6,789 | 14.8% | $178 | +8% |
+# | 55+ | 2,735 | 6.0% | $203 | +5% |
+
+# ## Revenue Trend Analysis
+
+# Below is the revenue trend across Q4 months showing consistent growth:
+#             """,
+#             "images": [
+#                 {
+#                     "url": "https://quickchart.io/chart?c={type:'line',data:{labels:['October','November','December'],datasets:[{label:'Revenue ($M)',data:[1.2,1.5,1.5],borderColor:'rgb(0,51,102)',backgroundColor:'rgba(0,51,102,0.1)',fill:true}]},options:{title:{display:true,text:'Q4 2025 Monthly Revenue Trend'},scales:{y:{beginAtZero:true,max:2}}}}",
+#                     "caption": "Figure 2: Monthly Revenue Trend - Q4 2025"
+#                 }
+#             ],
+#             "page_break": True
+#         },
+#         {
+#             "content": """
+# # Recommendations & 2026 Strategy
+
+# ## Key Recommendations
+
+# ### Immediate Actions (Q1 2026)
+
+# 1. **Expand Mobile Capabilities**
+#    - Invest in mobile app feature development
+#    - Optimize mobile checkout experience
+#    - Target: 60% mobile order share by Q2 2026
+
+# 2. **Scale Personalization Engine**
+#    - Deploy to all customer touchpoints
+#    - Expected: 35% increase in engagement
+
+# 3. **Enhance Data Infrastructure**
+#    - Implement advanced data governance framework
+#    - Prepare for 3x data volume growth
+
+# <div class="executive-summary">
+
+# **2026 Vision**: Position our analytics capabilities as a competitive differentiator through advanced AI, real-time insights, and predictive decision-making.
+
+# </div>
+
+# ## Investment Requirements
+
+# | Initiative | Investment | Expected ROI | Timeline |
+# |------------|------------|--------------|----------|
+# | Mobile Expansion | $450K | 280% | Q1-Q2 2026 |
+# | AI/ML Platform | $780K | 420% | Q1-Q4 2026 |
+# | Infrastructure | $320K | 195% | Q1-Q3 2026 |
+# | **Total** | **$1.55M** | **310%** | **2026** |
+#             """
+#         },
+#         {
+#             "content": f"""
+# # Conclusion
+
+# ## Quarter Summary
+
+# Q4 2025 represents a milestone quarter for our analytics organization. We exceeded all primary objectives, delivered exceptional data quality, and laid the foundation for continued growth.
+
+# ### Key Achievements
+
+# - ✓ **23.4% revenue growth** exceeding target by 5%
+# - ✓ **8,547 new customers** acquired, 7% above goal
+# - ✓ **94.2% retention rate**, best in company history
+# - ✓ **98.7% data quality score**, industry-leading
+
+# <div class="highlight-box">
+
+# **Strategic Position**: Our analytics capabilities represent a significant competitive advantage for 2026 and beyond.
+
+# </div>
+
+# ---
+
+# **Prepared by**: Data Analytics Team  
+# **Report Date**: {datetime.now().strftime("%B %d, %Y")}  
+# **Classification**: Confidential - Internal Use Only
+#             """
+#         }
+#     ]
+    
+#     # Generate the complete Q4 report
+#     generator = Q4ReportGenerator(
+#         title="Q4 2025 Analytics Performance Report",
+#         subtitle="Fourth Quarter Results & 2026 Strategy",
+#         author="Senior Data Analyst",
+#         department="Data Analytics Division",
+#         confidential=True
+#     )
+    
+#     success = generator.generate(
+#         sections=q4_sections,
+#         filename="Q4_2025_Complete_Report.pdf",
+#         output_dir="./output",
+#         cover_page=True
+#     )
+    
+#     if success:
+#         print("\n📋 Report Features:")
+#         print("  ✓ Executive cover page")
+#         print("  ✓ Performance metrics with tables")
+#         print("  ✓ Embedded charts and visualizations")
+#         print("  ✓ Customer analytics insights")
+#         print("  ✓ Strategic recommendations")
+#         print("  ✓ Professional styling and formatting")
+#         print("\n💡 Check the 'output' folder for your PDF!")
+#     else:
+#         print("\n❌ Report generation failed. Check logs for details.")