--- 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 | --- ## セットアップ(開発環境) ```bash 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以上 --- ## 今後の予定 - [x] Google Forms CSVインポート(希望シフトの自動取り込み) - [x] 法令アラートの強化(36協定の週次集計表示) - [x] 制約値(最低人数・リーダー要件)のUI上での変更 - [ ] シフト交換・代打依頼機能(従業員間の交代申請とリーダー承認フロー) - [ ] LINE通知連携(シフト確定・変更時の自動通知) - [ ] 複数店舗対応(店舗単位での従業員・シフト管理)