Claude Code x openpyxl で勤怠データ集計・残業アラートを完全自動化する

毎月の勤怠集計3時間がスクリプト1本で終わった

人事担当として毎月、30名分の勤怠Excelを集めて残業時間を集計するのに3時間かかっていました。Claude Codeに依頼したところ、打刻データの集計から36協定アラート・給与計算CSV出力まで完全自動化できました。

STEP 1：打刻データから勤務時間を自動計算する

勤怠システムからエクスポートした打刻CSVを読み込み、勤務時間・残業時間を自動計算します。

import pandas as pd
from datetime import datetime, time, timedelta

df = pd.read_csv("kintai_202504.csv", parse_dates=["日付"])
df["出勤"] = pd.to_datetime(df["出勤時刻"], format="%H:%M").dt.time
df["退勤"] = pd.to_datetime(df["退勤時刻"], format="%H:%M").dt.time

def calc(row):
    s = datetime.combine(row["日付"], row["出勤"])
    e = datetime.combine(row["日付"], row["退勤"])
    if e < s: e += timedelta(days=1)
    we = datetime.combine(row["日付"], time(18,0))
    ms = datetime.combine(row["日付"], time(22,0))
    reg = max(min((we-s).seconds/3600, 8), 0)
    ot  = max((e-we).seconds/3600, 0) if e > we else 0
    mid = max((e-ms).seconds/3600, 0) if e > ms else 0
    hol = (e-s).seconds/3600 - 1 if row["日付"].weekday()>=5 else 0
    return pd.Series({"所定内":round(reg,2),"残業":round(ot,2),
                       "深夜残業":round(mid,2),"休日出勤":round(max(hol,0),2)})

df = pd.concat([df, df.apply(calc,axis=1)], axis=1)
summary = df.groupby(["社員番号","氏名","部門"]).agg(
    {"所定内":"sum","残業":"sum","深夜残業":"sum","休日出勤":"sum"}).reset_index()
print(summary.head())

STEP 2：36協定アラートを自動生成する

残業時間が36協定の上限に近づいている社員を自動検出してExcelに色付けします。

import openpyxl
from openpyxl.styles import PatternFill, Font

wb = openpyxl.Workbook(); ws = wb.active; ws.title = "勤怠集計"
red_f=PatternFill("solid",fgColor="FFCDD2"); yel_f=PatternFill("solid",fgColor="FFF9C4")
hdrs=["社員番号","氏名","部門","所定内","残業","深夜","休日","合計残業","年間","36協定"]
for c,h in enumerate(hdrs,1):
    cell=ws.cell(1,c,h); cell.font=Font(bold=True,color="FFFFFF")
    cell.fill=PatternFill("solid",fgColor="107C41")

for ri, row in enumerate(summary.itertuples(), 2):
    total_ot = row.残業 + row.深夜残業 + row.休日出勤
    annual   = 0  # 年間集計は別途取得
    if annual > 360: alert,fill,f = "法違反リスク",red_f,Font(color="B71C1C",bold=True)
    elif total_ot > 60: alert,fill,f = "危険",red_f,Font(color="B71C1C")
    elif total_ot > 45: alert,fill,f = "要注意",yel_f,Font(color="E65100")
    else:               alert,fill,f = "正常",None,Font()
    vals=[row.社員番号,row.氏名,row.部門,row.所定内,row.残業,row.深夜残業,row.休日出勤,total_ot,annual,alert]
    for ci,v in enumerate(vals,1):
        c=ws.cell(ri,ci,v)
        if fill: c.fill=fill; c.font=f

wb.save("attendance_report.xlsx"); print("勤怠レポート出力完了")

STEP 3：マネージャーに自動アラートメールを送信する

残業過多の社員がいる部門マネージャーに自動でメール通知を送ります。

import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText

MGR = {"営業部":"sales-mgr@co.jp","開発部":"dev-mgr@co.jp"}

def send_ot_alert(dept, staff_list):
    rows = "".join(f"{s['氏名']}{s['残業']:.1f}h" for s in staff_list)
    html = (f"
【勤怠アラート】{dept}
"
            f"
以下のメンバーの残業が月45時間を超えました。来月の削減計画を提出してください。
"
            f"{rows}
氏名
残業時間
")
    msg = MIMEMultipart("alternative")
    msg["Subject"] = f"【勤怠アラート】{dept} 残業超過通知"
    msg["From"]="hr@co.jp"; msg["To"]=MGR.get(dept,"")
    msg.attach(MIMEText(html,"html","utf-8"))
    with smtplib.SMTP("smtp.office365.com",587) as sv:
        sv.starttls(); sv.login("hr@co.jp","PW"); sv.send_message(msg)
    print(f"送信: {dept}")

for dept, grp in summary.groupby("部門"):
    over = grp[grp["残業"]>45]
    if not over.empty: send_ot_alert(dept, over.to_dict("records"))

STEP 4：給与計算用CSVを自動出力する

勤怠集計結果を給与計算システムの入力フォーマットに自動変換します。

from datetime import datetime

def export_payroll(summary_df, out):
    prl = summary_df[["社員番号","所定内","残業","深夜残業","休日出勤"]].copy()
    prl.columns = ["EMP_ID","REGULAR_H","OT_H","MIDNIGHT_H","HOLIDAY_H"]
    # 時間→分に変換（給与システム仕様）
    for c in ["REGULAR_H","OT_H","MIDNIGHT_H","HOLIDAY_H"]:
        prl[c] = (prl[c]*60).astype(int)
    prl.to_csv(out, index=False, encoding="utf-8-sig")
    print(f"給与CSV出力: {out} ({len(prl)}名)")

export_payroll(summary, f"payroll_{datetime.now():%Y%m}.csv")

STEP 5：毎月1日に全処理を自動実行する

毎月1日の朝8時に前月の勤怠集計が自動完了している状態を実現します。

from datetime import date, timedelta
import calendar

def monthly_kintai_job():
    today = date.today()
    if today.day != 1: return  # 毎月1日のみ実行
    prev = (today - timedelta(days=1)).strftime("%Y%m")
    print(f"勤怠月次集計: {prev}")
    df = pd.read_csv(f"kintai_{prev}.csv", parse_dates=["日付"])
    df = pd.concat([df, df.apply(calc, axis=1)], axis=1)
    summary = df.groupby(["社員番号","氏名","部門"]).sum().reset_index()
    wb = openpyxl.Workbook()
    # ... レポート生成・メール送信
    export_payroll(summary, f"payroll_{prev}.csv")
    print(f"完了: {today}")

monthly_kintai_job()
# schtasks /create /tn "月次勤怠" /tr "python kintai_auto.py" /sc DAILY /st 08:00 /f

制作実績サンプル

このクオリティの資料が、あなたの業務でも作れます

Aurant Technologies が実際に制作したコンサルティング資料（全82枚）のサンプルです。Claude Code × AI自動化により、従来の1/5のコスト・時間で同等品質を実現します。

タイトル・ダーク背景

3カラム比較・分析

AI活用フロー図解

Before/After比較

構造化コンテンツ

→

全10枚を
見る

御社のテーマでこのレベルの資料を作成できます

制作費・納期・自動化プランは無料相談でご確認いただけます

📊 サンプル全10枚を見る →