Ryo_Shimano Claude Sonnet 4.6 commited on
Commit
ea3fdea
·
1 Parent(s): acac3c3

ヘルプページを最新仕様に更新・アイコン配色を統一

Browse files

- アイコン: 青(主要セクション)/ スレート(設定・履歴)/ 赤(バグ)の3色に集約、
全セクションで同じ透明度のマットな背景色に統一
- 目次チップ: バラバラなパステル → ニュートラルなボーダースタイルに統一(色ドットで区別)
- シフト表セクション: タブ切替→ボタン切替(リロードなし)・出力ドロップダウン・
変更履歴ボタン・コメント機能・朝食/ディナー上下表示に合わせて説明を更新
- hope-card-headerにrole/tabindex/onkeydownを追加(キーボードアクセシビリティ)
- 希望シフト入力: プログレスバーの追加に合わせて説明を更新

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Files changed (1) hide show
  1. templates/help/index.html +119 -96
templates/help/index.html CHANGED
@@ -25,13 +25,14 @@
25
  transition: background .15s; user-select: none;
26
  }
27
  .help-card-header:hover { background: rgba(148, 163, 184, 0.08); }
 
28
  .help-card-header.open { border-bottom-color: var(--border); }
29
  .help-card-icon {
30
  width: 36px; height: 36px; border-radius: 8px;
31
  display: flex; align-items: center; justify-content: center;
32
  font-size: 1.1rem; flex-shrink: 0;
33
  }
34
- .help-card-title { font-weight: 600; font-size: .95rem; flex-grow: 1; }
35
  .help-card-chevron { color: var(--text-muted); font-size: .8rem; transition: transform .2s; }
36
  .help-card-chevron.open { transform: rotate(180deg); }
37
  .help-card-body { padding: 1rem; display: none; font-size: .88rem; line-height: 1.7; color: var(--text); }
@@ -55,13 +56,9 @@
55
  border-radius: 0 8px 8px 0; padding: .6rem .85rem;
56
  font-size: .82rem; margin-top: .75rem;
57
  }
58
-
59
- /* tip-box / warn-box / info-box (ライトテーマ) */
60
  [data-theme="light"] .tip-box { background: #f0f9ff; color: #0c4a6e; border-left: 3px solid #0ea5e9; }
61
  [data-theme="light"] .warn-box { background: #fffbeb; color: #78350f; border-left: 3px solid #f59e0b; }
62
  [data-theme="light"] .info-box { background: #f0fdf4; color: #14532d; border-left: 3px solid #22c55e; }
63
-
64
- /* tip-box / warn-box / info-box (ダークテーマ) */
65
  [data-theme="dark"] .tip-box { background: rgba(14, 165, 233, 0.12); color: #38bdf8; border-left: 3px solid #0ea5e9; }
66
  [data-theme="dark"] .warn-box { background: rgba(245, 158, 11, 0.12); color: #fbbf24; border-left: 3px solid #f59e0b; }
67
  [data-theme="dark"] .info-box { background: rgba(34, 197, 94, 0.12); color: #4ade80; border-left: 3px solid #22c55e; }
@@ -82,6 +79,19 @@
82
  display: inline-block; border-radius: 4px;
83
  padding: 1px 7px; font-size: .75rem; font-weight: 600;
84
  }
 
 
 
 
 
 
 
 
 
 
 
 
 
85
  </style>
86
  {% endblock %}
87
 
@@ -89,7 +99,7 @@
89
  <!-- ヒーロー -->
90
  <div class="help-hero">
91
  <div class="app-icon">
92
- <img src="/static/icons/icon-192.png" alt="SKY DINING UOMAN"
93
  style="width:64px;height:64px;object-fit:contain;border-radius:12px">
94
  </div>
95
  <h2>SDU-Shift</h2>
@@ -98,35 +108,35 @@
98
 
99
  <div class="content">
100
 
101
- <!-- ── 目次 ── -->
102
  <div class="d-flex flex-wrap gap-2 mb-3">
103
- {% for anchor, label, color in [
104
- ('#home', 'ホーム', '#e0e7ff'),
105
- ('#staff', 'スタッフ管理', '#dbeafe'),
106
- ('#shift', '希望シフト', '#dcfce7'),
107
- ('#generate', '自動生成', '#fef9c3'),
108
- ('#schedule', 'シフト表', '#ede9fe'),
109
- ('#customer', '客数管理', '#fee2e2'),
110
- ('#settings', '設定', '#e2e8f0'),
111
- ('#changelog', '更新履歴', '#cffafe'),
112
- ('#known-issues', '既知の不具合', '#fecaca'),
113
  ] %}
114
- <a href="{{ anchor }}" class="text-decoration-none">
115
- <span style="background:{{ color }};color:#1e293b;border-radius:20px;
116
- padding:3px 12px;font-size:.78rem;font-weight:600">
117
- {{ label }}
118
- </span>
119
  </a>
120
  {% endfor %}
121
  </div>
122
 
123
- {# ── セクションマクロ ── #}
124
- {% macro section(id, icon, icon_bg, title, content_id) %}
125
  <div class="help-section" id="{{ id }}">
126
  <div class="help-card">
127
- <div class="help-card-header" onclick="toggleCard(this, '{{ content_id }}')">
 
 
128
  <div class="help-card-icon" style="background:{{ icon_bg }}">
129
- <i class="bi {{ icon }}"></i>
130
  </div>
131
  <span class="help-card-title">{{ title }}</span>
132
  <i class="bi bi-chevron-down help-card-chevron"></i>
@@ -134,14 +144,17 @@
134
  <div class="help-card-body" id="{{ content_id }}">
135
  {% endmacro %}
136
 
137
- {# ── ホーム(ダッシュボード) ── #}
138
- {{ section('home', 'bi-house-door-fill', '#e0e7ff', 'ホーム(ダッシュボード)', 'body-home') }}
 
 
 
 
139
 
140
  <p style="font-size:.82rem">ログイン後に最初に表示される画面です。「今日の状況」や「今やるべきこと」をまとめて確認できます。</p>
141
 
142
  <div class="sub-heading">今日の状況</div>
143
- <p style="font-size:.82rem">今日の予約客数(朝食・ディナー、入力済みの場合のみ表示)と、現在の時間帯における出勤予定人数をホール・キッチン別に表示します。<br>
144
- 人員が不足している区分は<span style="color:#ef4444;font-weight:600">赤色</span>でハイライトされ、不足人数が一目で分かります。</p>
145
 
146
  <div class="sub-heading">TODO(対応が必要な項目)</div>
147
  <p style="font-size:.82rem">優先度の高い順に、今対応した方がよい項目が自動でリストアップされます。各項目をタップすると関連する画面に移動します。</p>
@@ -157,17 +170,17 @@
157
  </div>
158
 
159
  <div class="sub-heading">期間ステータス</div>
160
- <p style="font-size:.82rem">直近のシフト期間について、「希望収集 → 自動生成 → 確定」の進行状況をバーで表示します。期間の開始日・終了日・残り日数、希望シフトの提出人数(提出済み/全体)も確認できます。</p>
161
 
162
  <div class="sub-heading">要対応の詳細</div>
163
- <p style="font-size:.82rem">「直近7日間で人員不足が発生する日付」「希望シフト未提出のスタッフ名」はタップして展開表示できます。シフト表・希望シフト入力画面への入口としてご利用ください。</p>
164
 
165
  </div>
166
  </div>
167
  </div>
168
 
169
  {# ── スタッフ管理 ── #}
170
- {{ section('staff', 'bi-people-fill', '#dbeafe', 'スタッフ管理', 'body-staff') }}
171
 
172
  <div class="sub-heading">基本操作</div>
173
  <ul class="step-list">
@@ -217,7 +230,7 @@
217
  <table class="table table-sm table-bordered mb-3" style="font-size:.82rem">
218
  <thead class="table-light"><tr><th>項目</th><th>内容</th></tr></thead>
219
  <tbody>
220
- <tr><td>勤務時間帯</td><td><strong>どちらでも</strong>(朝食・ディナー両方)/ <strong>朝食専任</strong>(朝食のみ)/ <strong>ディナー専任</strong>(ディナーのみ)。自動生成でのアサイン対象を制限します。</td></tr>
221
  <tr><td>朝食開店準備対応可<br><small class="text-muted">(5:45〜)</small></td><td>朝食の開店準備(open)バンドに配置できます。設定画面の「朝食バンド制約」で必要人数を設定します。</td></tr>
222
  <tr><td>朝食片付け対応可<br><small class="text-muted">(〜11:30)</small></td><td>朝食の片付け(cleanup)バンドに配置できます。同様に設定画面で人数を設定します。</td></tr>
223
  <tr><td>朝食:希望提出不要</td><td>毎日朝食に出勤可能なスタッフ。希望シフト入力がなくても朝食にアサインされます。</td></tr>
@@ -229,15 +242,12 @@
229
  <table class="table table-sm table-bordered mb-3" style="font-size:.82rem">
230
  <thead class="table-light"><tr><th>操作</th><th>内容</th></tr></thead>
231
  <tbody>
232
- <tr><td>アーカイブ</td><td>スタッフを非表示にします。シフト生成の対象外になりますが、データは保持されます。アーカイブすると現役一覧から消え、一覧画面に切り替わります。</td></tr>
233
  <tr><td>復元</td><td>アーカイブしたスタッフを元に戻します(「アーカイブ表示」から操作)。</td></tr>
234
  <tr><td>完全削除</td><td>スタッフと関連するすべてのデータを完全に削除します。<strong>元に戻せません。</strong></td></tr>
235
  </tbody>
236
  </table>
237
 
238
- <div class="sub-heading">アーカイブ表示の切り替え</div>
239
- <p style="font-size:.82rem">検索欄の横にある<strong>「アーカイブ」</strong>ボタンでアーカイブ済みスタッフの一覧に切り替えられます。アーカイブ表示中は<strong>「現役のみ」</strong>ボタンで通常表示に戻れます。</p>
240
-
241
  <div class="sub-heading">複数選択での一括操作</div>
242
  <p style="font-size:.82rem">各カード左端のチェックボックス(または上部の「全選択」)で複数のスタッフを選択すると、画面上部に一括操作バーが表示されます。</p>
243
  <table class="table table-sm table-bordered mb-0" style="font-size:.82rem">
@@ -254,38 +264,33 @@
254
  </div>
255
 
256
  {# ── 希望シフト入力 ── #}
257
- {{ section('shift', 'bi-pencil-square', '#dcfce7', '希望シフト入力', 'body-shift') }}
258
 
259
  <ul class="step-list">
260
  <li><span class="step-num">1</span><div><strong>期間を作成</strong> — 年月を選び「前半(1〜15日)」または「後半(16〜末日)」ボタンをタップします。</div></li>
261
- <li><span class="step-num">2</span><div><strong>希望を入力</strong> — 上部のスタッフ名チップをタップして対象者を切り替えながら、1人ずつ希望シフトを入力します。</div></li>
262
  <li><span class="step-num">3</span><div><strong>フォーム・CSV連携</strong> — 「外部フォーム&CSV連携(β)」パネルからGoogleフォームでの収集やCSV取り込みができます。</div></li>
263
  </ul>
264
 
265
  <div class="sub-heading">入力画面の見方</div>
266
- <p style="font-size:.82rem">画面上部のスタッフ名チップから対象者を選ぶと、その人の希望シフト入力欄が表示されます。1人ずつ切り替えながら入力してください。</p>
267
 
268
  <div class="sub-heading">一括操作ボタン</div>
269
- <p style="font-size:.82rem">各スタッフの入力画面上部に一括ボタンがあります。社員は「出勤」「休希望」「有休」「朝のみ可」「晩のみ可」を全日にまとめて設定でき、アルバイト/パートは「(休み)」または過去によく使われたパターン(最大3件)を全日にまとめて設定できます。</p>
270
 
271
  <div class="sub-heading">外部フォーム&CSV連携(β)</div>
272
  <p style="font-size:.82rem">入力画面下部の「外部フォーム&CSV連携(β)」パネルから、Googleフォームを使った希望収集やCSVインポートができます。</p>
273
  <ul class="step-list mb-3" style="font-size:.82rem">
274
- <li><span class="step-num">1</span><div><strong>フォームを自動作成</strong> — 「設定」でGoogleアカウント連携済みの場合、「フォームを自動作成」でこの期間専用の希望シフト収集フォームが生成されます。</div></li>
275
  <li><span class="step-num">2</span><div><strong>配布</strong> — 発行された配布用URLをコピーしてスタッフへ共有します。</div></li>
276
- <li><span class="step-num">3</span><div><strong>内容・選択肢の更新</strong> — タイトルや説明文を変更して「フォームに反映する」を押すと、作成済みフォームに変更が反映されます(回答の選択肢は人員構成に合わせて自動更新されます)。</div></li>
277
  <li><span class="step-num">4</span><div><strong>回答受付の締切管理</strong> — 「締め切る」でフォームへの新規回答を停止、「再開する」で受付を再開できます。</div></li>
278
- <li><span class="step-num">5</span><div><strong>回答データの同期</strong> — 「回答データを同期」でフォームの回答をシフト希望として取り込みます。「未入力のみ追加」(既存入力を保持)と「全て上書き」(フォーム回答を優先)から取り込み方法を選べます。</div></li>
279
  </ul>
280
- <p style="font-size:.82rem">Google連携を行っていない場合は、<strong>CSV手動取り込み</strong>からGoogleフォームなどでエクスポートしたCSVファイルを読み込めます。</p>
281
  <div class="info-box">
282
  <i class="bi bi-info-circle-fill me-1"></i>
283
- Googleフォーム連携の利用には、あらかじめ「設定」ページでGoogleアカウントとの連携が必要です(詳しくは「設定」の項目を参照)。
284
- </div>
285
-
286
- <div class="tip-box">
287
- <i class="bi bi-lightbulb-fill me-1"></i>
288
- 入力済みのスタッフはチップが<span style="color:#166534;font-weight:600">緑</span>に変わります。誰が未提出かひと目で確認できます。
289
  </div>
290
  <div class="warn-box">
291
  <i class="bi bi-exclamation-triangle-fill me-1"></i>
@@ -297,12 +302,12 @@
297
  </div>
298
 
299
  {# ── 自動生成 ── #}
300
- {{ section('generate', 'bi-lightning-fill', '#fef9c3', 'シフト自動生成', 'body-generate') }}
301
 
302
  <ul class="step-list">
303
  <li><span class="step-num">1</span><div><strong>対象期間を選択</strong> — ドロップダウンから希望シフト入力済みの期間を選びます。</div></li>
304
  <li><span class="step-num">2</span><div><strong>前提条件を確認</strong> — 期間を選ぶと「希望シフト入力人数」と「予約客数の入力状況」が自動チェックされます。</div></li>
305
- <li><span class="step-num">3</span><div><strong>優先度を設定</strong> — 各項目の <span class="help-btn" style="display:inline-flex;align-items:center;justify-content:center;width:18px;height:18px;border-radius:50%;background:#e0f2fe;color:#0369a1;font-size:.68rem;font-weight:700;border:1px solid #7dd3fc">?</span> をタップすると詳細説明が表示されます。</div></li>
306
  <li><span class="step-num">4</span><div><strong>「シフトを生成する」</strong>ボタンを押す。最大25秒で最適なシフトを算出します。</div></li>
307
  </ul>
308
 
@@ -313,7 +318,7 @@
313
  <tr><td>人件費最小化</td><td>総勤務時間の合計を少なくすることを優先します。短時間シフトのスタッフを優先配置して人件費を抑えます。</td></tr>
314
  <tr><td>アルバイト/パート希望充当</td><td>アルバイト/パートが希望した時間帯にできるだけアサインされるよう配慮します。</td></tr>
315
  <tr><td>人員バランス均等化</td><td>各スタッフの総勤務回数が均等になるよう調整します。</td></tr>
316
- <tr><td>深夜勤務分散</td><td>ディナー時間帯(22時以降)の勤務が特定のアルバイト/パートスタッフに集中しないよう分散させます(正社員は対象外)。</td></tr>
317
  </tbody>
318
  </table>
319
 
@@ -340,12 +345,12 @@
340
  </div>
341
 
342
  {# ── シフト表 ── #}
343
- {{ section('schedule', 'bi-calendar3', '#ede9fe', 'シフト表', 'body-schedule') }}
344
 
345
  <ul class="step-list">
346
- <li><span class="step-num">1</span><div>上部タブで<strong>朝食 / ディナー</strong>・<strong>ホール / キッチン</strong>の表示を切り替えます。</div></li>
347
- <li><span class="step-num">2</span><div><strong>セルをタップ</strong>するとその日・そのスタッフの担当を手動で追加・変更できます。</div></li>
348
- <li><span class="step-num">3</span><div><strong>日付ヘッダーをタップ</strong>するとその日の全員のタイムラインが確認できます。</div></li>
349
  <li><span class="step-num">4</span><div>内容が確定したら<strong>「確定」ボタン</strong>を押します。確定後に Excel / PDF エクスポートが可能になります。</div></li>
350
  </ul>
351
 
@@ -355,7 +360,7 @@
355
  <tbody>
356
  <tr>
357
  <td><i class="bi bi-check-lg text-success me-1"></i>確定</td>
358
- <td>ボタンを押すと<strong>確認ダイアログ</strong>が表示されます。人員不足の日数・希望未提出のスタッフ数が一覧表示され、問題を把握したうえで確定できます。確定後はセルの編集がロックされます。</td>
359
  </tr>
360
  <tr>
361
  <td><i class="bi bi-lock-fill text-danger me-1"></i>確定解除</td>
@@ -365,40 +370,62 @@
365
  </table>
366
 
367
  <div class="sub-heading">Excel / PDF エクスポート</div>
368
- <p style="font-size:.82rem">右上の <i class="bi bi-file-earmark-spreadsheet"></i> / <i class="bi bi-file-earmark-pdf"></i> ボタンからエクスポートできます。<br>
369
- シフトが<strong>未確定の場合はボタンがグレーアウト</strong>されます。タップすると「確定」を促すメッセージが表示されます。</p>
370
 
371
  <div class="sub-heading">人員状況グリッド(ページ上部)</div>
372
- <p class="mb-2">ページ上部の4マスのグリッドで、朝食ホール・朝食キッチン・ディナーホール・ディナーキッチン別の人員不足状況を一覧できます。タップすると不足している日付チップが展開されます。</p>
373
  <div class="d-flex gap-2 flex-wrap mb-2" style="font-size:.8rem">
374
  <span style="background:#ef4444;color:white;border-radius:4px;padding:2px 8px;font-weight:600">赤:人員不足</span>
375
  <span style="background:#f59e0b;color:white;border-radius:4px;padding:2px 8px;font-weight:600">黄:リーダー不足</span>
376
  <span style="background:#22c55e;color:white;border-radius:4px;padding:2px 8px;font-weight:600">緑:充足</span>
377
  </div>
378
- <p style="font-size:.82rem">日付ヘッダーにも同様の色でボーダーが付きます(赤:人員不足 / 黄:リーダー不足)。<br>
379
- 表の「予約」行には、現在表示中の時間帯(朝食 / ディナー)のその日の予約客数が表示されます。</p>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
380
 
381
- <div class="sub-heading">勤務時間の変更・応援の追加</div>
382
- <p class="mb-1">セルをタップして時間帯を指定できます。プリセット(全時間 / 早番 / 遅番)で素早く設定できます。ポジション選択は現在表示中のポジション(ホール / キッチン)が初期選択されます。<br>
383
- 希望シフトを提出済みのスタッフに時間を指定した場合は「<strong>時間を変更する</strong>」(希望時間からの短縮・延長)として<sup>変</sup>マークが付き、希望を提出していない日に出勤してもらう場合は「<strong>応援をお願いする</strong>」として<sup>応</sup>マークが付きます。</p>
384
 
385
- <div class="sub-heading">天気・気温の表示</div>
386
- <p style="font-size:.82rem">日付ヘッダーに天気アイコンと最高 / 最低気温が表示されます(直近16日分。過去日も記録があれば表示されます)。<br>
387
- 表示するには「設定」ページで店舗の緯度・経度を登録してください。未設定の場合は天気は表示されません。</p>
 
 
 
388
 
389
  <div class="sub-heading">予約客数のインライン編集</div>
390
  <p style="font-size:.82rem">「予約」行の各日のセルをタップすると、その場で朝食・ディナーの予約客数を編集できます。客数管理画面を開かずにシフト表から直接更新できます。</p>
391
 
392
- <div class="sub-heading">お知らせメモ(メモ1・メモ2)</div>
393
- <p style="font-size:.82rem">表の下部にある「メモ1」「メモ2」行は、日付ごとに自由にテキストを入力できる連絡用の行です。セルをタップして入力・編集します。<br>
394
- メモ1はスタッフ全体向け、メモ2は社員向けの連絡事項として使い分けることを想定しています。入力内容はExcel / PDF出力にも反映されます。</p>
395
-
396
- <div class="sub-heading">シフトセルへのコメント</div>
397
- <p style="font-size:.82rem">スタッフのシフトセルを編集する際、「コメント(任意)」欄に補足メモを残せます。コメントが入っているセルには小さなアイコンが表示され、タップすると内容を確認できます。</p>
398
 
399
  <div class="tip-box">
400
  <i class="bi bi-lightbulb-fill me-1"></i>
401
- 今日の日付の列は青ヘッダーでハイライト表示されます。土曜は青背景・日曜は赤背景で表示されます。
402
  </div>
403
 
404
  </div>
@@ -406,7 +433,7 @@
406
  </div>
407
 
408
  {# ── 客数管理 ── #}
409
- {{ section('customer', 'bi-cup-hot-fill', '#fee2e2', '客数管理', 'body-customer') }}
410
 
411
  <ul class="step-list">
412
  <li><span class="step-num">1</span><div>期間を選択して各日の<strong>予約客数(朝食・ディナー)</strong>を入力します。</div></li>
@@ -415,7 +442,7 @@
415
  </ul>
416
  <div class="tip-box">
417
  <i class="bi bi-lightbulb-fill me-1"></i>
418
- 予約客数を入力しておくと、自動生成時に閾値超過日は人数が自動増員されます。未入力の日は増員判定が無効になります。
419
  </div>
420
 
421
  <div class="sub-heading">客数予測(β)</div>
@@ -427,15 +454,14 @@
427
  </div>
428
 
429
  <div class="sub-heading">過去客数データ入力(β)</div>
430
- <p style="font-size:.82rem">客数予測(β)の精度向上のため、過去の実際の客数を月単位で入力できます。客数管理ページから「過去データ入力」を開き、月を切り替えながら朝食・ディナーの客数を入力します。<br>
431
- Excelなどからのコピー&ペーストで複数日分をまとめて入力することもできます。</p>
432
 
433
  </div>
434
  </div>
435
  </div>
436
 
437
  {# ── 設定 ── #}
438
- {{ section('settings', 'bi-gear-fill', '#e2e8f0', '設定', 'body-settings') }}
439
 
440
  <div class="sub-heading">シフト人員制約</div>
441
  <p style="font-size:.82rem">時間帯(朝食・ディナー)×ポジション(ホール・キッチン)ごとに人数の上限・下限を設定します。</p>
@@ -449,8 +475,7 @@
449
  </table>
450
 
451
  <div class="sub-heading">朝食バンド制約(開店準備 / 片付け)</div>
452
- <p style="font-size:.82rem">朝食の「開店準備(5:45〜)」と「片付け(〜11:30)」に参加するスタッフ数の制約を設定します。<br>
453
- スタッフ管理で「開店準備対応可」「片付け対応可」にチェックが入ったスタッフのみが���象になります。</p>
454
 
455
  <div class="sub-heading">社員デフォルト勤務時間</div>
456
  <p style="font-size:.82rem">正社員は希望シフトを提出しないため、シフト表・PDF・Excelに表示するデフォルトの勤務時間をポジション(ホール・キッチン)×時間帯(朝食・ディナー)別に設定します。</p>
@@ -475,16 +500,13 @@
475
  <p style="font-size:.82rem">個人昇給額はスタッフ管理画面でスタッフごとに設定します。正社員は人件費計算の対象外です。</p>
476
 
477
  <div class="sub-heading">ベータ機能</div>
478
- <p style="font-size:.82rem">開発中の実験的な機能です。今後も順次追加されます。</p>
479
 
480
  <div class="mb-2"><strong>客数予測機能(β)</strong></div>
481
- <p style="font-size:.82rem">過去の客数実績・曜日 / 祝日・気象データなどから朝食 / ディナーの客数を予測し、客数管理ページとダッシュボードに表示します。<br>
482
- 「客数予測機能を有効にする(β)」をオンにすると有効化されます。「店舗の緯度・経度」を設定すると、シフト表の天気表示にも使われる気象データを予測に利用できます(緯度・経度は任意ですが、未設定の場合シフト表に天気は表示されません)。<br>
483
- 予測精度を高めるには、客数管理画面で実績を入力し続けるか、過去客数データ入力ページから過去の実績を登録してください。</p>
484
 
485
  <div class="mb-2"><strong>Google フォーム連携機能(β)</strong></div>
486
  <p style="font-size:.82rem">Google Forms APIを利用して希望シフトの提出フォームを自動生成・配布し、回答結果を取り込める機能です。利用にはあらかじめGoogle Cloud ConsoleでOAuth 2.0クライアントを作成し、「Google OAuth Client ID」「Client Secret」を設定・保存してください(画面内に取得手順が表示されます)。<br>
487
- 設定保存後、「連携する」ボタンからGoogleアカウントと連携すると、各期間の希望シフト入力画面で「外部フォーム&CSV連携(β)」パネルが利用できるようになります。「連携解除」でいつでも連携を解除できます。</p>
488
 
489
  <div class="sub-heading">バックアップ / リストア</div>
490
  <table class="table table-sm table-bordered mb-0" style="font-size:.82rem">
@@ -504,7 +526,7 @@
504
  </div>
505
 
506
  {# ── 更新履歴 ── #}
507
- {{ section('changelog', 'bi-clock-history', '#cffafe', '更新履歴', 'body-changelog') }}
508
 
509
  <p style="font-size:.82rem">直近の更新内容です(コミットログより自動表示)。</p>
510
  {% if commits is none %}
@@ -538,7 +560,7 @@
538
  </div>
539
 
540
  {# ── 既知の不具合 ── #}
541
- {{ section('known-issues', 'bi-bug-fill', '#fecaca', '既知の不具合', 'body-known-issues') }}
542
 
543
  <p style="font-size:.82rem">現在報告されており、未対応の不具合です(GitHub Issuesより自動表示)。</p>
544
  {% if known_issues is none %}
@@ -571,7 +593,6 @@
571
  </div>
572
  </div>
573
 
574
- <!-- フッター余白 -->
575
  <div style="height:1rem"></div>
576
  </div>
577
  {% endblock %}
@@ -595,9 +616,11 @@ function toggleCard(header, bodyId) {
595
  if (!section) return;
596
  const header = section.querySelector('.help-card-header');
597
  if (header) {
598
- const bodyId = header.getAttribute('onclick').match(/'([^']+)'\s*\)/)[1];
599
- toggleCard(header, bodyId);
600
- setTimeout(() => section.scrollIntoView({ behavior: 'smooth', block: 'start' }), 100);
 
 
601
  }
602
  })();
603
  </script>
 
25
  transition: background .15s; user-select: none;
26
  }
27
  .help-card-header:hover { background: rgba(148, 163, 184, 0.08); }
28
+ .help-card-header:focus-visible { outline: 2px solid var(--primary); outline-offset: -2px; }
29
  .help-card-header.open { border-bottom-color: var(--border); }
30
  .help-card-icon {
31
  width: 36px; height: 36px; border-radius: 8px;
32
  display: flex; align-items: center; justify-content: center;
33
  font-size: 1.1rem; flex-shrink: 0;
34
  }
35
+ .help-card-title { font-weight: 600; font-size: .95rem; flex-grow: 1; color: var(--text); }
36
  .help-card-chevron { color: var(--text-muted); font-size: .8rem; transition: transform .2s; }
37
  .help-card-chevron.open { transform: rotate(180deg); }
38
  .help-card-body { padding: 1rem; display: none; font-size: .88rem; line-height: 1.7; color: var(--text); }
 
56
  border-radius: 0 8px 8px 0; padding: .6rem .85rem;
57
  font-size: .82rem; margin-top: .75rem;
58
  }
 
 
59
  [data-theme="light"] .tip-box { background: #f0f9ff; color: #0c4a6e; border-left: 3px solid #0ea5e9; }
60
  [data-theme="light"] .warn-box { background: #fffbeb; color: #78350f; border-left: 3px solid #f59e0b; }
61
  [data-theme="light"] .info-box { background: #f0fdf4; color: #14532d; border-left: 3px solid #22c55e; }
 
 
62
  [data-theme="dark"] .tip-box { background: rgba(14, 165, 233, 0.12); color: #38bdf8; border-left: 3px solid #0ea5e9; }
63
  [data-theme="dark"] .warn-box { background: rgba(245, 158, 11, 0.12); color: #fbbf24; border-left: 3px solid #f59e0b; }
64
  [data-theme="dark"] .info-box { background: rgba(34, 197, 94, 0.12); color: #4ade80; border-left: 3px solid #22c55e; }
 
79
  display: inline-block; border-radius: 4px;
80
  padding: 1px 7px; font-size: .75rem; font-weight: 600;
81
  }
82
+
83
+ /* ── 目次チップ:統一スタイル ── */
84
+ .toc-chip {
85
+ display: inline-flex; align-items: center; gap: .4rem;
86
+ background: var(--bg-card); border: 1px solid var(--border);
87
+ border-radius: 20px; padding: 4px 12px;
88
+ font-size: .78rem; font-weight: 600; color: var(--text);
89
+ text-decoration: none; transition: all .15s;
90
+ }
91
+ .toc-chip:hover { border-color: #0ea5e9; color: #0ea5e9; }
92
+ .toc-chip-dot {
93
+ width: 7px; height: 7px; border-radius: 50%; flex-shrink: 0;
94
+ }
95
  </style>
96
  {% endblock %}
97
 
 
99
  <!-- ヒーロー -->
100
  <div class="help-hero">
101
  <div class="app-icon">
102
+ <img src="/static/icons/icon-192.png" alt="SDU-Shift"
103
  style="width:64px;height:64px;object-fit:contain;border-radius:12px">
104
  </div>
105
  <h2>SDU-Shift</h2>
 
108
 
109
  <div class="content">
110
 
111
+ <!-- 目次 -->
112
  <div class="d-flex flex-wrap gap-2 mb-3">
113
+ {% for anchor, label, dot_color in [
114
+ ('#home', 'ホーム', '#0ea5e9'),
115
+ ('#staff', 'スタッフ管理', '#0ea5e9'),
116
+ ('#shift', '希望シフト', '#0ea5e9'),
117
+ ('#generate', '自動生成', '#0ea5e9'),
118
+ ('#schedule', 'シフト表', '#0ea5e9'),
119
+ ('#customer', '客数管理', '#0ea5e9'),
120
+ ('#settings', '設定', '#64748b'),
121
+ ('#changelog', '更新履歴', '#64748b'),
122
+ ('#known-issues', '既知の不具合', '#ef4444'),
123
  ] %}
124
+ <a href="{{ anchor }}" class="toc-chip">
125
+ <span class="toc-chip-dot" style="background:{{ dot_color }}"></span>
126
+ {{ label }}
 
 
127
  </a>
128
  {% endfor %}
129
  </div>
130
 
131
+ {# ── セクションマクロ(icon_color引数を追加) ── #}
132
+ {% macro section(id, icon, icon_bg, icon_color, title, content_id) %}
133
  <div class="help-section" id="{{ id }}">
134
  <div class="help-card">
135
+ <div class="help-card-header" onclick="toggleCard(this, '{{ content_id }}')"
136
+ role="button" tabindex="0"
137
+ onkeydown="if(event.key==='Enter'||event.key===' ')toggleCard(this,'{{ content_id }}')">
138
  <div class="help-card-icon" style="background:{{ icon_bg }}">
139
+ <i class="bi {{ icon }}" style="color:{{ icon_color }}"></i>
140
  </div>
141
  <span class="help-card-title">{{ title }}</span>
142
  <i class="bi bi-chevron-down help-card-chevron"></i>
 
144
  <div class="help-card-body" id="{{ content_id }}">
145
  {% endmacro %}
146
 
147
+ {# アイコン配色定数(青/スレート/赤の3色に統一)
148
+ bg: rgba(primary, .13) で全セクション同じ透明度
149
+ color: セクション種別で3色 #}
150
+
151
+ {# ── ホーム ── #}
152
+ {{ section('home', 'bi-house-door-fill', 'rgba(14,165,233,.13)', '#0ea5e9', 'ホーム(ダッシュボード)', 'body-home') }}
153
 
154
  <p style="font-size:.82rem">ログイン後に最初に表示される画面です。「今日の状況」や「今やるべきこと」をまとめて確認できます。</p>
155
 
156
  <div class="sub-heading">今日の状況</div>
157
+ <p style="font-size:.82rem">今日の予約客数(朝食・ディナー、入力済みの場合のみ表示)と、現在の時間帯における出勤予定人数をホール・キッチン別に表示します。人員が不足している区分は<span style="color:#ef4444;font-weight:600">赤色</span>でハイライトされます。</p>
 
158
 
159
  <div class="sub-heading">TODO(対応が必要な項目)</div>
160
  <p style="font-size:.82rem">優先度の高い順に、今対応した方がよい項目が自動でリストアップされます。各項目をタップすると関連する画面に移動します。</p>
 
170
  </div>
171
 
172
  <div class="sub-heading">期間ステータス</div>
173
+ <p style="font-size:.82rem">直近のシフト期間について「希望収集 → 自動生成 → 確定」の進行状況をバーで表示します。期間の開始日・終了日・残り日数、希望シフトの提出人数(提出済み/全体)も確認できます。</p>
174
 
175
  <div class="sub-heading">要対応の詳細</div>
176
+ <p style="font-size:.82rem">「直近7日間で人員不足が発生する日付」「希望シフト未提出のスタッフ名」は項目をタップすることで展開表示できます。シフト表・希望シフト入力画面への入口としてご利用ください。</p>
177
 
178
  </div>
179
  </div>
180
  </div>
181
 
182
  {# ── スタッフ管理 ── #}
183
+ {{ section('staff', 'bi-people-fill', 'rgba(14,165,233,.13)', '#0ea5e9', 'スタッフ管理', 'body-staff') }}
184
 
185
  <div class="sub-heading">基本操作</div>
186
  <ul class="step-list">
 
230
  <table class="table table-sm table-bordered mb-3" style="font-size:.82rem">
231
  <thead class="table-light"><tr><th>項目</th><th>内容</th></tr></thead>
232
  <tbody>
233
+ <tr><td>勤務時間帯</td><td><strong>どちらでも</strong>(朝食・ディナー両方)/ <strong>朝食専任</strong> / <strong>ディナー専任</strong>。自動生成でのアサイン対象を制限します。</td></tr>
234
  <tr><td>朝食開店準備対応可<br><small class="text-muted">(5:45〜)</small></td><td>朝食の開店準備(open)バンドに配置できます。設定画面の「朝食バンド制約」で必要人数を設定します。</td></tr>
235
  <tr><td>朝食片付け対応可<br><small class="text-muted">(〜11:30)</small></td><td>朝食の片付け(cleanup)バンドに配置できます。同様に設定画面で人数を設定します。</td></tr>
236
  <tr><td>朝食:希望提出不要</td><td>毎日朝食に出勤可能なスタッフ。希望シフト入力がなくても朝食にアサインされます。</td></tr>
 
242
  <table class="table table-sm table-bordered mb-3" style="font-size:.82rem">
243
  <thead class="table-light"><tr><th>操作</th><th>内容</th></tr></thead>
244
  <tbody>
245
+ <tr><td>アーカイブ</td><td>スタッフを非表示にします。シフト生成の対象外になりますがデータは保持されます。</td></tr>
246
  <tr><td>復元</td><td>アーカイブしたスタッフを元に戻します(「アーカイブ表示」から操作)。</td></tr>
247
  <tr><td>完全削除</td><td>スタッフと関連するすべてのデータを完全に削除します。<strong>元に戻せません。</strong></td></tr>
248
  </tbody>
249
  </table>
250
 
 
 
 
251
  <div class="sub-heading">複数選択での一括操作</div>
252
  <p style="font-size:.82rem">各カード左端のチェックボックス(または上部の「全選択」)で複数のスタッフを選択すると、画面上部に一括操作バーが表示されます。</p>
253
  <table class="table table-sm table-bordered mb-0" style="font-size:.82rem">
 
264
  </div>
265
 
266
  {# ── 希望シフト入力 ── #}
267
+ {{ section('shift', 'bi-pencil-square', 'rgba(14,165,233,.13)', '#0ea5e9', '希望シフト入力', 'body-shift') }}
268
 
269
  <ul class="step-list">
270
  <li><span class="step-num">1</span><div><strong>期間を作成</strong> — 年月を選び「前半(1〜15日)」または「後半(16〜末日)」ボタンをタップします。</div></li>
271
+ <li><span class="step-num">2</span><div><strong>希望を入力</strong> — 上部のスタッフ名チップをタップして対象者を切り替えながら、1人ずつ希望シフトを入力します。右上のプログレスバーで提出の進捗状況を確認できます。</div></li>
272
  <li><span class="step-num">3</span><div><strong>フォーム・CSV連携</strong> — 「外部フォーム&CSV連携(β)」パネルからGoogleフォームでの収集やCSV取り込みができます。</div></li>
273
  </ul>
274
 
275
  <div class="sub-heading">入力画面の見方</div>
276
+ <p style="font-size:.82rem">画面上部のスタッフ名チップから対象者を選ぶと、その人の希望シフト入力欄が表示されます。1人ずつ切り替えながら入力してください。入力済みのスタッフはチップが<span style="color:#166534;font-weight:600">緑</span>に変わるため、未提出者をひと目で確認できます。</p>
277
 
278
  <div class="sub-heading">一括操作ボタン</div>
279
+ <p style="font-size:.82rem">各スタッフの入力画面上部に一括ボタンがあります。正社員は「出勤」「休希望」「有休」「朝のみ可」「晩のみ可」を全日にまとめて設定でき、アルバイト/パートは「(休み)」または過去によく使われたパターン(最大3件)を全日にまとめて設定できます。</p>
280
 
281
  <div class="sub-heading">外部フォーム&CSV連携(β)</div>
282
  <p style="font-size:.82rem">入力画面下部の「外部フォーム&CSV連携(β)」パネルから、Googleフォームを使った希望収集やCSVインポートができます。</p>
283
  <ul class="step-list mb-3" style="font-size:.82rem">
284
+ <li><span class="step-num">1</span><div><strong>フォームを自動作成</strong> — Googleアカウント連携済みの場合、この期間専用の希望シフト収集フォームを自動生成できます。</div></li>
285
  <li><span class="step-num">2</span><div><strong>配布</strong> — 発行された配布用URLをコピーしてスタッフへ共有します。</div></li>
286
+ <li><span class="step-num">3</span><div><strong>内容・選択肢の更新</strong> — タイトルや説明文を変更して「フォームに反映する」を押すと、作成済みフォームに変更が反映されます。</div></li>
287
  <li><span class="step-num">4</span><div><strong>回答受付の締切管理</strong> — 「締め切る」でフォームへの新規回答を停止、「再開する」で受付を再開できます。</div></li>
288
+ <li><span class="step-num">5</span><div><strong>回答データの同期</strong> — 「回答データを同期」でフォームの回答を取り込みます。「未入力のみ追加」と「全て上書き」から選べます。</div></li>
289
  </ul>
290
+ <p style="font-size:.82rem">Google連携を行っていない場合は、<strong>CSV手動取り込み</strong>からエクスポートしたCSVファイルを読み込めます。</p>
291
  <div class="info-box">
292
  <i class="bi bi-info-circle-fill me-1"></i>
293
+ Googleフォーム連携の利用には、「設定」ページでGoogleアカウントとの連携が必要です。
 
 
 
 
 
294
  </div>
295
  <div class="warn-box">
296
  <i class="bi bi-exclamation-triangle-fill me-1"></i>
 
302
  </div>
303
 
304
  {# ── 自動生成 ── #}
305
+ {{ section('generate', 'bi-lightning-fill', 'rgba(14,165,233,.13)', '#0ea5e9', 'シフト自動生成', 'body-generate') }}
306
 
307
  <ul class="step-list">
308
  <li><span class="step-num">1</span><div><strong>対象期間を選択</strong> — ドロップダウンから希望シフト入力済みの期間を選びます。</div></li>
309
  <li><span class="step-num">2</span><div><strong>前提条件を確認</strong> — 期間を選ぶと「希望シフト入力人数」と「予約客数の入力状況」が自動チェックされます。</div></li>
310
+ <li><span class="step-num">3</span><div><strong>優先度を設定</strong> — 各項目の <span style="display:inline-flex;align-items:center;justify-content:center;width:18px;height:18px;border-radius:50%;background:#e0f2fe;color:#0369a1;font-size:.68rem;font-weight:700;border:1px solid #7dd3fc">?</span> をタップすると詳細説明が表���されます。</div></li>
311
  <li><span class="step-num">4</span><div><strong>「シフトを生成する」</strong>ボタンを押す。最大25秒で最適なシフトを算出します。</div></li>
312
  </ul>
313
 
 
318
  <tr><td>人件費最小化</td><td>総勤務時間の合計を少なくすることを優先します。短時間シフトのスタッフを優先配置して人件費を抑えます。</td></tr>
319
  <tr><td>アルバイト/パート希望充当</td><td>アルバイト/パートが希望した時間帯にできるだけアサインされるよう配慮します。</td></tr>
320
  <tr><td>人員バランス均等化</td><td>各スタッフの総勤務回数が均等になるよう調整します。</td></tr>
321
+ <tr><td>深夜勤務分散</td><td>ディナー時間帯(22時以降)の勤務が特定のスタッフに集中しないよう分散させます(正社員は対象外)。</td></tr>
322
  </tbody>
323
  </table>
324
 
 
345
  </div>
346
 
347
  {# ── シフト表 ── #}
348
+ {{ section('schedule', 'bi-calendar3', 'rgba(14,165,233,.13)', '#0ea5e9', 'シフト表', 'body-schedule') }}
349
 
350
  <ul class="step-list">
351
+ <li><span class="step-num">1</span><div>ページ上部の<strong>「ホール」「キッチン」ボタン</strong>でポジションを切り替えます。ページの再読み込みなしに即時切り替わります。</div></li>
352
+ <li><span class="step-num">2</span><div>各セルには<strong>朝食(上段)とディナー(下段)</strong>が並んで表示されます。いずれかをタップすると担当を追加・変更できます。</div></li>
353
+ <li><span class="step-num">3</span><div><strong>日付ヘッダーをタップ</strong>するとその日の全員のタイムライン一覧が確認できます。</div></li>
354
  <li><span class="step-num">4</span><div>内容が確定したら<strong>「確定」ボタン</strong>を押します。確定後に Excel / PDF エクスポートが可能になります。</div></li>
355
  </ul>
356
 
 
360
  <tbody>
361
  <tr>
362
  <td><i class="bi bi-check-lg text-success me-1"></i>確定</td>
363
+ <td>ボタンを押すと<strong>確認ダイアログ</strong>が表示されます。人員不足の日数・希望未提出のスタッフ数を確認したうえで確定できます。確定後はセルの編集がロックされます。</td>
364
  </tr>
365
  <tr>
366
  <td><i class="bi bi-lock-fill text-danger me-1"></i>確定解除</td>
 
370
  </table>
371
 
372
  <div class="sub-heading">Excel / PDF エクスポート</div>
373
+ <p style="font-size:.82rem">右上の<strong>「出力」ドロップダウン</strong>から「PDFプレビュー」「Excel出力」「PDF出力」を選択できます。<br>
374
+ Excel・PDF出力はシフトが<strong>確定済みの場合のみ</strong>有効になります。未確定の場合は選択肢がグレーアウトされます。</p>
375
 
376
  <div class="sub-heading">人員状況グリッド(ページ上部)</div>
377
+ <p class="mb-2">ページ上部の4マスのグリッドで、朝食ホール・朝食キッチン・ディナーホール・ディナーキッチン別の人員不足状況を一覧できます。問題のあるマスをタップすると不足している日付が展開されます。担当を追加・削除するとリアルタイムで更新されます。</p>
378
  <div class="d-flex gap-2 flex-wrap mb-2" style="font-size:.8rem">
379
  <span style="background:#ef4444;color:white;border-radius:4px;padding:2px 8px;font-weight:600">赤:人員不足</span>
380
  <span style="background:#f59e0b;color:white;border-radius:4px;padding:2px 8px;font-weight:600">黄:リーダー不足</span>
381
  <span style="background:#22c55e;color:white;border-radius:4px;padding:2px 8px;font-weight:600">緑:充足</span>
382
  </div>
383
+ <p style="font-size:.82rem">日付ヘッダーにも同様の色でボーダーが付きます。各日には朝食・ディナーそれぞれの人員バッジが表示され、現在表示中のポジションに合わせて更新されます。</p>
384
+
385
+ <div class="sub-heading">担当の追加・変更</div>
386
+ <p class="mb-1" style="font-size:.82rem">セルをタップすると担当編集モーダルが開きます。</p>
387
+ <table class="table table-sm table-bordered mb-3" style="font-size:.82rem">
388
+ <thead class="table-light"><tr><th>操作</th><th>内容</th></tr></thead>
389
+ <tbody>
390
+ <tr><td>ポジション選択</td><td>ホール・キッチンを切り替えてアサインできます。</td></tr>
391
+ <tr>
392
+ <td>希望シフト通り</td>
393
+ <td>希望提出済みのスタッフに対して表示されます。希望時間のままアサインします。</td>
394
+ </tr>
395
+ <tr>
396
+ <td>時間を変更する<sup>変</sup></td>
397
+ <td>希望提出済みのスタッフの勤務時間を短縮・延長します。プリセット(全時間 / 前半 / 後半)で素早く設定できます。</td>
398
+ </tr>
399
+ <tr>
400
+ <td>応援をお願いする<sup>応</sup></td>
401
+ <td>希望を提出していない日に出勤してもらう場合。時間帯を指定してアサインします。</td>
402
+ </tr>
403
+ </tbody>
404
+ </table>
405
+ <div class="tip-box">
406
+ <i class="bi bi-lightbulb-fill me-1"></i>
407
+ 担当の追加・削除はページリロードなしで即時反映されます。人員バッジ・不足グリッドも自動で更新されます。
408
+ </div>
409
 
410
+ <div class="sub-heading">シフトセルへのコメント</div>
411
+ <p style="font-size:.82rem">担当編集モーダル下部の「コメント(任意)」欄に補足メモを残せます(最大100文字)。コメントが入っているセルには <i class="bi bi-chat-fill"></i> アイコンと先頭8文字が表示されます。</p>
 
412
 
413
+ <div class="sub-heading">変更履歴</div>
414
+ <p style="font-size:.82rem">右上の <i class="bi bi-clock-history"></i> ボタンから手動変更履歴(直近60件)を確認できます。誰がいつ、どのスタッフの担当を追加・削除したかを記録しています。</p>
415
+
416
+ <div class="sub-heading">お知らせメモ(メモ1・メモ2)</div>
417
+ <p style="font-size:.82rem">表内の「メモ1」「メモ2」行は、日付ごとに自由にテキストを入力できる連絡用の行です。セルをタップして入力・編集します。<br>
418
+ メモ1はスタッフ全体向け、メモ2は社員向けの連絡事項として使い分けることを想定しています。Excel / PDF 出力にも反映されます。</p>
419
 
420
  <div class="sub-heading">予約客数のインライン編集</div>
421
  <p style="font-size:.82rem">「予約」行の各日のセルをタップすると、その場で朝食・ディナーの予約客数を編集できます。客数管理画面を開かずにシフト表から直接更新できます。</p>
422
 
423
+ <div class="sub-heading">天気・気温の表示</div>
424
+ <p style="font-size:.82rem">日付ヘッダーに天気アイコンと最高 / 最低気温が表示されます(直近16日分)。「設定」ページで店舗の緯度・経度を登録してください。未設定の場合は表示されません。</p>
 
 
 
 
425
 
426
  <div class="tip-box">
427
  <i class="bi bi-lightbulb-fill me-1"></i>
428
+ 今日の列は青ヘッダーでハイライト表示されます。土曜は青背景・日曜は赤背景で表示されます。
429
  </div>
430
 
431
  </div>
 
433
  </div>
434
 
435
  {# ── 客数管理 ── #}
436
+ {{ section('customer', 'bi-cup-hot-fill', 'rgba(14,165,233,.13)', '#0ea5e9', '客数管理', 'body-customer') }}
437
 
438
  <ul class="step-list">
439
  <li><span class="step-num">1</span><div>期間を選択して各日の<strong>予約客数(朝食・ディナー)</strong>を入力します。</div></li>
 
442
  </ul>
443
  <div class="tip-box">
444
  <i class="bi bi-lightbulb-fill me-1"></i>
445
+ 予約客数を入力しておくと、自動生成時に閾値超過日は人数が自動増員されます。未入力の日は増員判定が無効になります。シフト表の「予約」行からも直接編集できます。
446
  </div>
447
 
448
  <div class="sub-heading">客数予測(β)</div>
 
454
  </div>
455
 
456
  <div class="sub-heading">過去客数データ入力(β)</div>
457
+ <p style="font-size:.82rem">客数予測(β)の精度向上のため、過去の実際の客数を月単位で入力できます。客数管理ページから「過去データ入力」を開き、月を切り替えながら朝食・ディナーの客数を入力します。Excelなどからのコピー&ペーストで複数日分をまとめて入力することもできます。</p>
 
458
 
459
  </div>
460
  </div>
461
  </div>
462
 
463
  {# ── 設定 ── #}
464
+ {{ section('settings', 'bi-gear-fill', 'rgba(100,116,139,.13)', '#64748b', '設定', 'body-settings') }}
465
 
466
  <div class="sub-heading">シフト人員制約</div>
467
  <p style="font-size:.82rem">時間帯(朝食・ディナー)×ポジション(ホール・キッチン)ごとに人数の上限・下限を設定します。</p>
 
475
  </table>
476
 
477
  <div class="sub-heading">朝食バンド制約(開店準備 / 片付け)</div>
478
+ <p style="font-size:.82rem">朝食の「開店準備(5:45〜)」と「片付け(〜11:30)」に参加するスタッフ数の制約を設定します。スタッフ管理で「開店準備対応可」「片付け対応可」にチェックが入ったスタッフのみが対象になります。</p>
 
479
 
480
  <div class="sub-heading">社員デフォルト勤務時間</div>
481
  <p style="font-size:.82rem">正社員は希望シフトを提出しないため、シフト表・PDF・Excelに表示するデフォルトの勤務時間をポジション(ホール・キッチン)×時間帯(朝食・ディナー)別に設定します。</p>
 
500
  <p style="font-size:.82rem">個人昇給額はスタッフ管理画面でスタッフごとに設定します。正社員は人件費計算の対象外です。</p>
501
 
502
  <div class="sub-heading">ベータ機能</div>
 
503
 
504
  <div class="mb-2"><strong>客数予測機能(β)</strong></div>
505
+ <p style="font-size:.82rem">過去の客数実績・曜日 / 祝日・気象データなどから朝食 / ディナーの客数を予測し、客数管理ページとダッシュボードに表示します。「客数予測機能を有効にする(β)」をオンにすると有効化されます。「店舗の緯度・経度」を設定すると、シフト表の天気表示にも使われる気象データを予測に利用できます。</p>
 
 
506
 
507
  <div class="mb-2"><strong>Google フォーム連携機能(β)</strong></div>
508
  <p style="font-size:.82rem">Google Forms APIを利用して希望シフトの提出フォームを自動生成・配布し、回答結果を取り込める機能です。利用にはあらかじめGoogle Cloud ConsoleでOAuth 2.0クライアントを作成し、「Google OAuth Client ID」「Client Secret」を設定・保存してください(画面内に取得手順が表示されます)。<br>
509
+ 設定保存後、「連携する」ボタンからGoogleアカウントと連携すると、各期間の希望シフト入力画面で「外部フォーム&CSV連携(β)」パネルが利用できるようになります。</p>
510
 
511
  <div class="sub-heading">バックアップ / リストア</div>
512
  <table class="table table-sm table-bordered mb-0" style="font-size:.82rem">
 
526
  </div>
527
 
528
  {# ── 更新履歴 ── #}
529
+ {{ section('changelog', 'bi-clock-history', 'rgba(100,116,139,.13)', '#64748b', '更新履歴', 'body-changelog') }}
530
 
531
  <p style="font-size:.82rem">直近の更新内容です(コミットログより自動表示)。</p>
532
  {% if commits is none %}
 
560
  </div>
561
 
562
  {# ── 既知の不具合 ── #}
563
+ {{ section('known-issues', 'bi-bug-fill', 'rgba(239,68,68,.13)', '#ef4444', '既知の不具合', 'body-known-issues') }}
564
 
565
  <p style="font-size:.82rem">現在報告されており、未対応の不具合です(GitHub Issuesより自動表示)。</p>
566
  {% if known_issues is none %}
 
593
  </div>
594
  </div>
595
 
 
596
  <div style="height:1rem"></div>
597
  </div>
598
  {% endblock %}
 
616
  if (!section) return;
617
  const header = section.querySelector('.help-card-header');
618
  if (header) {
619
+ const m = header.getAttribute('onclick').match(/'([^']+)'\s*\)/);
620
+ if (m) {
621
+ toggleCard(header, m[1]);
622
+ setTimeout(() => section.scrollIntoView({ behavior: 'smooth', block: 'start' }), 100);
623
+ }
624
  }
625
  })();
626
  </script>