"""
PDF Report Generator for Restaurant Intelligence Agent
Generates professional PDF reports with:
- Executive Summary
- Menu Analysis with charts
- Aspect Analysis
- Chef & Manager Insights
- Trend Analysis
- Customer Feedback Highlights
"""
import os
import io
import tempfile
from datetime import datetime
from typing import Dict, Any, Optional, List
from reportlab.lib import colors
from reportlab.lib.pagesizes import letter, A4
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.units import inch
from reportlab.lib.enums import TA_CENTER, TA_LEFT, TA_JUSTIFY
from reportlab.platypus import (
SimpleDocTemplate, Paragraph, Spacer, Table, TableStyle,
Image, PageBreak, ListFlowable, ListItem
)
from reportlab.graphics.shapes import Drawing, Rect
from reportlab.graphics.charts.barcharts import HorizontalBarChart
# Color scheme
COLORS = {
'primary': colors.HexColor('#2196F3'), # Blue
'positive': colors.HexColor('#10b981'), # Green
'neutral': colors.HexColor('#f59e0b'), # Amber
'negative': colors.HexColor('#ef4444'), # Red
'text': colors.HexColor('#1f2937'), # Dark gray
'light_gray': colors.HexColor('#f3f4f6'), # Light background
'border': colors.HexColor('#e5e7eb'), # Border
}
def get_sentiment_color(sentiment: float) -> colors.Color:
"""Get color based on sentiment score."""
if sentiment > 0.3:
return COLORS['positive']
elif sentiment > -0.3:
return COLORS['neutral']
else:
return COLORS['negative']
def create_styles():
"""Create custom paragraph styles."""
styles = getSampleStyleSheet()
# Title style
styles.add(ParagraphStyle(
name='ReportTitle',
parent=styles['Heading1'],
fontSize=28,
textColor=COLORS['primary'],
spaceAfter=30,
alignment=TA_CENTER,
fontName='Helvetica-Bold'
))
# Section header
styles.add(ParagraphStyle(
name='SectionHeader',
parent=styles['Heading2'],
fontSize=16,
textColor=COLORS['primary'],
spaceBefore=20,
spaceAfter=12,
fontName='Helvetica-Bold'
))
# Subsection header
styles.add(ParagraphStyle(
name='SubsectionHeader',
parent=styles['Heading3'],
fontSize=12,
textColor=COLORS['text'],
spaceBefore=15,
spaceAfter=8,
fontName='Helvetica-Bold'
))
# Body text
styles.add(ParagraphStyle(
name='BodyText',
parent=styles['Normal'],
fontSize=10,
textColor=COLORS['text'],
spaceAfter=8,
alignment=TA_JUSTIFY,
leading=14
))
# Highlight/quote text
styles.add(ParagraphStyle(
name='Quote',
parent=styles['Normal'],
fontSize=10,
textColor=colors.HexColor('#4b5563'),
leftIndent=20,
rightIndent=20,
spaceAfter=10,
fontName='Helvetica-Oblique',
leading=14
))
# Stat number
styles.add(ParagraphStyle(
name='StatNumber',
parent=styles['Normal'],
fontSize=24,
textColor=COLORS['primary'],
alignment=TA_CENTER,
fontName='Helvetica-Bold'
))
# Stat label
styles.add(ParagraphStyle(
name='StatLabel',
parent=styles['Normal'],
fontSize=9,
textColor=colors.HexColor('#6b7280'),
alignment=TA_CENTER
))
return styles
def create_stat_box(value: str, label: str, styles) -> Table:
"""Create a statistics box."""
data = [
[Paragraph(str(value), styles['StatNumber'])],
[Paragraph(label, styles['StatLabel'])]
]
table = Table(data, colWidths=[1.5*inch])
table.setStyle(TableStyle([
('BACKGROUND', (0, 0), (-1, -1), COLORS['light_gray']),
('ALIGN', (0, 0), (-1, -1), 'CENTER'),
('VALIGN', (0, 0), (-1, -1), 'MIDDLE'),
('TOPPADDING', (0, 0), (-1, 0), 15),
('BOTTOMPADDING', (0, -1), (-1, -1), 15),
('LEFTPADDING', (0, 0), (-1, -1), 10),
('RIGHTPADDING', (0, 0), (-1, -1), 10),
('ROUNDEDCORNERS', [5, 5, 5, 5]),
]))
return table
def create_sentiment_table(items: List[Dict], title: str, styles, max_items: int = 10) -> List:
"""Create a table showing items with sentiment scores."""
elements = []
elements.append(Paragraph(title, styles['SubsectionHeader']))
if not items:
elements.append(Paragraph("No data available.", styles['BodyText']))
return elements
# Sort by mentions and take top items
sorted_items = sorted(items, key=lambda x: x.get('mention_count', 0), reverse=True)[:max_items]
# Table header
data = [['Item', 'Sentiment', 'Mentions', 'Status']]
for item in sorted_items:
name = item.get('name', 'Unknown')[:30]
sentiment = item.get('sentiment', 0)
mentions = item.get('mention_count', 0)
# Status emoji based on sentiment
if sentiment > 0.3:
status = '✅ Positive'
elif sentiment > -0.3:
status = '🟡 Mixed'
else:
status = '⚠️ Needs Attention'
data.append([name.title(), f'{sentiment:+.2f}', str(mentions), status])
table = Table(data, colWidths=[2.5*inch, 1*inch, 0.8*inch, 1.5*inch])
table.setStyle(TableStyle([
# Header
('BACKGROUND', (0, 0), (-1, 0), COLORS['primary']),
('TEXTCOLOR', (0, 0), (-1, 0), colors.white),
('FONTNAME', (0, 0), (-1, 0), 'Helvetica-Bold'),
('FONTSIZE', (0, 0), (-1, 0), 10),
('BOTTOMPADDING', (0, 0), (-1, 0), 10),
('TOPPADDING', (0, 0), (-1, 0), 10),
# Body
('FONTNAME', (0, 1), (-1, -1), 'Helvetica'),
('FONTSIZE', (0, 1), (-1, -1), 9),
('BOTTOMPADDING', (0, 1), (-1, -1), 6),
('TOPPADDING', (0, 1), (-1, -1), 6),
# Alternating row colors
('ROWBACKGROUNDS', (0, 1), (-1, -1), [colors.white, COLORS['light_gray']]),
# Grid
('GRID', (0, 0), (-1, -1), 0.5, COLORS['border']),
('ALIGN', (1, 0), (-1, -1), 'CENTER'),
]))
elements.append(table)
elements.append(Spacer(1, 15))
return elements
def create_insights_section(insights: Dict, role: str, styles) -> List:
"""Create insights section for Chef or Manager."""
elements = []
role_title = "Chef" if role == "chef" else "Manager"
emoji = "🍳" if role == "chef" else "📊"
elements.append(Paragraph(f"{emoji} {role_title} Insights", styles['SectionHeader']))
# Summary
summary = insights.get('summary', 'No summary available.')
elements.append(Paragraph(f"Summary: {summary}", styles['BodyText']))
elements.append(Spacer(1, 10))
# Strengths
strengths = insights.get('strengths', [])
if strengths:
elements.append(Paragraph("✅ Strengths", styles['SubsectionHeader']))
for s in strengths[:5]:
if isinstance(s, dict):
s = s.get('action', str(s))
elements.append(Paragraph(f"• {s}", styles['BodyText']))
elements.append(Spacer(1, 10))
# Concerns
concerns = insights.get('concerns', [])
if concerns:
elements.append(Paragraph("⚠️ Areas of Concern", styles['SubsectionHeader']))
for c in concerns[:5]:
if isinstance(c, dict):
c = c.get('action', str(c))
elements.append(Paragraph(f"• {c}", styles['BodyText']))
elements.append(Spacer(1, 10))
# Recommendations
recommendations = insights.get('recommendations', [])
if recommendations:
elements.append(Paragraph("💡 Recommendations", styles['SubsectionHeader']))
for r in recommendations[:5]:
if isinstance(r, dict):
priority = r.get('priority', '').upper()
action = r.get('action', str(r))
if priority:
elements.append(Paragraph(f"• [{priority}] {action}", styles['BodyText']))
else:
elements.append(Paragraph(f"• {action}", styles['BodyText']))
else:
elements.append(Paragraph(f"• {r}", styles['BodyText']))
return elements
def generate_pdf_report(
analysis_data: Dict[str, Any],
restaurant_name: str,
output_path: Optional[str] = None
) -> str:
"""
Generate a professional PDF report from analysis data.
Args:
analysis_data: Complete analysis results from the agent
restaurant_name: Name of the restaurant
output_path: Optional path to save PDF (if None, uses temp file)
Returns:
Path to generated PDF file
"""
# Create output path if not provided
if not output_path:
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
safe_name = restaurant_name.lower().replace(" ", "_").replace("/", "_")
output_path = os.path.join(tempfile.gettempdir(), f"{safe_name}_report_{timestamp}.pdf")
# Ensure directory exists
os.makedirs(os.path.dirname(output_path) if os.path.dirname(output_path) else '.', exist_ok=True)
# Create document
doc = SimpleDocTemplate(
output_path,
pagesize=letter,
rightMargin=0.75*inch,
leftMargin=0.75*inch,
topMargin=0.75*inch,
bottomMargin=0.75*inch
)
# Get styles
styles = create_styles()
# Build document content
elements = []
# ========== COVER PAGE ==========
elements.append(Spacer(1, 1.5*inch))
elements.append(Paragraph("🍽️", styles['ReportTitle']))
elements.append(Paragraph("Restaurant Intelligence Report", styles['ReportTitle']))
elements.append(Spacer(1, 0.3*inch))
elements.append(Paragraph(restaurant_name, ParagraphStyle(
'RestaurantName',
parent=styles['Heading1'],
fontSize=22,
textColor=COLORS['text'],
alignment=TA_CENTER
)))
elements.append(Spacer(1, 0.5*inch))
# Report metadata
report_date = datetime.now().strftime("%B %d, %Y")
elements.append(Paragraph(f"Generated: {report_date}", ParagraphStyle(
'ReportDate',
parent=styles['Normal'],
fontSize=11,
textColor=colors.HexColor('#6b7280'),
alignment=TA_CENTER
)))
elements.append(Spacer(1, 1*inch))
# Quick stats on cover
menu = analysis_data.get('menu_analysis', {})
aspects = analysis_data.get('aspect_analysis', {})
raw_reviews = analysis_data.get('raw_reviews', [])
food_items = menu.get('food_items', [])
drinks = menu.get('drinks', [])
aspect_list = aspects.get('aspects', [])
stat_data = [
[
create_stat_box(str(len(raw_reviews)), "Reviews Analyzed", styles),
create_stat_box(str(len(food_items) + len(drinks)), "Menu Items", styles),
create_stat_box(str(len(aspect_list)), "Aspects Analyzed", styles)
]
]
stat_table = Table(stat_data, colWidths=[2*inch, 2*inch, 2*inch])
stat_table.setStyle(TableStyle([
('ALIGN', (0, 0), (-1, -1), 'CENTER'),
('VALIGN', (0, 0), (-1, -1), 'MIDDLE'),
]))
elements.append(stat_table)
elements.append(PageBreak())
# ========== EXECUTIVE SUMMARY ==========
elements.append(Paragraph("📋 Executive Summary", styles['SectionHeader']))
# Calculate overall sentiment
all_items = food_items + drinks
if all_items:
avg_sentiment = sum(i.get('sentiment', 0) for i in all_items) / len(all_items)
sentiment_text = "positive" if avg_sentiment > 0.3 else "mixed" if avg_sentiment > -0.3 else "concerning"
elements.append(Paragraph(
f"Based on analysis of {len(raw_reviews)} customer reviews, {restaurant_name} shows "
f"{sentiment_text} overall sentiment (score: {avg_sentiment:+.2f}). "
f"The analysis identified {len(all_items)} menu items and {len(aspect_list)} "
f"customer experience aspects.",
styles['BodyText']
))
else:
elements.append(Paragraph(
f"Analysis of {len(raw_reviews)} customer reviews for {restaurant_name}.",
styles['BodyText']
))
elements.append(Spacer(1, 15))
# Key highlights
if all_items:
top_items = sorted(all_items, key=lambda x: x.get('sentiment', 0), reverse=True)[:3]
if top_items:
elements.append(Paragraph("🌟 Top Performing Items", styles['SubsectionHeader']))
for item in top_items:
elements.append(Paragraph(
f"• {item.get('name', '?').title()} - Sentiment: {item.get('sentiment', 0):+.2f}",
styles['BodyText']
))
elements.append(Spacer(1, 10))
# Areas needing attention
problem_items = [i for i in all_items if i.get('sentiment', 0) < -0.2]
if problem_items:
elements.append(Paragraph("⚠️ Items Needing Attention", styles['SubsectionHeader']))
for item in problem_items[:3]:
elements.append(Paragraph(
f"• {item.get('name', '?').title()} - Sentiment: {item.get('sentiment', 0):+.2f}",
styles['BodyText']
))
elements.append(PageBreak())
# ========== MENU ANALYSIS ==========
elements.append(Paragraph("🍽️ Menu Performance Analysis", styles['SectionHeader']))
elements.append(Paragraph(
f"Analysis of {len(food_items)} food items and {len(drinks)} beverages mentioned in customer reviews.",
styles['BodyText']
))
# Food items table
if food_items:
elements.extend(create_sentiment_table(food_items, "Food Items", styles))
# Drinks table
if drinks:
elements.extend(create_sentiment_table(drinks, "Beverages", styles))
elements.append(PageBreak())
# ========== ASPECT ANALYSIS ==========
elements.append(Paragraph("📊 Customer Experience Aspects", styles['SectionHeader']))
elements.append(Paragraph(
"Analysis of key aspects that customers mentioned in their reviews.",
styles['BodyText']
))
if aspect_list:
elements.extend(create_sentiment_table(aspect_list, "Aspects Overview", styles))
elements.append(PageBreak())
# ========== CHEF INSIGHTS ==========
chef_insights = analysis_data.get('insights', {}).get('chef', {})
if chef_insights:
elements.extend(create_insights_section(chef_insights, 'chef', styles))
elements.append(PageBreak())
# ========== MANAGER INSIGHTS ==========
manager_insights = analysis_data.get('insights', {}).get('manager', {})
if manager_insights:
elements.extend(create_insights_section(manager_insights, 'manager', styles))
elements.append(PageBreak())
# ========== CUSTOMER FEEDBACK HIGHLIGHTS ==========
elements.append(Paragraph("💬 Customer Feedback Highlights", styles['SectionHeader']))
# Get some sample reviews
if raw_reviews:
positive_reviews = [r for r in raw_reviews if r.get('rating', 0) >= 4][:3]
if positive_reviews:
elements.append(Paragraph("Positive Feedback", styles['SubsectionHeader']))
for r in positive_reviews:
text = r.get('text', r.get('review_text', ''))[:200]
if text:
elements.append(Paragraph(f'"{text}..."', styles['Quote']))
elements.append(Spacer(1, 20))
# ========== FOOTER ==========
elements.append(Paragraph(
"Report generated by Restaurant Intelligence Agent | Powered by Claude AI",
ParagraphStyle(
'Footer',
parent=styles['Normal'],
fontSize=9,
textColor=colors.HexColor('#9ca3af'),
alignment=TA_CENTER
)
))
# Build PDF
doc.build(elements)
print(f"✅ PDF Report generated: {output_path}")
return output_path
def generate_pdf_bytes(analysis_data: Dict[str, Any], restaurant_name: str) -> bytes:
"""
Generate PDF report and return as bytes (for direct download).
Args:
analysis_data: Complete analysis results
restaurant_name: Name of the restaurant
Returns:
PDF file as bytes
"""
# Generate to temp file
pdf_path = generate_pdf_report(analysis_data, restaurant_name)
# Read bytes
with open(pdf_path, 'rb') as f:
pdf_bytes = f.read()
# Clean up temp file
try:
os.remove(pdf_path)
except:
pass
return pdf_bytes
if __name__ == "__main__":
# Test with sample data
sample_data = {
'menu_analysis': {
'food_items': [
{'name': 'salmon sushi', 'sentiment': 0.85, 'mention_count': 12},
{'name': 'miso soup', 'sentiment': 0.72, 'mention_count': 8},
{'name': 'tempura', 'sentiment': -0.15, 'mention_count': 5},
],
'drinks': [
{'name': 'sake', 'sentiment': 0.65, 'mention_count': 6},
{'name': 'green tea', 'sentiment': 0.90, 'mention_count': 4},
]
},
'aspect_analysis': {
'aspects': [
{'name': 'service', 'sentiment': 0.75, 'mention_count': 25},
{'name': 'ambiance', 'sentiment': 0.82, 'mention_count': 18},
{'name': 'wait time', 'sentiment': -0.30, 'mention_count': 10},
]
},
'insights': {
'chef': {
'summary': 'Overall positive feedback on sushi quality.',
'strengths': ['Fresh ingredients', 'Beautiful presentation'],
'concerns': ['Tempura can be inconsistent'],
'recommendations': [
{'priority': 'high', 'action': 'Review tempura preparation process'}
]
},
'manager': {
'summary': 'Service is a strong point, wait times need attention.',
'strengths': ['Friendly staff', 'Attentive service'],
'concerns': ['Long wait times during peak hours'],
'recommendations': [
{'priority': 'medium', 'action': 'Consider reservation system improvements'}
]
}
},
'raw_reviews': [
{'rating': 5, 'text': 'Amazing sushi, best in the city!'},
{'rating': 4, 'text': 'Great food but had to wait 30 minutes.'},
]
}
output = generate_pdf_report(sample_data, "Test Restaurant", "test_report.pdf")
print(f"Test report saved to: {output}")