コンテンツにスキップ

車両コスト

車両コスト（OCR取込・明細・費目・ダッシュボード）

車両ごとの運行コスト（燃料費・整備・タイヤ・車検・保険・税・ETC 等）を登録・集計する業務。登録経路は「請求書・領収書 OCR 取込（複数カードをレビューして一括保存）」「手入力（1件）」の2つ、閲覧・分析は「コスト集計ダッシュボード」（タブ: 集計 / 運行ログ明細 / コスト明細 / 収入 P&L）で行う。ナビ表記は左サイドナビの「集計・分析」グループ内 「コスト集計」（パス /collector/fleet/costs、燃料アイコン）。

車両コスト集計とOCR入力画面のワイヤーフレーム

図: 車両コストの集計・入力画面。①手入力の入口　②請求書／領収書の複数カードOCRと原本確認　③費目・品目別内訳　④車両別・月次集計（凡例は図内）。

  • 対象ロール: admin / normal（＝collector staff）。driver は対象外（コスト系ルート・画面すべて COLLECTOR_STAFF_ROLES ガードで、driver には出ない／到達できない）。収入/P&L タブのみ admin 限定。
  • 前提:
  • 車両マスタ（「車両」/collector/fleet/vehicles）が登録済みであること（コスト行は必ず車両に紐づく。OCR の自動車両照合もナンバー索引に依存）。
  • normal ロールは所属工場スコープで見えるため、担当外工場の車両は選択肢に出ない（後述の注意参照）。
  • OCR 取込は請求書 PDF / 画像、または領収書の写真を用意する。

コスト集計ダッシュボードの閲覧（集計タブ）

  • 対象ロール: admin / normal
  • 前提: コストデータまたは運行ログが1件以上あること（無ければ空状態表示）。
  • 操作手順:
  • サイドナビ「コスト集計」(/collector/fleet/costs) を開く。画面上部タブは 「集計」「運行ログ明細」「コスト明細」（admin のみ 「収入/P&L」）。既定は「集計」。
  • 「絞り込み」パネルで 開始月 / 終了月（月選択）、工場（Select「すべて」）、車両（Select、ナンバー）、費目（Select、燃料費を除く）を指定して絞り込む。
  • サマリカードで「総コスト」「合計金額（燃料費を除く）」「燃料費」「走行距離」「給油量（軽油/アドブルー/ガソリン）」「燃費」「円/km」「費目別内訳」を確認する。
  • 下部の 「工場別 合計」「車両別 合計」「月次推移」「運行ログ 月次（車両別）」 テーブルを確認する。運行ログ月次テーブルは行クリックでその車両×月の日次運行ログにドリルダウン展開できる。
  • 確認/完了条件: 各カード・テーブルに金額/数量が表示される。閲覧のみで保存操作はない。
  • つまずき/注意:
  • 燃料費は運行ログの給油量(L)ではなくコスト入力(費目=燃料費)から集計する。燃料費のコスト入力が1件も無い期間は「燃料費 未確定」バッジが出て、総コスト・円/km も未確定扱い（給油量Lは別管理・二重計上防止）。
  • 費目 Select には「燃料費」が出ない（集計は fuel カテゴリを単一ソースにするため、絞り込み候補から除外）。
  • normal で「アクセスできる工場がありません」と出る場合は所属工場が未割当（管理者に割当依頼）。admin で同表示なら工場未登録（会社情報から登録）。

運行ログ明細タブ（＝日次運行ログ一覧）

  • 対象ロール: admin / normal
  • 前提: 日次運行ログ（ドライバー入力または事務代理入力）があること。
  • 操作手順:
  • 「コスト集計」画面で 「運行ログ明細」 タブを選ぶ。
  • 「絞り込み」で 月（クイック選択）/ 開始日 / 終了日 / 工場 / 車両 / ドライバー を指定する（工場・車両は集計タブと共有）。
  • 日次運行ログ（距離・給油量など）のフラット一覧を確認する。各行から運行ログの 「編集」（鉛筆アイコン）でその車両×日付の運行ログ編集へ遷移できる。
  • 確認/完了条件: 該当件数バッジと一覧が表示される。
  • つまずき/注意: このタブは 費目別のコスト行ではなく「日次運行ログ」（距離・給油量）を表示する。費目別のコストは隣の「コスト明細」タブで見る（名称に注意）。ドライバー列の「—」は記録なし（事務代理入力等）。

コスト明細タブ（＝費目別コスト入力の一覧）

  • 対象ロール: admin / normal
  • 前提: コスト入力（vehicle_cost_entries＝手入力 または 請求書・領収書 OCR 取込）があること。
  • 操作手順:
  • 「コスト集計」画面で 「コスト明細」 タブを選ぶ。
  • 「絞り込み」で 月（クイック選択）/ 開始日 / 終了日 / 工場 / 車両 / 費目 を指定する（工場・車両は集計タブと共有。費目 Select はここでは「燃料費」も含む全費目＝修繕費/燃料費/車検/保険/税/タイヤ/ETC/その他。集計タブの費目フィルタが fuel を除外するのとは別）。
  • 個別のコスト入力（修繕費・車検・税・燃料費など）を 日付 / 車両 / 費目 / 金額 / 仕入先 / メモ の列でフラット一覧表示する。明細行が保存されている行には 明細 N 件 が付き、末尾に「合計（燃料費含む）」が出る。
  • 明細 N 件 の行を展開して、保存済みの 品名 / 数量 / 単価 / 金額 を確認する。「明細を編集」から行の追加・削除・各項目の修正を行い、「明細を保存」を押す。
  • 行末の鉛筆アイコンで親コストの 日付 / 車両 / 費目 / 金額 / 税額 / インボイス登録番号 / 仕入先 / メモ を編集する。原本画像アイコンがある行は「原本プレビュー」で OCR 取込元を確認できる。
  • 確認/完了条件: 該当件数バッジと一覧・合計が表示される。明細編集の保存後は展開行へ反映され、親コストの編集後は一覧の値が更新される。
  • つまずき/注意: 明細合計と親コスト金額に差がある場合は差異を参考表示する。明細編集は親コスト金額を自動変更しない。

収入/P&L タブ

  • 対象ロール: admin のみ（normal・driver には表示されない）
  • 前提: 完了した二次搬出（運搬）＋車両コスト＋運搬費マスタ（排出元×搬出先）が登録されていること。
  • 操作手順: 「コスト集計」で 「収入/P&L」 タブを選び、開始月/終了月で期間を指定。サマリ（収入/費用/粗利）・費目別内訳・日次 P&L テーブルを確認する。
  • 確認/完了条件: 収入・費用・粗利が表示される。
  • つまずき/注意: normal には工場スコープ迂回リーク防止のためタブ自体を出さない（admin 限定）。「運搬費マスタに未登録のペアがあります」警告が出た場合、該当の排出元×搬出先の運搬費（/collector/secondary-transport-routes）を登録すると収入に反映される。

手入力でコストを1件登録

  • 対象ロール: admin / normal
  • 前提: 車両マスタが登録済み。
  • 操作手順:
  • 「コスト集計」画面右上の 「コスト入力」 ボタン（＋アイコン）→ /collector/fleet/costs/new。
  • 車両（必須・Select「車両を選択...」）、カテゴリ（必須・燃料費を除く費目）、計上日（必須・既定は本日）、金額 (円)（必須・0より大）、仕入先（任意）、メモ（任意）を入力。
  • 「保存」 を押す。
  • 確認/完了条件: 「コストを登録しました」トースト → コスト集計へ戻る。
  • つまずき/注意: 手入力フォームでは「燃料費」を選べない（カテゴリ候補から fuel を除外）。燃料費は二重計上防止のため請求書ベース（＝OCR取込 or 別ソース）で確定する設計。日次運行ログには給油量(L)のみ記録する。

請求書・領収書 OCR 取込（統合レビュー・一括登録）

  • 対象ロール: admin / normal（PR #139 で admin 限定から collector staff に開放。RLS の INSERT 権限と同水準）
  • 前提: 車両マスタ登録済み（OCR のナンバー自動照合に使用）。請求書 PDF/画像、または領収書の写真を用意。
  • 操作手順:
  • 「コスト集計」右上の 「コスト入力」 ボタン（admin/normal のみ表示）→ /collector/fleet/costs/new を開く。手入力フォームの上に「OCR 取込」カードが表示される。
  • 「請求書」または「領収書」を選ぶ。請求書は PDF / 画像を選択し、PDF はブラウザ内でページ画像化して逐次 OCR（最大 30 ページ、超過分は先頭 30 ページのみ・警告表示）。領収書はカメラ撮影または複数写真を選択できる（1 回の選択は最大 50 枚）。「解析中 n/m…」が進捗表示される。
  • OCR 完了後、請求書はページ／車両ブロック単位、領収書は写真単位の 下書きカード が並ぶ。カードには原本画像プレビュー、車両、費目、計上日、金額（税込）、税額、インボイス登録番号、仕入先／店名、メモ、明細行が表示され、低信頼の項目はハイライトされる。車両・金額などを確認・修正する。
  • カード内の「明細行」で 品名 / 数量 / 単価 / 金額 を追加・編集・削除できる。車両未選択や金額不正のカードは内容を補正してから保存する。原本画像は保存後もコスト明細の「原本プレビュー」から確認できる。
  • 「N 件を一括登録」 を押す。成功したカードは一覧へ保存され、失敗したカードは画面に残って再確認・再登録できる。
  • 確認/完了条件: 「N 件のコストを登録しました」トースト → コスト集計へ戻る。部分失敗時は成功カードのみ消え、失敗分が残って再試行できる。
  • つまずき/注意:
  • OCR 解析中は原本をブラウザでプレビューする。保存できたコストには原本画像が関連付けられ、後から「原本プレビュー」で確認できる。
  • 「車両を選択してください」バッジのカードは自動照合が付かなかった伝票。normal は自工場スコープのため他工場の車両が選択肢に出ず、車両を解決できないカードは保存せず管理者または手入力へ回す（OCR は Claude/Vision 課金を伴う prod-critical ルート）。

  • OCR 取込では 燃料費(fuel)も費目に選べる（請求書・領収書は燃料費の確定ソースになりうるため。手入力フォームだけが fuel 除外）。

  • 関連画面:

  • 車両マスタ「車両」/collector/fleet/vehicles（コスト行の紐づけ先・OCR 照合元）
  • 運行ログ入力（コスト集計右上「運行ログ入力」→ /collector/fleet/daily-logs/new）・日次運行ログ編集（明細タブ／集計タブのドリルダウンから）
  • 二次搬出運搬費マスタ /collector/secondary-transport-routes（P&L の収入・未登録ペア解消）
  • 費目マスタは固定8種（packages/shared の VEHICLE_COST_CATEGORIES）で、UI ラベルは 燃料費/メンテ費/車検/保険/税/タイヤ/ETC/その他（cost-labels.ts）。ユーザーが費目を追加する機能はない。