# YASUMI — 要件定義書 兼 Claude Code 実装指示書

**版数** 1.0（DBレス構成のデモ）／ **作成日** 2026-10-14 ／ **発行** ソウゾウ合同会社
**用途** 業種特化アプリの実演デモ ／ 介護・福祉（シフト勤務の事業所）向け「有給・特別休暇の管理」

---

## このドキュメントの使い方（Claude Code へ）

これ1枚が、規約・仕様・タスクのすべて。リポジトリ直下に `CLAUDE.md` として置き、毎回読み込むこと。

- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、`docs/DECISIONS.md` に1行ずつ残す。
- 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。**付与日数・年5日の判定・規程の読み取りは、テストが通るまで画面を作らない。**
- **見た目は、`デザイン/` に入るデザイン画像（Codex 第2稿・2026-10-14）を正とする**。主色 #315847・注意 #A33E31・補助の黄 #8B7750、角丸2〜3px、影なし。画像化に使った HTML（`デザイン/*.html`）の寸法をそのまま写した（`src/styles/theme.css`）。
- **介護事業所の事務の言葉で書く。** 年次有給休暇（有給）・年次有給休暇管理簿・基準日・付与・取得・繰越・時効・年5日の取得・時季指定・計画的付与・半日単位・時間単位・比例付与・週の所定労働日数・常勤／パート・特別休暇・慶弔休暇・夏季休暇・就業規則・休暇規程・シフト表・勤務の記号（早・日・遅・公・有・前有／後有・特）・公休・申請・承認・所長・事務。「ユーザー」「レコード」「ステータス」「インポート」を画面に出さない（「取り込む」と書く）。

> **このアプリが選ばれる理由**
> 介護事業所の休暇は、シフト表・有給の管理表・特別休暇の控えがばらばらで、年5日に届いていない人は年度末に表を突き合わせてやっと分かる。パートが多く、週の勤務日数で付与日数が変わるので、表計算の式も壊れやすい。
> YASUMI は、**シフト表から休暇を拾って、職員ごとの年次有給休暇管理簿を自動で作り、基準日から1年の期限までに5日に届かない人を、期限の近い順に一目で見せる。** 事業所独自の特別休暇は、就業規則・休暇規程のPDFを入れるとAIが種類と日数を読み取って候補を出し、事務が確かめて登録する。
> 年5日に届かない人を探すのに表を突き合わせる、パートの付与日数を手で調べる、特別休暇を別の紙で数える、のどれか1つでもあれば失敗とみなす。

---

## 課題定義

| 項目 | 内容 |
|---|---|
| 誰に刺すか | 介護事業所の事務・管理者（シフト勤務で、有給と特別休暇の管理が分かれている） |
| 場面 | 年度の途中で「年5日に届いていない人」を探すとき／特別休暇の申請が来たとき |
| 問題（ふわっと） | 「有給と有給5日消化の管理、特別休暇の管理を一本化したい」（介護の担当者・公式LINEの1問アンケート 2026-10-08。声は1件） |
| 理想 | 職員ごとの付与・取得・残りと、年5日に届かない人が一目で分かる。特別休暇も同じ画面で管理できる |
| 課題（ギャップ） | 有給・年5日・特別休暇が別々の表で管理され、シフト表とも分かれている |
| 見る前の感情 | 年度末に慌てて取得を促している |
| 見た後の感情 | いつでも誰が足りないか分かる。自分たちの規程に合わせて作れる |
| 見せ場（必ず見せる） | ①職員ごとの年次有給休暇管理簿（基準日・日数・取得した日）が自動でできる ②基準日から1年以内に5日に届かない人が一目で分かる ③シフト表から休暇を拾う ④AI：就業規則・休暇規程（PDF）を読み取って、特別休暇の種類と日数を登録する |
| 既製品で足りる部分／作る価値 | 勤怠・労務の専用ソフトで足りる場合が多い（料金は未確認）。作る価値は、シフト表と事業所独自の特別休暇を1つにまとめる部分。給与計算は専用ソフトに任せる |
| 言わないこと | 「労働基準法に対応済み」／「給与計算もできる」。ほかに「違反を防げる」「監査に通る」とも書かない。日数と判定は**目安**として出し、最終の判断は事業所（必要なら社会保険労務士）と書く |
| 完成の条件 | 架空の職員15名・1年分のシフトで、年5日に届かない人の一覧と特別休暇の申請まで動く。AIの呼び出しに回数と予算の上限を入れる |
| 流用する既存デモ | TOKIWA（勤怠・シフト）の業種版。見本の事業所・職員は MUKAE・KOTOZUTE と同じ「ひだまりデイサービス」 |

---

# 1. プロジェクト概要

## 背景（出典は末尾）

- 検索：年次有給休暇管理簿 1,000・有給 5日 880・有給管理表 480・有給管理 390・有給管理 エクセル 390・有給管理アプリ 320（ラッコキーワード 2026-10-13・Google・年平均）。道具の名前より「管理簿」「5日」という義務の言葉で探されている。**画面の見出しにも「年次有給休暇管理簿」「年5日」をそのまま使う。**
- 制度（厚生労働省の解説による）：年10日以上の年次有給休暇が付与される労働者に、使用者は基準日から1年以内に5日を取得させる（2019年4月から）。労働者ごとに年次有給休暇管理簿（時季・日数・基準日）を作り、期間の満了後3年間保存する。本人が取った日・計画的付与の日は5日に数えてよい。半日単位は0.5日として数え、時間単位は数えない。
- 介護事業所はパートが多い。週の所定労働日数が4日以下かつ週30時間未満の人は付与日数が少ない（比例付与）が、**週3日でも勤続が長いと10日以上になり、年5日の対象になる**。ここを手で追うのが一番間違いやすい。
- 見本の事業所は MUKAE（送迎）・KOTOZUTE（申し送り）と同じ「ひだまりデイサービス」。3本のデモがつながって見える。顔写真も同じものを使う。

## プロダクト定義

| 項目 | 内容 |
|---|---|
| 名前 | YASUMI（やすみ）※仮称 |
| 一言 | シフト表から休暇を拾って、年次有給休暇管理簿と「年5日に届かない人」が自動でできる。特別休暇は規程のPDFからAIが登録 |
| 提供形態 | レスポンシブWebアプリ。**フロントエンド完結（サーバー側の保存なし）** |
| 見本の事業所 | 「ひだまりデイサービス」（架空。東京都練馬区のあたり）。月〜土の営業、日曜は休業。職員15名（常勤9名・パート6名） |
| 見本の場面 | **今日（開いた日）**。事務の大西さんが、月の半ばに年5日の状況を確かめる。期限が近いのに足りない人が2名いる。介護職の山口さんから特別休暇（配偶者の出産）の申請が届いている。来月から休暇規程が改定され、新しい規程のPDFを登録したい |
| 主戦場 | 事務所のPC（年5日の状況・管理簿・シフト表・規程の登録・申請の承認）／職員のスマホ（自分の残り日数・申請・時季の相談への返事） |

## デモとしての成功条件

1. 開いた瞬間に、管理者のPCに「年5日の取得状況」が出る。15名のうち対象者（その期間に10日以上付与された人）だけが、期限の近い順に並び、「期限までにあと何日足りないか」が赤・黄・緑で分かる。対象外の人は理由（「付与8日・週3日」など）つきで下にまとまる
2. 職員を押すと、その人の年次有給休暇管理簿（基準日・付与日数・繰越・取得した日の一覧・残り）が出る。取得した日はシフト表から拾ったもので、日付を押すとシフト表のその日に移る。印刷と書き出し（CSV。Excelで開ける）ができる
3. シフト表（月×職員）で「有」「前有／後有」「特」を入れる（または、シフト表のCSVを取り込む）と、管理簿と年5日の状況がその場で変わる。見慣れない記号は、AIが「有給の半日では？」のように読み取り案を出し、人が確かめる
4. 「休暇の規程」で見本のPDFを使う（または自分のPDFを入れる）と、AIが特別休暇の種類・日数・単位・有給か無給か・対象を読み取り、**どの条文から読んだか**を横に並べて見せる。事務が確かめて「登録する」を押すと、特別休暇の一覧と職員の申請画面に出る。読めなかった所は止めずに「人が入れる」にする
5. 職員のスマホで、特別休暇（配偶者の出産 2日）を申請 → 管理者が承認 → シフト表に「特」が入り、特別休暇の残りが減る。**特別休暇は年5日に数えない**ことが画面で分かる
6. 足りない人に「時季を相談する」を押すと、シフトの人数に余裕がある日を候補に出し、管理者が選んで本人のスマホに送る。本人は「この日でよい／別の日がよい」で返事する。決めるのは管理者
7. AIの呼び出し回数と月の予算の上限が、管理者の画面に出る（デモでは数えるだけ・0円）
8. AIの見立て・取得計画・申請のチェック・話して申請・AIに聞く（F-12〜F-16）が動く
9. リセットできる

---

# 2. アーキテクチャ方針 — データベースを持たない

- すべてブラウザ内で動く。保存は localStorage（見本から変えた分）。**見本は開いた日を「今日」として組み立てる**（入社日・基準日を今日から逆算して置くので、「期限まであと何日」が毎回同じになる）。
- **AIは外部につながない**（デモの方針：費用0円・毎回同じ動き・悪用されない）。規程の読み取り・シフト記号の読み取りは `src/lib/ai/` の純粋な関数で、同じ入力なら同じ結果と理由（根拠の条文・語）を返す。本番ではこの部分だけを Claude に差し替える（`Brain` の型を守る）。
- 本番で外部のAIを呼ぶときの決まり（デモでは画面の「本番での仕組み」に書く）：①AIに送るのは規程の本文だけ（職員の情報は送らない） ②1日の呼び出し回数と月の予算に上限を持たせ、超えたら手で入力する形に戻す ③職員の情報の保存先・ログイン・見られる範囲は本番化の論点として説明する。
- PDFの文字の読み出しはブラウザの中だけ（pdf.js を、PDFを入れたときだけ読み込む。日本語の文字表は同梱）。ファイルを外へ送らない。文字が読めないPDF（画像だけのPDF）は「文字の入ったPDFを入れてください」と理由を出す。
- **日数の計算（付与・年5日・繰越・時効）は `src/lib/leave/` の純粋な関数**。画面はストアを直接触らず `src/lib/repo/` の関数とフックを使う。

## 休暇の計算の決まり（`leave/`）

| 項目 | 決まり |
|---|---|
| 基準日 | 入社日から6か月後を最初の基準日とし、以後1年ごと（職員ごとの基準日。全員を同じ日にそろえる「斉一的付与」は作らない） |
| 付与日数（通常） | 勤続 6か月 10日・1年6か月 11日・2年6か月 12日・3年6か月 14日・4年6か月 16日・5年6か月 18日・6年6か月以上 20日 |
| 付与日数（比例付与） | 週の所定労働日数が4日以下かつ週30時間未満の人。週4日：7・8・9・10・12・13・15／週3日：5・6・6・8・9・10・11／週2日：3・4・4・5・6・6・7／週1日：1・2・2・2・3・3・3（勤続の区切りは通常と同じ） |
| 出勤率 | 8割以上を前提にする（デモの見本は全員8割以上。出勤率の計算は作らない） |
| 年5日の対象 | その基準日に**10日以上付与**された人。繰越分は足さない（付与日数で決める） |
| 年5日に数える日 | 基準日から1年以内に取った有給（繰越分から使った日も含む）・計画的付与の日・半日（0.5日）。**時間単位と特別休暇は数えない** |
| 予定 | シフト表に入っている未来の「有」は「予定」として別に数え、「予定どおりなら届く」を分けて出す |
| 状態 | 届いた（緑）／足りない・期限まで3か月を超える（黄。予定どおりなら届くときは「予定で届く」と添える）／足りない・期限まで3か月以内（赤）／期限を過ぎて届かなかった（赤の札・過去の期間） |
| 繰越・時効 | 使い残しは次の1年まで繰り越し、2年で時効。使う順は規程による（見本の規程は「繰越分から」） |
| 夜勤 | 見本の事業所に夜勤は無い（デイサービス）。夜勤のある事業所の数え方は規程に書かれたとおりにする設定だけ持つ（作り込まない） |
| 表示 | 日数と判定はすべて「目安」と添える。最終の判断は事業所が行う |

## AIの決まり（`ai/`）

| 項目 | 決まり |
|---|---|
| 規程の読み取り | 規程の本文（条・項・号、表）から、特別休暇ごとに ①名前 ②日数（「5日」「連続した3日」「1日」） ③数え方（暦日・勤務日） ④有給か無給か ⑤対象（「本人の結婚」「配偶者の出産」「勤続満5年」） ⑥取れる期間（「7月から9月まで」「事由の発生から1か月以内」） を読み取る。例：「勤続満5年及び満10年に達した者には、それぞれ3日及び5日のリフレッシュ休暇を与える」→ 2行に分ける |
| 有給の決まりも読む | 半日単位の可否・時間単位の上限（年5日まで等）・計画的付与の日・使う順（繰越分から）を読み取り、設定の候補にする |
| 根拠 | 1行ごとに、読み取った条文の該当部分を必ず並べ、文中の語に印を付ける |
| 読めなかった所 | 日数が書かれていない（「所長が必要と認めた日数」など）・「別表」を参照している、などは落とさず「人が入れる」行にして理由を書く |
| 決めるのは人 | 読み取った結果は候補。事務が確かめて「登録する」を押すまで、特別休暇の一覧も職員の申請画面も変わらない。登録したあとも直せて、前の規程に戻せる（版を残す） |
| シフト記号の読み取り | シフト表のCSVに見慣れない記号（「有休」「年」「AM有」「慶」など）があれば、近い意味の記号を案として出す（「AM有 → 前有（有給・前半）」）。人が確かめて決める |
| 時季の候補 | 足りない人について、期限までの勤務日のうち、その日の介護職の人数が必要人数を上回る日を候補として出す（理由「この日は介護職が5名で、必要は4名」）。決めるのは管理者、返事は本人 |
| AIの上限 | 1日の呼び出し回数と月の予算の上限を設定に持ち、管理者の画面に「今日 3/30回・今月 ¥0/¥1,500（目安）」のように出す。デモでは決まりの関数で動くので費用は0円と明記する |

## 判断に迷ったときのルール

1. 迷ったら、月の半ばに年5日の状況を確かめる事務の大西さんの顔を思い浮かべる（表を突き合わせずに、誰に声をかければいいかが分かるか）
2. 日数には必ず「どこから来たか」を添える（付与日数は勤続と週の日数から、取得はシフト表のどの日から、特別休暇は規程のどの条文から）
3. 法律の言い切りをしない。「目安」「事業所の規程では」と書く

---

# 3. スコープ

## 作るもの

| 番号 | 機能 | 内容 |
|---|---|---|
| F-01 | 年5日の取得状況 | 管理者のトップ。対象者を期限の近い順に、基準日・期間・付与・取得・予定・あと何日・期限までの日数・状態。対象外の人は理由つきで下に |
| F-02 | 年次有給休暇管理簿 | 職員ごと。基準日・付与日数（勤続と週の日数から、と出す）・繰越・取得した日の一覧（日付・全日／半日・どのシフト表から）・残り・時効になる日数。前の期間も見られる（3年分）。印刷と CSV の書き出し |
| F-03 | シフト表 | 月×職員の表（記号）。休暇の記号は色で分かる。セルを押して記号を変えられる。日ごとの介護職の人数と必要人数を下に出す。前後の月へ移れる（1年前〜2か月先） |
| F-04 | シフト表の取り込み | シフトのCSV（職員×日付）を入れて、記号の読み取りを確かめてから取り込む。見本のCSVあり。文字コードは Shift_JIS と UTF-8 |
| F-05 | 休暇の規程（AI） | PDFを入れる（見本あり）→ AIが特別休暇と有給の決まりを読み取る → 根拠の条文を並べて確かめる → 登録。版を残す |
| F-06 | 特別休暇の一覧 | 登録した特別休暇（名前・日数・有給／無給・対象・取れる期間）。職員ごとの取った日数 |
| F-07 | 申請と承認 | 職員が有給（全日・半日）・特別休暇を申請 → 管理者が承認／差し戻し（理由つき）→ シフト表に入る |
| F-08 | 時季の相談 | 足りない人に、候補日を出して本人に送る → 本人が返事 → 管理者が決めるとシフト表に「有」が入る |
| F-09 | 職員のスマホ | 自分の有給の残り・年5日まであと何日・期限・次の休み・特別休暇の一覧・申請・時季の相談への返事 |
| F-10 | 設定・本番での仕組み | 必要人数・AIの上限・本番でのデータの扱い（保存先・ログイン・AIに送る範囲） |
| F-12 | AIの見立て | 年5日の取得状況の上に、声をかける順の見立て（急ぎ・パートでも対象・前の期間で届かなかった・繰越の時効・まだ0日の人）を理由つきで並べ、次にすること（候補日を送る・管理簿を見る・計画を作る）へつなぐ |
| F-13 | AIの取得計画 | 足りない人ごとに、期限までの残りを必要な日数ぶんに区切り、区切りの中で「介護職の人数に余裕がある・ほかの人の休みと重ならない・真ん中に近い」日を選ぶ（年末年始は避ける・相談中の人は送った候補のまま）。外したい日は外して、まとめて本人に相談として送る |
| F-14 | 申請のAIチェック | 申請ごとに、規程の日数・連続か・取れる期間・前日までの申請・有給の残り・半日の可否・その日の介護職の人数・年5日への効き方を確かめ、「問題なし／確かめてほしい所」を出す。決めるのは管理者 |
| F-15 | 話して申請（AI） | 職員が話す・書く（「来週の火曜と水曜、妻の出産で休みたい」）と、AIが種類・日付・理由を読み取って申請の欄に入れる。どの語から読んだかを出す。勤務の日でない日は外して知らせる |
| F-16 | AIに聞く | 管理者（上の「AIに聞く」）と職員（スマホ）が、規程と管理簿について聞ける（「配偶者の出産は何日？」「年5日に届いていないパートは？」「あと何日で5日？」）。答えには出どころ（規程の条・管理簿）を付け、法律の言い切りはしない。話して聞ける |
| F-11 | デモの帯 | 見る人（事務 大西さん／所長 早川さん／職員 山口さん・中村さん・小林さん）を切り替える・リセット |

## 作らないもの

- 給与計算・勤怠の打刻・残業の計算（専用ソフトに任せる）
- 出勤率（8割）の計算、全員の基準日をそろえる「斉一的付与」、前倒しの付与
- シフトの自動作成（シフト表は入れる・取り込むだけ）
- ログイン・権限の作り込み（デモの帯で見る人を切り替えるだけ）
- 外部のAI・外部への送信（PDFもCSVもブラウザの外へ出さない）
- 子の看護等休暇・介護休暇など法律で決まった休暇の計算（規程に書かれていれば一覧に載せるだけ）

---

# 4. 画面

| パス | 画面 | 主な中身 |
|---|---|---|
| `/` | スタート | 一言・見せ場4つ・「管理者の画面を見る」「職員のスマホを見る」 |
| `/m` | 年5日の取得状況（F-01） | 上に数字3つ（年5日の対象 13名・届いた 2名・足りない 11名（うち期限3か月以内 2名））。表：職員（顔写真・名前・常勤／パート 週の日数）・基準日・期間・付与・取得・予定・あと・期限まで・状態の帯。右：申請待ち・時季の相談の返事・AIの上限 |
| `/m/staff/:id` | 年次有給休暇管理簿（F-02） | 職員の見出し → 今の期間の表 → 取得した日の一覧 → 前の期間。印刷・CSV |
| `/m/shift` | シフト表（F-03・F-04） | 月の切り替え・記号の凡例・表・日ごとの人数。「シフト表を取り込む」 |
| `/m/rules` | 休暇の規程（F-05・F-06） | 左：規程の本文（PDFの文字）／右：読み取った候補の表（名前・日数・有給か・対象・期間・根拠の条文）→「登録する」。下：登録済みの特別休暇と版 |
| `/m/plan` | AIの取得計画（F-13） | 足りない人と期限・AIの案（日付・理由）・月ごとの休み・人数がぎりぎりの日 → 本人に相談として送る |
| `/m/requests` | 申請（F-07・F-14） | 申請の一覧（有給・特別休暇・時季の相談の返事）・承認／差し戻し |
| `/m/settings` | 設定（F-10） | |
| `/s` | 職員のスマホ（F-09） | 大きな数字で「年5日まで あと○日」「有給の残り ○日」・期限。次の休み・相談が来ていればその案内。「休みを申請する」 |
| `/s/apply` | 申請（F-07） | 種類（有給 全日／半日・特別休暇）→ 日付（シフト表の勤務日だけ選べる）→ 特別休暇は事由 → 送る |
| `/s/offer` | 時季の相談への返事（F-08） | 候補日・「この日でよい／別の日がよい（希望日）」 |

---

# 5. 見本データ

**今日＝開いた日（以下「今日」）。** 入社日は「今の基準日での勤続」と「期限まで」から逆算して置く（期限までの日数が毎回同じになる）。月〜土営業・日曜は公休。必要人数：介護職 4名／日（介護職でない人の時季の候補は、介護職がこれより多い日）。

| ID | 氏名 | 役割 | 働き方 | 今の基準日での勤続 | 今の期間の付与 | 取得（うち半日） | 予定 | 期限まで | 見せたい所 |
|---|---|---|---|---|---|---|---|---|---|
| s1 | 早川 由美 | 所長（管理者） | 常勤 | 11年6か月 | 20日（6年6か月以上） | 1 | 2 | 約11.5か月 | 黄：期間が始まったばかり。予定2日を入れればあと2日 |
| s2 | 大西 健 | 生活相談員・事務 | 常勤 | 6年6か月 | 20日 | 2 | 0 | **約1.5か月** | **赤**：あと3日・期限が近い（見本の主役） |
| s3 | 中村 さとみ | 介護職（早番） | 常勤 | 4年6か月 | 16日 | 3（半日2回を含む） | 0 | 約3.5か月 | 黄：あと2日 |
| s4 | 山口 翔太 | 介護職（遅番） | 常勤 | 2年6か月 | 12日 | 0 | 0 | 約11.5か月 | 前の期間は5日届いた。**特別休暇（配偶者の出産 2日）を申請中** |
| s5 | 小林 誠 | 送迎・介護補助 | パート週4日・29時間 | 3年6か月 | 10日（比例 週4日 3年6か月） | 4 | 0 | **約2週間** | **赤**：あと1日・期限が目の前。パートでも対象 |
| s6 | 斎藤 和夫 | 送迎 | パート週3日・18時間 | 7年6か月 | 11日（比例 週3日 6年6か月以上） | 2 | 1 | 約3.5か月 | 黄：**週3日のパートでも10日以上なので対象** |
| s7 | 吉村 恵子 | 看護職員 | 常勤 | 6年6か月 | 20日 | 1 | 2 | 約9か月 | 黄。慶弔休暇（祖母の葬儀 2日）を取った（年5日には数えない） |
| s8 | 岩田 健太 | 機能訓練指導員 | 常勤 | 1年6か月 | 11日 | 0 | 0 | 約11.5か月 | **前の期間（10日）は3日で期限を過ぎた**（赤の札が管理簿に残る） |
| s9 | 森田 彩 | 介護職 | パート週2日・12時間 | 1年6か月 | 4日（比例 週2日 1年6か月） | 1 | 0 | ― | 対象外（付与10日未満） |
| s10 | 坂本 大輝 | 介護職 | パート週3日・20時間 | 3年6か月 | 8日（比例 週3日 3年6か月） | 2 | 0 | ― | 対象外 |
| s11 | 佐藤 美咲 | 介護職 | 常勤 | 6か月 | 10日（最初の付与） | 0 | 1 | 約11.5か月 | 新しく対象になった人 |
| s12 | 高橋 浩二 | 介護職（リーダー） | 常勤 | 7年6か月 | 20日（繰越 6日） | 6（規程どおり繰越分から使う） | 0 | 約4.5か月 | 届いた（緑）。繰越分から使っている |
| s13 | 伊藤 久美子 | 介護職 | パート週4日・28時間 | 6年6か月 | 15日（比例 週4日 6年6か月以上） | 5 | 0 | 約10か月 | 届いた（緑）。夏季休暇も取った |
| s14 | 渡部 涼 | 介護職 | 常勤 | 3年6か月 | 14日 | 2 | 1 | 約7.5か月 | 黄 |
| s15 | 松井 千尋 | 調理員 | パート週5日・30時間 | 3年6か月 | 14日（週30時間以上なので通常の付与） | 0 | 0 | 約10.5か月 | 黄：まだ0日 |

- 年5日の対象は13名（s9・s10 が対象外）。届いた2名（s12・s13）、赤2名（s2・s5）、黄9名。数は実装で数えた値を正とし、上の「見せたい所」が必ず成り立つようにシフトを置く。**s2・s5 が赤、s8 の前の期間が「期限を過ぎた」になることはテストで固定する。**
- シフト表：1年前〜2か月先。常勤は月〜土のうち週5日（早・日・遅）、パートは決まった曜日。有給は季節に散らす（夏・年末年始の前後・連休の前後）。見本の特別休暇：吉村（慶弔 祖母 2日）・伊藤（夏季 3日）・中村（夏季 3日）・高橋（誕生日 1日）。計画的付与：8月13日（全員の有給1日・事業所の規程）。
- 見本のCSV：①シフト表（来月分・職員×日付・記号に「AM有」「慶」が混ざる） ②（任意）職員の一覧（入社日・週の日数・週の時間）。
- 見本のPDF：「ひだまりデイサービス 就業規則（抜粋）第5章 休暇」（下の付録）。来月からの改定版で、リフレッシュ休暇が新しく入る。

## 付録：見本の規程（PDFにする本文・架空）

> **第5章 休暇**
> **第30条（年次有給休暇）** 1 入社日から6か月間継続勤務し、所定労働日の8割以上出勤した者には、10日の年次有給休暇を与える。以後1年ごとに、別表1の日数を与える。2 週の所定労働日数が4日以下で、かつ週の所定労働時間が30時間未満の者には、別表2の日数を与える。3 年次有給休暇は、本人の請求により半日単位で取得することができる。半日は前半（8時30分から13時まで）と後半（13時から17時30分まで）とする。4 時間単位の取得は、1年に5日分を限度とする。5 前年度から繰り越した日数があるときは、繰り越した分から先に使用する。6 会社は、労使協定により、毎年8月13日を計画的付与の日とする。7 年次有給休暇が10日以上与えられた者には、基準日から1年以内に5日について、本人の意見を聴いた上で時季を指定して取得させる。ただし、本人が取得した日数及び計画的付与の日数は、指定する日数から除く。
> **第31条（特別休暇）** 職員が次の各号に該当するときは、特別休暇を与える。特別休暇は有給とする。(1) 本人が結婚するとき 連続5日 (2) 子が結婚するとき 1日 (3) 配偶者が出産するとき 2日（出産の日から2週間以内） (4) 配偶者、子又は父母が死亡したとき 連続5日 (5) 祖父母、配偶者の父母又は兄弟姉妹が死亡したとき 連続2日 (6) その他、所長が必要と認めたとき 所長が定める日数
> **第32条（夏季休暇）** 7月1日から9月30日までの間に、3日の夏季休暇を与える。夏季休暇は有給とし、分割して取得することができる。
> **第33条（誕生日休暇）** 誕生月に1日の誕生日休暇を与える。有給とする。
> **第34条（リフレッシュ休暇）**〔改定で新設〕 勤続満5年及び満10年に達した者には、それぞれ3日及び5日のリフレッシュ休暇を、達した日から1年以内に与える。有給とする。
> **第35条（休暇の申請）** 休暇を取得しようとする者は、原則として前日までに所定の方法で申請し、所長の承認を受けなければならない。
> 別表1・別表2（年次有給休暇の付与日数）は省略。

AIの読み取りで見せること：第31条(6)は日数が「所長が定める日数」→「人が入れる」行／第34条は2行に分ける／第30条の3〜6は「有給の決まり」の候補になる／「別表」は省略とあるので読まず、付与日数はアプリの計算（4章）を使うと書く。

---

# 6〜8. 見た目（デザイン画像が来るまでの目安）

- 色は落ち着いた主色1つ＋注意の赤＋足りないの黄（MUKAE の青緑・KOTOZUTE の紺と別の色にする。例：深い緑）。地は白〜薄いグレー
- 年5日の状況は、1人1行に「取得（濃い）＋予定（薄い）／5日」の帯。期限までの日数を大きな数字で
- シフト表の休暇の記号は色で分かる（有＝主色・前有／後有＝主色の半分・特＝別の落ち着いた色・公＝グレー）
- 規程の画面は、左に条文・右に読み取った表。読み取った語に印、表の行を押すと条文の該当部分に移る
- スマホは「年5日まで あと○日」を一番大きく。ボタンは親指で押せる大きさ
- 顔写真は丸（MUKAE・KOTOZUTE と同じ写真）

# 9. 技術

Vite 6 + React 19 + React Router 7 + Tailwind v4（色はチャンネル値の CSS 変数・基本の CSS は `@layer base` の中）+ Zustand persist。pdf.js（PDFを入れたときだけ読み込む）。Cloudflare Workers の静的アセット（account `fa03cd9cababb13a09331265a38f4ed1`・`yasumi.souzohnic.workers.dev`）。開発のポートは 3200。

# 10. 非機能

- 幅 320〜1920px で横のはみ出し・文字切れ0。PC の表はスマホではカードにする
- 初回の読み込みを軽く（pdf.js・日本語の文字表は PDF を入れたときだけ）
- コンソールのエラー0

# 11. 実装タスク

## Phase 1 — 計算と読み取り
`leave/`（基準日・付与・比例付与・年5日・繰越・時効・状態）と `ai/`（規程の読み取り・記号の読み取り・時季の候補）を純粋な関数で作り、テストを先に通す。境目のテスト：勤続6か月ちょうど・週4日で30時間ちょうど（通常の付与）・週3日6年6か月（11日で対象）・半日2回で1日・時間単位は数えない・特別休暇は数えない・期限の当日。

## Phase 2 — 見本データ
5章の15名と1年分のシフトを今日から逆算して組み立てる。「見せたい所」をテストで固定する。

## Phase 3 — 画面
デザイン画像を正として再現。撮って見比べる。

## Phase 4 — 仕上げ
一連の流れ（規程の登録 → 職員の特別休暇の申請 → 承認 → シフト表 → 管理簿／時季の相談 → 本人の返事 → 決定 → 年5日の状態が変わる）を通す。幅の点検。

# 12. 受入基準

1. 15名の付与日数が、勤続と週の日数から正しく出る（テストで15名とも固定）
2. 年5日の対象・状態が5章の「見せたい所」のとおりになる
3. シフト表で「有」を入れる・消すと、管理簿と年5日の状況がその場で変わる
4. 見本の規程から、特別休暇9行（本人の結婚・子の結婚・配偶者の出産・死亡（配偶者・子・父母）・死亡（祖父母など）・夏季・誕生日・リフレッシュ満5年・満10年）と「人が入れる」1行（所長が必要と認めたとき）・有給の決まり5つ（半日単位・時間単位の上限・繰越分から・計画的付与 8月13日・時季指定）が、根拠の条文つきで出る
5. 特別休暇の申請 → 承認 → シフト表に「特」・年5日は変わらない
6. 「言わないこと」が画面に無い
7. 幅 320・375・768・1024・1280・1440・1920 で崩れない

# 出典

- 厚生労働省「年5日の年次有給休暇の確実な取得 わかりやすい解説」（2026-10-13 確認）
- 厚生労働省「確かめよう労働条件」Q&A（年次有給休暇・比例付与・管理簿）（2026-10-13 確認）
- ラッコキーワード（2026-10-13・Google・年平均）
- 公式LINEの1問アンケート（2026-10-08・介護の担当者）


---

## 付録　本番運用に向けて（ソウゾウ合同会社より）

> **この章は実装の対象ではありません。Claude Code は、この章の内容を実装しないでください。** 要件定義書を読んでいる方へのご案内です。

この要件定義書は、画面と動きを確かめるための**デモ**として書かれています。社内やお客さまに実際に使ってもらうには、次の4つが別に必要です。

| 項目 | デモでは | 本番では |
|---|---|---|
| データの保存 | データはその端末のブラウザの中にしか残りません。ほかの端末やほかの人とは共有されず、消えることもあります。 | サーバーのデータベースに保存し、バックアップと復元ができるようにします。 |
| セキュリティ | ログインがなく、誰でもすべての画面とデータを見られます。 | ログイン、権限（誰が何を見られるか）、通信とデータの暗号化、不正なアクセスへの対策を入れます。 |
| ガバナンス（運用ルール） | 決めていません。 | 誰がいつ何をしたかの記録、個人情報の扱い（プライバシーポリシー・同意）、アカウントの発行と削除、障害のときの連絡体制を決めます。 |
| 公開・デプロイ | 手元で動かすか、デモとして公開するだけです。 | 独自ドメイン、本番とテストの環境分け、更新の手順、監視と障害対応、月々の費用の管理を整えます。 |

本番運用をお考えの方は、ぜひ一度ご相談ください。最適なプランのご紹介と、進め方をお伝えします。

- 日程を選んで相談する（代表 西澤）：https://vszh6zudz50.jp.larksuite.com/scheduler/e7fecdad1a756dbe
- 公式LINE：https://lin.ee/UNwvWjp
- お問い合わせフォーム：https://service.souzoh-official.com/contact/
