A-05 管理画面法人の詳細¶

項目	内容
画面 ID	A-05
URL	`/admin/tenants/[id]`
開ける人	Gipple 管理者のみ
画面の目的	1 つの会社について、情報・事業所・アカウント・課金・メモ・アラート・請求書をまとめて扱う

管理画面でいちばん大きい画面です。会社に関する操作がここに集まっています。

画面¶

A-05 法人の詳細

7 つの区分¶

区分	内容
概要	会社の基本情報を見る・直す。停止・再開
事業所	この会社の事業所の一覧
アカウント	この会社のアカウントの一覧。仮パスワードの発行
課金	今月の稼働人数・請求額・料金の内訳。月次の確定
メモ	社内向けの覚え書き
アラート	対応が必要なことの記録
請求書	請求書の作成と状態の管理

1 つの画面にまとめているのは、会社について調べるときにあちこち開き直さずに済ませるためです。

概要¶

入力項目¶

A-04 新規登録と同じ項目ですが、 法人番号とテナントスラッグは直せません。

項目	直せるか	理由
法人番号	×	公的な番号で、後から変わるものではないため
テナントスラッグ	×	配った URL が使えなくなるため
法人名・カナ・代表者名・電話・郵便番号・住所・プラン	○

ボタン¶

ボタン	何が起きるか	成功したとき
更新する	内容を保存する	`法人情報を更新しました`
停止	会社を止める	停止した旨
再有効化	また使えるようにする	`再有効化しました`

会社を止めるとどうなるか¶

影響	内容
所属する人	ログインできなくなります（既に入っている人も追い出されます）
管理画面の集計	件数・売上から外れます
過去のデータ	消えません

課金¶

項目	内容
ユニーク稼働人数	その月に 1 回でもシフトに入った人数
当月請求額
状態	確定前か、確定済みか
料金内訳	人数の区切りごとの単価と金額

確定（ロック）すると、その月の勤怠は直せなくなります。 請求した金額と記録がずれないようにするためです。確定すると 課金スナップショットを確定しました と出ます。

アカウント¶

この会社のアカウントを一覧で見られます。 仮パスワードの発行ができ、押すと 仮パスワードを発行しました と出て、発行された文字列が出ます。この画面を閉じると二度と見られません。

パスワードを保存していないためです（照合用の変換後の値だけを持ちます）。

メモ¶

操作	メッセージ
追加	`メモを追加しました`
削除	確認ダイアログ `このメモを削除しますか？` → `メモを削除しました`

社内向けの覚え書きです。会社側からは見えません。

アラート¶

操作	メッセージ
追加	`アラートを追加しました`
更新	`アラートを更新しました`

対応が必要なことを記録します。未対応の件数は A-02 ダッシュボードに出ます。

請求書¶

操作	メッセージ
当月の課金集計をセット	`当月の課金集計をセットしました`
請求書を作成	`請求書を作成しました`
状態の更新	`更新しました`

状態ごとの表示¶

状況	表示
読み込み中	読み込み中の印
取得に失敗	エラーの文言
停止中の法人	`停止中` のしるしと「再有効化」

画面の形¶

左に固定幅のカード、右に編集フォームと関連の一覧を置きます。右側は長くなるので、左のカードはスクロールしても付いてきます（下まで見たときに「何の画面だったか」を見失わないため）。編集フォームの保存ボタンは画面下に固定のバーで出します。

左のカードに入るのは「何の画面か」「いまの状態」「主な操作」の 3 つだけで、それ以外は右側に残します。画面ごとに並びが違うと、操作を探すのに毎回目で追うことになるためです。

幅が狭いときは縦に積み、左のカードが上に来ます。

権限¶

Gipple 管理者のみ。

遷移先と使う API¶

使う API	いつ
`GET` / `PATCH` `/api/tenants/{id}/`	概要の表示・更新
`POST /api/tenants/{id}/suspend/`（`TenantViewSet.suspend`）	停止
`POST /api/tenants/{id}/reactivate/`（`TenantViewSet.reactivate`）	再有効化
`GET /api/offices/`	事業所の一覧
`GET /api/auth/accounts/`	アカウントの一覧
`POST /api/auth/accounts/{user_id}/reset-password/`	仮パスワードの発行
`GET /api/shift/billing/{tenant_id}/{year}/{month}/`	課金の表示
`POST /api/shift/billing/{tenant_id}/{year}/{month}/lock/`	月次の確定
`GET` / `POST` `/api/tenants/{tenant_id}/memos/`	メモ
`DELETE /api/tenants/{tenant_id}/memos/{memo_id}/`	メモの削除
`GET` / `POST` `/api/tenants/{tenant_id}/alerts/`	アラート
`PATCH /api/tenants/{tenant_id}/alerts/{alert_id}/`	アラートの更新
`GET` / `POST` `/api/tenants/{tenant_id}/invoices/`	請求書
`PATCH /api/tenants/{tenant_id}/invoices/{invoice_id}/`	請求書の更新

A-05 管理画面 法人の詳細¶

画面¶