💬 よくある質問 FAQ

Control-N'AI の日常運用でよくある質問と回答集。

🐢 動作・パフォーマンス

Q1. NAI の画面が重くなってきました。どうすればいい？

A: ブラウザを一度閉じて、開き直してください。

NAI を長時間開きっぱなしにすると、ブラウザ側にデータが蓄積して動作が重くなることがあります。これは NAI 特有の現象ではなく、Gmail / LINE / その他のWebアプリ全般で起こる現象です。

対処の手順

1. ブラウザを × ボタンで閉じる
2. もう一度ブラウザを開く
3. NAI を開く → 軽くなっています

予防：朝の習慣にしましょう

• 業務開始前に、前日からのブラウザを開き直す
• 1日中快適に使えます

Q2. NAI 本体（サーバー）も再起動が必要ですか？

A: いいえ、サーバー側の再起動は不要です。

[サーバーPC]              [スタッフPC]
ControlNAI サービス  ←→   ブラウザ
24時間稼働でOK             重い時だけ閉じる/再起動

NAI のサーバー（Node.js プログラム）は Windows サービスとして24時間動き続けますが、それで OK です。重く感じる原因は ブラウザ側にあるので、ブラウザを開き直すだけで解決します。

サーバーPCの再起動頻度: 月1回程度（Windows Update 等で）で十分。日々の業務では再起動不要。

Q3. NAI を1台のPCにインストールして使ってます。それでも同じですか？

A: はい、ブラウザを閉じれば解決します。

NAI は1台のPC で動かしても：

• バックグラウンドで NAI 本体（サービス）が動く
• ブラウザだけ閉じても NAI は動き続ける
• ブラウザを再起動するだけでメモリが軽くなる

PC 自体の再起動は週1〜月1で十分。NAI を閉じる必要は基本ありません。

📞 CTI（電話着信通知）

Q4. 電話の着信ポップアップが出ません

A: 以下を順に確認してください。

1. ブラウザで http://localhost:3000/api/cti/status を開く（または http://192.168.1.240:3000/api/cti/status）
2. integraHost: "192.168.1.200" になってるか確認
3. lastCallKey に最近の番号が記録されてるか確認

ステータスが「未設定」と出る場合:
.env に INTEGRA_HOST, INTEGRA_USER, INTEGRA_PASS が設定されてない可能性。管理人にご連絡ください。

ステータスは正常だがポップアップが出ない場合:
NAI 画面を開いてないと表示されません。常に1つは NAI を開いておくのがおすすめ。

Q5. ポップアップの「番号コピー」ボタンが反応しません

A: v1.0.4 で修正済みです。

v1.0.0〜v1.0.3 では HTTP 経由（社内LAN）の場合にコピーボタンが動かない不具合がありました。v1.0.4 以降で修正されています。

NAI 画面のヘッダ右上で v1.0.4 以降になっているか確認してください。

🔄 アップデート

Q6. ヘッダに「v1.0.X が利用できます」と出ました

A: 「更新する」ボタンを押せば自動アップデート完了です。

1. バナーの「更新する」ボタンをクリック
2. 確認ダイアログ → 「OK」
3. 数分間 NAI が止まる（DLと展開）
4. 自動でサービス再起動
5. ブラウザリロード → 新バージョンで使える

データは保護されます:

• 顧客マスター・伝票・写真・設定すべて維持
• 修正前の状態が C:\control-nai-rollback-(日時)\ に自動バックアップ

Q7. 「更新する」を押したのに反映されません

A: v1.0.0〜v1.0.2 の不具合の可能性があります。

このバージョンには「更新する」ボタンが動かない不具合があります。管理人から送られた **「NAI-Patch-v1.0.X.bat」**を実行してください。

不明な場合は管理人（中村）までご連絡ください。

💾 バックアップ

Q8. データのバックアップはどうなっていますか？

A: v1.0.4 から自動バックアップが動いています。

毎日 23:00 自動実行:
  ├ ローカル: C:\control-nai\backups\hanaten_YYYY-MM-DD_HHMMSS.db
  │         （30日分自動保持、古いものは削除）
  └ Google Drive: Control-NAI_Backup フォルダ
            （30日分自動保持）

二重バックアップなので万が一の事故にも強い構成です。

Q9. データが消えてしまいました。復旧できますか？

A: ほぼ確実に復旧できます。 自動バックアップが30日分残っています。

復旧手順（管理者操作）:

1. NAI サービス停止 (Stop-Service ControlNAI)
2. 壊れた C:\control-nai\hanaten.db を退避（リネーム）
3. C:\control-nai\backups\ から最新のバックアップをコピー
4. NAI サービス起動 (Start-Service ControlNAI)

または Google Drive の Control-NAI_Backup フォルダから DL して同じ手順。

不安な場合は管理人にご相談ください。

🖨 印刷・札

Q10. 札（葬儀札V2、祝/供札V2 など）の印刷がうまくいきません

A: 設定画面でプリンタ設定を確認してください。

NAI で札を直接印刷する場合：

• OKI C542 等の専用プリンタを設定済み
• 設定画面の print_* 系項目をご確認
• 用紙サイズ（195×594mm 等）が登録されている必要あり

最初のセットアップは技術サポートが必要です。管理人にご連絡ください。

Q11. 葬儀札V2 で入力中にフリーズします

A: v1.0.4 で修正済みです。

v1.0.3 までは「代表取締役+役職」のような特定の入力でエラーになる不具合がありました。v1.0.4 にアップデートしてください。

📧 メール送信

Q12. 請求書のメール送信ができません

A: SMTP 設定を確認してください。

設定画面の「メール設定」タブで：

• SMTP_HOST (例: smtp.gmail.com)
• SMTP_PORT (例: 587)
• SMTP_USER / SMTP_PASS （アプリパスワード）

Gmail を使う場合、Google アカウントの「2段階認証」を有効にした上で「アプリパスワード」を発行して使ってください。通常のパスワードでは送信できません。

詳しくは docs/setup-guides/01_SMTP設定手順書.md を参照。

🔑 ログイン・権限

Q13. ログインパスワードを忘れました

A: 管理人にご連絡ください。

NAI は staff_auth テーブルで認証情報を管理しています。パスワードリセットには DB 操作が必要なので、自分で復旧する手段はありません。

電話 or メールで「ログインできなくなった」とお知らせください。再発行手順をご案内します。

Q14. 「タイムカード初期セットアップ」画面が出ました

A: 管理者アカウントを作成すれば消えます。

1. プルダウンから自分（or 代表者）を選択
2. パスワード（4文字以上）を入力
3. 「管理者アカウントを作成」ボタン

これでタイムカード機能が使えるようになります。

🌐 外部接続

Q15. 外出先から NAI にアクセスしたい

A: Tailscale 経由でアクセス可能です。

セットアップは管理人と相談しながら：

• Tailscale アカウント発行・サーバーPCに導入済み
• お使いのスマホ/外出先PCにも Tailscale をインストール
• 同じネットワーク内になるので http://100.X.X.X:3000 でアクセス可能

詳しくは docs/setup-guides/04_Tailscale設定手順書.md を参照。

❓ その他

Q16. AIアシスタント（右下の🤖ボタン）が答えてくれない機能があります

A: NAI に実装されてない機能の質問の可能性があります。

AI アシスタントは claude-knowledge/features.md に記載された機能のみ正確に回答します。「○○できますか？」と聞いて「未実装です」と返ってきた場合は、本当に未実装です。

新機能のリクエストは管理人にご連絡ください。

Q17. 共創店として参加した場合、どこまで触っていいですか？

A: 自店のNAI は自由に改造OK、本部送信は提案フォームから。

• 各共創店PCのNAI: ご自身で改造可能（Claude Desktop推奨）
• 改造内容を本部に送る: 設定画面 → 修正提案
• 採用されると次回リリースに反映、全共創店に展開

詳しくは claude-knowledge/CLAUDE.md の「共創の流れ」セクションを参照。

連絡先

質問・相談・トラブル全般:

中村 聡 (花のナカムラ)
satoshinakamura416@gmail.com