点検管理プラグイン

点検管理プラグイン 操作マニュアル

• バージョン: 1.1.0
• 種別: APP（一覧カスタマイズビュー）
• ライセンス: AES-GCM方式のライセンス認証（必須）

できること

• 点検レコードを「車両×月（36ヶ月分）」のマトリクスでカード表示
• 予定日・実施日を管理し、ステータス（完了／超過／間近／予定）をアイコンと色で表示
• 車両マスタアプリ連携：点検レコードがない車両も一覧に表示
• 点検種類ごとの予定日自動計算（基準日＋月数オフセット。カンマ区切り 0,3,6,9 で複数件を一括作成）
• 個別作成（セルの＋）／一括作成（全点検種類）／CSV一括取り込み
• 営業所フィルタ、年度切替（◀▶）
• カードの表示項目・編集モーダルの表示項目をカスタマイズ可能
• セル背景色（基本／超過／実施済み）とヘッダー色をカスタマイズ可能

事前準備（点検アプリに必要なフィールド）

• 車両番号（文字列1行／数値／レコード番号／リンク）※必須
• 点検種類（ドロップダウン／ラジオボタン）※必須
• 予定日（日付）※必須
• 実施日（日付）※必須
• ［任意］車検有効期限（日付）、営業所（文字列1行／ドロップダウン／ラジオボタン）
• カスタマイズビュー（設定画面の「ビューを自動作成」で作成可）
• 車両マスタアプリ（車両キーフィールド必須、任意で有効期限／営業所フィールド）

設定手順（設定画面の上から順）

1. ライセンス設定（最上部・必須）: ライセンスキー／シークレットキーを入力。入力中にリアルタイム検証され、無効なライセンスでは保存できない
2. 車両マスタ設定: 車両マスタアプリID→「フィールド読込」→ 車両キーフィールド（必須）、有効期限／営業所フィールド（任意）、絞り込み条件（任意）、追加表示列
3. 基本フィールド設定: 車両番号・点検種類・予定日・実施日・（任意）車検有効期限・営業所
4. 点検種類設定: ドロップダウンの選択肢を読み込み、種類ごとに「基準日からの月数」を設定（空欄/0=基準日そのまま、0,3,6,9 で複数件）。CSV取り込み・個別／一括作成の予定日自動計算に使用
5. カード表示設定: カードに追加表示する項目を選択（予定日・実施日・点検種類は常に表示）
6. 編集モーダル表示設定: カードクリックで開く編集モーダルの表示・編集フィールドを選択（車両番号は常に表示専用で最上部）
7. 表示設定: 年度開始月（既定4月）、各色（基本／期限超過／実施済み／ヘッダー）、対象カスタマイズビュー（必須）

既定値

| 項目 | 既定 |

|---|---|

| 年度開始月 | 4月 |

| 基本の背景色 | #ffffff |

| 期限超過の警告色 | #ffebee |

| 実施済みの表示色 | #e8f5e9 |

| ヘッダー・ボタン色 | #455a64 |

設定画面で選択できるフィールド型

• 車両番号: SINGLE_LINE_TEXT / NUMBER / RECORD_NUMBER / LINK
• 点検種類: DROP_DOWN / RADIO_BUTTON
• 予定日・実施日・車検有効期限: DATE
• 営業所: SINGLE_LINE_TEXT / DROP_DOWN / RADIO_BUTTON
• 車両マスタ キー: SINGLE_LINE_TEXT / NUMBER / RECORD_NUMBER、有効期限: DATE、営業所: SINGLE_LINE_TEXT / DROP_DOWN / RADIO_BUTTON
• カード表示候補: SINGLE_LINE_TEXT / NUMBER / DATE / DROP_DOWN / RADIO_BUTTON / MULTI_LINE_TEXT / LINK / DATETIME / CHECK_BOX（車両番号・点検種類・予定日・実施日は除外）
• 編集モーダル候補: SINGLE_LINE_TEXT / NUMBER / DATE / DATETIME / TIME / DROP_DOWN / RADIO_BUTTON / MULTI_LINE_TEXT / LINK

判定ロジック（ステータス）

• 実施日あり → 完了
• 予定日が今日より前（未実施） → 超過
• 予定日まで14日以内 → 間近
• それ以外 → 予定
• 予定日の自動計算: 基準日 + 点検種類の「月数」（複数指定で複数件作成）
• 年度: 既定開始月は4月（設定可）。一覧は前年度〜翌々年（36ヶ月）を表示

一覧画面の使い方

• 年度切替（◀▶）、営業所フィルタで絞り込み
• カードクリック → 編集モーダル（フィールド編集／保存／削除）
• セルの＋（hoverで出現） → 個別作成モーダル（基準日入力で予定日を自動計算）
• 「一括作成」: 選択車両に有効な全点検種類のレコードを一括作成（基準日からプレビュー）
• 「CSV取り込み」: 車両×日付のCSVから一括作成（UTF-8／Shift_JIS自動判定、西暦・和暦・Excelシリアル値に対応。4ステップ：ファイル選択→列マッピング→プレビュー検証→実行）

セキュリティ

• 一覧マトリクス・各モーダルに表示するレコード値（車両名・点検種類・マスタ値・営業所名等）はすべてHTMLエスケープして描画（ストアドXSS対策）
• カラー設定値は #hex 形式を検証（CSSインジェクション対策）

注意事項

• 利用にはライセンス認証が必須。対象カスタマイズビューの指定も必須
• ライセンスが無効・期限切れ・サブドメイン不一致の場合、一覧上部にエラーを表示し、プラグイン機能は動作しない（kintone標準のレコード一覧操作は可能）
• kintone標準UIは非表示にしない（レコード一覧テーブルのみ非表示）
• レコードは全件取得（500件ずつページング、最大10000件）
• v1.0.0（キーなし版）から更新する場合: ライセンスキー／シークレットキーが未設定だとビューが表示されなくなるため、更新後に設定画面でライセンスを登録する必要がある

本マニュアルは plugin_inspection_v1_1_0.zip 内の実装に基づきます。