#!/usr/bin/env python3
"""
generate_report_pdf.py
Executive Jira Weekly Report PDF Generator.
Renders responsive HTML5/CSS and vector SVG into an executive-grade A4 PDF via Playwright.
"""
import asyncio
import json
from pathlib import Path
from jira_client import JiraClient
from metrics_engine import MetricsEngine
PROTOTYPE_DIR = Path(__file__).parent
OUTPUT_PDF = PROTOTYPE_DIR / "jira_weekly_executive_report.pdf"
OUTPUT_HTML = PROTOTYPE_DIR / "report_preview.html"
def generate_burndown_svg(burndown: list, total_pts: float) -> str:
vw, vh = 500, 180
margin_l, margin_r, margin_t, margin_b = 40, 20, 20, 30
plot_w = vw - margin_l - margin_r
plot_h = vh - margin_t - margin_b
max_val = max(total_pts, 1.0)
n = len(burndown)
ideal_points = []
actual_points = []
for idx, item in enumerate(burndown):
x = margin_l + (idx / (n - 1)) * plot_w
y_ideal = margin_t + plot_h - (item["ideal"] / max_val) * plot_h
y_actual = margin_t + plot_h - (item["actual"] / max_val) * plot_h
ideal_points.append(f"{x:.1f},{y_ideal:.1f}")
actual_points.append(f"{x:.1f},{y_actual:.1f}")
ideal_line = " ".join(ideal_points)
actual_line = " ".join(actual_points)
x_labels = "".join(
f'{item["day"]}'
for i, item in enumerate(burndown)
)
y_grid = "".join(
f''
f'{round(max_val * (1 - k / 3)):.0f}'
for k in range(4)
)
return f"""
"""
def build_html_report(metrics: dict) -> str:
burndown_svg = generate_burndown_svg(metrics["burndown"], metrics["total_points"])
dev_rows = ""
for d in metrics["developers"]:
logged = d["hours_logged"]
est = d["hours_estimated"]
pct = min(round((logged / est * 100), 0) if est > 0 else 0, 150)
bar_color = "#10B981" if logged <= est else "#F59E0B"
dev_rows += f"""
| {d['developer']} |
{d['tasks_completed']} Done |
{d['tasks_active']} Active |
{logged}h / {est}h |
|
"""
issue_rows = ""
for issue in metrics["completed_issues"]:
issue_rows += f"""
| {issue['key']} |
{issue['summary']} |
{issue['type']} |
{issue['assignee']} |
{issue['story_points']} pts |
{issue['time_spent_hours']}h |
"""
return f"""
Jira Weekly Executive Report - {metrics['sprint_name']}
Sprint Velocity
{metrics['completed_points']} / {metrics['total_points']}
{metrics['completion_rate']}% Target Accomplished
Completed Tasks
{metrics['completed_count']} / {metrics['total_issues']}
+{metrics['completed_count']} Issues Closed
Total Time Spent
{metrics['total_hours_spent']}h
Est: {metrics['total_hours_est']}h ({'+' if metrics['estimation_variance'] >= 0 else ''}{metrics['estimation_variance']}h variance)
Active / In Review
{metrics['in_progress_count'] + metrics['in_review_count']}
On Track for Sprint Close
Sprint Burndown Progression
{burndown_svg}
Developer Workload & Hours Logged
| Developer |
Completed |
In Progress |
Logged vs Estimate |
Capacity Allocation |
{dev_rows}
Key Completed Deliverables
| Issue Key |
Summary |
Type |
Assignee |
Story Points |
Time Spent |
{issue_rows}
"""
async def main():
client = JiraClient(offline=True)
raw_data = client.fetch_sprint_data()
metrics = MetricsEngine.compute_sprint_metrics(raw_data)
html_content = build_html_report(metrics)
OUTPUT_HTML.write_text(html_content, encoding="utf-8")
print(f"[*] HTML Report generated at: {OUTPUT_HTML}")
# Render PDF via Playwright
try:
from playwright.async_api import async_playwright
async with async_playwright() as p:
browser = await p.chromium.launch()
page = await browser.new_page()
await page.set_content(html_content, wait_until="networkidle")
await page.pdf(
path=str(OUTPUT_PDF),
format="A4",
print_background=True,
margin={"top": "0mm", "bottom": "0mm", "left": "0mm", "right": "0mm"}
)
await browser.close()
print(f"[SUCCESS] Executive PDF Report compiled at: {OUTPUT_PDF}")
except Exception as e:
print(f"[!] Playwright compilation error: {e}. HTML report remains available at: {OUTPUT_HTML}")
if __name__ == "__main__":
asyncio.run(main())