スム住む 管理者(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]`
- 写真のアップロード/分類/確認(作業前・作業後の比較)
鍵管理(参照)
- 顧客側画面: `~/customer/project/key-management/[id]`
- 鍵の受け渡し履歴は案件詳細から参照(導線がある場合)
見積(Quotation)
見積一覧/作成/編集
- 一覧: `~/admin/quotation/index`
- 新規作成: `~/admin/quotation/new`
- 詳細/編集: `~/admin/quotation/[id]`
補足:
- 料金マスタと連動している場合、カテゴリ選択で推奨単価が反映されます
- 面積ガイドに基づく数量/工数の目安を参考にしてください
顧客承認フロー
- 顧客の確認/承認画面: `~/customer/quotation/[id]`
- 差戻し/コメント対応後は、再送信で承認取得を目指します
受注・施工・工程管理
工事情報・工程計画
- 工事情報: `~/admin/project/construction/[id]`
- 作業計画(工数/工程): `~/admin/project/work-schedule/[id]`
- 個別予定(担当/日別): `~/admin/project/schedule/[id]`
- 外部候補日程(入居者/関係者共有): `~/schedule/select/[token]`
- 見積承認後、作業WBS/担当割当/日程確定
- ガント/カレンダーで進行中タスクを把握
協力会社発注
- 発注新規: `~/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]`
主な操作:
- 案件/見積から請求を作成(請求先、請求日、支払期日、明細、税設定)
- 請求書のプレビュー/印刷、共有用公開URLの管理
注意:
- 共有前に表示内容(自社名・顧客名・金額・期日)を必ず確認してください
入金(消込)
- 入金管理: `~/admin/invoices/payments`
- 入金登録、差額/手数料の調整、消込ステータス更新
協力会社請求(原価管理)
- 業者請求管理: `~/admin/invoices/contractor-invoices`
- 協力会社からの請求(検収/支払予定)を一元管理
- 発注との紐づけで原価/粗利を把握
単価・マスター・タスク・設定
単価/料金設定
- 画面: `~/admin/pricing`
スクショ挿入: 「料金テーブル編集(カテゴリ/品目/単価)」
面積ガイド(基準値)
- 画面: `~/admin/master/area-guidelines`
スクショ挿入: 「面積ガイド編集」
タスク管理
- 画面: `~/admin/tasks/index`
スクショ挿入: "タスク一覧(担当/期限/ステータス)"
通知設定
- 画面: `~/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. ログインできません
- Q. 招待メールが届きません
- Q. 見積が承認されません(リンクが開けない)
- Q. 現地写真がアップロードできない
- Q. 請求書の印刷が開けない/内容が違う
- Q. スケジュール候補リンクが無効
付録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)
- 目的: 今日やるべきこと、遅延の兆候、重要アラートを素早く把握
- 前提: ログイン済み、テナントとユーザー権限が有効
- 主なウィジェット:
- 操作手順:
- 検証/注意:
- スクショ挿入: 「全体ウィジェット」「通知ドロワー」
カレンダー(~/admin/calendar)
- 目的: 社内/現場の予定を俯瞰、休日や稼働率を確認
- 表示: 月/週/日 切替、担当者フィルタ、案件フィルタ
- 操作:
- スクショ: 「月/週/日ビュー」「担当フィルタ」
顧客管理(~/admin/customers/*)
- 一覧(~/admin/customers/index)
- 詳細(~/admin/customers/[id]/index)
- 新規/編集(~/admin/customers/create, ~/admin/customers/[id]/edit)
協力会社管理/招待(~/admin/contractors, ~/invite-partners, ~/users/invitations/index)
- 一覧(~/admin/contractors)
- 招待(~/invite-partners)
- 招待状況(~/users/invitations/index)
案件管理(~/admin/project/*)
- 一覧(~/admin/project/index)
- 詳細(~/admin/project/[id])
現地写真(~/admin/project/site-photos/[id], ~/admin/project/completion-photos/[id])
- 操作: ドラッグ&ドロップでアップロード、タグ/カテゴリ付与、拡大/比較
- 注意: 通信不安定時は数枚ずつ、ブラウザを閉じない
- スクショ: 「アップロードUI」「サムネイル/拡大」
見積(~/admin/quotation/index, ~/admin/quotation/new, ~/admin/quotation/[id])
- 一覧
- 新規/編集
工程/スケジュール(~/admin/project/work-schedule/[id], ~/admin/project/schedule/[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)
- 概要: 協力会社からの請求を検収/支払予定管理
- 列例: 請求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)
- 保存ビュー例:
見積一覧(~/admin/quotation/index)
- 保存ビュー例:
請求一覧(~/admin/invoices/index)
- 保存ビュー例:
付録K: 写真運用ガイド(作業前/後・分類・証跡)
推奨ルール:
- 作業前/後の同一アングル撮影を徹底し、比較が容易な状態を作る
- 画質は長辺2000px程度を目安(通信と可読性のバランス)
- 必要な箇所にタグ(キッチン/浴室/居室等)を付与して後検索に備える
- 完了写真は必ず案件Noをメタ情報に残し、外部共有時にも識別可能に
付録L: 原価/粗利の見方(運用)
基本の見方:
- 見積総額 −(協力会社発注合計 + 資材等原価) = 粗利(見込み)
- 請求確定後は、入金済みベースで実績粗利を把握
注意:
- 発注変更が頻発する案件は工程と紐づけて差異の原因を特定
- 粗利の急変時は、数量/単価/税区分の入力ミスをチェック
付録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)
目的: 単価テーブルの整理と価格改定の安全運用。
推奨ルール:
- 改定日は月初に限定し、見積・発注の混乱を回避
- カテゴリ/品目の命名は短く一意に(略語統一)
- 旧価格を残す場合はバージョンタグを付けて参照性を確保
スクショ: 「単価一覧」「品目編集モーダル」「改定履歴(運用メモ)」
付録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円のみ入金
- 操作:
- 表示: 状態は「一部入金」へ。残高50,000円が一覧に表示
- 次アクション: 期日超過前に督促テンプレ(付録C)を送付
2) 過入金(多めの入金)
- 事象: 請求額100,000円に対し、100,500円の入金(手数料差し引きの逆パターン等)
- 操作:
- 注意: 仕訳影響があるため、会計と運用ルールを合わせる
3) 複数請求をまとめて入金
- 事象: 複数の請求(例: 60,000円と40,000円)を合算100,000円で入金
- 操作:
- 表示: 両方の請求が「入金済」に遷移
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)
- 実装概要:
- マニュアル整合:
- スクショ指示:
請求管理(~/admin/invoices/index)
- 実装概要:
- マニュアル整合:
- スクショ指示:
請求詳細の遷移(~/admin/invoice/[id])
- 実装概要:
- マニュアル整合:
- スクショ指示:
見積詳細(~/admin/quotation/[id])
- 実装概要:
- マニュアル整合:
- スクショ指示:
見積作成/編集(~/admin/quotation/new)
- 実装概要:
- マニュアル整合:
- スクショ指示:
---
整合チェック結論: 現状のマニュアル記載は、実装上のステータス/用語/導線と一致しています。今後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]
- 画面要素:
- データ連携/通知:
- マニュアル整合:
- スクショ指示:
発注作成 ~/admin/project/contractor-order/new
- 画面要素:
- 送信時の副作用:
- マニュアル整合:
- スクショ指示:
発注詳細 ~/admin/project/contractor-order/[id]
- 画面要素:
- ステータス表記:
- マニュアル整合:
- スクショ指示:
完了報告 ~/admin/project/completion/[id]
- 画面要素:
- 保存挙動:
- マニュアル整合:
- スクショ指示:
---
補足(整合メモ):
- すべての保存/取得は`/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. 役割別クイックアクション
- 見積担当
- 工程担当
- 請求担当
C. 次アクション表(状態→やること)
- 見積: 下書き → 内部確認→「顧客に送付」
- 見積: 差戻し → コメント読解→金額/範囲修正→再送
- 工程: 未登録 → スケジュール登録→職人/資材を手配
- 発注: 送信済 → 受注確認→納品/検収→業者請求待ち
- 完了: 施工完了 → 完了報告提出→顧客検収依頼
- 請求: 発行前 → 請求作成→請求画面の「共有」で印刷用リンクを共有→入金管理
D. 決定木(よくある分岐)
- 顧客が期日までに承認しない
- 工程に遅延リスク
- 入金遅延
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`)
- 右上の「新規作成」または「+」を押す
- 入力: 物件名・部屋番号・依頼元(顧客)・担当者・希望日(分かる範囲で)
- 「保存」を押す
- 案件詳細 → 「資料/写真」タブ
- 依頼書や写真があればドラッグ&ドロップで追加
- 案件詳細 → 「連絡」またはコメント欄に、受付の旨・次の流れ(現地日程の確認)を記入
- 既定テンプレがある場合はそれを利用
- 現地調査/退去立会いの日程調整(シナリオ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 施工業者) / 簡単なメッセージ
- 「送信」を押す
- 画面を開く: 招待管理(`~/users/invitations/index`)
- ステータスを確認: 送信済 / 開封 / 登録完了 / 期限切れ
- 必要に応じて「再送」
- 顧客の登録ページ: `~/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: 権限・ステータス・通知マトリクス(概要)
| 区分 | 参照 | 作成 | 更新 | 削除 | 備考 | | --- | --- | --- | --- | --- | --- | | 顧客 | ○ | ○ | ○ | △ | 削除は論理削除推奨 | | 案件 | ○ | ○ | ○ | △ | 関連データ一括確認 | | 見積 | ○ | ○ | ○ | △ | 承認後は制限あり | | 発注 | ○ | ○ | ○ | △ | 受注/検収後は履歴重視 | | 請求 | ○ | ○ | ○ | △ | 入金後の修正は履歴保持 | | 入金 | ○ | ○ | ○ | △ | 消込の整合に注意 |
通知トリガ(例):
- 見積送付/承認/差戻
- 発注送付/受注/検収
- 完了報告作成
- 請求発行/入金登録
