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

**版数** 1.0（DBレス構成のデモ）／ **作成日** 2026-10-13 ／ **発行** ソウゾウ合同会社
**用途** 業種特化アプリの実演デモ ／ 介護・福祉（デイサービス）向け「申し送りボード」

---

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

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

- 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
- 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、`docs/DECISIONS.md` に1行ずつ残す。
- 3章の「作らないもの」は、思いついても作らない。
- 「デモだから」を理由に品質を落とさない。**申し送りの整形と要約は、テストが通るまで画面を作らない。**
- **見た目は、`デザイン/` に入るデザイン画像を正とする**（Codex が作る。届いたら1pxずつ再現し、撮って見比べる）。この文書の6〜8章は、画像が来るまでの目安。
- **デイサービスの現場の言葉で書く。** 申し送り・利用者・ご家族・バイタル・検温・血圧・水分・食事量（主食・副食）・排泄・入浴・服薬・機能訓練・レクリエーション・送迎・時間差出勤・早番／遅番・スポット（単発）の職員・相談員・看護職員・ケアマネ（介護支援専門員）・介護ソフト。「ユーザー」「タスク」「ステータス」「レコード」「インポート」を画面に出さない（「取り込む」と書く）。

> **このアプリが選ばれる理由**
> デイサービスの申し送りは、朝の口頭と紙のノートで回っている。時間差で出勤する職員や、単発で入るスポットの職員には、前の申し送りが届かない。利用者の情報は介護ソフトに入っているのに、現場のスマホで「今日来る人だけ」を見る形になっていない。
> KOTOZUTE は、**介護ソフトから出したCSVを入れるだけで、今日来る利用者がスマホにカードで並び、顔写真・注意点・前日の申し送り（3行の要約）が1分で分かる**ようにする。申し送りは、スマホに話すだけでAIが申し送りの文に整える。送るのは職員が確かめてから。
> 時間差で出勤した職員が前の申し送りを人に聞く、スポットの職員が当日まで利用者の顔を知らない、介護ソフトの記録をもう一度手で写す、のどれか1つでもあれば失敗とみなす。

---

## 課題定義

| 項目 | 内容 |
|---|---|
| 誰に刺すか | デイサービスの管理者・生活相談員（職員がスマホに慣れていて、時間差出勤やスポットの職員がいる事業所） |
| 場面 | 朝の申し送り／時間差で出勤した職員が前の申し送りを知らないとき／スポットの職員が初めて来た日 |
| 問題（ふわっと） | 「職員間での利用者さんの情報共有っていうか、申し送り事項の共有をちょっとどうしていこうかな」「スマホでやってる職員が慣れてますんで、スマホで見やすく簡潔にできないかな」（デイサービスの管理者・2026-10-12 初回商談の録画） |
| 理想 | 出勤した職員が、自分のスマホで「今日来る利用者」と注意点・前日の申し送りを1分で把握できる。スポットの職員にも顔写真と注意点を事前に見せられる |
| 課題（ギャップ） | 情報は介護ソフトにあるが、現場のスマホで「今日の人だけ」を見る形になっていない。紙や口頭の申し送りは、時間差で出勤する職員に届かない |
| 見る前の感情 | 紙と口頭で回しているが漏れが怖い／Claude で自作してみたが「これでいいのか」が分からない |
| 見た後の感情 | 介護ソフトのCSVを入れるだけで今日の利用者カードが並ぶなら、うちでもできる。公開と個人情報の扱いだけはプロに見てもらいたい |
| 見せ場（必ず見せる） | ①介護ソフトのCSVを取り込む → 今日来る利用者だけがカードで並ぶ（曜日・時間差出勤に対応） ②スポットの職員に、顔写真と注意点を事前に見せる ③AI：スマホの音声入力で話した内容を申し送りの文に整え、前日分を3行に要約する |
| 既製品で足りる部分／作る価値 | 記録・請求・LIFE は介護ソフトのまま（置き換えない）。作る価値は「介護ソフトのデータを、現場のスマホで今日の分だけ見る」部分と、事業所ごとの注意点の書き方 |
| 言わないこと | 「介護記録ソフトの代わりになる」／「法令対応済み」／利用者の情報をそのまま外部のAIに送ってよいと断定すること（個人情報・要配慮個人情報の扱いは本番化の論点として説明する） |

---

# 1. プロジェクト概要

## 背景（出典は末尾）

- 検索：申し送り 介護 170・申し送りノート 140・介護 申し送り アプリ 50・申し送り アプリ 30（ラッコキーワード 2026-10-13・Google・年平均）。「申し送り」単体は 8,100 だが看護・引き継ぎ全般を含む。道具の名前より「申し送り」という仕事の名前で探されている。
- 同じ管理者の次の関心は送迎（デモ「【介護】送迎管理アプリ」MUKAE）。**見本の事業所・利用者・職員は MUKAE と同じ「ひだまりデイサービス」にする**（2本のデモがつながって見える。顔写真も同じものを使う）。
- 利用者の心身の状態は要配慮個人情報を含みうる（個人情報保護委員会「個人情報の保護に関する法律についてのガイドライン」）。本番で外部のAIに送るときの範囲と同意は、本番化の論点として画面と資料で説明する。

## プロダクト定義

| 項目 | 内容 |
|---|---|
| 名前 | KOTOZUTE（ことづて）※仮称。「言伝」＝人から人へ伝えること |
| 一言 | 介護ソフトのCSVを入れるだけ。今日来る人と注意点がスマホに並び、申し送りは話すだけでAIが整える |
| 提供形態 | レスポンシブWebアプリ。**フロントエンド完結（サーバー側の保存なし）** |
| 見本の事業所 | 「ひだまりデイサービス」（架空。MUKAE と同じ。東京都練馬区大泉学園町のあたり）。利用者20名（今日来るのは16名）・職員10名（MUKAE の6名＋看護職員・機能訓練指導員・スポットの職員2名） |
| 見本の場面 | **今日の朝 8:30**。早番の職員が出勤して、昨日の申し送りを読む。10:00 に遅番の職員が出勤する。今日はスポットの職員が初めて入る日 |
| 主戦場 | 職員のスマホ（今日の利用者・申し送りを話す）／事務所のPC（CSVの取り込み・申し送りの一覧・既読・スポットの職員への案内） |

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

1. 開いた瞬間に、職員のスマホに「今日来る16名」がカードで並ぶ。カードには顔写真・到着予定・注意点・昨日の申し送りの3行要約
2. 管理者のPCで「見本のCSVを使う」を押す（または自分のCSVを入れる）と、列の読み取りの確認 → 取り込み → 今日の利用者が並ぶ。明日の曜日に切り替えると並ぶ人が変わる
3. 職員のスマホで「話して申し送り」を押して話すと（または見本の声を流すと）、AIが「誰の・どの項目の・どんな状態か・どう対応したか」を読み取り、申し送りの文に整えて見せる。職員が確かめて「送る」と、その利用者のカードに付き、管理者の画面と、あとから出勤した職員のスマホに出る
4. スポットの職員用の案内（期限つきのリンク）を開くと、今日担当する利用者の顔写真と注意点だけが見られる。「確認しました」を押すと管理者の画面で確認済みになる
5. AIの呼び出し回数と月の予算の上限が、管理者の画面に出る（デモでは数えるだけ）
6. リセットできる

---

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

- すべてブラウザ内で動く。保存は localStorage（見本から変えた分）。見本は「今日」を基準に毎回同じものを組み立てる。
- **AIは外部につながない**（デモの方針：費用0円・毎回同じ動き・悪用されない）。申し送りの整形・要約・CSVの列の読み取りは `src/lib/ai/` の純粋な関数で、同じ入力なら同じ結果と理由を返す。本番ではこの部分だけを Claude に差し替える（`Brain` の型を守る）。
- **音声入力はブラウザの音声認識**（Web Speech API・ja-JP。MUKAE と同じ `useSpeech`）。使えないブラウザでは理由を出し、見本の声（あらかじめ用意した文）で試せるようにする。
- 本番で外部のAIを呼ぶときの決まり（デモでは画面の「本番での仕組み」に書く）：①AIに送るのは申し送りの本文だけ。氏名は「利用者A」のように置き換えて送り、戻す ②1日の呼び出し回数と月の予算に上限を持たせ、超えたら決まりの整形に戻す ③利用者の情報（要配慮個人情報を含みうる）の保存先・ログイン・見られる範囲は本番化の論点として説明する。
- CSVの読み取りはブラウザの中だけ（ファイルを外へ送らない）。文字コードは Shift_JIS と UTF-8 の両方を読む。
- 画面はストアを直接触らず `src/lib/repo/` の関数とフックを使う。

## CSVの決まりごと（`csv/`）

| 項目 | 決まり |
|---|---|
| 取り込むもの | ①利用者の一覧（氏名・ふりがな・生年月日または年齢・要介護度・利用曜日・サービス提供時間・送迎の有無・注意点） ②今日の利用予定（日付・利用者・到着予定・帰りの予定）。どちらか一方でもよい |
| 列の読み取り | 見出しの言い回しの違いを吸収する（例：「利用者名」「氏名」「お名前」→ 氏名、「曜日」「利用曜日」→ 利用曜日、「留意事項」「注意事項」「特記事項」→ 注意点）。読み取れない列は「使わない」にして、人が選び直せる |
| 文字コード | 先頭の数百バイトで Shift_JIS か UTF-8 かを判定する |
| 間違い | 氏名が空の行・日付が読めない行は取り込まず、何行目のどこが悪いかを文で出す |
| 取り込みの前 | 必ず「何名・何件を取り込むか」と最初の5行を見せて、人が「取り込む」を押す |

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

| 項目 | 決まり |
|---|---|
| 申し送りの整形 | 話した文（音声認識の結果。句読点が無いことがある）から、①利用者（姓・「さん／さま」・今日来る人の中から） ②項目（食事・水分・排泄・入浴・バイタル・服薬・体調・気分・転倒・皮膚・ご家族連絡・送迎・その他） ③数値（「8割」「37.4度」「150の90」→ 血圧150/90 など） ④対応（「連絡済み」「様子見」「看護に報告」）を言葉で読み取り、項目ごとに1文の敬体に整える。例：「松本さん昼8割午後ちょっと元気ない娘さんに連絡した」→【食事】昼食は8割召し上がりました。【体調】午後は少し元気がない様子でした。【ご家族】長女さまに連絡済みです。 |
| 読み取れなかった語 | 落とさず【その他】に原文のまま残す。利用者が分からなければ止めずに「どなたの申し送りですか」と選んでもらう |
| 注意を上げる | 体温37.5度以上・血圧の上が160以上・「転倒」「ふらつき」「むせ」「食べない」などの言葉があれば「看護職員に確認」の札を付ける（判断はしない。札だけ） |
| 前日分の要約 | 利用者ごとに、前日の申し送りを、注意の札 → 体調 → 食事・水分 → その他 の順に、最大3行。元の申し送りは必ず見られる |
| 今日のまとめ | 事業所全体で「今日気をつける方」を最大5名、理由つきで出す（注意の札・前日の体調・新しい注意点） |
| 決めるのは人 | 整えた文は下書き。職員が確かめて「送る」を押すまで、だれにも出ない。送ったあとも直せて、直した履歴が残る |
| AIの上限 | 1日の呼び出し回数と月の予算の上限を設定に持ち、管理者の画面に「今日 12/200回・今月 ¥340/¥3,000（目安）」のように出す。デモでは決まりの関数で動くので費用は0円と明記する |

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

1. 迷ったら、10時に出勤して、朝の申し送りを聞けなかった遅番の職員の顔を思い浮かべる
2. スマホは片手で1分で読める量にする（1人のカードに、注意点3行・要約3行まで）
3. AIの案には、必ず「どこを読み取ったか」を添える（話した文のどの部分から、どの項目にしたか）

---

# 3. スコープ

## 作るもの

| ID | 機能 |
|---|---|
| F-01 | CSVの取り込み（管理者のPC）：ファイルを入れる／見本のCSVを使う → 列の読み取りの確認（人が直せる）→ 何名・何件かの確認 → 取り込む。取り込んだ日時と件数の記録 |
| F-02 | 今日の利用者（スマホ）：今日来る利用者のカード（顔写真・名前・到着予定・帰りの予定・要介護度・注意点・前日の申し送りの3行要約・新しい申し送りの数）。並びは到着予定順。自分の出勤時刻より前の申し送りに「出勤前の申し送り」の札。日付を切り替えられる（明日の予定も見られる） |
| F-03 | 利用者のページ（スマホ）：注意点・申し送りの一覧（日付・書いた人・項目の札）・元の文・ご家族の連絡先（架空の番号） |
| F-04 | 話して申し送り（スマホ）：「話して申し送り」→ 音声入力 → AIが整えた下書き（項目ごとの文・読み取った所の印・注意の札）→ 直す／送る。見本の声（4つ）でも試せる。文字で書いてもよい |
| F-05 | 前日分の3行要約・今日のまとめ（スマホ・PC） |
| F-06 | スポットの職員への案内：管理者が「スポットの職員に案内」→ 期限つきのリンク（デモでは同じブラウザで開ける）→ スポットの職員の画面には、今日担当する利用者の顔写真と注意点・今日の流れだけ（申し送りの全文・連絡先は出さない）→「確認しました」→ 管理者の画面で確認済みになる |
| F-07 | 管理者の画面（PC）：今日の利用者の一覧・申し送りの一覧（新しい順・項目で絞る）・だれが読んだか（既読）・スポットの職員の確認状況・AIの上限 |
| F-08 | 本番での仕組み：介護ソフトからのCSVの出し方（一般的な手順）・AIに送る範囲と置き換え・上限・ログイン・保存先・要配慮個人情報の扱い |
| F-09 | スタートページ・デモの帯（見る人の切り替え：管理者／早番の職員／遅番の職員／看護職員／スポットの職員、時計を進める、リセット） |
| F-10 | 申し送りの既読：申し送りごとに、だれが読んだかを残す。職員のスマホに「まだ読んでいない申し送り N件」→ 1件ずつ／まとめて「読みました」。管理者の画面に、出勤している職員ごとの未読の数。時計を進めると、そのあいだに書かれた申し送りが届く |
| F-11 | AIの1分まとめ：その職員がまだ読んでいない申し送りを、同じ方は1行にまとめ、注意の札がある方を先に、最大6行（残りは件数）。ブラウザの読み上げで聞ける。文は申し送りの文をつなぐだけで、新しいことを足さない |
| F-12 | 看護職員の確認待ち：注意の札が付いた申し送りは、看護職員のスマホの「確認待ち」に届く。返事（よく使う返事を選ぶ・書く）をすると確認済みになり、書いた職員と管理者に返事が出る。判断は看護職員が行う |
| F-13 | 取り込みの違い：CSVを取り込む前に「今日来る方（振替など）・今日お休みの方・利用曜日が変わった方・注意点が変わった方・名簿にいない名前」を見せる |
| F-14 | 注意点の見直しの提案：2週間で同じこと（ふらつき・転倒3回、食事が少ない3回、水分が少ない3回、発熱2回）があり、注意点にまだ書いていなければ、AIが足す文を提案する。管理者が「足す」を押すと、スマホのカードにも出る。見送ることもできる |

## 作らないもの

- 介護記録・請求・LIFE・ケアプラン（介護ソフトの領分。置き換えない）。記録を介護ソフトへ書き戻すことも作らない
- 実在の介護ソフトの名前・画面・ロゴを使うこと（CSVは架空の見本。列の名前は一般的な言い回しで作る）
- 職員のシフト作成・勤怠
- 実際の電話・メッセージ送信（押すと「デモのため架空の番号です」と出す）
- 写真の撮影・保存（顔写真は見本だけ）

---

# 4. 画面

| パス | 画面 | 主な人 |
|---|---|---|
| `/` | スタート（見せ場3つと、入口） | — |
| `/s` | 今日の利用者（スマホ） | 職員 |
| `/s/u/:id` | 利用者のページ | 職員 |
| `/s/talk` | 話して申し送り（下書き → 送る） | 職員 |
| `/s/inbox` | 申し送りを読む（AIの1分まとめ・読みました） | 職員 |
| `/s/checks` | 看護職員の確認待ち（返事） | 看護職員 |
| `/g/:token` | スポットの職員の案内（期限つき） | スポットの職員 |
| `/m` | 今日の申し送り（PC） | 管理者 |
| `/m/import` | CSVの取り込み | 管理者 |
| `/m/notes` | 申し送りの一覧 | 管理者 |
| `/m/guest` | スポットの職員への案内 | 管理者 |
| `/m/settings` | 設定・AIの上限・本番での仕組み | 管理者 |

画面上部に、デモの帯（黒地）：見る人の切り替え（管理者 早川さん／早番 中村さん 8:30出勤／遅番 山口さん 10:00出勤／スポット 森田さん）、時計（8:30 → 10:00 → 12:30）、リセット、「これはデモです。AIは外部につながず、このブラウザの中だけで動きます。人物・電話番号はすべて架空です」。`?as=` で見る人を指定して開ける。

# 5. 見本データ

- 利用者20名：**MUKAE の20名と同じ**（`~/dev/souzoh/mukae/src/lib/seed/index.ts` の名前・年齢・乗り方・利用曜日・メモ・ご家族）。要介護度・サービス提供時間・注意点を足す。顔写真は MUKAE の `public/img/riders/` を使う。
- 職員10名：MUKAE の6名（早川 所長／大西 生活相談員／中村 介護職／山口 介護職／小林 送迎のみ／斎藤 送迎のみ）＋ 看護職員 吉村、機能訓練指導員 岩田、スポットの職員 森田・坂本（初めて入る日）。顔写真は MUKAE の6名を使い、新しい4名だけ Codex に頼む。
- 申し送り：過去2週間分を、項目・書いた人・時刻つきで約120件（体調の変化・食事量・入浴の見合わせ・ご家族からの連絡など。注意の札が付くものを数件）。前日分は全員に1〜4件。
- 見本のCSV2本：利用者の一覧（Shift_JIS・見出しは「利用者名」「フリガナ」「要介護度」「利用曜日」「提供時間」「送迎」「留意事項」）、今日の利用予定（UTF-8・「日付」「氏名」「到着予定」「帰宅予定」）。わざと見出しの言い方を2本で変えて、列の読み取りが効く所を見せる。
- 見本の声（4つ）：「松本さん昼8割午後ちょっと元気ない娘さんに連絡した」「井上さんお熱37.6あったので入浴やめました看護の吉村さんに報告済み」「木村さんトイレで少しふらつきあり転倒なし」「原田さん血圧150の92お薬は飲まれてます」

# 6〜8. 見た目

- **デザイン画像（`デザイン/` の5枚・Codex・2026-10-13）を正とする。** 主色は落ち着いた藍 #344F72、地は #F4F6F8、面は白、注意だけ赤。MUKAE の深緑とは別のアプリに見える色。
- 管理者のPC：左にメニュー（今日の申し送り・CSVの取り込み・申し送りの一覧・スポットの職員・設定）。今日の申し送りは、数字3つ（今日の利用・新しい申し送り・気をつける方）→ 利用者の表（顔写真・到着予定・注意点・昨日の申し送り・既読した職員）→ スポットの職員の確認状況。右に「AIの今日のまとめ」と「AIの上限」。
- 職員のスマホ：あいさつと出勤時刻 → 日付の切り替え → 今日来る人数 → 気をつける方の赤い帯 → 利用者のカード（顔写真・到着／帰り・要介護度・注意事項・昨日の申し送りのAI要約・新しい申し送り）→ 下に大きな「話して申し送り」。
- 話して申し送り：話した内容（読み取った所に下線）→ 整えた下書き（利用者・項目ごとの文と「読み取った所」）→「まだ送信されていません」→ 直す／送る。
- スポットの職員：今日の担当の方（顔写真と注意点だけ）・今日の流れ・「確認しました」。
- AIは「AI要約」「AI」の小さな枠の印で控えめに出す。紫のグラデーション・キラキラ・チャットの窓は使わない。
- スマホは本文16px以上・押す所48px以上（デザイン画像は2倍の見本）。日本語は Noto Sans JP、数字は等幅に見える書体。

# 9. 技術

Vite 6 + React 19 + React Router 7 + Tailwind v4（色はチャンネル値の CSS 変数・基本の CSS は `@layer base`）+ Zustand（persist）。CSV は自前の読み取り（Shift_JIS は `TextDecoder('shift_jis')`）。Cloudflare Workers の静的アセットで配信（account `fa03cd9cababb13a09331265a38f4ed1`）。

# 10. 非機能

- 320px〜2560px で横にはみ出さない
- 初期の JS は 200KB（gzip）以下
- スマホの画面は、ボタンの高さ 48px 以上・文字 16px 以上
- CSV 1,000行を2秒以内に読み取れる

# 11. 実装タスク

## Phase 1 — 読み取りとAI
- [ ] csv/（文字コードの判定・列の読み取り・間違いの文）とテスト：Shift_JIS／UTF-8、見出しの言い回し、空の氏名、読めない日付
- [ ] ai/note.ts（申し送りの整形）とテスト：見本の声4つ・句読点なし・数値（8割・37.6・150の92）・対応・注意の札・利用者が分からない文
- [ ] ai/summary.ts（前日分の3行・今日のまとめ）とテスト
## Phase 2 — 見本データ
- [ ] MUKAE の利用者20名・職員6名を読み込み、4名・要介護度・注意点・申し送り2週間分・見本のCSV2本を足す
## Phase 3 — 画面
- [ ] デザイン画像どおりに：外枠・デモの帯・スマホの今日の利用者・利用者のページ・話して申し送り・スポットの職員の案内・管理者の今日の申し送り・CSVの取り込み・申し送りの一覧・設定
## Phase 4 — 仕上げ
- [ ] 既読・確認済みの記録・リセット・レスポンシブ総点検・公開

# 12. 受入基準

1. 見せ場①〜③が動く
2. 読み取りとAIのテストがすべて通る（`npm test`）
3. 申し送りを送ると、管理者の画面と、別の職員のスマホに同時に出る。送る前は、だれにも出ない
4. スポットの職員の画面に、申し送りの全文と連絡先が1つも出ない
5. 320／375／768／1024／1280px で横はみ出し0・文字の切れなし
6. 「言わないこと」が画面の文言に入っていない

# 出典

- デイサービスの管理者との初回商談の録画（2026-10-12）の文字起こし
- ラッコキーワード（Google・年平均の月間検索数、2026-10-13）
- 個人情報保護委員会「個人情報の保護に関する法律についてのガイドライン（通則編）」（要配慮個人情報）
- 厚生労働省「医療・介護関係事業者における個人情報の適切な取扱いのためのガイダンス」


---

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

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

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

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

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

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