SOUZOHSPECS

業務システム ・ HIROBA

【AI】社内SNS・掲示板

AIが荒れそうなスレッドと社内の課題に気づく

掲示板・お知らせ・チャット・ストーリー・ありがとうを1つにした社内SNS。荒れそうなスレッドは早めに気づいて理由をつけて止められ、目安箱と今週の調子から社内の課題にも気づける。企業向けの社内SNS・掲示板

作り方は無料です。このページの手順どおりに、要件定義書とプロンプトを Claude Code に送れば、このデモと同じアプリが完成します。

要件定義書をダウンロードデモを触る ↗

v1.3・作成 2026-10-29

  1. 要件定義書を保存する

    パソコンに hiroba-app のようなフォルダを作り、その中に保存します。

    要件定義書.md として保存

  2. ChatGPT で画面イメージを作る デザインにこだわりたい人

    ChatGPT に要件定義書を添付して、下の文を送ります。雰囲気のところは、好きな言葉に書きかえてください。

    ChatGPT に送る
    添付の要件定義書は、これから作るアプリ「【AI】社内SNS・掲示板」のものです。
    このアプリのいちばん大事な画面を、デザイン画像にしてください。
    実際のアプリのように、文字やボタンまで入れてください。
    雰囲気:(例:やさしい/高級感/ポップ/シンプル など、好きな言葉で)

    気に入るまで「もっと明るく」「ボタンを大きく」のように直してもらい、できた画像を保存します。ほかの画面も欲しければ、同じように作ってもらえます。

  3. Claude Code に渡して「作って」と頼む

    Claude のデスクトップアプリで「Code」タブを開き、「Select folder」から hiroba-app を選びます。画面イメージがある人は、入力欄に画像をドラッグして貼りつけてから、下の文を送ります。詳しく

    Claude Code に送る(画像あり)
    @要件定義書.md をもとに、このアプリを作ってください。
    デザインは添付の画像に合わせてください。
    Claude Code に送る(画像なし)
    @要件定義書.md をもとに、このアプリを作ってください。

    作り終わるまで、しばらくかかります。途中で「許可しますか」と聞かれたら、内容を見て許可してください。

  4. 動かして確かめる・直す

    できたら、実際に画面を開いて触ります。直してほしいところは、スクリーンショットを貼りつけて、言葉で伝えれば大丈夫です。

    Claude Code に送る
    アプリを起動して、ブラウザで開けるようにしてください。
    Claude Code に送る
    (画面名)で(操作)をすると(今の動き)になります。
    (こうなってほしい動き)にしてください。
    Claude Code に送る
    このエラーを直してください。
    
    (ここにエラーの文をそのまま貼る)
  5. 途中で止まったら 必要なときだけ

    要件定義書が長いので、一度で作りきれないことがあります。そのときは新しい会話で、こう送ります。

    Claude Code に送る
    @要件定義書.md の続きを作ってください。
    まず、どこまでできているかを確かめてから進めてください。

    それでも進まないときは、30分無料相談でお手伝いします。公式LINEからのご相談もどうぞ。

    1段階ずつ頼みたいとき(全6段階)

    要件定義書には、作る順番が Phase 0〜5 で書かれています。止まりやすいときは、1つずつ頼むと確実です。

    Phase 0土台
    Claude Code に送る
    @要件定義書.md の「実装タスク」にある Phase 0 を作ってください。
    Phase 1荒れ具合・言葉の候補・要点
    Claude Code に送る
    @要件定義書.md の「実装タスク」にある Phase 1 を作ってください。
    Phase 2見本データ
    Claude Code に送る
    @要件定義書.md の「実装タスク」にある Phase 2 を作ってください。
    Phase 3全体デザインの承認
    Claude Code に送る
    @要件定義書.md の「実装タスク」にある Phase 3 を作ってください。
    Phase 4画面
    Claude Code に送る
    @要件定義書.md の「実装タスク」にある Phase 4 を作ってください。
    Phase 5仕上げ
    Claude Code に送る
    @要件定義書.md の「実装タスク」にある Phase 5 を作ってください。
  6. 本番で使うなら

    できたアプリはデモです。データの保存・セキュリティ・運用のルール・公開の仕方は入っていないので、そのまま公開すると誰でも中身を見られます。本番で使うのに何が要るかは、「本番で使いたい方へ」にまとめました。

    自社向けに作り変えるなら、まずこう聞いてみてください。

    Claude Code に送る
    この要件定義書は、記事に埋め込むデモ用に書かれています。
    自分の会社で実際に使えるように変えたいです。外したほうがいいところと、残したほうがいいところを教えてください。

    本番運用について相談する

準備や、うまくいかないときの対処は 作り方ガイド にまとめています。分からないときは 30分無料相談 へどうぞ。

これはデモ用の要件定義書です。本番で使うには、あと4つ必要です。

要件定義書をダウンロード

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

版数 1.3(DBレス構成のデモ・2026-10-29 社内の課題に気づく機能を追加)/ 作成日 2026-10-28 / 発行 ソウゾウ合同会社 用途 汎用アプリ(業種を問わない)の実演デモ / 「社内SNS・社内掲示板:投稿・反応・メンバー管理と、荒れたときに止める管理画面」 台帳 Lark Base「X・SEO・YouTube管理」→ デモアプリ 44番(reczz28SLN5E8PgQ・担当 海野)。連動SEO記事「Claude CodeでSNSアプリを開発する方法と費用」(公開済) 前の版との関係 台帳のデモURL(souzoh-sns.pages.dev・Souzoh SNS)は、ストーリー・DM・フォローのある一般向けの SNS。社内の掲示板と、荒れたときの管理画面は無い。HIROBA は会社の中で使う掲示板として別に作る(Souzoh SNS のコードは使わない)


このドキュメントの使い方(Claude Code へ)

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

  • 実装は「11. 実装タスク」の順に進める。フェーズを飛ばさない。
  • 仕様に書かれていないことは推測で作らず質問する。質問できない状況では「判断に迷ったときのルール」で決め、docs/DECISIONS.md に1行ずつ残す。
  • 3章の「作らないもの」は、思いついても作らない。
  • 荒れ具合の目安・言葉の候補・投稿前の確認は、テストが通るまで画面を作らない。
  • 見た目は Codex のデザイン画像を正とする(2段:全体案3つ → 菊池さんが承認 → 残りの画面と写真)。Claude は全体の見た目を決めない。企業向け(ToB)の業務の道具として作る(2026-10-27 菊池さん:HIBI で「企業向けのアプリなので、それを前提としたデザインに」)
  • 会社の言葉で書く。 画面に出す言葉:掲示板・投稿・返信・スタンプ・お知らせ・既読・メンバー・部署・管理者・モデレーター・通報・非表示・一時停止・返信を止める・ゆっくりモード・操作の記録・相談窓口。 出さない言葉:「監視」「違反者」「炎上」「BAN」「ユーザー」「フィード」「エンゲージメント」「ランキング」。英語のボタン名(Like・Post・Admin)は使わない

このアプリが選ばれる理由 社内の連絡はチャット・メール・紙の掲示板に散らばり、全社に読んでほしいお知らせが読まれたか分からない。チャットに雑談や意見の場を作ると、制度の変更などをきっかけに言い合いになることがあり、そのとき管理する人の手元には「投稿を消す」しか無い。消すと何があったかの記録も残らない。 HIROBA は、掲示板とお知らせ(既読の人数つき)を1つにし、言い合いが強くなりそうなスレッドを管理する人に早めに知らせ、「返信をいったん止める」「ゆっくりモード」「非表示(記録は残す)」「投稿の一時停止」を、理由とともに使えるようにする。AIは「荒れ具合の目安」と「強い言葉の候補」を出すだけで、止めるかどうかを決めるのは人。 荒れたスレッドを見つけるのに通報を待つしかない、止める手段が削除しかない、何をしたかが残らない、のどれか1つでもあれば失敗とみなす。


課題定義

台帳44番は Who・場面などの項目が空のため、この版では下の内容を弊社案として置く(西澤さんの確認で確定する)。

項目 内容
誰に刺すか 社員30〜300人の会社の総務・人事・経営企画(社内の連絡の場を整えたい人)
場面 全社にお知らせを出したとき/部署ごとの掲示板で共有するとき/制度の変更などで言い合いが強くなったとき
問題(ふわっと) 「お知らせを出しても読まれたか分からない」「社内のチャットで言い合いになったとき、どう止めればいいか分からない」(弊社の想定。根拠となる商談の記録は未入力)
理想 お知らせは誰が読んだか分かり、未読の人にだけもう一度知らせられる。荒れそうなスレッドは早めに分かり、止め方を選べ、何をしたかが残る
課題(ギャップ) 連絡の場がバラバラ。言い合いになっても管理する人が気づくのは通報か口頭で、止める手段が削除しかなく、記録が残らない
見る前の感情 社内SNSを入れたいが、荒れたら困る。止め方が分からない
見た後の感情 荒れても、止め方と記録があるなら入れられる。お知らせの既読も分かる
見せ場(必ず見せる) ①掲示板の投稿・返信・スタンプ ②全社のお知らせの既読の人数と、未読の人にだけ再通知 ③管理画面に「荒れ具合が高いスレッド」が出る(返信の速さ・強い言葉の候補・通報の数から) ④返信をいったん止める(理由と再開の時刻つき)・ゆっくりモード・非表示(本人と管理者には見える・記録は残る)・投稿の一時停止 ⑤投稿前の確認:強い言い回しに、やわらかい書き方の候補が出る(そのまま送ることもできる) ⑥メンバー管理(招待・部署・役割・退職者の停止) ⑦操作の記録(誰が・いつ・何を・理由)
既製品で足りる部分/作る価値 社内SNS・ビジネスチャットの既製品は多い。作る価値は、自社の掲示板の分け方・お知らせの既読の見え方・荒れたときの止め方と記録の残し方を、自社の決まり(就業規則・相談窓口)に合わせられる部分
言わないこと 「ハラスメントを防げる/なくせる」/「法令(パワハラ防止法)に対応済み」/「AIが自動で削除・処分する」/「投稿を監視する」

1. プロジェクト概要

背景(出典は末尾)

  • 事業主は、職場のパワーハラスメントについて相談があったとき、事実関係を迅速かつ正確に確認し、被害を受けた人への配慮・行為者への措置・再発防止の措置を講じることとされている。あわせて、相談者・行為者のプライバシーを保護する措置を講じ、その旨を周知する(厚生労働省「事業主が職場における優越的な関係を背景とした言動に起因する問題に関して雇用管理上講ずべき措置等についての指針」令和2年厚生労働省告示第5号、4(3)・4(4))。中小企業も令和4年4月1日から義務。
  • 再発防止の措置の例として、方針を「社内報、パンフレット、社内ホームページ等」に改めて掲載し配布することが挙げられている(同 4(3)ニ①)。
  • このため HIROBA では、①投稿を消さずに非表示にし、何があったかを記録として残す(事実確認の材料)②非表示にした投稿は本人と管理者だけが見られる(プライバシー)③会社の方針(掲示板のルール・相談窓口)を掲示板の中に常に出す、を基本にする。HIROBA がハラスメントの判断をするのではない。 判断と対応は会社(相談窓口・人事)が行う

プロダクト定義

項目 内容
名前 HIROBA(ひろば)※仮称
一言 社内の掲示板とお知らせ。荒れそうなら早めに分かり、理由をつけて止められる
提供形態 レスポンシブWebアプリ。フロントエンド完結(サーバー側の保存なし)
見本の会社 「ひびき設備」(架空の設備工事会社。HIBI と同じ会社)。社員64人・3拠点(本社・東部営業所・施工センター)・7部署。HIBI の22人を含む
見本の場面 今日(水曜)の 10:40。9:30 に人事が出した「新しい評価制度の説明資料」のスレッドで、10時台に返信が急に増え、強い言葉と通報が出ている。同じ朝、社長の「年末の安全大会」のお知らせは64人中41人が既読
主戦場 社員のスマホ・PC(読む・書く・スタンプ)/管理する人のPC(荒れ具合・止める・記録)

使う人

人 立場 見本の人 使う場面
社員 書く・読む 田中 悠真(営業1課) 外回りの合間にスマホで掲示板を読み、スタンプを押す。夕方に PC で共有を書く
モデレーター 掲示板を見守り、止める 馬場 里佳(本部 総務) 朝と昼に PC で管理画面を開く。荒れ具合が高いスレッドが出たら、止め方を選ぶ
管理者・導入を決める人 ルール・メンバー・記録 森田 一馬(本部 マネージャー) 掲示板の作り方・ルール・メンバーを整える。月に1回、使われ方と操作の記録を見る
導入を検討する会社の総務・人事 買う人 — 商談でデモを見る。「荒れたら止められるか」「記録が残るか」「お知らせが読まれたか分かるか」

デモとしての成功条件

  1. 開いた瞬間に、社員の画面で掲示板の新着と、未読のお知らせ(年末の安全大会)が見える
  2. 投稿・返信・スタンプ(いいね・ありがとう・了解・なるほど)ができ、すぐ数に反映される
  3. お知らせを開くと既読になり、管理者の画面で「既読 41 → 42人」に増える。未読の人にだけ再通知できる
  4. 投稿の前に強い言い回しがあると、やわらかい書き方の候補が出る(候補を使う/このまま送る)
  5. モデレーターに切り替えると、管理画面の先頭に「荒れ具合:高い」の評価制度のスレッドが出て、理由(直近10分の返信9件・強い言葉の候補4件・通報3件)が分かる
  6. 「返信をいったん止める」を選び、理由と再開の時刻を入れると、社員の画面のそのスレッドに理由と再開の時刻が出て、返信の欄が閉じる。元に戻せる
  7. 投稿を非表示にすると、社員の画面では「モデレーターが非表示にしました(理由)」と出て本文は出ない。書いた本人と管理者には本文が見える。記録は消えない
  8. すべての操作が「操作の記録」に、誰が・いつ・何を・理由とともに残り、CSV で出せる
  9. リセットできる

1.1 で足したもの(2026-10-29 菊池さん「機能を充実させて社内のSNSとして最高のものに」)

見た目は Codex 全体案v2 の A案「まるっとひろば」(案内役「ぽこ」・白地+緑 #58CC18)。

機能 中身 決めごと
通知(/inbox) 返信・メンション(@氏名)・届いたありがとう・未読のお知らせ・自分の投稿へのモデレーターの対応(理由つき)を新しい順に。ベルに件数 保存せず毎回データから組み立てる(lib/inbox)。未読は「最後に見た時刻」より新しいもの。未読のお知らせは読むまで残る
ありがとうを送る 相手を選ぶ → ひとこと → 送る。ありがとうの掲示板に宛先つきで残り、相手の通知とプロフィールに届く ありがとうの数で人を比べない(数の一覧・順位は出さない。メッセージだけ)
プロフィール(/people/:id) ひとこと自己紹介・得意なこと・最近の投稿・届いたありがとう。自分のときだけ書ける 名前・顔からプロフィールへ
アンケート 投稿に2〜4つの選択肢。答えると全員の割合が出る。もう一度押すと取り消し。締め切りつき 誰がどれを選んだかは出さない
ぽこの今日のお題 ひろばに毎日変わる軽いお題。ひとことで答えると雑談のスレッドに返信として入る お題は7つを日替わり
保存 あとで読む投稿を自分だけに保存。通知の画面の「保存した投稿」 本人にしか見えない
上に固定 モデレーター・管理者が掲示板の上に投稿を固定。操作の記録に残る
メンションの候補 本文で @ のあとに名前を打つと候補が出る。本文の @氏名 はプロフィールへの札になる

1.2 で足したもの(2026-10-29 菊池さん「個人間のチャット、SNS風のプロフィールなど、一般的なSNSにあるものは全て」)

1.0 の「作らないもの」から DM・フォロー・ストーリーを外した(菊池さんの指示)。

機能 中身 決めごと
チャット(/chat・/chat/:id) 1対1とグループ。既読(1対1は「既読」、グループは「既読 N」)・絵文字の反応6種・写真・入力中の表示・日付の区切り。強い言い方は送る前にぽこがひとこと 本文は参加している人にだけ返す。管理者・モデレーターも読まない(repo/social.ts の messagesOf・テストあり)。通報すると、その1件の本文だけがモデレーターに届く。チャットは消さない・非表示にしない
SNS風のプロフィール カバー写真(拠点の写真)・顔・オンラインの印・投稿/フォロー/フォロワーの数・自己紹介・得意なこと。タブで投稿・写真・届いたありがとう。フォロー・メッセージ・ありがとう・ミュート フォロー・フォロワーの数は出す(菊池さんの指示)。人を並べた順位にはしない
フォロー ひろばに「フォロー中」のタイムライン
ストーリー 24時間で見えなくなる、ひとこと(色の背景)か写真。ひろばの上に顔の丸。全面で5秒ずつ・左右で前後・見た人の数
ハッシュタグ 本文の #タグ を押すと一覧(/tag/:tag)。ひろばに「いま話題のタグ」(7日間)
写真の投稿 端末の写真を、ブラウザの中で長い辺960pxに縮めて付ける 外には送らない。保存の容量に注意
ミュート その人の投稿とストーリーが自分の画面に出なくなる 相手には知らせない
オンラインの印 顔の右下の緑の点 デモでは決まった人がオンライン

デモでは、1対1のチャットで送ると、相手から短い返事が来る(決まった言い回しから選ぶ。外のAIは使わない)。

1.3 で足したもの(2026-10-29 菊池さん「社内の課題を見つけるのにもつながるような機能」)

機能 中身 決めごと
目安箱(/voice) 困りごと・改善の提案を、分類(働き方・安全・設備と道具・制度とルール・つながり・そのほか)をつけて出す。ほかの人は「わたしも」。モデレーター・管理者が会社として答え、状態が「受け付けました → 検討中 → 対応中 → 対応済み」と進む 匿名で出すと、誰が出したかを保存しない(拠点だけ残す・管理者にも分からない)。強い言い方には、ぽこがひとこと
今週の調子(パルス) ひろばに週1回。5段階(しんどい〜絶好調)とひとこと。答えたら次の週まで出ない 人は保存しない(拠点・部署・週と点数だけ)。答えたかどうかの印だけ本人に残す
社内の声(/admin/insights・管理者) 「いま気にしておきたいこと」:①増えている話題(拠点ごと・この7日とその前の7日)②調子が下がっている拠点(先週とその前の4週)③答えのない質問(3件以上)④「わたしも」が多いのに答えていない声 ⑤お知らせが読まれにくい拠点(半分未満)⑥ありがとうが多い。あわせて、拠点ごとの調子の推移・よく出る言葉(押すとその文)・目安箱の上位・拠点ごとの既読 src/lib/ai/insights.ts の純粋な関数(テストあり)。人ごとの数字は出さない。5人未満のまとまりの調子は出さない。引用の中の名前も伏せる。AI の目安で、どう対応するかは人が決める。本番では「よく出る言葉」を Claude に差し替えられる(本文だけを送る)

見本の場面:東部営業所の調子がこの2週で下がっている(社用車が足りない・人が足りない)。施工センターで「夜間」「立会」の話題が増えている。評価制度のスレッドに答えのない質問がある。

引き続き作らないもの:人を比べる順位(ランキング)・連続利用の記録(使う圧力になるもの)。


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

  • すべてブラウザ内で動く。保存は localStorage(見本から変えた分)。見本は「今日」を基準に毎回同じものを組み立てる。
  • AIは外部につながない(費用0円・毎回同じ動き)。荒れ具合の目安・強い言葉の候補・やわらかい書き方の候補・長いスレッドの要点は、src/lib/ai/ の純粋な関数で、同じ入力なら同じ結果を返す。本番ではこの部分だけを Claude に差し替える。
  • 本番で外部のAIを呼ぶときの決まり(デモでは「本番での仕組み」の画面に書くだけ):①AIに送るのは投稿の本文だけで、氏名・社員番号・電話番号は置き換えて送る ②1日の呼び出し回数と月の予算に上限を持たせ、超えたらルール(言葉の一覧)の判定に戻す ③AIの結果は候補としてだけ出し、非表示・停止は人が押す
  • 見える範囲は lib/repo/_scope.ts の1か所で決める:非表示の投稿の本文は、書いた本人・モデレーター・管理者だけに返す。部署の掲示板は、その部署の人と管理者だけに返す。画面に役割の分岐を書かない
  • 書き込みの時刻はデモの時計(10:40 から、開いてから経った分だけ進む)から取る(HIBI の lib/time/now.ts と同じ)

3. スコープ

作るもの

区分 機能
掲示板 全社ひろば・部署ごと(7)・拠点ごと(3)・話題ごと(安全・ありがとう・雑談)。参加・通知の切り替え
投稿 文章・写真(端末の中で縮める)・リンク。返信(スレッド)。メンション(@名前)。スタンプ4種(いいね・ありがとう・了解・なるほど)。編集(履歴が残る)
お知らせ 管理者・部署長が出す。既読の人数と、未読の人の一覧(部署別)。未読の人にだけ再通知。期限つき(年末の安全大会まで)
投稿前の確認(AI) 強い言い回しの候補に下線と、やわらかい書き方の候補。「候補を使う」「このまま送る」(送ったかどうかは記録しない)
荒れ具合の目安(AI) スレッドごとに「落ち着いている/やや高い/高い」と理由(返信の速さ・強い言葉の候補の数・通報の数・参加人数)
止める 返信をいったん止める(30分/1時間/明日の朝まで・理由・再開の時刻)/ゆっくりモード(1人10分に1件)/投稿を非表示(理由・本人に知らせる)/メンバーの投稿を一時停止(期間・理由・本人に知らせる)/掲示板全体を読むだけにする(緊急)
通報 社員が投稿を通報(理由を選ぶ)。管理画面で「届いた・確認中・対応済み」。通報した人の名前は、書いた人には出さない
メンバー管理 招待(メールの代わりに招待リンクの見本)・部署・拠点・役割(社員/モデレーター/管理者)・退職者の停止(投稿は残す)
ルール 掲示板のルール(全員に見える)・相談窓口の案内・強い言葉の一覧(会社で足せる)・ゆっくりモードの既定
操作の記録 非表示・停止・返信の停止・ルールの変更・メンバーの変更・通報の対応。理由つき。CSV
使われ方 掲示板ごとの投稿数・読む人の割合・お知らせの既読率。個人の投稿数の順位は出さない
探す 投稿・返信・お知らせを全文で(HIBI の自前の全文検索を写す)
デモの帯 見る人(社員 田中 悠真/モデレーター 馬場 里佳/管理者 森田 一馬)・リセット・「これはデモです。書いた内容はこのブラウザの外に出ません。会社・人は架空です」

作らないもの

  • DM(1対1のやり取り)・ストーリー・フォロー(Souzoh SNS の機能。会社の掲示板には持ち込まない)
  • 投稿の自動削除・AIによる自動の非表示(候補を出すだけ)
  • 個人の投稿数・スタンプ数の順位、人の比較の表
  • 投稿の「本当の削除」(管理者にも元に戻せない消し方)。非表示だけ
  • 外部のチャット(Slack・Teams・LINE WORKS)との連携の実物(本番化の論点として説明だけ)

4. 画面

パス 画面 主な人 中身
/ スタート — 何ができるかと、3つの入口(社員/モデレーター/管理者)
/home ひろば(自分の新着) 社員 未読のお知らせ・参加中の掲示板の新着・自分宛て(メンション・返信)・今日のありがとう
/b/:id 掲示板 全員 投稿の一覧。上に掲示板のルールの一行。止めている間は理由と再開の時刻
/p/:id 投稿とスレッド 全員 本文・スタンプ・返信。長いスレッドは要点(AI)。非表示の返信は理由だけ
/write 投稿する 社員 掲示板を選ぶ・本文・写真。投稿前の確認(AI)
/notices /notices/:id お知らせ 全員/管理者 一覧と本文。管理者は既読の人数・部署別の未読・再通知
/people メンバー 全員 部署・拠点ごとの名簿(顔写真)
/search 探す 全員 投稿・返信・お知らせ
/mod 見守り(管理画面の入口) モデレーター 荒れ具合が高いスレッド・届いた通報・強い言葉の候補が出た投稿。止める操作
/mod/reports 通報 モデレーター 届いた・確認中・対応済み
/mod/thread/:id スレッドの様子 モデレーター 返信の速さの線・強い言葉の候補・参加人数・止める操作・相談窓口へつなぐ
/admin/members メンバー管理 管理者 招待・部署・役割・停止
/admin/boards 掲示板の管理 管理者 作る・誰が書けるか・ゆっくりモードの既定
/admin/rules ルールと言葉 管理者 掲示板のルール・相談窓口・強い言葉の一覧
/admin/log 操作の記録 管理者 誰が・いつ・何を・理由。CSV
/admin/usage 使われ方 管理者 掲示板ごとの投稿数・読む人の割合・お知らせの既読率
/how 本番での仕組み 導入を決める人 AIの差し替え・上限・ログイン・データの保存先・外部チャット連携の論点

5. データ設計(要点)

  • Member:id・氏名・ふりがな・部署・拠点・役割(member/moderator/admin)・状態(在籍/一時停止(期限)/退職)・顔写真
  • Board:id・名前・種類(全社/部署/拠点/話題)・書ける人・ゆっくりモード(分)・止めている(期限・理由・止めた人)・読むだけ
  • Post:id・掲示板・書いた人・本文・写真・親(返信なら)・スタンプ・作成・編集の履歴・非表示(理由・した人・時刻)・通報の数
  • Notice:id・出した人・本文・対象(全社/部署)・期限・既読(人と時刻)・再通知の履歴
  • Report:id・投稿・通報した人・理由(言い方が強い/個人を責めている/個人情報/その他)・状態・対応のメモ
  • ModAction:id・した人・種類・対象・理由・期限・時刻(操作の記録)

6. 荒れ具合の目安と言葉の候補(src/lib/ai/・テスト先行)

  • heat(thread, now):直近10分の返信数・強い言葉の候補の割合・通報の数・参加人数・同じ人の連続返信から点数を出し、「落ち着いている(0〜39)/やや高い(40〜69)/高い(70〜)」と、点数の理由を3つまで返す(例:「直近10分の返信 9件(ふだんの約4倍)」「強い言葉の候補 4件」「通報 3件」)
  • toneCheck(text):会社の「強い言葉の一覧」と、言い方の型(人格を責める・決めつけ・命令・皮肉)から候補の範囲を返す。判定ではなく候補。soften(text) はやわらかい書き方を1〜2案返す
  • summarize(thread):長いスレッド(20件以上)の要点を3行(出た意見・質問・まだ答えが無いこと)
  • テスト:見本の評価制度のスレッドが 10:40 に「高い」になる/止めたあとは返信の速さが下がる/普通の雑談スレッドは「落ち着いている」のまま/強い言葉が無い文には候補が出ない

7. 見本データ(今日を基準に毎回同じものを組み立てる)

  • 社員64人(HIBI の22人+42人。顔写真は第2段で依頼)。部署:営業1課・営業2課・施工管理部・本部(総務・人事・経理)・開発・東部営業所・施工センター
  • 掲示板:全社ひろば・お知らせ・安全の共有・ありがとう・雑談・部署7・拠点3
  • 投稿:この30日で約420件(返信を含む)。ありがとうの投稿が週に8件ほど。写真つきの安全の共有
  • 今日のスレッド(荒れる見本):9:30 人事 長谷川 美咲(架空・本部 人事)「新しい評価制度の説明資料を置きました」→ 10:05〜10:38 に返信18件(直近10分で9件)。強い言葉の候補4件(例:「現場を何も分かっていない」「説明する気がないなら出すな」)。通報3件。参加11人
  • お知らせ:社長「年末の安全大会(12月18日)」既読 41/64人(本社 22/24・東部営業所 11/20・施工センター 8/20)
  • 落ち着いているスレッド:施工センター「足場点検の写真」(返信4・いいね12)、ありがとう「藤井さん、夜間の立会ありがとうございました」(ありがとう 18)
  • 一時停止中のメンバー:0人(デモの中で止められるように)。退職者1人(投稿は残っている)

8. 非機能

  • 320px〜2560px で横にはみ出さない/文字が切れない
  • 初期の JS は 200KB(gzip)以下
  • スマホのボタンの高さ 48px 以上・文字 16px 以上
  • 動きを止める設定(prefers-reduced-motion)でも全部の操作ができる
  • 色の差 4.5:1 以上

9. 受入基準

  1. 承認したデザイン画像と、画面を並べて差が無い
  2. 成功条件1〜9がすべて画面で動く
  3. 非表示の投稿の本文が、書いた本人・モデレーター・管理者以外の画面と通信のどこにも出ない(_scope.ts のテスト)
  4. 個人の投稿数・スタンプ数の順位がどこにも無い
  5. 320/375/768/1024/1280/1920/2560px ではみ出し0・文字切れ0
  6. npm test が全部通る
  7. 言わないこと(ハラスメントを防げる・法令に対応済み・自動で削除・監視)の文言検索で0件

10. 技術

  • Vite 6+React 19+React Router 7+Tailwind v4+Zustand(persist・キー hiroba-v1)+motion(LazyMotion)+Phosphor Icons(MIT)
  • HIBI(~/dev/souzoh/hibi)の lib/repo の形・_scope.ts・全文検索・デモの帯・デモの時計を写して使う
  • 配信は Cloudflare Workers の静的アセット(hiroba.souzohnic.workers.dev・アカウント fa03…)

11. 実装タスク

Phase 0 — 土台(型・見える範囲・デモの時計)

Phase 1 — 荒れ具合・言葉の候補・要点(テストが通るまで画面を作らない)

Phase 2 — 見本データ(今日の10:40の場面)

Phase 3 — 全体デザインの承認(Codex 第1段)

Phase 4 — 画面(Codex 第2段の画像どおり)

Phase 5 — 仕上げ(はみ出し・速さ・言葉・公開・両サイトへの掲載)

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

  • 消すか残すか迷ったら、残して見えなくする(非表示)。記録は必ず残す
  • 止めるかどうかを機械に決めさせない。候補と理由を出し、人が押す
  • 個人を比べる数字は出さない。掲示板・会社全体の数字だけ
  • 画面の言葉は、総務の人が社員に説明するときの言葉にする

出典(取得日 2026-10-28)

  • 厚生労働省「事業主が職場における優越的な関係を背景とした言動に起因する問題に関して雇用管理上講ずべき措置等についての指針」(令和2年1月15日 厚生労働省告示第5号)https://www.mhlw.go.jp/content/11900000/000584512.pdf — 4(3) 事後の迅速かつ適切な対応(イ 事実関係の確認、ニ 再発防止の措置と社内ホームページ等への掲載の例)、4(4)イ プライバシーの保護
  • 青森労働局(厚生労働省)「職場のパワーハラスメント対策等について」https://jsite.mhlw.go.jp/aomori-roudoukyoku/content/contents/001322052.pdf — 「職場におけるパワーハラスメント対策が令和4年4月1日から中小事業主の義務となりました」

FROM DEMO TO PRODUCTION

本番で使うには、あと4つ必要です

この要件定義書は、画面と動きを確かめるためのデモとして書かれています。「【AI】社内SNS・掲示板」を社内やお客さまに実際に使ってもらうには、見た目の裏側に次の4つが要ります。

  1. 1データの保存

    デモでは
    データはその端末のブラウザの中にしか残りません。ほかの端末やほかの人とは共有されず、消えることもあります。
    本番では
    サーバーのデータベースに保存し、バックアップと復元ができるようにします。
  2. 2セキュリティ

    デモでは
    ログインがなく、誰でもすべての画面とデータを見られます。
    本番では
    ログイン、権限(誰が何を見られるか)、通信とデータの暗号化、不正なアクセスへの対策を入れます。
  3. 3ガバナンス(運用ルール)

    デモでは
    決めていません。
    本番では
    誰がいつ何をしたかの記録、個人情報の扱い(プライバシーポリシー・同意)、アカウントの発行と削除、障害のときの連絡体制を決めます。
  4. 4公開・デプロイ

    デモでは
    手元で動かすか、デモとして公開するだけです。
    本番では
    独自ドメイン、本番とテストの環境分け、更新の手順、監視と障害対応、月々の費用の管理を整えます。

本番運用をお考えの方へ

ぜひ一度ご相談ください。最適なプランのご紹介と、進め方をお伝えします。代表の西澤が直接お話しします。

  • 自分で作ったアプリを、そのまま本番で使いたい
  • どこまで自分で作り、どこから任せるか決めたい
  • 社内の決まりやセキュリティの基準に合わせたい

下のカレンダーから、空いている日時を選ぶだけで予約できます。

料金とプランは、サービス資料(全29ページ)にまとめています。先に質問したいときは、公式LINE か お問い合わせフォーム からもお気軽にどうぞ。

FREE CONSULTATION

分からないときは、お気軽に30分無料相談へ

途中で止まった、エラーが消えない、自社向けに作り変えたい。どんなことでも大丈夫です。

日程を決めて話す

代表の西澤と直接お話しできます。空いている日時を選ぶだけで予約できます。

代表 西澤と話す日程を選ぶ

まずは問い合わせる

要件定義書がほしい方・ご相談は公式LINEから。お問い合わせフォームからも受け付けています。