---
title: 顧客詳細の「取引履歴」を「案件履歴」にし、書類まで辿れるようにした
updated: 2026-09-01
---

# 2026-09-01 顧客詳細（案件履歴）

## 何を変えたか

- **「取引履歴」を「案件履歴」に改称。**中身も変えました。
- **この顧客の依頼が、金額の有無にかかわらず全部並びます。**
  以前は受注・請求のある依頼だけを出していましたが、**無料点検や、見積だけで失注した依頼も
  「以前この建物を見た」という記録**になるため、出すようにしました。
- **新しい順に並びます。**日付は**受注日**、まだ受注していない依頼は**登録日**（「登録」と表示）。
- **書類への直リンクを追加。**各行から **見積書 / 調査報告書・施工報告書 / 請求書** を直接開けます。
  **まだ作っていない書類はリンクが出ません**（押して「まだありません」に着く方が分かりにくいため）。
- **「すべての依頼を一覧で見る」の折りたたみを撤去。**案件履歴が同じ依頼を全部並べるようになり、
  同じ行が1画面に2回出る状態になったためです。

## AI影響

- [x] **プランのゲート（`App\Services\Entitlement`）を変えた？** → **影響なし。**
- [x] **ロールのゲート（誰が使えるか）を変えた？** → **影響なし。**
      書類のリンク先（見積修正・報告書編集・請求書編集）は、それぞれ従来どおりの権限で開きます。
      **リンクが出る＝開ける、ではありません。**リンクは「その書類が存在するか」だけで出しています。
- [x] **画面名・操作手順が変わった？** → **あり。**
      `manual/customer.md` の「顧客詳細から見えるもの」を書き換え。
      画面名（顧客詳細）は変えていないので `glossary/screens.md` の変更はありません
      （**案件履歴は画面ではなく、顧客詳細の中の見出し**です）。
- [x] **画面のURLを変えた？** → **なし。**
- [x] **新しいエラー文言が出るようになった？** → **影響なし。**
- [x] **文言は出ないが挙動が変わる現象が増えた？** → **あり（3件）。**
      1. 案件履歴の件数が**増えます**（金額の無い依頼を数えるようになったため）。
         **合計金額は変わりません**（金額の無い依頼は0円のため）。
      2. 並び順が「現場名順」から「**日付の新しい順**」に変わりました。
      3. 顧客詳細から**進捗ステップ（見積→受注→報告書→請求のバー）が見えなくなりました**。
         これは依頼一覧（`/projects/search`）と依頼詳細で見られます。
- [x] **用語が増減した？** → **あり。**「取引履歴」→「**案件履歴**」。
      顧客詳細の中の見出しなので、画面名の正本（`glossary/screens.md`）には影響しません。

## 実装のメモ（次に触る人へ）

- 金額の計算は `CustomerController::transactionRow()` の1箇所だけ。**画面側で足し算しない**
  （同じ数式が KPI と明細の2箇所にできると、合計と内訳が黙ってずれる）。
- 写真へのリンクは**入れていません**。PCに写真だけの画面が無く、行き先が依頼詳細か
  報告書編集になる＝依頼名のリンクと同じ場所になるためです。写真の入口を増やすなら、
  まず画面を作る話になります。