📋 NippoApp 利用ガイド
現在のフロントエンド画面に合わせた操作マニュアルです。 ドライバーの日報提出、管理者の各種管理(ユーザー・マスタ・フォーム・課金確認・ブランディング)、 そしてSaaS提供側オペレーターのテナント管理・請求集計までを含みます。
NippoApp は、配送現場の日報入力をモバイルで完結させる業務アプリです。 マ ルチテナント設計で、テナント(顧客企業)ごとにドライバー・管理者がデータを管理し、 SaaS提供側のオペレーターが全テナントを横串で運用します。
| 機能 | ドライバー | 管理者 | オペレーター |
|---|---|---|---|
| 日報の作成・提出 | ✅ | — | — |
| 日報一覧・詳細の閲覧 | 自分の分 | 自テナント全体 | — |
| ユーザー管理 | — | 自テナント内 | — |
| マスタ管理(店舗・ドライバー・コース) | — | ✅ | — |
| フォーム項目編集 | — | ✅ | — |
| 課金(自テナントの利用状況確認) | — | ✅ | — |
| ブランディング(社名・ロゴ・テーマカラー) | — | ✅ | — |
| テナント新規プロビジョニング | — | — | ✅ |
| 請求集計(全テナント横串/販売店別) | — | — | ✅ |
| ロール | 主な操作 | ログインURL | 所属 |
|---|---|---|---|
| ドラ イバー | 日報作成、送信、自分の日報閲覧 | /app | テナント(自社) |
| 管理者 | 自テナント内の全日報閲覧、ユーザー管理、マスタ管理、フォーム編集、課金確認、ブランディング | /app/admin/login | テナント(自社) |
| オペレーター | 全テナントの新規プロビジョニング、各テナント設定、月次請求集計(販売店別ロールアップ) | /app/operator/login | SaaS提供側(SotaTek) |
ドライバーの基本フロー
管理者の基本フロー
オペレーターの基本フロー
- 1ログイン画面を開く
ロールごとに専用のURLを使用します:
ドライバー:/app
管理者:/app/admin/login
オペレーター:/app/operator/login - 2ユーザー名とパスワードを入力
ドライバーのユーザー名は「ローマ字の姓 + 社員番号」です (例:鈴木さん・社員番号 0001 →suzuki0001)。 管理者・オペレーターはメールアドレスでログインします。 各画面ではそのロールのアカウントのみログインできます。 所属テナントはユーザー名から自動的に解決されます。 - 3ホームへ遷移
ドライバーは通常ホーム、管理者は管理ポータルのダッシュボードへ移動します。
ホーム画面では、当日の日報送信状況と最近の日報を確認できます。 未送信の場合は「+ 日報を作成する」、送信済みの場合は「送信済み日報を確認」ボタンが表示されます。
| 表示ブロック | 内容 |
|---|---|
| ステータスカード | 本日の日報が未送信か送信済みかを表示 |
| クイックアクション | 日報作成または送信済み日報の確認へ遷移 |
| 接続状態 | オンライン / オフラインの状態を表示 |
| 最近の日報 | 直近の提出データを3件表示 |
入力内容
日報作成画面は「基本情報」「配送先」「備考」に分かれています。 必須項目が未入力の場合は、確認画面へ進む前にエラー表示されます。
| エリア | 主な項目 | 補足 |
|---|---|---|
| 基本情報 | 配送日、乗務員氏名、コース、車番、作業時間 | 乗務員氏名はドライバー画面では固定 |
| 配送先 | 配送先、到着/出発時刻、温度、数量など | コース選択で配送順に自動作成。「+ 追加」で追加も可 |
| 備考 | 特記事項 | 任意入力 |
- 1確認画面で内容確認
基本情報と配送先 一覧が表示されます。 - 2「送信する」をタップ
送信成功後は完了画面に遷移します。 - 3ホームまたは一覧へ戻る
完了画面から次の操作を選べます。
日報一覧では配送日・ドライバー名・コース・車番・配送件数を確認で きます。 1件選択すると詳細画面に遷移し、送信IDと送信日時も確認できます。
| 機能 | 説明 |
|---|---|
| 日付絞り込み | 配送日のFrom/Toで検索 |
| ドライバー絞り込み | 管理者のみ利用可能 |
| 詳細表示 | 基本情報、配送先、数量バッジ、送信メタ情報を表示 |
管理者はサイドバー付きの専用ポータルで操作します。 ダッシュボードから日報管理、ユーザー管理、マスタ管理、フォーム編集、設定へ移動できます。
| メニュー | 内容 |
|---|---|
| ダッシュボード | ユーザー数、本日日報件数、最近の日報の確認 |
| 日報管理 | 全体の日報一覧・詳細確認、修正・承認 |
| 設定 | アカウント情報、接続状態、管理ツール遷移 |
「日報管理」では全ドライバーの日報を横断的に確認できます。「配送日」「ドライバー」で絞り込み、 一覧から選択すると詳細画面で内容を確認・修正・承認できます。
ステータスと承認の流れ
| ステータス | 意味 |
|---|---|
| 提出済み | ドライバーが送信した直後の状態 |
| 管理者修正 | 管理者が内容を修正し、ドライバーの再確認待ち |
| 承認済み | 管理者が承認して確定した状態(ロック) |
| 取消済み | 管理者が取り消した状態。ドライバーの画面には表示されません |
- 1編集
詳細画面の「編集」から配送先の追加・変更や各項目を修正できます。 修正するとステータスは「管理者修正」に変わります。 - 2ドライバーの再提出
「管理者修正」の日報はドライバー側に 「管理者が配送先を変更しました。内容を確認して再提出してください。」と表示され、 「確認して再提出」で再び「提出済み」に戻ります。 - 3承認
「提出済み」の日報で「✓ 承認する」を押すと「承認済み」になります。
日報の取り消し・削除
誤って配布した日報や、取り下げたい提出済みの日報は詳細画面から取り消せます。 「配布前」「予定(要入力)」「提出済み」の日報が対象です (「管理者修正」はドライバーの再提出待ち、「承認済み」は確定済みのため対象外です)。
- 1取り消し
詳細画面の「取り消し」を押すと「取消済み」になります。 内容はそのまま残りますが、ドライバーの画面には表示されなくなり、 CSV出力と月次の請求件数からも除外さ れます。 - 2復元
「取消済み」の日報は「復元する」で取り消し前の状態に戻せます。 ドライバーの画面にも再び表示されます。 - 3完全に削除
「取消済み」の日報のみ「完全に削除」できます。 入力内容も変更履歴も残らず、元に戻せません。
- 1「+ 追加」
ドライバーは姓・名・ローマ字・社員番号(4桁)・パスワードを登録します。 ローマ字は姓・名を入力すると自動補完されます(変換前のよみを利用するため、 貼り付けた漢字など補完できない場合は手入力してください)。 ユーザー名(例suzuki0001)は自 動生成され、保存前に画面で確認できます。
管理者は氏名・メールアドレス・パスワードを登録します。 - 2必要に応じて編集
ロール変更やパスワード再設定が可能です。ローマ字の姓や社員番号を変更するとユーザー名も変わるため、 ドライバーへの連絡が必要です。 - 3不要ユーザーを削除
確認ダイアログ後に削除されます。
店舗・ドライバー・コースをタブで切り替えて管理します。 追加・編集・有効/無効切り替え・削除・並び替え(▲▼)が可能です。
コースの配送順
コースを追加・編集すると、そのコースが回る店舗を選べます。 選んだ店舗は「配送順」として番号付きで並び、▲▼ で順番を入れ替えられます。 この順番がそのまま日報の配送先として作成されます。
- 1店舗を追加
下のボタンから店舗を選ぶと、配送順の最後に追加されます。 - 2順番を調整
▲▼ で入れ替え、「外す」でそのコースから除きます。 - 3日報へ反映
日報作成・翌日分の作成でコースを選ぶと、この順番で配送先が自動作成されます。 すでに配送先が入力されている場合は、作り直すかどうか確認されます。
フォーム編集画面では、ヘッダー・配送先・フッターそれぞれの項目を管理できます。 項目IDの重複は不可です。
| 操作 | 内容 |
|---|---|
| 項目追加 | テキスト、数値、選択、タイムスタンプ、カウンタなどを追加 |
| 項目編集 | ラベル、必須設定、選択肢、最小/最大値などを更新 |
| 並び替え | ▲▼ボタンで表示順を調整 |
| 保存 | フォーム定義をサーバーへ保存し、最新設定を反映 |
設定画面ではアカウント情報、接続状態、バージョンを確認できます。
- 1アカウント確認
ログイン中ユーザー情報を確認できます。 - 2ログアウト
確認ダイアログ後にログアウトします。 - 3CSV出力(管理者)
管理者ポータルの「データ出力」画面から、絞り込み条件(期間・ドライバー・キーワード)に 一致する日報をCSVでダウンロードできます。出力単位は「日報集計」(1日報=1行)/「配送明細」(配送先ごとに1行)から選べます。 列はテナントのフォーム定義に従って自動生成され、Excel対応のUTF-8(BOM付き)で出力されます。
管理者ポータルのサイドバー「レポート」(/app/admin/billing)から、 自テナントの月次アクティブドライバー数と請求予定額を確認できます。
| 項目 | 内容 |
|---|---|
| 月選択 | 右上の月ピッカーで対象月を切り替え |
| アクティブドライバー | 対象月内に1件以上日報を提出したドライバー数(重複なし) |
| 単価 | テナント契約レート、または提案資料のティア中央値 |
| 請求予定額 | アクティブドライバー数 × 単価(必要に応じて最低料金を適用) |
| ドライバー別 提出件数 | 誰が何件提出したかが棒グラフで可視化 |
管理者ポータルの「設定」(/app/admin/settings)にある 「ブランディング」カードから、自テナントの表示名・ロゴURL・テーマカラーを変更できます。
- 1表示用社名
サイドバー上部に表示される会社名です。未入力時はテナント名が使われます。 - 2ロゴURL
画像URLを指定します(任意)。 - 3テーマカラー
カラーピッカーから選択します。 - 4保存
「保存」を押すと即時反映されます。
オペレーターはSaaS提供側(SotaTek)のスタッフが利用するロールで、 全テナント横断でテナント管理と月次請求集計を行います。
- 1ログイン
/app/operator/loginからメール+パスワードでログインします。 ログイン後、テナント一覧ページに遷移します。 - 2サイドナビゲーション
「テナント」と「請求集計」を左側のサイドバーから切り替えます。 - 3ログアウト
右上のユーザーメニューを開き、「ログアウト」を選ぶと確認ダイアログ後にログアウトします。
/app/operator/tenants では登録テナント一覧の確認と、 新規テナントのプロビジョニング(テナント作成+初期管理者作成)を行います。
テーブル項目
| 列 | 内容 |
|---|---|
| スラッグ | テナント識別子(半角英数・ハイフン・アンダースコア) |
| 会社名 | ブランディング設定の「表示用社名」(未設定時はテナント名) |
| ドメイン | メールドメイン。ログイン時のテナント解決に使用 |
| 販売店 | 担当販売店名(任意のラベル) |
| 管理者 / ドライバー | そのテナントに所属するユーザー数 |
新規テナント作成
- 1「+ 新規テナント」 をクリックしてモーダルを開きます。
- 2テナント情報
スラッグ・会社名は必須。ドメイン・販 売店・表示用社名・テーマカラーは任意です。 - 3課金設定(任意)
単価(円/人/月)と月額最低料金を入力します。未設定の場合は提案資料のティアが適用されます。 - 4初期管理者
管理者の氏名・メール・初期パスワード(8文字以上)を入力します。 テナント作成と同一トランザクションで管理者ユーザーが作成されます。 - 5「作成」 をクリック → 一覧に追加されます。
PATCH /api/v1/operator/tenants/:slug を直接呼び出してください。 テナント編集モーダルは今後追加予定です。/app/operator/billing では、全テナントの月次アクティブドライバー数と請求予定額を 横串で集計できます。月選択と販売店グルーピング切り替えが可能です。
サマリーカード
| カード | 内容 |
|---|---|
| 対象テナント | 登録テナント数 |
| 課金対象テナント | 対象月にアクティブドライバーがいるテナント数 |
| 合計アクティブドライバー | 全テナントの重複なしアクティブドライバー合計 |
| 月次請求合計 | 全テナントの請求予定額合計 |
テナント別テーブル
- 1テナントごとに「会社名 / 販売店 / アクティブ / 単価 / 合計 / レート」を確認できます。
- 2「レート」列のタグで 契約(テナント個別設定)とデフォルト(提案資料ティア中央値)を区別表示します。
- 3「販売店でグルーピング」を有効にすると、販売店別の集計テーブルが上部に表示されます。 売上の大きい販売店順にソートされます。
/app/admin/billing)と完全に同じ計算ロジックを使用するため、 「管理者が見る金額」と「オペレーターが見る金額」は一致します。suzuki0001)、 管理者はメールアドレスで、それぞれパスワードと合わせて再確認してください。ドライバーは
/app、管理者は /app/admin/login からログインしま す。役割が一致しない画面ではログインできません。
パスワードを5回続けて間違えると15分間ロックされます。 管理者が「ユーザー管理」から解除できます。
ただし送信は通信が必要です。送信エラーが出た場合は、オンライン復帰後に再送信してください。
/app/admin/billing で自テナントの月次集計を確認できます。オペレーターは
/app/operator/billing で全テナント横串の集計と販売店別ロールアップを確認できます。両画面の数字は同じ計算ロジック に基づいています。
既存テナントの更新は現在UI未提供のため、APIを直接呼び出してください (
PATCH /api/v1/operator/tenants/:slug)。初期セットアップ用のシード値は
ops@sotatek-ops.test / password です。/app/admin/settings の「ブランディング」カードから変更できます。変更内容は次回のページ読み込みで管理者ポータルのサイドバーに反映されます。
操作に関する不明点や権限設定の依頼は、まず社内管理者へご連絡ください。 障害調査の際は、以下の情報があると対応がスムーズです。
- 発生日時
- ログインユーザー(メールアドレス)
- 送信ID(日報詳細画面下部)
- 実施した操作手順と表示されたメッセージ