勤務表作成 / 基本設定

当番を公平に、均等に。個人の回数を均等に、朝夕の職員配置を両グループでバランスよく。

職員マスター・祝日・休みは自動保存されます。

STAFF MASTER

職員マスター

氏名欄に名前を入力できます。氏名はシフト表にも反映されます。
チェックあり=担当可能、チェックなし=担当不可です。

登録枠在籍未満児 · 在籍以上児 · 在籍
枠を追加: 変更はこのブラウザに自動保存
在籍職員ID氏名 早早〇8・ふ9-179半介遅遅〇 枠

勤務表作成のルール

⚠ このルール集には、2026年9月19日の統合で変更された記載が残っています(枠数47固定、職員マスタとシフト表の分離など)。変更点と理由は「実装計画書」の「2. 統合にあたって破棄・変更した前提」にまとめてあります。ここの記述だけを根拠に実装を戻さないでください。

1. 作成する勤務表の目的

2. クラスと職員

3. 当番と担当可否

4. 平日の当番人数

当番必要人数条件
早2名この2名に正職員を最低1名含める
早〇1名早の2名とは別枠
81名担当可能な職員
・/ふ未指定普通番/希望による普通番。勤務時間は同じ。
9-17変動固定当番と普通番の配置後、夕方9名への不足分のみ(最大3名、担当可否を守る)
9半1名担当可能な職員
介2名担当可能な職員
遅2名この2名に正職員を最低1名含める
遅〇1名遅の2名とは別枠

固定人数の合計は10名です。正職員の条件は「早」「遅」の各2名の中に最低1名、という解釈で記録しています。

当初の時間の説明:早番は原則7時出勤、早〇は7時30分出勤。各当番の勤務時間の詳細は後日設定します。

未設定事項の詳細は「未決定事項」を参照してください。ここではルールを記録しており、自動割り振りでラフ案を作成し、未達条件を表示します。

5. 個人の公平性と朝夕の配置

公平性の評価方法などは「未決定事項」にまとめています。

一般ルール(常に適用)

同じクラスに同じ当番は自動配置しない。対象は早・早〇・8・9-17・9半・介・遅・遅〇。通常勤務の「・」「ふ」は複数配置できる。早+早〇、遅+遅〇など記号が異なる当番は配置可能。手入力の重複は保持して警告する。クラス内で早系(早・早〇・8)/遅系(遅・遅〇・9半・介)が固まらない配置も優先する。0歳は休みがいる日も同系統2人まで許容する。早系1人+遅系3人も例外として扱うが、他クラスへ当番を分散できれば分散する。0・1歳の合同配置は応援確認として表示し、所属クラスは変更しない。合同でバランスがよければ0歳の偏りを許容する新基準は、人数差と9半の扱いを確認中。必要人数・禁止条件を優先し、その次にクラスの偏り、個人回数等を比較する。

職員ID固有ルール(チェックON時のみ追加適用)

OFFでもマスターの担当可否・在籍・雇用形態と手入力の希望は有効です。STの個別例外もOFFになります。同じIDを別の人へ引き継ぐ際は、担当可否と以下の個別条件を見直してください。切り替えは次の自動生成から反映します。

自動割り振りはラフ案です。全条件を満たせない場合は確認事項に表示します。「なるべく」「極力」は希望条件として扱い、絶対条件とは分けます。

6. 保存・HTMLでの受け渡し

日々の編集内容はブラウザに保存します。「選択月をHTML出力」で、その月だけの閲覧専用シフト表を保存します。内部には対象月の休み・祝日と、出力時点の在籍職員マスターを含めます。外部への送信は行いません。

「HTML読み込み」では、対象月と職員マスターを個別に選択して取り込めます。最新マスターの引き継ぎには、最新のHTMLからマスターだけを取り込みます。古い月を戻す場合は、マスターの取り込みを外せば現在のマスターを保持できます。

読み込むHTMLは実行せず、埋め込みデータのみを検証します。不在職員は出力に含めません。手入力と自動入力は区別して保存・復元します。

7. Excel出力コード表

Excelの文字は全セル黒・MS 明朝・通常書体(斜体なし)。変換後の「全庁一般」は薄い赤、「指」は通常・希望とも薄い黄色のセル背景。行事欄のみ小さい文字サイズを維持する。HTMLの色・斜体は変更しない。

Excel出力時だけ、勤務表内の記号を以下へ置き換える。HTML上の記号と自動割り振りの記号は変えない。

HTMLの記号Excelの表記
早・早〇保育士A
8保育士C
9-17・9半・介保育士G
遅保育士H
遅〇保育士I
・・ふ(正職員)全庁一般
・・ふ(7時間・7.5時間)保育士E
休E
指・指(通常)指
研・研(半休)出張
AM研・PM研研修
厚特
夏夏休
9-17半保育士H
8PM研保育士I
早PM研A研修
早PM休保育士A

個別コード:/→/、X→/、ひ0・ひ1・り・う・ぱ・き・PM・園会・代ホ・ぶ・AM休→E、1F・2F・8PM休→AM、PM休→?、人間ドック→人間ドック、出張→出張、ホ代→ホ代、ホ→ホ。

⚠ この実装ログには、2026年9月19日の統合で変更された記載が残っています(「枠数を変えずに運用する」「JSON単体の出力・取り込みボタンを廃止」など)。変更点と理由は「実装計画書」の「2. 統合にあたって破棄・変更した前提」にまとめてあります。ここの記述だけを根拠に実装を戻さないでください。

追加:更新履歴と品質確認ボタン(2026年11月21日)

版ごとの変更を1か所で追えるよう「更新履歴」を追加した。記録はブラウザ保存ではなくHTML内のJSON(#app-changelog)に持つ。ファイルを渡した相手にも履歴が届き、ブラウザのデータ消去でも失われないため。あわせて、AIへ貼り付ける「品質確認・採点・改善提案」ボタンを追加した。文面はPFCエディターの品質確認を土台に、月間の自動割り振りと夕方配置の自動計算に合わせて書き換えた。勤務表・配置の計算処理と保存形式は変更していない。

追加:内蔵試験(2026年11月21日)

月間の自動割り振りと夕方配置を架空データで検算する「内蔵試験」を追加した。判定は計算本体の reasons などを流用せず独立に書く(本体の誤りを本体で合格させないため)。実行中は状態を差し替え、storageSandbox で保存を遮断し、終了後に元へ戻して、ブラウザ保存と画面の状態が不変であることも判定する。判定基準を緩めて合格させないこと。Excel出力、印刷、ドラッグ操作、HTML・JSON読込は対象外。

修正:玄関の自動選出条件とフラグの残留(2026年9月19日・4回目のスクリーニング)

①禁止条件を点数で表現しない:副園長の制限を genkanScore の減点(17:00より前は-30)で表していたため、候補が他にいない日には減点されても選ばれてしまい、16:00帯でも自動配置されていた。また17:15の強制交代(deputyTakesGenkan)は雇用形態を見ておらず、7時間の副園長でも玄関へ入れた。genkanEligible に禁止条件を集約し、点数選出と強制交代の両方が必ずここを通るようにした。条件は「園長は対象外」「正職員・7.5時間のみ」「帯の最後までいること」「副園長は遅番のみ」「副園長は17:00より前は対象外」。禁止条件を減点で表現する実装へ戻さないこと。15通り(時間帯5×雇用形態3)で検証済み。②手直し後のフラグ残留:玄関から応援へ回した印(fromGenkan)が手動移動後も残り、玄関へ戻したあとでも「クラス優先で不在」と表示されていた。moveStaff で auto と同様に fromGenkan・replaced も解除し、表示側も玄関が実際に0人であることを条件に加えた(古い保存データに印が残っていても誤表示しない)。③交代した前任者の行き先:fallbackAreaAfterGenkan は用意してあったが、自動配置は帯ごとに作り直すため前帯の玄関担当が「交代元」として扱われず、一度も呼ばれていなかった。buildBand で前帯の玄関担当IDを取り出し、副園長へ交代する場合に限って前任者を0・1・2歳室へ合流させる(要件書1-7)。勤務中で手動確定でない場合だけ適用する。全職員の自動配置を前帯から引き継ぐ変更へ広げないこと。現行の「帯ごとに独立生成」を維持し、玄関交代だけを例外として扱う。

「副園長への交代で外れた前任者の行き先(0・1・2歳室)」と「クラス不足で玄関を空けたときの応援先(自クラス優先、なければ不足最大)」は別ルールとして維持する。前者は要件書1-7、後者は2026年9月19日の運用決定に基づくもので、根拠が異なるため一方を他方へ流用しない。

決定:玄関の優先度を下げ、副園長を自動選出する(2026年9月19日)

①副園長の玄関:長く保留していた方針を「自動選出して、必要なら人が手直しする」に確定した。これまで `autoFillGenkan` と玄関おすすめが `isLeadership` で管理職を一括除外していたため、`genkanScore` に書かれた副園長の分岐は到達しない死にコードだった。除外を園長だけに変更し、あわせて17:15・17:30の帯では遅番の副園長が玄関を代わる規則を明示的に実装した。点数だけに任せると介の正職員(72点)が副園長(33点)を上回って交代が起きないため、点数比較より優先する規則として書いている。交代で外れた前任者は自分のクラスが不足していればそこへ、なければ不足のいちばん大きい部屋へ回す。手で確定した玄関担当は自動では動かさない。②玄関はいちばん最後に諦める枠:今後、玄関の重要度は下がっていく見込みという運用判断により、16:30以降の帯でクラスの必要人数を埋めきれない場合は、玄関を空にして担当者を足りない部屋へ回す処理を追加した(releaseGenkanForShortage)。必ず応援の自動配置のあとに実行する。16:00〜16:30は通常保育の時間帯なので対象外。人が手で玄関へ置いた場合は覆さない。画面では、ただの人数不足と区別して玄関に「クラス優先で不在」と表示し、回された職員のカードに「玄関から回した」バッジを出す。この2つは運用上の決定であり、実装の都合で元へ戻さないこと。

修正:生成経路の不統一と警告の残留(2026年9月19日・3回目のスクリーニング)

①時間帯ボタンからの迂回:「古い帯があれば作り直しを求める」判定が一括生成にしか無く、時間帯ボタンと描画時の自動生成はそれを通らずに追加生成できていた。判定を canBuildBand に切り出し、生成のすべての入口で必ず通す。古い帯があるときは新規生成を止め、既存帯の閲覧は許したうえで作り直しへ誘導する。②休みになった人の残業承認:承認済みの残業配置を次の帯へ引き継ぐ処理が、その人の勤務自体が消えた場合(休みへ変更など)も引き継いでいた。残業は勤務の延長なので、勤務が無くなったら承認も引き継がない。③日をまたいだ警告の残留:印刷警告の更新がサマリー完成時にしか走らず、未完成の日へ移ると前の日の警告が残っていた。早期終了より前に必ず消す。④ステッパーの状態遅れ:時間帯ボタンを描いたあとに初期帯を生成していたため、初回表示では次の帯のボタンが押せないままだった。生成後にステッパーを描き直す。

修正:陳腐化検出の境界条件(2026年9月19日・2回目のスクリーニング)

前回の修正そのものに残っていた4件を直した。①指紋の単位:指紋を日単位で持ちながら帯を1つ生成するたびに更新していたため、古い帯を残したまま「残りを一括生成」すると日全体が最新扱いになり、古い配置と新しい配置が混ざったまま出力できた。指紋は帯ごとに持つよう変更し、日の古さは「どれか1帯でも古ければ古い」と定義した。さらに、古い帯がある状態で続きだけ作ることを禁止し、確認のうえ日ごと作り直す導線にした。帯を破棄するときは指紋も一緒に破棄する。②指紋のない保存データ:この仕組みを入れる前に保存された配置には指紋がなく、「古くない」と判定されて素通りしていた。指紋のない帯は「確認できない」として古い扱いにする。読み込み時に現在の指紋を付けて正常化してはならない(どの勤務表から作られたか分からないため)。通知も理由を出し分ける。③初回生成時の保存失敗:通知を描いたあとに配置を生成していたため、その生成に伴う保存で初めて失敗した場合、未保存フラグだけが立って警告が出なかった。生成した直後に通知を描き直す。④印刷物の警告:古い配置でも印刷はできるが、画面の警告は操作欄(no-print)の中にあり紙に残らなかった。印刷される位置に専用の警告欄を設け、印刷CSSでも表示し続ける。この警告を no-print の中へ戻さないこと。

修正:統合後の機能間整合スクリーニング指摘(2026年9月19日)

統合で追加した機能どうしの接続を点検し、7件を修正した。①配置の陳腐化検出:配置を作ったあとに勤務表・休み・在籍・雇用形態・枠が変わっても、古い配置がそのまま表示・出力されていた。呼び出し箇所を個別に潰すと漏れるため、その日の前提(職員ID・雇用形態・クラス・当番・解決後の勤務時刻)を1本の文字列にした指紋を生成時に保存し、描画時に突き合わせる方式にした。古くなっても自動では消さず、警告を出して人に作り直させる(手で動かした配置を確認なく捨てないため)。サマリーは古い状態ではExcel出力を禁止する。②JSON取込の無警告切捨て:既存枠との合算が上限200を超えると末尾を黙って捨てていた。超過件数を示して取込全体を中止するよう変更。③未来帯の無確認破棄:過去帯でカードを動かすだけで、以降の手動調整済み配置が確認なく消えていた。移動できるかを先に判定し、確認をすべて済ませてから書き換える順序に変更。キャンセルすれば何も変わらない。破棄の通知は再描画で消えない専用欄へ移した。④自動玄関配置の上書き:手動配置した職員を玄関の自動仮配置が動かしていた。候補から手動配置済みを除外し、全員が手動なら玄関を空にして不足表示する。⑤保存失敗の握り潰し:savePlacementの戻り値を誰も見ておらず、失敗表示が直後の再描画で消えていた。未保存フラグと常設警告を設け、保存成功まで出し続ける。一括生成の「作成しました」も保存成功時だけ出す。⑥退勤をまたぐ手動配置:黙って不在へ落としていたのを、またぐ瞬間に残業継続を確認するようにした。⑦記号の正準化位置:正規化が夕方配置側だけで、自由入力と復元は元の文字列を保存していたため、同じ「早○」が勤務表では標準当番外、夕方では勤務者と扱われていた。既知のラベルに一致したときだけ寄せる canonicalDutyLabel を入力境界(自由入力・validateEvents)へ追加。「指(通常)」の全角括弧を半角化すると休み判定が壊れるため、normalizeDutyMarkを全文字列へそのまま適用してはならない。正規化関数は保存データの読み込みでも使うので、ファイル先頭側に置いてある(後方定義に戻すと初期化時にTDZで落ちる)。

注意:インラインスクリプトに生の制御文字を書かない(2026年9月19日)

配置サマリーのExcel出力を追加した際、正規表現 /[\u0000-\u0008\u000b\u000c\u000e-\u001f]/g のエスケープが生の制御文字としてファイルへ書き込まれ、スクリプト全体が起動しなくなった。HTMLパーサは仕様上U+0000をU+FFFD(�)へ置換するため、文字クラスが [�-\u0008…] となり「Range out of order」で構文エラーになる。fetchで読むとこの置換が起きないため、ファイル単体では正常に見えるのが厄介だった。このファイルを編集するときは、制御文字を必ず \uXXXX のエスケープ表記で書くこと。症状は「スクリプトが丸ごと動かず、staffなど基本的な変数まで未定義になる」。

追記:④配置サマリーとExcel出力(2026年9月19日)

1日分の配置を1枚にまとめる独立タブを追加。シフト帯別の在園者、時間帯別の配置場所、職員別の配置の3段構成。最後の時間帯まで配置が出来ていない日は空状態メッセージを出す。Excelは既存のexcelZipを再利用し、職員別・配置場所別の2シートをMS明朝の黒文字・罫線つきで出力する。印刷は@media printでA3横とし、画面の色分けをそのまま活かす。新しいライブラリは追加していない。自動仮配置・残業配置は画面とExcelの両方に注記する。

統合:職員マスター/勤務表作成と夕方配置ツールを1つのHTMLへ(2026年9月19日)

別々の単体HTMLだった「staff-master(職員マスター・勤務表作成)」と「夕方配置ツール」を統合した。夕方配置ツールがExcelから読もうとしていた月間勤務表は、staff-master側が自分で生成しているものだったため、Excel取込・SheetJS(約880KB)・氏名の曖昧一致UIを廃止できた。土台はstaff-masterをそのまま複製し、夕方配置の機能を載せる方針とする(staff-masterを最新ルールとする決定による)。職員マスターは枠可変へ変更し、職員マスタJSONの出力・取込を追加した。当番記号はstaff-masterの10種類に統一し、丸記号はU+3007(〇)へ寄せる。詳細と、この変更で無効になった旧方針の一覧は「実装計画書」を参照。元の2ファイルは変更していない。

更新:出力HTMLを1ファイルに統合(2026年9月18日)

シフト表と当番回数表の別々のHTML出力を廃止し、「選択月をHTML出力」1回で両方を含む閲覧HTMLを生成する。出力先のボタンでシフト表/当番回数表を切り替える。スマホでは日付・項目の見出しを上部に、職員ID・氏名を左側に固定し、残りを縦横スクロールする。固定は閲覧HTMLだけに適用し、シフト作成画面は変更しない。印刷時は選択中の表だけを出力する。

追記:回数表HTML出力とスマホ表示(2026年9月17日)

選択月の出勤予定・休み・早系合計・遅系合計・各当番回数を、職員別の閲覧・印刷用HTMLとして出力する。自由入力した当番も列へ追加し、順序・クラス・雇用形態の並べ替えとクラスカラーを維持。通常のシフトHTMLと回数表HTMLは、スマホで横スクロールしやすい領域、折り返す操作欄、タップしやすいラベル、狭い画面用の余白と文字サイズを持つ。印刷書式は従来どおり横向きを維持する。

修正:総合スクリーニング指摘(2026年9月17日)

出力HTMLの並べ替えを本体と同じ管理職先頭・数値を考慮したID順へ修正。普通番への交代では、交代元職員を一時的に当番から外した状態で重複条件を評価し、有効な交代を誤って除外しない。Excelの行事名は最大60文字が行高上限内へ収まるよう小さい共通フォントへ調整。現行ルールの職員47枠を反映し、古い未実装一覧を当時の記録と明示。保存形式と旧HTML読込形式は変更しない。

更新:Excelの書体・背景色

見本に合わせExcel出力は黒文字・MS 明朝・通常書体へ統一。希望/自動による文字色と斜体の区別をExcelでは廃止。「全庁一般」は薄い赤、「指」は薄い黄色の背景で区別する。変換後のコードに基づき色を決め、入力画面・HTML出力の書式は維持する。

修正:出力HTMLの日付・曜日の縦位置

休日ラベルの有無で日付・曜日が上下しないよう、全日付列に同じ高さの休日表示欄を確保する。通常日は空欄にし、印刷時も位置を揃える。

追記:出力行事名の縦書き

HTML・Excel出力では日付の上に行事名を最大3件、行事ごとに別の縦書き列で表示する。日付列は行事の有無にかかわらず均等幅。HTMLは縦書き要素、Excelは縦書きセル内の改行を使用。入力画面の形式は維持する。Excelの固定見出しは行事・日付・曜日の3段へ変更する。

追記:Excel用当番コード変換(2026年9月17日)

Excel出力だけでHTML上の当番記号を業務コードへ変換する。早・早〇は保育士A、8は保育士C、9-17・9半・介は保育士G、遅は保育士H、遅〇は保育士I。普通番(・・ふ)は正職員なら全庁一般、7時間・7.5時間なら保育士E、その他はE。休み・研修・出張等の個別変換表もExcel側へ追加し、HTML画面・保存データ・自動割り振りの記号は変えない。利用者の指定により正式名称の「保育士」を省略しない。

追記:Excel出力(2026年9月17日)

選択月をExcel(.xlsx)で出力するボタンを追加。参考画像に合わせ、1行目に日付、2行目に番号・氏名・曜日を配置し、在籍職員をシフト画面の順で1から連番にする。氏名未入力は空欄。実在する月末まで出力し、うるう年に対応。当番・休みと希望の色/斜体を保持し、罫線付き白地の表にする。ブラウザ内でファイルを生成し外部へ送信しない。Excelからの復元機能は設けず、復元には既存のHTMLを使用する。

追記:クラス内の同一当番を禁止(2026年9月16日)

同じ年齢クラスへ早・早〇・8・9-17・9半・介・遅・遅〇の同一記号を複数、自動配置しない一般ルールを追加。「・」「ふ」は残りの通常勤務を配置するため複数可。早と早〇、遅と遅〇は別当番として扱う。0歳の同系統2人許容も、別当番であれば維持する。手入力同士の重複は勝手に変更せず確認事項に表示し、人数を満たせない場合は重複で埋めず不足を表示する。

訂正:0歳の重複2人許容(2026年9月16日)

0歳の同系統2人までの許容を当日4人出勤に限定しない。休みがあり当日2〜3人でも許容する。2人全員が同系統の場合も全員集中の強い減点を付けず、分散優先の軽い評価だけ残す。0・1歳合同のバランスによる0歳の偏り許容は、数値基準と合同判定での9半の扱いを確認してから変更する。

訂正:サブ職員の対象確定(2026年9月16日)

前回の「同クラスの7.5時間・7時間職員全員」という解釈を訂正。対象は0-2・1-2・2-2のみ。同クラス正職員の休み日に遅・9半を避ける希望評価をID固有ルールへ移し、個別ルールOFF時は適用しない。クラス別の朝夕バランスは引き続き一般ルールとして適用する。

追記:クラス別の朝夕配置(2026年9月16日)

各クラスの早系/遅系集中を評価し、必要人数等の未達が同じならクラス配置を個人の回数均等より先に比較する。自動当番同士のクラスをまたぐ交換で偏りを減らす。手入力、担当可否、月週上限、連続禁止、正職員枠は維持。0歳の特例は当日出勤4人以上で判定し、3人以下では適用しない。0・1歳が合同なら対応できる集中は補助案として評価するが、クラス単独で対応できる配置を優先し応援確認を表示。サブは同クラスの7.5時間・7時間職員全員と解釈し、正職員の休み日の遅・9半を避ける。研・AM研・PM研は保育配置人数から除外する暫定評価。勤務時刻や実際の応援配置は未確定であり、時間帯の実人数保証ではない。9-17や普通番を今回の遅系へ推測で追加しない。

追記:早夕当番のクラス集中回避(2026年9月17日)

同じクラスに早系(早・8)または遅系(遅・介・9半)が固まらないよう、自動割り振りの候補評価と自動交換で強く分散する。0歳は従来どおり同系統2人まで許容し、他クラスへ移せる場合を優先する。完全回避できない場合は未達事項として表示する。早〇・遅〇はこの集中評価では別枠とし、同一記号のクラス内重複禁止は維持する。

実装ログ・維持する仕様

記録日:2026年9月13日。会話で決めて実装した内容を、変更の理由とともに整理した記録です。個別の実装日時は記録していないため、以下は変更順の履歴です。

1. 職員マスターの土台

2. 表示と並べ替え

3. カレンダーと休み

4. 保存とファイル受け渡し

5. ルールと説明ウィンドウ

6. 当時の未実装・提案記録(後続履歴で実装済みの場合あり)

この節は開発初期の記録です。現在仕様は「ルール表示」と、この節より後の追記を優先してください。

追記:休日ラベルの整理(2026年9月13日)

各日付のチェック横に繰り返していた「休日」を削除。チェックを専用の見出し段に揃え、その左端だけに小さく「休」「日」を縦表示する。繰り返しの文字で表を混雑させないため。各チェックの読み上げラベル、休日保存、日曜の初期ON、赤の優先表示は維持する。

追記:31日を収める横幅調整(2026年9月13日)

休日の縦ラベルも不要との依頼で削除(チェックの読み上げラベルは維持)。カレンダーの1500px最低幅を840pxへ縮小し、画面幅いっぱいに日付列を均等配分する。職員情報はID48px・氏名82px・クラス44px・雇用形態58pxに集約。並べ替えラジオは列名の下段に置き、クラスは年齢だけ表示、グループ名はツールチップで確認できる。氏名は省略表示時もツールチップで全文を保持。狭い画面では操作性のため横スクロールを残す。

追記:固定31列と職員情報の書式統一(2026年9月13日)

月の日数によって日付列の幅を変えず、常に31列を確保する。存在しない日は無記入・操作不可の空欄とし、閲覧HTMLも同様とする。職員情報の表示書式をマスターとシフト表で統一することをアプリのコンセプトとする。氏名・IDは同じ文字サイズと左揃え、クラスは共通部品の年齢バッジ(グループはツールチップ)、雇用形態は同じ文字サイズ、並べ替えラジオは両画面で見出しの下段とする。マスターの入力・選択機能は維持する。右端への出勤日数・各当番回数の集計は追加候補として記録し、まだ実装しない。

追記:最優先テーマと列幅の共通化(2026年9月13日)

このアプリの最大のテーマは「当番を公平に、均等に」。個人と未満児/以上児グループ両方の公平性を中心に設計し、具体的な評価方法は未決定事項として詰める。前回の統一は列幅まで徹底できていなかったため修正。ID52px・氏名96px・クラス104px・雇用形態90pxを単一の設定から両表のcolgroupへ適用する。クラスは両画面で共通部品の「年齢 · 未満児/以上児」バッジとし、省略表示に分岐しない。セル余白と高さも統一する。マスターの編集用入力・選択操作は維持する。

追記:月別回数表示(2026年9月13日)

「当番回数表示」で、職員情報を同じ幅・書式で残し、日付部分を出勤予定・手入力の休み・各当番回数へ置き換える。「当番表に戻る」で戻す。年月・独立ソート・分類色は両表示で共通。現時点の出勤予定は休日OFFかつ休み未入力の日数(土曜含む)という暫定計算。個人の休みは手入力数のみで、休日とは別管理。当番割り振り未実装なので当番回数は0。実際の勤務実績ではない。以前の「回数集計未実装」はこの基礎表示のみ更新し、割り振りデータからの集計は今後対応。スマホは横スクロールで操作可能だが専用レイアウトではない。

追記:行事日の自由入力(2026年9月14日)

日付上に休日とは独立した行事チェックを追加。ONの日は各職員のマスをクリックし任意の当番名を入力できる。「フリー」という当番は作らない。入力は青文字、休で休み、空欄で解除。行事OFFで既存入力を削除しない。月・職員ID単位のブラウザ保存、手動保存、閲覧HTML出力・取り込みに対応。旧HTMLに行事データがなければ空として取り込む。自由入力名も月別回数に集計し、休日でも当番入力があれば出勤予定に数える。自動生成・固定保護は引き続き未実装。

追記:行事名と配置ルール(2026年9月14日)

行事名は日付上の+/件数ボタンから同日3つまで入力する。従来の自由当番入力のON/OFFは編集画面内に保持し、行事名はブラウザ・閲覧HTMLの保存と復元に対応。旧ファイルは行事名なしとして移行。「4時間」を「短時間」に名称変更し旧保存値を移行。「・」「ふ」を分離し旧「・ふ」の可否を両方へ移行。0-1は遅・介・のみの可否を固定する。グループ間の単純な当番回数均等から朝夕の配置バランスへ目的を修正。土曜人数・運動会前日・園長不在・休日前・遅翌日・園内研修・4-2の9半制約を記録。具体的範囲や副園長IDなどの未確定点は推測で固定しない。自動計算はまだ未実装。

追加確認の確定(2026年9月14日)

副園長は「副園長」の固定識別子で管理職の別枠に追加。早い当番は早・8。4-2の9半は月2回が上限で、最低回数は求めない。マスターの4-2の9半を初回移行時に可能へ設定。将来の自動生成に用いる条件データも記録するが、現時点で回数上限や行事配置の自動制御は行わない。

追記:個別回数と行事ポップアップ(2026年9月14日)

1-3の9-17は週1〜3回、9半は月2回。2-3は早より早〇を優先し、早〇は月4回、9半は月2回。月回数が目標か上限か、週の境界は未確定として記録する(4-2の月2回上限とは区別)。行事件数にマウスを合わせるかキーボードフォーカスすると日付と最大3件の行事名をすぐ表示する。画面右端で切れない位置へ調整し、スクロール・再描画・Escで閉じる。クリック/スマホのタップでは従来どおり編集画面を開く。

追記:ST15枠と画面初期表示(2026年9月14日)

シフト表を先頭タブ・初期画面に変更。ST-1〜15を所属フリー・短時間固定で追加し初期は不在。通常職員の雇用形態では短時間を新規選択できなくするが、旧設定は勝手に正職員等へ変えず「短時間(旧設定)」として保持。ST-2・3・8・11の9-17、ST-8の早〇を初期可否へ設定。日別クラス配置は未実装。1-3・2-3の月回数は上限として確定し、3-3遅〇の曜日と上限、ST-8の曜日と週上限を記録。16:30以降9名の人数確保は対象当番とST算入条件を確認してから実装する。

追記:園長と副園長の担当条件(2026年9月14日)

園長を番号なしの管理職別枠に追加(合計47枠)。園長の可否は早・8・に固定。副園長のマスター可否は全当番とし、園長不在日のみ早・8へ制限する日別ルールを記録。旧ファイルに園長がなければ取り込み時は不在となる。休み・自由入力・HTML保存復元の識別子に園長を追加。16:30以降9名は園全体で・、ふ、9-17、9半、介、遅、遅〇の合計。不足日のみSTへ9-17を割り当てる条件も確定記録。自動配置・日別制限の計算適用はまだ未実装。

追記:管理職の固定順(2026年9月14日)

園長を最上段、副園長を2番目に固定し、その他の職員だけを選択したクラス順・雇用形態順で並べ替える。マスター、シフト表、回数表示、閲覧HTMLで共通の比較処理を使用する。在籍のみ表示では不在の管理職は従来どおり非表示。表示順変更で職員ID・保存キー・保存データは変更しない。

追記:シフト表の初期ソート(2026年9月14日)

シフト表・回数表示の初期順を雇用形態順へ変更。マスターは独立したクラス順を維持。園長・副園長の先頭固定は両方で維持する。

追記:選択当番のクリック入力(2026年9月14日)

在籍人数の右に当番名とその下の単一選択ラジオを配置。選択当番をマスへクリック入力し、同じ当番を再クリックで解除。初期選択は従来の操作と合わせ休。「消去」と行事日用の「自由入力」も設け、既存自由入力機能を維持。入力は青、ブラウザ保存・HTML受け渡し・当番回数集計へ反映する。手入力の担当可否・人数・曜日上限の警告は未実装。

追記:自動割り振りラフ案(2026年9月14日)

9-17・9半を7時間/短時間のみへ制限し、手入力の当番・休みを青い斜体で表示。自動割り振りは手入力を固定し、自動分のみ再作成する。複数の候補順で必要枠、正職員枠、月上限、曜日制限、週上限を扱い、残りの9-17/普通番と不足時のSTで夕方9名を確保する。個人回数と朝夕のグループ配置の偏りを減らす評価を行うが、最適解の保証はない。未達人数、手入力違反、行事配置の未達、未割り振りを表示する。週は月曜始まりを暫定採用し、園長不在は休み/在籍で判定する。行事名の運動会・園内研修を検出する。土曜正職員条件・夕方9名は暫定適用。1-3週最低1回、休み前の早、遅翌日の早回避は希望評価であり保証しない。自動分は黒、ブラウザ・HTML・集計で保持。旧HTMLは自動データなしとして移行する。

追記:計算検証(2026年9月15日)

回数集計をキャッシュして計算時間を短縮。8候補を比較し、候補間で画面を更新する。計算中は入力を止め、固定条件が途中で変わらないようにする。固定入力保持・雇用制限・月上限・曜日制限・旧形式・保存復元・不足検出の回帰確認を追加。週最低回数や遅翌日の早、休み前日の希望未達も報告し、満たしていない希望を隠さない。

追記:研・指・厚・夏と見出し固定(2026年9月15日)

シフトの手入力選択肢に研・指・厚・夏を追加。マスターの通常当番可否や自動選択候補には追加せず、希望入力として青斜体・固定・保存・HTML・各記号の回数集計に対応する。出勤/休みや夕方人数への算入区分は未定義なので今後確認する。表を画面高62%のスクロール領域にし、行事・日付・曜日・休日を含むthead全体を固定する。回数表示でも見出しを固定し、分類色・休日の赤優先は維持する。自由入力は行事日に一覧外の当番名を入力する既存機能として残す。

追記:勤務・休み区分と自由入力・表示順(2026年9月15日)

指・厚・夏は休み、研・AM研・PM研は勤務と確定。休みは自動割り振りの対象外とし休み日数に含め、研修記号は勤務固定として扱うが時間未確定のため夕方9名には算入しない。自由入力は全日利用可能へ変更し、行事編集内の制限チェックを削除。氏名の右に共通幅38pxの順序列を追加し、クリック順に1から採番、番号再クリックで解除。番号は職員データとして保存・HTML受け渡しし、両画面の指定順ラジオで独立に並べ替える。未指定は番号付きの後。園長・副園長の先頭固定は維持する。

追記:帽子のクラスカラーへ統一(2026年9月15日)

0歳オレンジ・1歳赤・2歳緑・3歳青・4歳黄・5歳桃の淡い配色へ変更。雇用形態順でも学年を見分けるため、雇用形態別の背景色は廃止し、クラス順・雇用形態順・指定順のすべてで学年色を固定する。マスター・シフト・回数集計・閲覧HTMLに共通色を使い、クラスバッジも同じ色に揃える。STと管理職は学年色を付けず中立色。休日ONと日曜の赤優先は維持する。

追記:指の通常・希望区分(2026年9月15日)

指は赤字に変更。選択欄を指(通常)と指(希望)に分け、マスでは双方「指」と表示するが通常は正体、希望は斜体。旧保存値「指」は従来の手入力希望として保持し、通常は別値で保存。両方とも休みとして自動配置から除外し、回数集計は通常/希望を別列にする。HTML出力・取り込みも色と区別を維持する。通常の指も手入力固定として自動計算では上書きしない。

追記:休みの赤枠と文字表現(2026年9月15日)

指(通常/希望)・休・夏・厚はすべて淡い赤背景+赤枠+赤文字へ統一。希望休みは赤斜体、通常の指は赤通常文字。希望当番は青斜体、自動当番は黒通常文字。休日列でも休みの枠と赤字を維持し、取消・上書き時は表示を更新する。閲覧HTMLにも同じ表現を反映。通常の指も入力済み固定として保存し、希望との区別は既存値を保持する。

追記:休み背景の調整・赤枠廃止(2026年9月15日)

休みマスの赤枠を廃止。休日・日曜日と同じ淡い赤(#f3ccc8)を背景に使い、クラスカラーより濃くして識別する。希望休みの赤斜体と通常指定休の赤通常文字は維持。閲覧HTMLも同じ背景色とし、枠を復活させない。

追記:当番ラジオの均等配置(2026年9月15日)

当番選択を均等幅のグリッドへ変更。重複していた研・指・厚・夏などは一度だけ表示し、ラベルの高さとラジオ位置を揃える。広い画面は16列、狭い画面は8列・4列へ縮小し、月コントロール内で折り返す。選択状態・入力動作・自由入力・手入力の保存は維持する。

追記:当番選択を1行・休み記号を赤字(2026年9月15日)

選択ラジオは1行固定の横並びへ戻し、狭い幅では選択欄のみ横スクロールする。休・指(通常)・指(希望)・厚・夏は選択ラベルを赤字で表示し、指(希望)は斜体も維持。ラジオの位置・当番入力・保存は変更しない。

追記:9-17の過剰配置修正(2026年9月15日)

残った担当可能者全員を9-17にする処理を廃止。固定当番と平日の普通番を先に配置し、夕方9名に不足する分のみ9-17を追加する。1日最大3名、充足時は0名。土曜の普通番1名は維持。手入力は保持し、上限超過・人数不足を表示する。既存の自動結果は再計算で更新する。

追記:管理職は不足時の補助(2026年9月15日)

園長・副園長は当番の常用要員にしない。同じ当番の候補は一般職員を必ず優先し、候補がいない場合のみ管理職を使う。残りの普通番への自動配置と未割り振り警告から管理職を除外。園長の早・8・普通番、副園長の園長不在時は早・8という既存可否と手入力固定を維持する。管理職を使わない候補を評価で優先するが、全組み合わせの最適性は保証しない。

追記:早系・遅系の負担を合算(2026年9月15日)

早と早〇、遅と遅〇をそれぞれ合算し、候補選択と最終案の評価に使う。別記号に分かれていても負担が集中しないため。前日・翌日の同系統当番を避ける希望評価を追加し、残った連続配置は確認事項に表示。手入力や必要人数・担当可否は維持し、連続禁止や一律回数上限にはしない。月別集計には早系合計・遅系合計を追加。8はこの合算には含めず、行事の早い当番等の既存定義も維持する。

追記:連続当番を禁止条件へ(2026年9月15日)

遅・遅〇の翌日の早・早〇・8を禁止。同じ週(月曜〜日曜)の隣接する暦日に同一当番を配置しない。早と早〇、遅と遅〇、普通番の・とふはそれぞれ同じ当番として判定する。週内の離れた日の再担当は禁止しない。前日だけでなく翌日の固定入力、保存済み隣月も確認。希望入力は保持して違反を表示し、自動配置で禁止を破って人数を埋めない。不足時は未達表示する。過去の「なるべく回避」よりこの禁止条件を優先。

変更時の確認項目

機能を追加・変更する際はこのログも更新する。氏名・在籍・担当可否・月別休みの保持、旧ファイルの移行、独立ソート、色の優先順位、閲覧HTMLの復元を確認する。新しい依頼で仕様を変える場合は、以前の仕様と変更理由を残す。

追記:総合スクリーニング後の整合性修正(2026年9月16日)

複数のブラウザ保存は一括して試し、途中失敗時は保存前へ戻す。自動割り振り候補は必要人数・禁止違反などの未達を公平性より先に比較する。平日・土曜必要人数、正職員条件、夕方人数、9-17上限は単一の一般ルールから参照する。普通番の連続禁止で空白が生じにくいよう、普通番の職員を翌日の固定枠へ優先し、自動配置同士の入れ替えを追加。残る空白には配置できない理由を表示する。条件変更後は古い結果を未再計算と表示。HTML復元・旧形式・保存失敗・必要人数優先・普通番交代の回帰試験を追加。連続禁止、手入力固定、管理職の補助扱いは維持する。

未決定事項・これから決めること

勤務時間と必要人数

公平性と希望

追加ルールの確認事項

決定済み・実装待ち

「・」は普通番、「ふ」は希望による普通番で、勤務時間は同じです。自動割り振りは実装済みですが、勤務時間・日別クラス配置は未検証です。

枠外をクリックするか、Escキーでも閉じられます。

実装計画書(統合版)

2026年9月19日、「職員マスター/勤務表作成アプリ(staff-master)」と「夕方配置ツール」を1つのHTMLへ統合するにあたり、両アプリの実装計画・ルール・実装ログを1か所へまとめたもの。記載は削除せず、変更されたものは「何に・なぜ変わったか」を併記する方針で維持する。

0. このドキュメントの位置づけとAI作業ルール

このファイルは、CodexとClaude Codeなど複数のAIが、クオータや作業分担の都合で交互に編集する可能性がある。前回会話の記憶ではなく、この実装計画書・「勤務表作成のルール」・「実装ログ」・HTML本体を最新の正本として扱うこと。

旧「夕方配置ツール」のAI作業ルールにあった「同じフォルダの `夕方配置ツールテスト.html` は別思想の旧試作」という注記は、統合により対象外となった。現在の本体はこの統合版HTML1本である。

1. 目的

1つの単体HTMLで、保育園の月間勤務表づくりと夕方(16:00〜閉園)の職員配置を続けて行う。

この2つが1つのアプリに入ることの意味:夕方配置の入力である月間勤務表を、同じアプリが作っている。したがって勤務表をファイル経由で受け渡す必要がなく、職員マスターも1か所で足りる。

2. 統合にあたって破棄・変更した前提(2026年9月19日)

この章がもっとも重要。以下は、両アプリの旧記載に明記されていたが、統合の決定によって変更されたもの。旧記載は他の章に残っているため、ここを読まずに旧記載へ戻す変更を行わないこと。

旧方針(そのまま残っている記載)出典現在の方針変更した理由
Excelの現場勤務表を丸ごと取り込み、職員マスタに載っている人だけを抽出する。これを本線とする。 夕方配置ツール「2. 現在の設計」 Excel取込は廃止。勤務表はこのアプリ自身が作る。 統合により、夕方配置が読もうとしていた月間勤務表を同じアプリが生成するようになった。自分で作ったデータをExcel経由で読み直す必要がない。これに伴い、シフト表整形・取込タブ、月間/1日リスト/マトリクスの形式判定、氏名の曖昧一致と人間による突き合わせUI、SheetJS(約880KB)のインラインが不要になった。
職員マスタとシフト表取込を分ける。職員マスタは無加工シフト表を読むためのフィルター兼補完情報であり、統合シフト表へ置き換えない。 夕方配置ツール「2. 現在の設計」冒頭の「重要」 分離の理由が消滅。職員マスターは1つで、勤務表・夕方配置の両方がこれを参照する。 分けていた理由は「現場のExcel勤務表を加工・コピペさせないため」だった。Excel取込をやめた以上、フィルターとしての役目がなくなった。
localStorageなどの自動保存は使わない。編集内容はブラウザのメモリ上だけに置き、リロードで初期値に戻る。保存したい場合だけExcel出力する。 夕方配置ツール「データ保持」「保存の考え方」「AI作業ルール」 ブラウザ保存(localStorage)が正本。職員マスター・祝日・休み・当番・行事は自動保存する。 staff-master側の方式を採用した(「基本的にstaff-masterが最新のルール」という決定による)。localStorageはブラウザ内に閉じており外部送信ではないため、個人情報保護の理由にはあたらない。毎回ゼロから入力させる運用コストの方が大きい。ただし「外部通信・CDNを使わない」制約は維持する。
各クラス5枠・計30枠に園長・副園長各1枠とST15枠を加えた計47枠。在籍チェックで在籍・不在を管理し、枠数を変えずに運用する。人数変更のたびに枠を作り直さないため。 staff-master「2. クラスと職員」/実装ログ「1. 職員マスターの土台」 枠可変。「クラス-連番」のID体系は維持したまま、クラスごとに枠を追加・削除できる。上限は1クラス99枠・全体200枠。 実際の職員数が固定47枠に収まらない・余るため。IDの形(0-1〜5-5、園長、副園長、ST-n)は変えていないので、IDからクラスを読む既存ロジックはそのまま使える。在籍チェックは廃止していない:一時的に外すだけなら在籍チェック、名簿から消すなら枠の削除、と使い分ける。枠を削除すると、その職員の休み・当番データも同時に削除する(残すと、同じIDを再追加したときに別人の予定が復活するため)。
JSON単体の出力・取り込みボタンを廃止し、閲覧専用HTMLの出力・取り込みへ変更。利用者にJSONの操作を求めないため。 staff-master 実装ログ「4. 保存とファイル受け渡し」 職員マスタのJSON出力・取込を復活。月次HTMLの出力・取込は従来どおり併存する。 ブラウザ保存を正本にしたため、PCの載せ替え・控えの手段が必要になった。JSON出力には不在の枠も含める(控えとして名簿全体を持ち出すため)。月次HTMLへ埋め込む分は従来どおり在籍者のみで、こちらの仕様は変えていない。
当番記号の表記ゆれをシフトマスタのエイリアス表で吸収する(早/早○、8/8、ふ/・/プ/AM研 など約40行)。 夕方配置ツール「シフトマスタ」DEFAULT_SHIFT_RULES 当番記号はstaff-masterの10種類に統一。エイリアス表は廃止し、代わりに入力境界での正規化関数を1つだけ持つ。 表記ゆれはExcel取込のためのものだった。取込をやめた結果、外部文字列が入る箇所は「自由入力(prompt)」と「JSON取込」の2つだけになり、そこで正規化して正準形だけを保存すれば足りる。注意:staff-masterは「早〇」の丸に U+3007(漢数字のゼロ)を、夕方配置ツールは「早○」の丸に U+25CB(白丸)を使っていた。見た目がほぼ同じで照合が黙って外れるため、U+3007 に統一する。正規化は「全角英数→半角(8→8)」「丸の統一(○ ◯ → 〇)」を行う。
雇用形態は 正規/非常勤7.5h/非常勤7h/短時間。 夕方配置ツール KINDS 正職員/7.5時間/7時間/短時間(staff-masterの表記)。 staff-masterを最新ルールとする決定による。概念は同一で、ラベルのみ統一した。
クラスは 年長/年中/年少/2歳/1歳/0歳 の文字列で持つ。 夕方配置ツール CLASSES age(0〜5の数値)が正本。表示名は必要な場所で引く。3歳=年少、4歳=年中、5歳=年長。 staff-masterが職員IDの先頭文字からageを決めており、IDと不可分のため。配置エリア名として「年少・年中・年長」を出す場合は、ageから変換して表示する。
不在記号:指定休・指・X・X・/・/・研・PM研・8PM研・早PM研・夏休・出張・年・厚 夕方配置ツール DEFAULT_ABSENT_MARKS 「5. 当番記号と夕方の在否」の表に統一。X・/は廃止。出張・年(年休)は不在として扱う。 X・/は旧Excel勤務表由来の記号で、このアプリが勤務表を作る以上は発生しない(自由入力で打てば不在側に倒れる)。出張・年は実務で使うため残す。
氏名の扱いについて、配置表はコード名(「年少1」等)で作り、別シートで本名に変換する2段階構成にするか未定。 夕方配置ツール 要件書 2-e 不要。2段階構成は作らない。 staff-masterが職員ID(2-1など)と氏名を最初から別列で持ち、出力にも両方を含めているため、VLOOKUP相当の変換は要らない。出力時に氏名列を出す/出さないの切替で足りる。
玄関の優先順位の例外ルール(その学年の保育者が誰もいなくなる場合/他学年と被る場合は「介優先」より優先する)を実装するか未定。 夕方配置ツール 要件書 2-a 今回は実装しない。人間が手動で動かす。 このアプリは全自動配置を目指さず、ドラッグ&ドロップで人間が確定する設計。ルール化して自動化すると挙動が読めなくなるリスクの方が大きい。運用してみて必要なら追加する。
17:00以降、退勤間際の職員を一時的に該当枠に残す個別対応を、汎用ロジックとしてどう組み込むか未定。 夕方配置ツール 要件書 2-b 今回は実装しない。人間が手動で動かす。 同上。デバッグ記録で繰り返し出ていた個別ケースだが、ルール化できる部分とできない部分の切り分けが済んでいない。

上記以外の記載(「勤務表作成のルール」「実装ログ」「未決定事項」の各項目)は、変更されていない=現在も有効として扱う。

3. 現在の設計(領域別)

領域現在の方針
データ保持ブラウザ保存(localStorage)が正本。職員マスター・祝日・休み・当番・行事を自動保存する。複数キーへの書き込みは一括で試し、途中で失敗したら保存前の状態へ戻す。持ち出し・控えは、職員マスタJSONと月次の閲覧用HTMLで行う。外部通信・CDNは使わない。
職員マスター氏名、職員ID、表示順序、クラス(age)、雇用形態、当番の担当可否、在籍を持つ。勤務時刻は持たない。職員IDは「クラス-連番」「園長」「副園長」「ST-連番」。枠はクラスごとに追加・削除できる(上限1クラス99枠・全体200枠)。園長・副園長の枠は削除できない。氏名を変えてもIDは変わらないため、休み・勤務データの紐付けが壊れない。
月間勤務表在籍職員の当番を月単位で入力・自動割り振りする。手入力は固定し、自動分だけを再計算する。休み・休日・行事・自由入力を持つ。詳細は「勤務表作成のルール」を参照。
シフトマスタ(夕方配置用)雇用形態×当番記号から出勤・退勤時刻を決める唯一の場所。初期値はHTML内にハードコードする。表記ゆれのエイリアスは持たない(統合により不要。「2.」参照)。夕方の在否と配置先ヒントもここで管理する。
配置マスタ時間帯ごとの配置エリア、必要人数、統合対象、玄関有無、備考を持つ。初期値はHTML内にハードコードし、日々触らない前提だが、タブ上で統合ボタンや文字修正を試せる。通常導線では触らず、画面後方の保守用タブとして置く。配置マップの表示エリア、統合クラス、必要人数、不足表示、Excel出力の正本として使う。
初期配置の根拠正職員・7.5時間・7時間は職員マスターのクラス(age)。短時間(ST)は所属クラスを持たないため、その日の当番から配置先を決めるか、分からない日はフリーへ置く。園長・副園長は配置先が分かる日はそのクラスへ、分からない日はフリーへ置く。
配置マップ配置マスタをもとに、時間帯ごとに玄関、フリー、統合済みクラス、不在のエリアを動的に出す。カードは園長、副園長、正職員、7.5時間、7時間、短時間で色分けする。退勤済みの職員は不在エリアに「退勤済」として置き、通常の配置候補・玄関候補には含めない(デフォルトでは非表示、上部トグルで切替可能)。人員不足時は不在エリアから退勤済み職員を動かせるが、確認ダイアログを経て「残業配置」として本人カードとExcel出力に明示し、不在へ戻すと解除される。カードをクリックまたはドラッグアンドドロップで移動する。各時間帯は在園者と初期配置を独立判定し、さらに手動で動かした人だけを未来の時間帯へ優先的に引き継ぐハイブリッド方式で運用する(残業配置フラグも同様に引き継ぐ)。生成済みの未来がある状態で過去の時間帯を修正すると、確認のうえ以降の配置と各種フラグを破棄して再計算待ちにし、画面に通知を出す。手動配置のまま退勤時刻をまたぐ場合は、またぐ瞬間に残業として続けるかを都度確認する。
カレンダー/日付選択月間勤務表のカレンダーを日付選択に兼用する。夕方配置へ進める日は、その日の当番が入力済みの日。
クラス移動各時間帯の生成時、必要人数を下回るクラスがあれば余剰のあるクラス・フリーから応援を自動で仮配置する(玄関の自動仮配置と同じ「仮置き」思想)。ただし本当のクラス統合タイミングまでは先読みせず、「退勤時刻が早い人を先に送る」という近似ルールにとどめた縮小版。人間がクリック・ドラッグで動かした瞬間に通常の手動配置へ昇格し、以後は人間の判断が優先される。
最終出力配置マップで作成済みの各時間帯配置を、1枚の推移表として確認・Excel出力する。ただし見た目は推移表でも、各時間帯の配置データは独立して持つのが目標。Excelはライブラリを使わず、ZIP(stored)とOOXMLを自前で組み立てて出力する。
デザイン配色とフォントは勤務表(staff-master)の系統を維持する(緑 #226a58 系、游ゴシック/メイリオ、クラスカラーは0歳オレンジ・1歳赤・2歳緑・3歳青・4歳黄・5歳桃の淡色)。画面構成・導線は夕方配置ツールの考え方(番号付きタブ、カード型の配置エリア)に寄せる。
AIで追加編集する場合この実装計画書とHTML本体を正本として扱う。大規模な作り替えより、現在の単体HTMLの構造に沿った小さな修正を優先する。

4. 夕方配置のルール(園の運用)

出典:保育園職員配置ツール引き継ぎ資料(2026-07-04時点で最新・最も信頼できる資料)および要件書。

4-1. 園の基本情報

クラスは年長(5歳)・年中(4歳)・年少(3歳)・2歳・1歳・0歳。職員数の目安は 年長2・年中2・年少3・2歳4.5・1歳5〜6・0歳3。

4-2. 夕方配置の必要人数

時間帯玄関年中・年長年少2歳0・1歳
16:00〜16:301人(正職員・7.5時間優先)通常保育
16:30〜17:001人1人1人3人3人以上
17:00〜17:151人年中長少合体2人0・1・2合体3人
17:15〜17:301人2人3人
17:30〜17:451人1人(いなければ0・1・2から1人回す)3人
17:45〜18:00なし全員1室集合(閉園18:00。残るのは遅・遅〇)

4-3. 配置の優先順位

4-4. 17:00以降の引き継ぎ

16:30時点の部屋割りを記録し、17:00以降は退勤者を除いてそのまま引き継ぐ(在園中の人を勝手に他部屋へ動かさない)。玄関担当が交代したら、前の担当者は0・1・2室へ合流。

4-5. 特記事項

要件書2-c「玄関優先チェックボックス(職員ごとに手動でON/OFFする機能)を今回も実装するか」は未決定のまま。前回ツールには機能があったが、実際にはチェックを入れずに運用していた形跡がある。/要件書2-f「短時間職員のPM休(8:30〜12:00=午前のみ勤務)を夕方配置の対象外としてよいか」も明確な回答が確認できていない。現行は午後不在として扱う。

5. 当番記号と夕方の在否

staff-masterの workLabels(研・AM研・PM研を勤務として数える)は出勤予定日数のカウントの話であり、夕方その人が園にいるかとは別の問い。夕方配置は下表で判定する。

記号勤務表上の扱い夕方(16:00〜)の在否
早/早〇/8/・/ふ/9-17/9半/介/遅/遅〇当番在:シフトマスタの退勤時刻まで
AM研勤務在:「・」と同じ時刻で扱う
研/PM研勤務不在
早PM研/8PM研(自由入力)勤務不在
指/指(通常)/厚/夏休み不在
休(daysOff)休み不在
出張/年(自由入力)勤務外不在

「早PM研」「8PM研」は1セルに「早番・8番で出勤し、午後は研修」の2つの情報が入った複合記号。staff-masterは1セル1値のモデルなので自由入力の文字列として持ち、正規化時に前置記号を剥がして判定する。夕方配置にとって前置記号は影響しない(PM研なら午後不在なので、前半が早でも8でも夕方の在否は同じ)。前置記号が効くのは勤務表側の「早系合計」カウントだけであり、staff-masterの1セル1値モデルを崩す必要はない。

出退勤時刻(雇用形態×記号)の対応表は、旧「夕方配置ツール」のDEFAULT_SHIFT_RULESおよび要件書1-2を正本として移植する。正職員に「9半」の種別は存在しない。短時間の退勤時刻は種別名から個別に読み取る。

拘束時間は雇用形態ごとに一定で、正職員525分・7.5時間510分・7時間480分に全記号が揃う。要件書1-2の2エントリ(正規の遅=9:30、7時間の介=9:00〜16:00)はこの規則から外れていたが、2026年9月19日に利用者へ確認し、旧HTML側の値が正しいと確定した(正規の遅=9:15〜18:00で525分、7時間の介=9:45〜17:45で480分)。要件書側の記述は誤り。

6. 夕方配置ツールからの移植対象(旧アプリで実装済みの機能)

注意:下表の「実装済み」は旧「夕方配置ツール.html」での状態であり、この統合版での状態ではない。統合版での進捗は「9. 移植の進捗」を見ること。

項目旧アプリでの状態詳細
シフトマスタ実装済み雇用形態×シフト記号から出勤・退勤時刻を解決する。表記ゆれ、不在記号、配置先ヒント、玄関候補フラグ、遅番フラグを持つ。ブラウザ上で編集でき、初期値から変更した欄は赤系の変更表示になる。時刻入力は4桁入力から時刻表記へ変換する。(表記ゆれのエイリアスは統合により廃止。「2.」参照)
職員マスタ実装済み氏名、役職、雇用形態、通常クラス、玄関優先を管理する。Excel取込、Excel保存、手動追加、グレーのサンプル行表示に対応。手動変更箇所は変更表示する。職員IDは氏名依存ではなく連番+乱数で発行し、同姓同名でも重複しにくい設計にしている。職員マスタExcel再取込時は、完全一致または空白・全角半角をならした一致が1人だけなら既存IDを維持する。(統合版ではstaff-masterの職員マスターを正本とし、ID体系は「クラス-連番」。Excel取込・サンプル行・玄関優先は移植しない/未決定。)
シフト表整形・取込実装済みExcelファイル直接取り込み、または非常用のテキスト貼り付けから、月間勤務表、1日分リスト、複数日マトリクスを判定し、アプリ用出勤簿へ整形する。主目的は、加工しにくい勤務表Excelを丸ごと投入し、職員マスタに載っている人だけを抽出すること。Excel取込では「貼付用」系シートを優先して探す。取込期間、日数、読み取った日付をプレビューで確認できる。職員名の一部一致候補・候補なしは取込タブで選択確定または無視できる。Excelセル内改行を含む貼り付けにも対応する。Excel書式や色は読まない。(統合により廃止。「2.」参照)
再取込時の初期化実装済み同じ日付を再取込した場合、その日付の確定シフト、配置マップ、手動配置、確認済み時間帯、残業配置フラグを削除し、古い配置情報が残らないようにする。(取込廃止に伴い不要。ただし「勤務表の当番を後から変えた日は、その日の配置を作り直す」という同趣旨の処理は必要。)
通常導線とマスタ導線の分離実装済み毎回使う職員マスタ、シフト表整形・取込、日付選択、配置マップを前に置き、基本触らないシフトマスタと配置マスタは後ろに置く。取込確定後は配置マスタを挟まず日付選択へ進む。(統合版でも維持する。)
カレンダー3状態表示実装済み日付を「データなし」「データあり・エラー」「データあり・使用可能」に分けて表示する。使用可能な日だけ配置マップへ進める。取込後は取り込んだ最初の日付の月を表示する。
配置マスタ実装済み時間帯ごとの表示エリア、必要人数、統合対象、玄関有無、備考を管理する。16:00から17:45以降までのクラス統合表を初期値として持ち、配置マップの箱、必要人数、不足表示、Excel出力へ反映する。画面上で統合ON/OFFや文字修正を試せる。
配置マップ基本レイアウト実装済み上部に時間帯ステッパーを表示し、生成済み時間帯だけジャンプ可能にする。玄関・フリーを上段、クラス・統合クラスを中段、不在を下段に表示する。各エリアには必要人数、備考、現在人数を表示し、不足・充足を色で示す。
時間帯ごとの独立初期配置+手動引き継ぎ実装済み各時間帯で、その時点に在園している人を出退勤時刻から判定し、職員マスタまたはシフト記号から初期配置を作る。人間が手動で動かした職員だけは未来の時間帯へ優先的に引き継ぐ。クラス統合でエリア名が変わる場合は、配置マスタの統合ルールを使って統合先エリアへ読み替える。過去時間帯で手動修正する場合は、以降の生成済み配置を破棄して再計算待ちにするか確認し、古い未来配置をそのまま見せない。
ドラッグ&ドロップ/クリック移動実装済みカードをクリックして選択し移動先エリアをクリック、またはドラッグ&ドロップで移動できる。すべての移動経路は共通の移動処理を通し、手動配置フラグ、残業配置確認、不在へ戻したときの解除処理を同じルールで扱う。
退勤済み・不在カードの非表示実装済み退勤済みまたは不在のカードは不在エリアに置く。画面上部のトグルで不在エリア内の退勤済み・不在カードだけを隠せる。玄関やクラスなどへ手動配置された退勤済みカードは非表示にしない。
残業配置実装済み不在エリアから退勤済み職員を移動すると確認ダイアログを出し、承認時のみ「残業配置」として扱う。勤務中に手動配置した職員が未来時間帯で退勤時刻をまたぐ場合も、その瞬間だけ確認する。承認後は以降の時間帯へ聞き直さず引き継ぎ、却下時は不在へ落とす。不在へ戻すと残業配置フラグを解除する。カード、画面表示、職員別Excel、配置場所別Excelに「残業配置」を明記する。
玄関候補の見える化実装済み玄関に配置できる雇用形態は正職員または7.5時間のみ。7時間と短時間は玄関候補から除外し、手動で玄関へ動かす操作もブロックする。そのうえで、玄関優先、シフトマスタの玄関候補フラグ、その時間帯を最後まで担当できるか、続けて長く担当できるか、部屋との往復移動が少ないか、役職ペナルティ、正職員、現在フリーなどを点数化し、上位3名をおすすめ順位として表示する。退勤済み・途中退勤・シフト上不在の職員は候補・ランキングから除外する。
玄関の自動仮配置実装済み各時間帯を生成した瞬間、玄関が空であれば玄関おすすめスコア1位を自動で仮配置する(完全自動決定ではなく「仮置き」の位置づけ)。園長・副園長は自動選出の対象外(人間の判断に委ねる。手動では引き続き選べる)。その時間帯を通しで担当できない人・スコアが0以下の人は選ばれず、その場合は玄関を空のまま表示する。カードに「仮配置」バッジを表示し、人間がクリック・ドラッグ&ドロップで動かした瞬間に通常の手動配置へ昇格してバッジが消える。未来の時間帯へは引き継がず、生成のたびに毎回ランキングを再評価する。画面表示・職員別Excel・配置場所別Excelに「自動仮配置」と明記する。
クラス人数の自動応援仮配置実装済み各時間帯を生成した瞬間(玄関の自動仮配置の後)、必要人数(配置マスタの数値)を下回るクラスがあれば、余剰のあるクラスやフリーから応援を自動で仮配置する。送り出す優先順位は、フリーに居る人→退勤時刻が早い人(クラス統合のタイミングで抜ける人の近似)。不足中のエリア・必要人数が数値でないエリア(通常保育など)からは引き抜かず、引き抜き元が自分の必要人数を下回ることはない。手動配置済みの人・園長・副園長・その時間帯を通しで居られない人は動かさない。埋めきれない不足はそのまま赤色の不足表示で人間に知らせる。カード・Excelの扱いは玄関の自動仮配置と共通(「仮配置」バッジ、動かすと手動配置へ昇格、未来へ引き継がず毎回再評価)。
配置サマリー(独立タブ)実装済み配置マップとは別タブに分離した最終確認画面。日付未選択、または最後の時間帯(17:45〜)まで配置が進んでいない場合は空状態メッセージを表示する。内容はシフト帯別在籍者一覧(解決後の勤務時刻が同じ記号は「遅・遅〇」のように1行へ統合し、勤務時間を併記、1人1セルのExcel風グリッド。シフト上不在の人は載せない)、時間帯別配置場所(クラス系統で色分け、玄関=青/年中年長少=緑/2歳=オレンジ/0・1歳=紫。エリアごとに最大人数分の列を取り1人1セル、統合エリアはセル結合の代わりに内側の縦罫線を消して一続きの場所に見せる)、職員別配置表の3段構成。Excelダウンロード(無色、主シート職員別+配置場所別)と、画面の色分けをそのまま活かす「色分けで印刷・PDF保存」(ブラウザ標準の印刷機能、新規ライブラリ依存なし)の両方を出せる。配置マップのボタンからワンクリックで遷移する。
XSS対策と氏名表示復元実装済みカード、玄関おすすめランキング、取込プレビュー、配置表画面表示など、ユーザー入力由来の氏名・理由・記号はescapeHtmlを通して表示する。過去の修正で消えた氏名表示は、エスケープ付き表示として復元済み。(統合版でも同じ方針。staff-master側は基本的にDOM APIで組み立てており、文字列連結でHTMLを作る箇所ではエスケープを通す。)

7. 運用上の注意

項目安心して使うための考え方
時間帯の修正基本は16:00から順に配置を確認していく。過去時間帯を直す場合は、以降の生成済み配置をいったん再計算待ちにする確認が出る。これは古い未来配置が混ざらないようにするための安全機能。
残りを一括生成未生成の時間帯だけをまとめて作る便利ボタン。すでに手で調整済みの未来時間帯は勝手に上書きしない。現場で細かく確認したい日は、通常の「次の時間へ」で順番に進める。
配置マスタ配置マスタは日々触る場所ではなく、園の時間帯ルールを置いておく保守用設定。運用中に大きく変えた場合は、その日の配置を作り直す前提で扱う。
枠の削除と在籍チェックの使い分け産休・長期休職など一時的に外すだけなら「在籍」チェックを外す(データは残る)。名簿から本当に消すときだけ枠を削除する(その職員の休み・当番データも一緒に消える)。
職員マスタの持ち出しブラウザ保存が正本なので、PCを替えるときは「職員マスタをJSON出力」で控えを取り、移行先で「職員マスタJSON読込」する。月次の勤務表ごと移すときは従来どおり月次HTMLを使う。
保存の考え方日々の編集はブラウザに自動保存される。ブラウザのデータを消すと失われるため、節目でJSONまたは月次HTMLを書き出しておく。外部通信は行わないため、USBやローカルPCで扱える。
AIで追加編集する場合この実装計画書とHTML本体を正本として扱う。大規模な作り替えより、現在の単体HTMLの構造に沿った小さな修正を優先する。

8. 将来の任意改善

項目必要になったら追加するもの
ここから再計算現在の配置を起点に、以降の時間帯を明示的に作り直す専用ボタン。現行でも過去時間帯を修正した場合は自動で再計算待ちになるため、通常運用では必須ではない。
カード情報の追加必要に応じて、カード内に退勤時刻、通常クラス、今日の配置先、残業配置理由などをさらに表示する。
クラス統合タイミングを見た応援選定現行の応援自動仮配置は「退勤時刻が早い人」を近似指標に使う縮小版。将来、そのクラスが何時にクラス統合で必要人数が減るかまで先読みし、そのタイミングに近い人を優先して応援に出す、より精密な選定に発展させる余地がある。実装コストが高いため、現行の近似ルールで運用してから必要性を見て判断する。
全時間帯サマリー専用ビュー配置マップ内で画面表示とExcel出力ができる。将来、画面上でさらに見やすい専用ビューが欲しくなった場合に追加する。
Excelの色判定旧アプリでExcelセルの文字だけを読む設計だった名残。取込廃止により当面不要。
配置マスタのExcel保存・読込配置マスタを園ごとに持ち回る必要が出た場合に追加する。現行はHTML内の初期値と画面上の一時編集で十分に使える。
玄関優先チェックボックス職員ごとに玄関優先を手動でON/OFFする機能(要件書2-c)。前回ツールには存在したが、実際にはチェックを入れずに運用していた形跡があるため、必要性を確認してから判断する。

9. 移植の進捗(統合版での実装状況)

この節は、統合作業が進むたびに更新する。「6.」の表は旧アプリの状態を示すものなので混同しないこと。

工程状態備考
staff-masterを土台として複製完了元の2ファイル(staff-master(サンプル).html、夕方配置ツール.html)は変更していない。
職員マスターの枠可変化完了保存データを名簿の正本に変更。クラスごとの枠追加、枠削除(休み・当番データの同時削除つき)、ID検証パターンの一本化、登録枠数の表示。
職員マスタJSONの出力・取込完了出力は不在枠も含む。取込は手元に無いIDを新しい枠として追加し、取込側に無い手元の枠は不在として残す。
実装計画書の統合完了本ドキュメント。両アプリの記載を統合し、変更した前提を「2.」に明示。
当番記号の正規化関数完了全角英数→半角、丸記号(○ ◯ 〇 ●)→U+3007、波ダッシュ→ハイフンへ寄せる。短時間の直接時刻表記(8:30-16:30 など)とSTクラス記号(ひ0・ひ1・り・う・ぱ・き)も解決する。
シフトマスタ(雇用形態×記号→時刻)完了SHIFT_TIMES として実装。拘束時間は正職員525分・7.5時間510分・7時間480分で全記号が揃う。要件書1-2の「正規の遅9:30」「7時間の介9:00-16:00」との食い違いは、2026年9月19日に利用者へ確認し旧HTML側が正しいと確定(正規の遅9:15〜18:00、7時間の介9:45〜17:45)。
配置マスタ完了TIME_BANDS(6帯)とPLACEMENT_RULES。要件書1-5の必要人数表をそのまま反映。sourcesはage(0〜5)の配列で持つ。
配置マップ完了時間帯ステッパー、エリア別カード、クリック移動とドラッグ&ドロップ、不足の赤表示、玄関おすすめ上位3名、玄関の自動仮配置、クラス不足の自動応援、残業配置の確認と引き継ぎ、過去帯を直したときの以降の破棄。園長は自動選出の対象外(手動は確認つきで可)、遅番の副園長は17:15・17:30で玄関を自動交代、玄関は正職員・7.5時間のみ(7時間・短時間は移動もブロック)。16:30以降でクラスが埋まらない場合は玄関を空けてそのクラスへ回す。
配置の陳腐化検出完了生成時の前提(職員・雇用形態・クラス・当番・解決後の勤務時刻)を時間帯ごとに指紋として保存し、描画時に照合する。古い帯があるときは新規生成を止め、確認のうえ日ごと作り直す。指紋のない旧保存データは「確認できない」として古い扱いにする。古い状態ではサマリーのExcel出力を禁止し、印刷物にも警告を残す。
在園判定完了配置に数えるのは「その時間帯を最後までいる人」だけ。16:15退勤の職員は16:00〜16:30の当番には入れない(2026年9月19日に利用者へ確認して確定)。一度「開始時点にいれば数える」実装にしたが誤りだったため戻した。途中で抜ける人を入れたい場合は、残業配置と同じ確認ダイアログを経て手動で置く。
配置サマリーとExcel出力完了④配置サマリータブ。シフト帯別の在園者(同じ勤務時刻の記号は1行に統合し時間を併記)、時間帯別の配置場所(エリアごとに最大人数分の列、統合エリアは内側の縦罫線を消して一続きに見せる)、職員別の配置の3段。出力はstaff-masterと同じ作法で、Excelは既存の excelZip を再利用(MS明朝・黒文字・罫線つき、職員別と配置場所別の2シート)、印刷は @media print の A3横で画面の色分けを活かす。新しいライブラリは追加していない。
デザイン統合一部完了配色(緑#226a58系・クラスカラー)とフォントは勤務表のまま維持し、タブに①〜④の番号を付けて導線を夕方配置寄せにした。カード型の配置エリアも勤務表の罫線・余白の作法に合わせてある。全体の見直しは残っている。

枠外をクリックするか、Escキーでも閉じられます。

更新履歴

このファイルに加えた変更の台帳です。新しい順に表示します。設計判断の詳しい理由は「実装ログ」にあります。

品質確認・採点・改善提案

下の文面をコピーし、このHTMLファイルと一緒にAIへ渡してください。実名の入った職員マスタJSONや月次HTMLは添付しないでください。

内蔵試験(自動計算)

架空の職員データで、月間の自動割り振りと夕方配置を検算します。実行中は保存を遮断し、終了後に画面の状態とブラウザ保存が変わっていないことも確かめます。

行事名

同じ日に3つまで。空欄は保存しません。

HTMLから取り込む

選択した内容を置き換えます。他の月の休み・祝日は保持します。マスターを取り込む場合、ファイルにない職員は不在になります。