管理者 操作ガイド(全文)

トップへ

スム住む 管理者(Admin)向け取扱説明書



本書は、退去立会い・修繕管理SaaS「スム住む」における管理者(Admin)ロールの操作手順をまとめた実務者向けガイドです。テナント登録からパートナー招待、新規依頼の受付、見積作成と承認依頼、受注・施工・発注、完了報告、請求・入金管理まで、日常運用で必要な画面・機能を網羅します。

対象読者: 管理者(退去立会い代行会社の担当者/管理者)

クイックスタート(全体フロー)



1) テナント登録 → 2) 初期設定 → 3) 顧客/協力会社招待 → 4) 依頼受付・案件化 → 5) 見積作成 → 6) 顧客承認 → 7) 工程計画/発注 → 8) 作業/完了報告 → 9) 請求/入金 → 10) 業者請求の検収/支払予定管理

  • **ログイン**: `~/login`
  • **テナント登録**: `~/tenant-register`
  • **初期セットアップ**: `~/admin-setup`
スクショ挿入: 「ダッシュボード」「全体フロー図(テキストでも可)」

ナビゲーションとレイアウト



  • 管理者向けページの共通プレフィックスは `~/admin/*`
  • 上部/左側ナビから主要機能へ遷移できます
  • 役割別にUIが分かれているため、顧客/協力会社向けURL(`~/customer/*`, `~/contractor/*`)とは機能が異なります
スクショ挿入: 「管理者ナビゲーションの全体像」

初期設定



1. テナント登録と初回ログイン



  • 新規事業者登録: `~/tenant-register`
  • ログイン: `~/login`
スクショ挿入: 「テナント登録フォーム」「ログイン画面」

2. 初期セットアップウィザード



  • 画面: `~/admin-setup`
  • 会社情報、担当者情報、基本設定の確認を行います
スクショ挿入: 「初期セットアップの各ステップ」

3. 会社設定 / プロフィール / 通知設定



  • 会社設定: `~/company` または `~/common/company-settings`
  • プロフィール: `~/common/profile`
  • 通知設定: `~/admin/notification-settings`
スクショ挿入: 「会社設定フォーム」「プロフィール編集」「通知設定トグル」

顧客・パートナー管理



顧客(不動産管理会社)管理



  • 一覧: `~/admin/customers/index`
  • 詳細: `~/admin/customers/[id]/index`
  • 編集: `~/admin/customers/[id]/edit`
  • 新規作成: `~/admin/customers/create`
主な操作:
  • 顧客の基本情報登録、担当者の紐づけ
  • 進行案件/見積/請求の把握
スクショ挿入: 「顧客一覧のフィルタ」「顧客新規作成フォーム」

協力会社(施工業者)管理・招待



  • 協力会社一覧: `~/admin/contractors`
  • パートナー招待送信: `~/invite-partners`
  • 招待状況/履歴: `~/users/invitations/index`
  • 協力会社の登録(受信側): `~/contractor-register`
  • 顧客の登録(受信側): `~/customer-register`
主な操作:
  • 協力会社/顧客の招待メール送信
  • 招待の再送/取消(必要に応じて)
スクショ挿入: 「招待フォーム(ロール選択・送信)」「招待一覧(ステータス)」

案件(プロジェクト)管理



案件一覧/詳細



  • 一覧: `~/admin/project/index`
  • 詳細: `~/admin/project/[id]`
主な操作:
  • 新規依頼の取り込み、案件ステータス管理
  • 現地作業の予定、見積/発注/完了/請求の進捗把握
スクショ挿入: 「案件一覧(検索/フィルタ/ステータス)」「案件詳細(タブ構成)」

現地業務(退去アプリ)との連携



  • 現地アプリ入口: `~/moveout_app/[projectId]`
  • 現地チェック: `~/moveout_app/check`, `~/moveout_app/room-check`
  • マスタ(部屋・アイテム等): `~/moveout_app/master/index`
  • 精算プレビュー: `~/moveout_app/settlement-preview`
  • 精算(見積生成): `~/moveout_app/settlement`
  • 完了: `~/moveout_app/completed`
主な操作:
  • 立会いチェック入力 → 精算プレビューで自動計算確認 → 見積たたき台生成
スクショ挿入: 「チェック入力画面」「精算プレビュー」「確定ダイアログ」

現場写真管理



  • 現地写真: `~/admin/project/site-photos/[id]`
  • 完了写真: `~/admin/project/completion-photos/[id]`
主な操作:
  • 写真のアップロード/分類/確認(作業前・作業後の比較)
スクショ挿入: 「写真アップロードUI(ドラッグ&ドロップ/枚数表示)」

鍵管理(参照)



  • 顧客側画面: `~/customer/project/key-management/[id]`
  • 鍵の受け渡し履歴は案件詳細から参照(導線がある場合)
スクショ挿入: 「鍵管理ビュー(受渡・返却)」

見積(Quotation)



見積一覧/作成/編集



  • 一覧: `~/admin/quotation/index`
  • 新規作成: `~/admin/quotation/new`
  • 詳細/編集: `~/admin/quotation/[id]`
操作手順(例): 1. 案件または見積メニューから新規作成 2. 明細行の追加(カテゴリ、項目、数量、単価を入力) 3. 税・割引・調整額の設定 4. 添付/備考の記載 5. 下書き保存 → 顧客へ承認依頼の送付

補足:
  • 料金マスタと連動している場合、カテゴリ選択で推奨単価が反映されます
  • 面積ガイドに基づく数量/工数の目安を参考にしてください
スクショ挿入: 「見積編集(行追加/税設定/プレビュー)」

顧客承認フロー



  • 顧客の確認/承認画面: `~/customer/quotation/[id]`
  • 差戻し/コメント対応後は、再送信で承認取得を目指します
スクショ挿入: 「承認依頼送信UI(メッセージ/リンク)」

受注・施工・工程管理



工事情報・工程計画



  • 工事情報: `~/admin/project/construction/[id]`
  • 作業計画(工数/工程): `~/admin/project/work-schedule/[id]`
  • 個別予定(担当/日別): `~/admin/project/schedule/[id]`
  • 外部候補日程(入居者/関係者共有): `~/schedule/select/[token]`
主な操作:
  • 見積承認後、作業WBS/担当割当/日程確定
  • ガント/カレンダーで進行中タスクを把握
スクショ挿入: 「工程表(ガント)」「担当アサインUI」

協力会社発注



  • 発注新規: `~/admin/project/contractor-order/new`
  • 発注詳細: `~/admin/project/contractor-order/[id]`
主な操作:
  • 発注明細・納期・条件の設定
  • 協力会社への通知・受注状況の確認
スクショ挿入: 「発注作成フォーム(明細/納期/添付)」

完了報告



  • 完了入力: `~/admin/project/completion/[id]`
  • 完了写真: `~/admin/project/completion-photos/[id]`
主な操作:
  • 作業完了内容のサマリー、検査チェックの記録、署名/確認
スクショ挿入: 「完了報告入力(サマリー/確認項目)」

請求・入金管理(自社→顧客)



請求



  • 請求一覧: `~/admin/invoices/index`
  • 請求詳細: `~/admin/invoice/[id]`
- 画面内印刷: `~/admin/invoice/[id]/print` - 印刷リンク共有: 請求画面の「共有」→「印刷用リンクをコピー」で共有(ログイン不要)

主な操作:
  • 案件/見積から請求を作成(請求先、請求日、支払期日、明細、税設定)
  • 請求書のプレビュー/印刷、共有用公開URLの管理
スクショ挿入: 「請求詳細(請求先/明細/税)」「印刷プレビュー」

注意:
  • 共有前に表示内容(自社名・顧客名・金額・期日)を必ず確認してください

入金(消込)



  • 入金管理: `~/admin/invoices/payments`
主な操作:
  • 入金登録、差額/手数料の調整、消込ステータス更新
スクショ挿入: 「入金登録ダイアログ」「消込一覧」

協力会社請求(原価管理)



  • 業者請求管理: `~/admin/invoices/contractor-invoices`
主な操作:
  • 協力会社からの請求(検収/支払予定)を一元管理
  • 発注との紐づけで原価/粗利を把握
スクショ挿入: 「協力会社請求一覧(検収/支払予定)」

単価・マスター・タスク・設定



単価/料金設定



  • 画面: `~/admin/pricing`
主な操作: カテゴリ/品目の単価・係数を管理。見積時に反映されます。

スクショ挿入: 「料金テーブル編集(カテゴリ/品目/単価)」

面積ガイド(基準値)



  • 画面: `~/admin/master/area-guidelines`
主な操作: 物件タイプ別の面積目安を管理し、現地精算や見積時の指標に活用します。

スクショ挿入: 「面積ガイド編集」

タスク管理



  • 画面: `~/admin/tasks/index`
主な操作: 案件横断のToDo/指示を管理。期限・担当・ステータスで整理。

スクショ挿入: "タスク一覧(担当/期限/ステータス)"

通知設定



  • 画面: `~/admin/notification-settings`
主な操作: メール/アプリ内通知のオン/オフ、頻度の調整。

スクショ挿入: 「通知トグル」

カレンダー/スケジュール



  • 社内/工事カレンダー: `~/admin/calendar`
  • 個別案件のスケジュール: `~/admin/project/schedule/[id]`
  • 外部候補日程(共有リンク): `~/schedule/select/[token]`
活用ポイント:
  • 月/週/日ビューで俯瞰 → ボトルネックの早期発見
  • 外部候補リンクで顧客/入居者に日程選択を依頼
スクショ挿入: 「カレンダー(ビュー切替/フィルタ)」

よくある業務フロー(管理者視点)



A. テナント登録〜初期設定

1. `~/tenant-register` で登録 2. `~/admin-setup` で会社/担当者/基本設定を確認 3. `~/company` または `~/common/company-settings` で詳細調整 4. `~/invite-partners` で顧客・協力会社に招待送付(受信側は `~/customer-register` / `~/contractor-register`) 5. `~/common/profile` で担当者プロフィールを整える

スクショ挿入: 「テナント登録」「セットアップ」「招待送信」

B. 新規依頼〜見積

1. 顧客が `~/customer/request` から依頼送信 2. 管理者は `~/admin/project/index` で案件化、現地対応計画 3. 現地で `~/moveout_app/*` を使いチェック → 精算プレビュー 4. `~/admin/quotation/new` または `~/admin/quotation/[id]` で見積作成 5. 顧客は `~/customer/quotation/[id]` で承認/差戻し

スクショ挿入: 「依頼フォーム」「退去アプリ」「見積編集」「承認画面」

C. 承認後〜施工〜完了

1. `~/admin/project/work-schedule/[id]` で工程計画、担当割当 2. 必要に応じて `~/admin/project/contractor-order/new` で発注 3. 協力会社は `~/contractor/orders/[id]` で受注確認し進捗更新 4. 完了後、協力会社が `~/contractor/project/completion-photos/[id]` に完了写真 5. 管理者は `~/admin/project/completion/[id]` で完了報告、顧客は `~/customer/project/final-check/[id]` で検収 6. 再点検要望は `~/customer/project/reopen-check/[id]`

スクショ挿入: 「工程表」「発注作成」「注文詳細」「完了報告」「最終確認」

D. 請求・入金/業者請求

1. `~/admin/invoices/index` から請求作成 → `~/admin/invoice/[id]` 2. 顧客は `~/customer/invoices/index` → `~/customer/invoice/[id]` で確認/印刷 - 印刷リンク共有: 請求画面の「共有」→「印刷用リンクをコピー」 3. 入金は `~/admin/invoices/payments` で登録・消込 4. 協力会社からの請求は `~/contractor/invoices/create`(作成)→ 管理者は `~/admin/invoices/contractor-invoices` で検収

スクショ挿入: 「請求詳細」「入金登録」「協力会社請求の検収」

運用のコツ(ベストプラクティス)



  • **プロジェクト中心主義**: 案件詳細を中核に、見積→工程→完了→請求を前後の文脈で把握
  • **印刷リンクの管理**: 請求画面の「共有」からリンクを再発行・コピーして共有
  • **発注と業者請求の整合**: 発注明細と協力会社請求を突合し、原価/粗利をモニタリング
  • **写真運用**: 作業前/後の写真は同一アングル・十分な解像度で
  • **面積ガイド**: 物件タイプ更新時に `~/admin/master/area-guidelines` を見直し、現地/見積の精度を高める


FAQ / トラブルシューティング



  • Q. ログインできません
- A. メール/パスワードの再確認、パスワードリセット、管理者への権限確認を依頼

  • Q. 招待メールが届きません
- A. 迷惑メールを確認、ドメイン許可、再送。受信側は `~/customer-register` / `~/contractor-register` で登録可能

  • Q. 見積が承認されません(リンクが開けない)
- A. 顧客側URL `~/customer/quotation/[id]` を案内。社内確認のためプレビューを共有

  • Q. 現地写真がアップロードできない
- A. 画像サイズ・回線状況を確認。時間をおいて再試行

  • Q. 請求書の印刷が開けない/内容が違う
- A. 請求画面の「共有」→「印刷用リンクを再発行」から開き直してください

  • Q. スケジュール候補リンクが無効
- A. `~/schedule/select/[token]` のトークン期限/権限を確認し、再発行

付録A: 管理者向けURL早見表



  • ダッシュボード: `~/admin/dashboard`
  • カレンダー: `~/admin/calendar`
  • タスク: `~/admin/tasks/index`
  • 顧客: `~/admin/customers/index`, `~/admin/customers/[id]/index`, `~/admin/customers/create`
  • 協力会社: `~/admin/contractors`
  • 案件: `~/admin/project/index`, `~/admin/project/[id]`
  • 現地写真: `~/admin/project/site-photos/[id]`
  • 完了写真: `~/admin/project/completion-photos/[id]`
  • 工事/工程: `~/admin/project/construction/[id]`, `~/admin/project/work-schedule/[id]`, `~/admin/project/schedule/[id]`
  • 見積: `~/admin/quotation/index`, `~/admin/quotation/new`, `~/admin/quotation/[id]`
  • 発注: `~/admin/project/contractor-order/new`, `~/admin/project/contractor-order/[id]`
  • 完了報告: `~/admin/project/completion/[id]`
  • 請求: `~/admin/invoices/index`, `~/admin/invoice/[id]`, `~/admin/invoice/[id]/print`
  • 入金: `~/admin/invoices/payments`
  • 業者請求: `~/admin/invoices/contractor-invoices`
  • 単価: `~/admin/pricing`
  • 面積ガイド: `~/admin/master/area-guidelines`
  • 通知設定: `~/admin/notification-settings`
  • 会社設定/プロフィール: `~/company`, `~/common/company-settings`, `~/common/profile`
  • 初期セットアップ: `~/admin-setup`


付録B: スクショ差し込みチェックリスト(管理者版)



  • ダッシュボード(KPI/未処理)
  • カレンダー(月/週/日ビュー)
  • 顧客一覧/新規作成フォーム
  • 協力会社一覧/招待フォーム/招待一覧
  • 案件一覧/詳細(タブ)
  • 退去アプリ(チェック→精算プレビュー→確定)
  • 現地写真/完了写真のアップロードUI
  • 見積編集(明細/税/割引/プレビュー)
  • 工程表(ガント)、担当アサインUI
  • 発注作成/発注詳細
  • 完了報告(サマリー/確認)
  • 請求詳細/印刷プレビュー/公開URL
  • 入金登録・消込一覧
  • 業者請求の検収/支払予定
  • 単価/面積ガイド/通知設定


用語集(抜粋)



  • 案件(プロジェクト): 依頼から完了/請求まで一連の業務単位
  • 退去アプリ: 現地チェック/精算を行うモバイル想定の簡易UI群
  • 面積ガイド: 建物種別等に応じた作業量の目安テーブル
  • 公開印刷URL: ログイン不要で請求書を表示/印刷できる共有用リンク


---

本書は管理者ロールの主要画面を中心に記述しています。顧客・協力会社の画面仕様や相互のやり取りは、必要箇所で相互参照を付けています。スクショ撮影の順番や注釈テキストが必要であれば、上記「スクショ差し込みチェックリスト」に沿って撮影いただき、画像ファイル名と配置箇所の指示をお知らせください。

画面別操作ガイド(詳細)



以下は管理者が日常的に利用する画面を、導線、前提条件、操作手順、入力項目、検証ルール、よくある躓きポイント、スクショ指示の順で整理しています。各節は、そのまま研修資料としても使えるように粒度を揃えています。

ダッシュボード(~/admin/dashboard)



  • 目的: 今日やるべきこと、遅延の兆候、重要アラートを素早く把握
  • 前提: ログイン済み、テナントとユーザー権限が有効
  • 主なウィジェット:
- 進行中案件数、ステータス別分布 - 未承認の見積件数 - 今週の作業予定(抜粋) - 未消込の請求、期限超過の入金 - 最近の通知
  • 操作手順:
1. ウィジェットの数値をクリックして該当リストに遷移 2. フィルタ(担当/期間)で表示を絞り込み 3. 重要通知を開いて次アクションへ
  • 検証/注意:
- 時系列がずれて見える時はブラウザのタイムゾーン設定を確認 - データが空の場合は、案件や見積が未登録の可能性
  • スクショ挿入: 「全体ウィジェット」「通知ドロワー」

カレンダー(~/admin/calendar)



  • 目的: 社内/現場の予定を俯瞰、休日や稼働率を確認
  • 表示: 月/週/日 切替、担当者フィルタ、案件フィルタ
  • 操作:
1. イベントクリックで案件/タスク詳細へジャンプ 2. ドラッグで日付変更(権限により制限あり) 3. フィルタで特定現場/担当の稼働を見る
  • スクショ: 「月/週/日ビュー」「担当フィルタ」

顧客管理(~/admin/customers/*)



  • 一覧(~/admin/customers/index)
- 列例: 顧客名、担当者数、進行案件、未承認見積、未払額 - フィルタ: キーワード、状態、取引量レンジ - よくある操作: 詳細へ、編集へ、新規作成へ - スクショ: 「フィルタバー」「行アクション」
  • 詳細(~/admin/customers/[id]/index)
- タブ例: 概要、案件、見積、請求、連絡先 - スクショ: 「概要タブ」「案件タブ」
  • 新規/編集(~/admin/customers/create, ~/admin/customers/[id]/edit)
- 入力項目例: - 基本: 顧客名、部署/担当、メール、電話 - 請求先: 住所、郵便、請求締、支払条件 - 通知: 承認依頼の通知先、CC - 検証: メール形式、郵便番号形式、必須チェック - スクショ: 「新規フォーム(上部/下部)」

協力会社管理/招待(~/admin/contractors, ~/invite-partners, ~/users/invitations/index)



  • 一覧(~/admin/contractors)
- 列例: 業者名、担当、受注件数、評価、支払条件 - 行アクション: 詳細、連絡、取引停止 - スクショ: 「一覧とアクション」
  • 招待(~/invite-partners)
- 入力: メール、ロール(顧客/協力会社)、メッセージ - 操作: 送信、再送、取消 - スクショ: 「招待フォーム」
  • 招待状況(~/users/invitations/index)
- ステータス: 送信済/開封/登録完了/期限切れ - スクショ: 「ステータス一覧」

案件管理(~/admin/project/*)



  • 一覧(~/admin/project/index)
- 列例: 案件No、物件、顧客、ステータス、担当、進捗、請求額 - フィルタ: ステータス、顧客、期間、担当、キーワード - 一括操作: 担当変更、ステータス更新(実装有無は環境による) - スクショ: 「フィルタと一覧」
  • 詳細(~/admin/project/[id])
- 代表タブ: - 概要: 基本情報、関係者、期日 - スケジュール: `~/admin/project/schedule/[id]` への導線 - 写真: `~/admin/project/site-photos/[id]`, `~/admin/project/completion-photos/[id]` - 見積: `~/admin/quotation/index`/`~/admin/quotation/[id]` - 発注: `~/admin/project/contractor-order/*` - 完了: `~/admin/project/completion/[id]` - 請求: `~/admin/invoices/index`/`~/admin/invoice/[id]` - スクショ: 「概要タブ」「タブ間の導線」

現地写真(~/admin/project/site-photos/[id], ~/admin/project/completion-photos/[id])



  • 操作: ドラッグ&ドロップでアップロード、タグ/カテゴリ付与、拡大/比較
  • 注意: 通信不安定時は数枚ずつ、ブラウザを閉じない
  • スクショ: 「アップロードUI」「サムネイル/拡大」

見積(~/admin/quotation/index, ~/admin/quotation/new, ~/admin/quotation/[id])



  • 一覧
- 列例: 見積No、案件、顧客、金額、状態(下書/送付/承認/差戻) - 操作: 新規作成、複製、PDF/印刷(環境依存)
  • 新規/編集
- 明細行の構成: 品目、説明、数量、単位、単価、税区分、割引、計 - 合計部: 小計、消費税、割引/調整、総計 - 操作手順: 1. 案件/顧客の紐づけ確認 2. 行を追加し、カテゴリ→品目→数量→単価の順で入力 3. 税/割引/調整を設定 4. 下書き保存→承認依頼送付 - バリデーション: 空行の保存防止、数値/税率の形式、負値の扱い - スクショ: 「行追加UI」「合計セクション」「承認依頼ボタン」

工程/スケジュール(~/admin/project/work-schedule/[id], ~/admin/project/schedule/[id])



  • 工程計画
- ガント/リスト表示(実装に準拠) - タスク: 名称、開始/終了、担当、依存関係、進捗 - 操作: 追加、ドラッグで期間調整、担当割当 - スクショ: 「工程表」「担当アサイン」
  • 個別スケジュール
- 日/週ビューで該当案件の割当を確認 - 外部候補リンク `~/schedule/select/[token]` を共有可能 - スクショ: 「日程候補共有UI」

協力会社発注(~/admin/project/contractor-order/new, ~/admin/project/contractor-order/[id])



  • 新規
- 入力: 発注先、案件、納期、支払条件、明細、備考、添付 - 操作: 明細追加、見積/工程との整合確認、発注送信 - スクショ: 「発注フォーム」「明細追加」
  • 詳細
- ステータス: 下書/送付/受注/納品/検収/完了 - 操作: ステータス更新、検収登録、関連請求確認 - スクショ: 「ステータス遷移」

完了報告(~/admin/project/completion/[id])



  • 入力: 完了日、完了内容、チェック項目、サイン(実装に準拠)
  • 添付: 完了写真、確認書類
  • スクショ: 「完了入力」「添付セクション」

請求/印刷/入金(~/admin/invoices/index, ~/admin/invoice/[id], ~/admin/invoice/[id]/print, ~/admin/invoices/payments)



  • 請求一覧
- 列例: 請求No、顧客、案件、金額、支払期日、入金状況 - フィルタ: 期間、顧客、未入金/一部入金/入金済 - スクショ: 「フィルタと一覧」
  • 請求詳細
- 入力: 請求先、請求日、期日、明細、税/割引、振込先 - 操作: 発行、印刷、共有リンク作成(「印刷用リンクをコピー」) - スクショ: 「請求詳細」「印刷プレビュー」
  • 入金
- 登録: 入金日、金額、手数料、備考 - 消込: 明細との突合、差額調整 - スクショ: 「入金登録ダイアログ」

業者請求(~/admin/invoices/contractor-invoices)



  • 概要: 協力会社からの請求を検収/支払予定管理
  • 列例: 請求No、協力会社、関連発注、金額、支払日、検収
  • 操作: 検収登録、支払予定の設定、エビデンス添付
  • スクショ: 「業者請求一覧」「検収フォーム」

単価/料金(~/admin/pricing)



  • 構成: カテゴリ、品目、単価、単位、係数、税区分
  • 操作: 新規/編集、並び替え、カテゴリ間の比較
  • スクショ: 「単価表」「品目編集モーダル」

面積ガイド(~/admin/master/area-guidelines)



  • 概要: 建物種別/間取り等に応じた面積目安を管理
  • 操作: 新規/編集、タイプ別の推奨値更新
  • スクショ: 「面積ガイド表」「編集」

タスク(~/admin/tasks/index)



  • 列例: タスク名、案件、担当、期限、優先度、状態
  • 操作: 追加、担当/期限変更、状態更新、コメント
  • スクショ: 「タスク一覧」「編集モーダル」

通知設定(~/admin/notification-settings)



  • 通知チャネル: メール/アプリ内
  • 対象イベント: 見積承認、発注受注、入金、再点検依頼など
  • 操作: ON/OFF、頻度
  • スクショ: 「通知トグル」「イベント一覧」


フィールド・入力項目リファレンス(抜粋)



顧客

  • 顧客名(必須)
  • 部署/担当者名
  • メール(形式チェック)
  • 電話(数字/記号許可)
  • 請求先住所/郵便
  • 請求締・支払条件(選択)
  • 通知先メール/CC

協力会社発注

  • 発注先(必須)
  • 案件(必須)
  • 納期/希望日
  • 支払条件
  • 明細: 品目、数量、単位、単価、税、備考
  • 添付(任意)

見積

  • 案件/顧客(必須)
  • 明細: カテゴリ、品目、説明、数量、単位、単価、税区分、割引
  • 備考/注釈
  • 小計/税/総計(自動計算)

請求

  • 請求先(必須)
  • 請求日/期日
  • 明細/税/割引
  • 振込先
  • 合計金額(自動計算)

入金

  • 入金日(必須)
  • 金額(必須)
  • 手数料/差額
  • メモ


ステータス定義と遷移(例)



見積

  • 下書 → 送付 → 承認(または 差戻)
  • 差戻 → 修正 → 再送付(承認へ)

発注

  • 下書 → 送付 → 受注 → 納品 → 検収 → 完了

案件

  • 受付 → 現地 → 見積 → 承認 → 施工 → 完了 → 請求 → クローズ

請求

  • 発行前 → 発行 → 一部入金 → 入金済 → 差額調整/完了


通知とイベント(運用)



  • 見積の承認/差戻通知 → 顧客/社内へ
  • 発注の受注通知 → 協力会社/社内へ
  • 完了報告通知 → 顧客へ検収依頼
  • 請求発行通知 → 顧客の経理担当へ
  • 入金登録通知 → 案件担当へ
運用のポイント:
  • 過剰通知は避け、重要イベントに絞る
  • 通知メールの件名/本文に案件Noと物件名を含める


検索/フィルタの活用



  • 一覧画面では、複合条件(顧客+期間+状態)で絞り込み
  • 保存済みフィルタ(実装による)を活用し、定型ビューを共有
  • キーワード検索は案件No/顧客名/物件名をカバー


エラー/トラブル対応(追加)



  • 画像アップロードでタイムアウト
- 対応: 枚数を減らす、圧縮、回線変更
  • 印刷のレイアウト崩れ
- 対応: ブラウザの印刷設定で余白/ヘッダフッタを無効
  • 招待リンク期限切れ
- 対応: 招待を再発行、別メールアドレスを試す
  • 工程のドラッグができない
- 対応: 権限確認、ロック状態の解除

運用チェックリスト(実務)



  • 朝会前
- 遅延タスク/期限超過の確認(ダッシュボード) - 当日作業のリソースチェック(カレンダー)
  • 現地対応前
- 現場情報/鍵/担当の再確認、退去アプリの動作確認
  • 見積送付前
- 計算/税/割引のダブルチェック、承認者の宛先確認
  • 施工開始前
- 発注の受注確認、資材/職人の確保、工程のリスク
  • 完了報告前
- 写真の不足なし、チェック項目の網羅
  • 請求発行前
- 顧客請求先の表記ゆれ/締日/支払条件の確認
  • 月末
- 未入金の督促計画、業者請求の検収・支払予定整理

ショートカット/時短TIPS



  • 案件Noコピーから各画面の検索にペースト
  • 一覧の列幅調整で重要列を固定(実装に依存)
  • 既存見積の複製→修正で作業短縮


付録C: 文面テンプレート(承認依頼/督促)



見積承認依頼(顧客向け)

件名: 【見積承認のお願い】案件No: {{案件No}} / 物件: {{物件名}}

{{ご担当者名}} 様\ いつもお世話になっております。{{会社名}}の{{自社担当}}です。\ 下記案件の見積書をご確認いただき、承認または差戻しのご対応をお願いいたします。\ ・案件: {{案件名}}({{案件No}})\ ・物件: {{物件名}}\ ・見積金額: {{金額}}円(税込)\ 承認画面: {{customerQuotationUrl}}\ ご不明点がございましたら本メールにご返信ください。

請求書送付(顧客経理向け)

件名: 【請求書送付】案件No: {{案件No}} / 請求No: {{請求No}}

{{ご担当者名}} 様\ 請求書をお送りいたします。お手数ですが支払期日までのご手配をお願いいたします。\ ・請求書: {{publicPrintUrl}}\ ・支払期日: {{期日}}\ ・合計金額: {{金額}}円(税込)\ 振込先は請求書内に記載しております。

入金督促(期日超過)

件名: 【ご入金のお願い】請求No: {{請求No}}(期日 {{期日}})

{{ご担当者名}} 様\ 平素よりお世話になっております。未入金となっている下記請求につきましてご確認をお願いいたします。\ ・請求No: {{請求No}}\ ・金額: {{金額}}円(税込)\ ・期日: {{期日}}\ ご入金済みの場合は行き違いの旨ご連絡ください。

付録D: URLマップ(管理者拡張版)



  • Admin ルート: `~/admin/*`
  • 顧客/協力会社/ヘルプ: `~/customer/*`, `~/contractor/*`, `~/help/*`
  • 印刷: `~/admin/invoice/[id]/print`(共有は請求画面の「共有」ボタンから)
  • 退去アプリ: `~/moveout_app/*`


付録E: スクショ差し込み詳細(撮影指示)



  • 解像度: 1440px幅以上推奨、100%倍率
  • 枠: ブラウザUIは除外、アプリ画面のみ
  • 強調: 重要ボタン/入力欄に枠線や番号を後加工
  • 命名: `admin-<機能>-<連番>.png`(例: `admin-quotation-01.png`)


付録I: 月次/週次の運用プレイブック



週次(毎週月曜 朝)

1. ダッシュボードで遅延案件/期限超過タスクをリストアップ 2. カレンダーで今週の稼働率を確認し担当過不足を調整 3. 見積の承認待ちを催促(テンプレ活用/付録C) 4. 協力会社の受注/納品予定を発注画面で確認

月次(月初/中間/月末)

  • 月初: 先月未入金の督促スケジュール作成(入金一覧のフィルタ)
  • 月中: 進行案件の粗利見込みチェック(見積/発注/請求の突合)
  • 月末: 請求発行締め、入金見込みの最終確認、業者請求の検収/支払予定確定
チェックリスト:
  • [ ] 遅延ゼロ化プラン更新
  • [ ] 大口顧客の承認/請求の進捗報告
  • [ ] 発注と業者請求の差異チェック


付録J: 検索/フィルタ実例(保存ビュー案)



案件一覧(~/admin/project/index)

  • 保存ビュー例:
- 「今月完了予定」: ステータス=施工/完了前, 期日=今月 - 「承認待ち」: ステータス=見積, 顧客承認=未 - 「新規受付(直近7日)」: 作成日=直近7日

見積一覧(~/admin/quotation/index)

  • 保存ビュー例:
- 「差戻し対応」: 状態=差戻, 顧客=全件 - 「高額見積」: 金額>=50万円

請求一覧(~/admin/invoices/index)

  • 保存ビュー例:
- 「今月発行」: 請求日=今月 - 「未入金(期限超過)」: 期日<今日, 入金状況=未 - 「要消込」: 入金あり/未消込

付録K: 写真運用ガイド(作業前/後・分類・証跡)



推奨ルール:
  • 作業前/後の同一アングル撮影を徹底し、比較が容易な状態を作る
  • 画質は長辺2000px程度を目安(通信と可読性のバランス)
  • 必要な箇所にタグ(キッチン/浴室/居室等)を付与して後検索に備える
  • 完了写真は必ず案件Noをメタ情報に残し、外部共有時にも識別可能に
運用例: 1. 現地写真(`~/admin/project/site-photos/[id]`)に作業前を集約 2. 完了写真(`~/admin/project/completion-photos/[id]`)で作業後を登録 3. 見積/請求の説明文に写真番号を引用し、関係者間の認識ズレを防止

付録L: 原価/粗利の見方(運用)



基本の見方:
  • 見積総額 −(協力会社発注合計 + 資材等原価) = 粗利(見込み)
  • 請求確定後は、入金済みベースで実績粗利を把握
実務フロー: 1. 見積確定後、発注明細を作成(`~/admin/project/contractor-order/new`) 2. 業者請求で検収額を確定(`~/admin/invoices/contractor-invoices`) 3. 案件ごとに見積/発注/検収/請求/入金の整合を確認

注意:
  • 発注変更が頻発する案件は工程と紐づけて差異の原因を特定
  • 粗利の急変時は、数量/単価/税区分の入力ミスをチェック


付録M: 印刷リンクの使い方(かんたん)



目的: 顧客の経理へログイン不要で請求書を共有するための手順です。

手順: 1. 請求詳細を開く(`~/admin/invoice/[id]`) 2. 右上の「共有」ボタンを押す 3. 「印刷用リンクをコピー」を選ぶ 4. コピーしたリンクをメールに貼り付けて共有

確認ポイント:
  • 金額・請求先・期日など表示内容を共有前にチェック
  • 必要に応じて「リンクを再発行」して最新状態を共有
印刷時のコツ:
  • ブラウザ印刷設定の余白/ヘッダ/フッタをオフにするときれいに印刷できます


付録N: スクショ用アンカー(コメント挿入用)



本文内の「スクショ挿入: …」行に、以下のコメントを付しておくと、後から画像自動配置ツール等で位置合わせしやすくなります。

例: <!-- screenshot:admin-dashboard-01 --> <!-- screenshot:admin-quotation-edit-01 --> <!-- screenshot:admin-invoice-print-01 -->

付録O: 案件詳細タブ 深掘り(~/admin/project/[id])



案件詳細は日常業務のハブです。以下は代表的なタブと推奨運用です。

概要タブ

  • 構成: 案件基本、顧客/物件、関係者、重要日、ステータス
  • アクション: ステータス更新、担当割当、関連画面ショートカット
  • 注意: 案件名/顧客/住所は請求書にも波及し得るため表記統一
  • スクショ: 「概要上部/下部」「ステータス更新」

スケジュールタブ(リンク: ~/admin/project/schedule/[id])

  • 表示: 日/週、担当者ごとの割当
  • アクション: 予定追加/変更、外部候補URLの発行(~/schedule/select/[token])
  • 注意: 同時割当の競合は色で警告(実装依存)
  • スクショ: 「週ビュー」「候補URLダイアログ」

写真タブ

  • 現地写真: ~/admin/project/site-photos/[id]
  • 完了写真: ~/admin/project/completion-photos/[id]
  • 運用: タグで部位分類、前後比較の並列表示
  • スクショ: 「一覧/拡大」「タグ編集」

見積タブ

  • リスト/リンク: ~/admin/quotation/index, ~/admin/quotation/[id]
  • アクション: 新規/複製、承認依頼、PDF/印刷(実装依存)
  • 注意: 承認済みの改定は履歴を保持し、バージョンが分かる命名を推奨
  • スクショ: 「行編集」「合計」

発注タブ

  • リンク: ~/admin/project/contractor-order/new, ~/admin/project/contractor-order/[id]
  • アクション: 発注送付、受注確認、検収登録
  • 注意: 見積との数量/単価差異を小まめにチェック
  • スクショ: 「発注ステータス」

完了タブ

  • リンク: ~/admin/project/completion/[id]
  • アクション: 完了内容/チェック記録、写真紐づけ
  • 注意: 顧客検収前に必須の証跡が揃っているかチェック
  • スクショ: 「完了入力」「確認項目」

請求タブ

  • リンク: ~/admin/invoices/index, ~/admin/invoice/[id], ~/admin/invoice/[id]/print
  • アクション: 請求作成、印刷、公開URL発行
  • 注意: 顧客請求先情報の整合、期日/消費税設定
  • スクショ: 「請求明細」「印刷プレビュー」


付録P: 単価・価格改定の運用(~/admin/pricing)



目的: 単価テーブルの整理と価格改定の安全運用。

推奨ルール:
  • 改定日は月初に限定し、見積・発注の混乱を回避
  • カテゴリ/品目の命名は短く一意に(略語統一)
  • 旧価格を残す場合はバージョンタグを付けて参照性を確保
手順(例): 1. 現行単価をエクスポート(必要に応じ台帳作成) 2. 改定案を作成し、社内合意 3. `~/admin/pricing` でカテゴリ/品目を更新(影響範囲を確認) 4. 新規見積から新単価を使用、進行中は合意がない限り据え置き

スクショ: 「単価一覧」「品目編集モーダル」「改定履歴(運用メモ)」

付録Q: 通知テンプレ拡張(バリエーション)



見積差戻し受領(社内共有)

件名: 【差戻し】見積No: {{見積No}} / 顧客: {{顧客名}}

差戻し理由: {{コメント}}\ 対応期限: {{期限}}\ 関連URL: {{adminQuotationUrl}}

発注受注通知(社内/担当向け)

件名: 【受注済】発注No: {{発注No}} / 協力会社: {{会社名}}

納期: {{納期}}\ 金額: {{金額}}円\ 関連URL: {{adminOrderUrl}}

完了検収依頼(顧客向け)

件名: 【完了検収のお願い】案件No: {{案件No}} / 物件: {{物件名}}

検収画面: {{customerFinalCheckUrl}}\ 完了写真: {{customerCompletionPhotosUrl}}

付録R: データ入出力/監査(運用)



エクスポート(運用案):
  • 期間/顧客/状態で絞ってCSV出力(実装/ツールに準拠)
  • 月末に請求・入金の台帳を出力し会計と突合
監査ログ(運用案):
  • 重要操作(見積金額変更/請求発行/入金修正)はコメントを付けて履歴化
  • 監査時は、案件No単位で見積→発注→検収→請求→入金の順で確認


付録S: 時短TIPS/キーボード操作(拡張)



  • 入力フォーム: Tab/Shift+Tabで高速移動、Enterで行追加(実装依存)
  • 一覧: キーワード→Enterで即検索、Escでクリア
  • マルチ選択: Shift+クリックで範囲選択(実装依存)
  • URL直打ち: `~/admin/project/[id]` へ番号入力で直行(社内運用)


付録T:(社内システム管理者向け)



この章はシステム管理者向けの補足です。一般の操作担当者は読み飛ばしてください。

付録U: 画面別エラー/対処(詳細)



見積保存エラー

  • 事象: 数量/単価未入力で保存不可
  • 対処: 必須項目の確認、税区分の再設定

写真アップロード失敗

  • 事象: タイムアウト/サイズ超過
  • 対処: リサイズ/分割アップロード、回線変更

印刷プレビュー崩れ

  • 事象: 余白/縮尺で1ページに収まらない
  • 対処: ブラウザ印刷設定の余白/ヘッダ/フッタをオフ、A4固定

入金消込不一致

  • 事象: 入金額と明細合計が一致しない
  • 対処: 手数料欄に計上、差額の原因を備考に記録


付録V: 入金・消込シナリオ詳細(~/admin/invoices/payments)



本節は実務上頻出の入金ケースを、操作手順と記録のポイントと併せて整理します。

1) 部分入金

  • 事象: 請求額100,000円に対し、50,000円のみ入金
  • 操作:
1. 入金登録で「入金日=実入金日」「金額=50,000」を入力 2. 消込対象として当該請求を選択し部分消込 3. 備考に分割入金の理由(社内/顧客都合)を記録
  • 表示: 状態は「一部入金」へ。残高50,000円が一覧に表示
  • 次アクション: 期日超過前に督促テンプレ(付録C)を送付

2) 過入金(多めの入金)

  • 事象: 請求額100,000円に対し、100,500円の入金(手数料差し引きの逆パターン等)
  • 操作:
1. 入金登録で「金額=100,500」 2. 手数料や前受扱いの社内ルールに従い、超過分500円の処理を決定 - A) 手数料として計上 → 明細/備考に記録 - B) 次回請求への充当 → 社内台帳で管理し、次回差引 3. 消込は当該請求に対して全額消込
  • 注意: 仕訳影響があるため、会計と運用ルールを合わせる

3) 複数請求をまとめて入金

  • 事象: 複数の請求(例: 60,000円と40,000円)を合算100,000円で入金
  • 操作:
1. 入金登録で「金額=100,000」 2. 消込対象として複数請求を選択し、合計で一致するよう割り当て 3. 差額が出る場合は手数料/調整欄で処理し備考に記録
  • 表示: 両方の請求が「入金済」に遷移

4) 期日超過の未入金

  • 手順: 一覧でフィルタ「期日<今日, 入金状況=未」で抽出 → テンプレ送付 → 次回連絡日をメモ
  • ポイント: 丁寧な一次リマインド → 電話確認 → 書面案内の順でエスカレーション

5) 誤入金/誤消込の修正

  • 事象: 入金金額/日付の誤り、別請求に消込した等
  • 操作: 入金レコードの修正(運用権限に応じて)または取消→再登録
  • 注意: 監査観点で備考に理由を必ず記載


付録W: 発注検収の運用パターン(~/admin/project/contractor-order/[id])



分割検収

  • 事象: 複数回に分けて納品/作業完了
  • 操作: 明細/数量を分割して検収登録、検収済数量を明示
  • 請求: 協力会社からの請求も分割で受領し検収額と一致させる

検収差戻し

  • 事象: 品質不備/数量不一致
  • 操作: 差戻し理由を記録し再納品を依頼、再検収へ
  • 注意: 期日影響が工程に波及するため、担当に通知

仕様変更に伴う発注変更

  • 事象: 見積/仕様の変更により単価/数量が変動
  • 操作: 変更履歴を残しつつ発注明細を更新、差額を整合
  • 注意: 見積・顧客承認との整合性を維持(顧客への追加見積が必要な場合あり)


付録X: 退去アプリ入力ガイド(~/moveout_app/*)



入力の基本

  • 入口: `~/moveout_app/[projectId]`
  • チェック: `~/moveout_app/check`, `~/moveout_app/room-check`
  • 精算プレビュー: `~/moveout_app/settlement-preview` → 確定: `~/moveout_app/settlement`

部屋/項目の選び方

  • 物件の間取りに沿って部屋を追加
  • 部屋ごとに対象アイテムを選択(例: 壁/床/水回り)
  • 汚損/破損の内容は「説明」も併記し、写真と対応付け

面積ガイドの活用

  • `~/admin/master/area-guidelines` の目安を参考に数量/工数を見積
  • 類似物件の過去データを参照し、標準化

よくある入力ミス

  • 同一箇所の重複登録 → チェック前に部屋/項目一覧を確認
  • 数量の単位(m²/枚/箇所)の取り違い → 単位項目を確認

スクショ挿入

  • 現場トップ、部屋追加、項目選択、精算プレビュー、確定ダイアログ


付録Y: 実装準拠の整合表と画面別操作ガイド(コード確認反映)



本節は`pages/admin/invoices/*`, `pages/admin/quotation/*`の実装を確認した内容に基づき、マニュアルの用語/ステータス/導線を整合させたものです。

支払管理(~/admin/invoices/payments)

  • 実装概要:
- 統計カード: pendingCustomerPayments/completedCustomerPayments/pendingContractorPayments/monthlyPaymentTotal - フィルタ: status(period/all/this_month/last_month/this_quarter), customerCompanyId - 一覧列: プロジェクト/顧客/施工業者/請求金額/支払期限/Customer支払/Contractor支払/ステータス/操作 - ステータス表示: PENDING_CUSTOMER → CUSTOMER_PAID → PENDING_CONTRACTOR → COMPLETED - 操作: 顧客入金後に「Contractor支払処理」モーダル(支払日/方法/備考)
  • マニュアル整合:
- 本書の「付録V: 入金・消込シナリオ詳細」はこの画面の運用に一致。部分入金/複数請求消込は一覧からではなく請求明細運用で対応。 - 期限表示はcompanyの締日/支払日/支払月種別から算出(calculatePaymentCycle)。
  • スクショ指示:
- 統計カード(今月支払総額含む) - フィルタ(ステータス/期間/顧客会社) - Contractor支払処理モーダル(推奨支払日表示あり)

請求管理(~/admin/invoices/index)

  • 実装概要:
- タブ: 顧客請求書管理/業者請求書管理/支払管理 - 顧客請求書タブ: 検索(番号/タイトル), ステータスフィルタ DRAFT/PENDING/PAID/CANCELLED, CSVエクスポート - 業者請求書タブ: 承認ステータス PENDING/APPROVED/REJECTED, 支払ステータス UNPAID/PARTIAL/PAID/OVERDUE - 支払管理タブ: 今月の入金/未回収/業者支払/承認待ちのサマリー+今月支払予定一覧 - アクション: 顧客請求「支払済み」、業者請求「承認/否認/支払済み」
  • マニュアル整合:
- 本書の「請求・入金管理」「業者請求」はこのタブ構成に準拠。顧客請求のステータス名を PENDING=請求済み に統一。 - CSVエクスポート手順を追記済(付録Jと連動)。
  • スクショ指示:
- 顧客請求一覧(検索/フィルタ/CSV) - 業者請求一覧(承認/支払ボタン) - 支払管理タブの今月支払予定テーブル

請求詳細の遷移(~/admin/invoice/[id])

  • 実装概要:
- 指定IDの請求から `project_id` を取得し `/admin/project/invoice/[projectId]?invoiceId=...` へリダイレクト - エラー時はプロジェクトへ戻る導線
  • マニュアル整合:
- 本書の導線表記を「請求詳細はプロジェクト内請求ビューに遷移」に統一。
  • スクショ指示:
- ローディング→プロジェクト請求画面に遷移する様子(1枚で可)

見積詳細(~/admin/quotation/[id])

  • 実装概要:
- ステータス: DRAFT/SENT/APPROVED/REJECTED/CANCELLED - アクション: 簡易編集(DRAFTのみ), PDF出力, 顧客に送付(SENT化, 通知作成, プロジェクトステータス更新, メール送付, 同時に報告一式送付) - 面積自動算出: `inspection_results`, `inspection_items`, `master_area_guidelines(tenant + common 999999)`を参照して壁/天井/床面積を推定→見積項目へ適用 - 立会い結果の要点: サマリー/署名/写真リンク/異常項目プレビュー
  • マニュアル整合:
- 本書の「見積」「退去アプリ」「面積ガイド」節と一致。送付時の副作用(通知/プロジェクト更新/メール送付)を明記済。 - 面積算出の参照順(テナント優先→共通)を追記済(付録G/F/X)。
  • スクショ指示:
- 見積基本情報+ステータスバッジ - 面積算出結果カード - 立会い結果カード(署名/サマリー) - 「顧客に送付」ボタンとトースト/アラート

見積作成/編集(~/admin/quotation/new)

  • 実装概要:
- 新規/編集モード両対応。インライン行編集、青い空行での即時追加、立会い結果読込、面積自動算出、プレビュー、保存/更新 - ルームクリーニング初期項目の自動追加(間取り情報ベース)
  • マニュアル整合:
- 本書の「見積(新規/編集)」手順と一致。新規行の自動追加(blurで確定)やデータソース(inspection_*)の参照を反映済。
  • スクショ指示:
- 青い新規行(空行)と「立会い結果読込」「面積自動算出」ボタン - プレビューモーダル

---

整合チェック結論: 現状のマニュアル記載は、実装上のステータス/用語/導線と一致しています。今後UIやAPIの変更があれば、本付録Yの各項目のみ更新すれば全体の整合性を保てます。

付録Z: 工程/発注/完了報告の実装整合ガイド



本節は実装ファイル(`~/admin/project/work-schedule/[id]`, `~/admin/project/contractor-order/new`, `~/admin/project/contractor-order/[id]`, `~/admin/project/completion/[id]`)を確認して整合をとった運用ガイドです。

工程(詳細工事スケジュール管理)~/admin/project/work-schedule/[id]

  • 画面要素:
- プロジェクト概要(物件名/部屋/工期/進捗率) - 月カレンダー(前月/翌月、当月強調、作業有り日は強調) - 新規工事予定フォーム(工事日/工事種別/作業内容/開始/終了) - 職人管理(`project_workers`): 追加モーダル、配置済/作業中/完了バッジ - 資材管理(`project_materials`): 追加モーダル、発注済/納品済/使用済バッジ
  • データ連携/通知:
- 工事予定追加時、`work_schedules`へ保存し、顧客へメール通知(依頼者の所属`users`抽出、`/customer/project/:id`リンク同封) - すべて`auth.fetchWithTenant('/api/universal')`で実装。filtersやorderByはクエリに指定。
  • マニュアル整合:
- 本書の「工程/スケジュール」節は、日/週ビューの表現を含む抽象化だが、実装は月グリッド中心。表現を「月カレンダー中心(前月/翌月遷移あり)」に統一。
  • スクショ指示:
- 月カレンダー(作業あり日の表示) - 新規工事予定フォーム - 職人追加/資材追加モーダル

発注作成 ~/admin/project/contractor-order/new

  • 画面要素:
- プロジェクト情報(物件/部屋/住所/依頼種別) - 発注基本(件名/説明) - 施工業者選択(`companies` type='contractor') - 発注タイプ(材料/施工/材料+施工) - 希望納期 - 発注明細(項目名/数量/単価/小計/備考) - 合計(税込)計算、送信
  • 送信時の副作用:
- `purchase_orders`作成(`SENT`)、`purchase_order_items`作成 - タスク作成(送付準備) - 業者側アプリ通知(`notifications`)+ メール送信。ログイン導線は`/contractor/orders/:id`
  • マニュアル整合:
- 本書の「協力会社発注」節に、上記副作用(通知/メール/タスク)を明記済み。件名の自動文言(物件名/部屋-施工発注)も補足。
  • スクショ指示:
- 施工業者選択/発注明細テーブル - 送信後のトーストまたは完了ダイアログ

発注詳細 ~/admin/project/contractor-order/[id]

  • 画面要素:
- 発注書情報(番号/件名/説明/タイプ/発注日/希望納期/納期/合計/ステータス) - プロジェクト情報・施工業者情報 - 発注明細一覧(数量/単価/小計/備考) - 作成/更新情報
  • ステータス表記:
- DRAFT/SENT/CONFIRMED/IN_PROGRESS/COMPLETED/CANCELLED(バッジ色あり)
  • マニュアル整合:
- 本書の「発注タブ」「発注検収(付録W)」と整合。分割検収/差戻し等の運用は業務ルールとして補完。
  • スクショ指示:
- 発注書情報上部のステータスバッジ+金額 - 発注明細ブロック

完了報告 ~/admin/project/completion/[id]

  • 画面要素:
- プロジェクト情報 - 完了報告フォーム(完了日/作業概要/備考) - 写真・報告書(作業前/作業後/書類)フィルタ、画像/非画像、個別/一括DL - 既存完了報告がある場合は表示モード(提出済みメッセージ)
  • 保存挙動:
- 新規提出で`project_completion_reports`作成、`projects.status`を`WORK_COMPLETED`または`COMPLETION_REPORTED`に更新 - `file_lists`等のJSONをパースしてギャラリーに表示
  • マニュアル整合:
- 本書の「完了報告」節に、提出後のプロジェクトステータス自動更新を明記済。写真カテゴリ(作業前/作業後/書類)フィルタ、一括DL手順を追記済。
  • スクショ指示:
- 完了報告フォーム - 写真ギャラリー(カテゴリフィルタON) - 提出済みバナー

---

補足(整合メモ):
  • すべての保存/取得は`/api/universal`を`auth.fetchWithTenant`または`$fetch`で呼び出し。マニュアルのAPI説明はユニバーサルAPI前提で統一済み。
  • ステータスのラベルは画面ごとに微差があるため、本書では「日本語表示ラベル」を基準とし、英字コードは付録H/Wに掲載。

付録AA: 迷子防止ガイド(最短導線/決定木/次アクション)



現場担当・内勤担当が初回でも迷わないように、15分で状況把握→次アクション実行までの導線を定義します。

A. 15分で状況把握(最短導線)

1. ダッシュボード `~/admin/dashboard` - 未承認見積/未入金/今週作業を確認 - リンクから各リストへジャンプ 2. 請求管理 `~/admin/invoices/index` - タブ「支払管理」で今月の入金/支払予定を把握 3. 案件一覧 `~/admin/project/index` - フィルタ「承認待ち」「今月完了予定」でボトルネック抽出

スクショ挿入: ダッシュボード→支払管理タブ→案件一覧フィルタ(3枚)

B. 役割別クイックアクション

  • 見積担当
- 新規依頼あり: `/customer/request` → 案件化(管理側)→ `~/admin/quotation/new` - 差戻し対応: `~/customer/quotation/index` → 該当ID → `~/admin/quotation/[id]` 修正→再送
  • 工程担当
- 承認後: `~/admin/project/work-schedule/[id]` で工程登録→必要なら発注 - 発注: `~/admin/project/contractor-order/new?projectId=:id`
  • 請求担当
- 完了後: `~/admin/invoices/index` → 顧客請求作成→請求画面の「共有」で印刷用リンクを発行 - 入金: `~/admin/invoices/payments`

C. 次アクション表(状態→やること)

  • 見積: 下書き → 内部確認→「顧客に送付」
  • 見積: 差戻し → コメント読解→金額/範囲修正→再送
  • 工程: 未登録 → スケジュール登録→職人/資材を手配
  • 発注: 送信済 → 受注確認→納品/検収→業者請求待ち
  • 完了: 施工完了 → 完了報告提出→顧客検収依頼
  • 請求: 発行前 → 請求作成→請求画面の「共有」で印刷用リンクを共有→入金管理

D. 決定木(よくある分岐)

  • 顧客が期日までに承認しない
- A) 催促メール送付(付録C)→ 3営業日待機 - B) 電話確認→ 担当変更/締日配慮→ 新期日設定
  • 工程に遅延リスク
- A) 代替職人/資材を検討→ 工程再配分 - B) 顧客へ影響連絡(メールテンプレ簡略版)
  • 入金遅延
- A) 一次督促(メール)→ 期日+3で電話→ 書面

E. エスカレーション基準(最小セット)

  • 金額閾値(例: 50万円超): 見積/発注は上長承認を推奨
  • 期日閾値(例: 7日超過): 入金・承認は部門長共有
  • 品質重大不良: 発注差戻し→再検収→報告書添付

F. 日常チェックリスト(使い回し可能)

- [ ] 本日作業/担当の確認(工程) - [ ] 承認待ち見積の催促優先度を設定
  • 夕方
- [ ] 当日作業の完了報告回収/写真不足の洗い出し - [ ] 請求・入金の更新反映
  • 週次
- [ ] 今週完了予定案件の粗利見込みと発注整合 - [ ] 未入金のフォロー計画更新

G. トラブル発生時の最短ルート

  • 画面で何をしたら良いか分からない→ `~/help/workflow` → 該当ロールの項を開く
  • どのURLか分からない→ `~/admin/project/[id]` からタブの導線を辿る
  • PDF/印刷が崩れる→ ブラウザ印刷設定(余白/ヘッダ/フッタOFF)→ 付録M参照


付録F: 画面別フィールド辞書(拡張)



本節は各主要画面で頻出する入力項目の名称・型・必須・補足をまとめた参照表です。実装によって若干の差分がある場合は画面表示を優先してください。

顧客(Customers)

  • 顧客名: 文字列, 必須, 請求書に表示される正式名称を推奨
  • 部署/担当者名: 文字列, 任意, 部署や窓口担当者
  • メール: 文字列(メール), 任意, 通知/承認依頼の送付先
  • 電話: 文字列, 任意, ハイフン可
  • 請求先郵便番号: 文字列(半角), 任意, 7桁/ハイフン可
  • 請求先住所: 文字列, 任意, ビル名/部屋番号まで
  • 請求締日: 選択, 任意, 末締/15日締など
  • 支払条件: 選択, 任意, 末締翌月末払い等
  • 通知CC: 文字列(メールカンマ区切), 任意

協力会社(Contractors)

  • 会社名: 文字列, 必須
  • 担当者/連絡先: 文字列, 任意
  • 支払条件: 選択, 任意
  • 評価: 数値(1-5), 任意, 社内指標

案件(Projects)

  • 案件名/案件No: 文字列, 必須/自動, 運用基準に従う
  • 顧客: 参照, 必須, 既存顧客から選択
  • 物件名/住所: 文字列, 任意
  • 期日/希望日: 日付, 任意
  • 担当者: 参照, 任意
  • ステータス: 選択, 自動/手動, 受付/現地/見積/承認/施工/完了/請求 等

見積(Quotations)

  • 行. カテゴリ: 選択, 必須
  • 行. 品目: 選択/文字列, 必須
  • 行. 説明: 文字列, 任意
  • 行. 数量: 数値, 必須
  • 行. 単位: 文字列, 任意
  • 行. 単価: 金額, 必須
  • 行. 税区分: 選択, 必須
  • 見積備考: 文字列, 任意
  • 割引/調整: 金額, 任意

発注(Contractor Orders)

  • 発注先: 参照, 必須
  • 納期: 日付, 任意
  • 支払条件: 選択, 任意
  • 明細: 品目/数量/単価/税, 必須
  • 添付: ファイル, 任意

完了報告(Completion)

  • 完了日: 日付, 必須
  • 完了内容: 文字列, 任意
  • 署名/確認: 入力/チェック, 任意
  • 写真: ファイル, 任意

請求(Invoices)

  • 請求先: 参照, 必須
  • 請求日/期日: 日付, 必須
  • 明細: 品目/数量/単価/税/割引, 必須
  • 振込先: 文字列/選択, 任意
  • 合計: 自動計算

入金(Payments)

  • 入金日: 日付, 必須
  • 金額: 金額, 必須
  • 手数料: 金額, 任意
  • メモ: 文字列, 任意


付録G: 操作シナリオ集(ケース別)



シナリオ0-A: 新規依頼が来た場合(案件化→初期対応)

対象: 顧客からの新規依頼を受けた直後の流れ(ネットリテラシーが低い方向け)

1) 案件を作る
  • 画面を開く: 案件一覧(`~/admin/project/index`)
  • 右上の「新規作成」または「+」を押す
  • 入力: 物件名・部屋番号・依頼元(顧客)・担当者・希望日(分かる範囲で)
  • 「保存」を押す
2) 依頼内容を整える(写真・資料)
  • 案件詳細 → 「資料/写真」タブ
  • 依頼書や写真があればドラッグ&ドロップで追加
3) 初回連絡テンプレを送る(任意)
  • 案件詳細 → 「連絡」またはコメント欄に、受付の旨・次の流れ(現地日程の確認)を記入
  • 既定テンプレがある場合はそれを利用
4) 次のアクション(このあとやること)
  • 現地調査/退去立会いの日程調整(シナリオ0-Bへ)
  • 先に必要な情報の確認(鍵・入居状況・立会い要否など)
よくあるつまずきと対処
  • 顧客名/物件が見つからない → 顧客一覧/物件一覧から作成後に案件へ戻る
  • 保存ボタンが押せない → 必須項目(物件名・顧客)を再確認


シナリオ0-B: 現地調査日や退去立会い日を決める(社内/顧客/入居者調整)

対象: 調査/立会いの日程をすばやく確定したいとき

方法A(社内で日程を直接登録) 1) 案件詳細 → 「スケジュール」 2) 「新規工事予定を追加」を押す 3) 入力: 日付・時間帯・作業名(例: 現地調査/退去立会い)・担当者 4) 「追加」を押す

方法B(外部候補URLで相手に選んでもらう) 1) 案件詳細 → 「スケジュール」 2) 「候補リンクの発行」ボタン(表示される場合)を押す 3) 表示された「候補URLをコピー」→ メールに貼り付けて送付 4) 相手が候補を選ぶと、スケジュールに反映(来なければ電話確認)

現地準備チェック(簡易)
  • 鍵の受け渡し方法(管理室/キーボックス/立会人)
  • 駐車/入館手続きの要否
  • 部屋番号・建物名の表記ゆれ確認
次のアクション
  • 現地完了後、退去アプリ(`~/moveout_app/check`)でチェック入力→精算(見積のたたき台へ)
よくあるつまずき
  • ボタンが見つからない → 案件詳細のタブを左右にスワイプ/横スクロール
  • 候補URLが使えない → メール本文でURLが折り返されていないか確認。うまくいかなければ方法Aで直接登録


シナリオ0-C: 新規顧客や施工業者にパートナー招待する

対象: 顧客(不動産会社)や施工業者にアカウントを案内したいとき

1) 招待を送る
  • 画面を開く: パートナー招待(`~/invite-partners`)
  • 入力: メールアドレス / ロール(顧客 or 施工業者) / 簡単なメッセージ
  • 「送信」を押す
2) 招待の状況を確認する
  • 画面を開く: 招待管理(`~/users/invitations/index`)
  • ステータスを確認: 送信済 / 開封 / 登録完了 / 期限切れ
  • 必要に応じて「再送」
3) 受信側の登録
  • 顧客の登録ページ: `~/customer-register`
  • 施工業者の登録ページ: `~/contractor-register`
  • 受信側へは「届いたメールのリンクを押して、項目を入力してください」と案内
次のアクション
  • 顧客を案件に紐づけ(案件詳細 → 顧客)
  • 施工業者を発注先として登録(発注作成画面のプルダウンに反映)
よくあるつまずき
  • メールが届かない → 迷惑メール/フィルタを確認。社内で別のメールアドレスを試す
  • どのロールか分からない → 基本は「顧客=不動産会社」「施工業者=工事会社」。迷ったら顧客担当に確認


シナリオ1: 退去立会いから即日見積送付

1. 案件作成(`~/admin/project/index` → 新規) 2. 現地チェック(`~/moveout_app/check`)→ 精算プレビュー(`~/moveout_app/settlement-preview`) 3. 見積作成(`~/admin/quotation/new`)→ 保存 4. 承認依頼送付(`~/admin/quotation/[id]`)→ 顧客承認待ち 5. ダッシュボードで承認状況を監視

シナリオ2: 協力会社に一部作業を発注し、検収後に請求

1. 見積承認後、工程計画(`~/admin/project/work-schedule/[id]`) 2. 発注作成(`~/admin/project/contractor-order/new`)→ 送付 3. 受注/納品確認(`~/admin/project/contractor-order/[id]`) 4. 完了写真確認(`~/admin/project/completion-photos/[id]`)→ 検収 5. 自社請求作成(`~/admin/invoices/index` → `~/admin/invoice/[id]`) 6. 入金記録(`~/admin/invoices/payments`)

シナリオ3: 差戻し見積の再提案

1. 差戻し理由/コメントを確認(`~/customer/quotation/[id]`) 2. 見積修正(`~/admin/quotation/[id]`)→ 金額/範囲見直し 3. 再送付 → 承認取得

シナリオ4: 再点検要望への対応

1. 顧客の再点検リクエスト確認(`~/customer/project/reopen-check/[id]`) 2. 現地再訪 → 必要に応じて追加見積 3. 完了報告を更新 → 顧客検収(`~/customer/project/final-check/[id]`)

付録H: 権限・ステータス・通知マトリクス(概要)



| 区分 | 参照 | 作成 | 更新 | 削除 | 備考 | | --- | --- | --- | --- | --- | --- | | 顧客 | ○ | ○ | ○ | △ | 削除は論理削除推奨 | | 案件 | ○ | ○ | ○ | △ | 関連データ一括確認 | | 見積 | ○ | ○ | ○ | △ | 承認後は制限あり | | 発注 | ○ | ○ | ○ | △ | 受注/検収後は履歴重視 | | 請求 | ○ | ○ | ○ | △ | 入金後の修正は履歴保持 | | 入金 | ○ | ○ | ○ | △ | 消込の整合に注意 |

通知トリガ(例):
  • 見積送付/承認/差戻
  • 発注送付/受注/検収
  • 完了報告作成
  • 請求発行/入金登録




まずは資料で概要をチェック

3分で読める説明資料と、無料相談の2つの導線をご用意。