Skip to content

docs(manual): 画面写真つきの使い方マニュアルを納品する - #69

Merged
GIGAyama merged 1 commit into
mainfrom
claude/app-manual-portal-display-ojm94c
Sep 1, 2026
Merged

GIGAyama merged 1 commit into
mainfrom
claude/app-manual-portal-display-ojm94c

Conversation

@GIGAyama

Copy link
Copy Markdown
Owner

何をしたか

実ブラウザで全機能をさわり、40 枚の画面写真を撮って docs/manual/manual.md にまとめました。giga-manual スキルの書式に沿わせ、lint-manual.mjs は警告 0 件です。

  • 17 章 53 節。11 のタブと児童の受付操作を、機能のまとまりごとに章立てしました
  • 画面写真は 40 枚。押す場所には赤い枠を入れ、引き(画面全体)と寄り(触るところ)を分けています
  • 撮影に使ったデモ学級とシナリオを tools/manual-shots/ に残しました。実在する子どもは一人も含まれていません
  • docs/CHANGELOG.md に 1 行足しました(マニュアルは使う人から見て増えたもの)

中身をコードと突き合わせて直したところ

書式の検査も、目で見ることも、書いてある中身が正しいかは見ません。本文の言い切っている文を根拠のコードへ戻して確かめたところ、3 か所ずれていました。

  • 提出率の母数から欠席を外すのは「おやすみ日の提案」だけで、レポートの必要回数は欠席日も数えます(src/App.jsxgenerateReportData)。当初は「欠席は母数から外れます」と書いていました
  • 一括登録の出席番号は「現在の最大番号から連番」ではなく、空いている番号のうち小さいほうから割り当てます(handleAddBulkStudents)。画面に出ている説明文のほうが古くなっています
  • 名簿に無い番号を打つと出るのは「IDがみつかりません」です(handleScan

あわせて、MANUAL.md にある「Google Fonts から丸ゴシックを読んでいます」は現状と食い違う(fonts/ に自己ホスト済み・CSP は font-src 'self')ため、マニュアルには持ちこんでいません。

撮れていない画面

  • 更新の帯(「あたらしい ばんが あります」)。新しい版が用意できたときにだけ出るもので、撮影のためだけに本物の更新を起こせません。マニュアルでは文章だけで説明しています

検査

  • node .claude/skills/giga-manual/scripts/lint-manual.mjs docs/manual/manual.md … 警告 0 件
  • node .claude/skills/giga-changelog/scripts/lint-changelog.mjs docs/CHANGELOG.md … 通過
  • npm run check(lint → test → build → gate)… 0 error / 0 warning
  • node ../GIGAyama.github.io/standards/check-drift.mjs --standards ../GIGAyama.github.io/standards … 正本と一致
  • ポータルの組み立て(tools/lib/article-md.mjs + manual-page.mjs)でページにして、実ブラウザで確認。壊れた画像 0・4xx 0・図の説明文に降格した本文なし。印刷は A4 で 57 ページ(1 章あたり約 3.4 ページ)

ポータル側

このリポジトリの Pages は dist/ だけを配っているため、サブドメインからは docs/manual/images/ に届きません。控えが無いと raw.githubusercontent.com に落ち、GitHub を塞いでいる学校では画面写真が 1 枚も出ません。

控えは GIGAyama/GIGAyama.github.io の同名ブランチに置いてあります(assets/manual/homework-barcordreader/ の WebP 40 枚)。あわせてご確認ください。


Generated by Claude Code

実ブラウザで全機能をさわり、40 枚の画面写真を撮って
docs/manual/manual.md にまとめた。giga-manual スキルの書式に沿わせ、
lint-manual は警告 0 件。

- 17 章 53 節。11 のタブと児童の受付操作を、機能のまとまりごとに章立て
- 画面写真は 40 枚。押す場所には赤い枠を入れ、引きと寄りを分けた
- 撮影に使ったデモ学級とシナリオを tools/manual-shots/ に残した。
  実在する子どもは一人も含まれていない
- MANUAL.md にあった「Google Fonts から丸ゴシックを読む」は現状と食い違う
  (fonts/ に自己ホスト済み)ため、マニュアルには持ちこんでいない

書いた内容はコードと突き合わせて直した。とくに次の 3 つは、
書いた本人には正しく見えたまま残るところだった。

- 提出率の母数から欠席を外すのは「おやすみ日の提案」だけで、
  レポートの必要回数は欠席日も数える
- 一括登録の出席番号は「最大番号から連番」ではなく、
  空いている番号のうち小さいほうから割り当てる(画面の説明文のほうが古い)
- 名簿に無い番号を打つと出るのは「IDがみつかりません」

更新ログにも 1 行足した(マニュアルは使う人から見て増えたもの)。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cr3ptejpAPzJkhsqCJwr3g
@GIGAyama
GIGAyama marked this pull request as ready for review September 1, 2026 08:22
@GIGAyama
GIGAyama merged commit 23365fe into main Sep 1, 2026
2 checks passed
@GIGAyama
GIGAyama deleted the claude/app-manual-portal-display-ojm94c branch September 1, 2026 08:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants