SenpaiGo の中身:オフラインで使える「仕事の日本語」アプリ
SenpaiGo は、仕事で使う日本語を学ぶためのウェブアプリです。ビジネス語彙、敬語、文法、そして BJT(ビジネス日本語能力テスト)対策の練習問題を収録しています。ブラウザで動き、オフラインでも使え、学習履歴は利用者の端末に保存されます。
この記事では、できることと、その仕組みを紹介します。
できること
- まず検索。 ホーム画面は検索ボックスです。漢字、かな、ローマ字、英語で調べられ、「ご確認ください」のような活用形もそのまま検索できます。文を貼り付けると、単語に分けてふりがなと英訳を表示します。手書き入力と、画像からの文字読み取りにも対応しています。
- 言葉と文法の解説。 ビジネス用語には個別のページがあり、意味、ニュアンス、社内・社外・メールの場面別の例文を確認できます。文法の解説は JLPT N5 から N1 まで。
- フラッシュカード。 語彙・文法・敬語のデッキを、間隔反復で復習できます。
- BJT 対策。 BJT の全9形式の練習問題に加えて、本番と同じ形式・制限時間の模擬試験(聴解模試を含む)があります。JLPT N2・N3 の模擬試験もあります。
- AI 機能(任意)。 AIチャット、AI添削、AIへの質問は、利用者自身のローカルAI(Ollama)または自分の API キーで動きます。
- Chrome 拡張機能。 ウェブページ上の日本語を選択すると、読みと意味を表示します。PDF では右クリックメニューから、Chrome のサイドパネルに結果を開けます。
- 表示言語は2つ。 日本語と英語。


仕組み
サーバーのない静的サイト。 Next.js と React で作り、Tailwind CSS でスタイルを付け、静的ファイルとして書き出しています。サーバーでは何も動かないので、アカウント登録もログインもありません。
オフラインが基本。 Service Worker(Serwist)がすべてのページを事前にキャッシュするため、一度開けば通信なしでも使えます。
辞書は端末の中で動く。 データは JMdict と KANJIDIC2 で、バージョンを固定しチェックサムを確認したリリースからビルド時に変換しています。約2万3千語の基本辞書はアプリと一緒にキャッシュされます。約21万9千語(14.7 MB)の完全版は初回利用時にダウンロードされ、Web Worker が IndexedDB に保存するので、読み込み中も画面が固まりません。
学習履歴はブラウザの中に。 練習問題の解答履歴とフラッシュカードの進捗は IndexedDB に保存します。復習スケジュールには ts-fsrs ライブラリの FSRS を使っています。
解説は事前に作成。 言葉と文法の解説は、Claude の構造化出力で生成し、JSON ファイルとしてリポジトリに保存して、静的ページとして配信しています。アプリ上では AI 生成であることを表示しています。
そのほかの部品。
- WanaKana:検索時のローマ字・かな変換。
- KanjiVG:漢字の書き順と、手書き入力の文字データ。
- Tesseract.js:ブラウザ内で画像から日本語を読み取る。
- kuromoji:例文のふりがなをビルド時に生成。
テストで内容を守る。 テストが問題バンクの全問を検証します。正解の番号が範囲外だったり、聴解問題に音声がなかったりすると、公開される前にビルドが失敗します。
ホスティング
書き出したファイルは、CloudFront の後ろにある非公開の S3 バケットに置いています。構成は AWS CDK でコードとして管理しています。main ブランチへ push するたびに、GitHub Actions が lint・テスト・ビルドを実行し、結果をアップロードします。GitHub は短時間だけ有効なトークンで AWS にサインインするので、AWS のキーはリポジトリに保存していません。
このサイトも同じ方法でホスティングしています。
方向を決めた3つの判断
- すべてを端末の中で。 辞書も、学習履歴も、拡張機能での検索も、端末内で動きます。拡張機能で選択した文章が外部に送信されることはありません。
- サーバーではなく静的サイト。 バックエンドがないので、動かし続けたり更新したりするものがなく、小規模ならホスティング費用はほぼゼロです。
- AI は任意。 バックエンドがないため、リアルタイムの AI 機能は利用者が用意したモデルやキーで動き、それ以外の機能は AI なしで使えます。
アプリはこちら:senpaigo.shakyabishal.com.np