社内ポータル 要件定義書 v2|Souzoh Portal
2026-09-24 · 西澤志門
00. 改訂方針と本書の読み方
v2は「見せるデモ」だったv1を、社内で実際に運用できる社内ポータルへ作り替える版です。デザインの方向性(ダークインク基調・ベントーグリッド・ガラス質タイル)は据え置き、機能と文字組みの規約を作り込みました。
v1からの主な変更点
| 区分 |
v1 |
v2 |
| 位置づけ |
記事サムネイル用の見栄え重視デモ |
実運用可能な社内ポータル(兼・爆速アプリ開発デモ) |
| 技術基盤 |
Vite + React 18(JSX) |
Next.js 15 + TypeScript strict(HIREBASEシリーズ標準に統一) |
| データ |
永続化なし(リロードで初期化) |
Zustand + persist で永続化。lib/repo/ 経由で後からAPIへ差し替え可能 |
| ロール |
単一ユーザー |
一般・承認者・管理者の3ロール+デモ切替バー |
| 業務機能 |
フィード・お知らせ・名鑑のみ |
申請承認、施設予約、カレンダー、通知、Wiki、管理画面を追加 |
| 要件の書き方 |
章ごとの説明 |
機能ID(F-)・画面ID(SC-)・機能要件ID(FR-)・非機能ID(NFR-)で追跡可能に |
| 文字組み |
言及なし |
05章に「ずれ防止規約」を新設し、受け入れ基準で機械的に検査 |
| 図 |
全角文字入りのASCII罫線図 |
表・Mermaid・grid-template-areas のコードに置換(全角混在で罫線がずれるため) |
IDの体系
| 接頭辞 |
意味 |
例 |
| F- |
機能(スコープ単位) |
F-W03 申請の承認 |
| SC- |
画面 |
SC-400 申請一覧 |
| FR- |
機能要件(実装・テストの単位) |
FR-412 差戻し時は理由を必須 |
| TY- |
文字組み規約 |
TY-03 和欧混植の禁止 |
| NFR- |
非機能要件 |
NFR-04 CLS 0.01以下 |
Claude Codeへの指示とコミットメッセージには必ずIDを含めます(例:feat(workflow): 差戻し処理を実装 (FR-412, FR-413))。
実装者(Claude Code)への前提指示
- 仕様が曖昧・矛盾している場合は推測で実装せず、質問する。
- 15章のフェーズ順に進め、先のフェーズに手を出さない。
- 色・余白・角丸・フォント・アニメーション値は、トークンと
lib/motion.ts 以外に直書きしない。
- コンポーネントからストアを直接参照しない。必ず
lib/repo/ を経由する。
01. 目的・ゴール・スコープ
社員30〜300名規模の会社が、お知らせ・申請・予約・社内の動きを1か所で済ませられるポータルを作ります。成功条件は「メール・紙・チャットで散らばっていた社内手続きの8割が、このアプリ内で完結すること」です。
| 項目 |
内容 |
| プロダクト名 |
Souzoh Portal |
| タグライン |
会社の「いま」が、ひと目で |
| 想定利用者 |
30〜300名規模の中小企業の全社員(PC 7割・スマホ 3割) |
| 一次目的 |
社内の情報・手続きの窓口を1つにまとめる |
| 二次目的 |
爆速アプリ開発のB2Bデモとして、開いて2秒で「自社に欲しい」と思わせる |
| 成功指標 |
必読お知らせの既読率 90%以上/申請の平均承認リードタイム 1営業日以内/週次アクティブ率 80%以上 |
機能一覧:一般社員(全ロール共通)
| ID |
機能 |
概要 |
優先度 |
| F-M01 |
ホームダッシュボード |
ベントーグリッドでKPI・お知らせ・予定・申請状況・在席・称賛を一覧。タイルの表示/非表示と並び順を個人ごとに保存 |
Must |
| F-M02 |
お知らせ閲覧 |
カテゴリ・重要度・未読で絞り込み。必読は「確認しました」ボタンで既読確定 |
Must |
| F-M03 |
社内フィード |
分報・称賛・質問の投稿、拍手、コメント、@メンション、#タグ、画像添付、自分の投稿の編集・削除 |
Must |
| F-M04 |
メンバー名鑑・組織図 |
氏名・かな・スキル検索、部署フィルタ、組織ツリー、メンバー詳細 |
Must |
| F-M05 |
在席ステータス |
在席・会議中・外出・リモート・休暇の5状態と一言メッセージ。自分で変更 |
Must |
| F-M06 |
申請 |
休暇・経費精算・備品購入・汎用稟議の4種を作成、下書き保存、取下げ、再申請 |
Must |
| F-M07 |
施設予約 |
会議室・社用車・備品を15分単位で予約。重複はその場で拒否 |
Must |
| F-M08 |
カレンダー |
全社イベント・自分の予約・承認済み休暇を週/月表示。イベントの出欠回答 |
Must |
| F-M09 |
通知センター |
種別フィルタ、既読管理、通知からの該当画面遷移 |
Must |
| F-M10 |
メッセージ |
1対1・グループのDM、既読表示、未読数バッジ |
Should |
| F-M11 |
社内Wiki・規程集 |
カテゴリ別の文書閲覧、目次、更新履歴、全文検索 |
Should |
| F-M12 |
全社検索(⌘K) |
メンバー・お知らせ・投稿・Wiki・申請メニュー・施設を横断検索 |
Must |
| F-M13 |
マイページ・設定 |
プロフィール編集、通知設定、表示密度、ライト/ダーク切替 |
Must |
機能一覧:承認者(部署リーダー以上)
| ID |
機能 |
概要 |
優先度 |
| F-W01 |
承認待ち一覧 |
自分宛ての申請を期限順に一覧、件数をヘッダーに常時表示 |
Must |
| F-W02 |
申請の承認・差戻し・却下 |
差戻し・却下は理由必須。コメント付き承認も可 |
Must |
| F-W03 |
一括承認 |
休暇申請・3万円以下の経費精算に限り、複数選択して一括承認 |
Should |
| F-W04 |
代理承認者の設定 |
不在期間中の承認を指定メンバーへ委任 |
Should |
| F-W05 |
部署の在席・休暇状況 |
部下の今日の在席と今週の休暇予定を一覧 |
Should |
機能一覧:管理者(管理部)
| ID |
機能 |
概要 |
優先度 |
| F-A01 |
お知らせ配信管理 |
作成・予約配信・対象部署指定・上部固定・既読率確認・未読者へのリマインド |
Must |
| F-A02 |
メンバー管理 |
追加・編集・異動・休職・退職処理、ロール付与 |
Must |
| F-A03 |
部署管理 |
部署の追加・並び替え・親子関係・部署長の設定 |
Must |
| F-A04 |
承認ルート設定 |
申請種別×金額帯ごとの承認段数と承認者 |
Must |
| F-A05 |
施設マスタ管理 |
施設の追加・定員・設備・予約可能時間帯・利用停止 |
Must |
| F-A06 |
KPI入力 |
ホームKPIの月次値を手入力/CSV取込 |
Should |
| F-A07 |
Wiki編集 |
文書の作成・編集・公開範囲・版管理 |
Should |
| F-A08 |
利用状況 |
週次アクティブ率、お知らせ既読率、申請リードタイム |
Could |
| F-A09 |
データ書き出し |
申請一覧・経費一覧をCSVで書き出し(会計ソフト連携の前段) |
Should |
共通・基盤
| ID |
機能 |
概要 |
優先度 |
| F-S01 |
デモ切替バー |
ロール・ペルソナの即時切替、デモリセット、「これはデモです」の明示 |
Must |
| F-S02 |
通知配信 |
アプリ内通知へ配信。メール通知は送信プレビューで再現 |
Must |
| F-S03 |
画像の自動取得 |
ビルド前スクリプトで画像を取得し、3層フォールバックで表示 |
Must |
| F-S04 |
初回ガイド |
初回訪問時に「試せること」を3ステップで案内 |
Should |
作らないもの(Won't have)
| 項目 |
理由・代替 |
| バックエンドAPI・DB・本物の認証・SSO |
デモ版はブラウザ内で完結。lib/repo/ の差し替えで本番化する(03章) |
| 実際のメール送信・プッシュ通知 |
送信プレビューモーダルで再現 |
| 会計ソフト・勤怠システムとの実連携 |
CSV書き出しで代替 |
| 勤怠打刻・給与計算 |
専用SaaSの領域。スコープが膨張するため除外 |
| ファイルの実アップロード(画像以外) |
ファイル名と容量のみ保持 |
| 複数ブラウザ間のデータ共有 |
デモとしては各ブラウザで独立してよい |
| 多言語UI |
日本語のみ |
スコープリスク: 承認ルートは「部署×金額×種別」で組み合わせが爆発しやすい領域です。v2では段数を最大3段、条件を金額帯のみに固定し、それ以外の条件分岐は作りません(10章)。
02. 利用者・ロール・権限
ロールは member(一般)・approver(承認者)・admin(管理者)の3つです。上位ロールは下位の権限をすべて含みます。認証は行わず、デモ切替バーでペルソナを選ぶとそのロールで動きます。
ロール定義
| ロールID |
名称 |
該当者 |
デモのペルソナ |
member |
一般社員 |
全社員 |
m00 あなた(開発部 アプリチーム・エンジニア) |
approver |
承認者 |
部署長・チームリーダー |
m02 菊池 星哉(開発部長) |
admin |
管理者 |
管理部・経営 |
m08 若林 詩織(管理部長・人事総務) |
権限マトリクス
○=可、△=条件付き、-=不可。
| 操作 |
member |
approver |
admin |
| お知らせ閲覧 |
○ |
○ |
○ |
| お知らせ作成・配信 |
- |
△ 自部署宛てのみ |
○ |
| 既読率・未読者の確認 |
- |
△ 自部署宛てのみ |
○ |
| フィード投稿・拍手・コメント |
○ |
○ |
○ |
| 他人の投稿の非表示 |
- |
- |
○(理由必須・履歴に残る) |
| 申請の作成・取下げ |
○ |
○ |
○ |
| 申請の承認・差戻し・却下 |
- |
△ 承認ルートに指名された段のみ |
△ 同左+最終段(管理部確認) |
| 他人の申請の閲覧 |
- |
△ 自部署+自分が承認者の申請 |
○ |
| 施設予約 |
○ |
○ |
○ |
| 他人の予約の取消 |
- |
- |
○(本人に通知) |
| メンバー・部署・施設マスタ編集 |
- |
- |
○ |
| 承認ルート設定 |
- |
- |
○ |
| KPI入力・CSV書き出し |
- |
- |
○ |
| Wiki閲覧 |
○ |
○ |
○ |
| Wiki編集 |
- |
- |
○ |
権限判定は lib/auth/can.ts の純粋関数 can(actor, action, resource) に1本化し、画面とリポジトリの両方から呼びます(FR-020)。ボタンを隠すだけの制御は禁止です。権限のない操作は、リポジトリ層でも ForbiddenError を投げます(FR-021)。
デモ切替バー(F-S01)
画面最上部に高さ36pxで常時固定します。プロダクト本体ではないことを示すため、トークンとは別の配色(黒地 #000・白文字・12px)で描き、本体のタイルと混同させません。
- ペルソナ切替:3名のアバター付きセグメント。切替は即時で、現在の画面に権限があればそのまま留まり、なければホームへ移動する(FR-030)
- 「デモをリセット」:確認ダイアログの後、永続化データを消して初期状態に戻す(FR-031)
- 「これはデモです。入力内容はこのブラウザ内にのみ保存されます」を常時表示(FR-032)
- スマホ幅ではペルソナ名を省略し、アバターのみ表示する
ロールをまたぐ体験(デモの肝)
以下の4つは、ペルソナを切り替えたときに必ずつながっていること。受け入れ基準(16章)で全件を確認します。
- あなたが休暇申請を出す → 菊池に切替 → ヘッダーの承認待ちバッジが1増え、承認待ち一覧の先頭にある(1段目の海野の代理として。14章)
- 菊池が差戻す → あなたに切替 → 通知センターに理由付きで届き、申請が「差戻し」で編集可能になっている
- 若林が必読お知らせを開発部宛てに配信 → あなた・菊池に切替 → ホームとお知らせに未読で出る/若林の既読率画面で、あなたが確認すると既読数が1増える
- あなたが称賛投稿で菊池を宛先にする → 菊池に切替 → 通知が届き、称賛ランキングの数値が1増えている
03. 技術構成・データ永続化・リポジトリ層
Next.js 15 の静的書き出しをCloudflare Pagesに置き、データはブラウザ内(localStorage+IndexedDB)に永続化します。全データアクセスを lib/repo/ に集約し、本番化の際はこの層だけをAPI呼び出しに差し替えます。
技術スタック(固定・勝手に変更しない)
| レイヤ |
技術 |
備考 |
| フレームワーク |
Next.js 15(App Router)/TypeScript strict |
output: 'export' で静的書き出し |
| スタイル |
Tailwind CSS v4 + CSS変数 |
トークンは app/theme.css の @theme に集約 |
| UI基盤 |
Radix UI(Dialog・Popover・DropdownMenu・Tabs・Tooltip) |
a11yを自前実装しない |
| 状態管理 |
Zustand + persist |
通常データは localStorage、画像Blobは IndexedDB(idb-keyval) |
| フォーム |
React Hook Form + Zod |
スキーマは lib/validation/ |
| 日付 |
date-fns(ja)+ @holiday-jp/holiday_jp |
営業日計算に祝日を反映 |
| グラフ |
Recharts |
KPIスパークライン・面グラフ |
| コマンドパレット |
cmdk |
⌘K |
| 並べ替え |
dnd-kit |
ホームタイルの並び替え。キーボード操作対応のため |
| アニメーション |
motion(motion.dev) |
07章で定めた4用途のみ |
| アイコン |
lucide-react |
絵文字のアイコン利用は禁止 |
| フォント |
next/font(自己ホスト) |
05章。外部CDNから読まない |
| テスト |
Vitest / Playwright / axe-core |
文字ずれ検査もPlaywrightで行う(TY-20) |
| ホスティング |
Cloudflare Pages |
|
上記以外のライブラリを入れる前に、必ず提案して承認を得ること。
レイヤ構成
[ app/ , components/ ] UI only. Never touch the store directly.
|
[ lib/repo/*.ts ] All methods async. Permission check here (can()).
|
[ lib/domain/ ] Pure functions: workflow, booking, leave, search
[ lib/auth/can.ts ] Pure function: permission matrix (02)
[ lib/store/*.ts ] Zustand + persist (localStorage / IndexedDB)
|
[ lib/seed/*.ts ] Initial data. Dates are relative to "now".
- リポジトリの全メソッドは中身が同期処理でも
async で定義し、await で呼ぶ(FR-001)
- 失敗は型付きエラーで返す:
ValidationError / ForbiddenError / ConflictError(予約重複・二重承認)/ NotFoundError(FR-002)
- 書き込み系は楽観的更新をしない。リポジトリの成功を待ってから画面を更新する(業務データの誤表示を防ぐため)(FR-003)
- 業務ロジック(承認ルート解決、休暇日数計算、予約重複判定、検索スコア)はすべて
lib/domain/ の純粋関数にし、Vitestで単体テストを書く(FR-004)
永続化の仕様
| 項目 |
仕様 |
| ストアキー |
souzoh-portal:v2:<slice>(例 souzoh-portal:v2:workflow) |
| スキーマ版 |
各スライスに version を持ち、migrate で旧版を変換する。変換できない場合は初期化して通知(FR-010) |
| 容量 |
localStorage 合計 4MB を超えたら、90日より古い通知と既読済みフィードの本文を間引く(FR-011) |
| 画像 |
投稿・プロフィールに添付した画像は長辺1600pxに縮小してIndexedDBへ保存(FR-012) |
| 時刻 |
すべてISO 8601(+09:00)で保存し、表示時にだけ整形する(FR-013) |
| デモリセット |
localStorage の souzoh-portal:* と IndexedDB を削除して再シード(FR-031) |
| タブ間同期 |
storage イベントで他タブの変更を取り込む(FR-014) |
本番化の差し替え方針
本番ではリポジトリ実装をAPIクライアントに置き換え、lib/store/ はキャッシュ用途に縮小します。想定構成はCloudflare Workers+D1、認証はGoogle Workspace/Microsoft 365のSSOです。UI層・lib/domain/・lib/auth/can.ts は変更しません(can() はサーバー側でも同じ関数を使う)。
04. デザイン仕様
v1の「管制室」の質感(ダークインク地・不揃いなガラス質タイル・ライムの差し色)をそのまま継承します。v2での変更は、ライト版トークンの全項目定義、コントロール寸法の固定、業務用ステータス色の追加の3点です。
方向性(v1から継承)
- 暗い地に、わずかに浮いたガラス質のパネルが不揃いなサイズで並ぶ。光が入るのはKPIの数字と差し色だけ
- 中心はベントーグリッド。均一なカードの反復にしない
- 既定はダーク。v2ではマイページでライトへ切り替え可能(F-M13)。ライトは全トークンを差し替えるだけで成立させる
デザイントークン(app/theme.css)
@theme {
/* Base (dark) */
--color-bg: #0B0D12;
--color-surface: #131721;
--color-surface-2: #1B2130;
--color-surface-3: #232B3D;
--color-ink: #EEF1F7;
--color-ink-sub: #8B93A7;
--color-ink-dim: #5A6175;
--color-line: #262E3F;
--color-line-lit: #38425C;
/* Accent */
--color-accent: #C6F24E; /* lime: CTA, current, emphasis */
--color-on-accent: #0B0D12; /* text on lime */
--color-accent-2: #4CC9F0; /* cyan: link, in progress */
--color-accent-3: #F5A623; /* amber: due, warning */
--color-danger: #FF5C6C;
--color-ok: #3DDC97;
/* Status (workflow) */
--color-st-draft: #5A6175;
--color-st-pending: #4CC9F0;
--color-st-returned: #F5A623;
--color-st-approved: #3DDC97;
--color-st-rejected: #FF5C6C;
/* Glass */
--glass-bg: rgb(255 255 255 / .035);
--glass-border: rgb(255 255 255 / .075);
--glass-blur: 18px;
/* Type (see 05) */
--font-jp: var(--font-noto-sans-jp), "Hiragino Sans", "Yu Gothic UI", sans-serif;
--font-latin: var(--font-space-grotesk), var(--font-jp);
--font-num: var(--font-jetbrains-mono), ui-monospace, monospace;
/* Space */
--space-1: 4px; --space-2: 8px; --space-3: 12px; --space-4: 16px;
--space-5: 20px; --space-6: 24px; --space-8: 32px; --space-12: 48px;
/* Control size (see 05, TY-10) */
--h-control-sm: 28px;
--h-control: 36px;
--h-control-lg: 44px; /* mobile tap target */
--h-badge: 20px;
/* Shape */
--radius-tile: 18px;
--radius-inner: 12px;
--radius-pill: 999px;
--shadow-tile: inset 0 1px 0 rgb(255 255 255 / .05), 0 20px 50px rgb(0 0 0 / .45);
--shadow-lift: 0 30px 70px rgb(0 0 0 / .6);
/* Motion (see 07) */
--ease-out: cubic-bezier(.16, 1, .3, 1);
--ease-inout: cubic-bezier(.65, 0, .35, 1);
--dur-fast: 140ms;
--dur-base: 240ms;
--dur-slow: 520ms;
}
ライト版([data-theme="light"] で全項目を上書き)
| トークン |
ダーク |
ライト |
--color-bg |
#0B0D12 |
#F5F6F8 |
--color-surface |
#131721 |
#FFFFFF |
--color-surface-2 |
#1B2130 |
#EFF1F5 |
--color-surface-3 |
#232B3D |
#E6E9EF |
--color-ink |
#EEF1F7 |
#0E1219 |
--color-ink-sub |
#8B93A7 |
#5C6478 |
--color-ink-dim |
#5A6175 |
#8A91A3 |
--color-line |
#262E3F |
#E3E6EC |
--color-line-lit |
#38425C |
#CDD2DC |
--color-accent |
#C6F24E |
#5B39F5 |
--color-on-accent |
#0B0D12 |
#FFFFFF |
--glass-bg |
白 3.5% |
白 72% |
--glass-border |
白 7.5% |
黒 6% |
文字色と背景の組み合わせは、本文 4.5:1以上・大きな数字と見出し 3:1以上を両テーマで満たすこと(NFR-20)。--color-ink-dim は補助表示専用で、本文には使いません。
タイル(components/ui/tile.tsx)
- 背景
--glass-bg + backdrop-filter: blur(var(--glass-blur))、枠 1px --glass-border、角丸 --radius-tile、影 --shadow-tile
- 内側余白は PC 20px / スマホ 16px で固定。タイル見出し行は高さ 24px で固定し、右端にアクション(「すべて見る」など)を置く
- ホバー:
translateY(-2px)、影を --shadow-lift、枠を --color-line-lit へ(--dur-base)
- 背景の下地:右上に
--color-accent を不透明度 6%、左下に --color-accent-2 を 5% で、blur(120px) の楕円として固定配置。スクロールで動かさない
backdrop-filter 非対応環境では --color-surface の単色で代替する
ステータス表示
申請の状態は色だけに頼らず、必ず「色付きドット+文字」で表示します(色覚多様性への配慮)。
| 状態 |
表示名 |
色 |
| draft |
下書き |
--color-st-draft |
| pending |
承認待ち |
--color-st-pending |
| returned |
差戻し |
--color-st-returned |
| approved |
承認済み |
--color-st-approved |
| rejected |
却下 |
--color-st-rejected |
| withdrawn |
取下げ |
--color-st-draft |
やらないこと(NGリスト)
- 紫→ピンクのグラデーションボタン
- 全タイルへの常時の強い影(ホバー時のみ)
- 絵文字をUIアイコンとして使うこと(lucide-reactに統一)
- 角丸の混在(
--radius-tile/--radius-inner/--radius-pill の3種のみ)
- 中央揃えの長文
- 3種を超えるフォント
- ネオン発光の多用(発光は「今月の受注」KPIと在席パルスのみ)
- ライム地に白文字(必ず
--color-on-accent を使う)
05. 文字組み・ずれ防止規約
文字ずれは「フォントの混在」「高さ未固定」「はみ出し」「読み込み時の差し替え」の4つが原因です。本章の TY- 規約で4つを仕様として潰し、Playwrightで機械的に検査します(TY-20〜23)。
v1で起きうるずれと対策
| v1の指定 |
起きるずれ |
v2の対策 |
| 見出しを Space Grotesk → Zen Kaku の順で指定 |
英字と和文で別フォントになり、ベースラインと字面の高さが揃わない |
和文を含む文字列は和文フォント1本(TY-01) |
| ラベルに大文字+letter-spacing .12em をカタカナにも適用 |
カタカナだけ間延びし、行末がタイル右端からはみ出す |
字間は欧文ラベルのみ。和文は 0.04em まで(TY-06) |
| 数字だけ JetBrains Mono、単位「件」「h」は別指定なし |
数字と単位のベースラインがずれる |
数値部品 <Num> で数字と単位を分け、ベースライン揃え(TY-08) |
| ボタン・バッジの高さを行間任せ |
和文フォントの上下余白の差で文字が上下に寄る |
高さをトークンで固定し、行間 1 + flex中央揃え(TY-10) |
| 長い氏名・件名の扱いが未定義 |
グリッドの列幅を押し広げ、タイル間がずれる |
全表示箇所に最大行数を定義(TY-14) |
| Google Fontsを外部読み込み |
読み込み完了時にフォントが差し替わり、行が動く |
next/fontで自己ホスト+代替フォントの寸法補正(TY-04) |
| 要件書内の罫線図に全角文字 |
等幅でないため罫線がずれる |
図は表・Mermaid・コードに置換(本書全体) |
フォント
| ID |
規約 |
| TY-01 |
和文を1文字でも含む文字列は --font-jp(Noto Sans JP)だけで描く。和欧混植(英字だけ別フォント)は行わない |
| TY-02 |
--font-latin(Space Grotesk)は、英字・数字だけで構成される固定文言に限定する。対象はアプリ名「Souzoh Portal」、欧文ラベル(TODAY など)、⌘Kの表記のみ |
| TY-03 |
--font-num(JetBrains Mono)は数値・日時・金額の数字部分にのみ使う。単位・通貨記号・曜日は --font-jp |
| TY-04 |
フォントは next/font で自己ホストし、display: 'swap' と adjustFontFallback を有効にする。Noto Sans JP は 400/500/700 の3ウェイトのみ読み込む |
| TY-05 |
可変フォント軸・font-synthesis による擬似太字は使わない(font-synthesis: none) |
文字サイズと行間(固定値)
可変サイズ(clamp)は見出しとKPIの2つだけに絞り、それ以外はpxで固定します。行間は倍率ではなく実寸で指定し、1行の高さを整数pxにします(小数だと行が0.5px単位でずれるため)。
| 用途 |
サイズ |
行の高さ |
太さ |
字間 |
| ページ見出し |
clamp(24px, 2.2vw, 32px) |
1.25 |
700 |
0 |
| KPI数値 |
clamp(28px, 3.2vw, 44px) |
1 |
500 |
-0.02em |
| タイル見出し |
15px |
24px |
700 |
0 |
| 本文 |
14px |
24px |
400 |
0 |
| 本文(小) |
13px |
20px |
400 |
0 |
| 補助・メタ |
12px |
18px |
400 |
0 |
| ラベル(和文) |
11px |
16px |
500 |
0.04em |
| ラベル(欧文) |
11px |
16px |
500 |
0.12em(大文字) |
| ボタン |
14px |
1(高さはトークン) |
500 |
0 |
| バッジ |
11px |
1(高さ20px) |
500 |
0 |
字間・約物・改行
| ID |
規約 |
| TY-06 |
欧文ラベル以外に 0.04em を超える字間を付けない |
| TY-07 |
font-feature-settings: "palt"(約物詰め)はページ見出しとタイル見出しのみ。本文・表・ボタンには付けない(幅が変わり列が揃わなくなるため) |
| TY-08 |
数値は <Num value unit /> 部品で出す。数字は --font-num + tabular-nums、単位は --font-jp で 0.6em・左に2px空け、親は inline-flex; align-items: baseline |
| TY-09 |
本文は line-break: strict; overflow-wrap: anywhere;。見出しは word-break: auto-phrase(非対応ブラウザでは通常改行) |
高さと中央揃え
| ID |
規約 |
| TY-10 |
ボタン・入力欄・セレクト・タブ・バッジは、高さを --h-control* / --h-badge で固定し、line-height: 1 + display: inline-flex; align-items: center で中央に置く。上下paddingで高さを作らない |
| TY-11 |
アイコンと文字の並びは必ず inline-flex; align-items: center; gap: 6px。アイコンは 16px(小 14px)、flex-shrink: 0。vertical-align での調整は禁止 |
| TY-12 |
対応ブラウザでは text-box: trim-both cap alphabetic をボタン・バッジに付け、字面の上下を揃える(非対応でもTY-10で崩れない) |
| TY-13 |
表の数値列・金額列・日付列は右揃え+tabular-nums。文字列は左揃え。1つの列の中で揃えを混ぜない |
はみ出しと省略
| ID |
規約 |
| TY-14 |
可変長の文字列はすべて最大行数を決め、超えたら省略記号(…)で切る。省略した箇所はホバーとフォーカスで全文をツールチップ表示 |
| TY-15 |
グリッド・flexの子要素には min-width: 0 を付ける(長い文字列で列幅が押し広げられるのを防ぐ) |
| TY-16 |
件数バッジは min-width: 20px、99を超えたら「99+」 |
| TY-17 |
入力の最大文字数はZodとUIで一致させ、残り文字数を表示する(13章の各項目) |
省略ルールの一覧(TY-14)です。
| 表示箇所 |
最大 |
| 氏名(カード・一覧) |
1行 |
| 部署・役職 |
1行 |
| お知らせ件名(一覧・ホーム) |
2行 |
| フィード本文(ホームのタイル内) |
3行 |
| フィード本文(フィード画面) |
8行+「続きを読む」 |
| 申請件名 |
1行 |
| 予定名(カレンダーの週表示) |
2行 |
| スキルタグ |
1行、表示は最大5個+「+N」 |
| 通知本文 |
2行 |
表記ルール
| ID |
規約 |
| TY-18 |
英数字・記号は半角、かっこ・コロンは和文中なら全角に統一。日付は 9月24日(木)(曜日のかっこは半角)、時刻は 09:30(ゼロ埋め) |
| TY-19 |
金額は ¥8,420,000(記号と数字の間に空白なし)、増減は +12.4% / −2.8h(マイナスは U+2212)。0は符号なし |
整形は lib/format/ の関数(formatDate formatYen formatDelta formatDuration)だけで行い、画面側で文字列を組み立てない。
検査(受け入れ基準と連動)
| ID |
検査 |
| TY-20 |
Playwrightで全画面を 390/1024/1440px で開き、scrollWidth > clientWidth の要素が0件であること(省略指定の要素を除く) |
| TY-21 |
同一行に並ぶアイコンと文字、数字と単位の中心座標の差が 1px以内であること |
| TY-22 |
フォント読み込み前後のスクリーンショットで CLS が 0.01以下であること |
| TY-23 |
/dev/typography に最悪ケースの文字列(20文字の氏名、120文字の件名、7桁の金額、「99+」のバッジ、英数字の長い連続)を並べたページを置き、3幅×2テーマで目視とスクリーンショット差分を取る |
06. 画像の自動取得
デモ画像はビルド前にスクリプトで一括取得してローカル配信し、表示は3層フォールバックで必ず何かを映します(v1の方式を継承)。v2では、管理者やメンバーがアップロードした自社画像を最優先で表示する経路を追加します。
方針
- 実行時に外部画像URLを直接参照しない。外部サービスが止まると全画面の画像が同時に壊れるため
- 取得元は
picsum.photos のseed指定URL(https://picsum.photos/seed/{seed}/{w}/{h})。seed固定で毎回同じ画像になる
- 人物の顔写真は取得しない。アバターはメンバーIDから決まる2色グラデーション+頭文字(FR-051)
public/images/ は .gitignore に入れ、配布するのはスクリプトとマニフェストのみ。README冒頭に npm run fetch:images の手順を書く
取得スクリプト(scripts/fetch-images.mjs)
| ID |
要件 |
| FR-040 |
lib/seed/image-manifest.ts を読み、各エントリを public/images/{seed}.jpg に保存する |
| FR-041 |
既存ファイルはスキップ。--force で上書き |
| FR-042 |
同時取得は4本まで |
| FR-043 |
1枚の失敗でビルドを止めない。失敗は1行ログに出して次へ進む |
| FR-044 |
完了時に 取得 18 / スキップ 4 / 失敗 0 の形式でサマリを出力 |
| FR-045 |
package.json の prebuild から自動実行する |
マニフェスト(18枚)
| 用途 |
seed |
サイズ(px) |
| ホームのヒーロー |
portal-hero |
1600×900 |
| お知らせ:全社合宿/新オフィス/表彰 |
news-offsite / news-office / news-award |
1200×800 |
| フィード:作業風景/議論/研修 |
feed-desk / feed-whiteboard / feed-training |
1000×750 |
| フィード:ランチ |
feed-lunch |
1000×1000 |
| フィード:リリース/現場 |
feed-launch / feed-site |
1000×562 |
| 部署カバー:開発/営業/CS/管理 |
team-dev / team-sales / team-cs / team-corp |
800×400 |
| イベント:全社会議/勉強会/歓迎会/1on1週間 |
event-allhands / event-study / event-welcome / event-1on1 |
900×600 |
表示部品(components/ui/smart-image.tsx)
画像の参照は { kind: 'seed', seed, w, h } と { kind: 'upload', blobKey, w, h } の2種類を受け取ります。
| 順 |
参照先 |
使われる場面 |
| 0 |
IndexedDB の Blob(upload のみ) |
利用者がアップロードした画像 |
| 1 |
/images/{seed}.jpg |
通常のデモ画像 |
| 2 |
https://picsum.photos/seed/{seed}/{w}/{h} |
スクリプトを実行し忘れた場合の保険 |
| 3 |
seedから決まる2色グラデーション |
上記すべて失敗しても必ず何かが映る |
- 読み込み完了までは seed由来のグラデーションを敷き、完了時に不透明度 0→1 で
--dur-slow かけて切り替える(FR-046)
width と height を必ず指定し、aspect-ratio でレイアウトシフトを防ぐ(FR-047)
- ファーストビュー外は
loading="lazy" + decoding="async"(FR-048)
- 壊れた画像アイコンは、いかなる場合も表示しない(FR-049)
アップロード(実運用向け)
| ID |
要件 |
| FR-050 |
投稿・お知らせ・プロフィールカバーに画像を添付できる。形式は JPEG/PNG/WebP、1枚10MBまで、投稿は最大4枚 |
| FR-051 |
アバターは写真アップロード可(任意)。未設定時はグラデーション+頭文字 |
| FR-052 |
取り込み時に長辺1600pxへ縮小し、EXIF(位置情報を含む)を除去してから保存する |
| FR-053 |
形式・容量エラーは「10MBを超えています。圧縮するか別の画像を選んでください」のように原因と対処を表示 |
07. 動きの仕様
動きはv1の14種を継承し、業務操作の手応えを返す2種を加えた16種に確定します。全数値は lib/motion.ts に定数として置き、JSXに数値を書きません。
原則
- 動かすのは「出現」「状態変化」「因果」の3つだけ
- 動かすプロパティは
transform と opacity のみ。width height top margin font-size をアニメーションさせない(文字の再配置が起きるため)。例外は組織図の展開(#12)だけ
- 主要な動きは
--dur-base、退場は入場の0.6倍、大きな移動のみ --dur-slow
prefers-reduced-motion: reduce で下表の「停止」がすべて止まること(NFR-30)
- マイページの「動きを減らす」設定でも同じ状態にする(F-M13)
動きの一覧(16種)
| # |
名称 |
対象 |
仕様 |
動きを減らす時 |
| 1 |
段差入場 |
ホームの全タイル |
下から16px+不透明度0→1、520ms、60ms差(最大12枚) |
停止(即表示) |
| 2 |
KPIカウントアップ |
KPI4枚の数値 |
0→目標値、900ms、--ease-out |
停止(最終値) |
| 3 |
スパークライン描画 |
KPIタイル |
stroke-dashoffset で左から1100ms |
停止(完成形) |
| 4 |
スクロール連動表示 |
ホーム下部・フィード |
画面下20%に入ったら下から24px+フェード、520ms |
停止 |
| 5 |
タイルのホバー浮上 |
全タイル |
translateY(-2px)+影+枠色、240ms |
影のみ |
| 6 |
画面遷移 |
全ページ |
View Transitions API でクロスフェード+4px上移動、240ms |
即時切替 |
| 7 |
共有要素モーフ |
名鑑→メンバー詳細 |
アバターと氏名が連続移動 |
停止 |
| 8 |
⌘Kパレット |
SC-900 |
背景 blur 0→10px、パネル scale .96→1、240ms |
フェードのみ |
| 9 |
検索結果の入れ替え |
SC-900 |
各行20ms差でスライドイン、入力デバウンス120ms |
停止 |
| 10 |
拍手 |
フィード |
ライムの粒8個が放射し600msで消える+数字が縦スライド |
数字のみ変化 |
| 11 |
在席パルス |
在席ドット |
2.4秒周期でゆっくり明滅 |
停止 |
| 12 |
組織図の展開 |
SC-310 |
高さアニメ+子の段差入場40ms差 |
即展開 |
| 13 |
進捗リング |
ホーム「今月の目標」 |
stroke-dashoffset で0→達成率、1200ms |
完成形 |
| 14 |
トースト |
全体 |
右下から16px上+フェード、4秒で自動退場、ホバー中は停止 |
フェードのみ |
| 15 |
承認完了 |
承認詳細 |
ステータスバッジが色替え+チェックアイコンが描画、400ms、一覧から該当行が左へ退場 |
色替えのみ |
| 16 |
予約確定 |
施設予約タイムライン |
仮枠(破線)が実枠に変わり、枠がわずかに拡大縮小(scale 1→1.02→1)、320ms |
色替えのみ |
文字を揺らさないための追加要件
| ID |
要件 |
| FR-060 |
カウントアップ中は、最終値の文字列で幅を確保した透明な要素を下敷きにし、表示中の数値はその上に重ねる。桁が増えても周囲が動かないこと |
| FR-061 |
3桁区切りのカンマもカウント中から表示する(¥8,4 のように途中でカンマが消えない) |
| FR-062 |
拍手数・未読数など数字が変わる箇所は tabular-nums とし、桁が増える場合のみ幅を変える |
| FR-063 |
段差入場中もグリッドの最終配置は確定済みとし、要素の出現で他タイルの位置が変わらないこと |
ファーストビューの演出(2.0秒で完結)
| 経過時間 |
出来事 |
| 0ms |
背景グラデーションのみ |
| 120ms |
ヘッダーとサイドナビがフェードイン |
| 200ms |
ヒーロータイルが下から入場 |
| 260ms |
KPIタイル4枚が60ms差で入場(#1) |
| 400ms |
KPIのカウントアップとスパークライン描画を同時に開始(#2・#3) |
| 900ms |
残りのタイルが60ms差で入場 |
| 1400ms |
全タイル着地 |
| 2000ms |
完了。以降は在席パルス(#11)のみ継続 |
演出は1セッションにつき初回のホーム表示のみ。2回目以降のホーム遷移ではタイルを即表示し、数値のみ#2を300msで再生します(業務で毎回2秒待たせないため、FR-064)。
motion ライブラリの使用範囲
使ってよいのは #7 共有要素モーフ、#8 パレット、#10 拍手、#12 組織図 の4つだけです。それ以外はCSS・Web Animations API・View Transitions APIで実装します。
08. 画面一覧・ルーティング・共通シェル
画面は利用者向け20・管理者向け10の計30です。静的書き出しでは利用者が作ったデータの詳細ページを事前生成できないため、詳細画面はクエリ文字列 ?id= で受け取ります。
利用者向け画面
| 画面ID |
画面 |
パス |
ロール |
機能ID |
| SC-000 |
ホーム |
/ |
全員 |
F-M01 |
| SC-100 |
お知らせ一覧 |
/notices |
全員 |
F-M02 |
| SC-101 |
お知らせ詳細 |
/notices/view?id= |
全員 |
F-M02 |
| SC-200 |
フィード |
/feed |
全員 |
F-M03 |
| SC-201 |
投稿詳細(コメント) |
/feed/view?id= |
全員 |
F-M03 |
| SC-202 |
投稿作成 |
シート(どの画面からも) |
全員 |
F-M03 |
| SC-300 |
メンバー名鑑 |
/members |
全員 |
F-M04 |
| SC-301 |
メンバー詳細 |
/members/view?id= |
全員 |
F-M04 |
| SC-310 |
組織図 |
/members/org |
全員 |
F-M04 |
| SC-400 |
申請一覧(自分の申請) |
/requests |
全員 |
F-M06 |
| SC-401 |
申請作成・編集 |
/requests/new?type= / /requests/edit?id= |
全員 |
F-M06 |
| SC-402 |
申請詳細 |
/requests/view?id= |
申請者・承認者・管理者 |
F-M06, F-W02 |
| SC-410 |
承認待ち一覧 |
/approvals |
approver 以上 |
F-W01, F-W03 |
| SC-500 |
施設予約 |
/bookings |
全員 |
F-M07 |
| SC-600 |
カレンダー |
/calendar |
全員 |
F-M08 |
| SC-700 |
メッセージ |
/messages / /messages/view?id= |
全員 |
F-M10 |
| SC-750 |
Wiki・規程集 |
/wiki / /wiki/view?id= |
全員 |
F-M11 |
| SC-800 |
通知センター |
右ドロワー(どの画面からも) / /notifications |
全員 |
F-M09 |
| SC-850 |
マイページ・設定 |
/me / /me/settings |
全員 |
F-M05, F-M13 |
| SC-900 |
全社検索(⌘K) |
オーバーレイ |
全員 |
F-M12 |
管理者向け画面
| 画面ID |
画面 |
パス |
ロール |
機能ID |
| SC-A00 |
管理ホーム |
/admin |
admin |
— |
| SC-A10 |
お知らせ配信一覧・既読率 |
/admin/notices |
admin(approver は自部署宛てのみ) |
F-A01 |
| SC-A11 |
お知らせ作成・編集 |
/admin/notices/edit?id= |
同上 |
F-A01 |
| SC-A20 |
メンバー管理 |
/admin/members |
admin |
F-A02 |
| SC-A21 |
部署管理 |
/admin/departments |
admin |
F-A03 |
| SC-A30 |
承認ルート設定 |
/admin/routes |
admin |
F-A04, F-W04 |
| SC-A40 |
施設マスタ |
/admin/facilities |
admin |
F-A05 |
| SC-A50 |
KPI入力 |
/admin/kpi |
admin |
F-A06 |
| SC-A60 |
Wiki編集 |
/admin/wiki |
admin |
F-A07 |
| SC-A70 |
利用状況・書き出し |
/admin/insights |
admin |
F-A08, F-A09 |
共通シェル
| 部位 |
PC(1280px以上) |
タブレット(769〜1279px) |
スマホ(768px以下) |
| デモ切替バー |
上端 36px 固定 |
同左 |
同左(アバターのみ) |
| ヘッダー |
高さ 56px。左にパンくず、中央に検索窓(⌘K表示)、右に承認待ち・通知・アバター |
同左(検索はアイコン化) |
高さ 52px。検索・通知・アバターのみ |
| ナビゲーション |
左サイドナビ 232px(アイコン+文字) |
左アイコンレール 72px(ホバーで文字をツールチップ) |
下部タブバー 5項目(高さ 56px+セーフエリア) |
| 本文の最大幅 |
1440px(中央寄せ)。一覧系は 1120px |
可変 |
可変、左右余白 16px |
サイドナビの並び:ホーム/お知らせ/フィード/申請/承認(approver以上)/施設予約/カレンダー/メンバー/メッセージ/Wiki、区切り線の下に管理(admin)。スマホのタブバーは ホーム/お知らせ/申請/予約/メニュー(残りを格納)。
ヘッダーの状態表示
| ID |
要件 |
| FR-070 |
承認待ち件数(自分宛て)をバッジで表示。0件ならバッジを出さない |
| FR-071 |
通知ベルに未読数。クリックで通知ドロワー(SC-800)を右から開く |
| FR-072 |
アバターのメニューに 在席ステータス変更・マイページ・設定・テーマ切替 |
| FR-073 |
必読お知らせが未読のとき、ヘッダー直下に1行の帯「必読のお知らせが2件あります」を出す。確認すると消える |
全画面共通の状態
| 状態 |
表示 |
| 読み込み中 |
実際のレイアウトと同寸のスケルトン(文字の行数も一致させ、表示時にずれない) |
| 空(初めて) |
何ができるかの説明+最初の操作ボタン(例:「まだ申請はありません」+「休暇を申請する」) |
| 空(絞り込み結果0件) |
条件をクリアするボタン |
| エラー |
原因と次の行動。再試行ボタン |
| 権限なし |
「この画面は管理者のみ閲覧できます」+ホームへ戻る |
| 保存中 |
押したボタンをスピナー付きの無効状態に。ボタン幅は変えない(文言の横にスピナーを置く場合も幅を固定) |
文言の規約
| 原則 |
良い例 / 悪い例 |
| ボタンは「何が起きるか」 |
○ 申請を送信 / × 送信・OK |
| 操作名を最後まで変えない |
「差し戻す」→ トーストも「差し戻しました」 |
| エラーは原因と対処 |
○ 10:00〜11:00 は「会議室A」が予約済みです。別の時間か部屋を選んでください |
| 謝罪しない |
× 申し訳ございませんが… |
| システム語を使わない |
○ 取り下げる / × ステータスを withdrawn に変更 |
| 必須表示 |
「必須」バッジ。※印は使わない |
| ラベル |
プレースホルダをラベル代わりにしない |
| 取り消せない操作 |
確認ダイアログで対象名を明示し、実行ボタンに動詞を書く(「予約を取り消す」) |
09. 各画面の詳細仕様
各画面は「表示要素」「操作」「機能要件(FR-)」の順で定義します。申請・予約・カレンダー・通知は10〜11章、管理画面は12章に分けています。
SC-000 ホーム(ベントーダッシュボード)
ホームは上段(ヒーロー+KPI)を固定、下段の7タイルを個人ごとに並べ替え・非表示できる構成にします。罫線図は全角文字でずれるため、配置は grid-template-areas とサイズ表で定義します。
上段(PC 1280px以上、12列、行の高さ 150px、間隔 16px):
.home-top {
display: grid;
grid-template-columns: repeat(12, minmax(0, 1fr));
grid-template-rows: repeat(2, 150px);
gap: 16px;
grid-template-areas:
"hero hero hero hero hero hero k1 k1 k1 k2 k2 k2"
"hero hero hero hero hero hero k3 k3 k3 k4 k4 k4";
}
下段(12列、行の高さ 116px、grid-auto-flow: row dense):
| タイルID |
内容 |
幅×高さ(列×行) |
既定の順 |
ロール |
todo |
自分のやること |
4×3 |
1 |
全員 |
feed |
社内フィード(直近5件) |
8×3 |
2 |
全員 |
notice |
お知らせ(未読優先で5件) |
4×2 |
3 |
全員 |
goal |
今月の目標(進捗リング) |
4×2 |
4 |
全員 |
schedule |
今日と明日の予定・空き会議室 |
4×2 |
5 |
全員 |
presence |
在席メンバー |
6×2 |
6 |
全員 |
praise |
称賛ランキング |
6×2 |
7 |
全員 |
タブレット(6列)では上段をヒーロー6列+KPI 3列×2段に、下段の幅は min(元の幅, 6) に丸めます。スマホは1列縦積みで、KPIのみ2列、並びは ヒーロー→KPI→やること→お知らせ→予定→フィード→その他です。
タイルの中身
| タイル |
表示 |
操作 |
| ヒーロー |
今週のハイライト(管理者が設定した特集お知らせ)の写真・件名2行・配信日。写真の下から --color-bg へのグラデーションを重ね、文字のコントラスト 4.5:1 を確保 |
「詳しく見る」で SC-101 |
| KPI×4 |
今月の受注・稼働プロジェクト・新規問い合わせ・平均残業。数値+単位(TY-08)、前月比、6か月のスパークライン |
タイルのクリックで KPI詳細ポップオーバー(月別の表) |
| やること |
承認待ち(approver以上)、差戻された自分の申請、未読の必読お知らせ、今日の自分の予約、出欠未回答のイベント。種別アイコン+件名1行+期限。0件なら「やることはすべて完了しています」 |
行クリックで該当画面へ |
| フィード |
投稿者アバター・氏名・種別ラベル・本文3行・拍手数。タイル内で縦スクロール |
拍手はその場で可。「すべて見る」で SC-200 |
| お知らせ |
未読を先頭に5件。必読は左端にライムの縦線、未読ドット |
行クリックで SC-101 |
| 今月の目標 |
管理者が設定した全社目標1件の達成率(進捗リング)、目標値と実績値 |
なし |
| 予定 |
今日と明日の自分の予定(予約・承認済み休暇・参加イベント)、現在時刻以降に空いている会議室の数 |
「空き会議室を予約」で SC-500 |
| 在席 |
在席中のアバターを並べ、状態ドット。12/28名 表示 |
アバターのホバーで氏名と一言、クリックで SC-301 |
| 称賛ランキング |
今月の称賛獲得数トップ5。1位のみ数値を大きく |
行クリックで SC-301 |
| ID |
要件 |
| FR-100 |
「ホームを編集」で編集モードに入り、下段タイルをドラッグ(またはキーボードの矢印)で並べ替え、目のアイコンで表示・非表示を切り替えられる。上段は固定 |
| FR-101 |
編集結果はメンバーごとに保存し、「初期配置に戻す」で既定に戻せる |
| FR-102 |
ヒーローとKPIは管理者の設定値を表示する。未設定時はヒーローを「今週のお知らせはまだありません」、KPIを「—」で表示し、レイアウトは崩さない |
| FR-103 |
やることタイルの件数は、ヘッダーのバッジ・各画面の件数と常に一致させる(同じリポジトリ関数から取得) |
SC-100 お知らせ一覧 / SC-101 お知らせ詳細
| 区分 |
仕様 |
| 絞り込み |
タブ:すべて/未読/必読。カテゴリ(人事・総務・システム・イベント・全社)の複数選択。キーワード |
| 並び順 |
上部固定 → 未読の必読 → 配信日の新しい順 |
| 一覧の行 |
必読の縦線、未読ドット、カテゴリラベル、件名2行、配信者、配信日、添付あり・画像ありアイコン |
| 詳細 |
カバー画像、件名、カテゴリ、配信者、配信日、対象(全社/部署名)、本文(Markdown:見出し・箇条書き・リンク・太字のみ)、添付ファイル一覧 |
| 必読 |
本文の末尾に「内容を確認しました」ボタン。押すまで既読にならない。押した日時を表示 |
| 通常 |
詳細を開いた時点で既読 |
| ID |
要件 |
| FR-150 |
自分が配信対象外のお知らせは一覧・検索・通知のいずれにも出さない |
| FR-151 |
確認期限のある必読は、期限3日前から「あと3日」の琥珀色ラベル、期限超過で赤ラベル |
| FR-152 |
添付ファイルはファイル名・形式・容量を表示し、クリックで「デモのためダウンロードはできません」のトースト |
| FR-153 |
既読状態の変更はホームの未読数・ヘッダー帯・通知に即時反映 |
| FR-154 |
前後のお知らせへ移動するリンクを詳細の下部に置く |
SC-200 フィード / SC-201 投稿詳細 / SC-202 投稿作成
| 区分 |
仕様 |
| タブ |
全社/自部署/フォロー中(フォローはメンバー詳細から) |
| 投稿種別 |
分報(シアン)・称賛(ライム)・質問(グレー)。お知らせはフィードに流さない |
| 投稿カード |
アバター、氏名、部署、種別ラベル、経過時間、本文(8行で省略)、画像最大4枚のグリッド、#タグ、拍手ボタンと数、コメント数 |
| 称賛 |
宛先メンバー(最大5名)のアバターを本文上に並べ、会社の行動指針タグ(挑戦/誠実/共創 の3種から1つ)を付ける |
| 質問 |
「解決済み」を投稿者が付けられる。付けるとコメントの1件を「ベストアンサー」に指定可 |
| コメント |
1階層のみ(返信のネストなし)。@メンション可。自分のコメントは編集・削除可 |
| 作成 |
種別を先に選ぶ → 称賛なら宛先選択 → 本文(1〜1,000字、残り文字数表示)→ 画像(任意)→ 投稿 |
| ID |
要件 |
| FR-200 |
@ 入力でメンバー候補をかな・氏名の前方一致で表示し、選択するとメンションになる。メンションされた人に通知 |
| FR-201 |
# で始まる語をタグとして抽出し、タグのクリックでそのタグの投稿に絞り込む |
| FR-202 |
拍手は1人1投稿につき1回、もう一度押すと取り消し。自分の投稿には押せない |
| FR-203 |
自分の投稿は24時間以内なら編集可(「編集済み」表示)、削除はいつでも可(確認ダイアログ) |
| FR-204 |
管理者は投稿を非表示にできる(理由必須)。投稿者には理由付きで通知し、投稿者本人には「非表示にされた投稿」として残る |
| FR-205 |
作成途中の内容は自動で下書き保存し、シートを閉じても次回開いたときに復元する |
| FR-206 |
新着はポーリングせず、画面上部に「新しい投稿が3件あります」の帯を出し、押すと先頭に読み込む(読んでいる位置がずれないように) |
| FR-207 |
称賛の宛先に自分は選べない。称賛の件数は称賛ランキングに即時反映 |
SC-300 メンバー名鑑 / SC-301 メンバー詳細 / SC-310 組織図
| 区分 |
仕様 |
| 名鑑の絞り込み |
キーワード(氏名・かな・スキル・一言)、部署、在席状態、役職 |
| 名鑑の表示 |
カードグリッド(PC 4列・タブレット 3列・スマホ 2列)とリスト表示の切替。カードは アバター・氏名・かな・部署・役職・在席ドット・スキルタグ最大3個 |
| 並び順 |
部署の並び順 → 役職の序列 → かな順。キーワード検索時は一致度順 |
| 詳細 |
部署カバー画像、アバター、氏名、かな、部署、役職、入社年月、内線、社用メール、在席状態と一言、上長、部下、「できること」スキルタグ、自己紹介(300字)、直近の投稿3件、今月受けた称賛3件 |
| 詳細の操作 |
メッセージを送る(SC-700)、フォローする、称賛を送る(宛先入りで SC-202) |
| 組織図 |
会社→部署→チームの3階層ツリー。各部署に部署長・人数・在席数。部署をクリックでメンバーを展開(#12) |
| ID |
要件 |
| FR-300 |
かな検索はひらがな・カタカナ・半角カナを同一視し、部分一致で検索する |
| FR-301 |
退職者は名鑑・検索・メンション候補に出さない。過去の投稿では氏名の横に「退職」と表示 |
| FR-302 |
休職者は名鑑に出すが、在席状態を「休職中」で固定し、メンションと承認者指定の候補から外す |
| FR-303 |
組織図は部署マスタ(F-A03)の親子関係と並び順から生成し、階層は最大3段 |
| FR-304 |
名鑑の絞り込み条件はURLのクエリに持ち、共有・戻る操作で復元できる |
SC-750 Wiki・規程集
| 区分 |
仕様 |
| 一覧 |
カテゴリ(就業規則・経費・IT・入社手続き・社内ルール)別の文書リスト。最終更新日・更新者 |
| 詳細 |
本文(Markdown:見出し2〜3・箇条書き・表・リンク・コード)、右側に見出しから作る目次(PCのみ、スクロールに追従)、更新履歴(版・日付・更新者・変更概要) |
| 検索 |
件名と本文の全文検索。一致箇所の前後30字を抜粋して表示 |
| ID |
要件 |
| FR-750 |
公開範囲(全社/部署指定)外の文書は一覧・検索に出さない |
| FR-751 |
「この文書は役に立ちましたか」の はい/いいえ を集計し、管理者の編集画面に表示 |
| FR-752 |
申請作成画面から関連する規程へリンクする(例:経費精算 → 経費規程) |
SC-700 メッセージ
| 区分 |
仕様 |
| 一覧 |
スレッド(1対1・グループ)を最終メッセージの新しい順。未読数、最終メッセージ1行 |
| スレッド |
吹き出し(自分は右・相手は左)、日付の区切り、既読(1対1は「既読」、グループは「既読 3」) |
| 入力 |
1〜2,000字。Enterで改行、⌘Enter/Ctrl+Enterで送信(設定で入れ替え可) |
| ID |
要件 |
| FR-700 |
グループは3〜20名。作成者が名前を付ける |
| FR-701 |
デモでは相手からの返信を送信1.2秒後に定型文で自動生成する。相手が外出・休暇なら返信しない |
| FR-702 |
送信したメッセージは5分以内なら取り消せる(「メッセージを取り消しました」を残す) |
SC-850 マイページ・設定
| 区分 |
仕様 |
| プロフィール |
アバター画像、自己紹介、スキルタグ(最大10個・各20字)、内線 |
| 在席ステータス |
在席/会議中/外出/リモート/休暇 と一言(40字)、「◯時に自動で在席に戻す」 |
| 通知設定 |
種別ごと(お知らせ・申請・承認・メンション・称賛・予約・イベント)に アプリ内/メール(プレビュー)のオンオフ |
| 表示 |
テーマ(ダーク/ライト/OSに合わせる)、表示密度(標準/詰める)、動きを減らす |
| 休暇残日数 |
年次有給の付与日数・使用日数・申請中・残り、次回付与日 |
| ID |
要件 |
| FR-850 |
承認済みの休暇期間中は在席ステータスを自動で「休暇」にし、期間終了の翌営業日に在席へ戻す |
| FR-851 |
表示密度「詰める」ではタイル内余白と行の高さを1段階小さくする。フォントサイズは変えない(05章の表を2セット持つ) |
| FR-852 |
設定はすべてメンバーごとに保存し、ペルソナ切替で切り替わる |
SC-900 全社検索(⌘K)
| 区分 |
仕様 |
| 起動 |
⌘K / Ctrl+K、ヘッダーの検索窓のクリック、/ キー(入力欄にフォーカスがないとき) |
| 対象 |
メンバー・お知らせ・投稿・Wiki・施設・申請メニュー・画面(「承認待ち」「会議室を予約」など) |
| 表示 |
カテゴリ別にグループ化、各カテゴリ最大5件、種別アイコン、一致箇所の強調 |
| 入力が空 |
最近開いたもの5件、クイック操作3件(休暇を申請/会議室を予約/投稿する) |
| 0件 |
「◯◯」に一致する結果はありません、と表示し、表記ゆれを吸収した近い候補を出す |
| 操作 |
↑↓で移動、Enterで開く、⌘Enterで新しいタブ、Escで閉じる。キーボードのみで完結 |
| ID |
要件 |
| FR-900 |
検索は lib/domain/search.ts に集約し、ひらがな・カタカナ・全角半角・大文字小文字を正規化して照合する |
| FR-901 |
スコアは 完全一致 > 前方一致 > 部分一致、同点は更新の新しい順 |
| FR-902 |
権限・配信対象外の項目は検索結果に出さない(FR-150、FR-750と同じ判定関数を使う) |
| FR-903 |
「休暇」と打つと申請メニュー「休暇を申請」が先頭に出るよう、操作語の同義語辞書を lib/domain/search-synonyms.ts に持つ |
10. 業務機能:申請・承認ワークフロー
申請は休暇・経費精算・備品購入・汎用稟議の4種、承認は最大3段・条件は金額帯のみで固定します。承認ルートの解決・休暇日数・状態遷移はすべて lib/domain/workflow/ の純粋関数で実装し、単体テストで全パターンを固めます。
状態遷移
stateDiagram-v2
[*] --> draft: 作成
draft --> pending: 送信
draft --> [*]: 削除
pending --> pending: 承認(次の段へ)
pending --> approved: 最終段で承認
pending --> returned: 差戻し
pending --> rejected: 却下
pending --> withdrawn: 取下げ
returned --> pending: 修正して再送信
returned --> withdrawn: 取下げ
approved --> [*]
rejected --> [*]
withdrawn --> [*]
差戻しは申請者が修正して再送信でき、再送信すると承認は1段目からやり直しです。却下は終了状態で、同じ内容を出し直すには複製して新規作成します。
申請種別と入力項目
| 種別 |
入力項目(太字は必須) |
主なチェック |
| 休暇 |
休暇種別(年次有給/特別休暇/代休/欠勤)、開始日、終了日、取得単位(全日/午前半休/午後半休)、理由(年次有給は任意・それ以外は必須、200字)、引き継ぎ先 |
日数は土日・祝日・会社休日を除いて自動計算。年次有給は残日数を超えられない |
| 経費精算 |
件名、明細(1〜20行:利用日・科目・金額・支払先・摘要)、領収書画像、交際費は参加者と人数 |
利用日は申請日から90日以内。1明細 1〜1,000,000円 |
| 備品購入 |
品名、数量(1〜99)、単価、購入先URL、希望納期、用途 |
合計金額を自動計算。希望納期は申請日の3営業日後以降 |
| 汎用稟議 |
件名、金額(0可)、目的、期待効果、実施時期、添付 |
目的 20〜2,000字 |
経費の科目は 交通費/会議費/交際費/消耗品費/新聞図書費/通信費/研修費/その他 の8つです。1明細 5,000円以上、または交際費は、領収書の添付を必須にします(FR-420)。
承認ルート(既定値・管理者が SC-A30 で変更可能)
| 種別 |
金額帯 |
1段目 |
2段目 |
3段目 |
| 休暇 |
— |
部署長 |
— |
— |
| 経費精算 |
30,000円未満 |
部署長 |
管理部(経理) |
— |
| 経費精算 |
30,000円以上 |
部署長 |
代表 |
管理部(経理) |
| 備品購入 |
50,000円未満 |
部署長 |
管理部(総務) |
— |
| 備品購入 |
50,000円以上 |
部署長 |
代表 |
管理部(総務) |
| 汎用稟議 |
— |
部署長 |
代表 |
管理部 |
承認者は「部署長」「代表」のような役割で指定し、申請時点の組織から実在の人に解決します。解決した承認者は申請に記録し、送信後に組織が変わっても変えません(FR-401)。
承認ルート解決のルール
| ID |
要件 |
| FR-400 |
送信時に種別と合計金額からルートを選び、各段の承認者を解決する。解決結果を送信前の確認画面に表示する |
| FR-401 |
解決した承認者は申請に固定する(送信後の異動の影響を受けない) |
| FR-402 |
申請者本人が承認者になる段は、その段を1つ上の部署長へ繰り上げる。繰り上げ先がいなければ代表とする。代表本人の申請で代表段に当たる場合はその段を省略する |
| FR-403 |
同じ人が連続する段の承認者になった場合は、1回の承認で両方の段を通過させる |
| FR-404 |
承認者に代理承認者が設定され、今日がその期間内なら、代理承認者にも同じ権限で表示する。承認記録には「代理:◯◯」と残す |
| FR-405 |
承認者が休職・退職になった場合、管理者の画面に「承認者不在の申請」として表示し、管理者が付け替えられる |
承認の操作
| ID |
要件 |
| FR-410 |
承認者は 承認/差戻し/却下 を選ぶ。承認はコメント任意(200字) |
| FR-411 |
承認・差戻し・却下のボタンは、今の段の承認者(と代理)にだけ表示し、リポジトリでも同じ判定をする |
| FR-412 |
差戻しと却下は理由を必須とする(10〜500字) |
| FR-413 |
差戻し時、申請者には理由付きで通知し、申請を編集可能にする。承認履歴は消さない |
| FR-414 |
同じ申請を別タブで同時に処理した場合、後の操作は ConflictError とし「この申請はすでに承認されています」と表示する(申請ごとに version を持つ) |
| FR-415 |
一括承認(F-W03)は 休暇、および合計30,000円未満の経費精算に限る。選択した件数と合計金額を確認ダイアログに表示する |
| FR-416 |
送信から2営業日を過ぎても処理されない段は「期限超過」として承認者の一覧で赤表示し、承認者に1日1回まで通知する |
申請者の操作
| ID |
要件 |
| FR-420 |
経費の領収書必須条件(1明細5,000円以上、または交際費)を満たさないと送信できない |
| FR-421 |
下書きは自動保存(入力が止まって2秒後)し、一覧の「下書き」タブに残る |
| FR-422 |
承認待ちの間は、最終承認前ならいつでも取下げできる(理由任意)。取下げ後は編集不可 |
| FR-423 |
却下・取下げ・承認済みの申請は「複製して新規作成」ができる |
| FR-424 |
申請詳細には 承認ルート(段ごとの承認者・状態・日時・コメント)を縦のタイムラインで表示する |
| FR-425 |
休暇の日数計算は lib/domain/workflow/leave.ts。半休は0.5日。期間内の土日・祝日(@holiday-jp)・会社休日(管理者が設定)を除く |
| FR-426 |
年次有給の残日数は「付与 − 使用済み − 承認待ち中」で計算し、申請画面に表示する。残日数を超える場合は送信できない |
| FR-427 |
休暇の開始日が申請日から3営業日未満の場合、送信はできるが「直前の申請です。承認者へ口頭でも伝えてください」と警告する |
| FR-428 |
同じ日に重なる休暇申請(承認待ち・承認済み)があれば送信できない |
画面
| 画面 |
仕様 |
| SC-400 申請一覧 |
タブ:すべて/下書き/承認待ち/差戻し/完了。行は 種別アイコン・件名1行・金額または日数・申請日・状態(ドット+文字)・現在の段(例「2/3 代表」)。右上に「新しい申請」メニュー(4種) |
| SC-401 申請作成 |
1画面フォーム。右側(スマホは下部)に 承認ルートのプレビュー、休暇なら残日数、経費なら合計金額を常時表示。送信前に確認画面 |
| SC-402 申請詳細 |
入力内容、添付、承認ルートのタイムライン、コメント。承認者が開いた場合は下部に固定の操作バー(承認/差戻し/却下) |
| SC-410 承認待ち |
自分宛ての申請を期限の近い順。種別・部署で絞り込み。チェックボックスで一括承認(対象外の行はチェック不可、理由をツールチップ) |
完了後の連動
| ID |
要件 |
| FR-430 |
休暇が承認されたら、申請者のカレンダーに休暇予定を作り、部署の予定表にも表示する |
| FR-431 |
経費精算・備品購入が承認されたら、管理者の書き出し対象(F-A09)に加える |
| FR-432 |
承認済みの休暇を取り消すには「取消申請」を出し、1段目の承認者が承認すると休暇予定を削除し残日数を戻す |
11. 業務機能:施設予約・カレンダー・通知
施設予約は15分単位・重複不可、カレンダーは予約・休暇・全社イベントを1つに重ね、通知は14種類の発生条件を固定します。予約の重複判定は lib/domain/booking.ts の純粋関数で行います。
SC-500 施設予約
| 区分 |
仕様 |
| 表示 |
日付を選び、縦軸に施設・横軸に時刻(8:00〜21:00)のタイムライン。予約済み枠に予約者と件名。スマホは施設を1つ選んで縦の時間割 |
| 絞り込み |
種別(会議室/集中ブース/社用車/備品)、定員(◯名以上)、設備(モニター・Web会議機材・ホワイトボード) |
| 予約操作 |
空き枠をドラッグして範囲選択 → 予約ダイアログ(件名・参加者・繰り返し・メモ)。ダイアログから時刻と施設の変更も可 |
| 自分の予約 |
右側(スマホは別タブ)に今日以降の自分の予約一覧。変更・取消 |
| ID |
要件 |
| FR-500 |
予約は15分単位。開始 < 終了、予約可能時間帯(施設ごと、既定 8:00〜21:00)の内側であること |
| FR-501 |
1回の予約は最長4時間(大会議室・セミナールームは8時間、社用車は終日可) |
| FR-502 |
予約できるのは60日先まで。過去の時刻は選べない |
| FR-503 |
同じ施設の予約同士は重ねられない。判定は半開区間(終了時刻ちょうどに次の予約を始められる)。重複時は ConflictError で、重なる予約の時刻と予約者を表示する |
| FR-504 |
参加者の人数が定員を超える場合は送信できない |
| FR-505 |
繰り返しは毎週・隔週で最大12回。一部の回が重複する場合は、重複する日の一覧を出し「重複しない回だけ予約する」を選べる |
| FR-506 |
予約開始から15分以内に「利用開始」が押されない予約は自動で解放し、予約者に通知する(会議室・集中ブースのみ。デモでは現在時刻で判定) |
| FR-507 |
参加者に指定したメンバーには通知し、各自のカレンダーに予定を作る |
| FR-508 |
利用停止中の施設(F-A05)は表示するが灰色にし、予約できない理由を表示する |
| FR-509 |
取消は開始時刻まで可能。管理者が他人の予約を取り消す場合は理由必須で、予約者に通知 |
SC-600 カレンダー
| 区分 |
仕様 |
| 表示切替 |
月/週/日(スマホは日と一覧のみ)。今日へ戻るボタン、前後移動 |
| 重ねる層 |
全社イベント(ライム)、自分の予約(シアン)、自分の休暇(琥珀)、部署メンバーの休暇(灰・承認者以上は既定で表示)、祝日・会社休日(日付の数字を赤) |
| 層の切替 |
凡例のチェックで各層を表示・非表示。状態は保存 |
| イベント詳細 |
日時、場所、主催者、説明、定員と参加人数、出欠の締切、自分の回答 |
| 出欠 |
参加/不参加/未定。締切後は変更不可。定員に達したら「満席」でキャンセル待ちに入れる |
| ID |
要件 |
| FR-600 |
週表示で予定が重なる場合は横に並べ、2つを超えたら「+2」でまとめる(文字を重ねない) |
| FR-601 |
月表示の1日のセルは最大3件、超えたら「+N件」。クリックでその日の一覧 |
| FR-602 |
キャンセル待ちは申込順。空きが出たら先頭を自動で繰り上げ、本人に通知 |
| FR-603 |
予定から .ics ファイルを書き出せる(ブラウザ内で生成してダウンロード) |
| FR-604 |
出欠未回答で締切2日前のイベントは、ホームの「やること」に出す |
SC-800 通知センター
| 区分 |
仕様 |
| 表示 |
右ドロワー(幅 400px、スマホは全画面)。種別アイコン、本文2行、経過時間、未読ドット |
| 絞り込み |
すべて/未読/メンション/申請・承認 |
| 操作 |
行クリックで該当画面へ移動して既読。「すべて既読にする」 |
通知の種類
| 種別 |
発生条件 |
受け取る人 |
遷移先 |
| お知らせ配信 |
お知らせが配信された |
配信対象者 |
SC-101 |
| 必読リマインド |
管理者がリマインドを送った |
未読の対象者 |
SC-101 |
| 承認依頼 |
申請が自分の段に来た |
承認者と代理 |
SC-402 |
| 承認期限超過 |
2営業日を過ぎた(1日1回まで) |
承認者 |
SC-402 |
| 申請の承認完了 |
最終段で承認された |
申請者 |
SC-402 |
| 差戻し・却下 |
差戻し・却下された |
申請者 |
SC-402 |
| メンション |
投稿・コメントで@された |
本人 |
SC-201 |
| 称賛 |
称賛の宛先になった |
本人 |
SC-201 |
| コメント |
自分の投稿にコメントが付いた |
投稿者 |
SC-201 |
| 投稿の非表示 |
管理者が投稿を非表示にした |
投稿者 |
SC-201 |
| 予約への招待 |
予約の参加者に指定された |
参加者 |
SC-500 |
| 予約の自動解放・取消 |
FR-506 / FR-509 |
予約者 |
SC-500 |
| キャンセル待ち繰り上げ |
FR-602 |
本人 |
SC-600 |
| メッセージ |
DMを受け取った(通知センターではなくメッセージの未読数で表示) |
受信者 |
SC-700 |
| ID |
要件 |
| FR-800 |
通知は lib/domain/notify.ts の1関数から発行し、各機能は直接通知を作らない |
| FR-801 |
本人の通知設定でオフの種別は作らない。ただし 承認依頼・差戻し・却下 はオフにできない |
| FR-802 |
自分の操作で自分に通知しない |
| FR-803 |
メールがオンの種別は、作成時にメールの送信プレビュー(件名・本文・送信先)をトーストのリンクから確認できる |
| FR-804 |
通知は90日で自動削除(FR-011) |
12. 管理者機能
管理画面はホームと同じシェル・トークンを使い、一覧は表形式、編集は右からのパネル(スマホは全画面)で統一します。管理操作はすべて操作ログ(誰が・いつ・何を・変更前後)に残します(FR-A00)。
SC-A00 管理ホーム
要対応の件数タイル(承認者不在の申請/期限超過の承認/既読率80%未満の必読/利用停止中の施設)と、直近の操作ログ10件を表示します。各タイルから該当画面へ移動します。
SC-A10 / SC-A11 お知らせ配信管理
| 項目 |
仕様 |
| 入力 |
件名(1〜60字)、カテゴリ、重要度(必読/通常)、本文(Markdown、1〜10,000字、右にプレビュー)、カバー画像、添付(最大5件)、対象(全社/部署の複数選択)、確認期限(必読のみ)、上部固定、ホームのヒーローに設定 |
| 配信 |
今すぐ配信/日時を指定して予約配信/下書き保存 |
| 一覧 |
状態(下書き・予約・配信済み)、件名、対象、配信日、既読率(数値+横棒) |
| 既読率詳細 |
対象者数・既読数・未読数、部署別の既読率、未読者の一覧 |
| ID |
要件 |
| FR-A10 |
予約配信は指定日時以降の最初の画面表示時に配信状態へ変える(デモのため。本番はサーバー側の定期実行) |
| FR-A11 |
配信済みの本文を修正すると「更新」ラベルと更新日時を付け、必読の場合は既読を維持するか再確認を求めるかを選ぶ |
| FR-A12 |
未読者へのリマインドは1件につき1日1回まで |
| FR-A13 |
approver は対象を自部署に限定した作成・配信・既読率確認ができる(02章) |
| FR-A14 |
上部固定は最大3件。4件目を固定すると最も古い固定を外すか確認する |
SC-A20 メンバー管理 / SC-A21 部署管理
| 項目 |
仕様 |
| メンバー一覧 |
氏名・かな・社員番号・部署・役職・ロール・状態(在籍/休職/退職)・入社日。検索と絞り込み |
| メンバー編集 |
氏名・かな・社員番号(重複不可)・社用メール(重複不可)・部署・役職・ロール・入社日・内線・年次有給の付与日数と次回付与日 |
| 異動 |
異動日と新部署・新役職を登録。異動日以降に自動で反映し、異動履歴を残す |
| 休職・退職 |
開始日(退職日)を登録。承認者になっている承認待ち申請があれば件数を警告し、付け替え先を選ばせる |
| 部署 |
部署名・略称・親部署(最大3階層)・部署長・並び順(ドラッグ)・カバー画像 |
| ID |
要件 |
| FR-A20 |
部署長が空の部署に申請が出た場合、親部署の部署長を承認者とする(FR-402と同じ関数) |
| FR-A21 |
自分自身の admin ロールは外せない(管理者が0人になるのを防ぐ) |
| FR-A22 |
メンバーの一括登録はCSV(氏名・かな・社員番号・メール・部署略称・役職・入社日)。取込前にプレビューとエラー行の一覧を出し、エラー行を除いて取り込める |
| FR-A23 |
子部署やメンバーが残っている部署は削除できない |
SC-A30 承認ルート設定
| 項目 |
仕様 |
| ルート表 |
種別×金額帯の行、1〜3段の承認者役割(部署長/代表/管理部(経理)/管理部(総務)/指定メンバー) |
| 金額帯 |
境界金額を編集(例 30,000円)。境界ちょうどは「以上」側 |
| 代理承認 |
承認者ごとに 代理承認者・期間(開始日〜終了日) |
| 会社休日 |
年末年始・夏季休業などの日付を登録(休暇日数・営業日計算に使用) |
| ID |
要件 |
| FR-A30 |
ルートの変更は、変更後に送信された申請から適用する。承認待ちの申請には影響しない(FR-401) |
| FR-A31 |
保存前に「このルートで 経費 45,000円 を 営業部 高木が申請した場合」のようなシミュレーションを表示する |
SC-A40 施設マスタ
施設名、種別、定員、設備、場所、予約可能時間帯、1回の最長時間、利用開始の要否(FR-506)、利用停止(期間と理由)を編集します。利用停止を設定すると、期間内の既存予約の一覧を出し、予約者へ通知するか確認します(FR-A40)。
SC-A50 KPI入力
| ID |
要件 |
| FR-A50 |
KPIは4枠固定。各枠の表示名・単位・小数桁・増減の良し悪し(増えて良い/減って良い)を設定する |
| FR-A51 |
月ごとの値を表で入力する。CSV取込(年月・キー・値)も可 |
| FR-A52 |
今月の目標(進捗リング)の件名・目標値・実績値を設定する |
| FR-A53 |
平均残業のように「減って良い」指標は、減少を --color-ok、増加を --color-danger で表示する |
SC-A60 Wiki編集
文書の作成・編集(Markdownとプレビュー)、カテゴリ、公開範囲、版の保存(変更概要必須)、過去版との差分表示、過去版への戻しができます。
SC-A70 利用状況・書き出し
| 項目 |
仕様 |
| 利用状況 |
週次アクティブ率(直近12週の折れ線)、必読の平均既読率、申請の平均承認リードタイム(営業日)、施設稼働率 |
| 書き出し |
承認済みの経費精算(明細単位)・備品購入・休暇取得を、期間を指定してCSVで書き出し |
| ID |
要件 |
| FR-A70 |
CSVは UTF-8(BOM付き)・カンマ区切り・1行目に見出し。金額は数値のみ(カンマなし)、日付は YYYY-MM-DD |
| FR-A71 |
経費CSVの列:申請番号, 承認日, 申請者, 社員番号, 部署, 利用日, 科目, 金額, 支払先, 摘要 |
| FR-A72 |
書き出した申請には書き出し日時を記録し、「未書き出しのみ」で絞り込める(二重計上の防止) |
13. データモデル・業務ルール・バリデーション
型は lib/types/ に置き、全エンティティに id・createdAt・updatedAt、更新競合を検出する必要のあるものに version を持たせます。IDは接頭辞付きの文字列(m_・req_ など)で、本番化でUUIDに置き換えても型は変わりません。
型定義
type ISO = string; // ISO 8601, +09:00
type Role = 'member' | 'approver' | 'admin';
type Presence = 'in' | 'meeting' | 'out' | 'remote' | 'leave' | 'suspended';
interface Member {
id: string; employeeNo: string; name: string; kana: string; email: string;
deptId: string; title: string; role: Role;
status: 'active' | 'suspended' | 'retired';
joinedOn: string; retiredOn?: string; ext?: string;
presence: Presence; presenceNote?: string; presenceUntil?: ISO;
skills: string[]; bio?: string; avatar?: ImageRef;
leave: { grantedDays: number; nextGrantOn: string };
following: string[];
}
interface Department {
id: string; name: string; short: string; parentId?: string;
headId?: string; order: number; cover?: ImageRef;
}
type ImageRef =
| { kind: 'seed'; seed: string; w: number; h: number }
| { kind: 'upload'; blobKey: string; w: number; h: number };
interface Notice {
id: string; title: string; body: string;
category: 'hr' | 'general' | 'system' | 'event' | 'company';
priority: 'must' | 'normal';
audience: { kind: 'all' } | { kind: 'depts'; deptIds: string[] };
status: 'draft' | 'scheduled' | 'published';
publishAt: ISO; dueOn?: string; pinned: boolean; hero: boolean;
cover?: ImageRef; attachments: { name: string; size: number }[];
authorId: string; editedAt?: ISO;
reads: Record<string, ISO>; // memberId -> read/confirmed at
}
interface Post {
id: string; type: 'log' | 'praise' | 'question';
authorId: string; body: string; images: ImageRef[];
toMemberIds: string[]; value?: 'challenge' | 'integrity' | 'cocreate';
tags: string[]; mentions: string[];
claps: string[]; // memberIds
solved?: boolean; bestCommentId?: string;
hidden?: { by: string; reason: string; at: ISO };
editedAt?: ISO; createdAt: ISO;
}
interface Comment { id: string; postId: string; authorId: string; body: string; mentions: string[]; createdAt: ISO; editedAt?: ISO }
type RequestType = 'leave' | 'expense' | 'purchase' | 'ringi';
type RequestStatus = 'draft' | 'pending' | 'returned' | 'approved' | 'rejected' | 'withdrawn';
interface WorkflowRequest {
id: string; no: string; // e.g. R-2026-0142
type: RequestType; applicantId: string; deptId: string;
title: string; payload: LeavePayload | ExpensePayload | PurchasePayload | RingiPayload;
amount: number; // yen, 0 for leave
status: RequestStatus; currentStep: number;
steps: ApprovalStep[]; // fixed at submit (FR-401)
history: { at: ISO; actorId: string; action: string; comment?: string; proxyFor?: string }[];
submittedAt?: ISO; completedAt?: ISO; exportedAt?: ISO;
version: number;
}
interface ApprovalStep {
order: 1 | 2 | 3; roleLabel: string; approverId: string;
state: 'waiting' | 'current' | 'approved' | 'skipped';
actedAt?: ISO; actedBy?: string;
}
interface LeavePayload { kind: 'annual' | 'special' | 'compensatory' | 'absence'; from: string; to: string; unit: 'full' | 'am' | 'pm'; days: number; reason?: string; coverId?: string }
interface ExpenseLine { usedOn: string; account: string; amount: number; payee: string; memo?: string; receipt?: ImageRef; attendees?: string; headcount?: number }
interface ExpensePayload { lines: ExpenseLine[] }
interface PurchasePayload { item: string; qty: number; unitPrice: number; url?: string; needBy: string; purpose: string }
interface RingiPayload { purpose: string; effect?: string; when?: string; attachments: { name: string; size: number }[] }
interface Route { type: RequestType; minAmount: number; maxAmount?: number; steps: StepRule[] }
type StepRule = { kind: 'deptHead' | 'ceo' | 'accounting' | 'general' } | { kind: 'member'; memberId: string };
interface Proxy { approverId: string; proxyId: string; from: string; to: string }
interface Facility {
id: string; name: string; kind: 'room' | 'booth' | 'car' | 'equipment';
capacity: number; features: string[]; place: string;
open: string; close: string; maxMinutes: number; needsCheckIn: boolean;
suspended?: { from: string; to: string; reason: string };
}
interface Booking {
id: string; facilityId: string; ownerId: string; title: string;
start: ISO; end: ISO; // half-open [start, end)
attendeeIds: string[]; seriesId?: string; memo?: string;
checkedInAt?: ISO; releasedAt?: ISO; cancelled?: { by: string; reason?: string; at: ISO };
version: number;
}
interface CompanyEvent {
id: string; title: string; start: ISO; end: ISO; place: string;
hostId: string; description: string; capacity?: number; rsvpDue?: string;
rsvps: Record<string, 'yes' | 'no' | 'maybe'>; waitlist: string[]; cover?: ImageRef;
}
interface Notification {
id: string; toId: string; kind: string; title: string; body: string;
href: string; createdAt: ISO; readAt?: ISO;
}
interface Kpi { key: string; label: string; unit: string; decimals: number; better: 'up' | 'down'; monthly: Record<string, number> }
interface WikiDoc { id: string; title: string; category: string; audience: Notice['audience']; versions: { v: number; body: string; at: ISO; by: string; summary: string }[]; helpful: { yes: number; no: number } }
interface AuditLog { id: string; at: ISO; actorId: string; action: string; target: string; before?: unknown; after?: unknown }
入力の上限(Zodスキーマと画面表示で一致させる)
| 項目 |
下限 |
上限 |
| 氏名 |
1字 |
20字 |
| かな |
1字 |
30字(ひらがなと空白のみ) |
| 社員番号 |
1字 |
10字(英数字) |
| 一言(在席) |
0字 |
40字 |
| 自己紹介 |
0字 |
300字 |
| スキルタグ |
1字 |
20字 × 最大10個 |
| 投稿本文 |
1字 |
1,000字 |
| コメント |
1字 |
500字 |
| お知らせ件名 |
1字 |
60字 |
| お知らせ本文 |
1字 |
10,000字 |
| 申請件名 |
1字 |
40字 |
| 差戻し・却下理由 |
10字 |
500字 |
| 経費1明細の金額 |
1円 |
1,000,000円 |
| 経費の明細数 |
1行 |
20行 |
| 予約の件名 |
1字 |
40字 |
| メッセージ |
1字 |
2,000字 |
採番と日付の業務ルール
| ID |
要件 |
| FR-080 |
申請番号は R-年-4桁連番(例 R-2026-0142)。年が変わると0001から |
| FR-081 |
営業日は土日・祝日・会社休日を除いた日。計算は lib/domain/calendar.ts に1本化 |
| FR-082 |
シードの日時は「今日」を基準にした相対値で生成し、いつ開いても今週の予定・今月のKPIとして成立させる |
| FR-083 |
金額はすべて整数の円で保持する(小数の円を扱わない) |
14. デモデータ
デモデータは「開いた瞬間に承認待ち・差戻し・未読必読・今日の予約がすべて1件以上ある」状態で用意します。日付はすべて今日を基準にした相対値です(FR-082)。表中の「D」は今日、「D+1」は翌営業日を表します。
部署(5部署・7チーム)
| ID |
部署 |
親 |
部署長 |
| d_exec |
経営 |
— |
m01 西澤 志門 |
| d_dev |
開発部 |
— |
m02 菊池 星哉 |
| d_dev_app |
アプリチーム |
d_dev |
m03 海野 遥 |
| d_dev_design |
デザインチーム |
d_dev |
m10 綾部 実咲 |
| d_sales |
営業部 |
— |
m04 高木 芽衣 |
| d_cs |
CS部 |
— |
m06 三宅 千秋 |
| d_admin |
管理部 |
— |
m08 若林 詩織 |
メンバー(28名・主要12名)
| ID |
氏名 |
部署 |
役職 |
ロール |
在席 |
スキル |
| m00 |
あなた(小野 陽向) |
アプリチーム |
エンジニア |
member |
在席 |
React / TypeScript |
| m01 |
西澤 志門 |
経営 |
代表 |
admin |
在席 |
事業開発 / ノーコード / AI活用 |
| m02 |
菊池 星哉 |
開発部 |
部長 |
approver |
会議中 |
アーキテクチャ / 要件定義 |
| m03 |
海野 遥 |
アプリチーム |
リーダー |
approver |
リモート |
実装 / API連携 / 自動化 |
| m04 |
高木 芽衣 |
営業部 |
部長 |
approver |
在席 |
提案 / 折衝 |
| m05 |
相馬 隼人 |
営業部 |
メンバー |
member |
外出 |
新規開拓 |
| m06 |
三宅 千秋 |
CS部 |
部長 |
approver |
在席 |
導入支援 / 研修設計 |
| m07 |
大野 湊斗 |
CS部 |
メンバー |
member |
休暇 |
FAQ整備 |
| m08 |
若林 詩織 |
管理部 |
部長(人事・総務) |
admin |
在席 |
採用 / 労務 |
| m09 |
堀内 樹 |
管理部 |
経理 |
admin |
在席 |
経理 / 資金繰り |
| m10 |
綾部 実咲 |
デザインチーム |
リーダー |
approver |
在席 |
UI設計 / 情報設計 |
| m11 |
郡司 蓮 |
営業部 |
メンバー |
member |
リモート |
インサイドセールス |
残り16名(m12〜m27)は氏名・かな・部署・役職を生成し、在席を合計12名になるよう調整します(ホームの 12/28名 と一致)。うち1名を休職、1名を異動予定(D+10)にします。デモ上の承認者の解決先は「部署長」=上表の部署長、「代表」=m01、「管理部(経理)」=m09、「管理部(総務)」=m08 です。
ペルソナは あなた(member)・菊池(approver:開発部長)・若林(admin)の3名です。あなたの休暇申請の1段目は所属チームの長 m03 海野ですが、デモのわかりやすさのため m03 に代理承認者 m02 菊池(期間:D−3〜D+7)を設定し、菊池に切り替えると承認できるようにします。
申請(14件)
| 申請者 |
種別 |
件名 |
金額・日数 |
状態 |
ペルソナから見えるもの |
| m00 |
休暇 |
年次有給(D+8) |
1日 |
承認待ち 1/1 |
菊池の承認待ち(代理) |
| m00 |
経費 |
客先訪問の交通費 |
¥4,380 |
差戻し(理由:領収書の日付が読めません) |
あなたのやること |
| m00 |
備品 |
検証用スマートフォン |
¥68,800 |
承認待ち 2/3 代表 |
あなたの一覧 |
| m00 |
経費 |
技術書の購入 |
¥3,520 |
承認済み |
あなたの完了タブ |
| m00 |
稟議 |
開発者カンファレンス参加 |
¥45,000 |
下書き |
あなたの下書き |
| m10 |
経費 |
デザインツール年額 |
¥28,600 |
承認待ち 1/2 |
菊池の承認待ち |
| m03 |
休暇 |
午後半休(D+2) |
0.5日 |
承認待ち 1/1 |
菊池の承認待ち(期限超過で赤) |
| m05 |
経費 |
接待交際費 |
¥36,300 |
承認待ち 2/3 代表 |
若林から一覧で閲覧可 |
| m11 |
休暇 |
年次有給(D+4〜D+5) |
2日 |
承認済み |
カレンダーの部署休暇 |
| m07 |
休暇 |
年次有給(D−1〜D+1) |
3日 |
承認済み |
大野が在席「休暇」 |
| m06 |
稟議 |
CSツール導入 |
¥480,000 |
承認待ち 3/3 管理部 |
若林の承認待ち |
| m09 |
経費 |
振込手数料 |
¥1,320 |
承認済み(未書き出し) |
若林のCSV書き出し対象 |
| m04 |
備品 |
商談用モニター |
¥32,800 |
却下(理由:既存の在庫を使ってください) |
若林から一覧で閲覧可 |
| m05 |
経費 |
タクシー代 |
¥2,460 |
取下げ |
若林から一覧で閲覧可 |
施設(8件)
| ID |
名称 |
種別 |
定員 |
設備 |
最長 |
利用開始 |
| f01 |
会議室A |
room |
8 |
モニター / Web会議 |
4時間 |
要 |
| f02 |
会議室B |
room |
4 |
モニター |
4時間 |
要 |
| f03 |
大会議室 |
room |
20 |
プロジェクター / Web会議 / ホワイトボード |
8時間 |
要 |
| f04 |
セミナールーム |
room |
30 |
プロジェクター / マイク |
8時間 |
要 |
| f05 |
集中ブース1 |
booth |
1 |
Web会議 |
4時間 |
要 |
| f06 |
集中ブース2 |
booth |
1 |
Web会議 |
4時間 |
要(D〜D+5 利用停止:空調工事) |
| f07 |
社用車(プリウス) |
car |
5 |
ETC |
終日 |
不要 |
| f08 |
貸出用プロジェクター |
equipment |
1 |
HDMI |
終日 |
不要 |
今日の予約は各会議室に2〜3件、うち1件はあなたの予約(D 14:00〜15:00 会議室B「設計レビュー」、参加者に菊池)とします。
お知らせ(8件)
| 重要度 |
カテゴリ |
件名 |
対象 |
状態 |
画像 |
| 必読 |
人事 |
下期の目標設定について(D+10締切) |
全社 |
配信済み・上部固定 |
— |
| 必読 |
システム |
経費精算の入力方法が変わります |
全社 |
配信済み |
— |
| 必読 |
総務 |
集中ブース2の空調工事のお知らせ |
開発部 |
配信済み |
— |
| 通常 |
イベント |
全社合宿を開催します |
全社 |
配信済み・ヒーロー |
news-offsite |
| 通常 |
総務 |
新オフィスへの移転が完了しました |
全社 |
配信済み |
news-office |
| 通常 |
全社 |
上期MVPを表彰しました |
全社 |
配信済み |
news-award |
| 通常 |
総務 |
年末年始の休業日について |
全社 |
予約配信(D+3) |
— |
| 通常 |
システム |
社内Wikiの構成を見直しました |
全社 |
下書き |
— |
フィード投稿(12件)
| 種別 |
投稿者 |
本文の要旨 |
画像 |
拍手 |
| 称賛(共創) |
m04 → m02 |
北斗製作所の追加要件を休日前に整理してくれて、打ち合わせが3分で終わった |
— |
47 |
| 分報 |
m02 |
朝から詰まっていた同期処理の原因は設定漏れ。手順書に追記済み |
feed-desk |
12 |
| 分報 |
m10 |
ポータルの配色を暗い地に変えた。写真の発色が良い |
feed-whiteboard |
31 |
| 称賛(誠実) |
m06 → m07 |
研修資料を受講者の質問を全部拾って改訂してくれた |
— |
38 |
| 分報 |
m05 |
新規の問い合わせが今週9件。年明け以来のペース #営業 |
— |
24 |
| 質問(解決済み) |
m03 |
Workersの環境変数、本番と検証で分ける運用はどうしている? |
— |
6 |
| 分報 |
m08 |
来月の入社が2名決まった。受け入れ準備を進めます |
feed-training |
55 |
| 分報 |
m09 |
上期の締めが近いので経費精算は今週中に |
— |
9 |
| 分報 |
m01 |
新オフィスは静かで集中できる。窓際の席が人気 |
feed-lunch |
41 |
| 分報 |
m02 |
リリース完了。今回は差し戻しゼロ #リリース |
feed-launch |
62 |
| 称賛(挑戦) |
m01 → m03 |
現場トラブルに即日で駆けつけてくれた |
feed-site |
33 |
| 質問 |
m11 |
商談メモのテンプレート、何を使っていますか? @m04 |
— |
4 |
実在の取引先名は使わず、架空の社名にします。
KPI(直近6か月・今月が最後)
| キー |
表示名 |
単位 |
良い方向 |
値 |
| revenue |
今月の受注 |
円 |
増 |
6,100,000 / 6,800,000 / 7,200,000 / 7,000,000 / 7,900,000 / 8,420,000 |
| projects |
稼働プロジェクト |
件 |
増 |
12 / 13 / 15 / 14 / 16 / 17 |
| inquiries |
新規問い合わせ |
件 |
増 |
31 / 35 / 33 / 40 / 39 / 48 |
| overtime |
平均残業 |
時間 |
減 |
18.4 / 17.1 / 15.9 / 14.2 / 14.0 / 11.2 |
今月の目標:「新規受注 25件」に対し実績17件(68%)。
イベント(6件)
| 日時 |
名称 |
場所 |
定員 |
出欠締切 |
| D 10:00〜11:00 |
全社定例 |
大会議室 / オンライン |
— |
— |
| D+1 17:30〜18:30 |
開発ふりかえり |
開発エリア |
— |
— |
| D+3 14:00〜16:00 |
社内勉強会「AI活用の現在地」 |
セミナールーム |
30(残り2) |
D+1(あなたは未回答) |
| D+5〜D+7 |
1on1週間 |
各所 |
— |
— |
| D+6 18:30〜20:30 |
歓迎会 |
近隣の会場 |
20(満席・キャンセル待ち1) |
D+4 |
| D+20〜D+21 |
全社合宿 |
研修施設 |
40 |
D+10 |
Wiki(6文書)
就業規則(全社)、経費規程(全社・経費申請画面からリンク)、休暇の取り方(全社)、PC・アカウントの申請(全社)、入社初日の手順(全社)、開発環境の構築(開発部のみ)。
15. ディレクトリ構成・実装セッション分割
実装は8セッションに分け、純粋関数とデザイン基盤を最初に固めてから画面に入ります。各セッションの冒頭で読ませる章を限定し、完了チェックを満たしてから次へ進みます。
ディレクトリ構成
souzoh-portal/
├── CLAUDE.md # 00章の前提指示と03章のスタック表
├── scripts/fetch-images.mjs # 06
├── public/images/ # gitignore
├── app/
│ ├── theme.css # 04 tokens (dark + light)
│ ├── layout.tsx # shell + demo bar + fonts (next/font)
│ ├── page.tsx # SC-000
│ ├── notices/ feed/ members/ requests/ approvals/
│ ├── bookings/ calendar/ messages/ wiki/ notifications/ me/
│ ├── admin/ # SC-A00 to SC-A70
│ └── dev/ # components/, typography/ (TY-23). Not linked in prod
├── components/
│ ├── ui/ # Tile, SmartImage, Num, Badge, Button, Field, Truncate, Avatar
│ ├── domain/ # KpiTile, RequestTimeline, BookingGrid, PostCard ...
│ ├── shell/ # Header, SideNav, TabBar, NotificationDrawer
│ └── demo/ # DemoBar, ResetDialog, GuideTour, MailPreview
├── lib/
│ ├── types/ seed/ store/ repo/
│ ├── domain/ # workflow/, booking.ts, calendar.ts, search.ts, notify.ts
│ ├── auth/can.ts
│ ├── format/ # formatDate, formatYen, formatDelta, formatDuration
│ ├── validation/ # Zod schemas
│ └── motion.ts # 07 constants
├── e2e/ # Playwright incl. typography checks (TY-20 to TY-22)
└── README.md # fetch:images first
セッション分割
| # |
やること |
冒頭で読ませる章 |
| 0 |
初期化、スタック導入、theme.css、フォント、lib/format/、/dev/typography。画面は作らない |
03・04・05 |
| 1 |
型・シード・ストア・リポジトリ・can()・lib/domain/ 全関数と単体テスト。画像取得スクリプト |
02・03・06・10・11・13・14 |
| 2 |
UI部品(Tile・Num・Badge・Button・Field・Truncate・SmartImage)とシェル、デモ切替バー、/dev/components |
04・05・07・08 |
| 3 |
SC-000 ホーム(ベントー・演出・編集モード) |
07・09(SC-000) |
| 4 |
お知らせ・フィード・名鑑・組織図・⌘K |
09 |
| 5 |
申請・承認(SC-400〜410) |
10 |
| 6 |
施設予約・カレンダー・通知・メッセージ・Wiki・マイページ |
09・11 |
| 7 |
管理画面一式、CSV、利用状況。E2E・文字ずれ検査・a11y検査の仕上げ |
12・16 |
セッション1で純粋関数を先に固めるのは、承認ルート解決・休暇日数・予約重複の3つが最もバグの出やすい箇所だからです。画面を作ってから直すと、表示と計算の両方に手が入り往復が増えます。
セッション1の完了チェック
セッション指示文のひな形
添付の要件定義書 v2 の {章} を実装してください。対象IDは {FR-xxx, SC-xxx} です。
components/ui/ と lib/ 以下の既存の部品・関数は作り直さず import して使ってください。
色・余白・角丸・フォントは app/theme.css の変数のみ、アニメーション値は lib/motion.ts の定数のみを使い、
JSX に数値を直接書かないでください。
文字組みは 05章の TY-01〜TY-19 に従い、可変長の文字列にはすべて Truncate 部品で最大行数を指定してください。
データの読み書きは lib/repo/ 経由のみとし、ストアを直接参照しないでください。
実装前に、作成・変更するファイルの一覧と、仕様で曖昧な点を先に提示してください。
16. 非機能要件・受け入れ基準
受け入れは「業務が最後まで通るか」「文字がずれないか」「見た瞬間に伝わるか」の3観点で行います。下記のチェックがすべて埋まった時点で完成とします。
非機能要件
| ID |
項目 |
基準 |
| NFR-01 |
初回表示 |
4G回線相当でLCP 2.5秒以内 |
| NFR-02 |
操作の応答 |
クリックから画面の反応まで100ms以内(INP 200ms以内) |
| NFR-03 |
バンドル |
初回JS 250KB以内(gzip)。Recharts・cmdk・motion は使う画面で遅延読み込み |
| NFR-04 |
レイアウトシフト |
CLS 0.01以下(TY-22) |
| NFR-10 |
対応ブラウザ |
Chrome・Edge・Safari・Firefox の最新2版、iOS Safari 17以上 |
| NFR-20 |
アクセシビリティ |
WCAG 2.2 AA。axe-core で重大な違反0件 |
| NFR-21 |
キーボード |
全操作をキーボードで完結。フォーカスリングは --color-accent-2 の2px |
| NFR-30 |
動きを減らす |
07章の「動きを減らす時」列の通りに切り替わる |
| NFR-40 |
データ保護 |
デモ版はブラウザ外にデータを送らない(外部通信は画像取得の保険のみ) |
業務(通しで動くこと)
文字組み(ずれがないこと)
デザイン・動き・第一印象
引き渡し物