データ可視化レポート納品の型：Tableau/Matplotlib｜“図3点＋結論1行＋運用”で伝わる・続く・刺さる

report/
  data/sales.csv
  src/make_report.py
  outputs/weekly_report_YYYYMMDD.pdf
  config.yaml
  README.md

date_col: date
value_col: sales
segment: category
freq: D

import pandas as pd
import matplotlib.pyplot as plt
from matplotlib.backends.backend_pdf import PdfPages
import yaml, pathlib

cfg = yaml.safe\_load(open('config.yaml', 'r', encoding='utf-8'))
path = pathlib.Path('data/sales.csv')
df = pd.read\_csv(path, parse\_dates=\[cfg\['date\_col']])

# 前処理

s = (df.set\_index(cfg\['date\_col'])\[cfg\['value\_col']]
.asfreq(cfg\['freq']).fillna(0))
seg = (df.pivot\_table(index=cfg\['date\_col'], columns=cfg\['segment'],
values=cfg\['value\_col'], aggfunc='sum')
.asfreq(cfg\['freq']).fillna(0))

with PdfPages('outputs/weekly\_report.pdf') as pdf:
\# 図1：推移
plt.figure(figsize=(10,5))
s.rolling(7).mean().plot()
plt.title('売上推移（7日移動平均）'); plt.xlabel('日付'); plt.ylabel('売上')
plt.axhline(s.mean(), linestyle='--')
pdf.savefig(); plt.close()

```
# 図2：分解（上位カテゴリ）
top = seg.iloc[-30:].sum().sort_values(ascending=False).head(5).index
plt.figure(figsize=(10,5))
seg[top].iloc[-30:].plot(kind='bar', stacked=True)
plt.title('直近30日のカテゴリ別売上'); plt.xlabel('日付'); plt.ylabel('売上')
pdf.savefig(); plt.close()

# 図3：構成比（直近週）
last = seg.iloc[-7:].sum()
plt.figure(figsize=(8,6))
(last/last.sum()).sort_values().plot(kind='barh')
plt.title('直近7日の構成比'); plt.xlabel('構成比')
pdf.savefig(); plt.close()

import smtplib, ssl
from email.message import EmailMessage

msg = EmailMessage()
msg\['Subject'] = '\[週次KPI] レポート'
msg\['From'] = '[noreply@example.com](mailto:noreply@example.com)'
msg\['To'] = '[team@example.com](mailto:team@example.com)'
msg.set\_content('結論1行：売上+8%、欠品-1.2pt。詳細はPDF参照。')

with open('outputs/weekly\_report.pdf', 'rb') as f:
msg.add\_attachment(f.read(), maintype='application', subtype='pdf',
filename='weekly\_report.pdf')

with smtplib.SMTP\_SSL('smtp.example.com', 465, context=ssl.create\_default\_context()) as s:
s.login('user','pass'); s.send\_message(msg)

# SOW（レポート納品）
目的：経営会議の意思決定を迅速化（所要10分）
成果物：PDF 1本（結論1行＋図3点）、Tableauダッシュボード1本
検収：KPI定義一致／PDF生成≤3分／図の禁じ手なし
納期：YYYY-MM-DD（営業日10日）
運用：Tableauサブスク配信／Python自動出力のREADME
変更：指標/定義変更はChange Requestで合意