app / README.md
m1m02530125's picture
デスクトップ版(PyQt6)を廃止し、Web版に一本化
fc5e1f9
|
Raw History Blame Contribute Delete
4.8 kB
metadata
title: SDU Shift Tool
emoji: 📅
colorFrom: blue
colorTo: green
sdk: docker
app_port: 8080
pinned: false

SDU-Shift

飲食店向けのシフト表自動生成Webアプリケーションです。
従業員の希望シフトをパターンから選択するだけで、制約条件を満たした最適なシフト表を自動生成します。


主な機能

機能 内容
従業員管理 氏名・雇用形態・所属ポジション・勤務時間帯・ポジション別習熟度を登録
希望シフト入力 2週間単位でシフトパターン(14種類)またはカスタム時刻を入力
シフト自動生成 CP-SATソルバーによる最適化(正社員優先・リーダー要件・ポジション制約を考慮)
シフト編集 朝食/ディナー別タブのカレンダー形式で確認・手動修正。他時間帯専任メンバーのワンタッチ表示切替
バックアップ/インポート データをJSON形式でダウンロード・復元
ダークモード OS設定に連動した自動切替(Light / Dark)
出力 PDF・Excel(.xlsx)形式でエクスポート(従業員×日付マトリクス形式)

従業員属性

各従業員には以下の属性を設定できます。

属性 選択肢 説明
雇用形態 正社員 / アルバイト アルバイトは2週間単位で希望シフトを入力
所属ポジション どちらでも / ホール専任 / キッチン専任 専任設定はシフト自動生成の硬制約
勤務時間帯 どちらでも / 朝食専任 / ディナー専任 シフト表示タブのデフォルトフィルタに使用
ホール習熟度 リーダー / ベテラン / 一般 / 新人 ホールのリーダー要件に反映
キッチン習熟度 リーダー / ベテラン / 一般 / 新人 キッチンのリーダー要件に反映

シフトパターン

希望シフト入力では以下のパターンから選択できます。

パターン 時間
朝食短番 6:00 〜 10:00
朝食 6:30 〜 11:30
朝食ロング 5:45 〜 14:45
午前半日 6:30 〜 15:30
中番 10:00 〜 15:00
通し早番 13:00 〜 22:30
通し遅番 14:00 〜 23:00
ディナー 17:00 〜 22:30
ディナー遅番 17:30 〜 23:00
ディナーロング 16:00 〜 23:00
ランチ+ディナー 11:00 〜 16:00 / 17:00 〜 23:00
ダブル 朝食+ディナー(通し)
カスタム入力 任意の開始・終了時刻

シフト制約(人員要件)

時間帯 ポジション 人数 リーダー最低
朝食 ホール 3〜4名 1名
朝食 キッチン 3名固定 1名
ディナー ホール 2〜3名 1名
ディナー キッチン 3名固定 2名

最適化の優先順位

  1. ポジション制約 — 専任設定のある従業員は該当ポジション以外に配置しない
  2. リーダー要件 — 各スロット・ポジションのリーダー最低人数を保証
  3. 正社員優先充当 — 正社員が希望した枠には必ず充当し、余りをアルバイトで補完
  4. 人件費の最小化(総労働時間の削減)
  5. 残業・深夜勤務の特定人物への集中を回避
  6. 従業員の希望をなるべく通す(アルバイト)
  7. 各日の人員配置のバランスを均等化

技術スタック

用途 ライブラリ
Webフレームワーク Flask
最適化 Google OR-Tools(CP-SAT)
データベース SQLite / PostgreSQL
Excel出力 openpyxl
PDF出力 reportlab

セットアップ(開発環境)

git clone https://github.com/Richiesss/shift-tool.git
cd shift-tool
pip install -r requirements.txt
python web_app.py

http://localhost:5000 でアクセスできます。DATABASE_URL 未設定時はSQLite(~/.shift_tool/shift_tool.db)にフォールバックします。設定画面のバックアップ機能を使うと、データをJSON形式で保存・復元できます。

動作確認済み環境: Python 3.11以上


今後の予定

  • Google Forms CSVインポート(希望シフトの自動取り込み)
  • 法令アラートの強化(36協定の週次集計表示)
  • 制約値(最低人数・リーダー要件)のUI上での変更
  • シフト交換・代打依頼機能(従業員間の交代申請とリーダー承認フロー)
  • LINE通知連携(シフト確定・変更時の自動通知)
  • 複数店舗対応(店舗単位での従業員・シフト管理)