SYSTEM SPECIFICATION
運輸・飲料メーカーリスト リサーチシステム仕様書
Current Version: v74
Last Updated: 2025/12/12
📦 システム概要
本システムは、Google Sheets上で動作するGAS（Google Apps Script）ベースの業務支援アプリケーションです。運輸・飲料業界の人手不足解消を目的としたリスト作成業務において、リサーチ、紐付け、進捗管理、架電リストへの同期を一元管理し、作業効率とデータの整合性を最大化します。
🎯 目的
効率的な企業リサーチと、誤架電リスクを排除した高品質なリストの構築。
👤 対象ユーザー
リサーチ担当者、架電担当者、ディレクター（管理者）
🎨 UIコンセプト
現場主義・脳死操作
入力ガードや自動計算により、ユーザーが意識せずに正確なデータを作成できる設計。
🖥️ UI / メニュー構成
スプレッドシート上部に独自のカスタムメニューを展開します。
⚙️ コア機能詳細
1. リサーチ支援サイドバー（統合版）
画面右側に常駐し、リサーチ業務の中核を担うインターフェースです。
- タブ切り替えUI: 「🔗 紐づけ」と「📖 マニュアル」をタブで瞬時に切り替え可能。
- 自動サジェスト: 選択中の企業名に基づき、シート内の「類似企業」「同名他社」を自動検索して提示。
- 紐付けアクション: 親会社・子会社・拠点などの関係性を選択し、備考欄へ定型文を一括追記。
- 注意喚起機能: v71 Update シート内外の同名・類似企業に対する架電注意喚起を、範囲・度合いを指定して備考欄に追記。
2. 検索ランチャー（Search Launcher）
企業名を選択した状態で起動すると、以下のGoogle検索をワンクリックで実行できるモードレスダイアログを表示します。
検索プリセット:
- 🏢 会社概要
- 🌐 会社名 ＋ 住所（所在地確認用）
- 📞 電話番号
- ✉️ メールアドレス / お問い合わせ
- ✅ 採用 / 求人 / 外国人
- ❌ 倒産 / 破産 / 行政処分
3. 自動集計 & 進捗管理ロジック
「集計」シートのデータを更新し、進捗状況を可視化します。
- 時空の歪み補正: "1899/12/30" 基準の時刻データと、現在日付の時刻データが混在しても、正確に時間差分（稼働時間）を計算。
- NaN・文字列対策: v70 Fix 稼働予定セルに「35.00時間」のような単位が含まれていても、数値のみを抽出して計算を実行。
- 進捗色分け (GAS制御):
- ● 緑色: 目標達成、または順調（進捗率以上のペース）。
- ● 赤色: 遅延発生、または働きすぎ（マイナス乖離）。
- ● 薄黄: まだ稼働枠が残っている状態。
4. リスト同期 (Generator & Sync)
リサーチ完了分を「架電リスト」へ転記します。v72より同期機能が強化されました。
同期ロジック:
- 新規追加: まだリストにない「完了(情報あり)」の企業を新規行として追加。
- 差分更新: v72 New 既にリストにある企業について、リサーチシート側で「メール」「電話番号」「備考」が修正されていた場合、その項目のみを上書き更新します。
※架電担当者が入力するステータスや架電結果列は保護され、上書きされません。
5. 備考欄フォーマット統一
スプレッドシートの1行表示における視認性を確保するため、以下のルールを強制します。
🛑 改行禁止ルール
備考欄への追記は、改行コード（\n）を使用せず、セパレーター ■ を使用して1行に記述します。
これにより、セルをダブルクリックせずとも内容の有無が視認可能になります。
🛡️ 安全装置・入力ガード
時刻列ガード (onEdit)
開始・終了時刻列（F/G列）に誤って「日付」を入力すると、自動検知して警告を表示または修正します。
ピッタリ退勤
現在の行のタスクを何時に終えれば「今月の目標時間」にピッタリ着地するかを逆算し、終了時刻を自動入力します。
過去データ修正 (Hidden)
備考欄に含まれる改行を一括で「 ■ 」に変換するメンテナンス機能（v74ではメニュー非表示、コード内に保持）。