コピペで回るレポート納品｜Jupyter→PDF/HTML→共有の自動化テンプレ

report-kit/
  README.md
  data/
    raw/          # 入手データ（触らない）
    interim/      # 中間（Parquet/キャッシュ）
    out/          # 図・表（PNG/CSV）
  notebooks/
    00_preamble.ipynb   # 図表スタイル/関数の読み込み
    10_eda.ipynb        # 品質チェック・俯瞰
    20_analysis.ipynb   # 主要分析
    30_report.ipynb     # 図表貼り込み・文章生成
  styles/
    matplotlib.mplstyle
    report.css
    report.tpl          # nbconvertテンプレ（Jinja）
  build/
    build.py            # papermill→nbconvertの一発ビルド
  dist/                 # 出力（PDF/HTML/ZIP）
  requirements.txt
  Dockerfile（任意）

figure.dpi: 150
savefig.dpi: 150
font.size: 10
axes.titlesize: 12
axes.labelsize: 10
axes.grid: True
grids.alpha: 0.2
legend.frameon: False

import matplotlib.pyplot as plt
plt.style.use("styles/matplotlib.mplstyle")

ax = df.plot(x="date", y="sales")
ax.set_title("週次売上推移（移動平均7日）")
ax.set_xlabel("日付"); ax.set_ylabel("売上")
ax.annotate("キャンペーン", xy=(pd.Timestamp("2025-08-01"), 1200),
            xytext=(+7, +200), textcoords="offset points",
            arrowprops=dict(arrowstyle="->"))
plt.tight_layout()
plt.savefig("data/out/fig_20_01_sales.png", bbox_inches="tight")

from pathlib import Path
import papermill as pm
import nbformat
from nbconvert import PDFExporter, HTMLExporter
from traitlets.config import Config
from datetime import date

ROOT = Path(**file**).resolve().parents\[1]
NB = ROOT/"notebooks"
DIST = ROOT/"dist"; DIST.mkdir(exist\_ok=True)
DATE = date.today().strftime("%Y%m%d")

# 1) パラメータ注入（週・フィルタ条件など）

pm.execute\_notebook(
NB/"30\_report.ipynb",            # 入力
NB/"30\_report\_out.ipynb",        # 出力（実行後）
parameters={"report\_date": DATE}
)

# 2) HTMLエクスポート（CSS適用）

html\_conf = Config()
html\_conf.TemplateExporter.exclude\_input = True  # コード非表示
html = HTMLExporter(config=html\_conf)
html.exclude\_input = True
(body\_html, res) = html.from\_filename(NB/"30\_report\_out.ipynb")
(ROOT/"styles"/"report.css").write\_text((ROOT/"styles"/"report.css").read\_text(encoding="utf-8"), encoding="utf-8")
(DIST/f"{DATE}\_週次レポート.html").write\_text(body\_html, encoding="utf-8")

# 3) PDFエクスポート（LaTeX環境がある場合）

pdf\_conf = Config()
pdf\_conf.TemplateExporter.exclude\_input = True
pdf = PDFExporter(config=pdf\_conf)
(body\_pdf, res) = pdf.from\_filename(NB/"30\_report\_out.ipynb")
(DIST/f"{DATE}\_週次レポート.pdf").write\_bytes(body\_pdf)

@page { size: A4; margin: 18mm; }
h1, h2, h3 { page-break-after: avoid; }
.figure { page-break-inside: avoid; margin: 0 0 12px; }
.footer { color: #777; font-size: 10px; text-align: right; }

import pandas as pd
with pd.ExcelWriter("dist/出力.xlsx", engine="xlsxwriter") as w:
    summary.to_excel(w, sheet_name="サマリ", index=False)
    detail.to_excel(w, sheet_name="明細", index=False)

from pptx import Presentation
from pptx.util import Inches
prs = Presentation()
s = prs.slides.add_slide(prs.slide_layouts[5])
title = s.shapes.title or s.shapes.add_textbox(Inches(0.5), Inches(0.2), Inches(9), Inches(1)).text_frame
title.text = "週次レポート"
s.shapes.add_picture("data/out/fig_20_01_sales.png", Inches(0.5), Inches(1.2), width=Inches(8))
prs.save("dist/週次レポート.pptx")

name: weekly-report
on:
  schedule:
    - cron: "10 21 * * *"   # JST 6:10（UTC+9）
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with: { python-version: '3.12' }
      - run: pip install -r requirements.txt
      - run: python build/build.py
      - uses: actions/upload-artifact@v4
        with: { name: report, path: dist/ }