05. 状態の移り変わり¶
「いまどうなっているか」を表す値と、どの操作でどう変わるかを すべて書き出します。表に無い変わり方はしません。
各表の「保存される値」は、データベースに入っている文字です。 画面にはその右の「画面の表示」が出ます。
応募(modules_shift.JobApplication.status)¶
| 保存される値 | 画面の表示 | 意味 |
|---|---|---|
pending |
応募中 |
スタッフが応募し、事業所の返事待ち |
confirmed |
確定 |
働くことが決まった |
rejected |
不採用 |
事業所が断った |
cancelled |
キャンセル |
取り消された |
withdrawn |
辞退 |
スタッフが取り下げた |
移り変わり¶
| 変わる前 | 変わった後 | 誰が | どこで |
|---|---|---|---|
| (無し) | pending |
スタッフ | S-06 お仕事の詳細 の「応募する」 |
pending |
confirmed |
企業・事業所アカウント/管理者 | C-05 / C-11 の「確定」 |
pending |
rejected |
同上 | 同上の「却下」 |
confirmed |
rejected |
同上 | 同上の「却下」(確定後も断れます) |
pending |
withdrawn |
スタッフ本人 | S-06 の「応募を取り消す」 |
変われないとき¶
| やろうとしたこと | 出る理由 |
|---|---|
pending 以外を確定する |
応募状態が正しくありません |
| 同じ時間帯に確定済みの人を確定する | 重なっているお仕事を示す文言 |
| 募集人数を超えて確定する | 募集人数の上限(N名)に達しています |
pending / confirmed 以外を却下する |
応募状態が正しくありません |
confirmed から pending には戻せません。 戻せると、
確定に合わせて作った勤怠の記録が宙に浮くためです。
間違えたときは却下します。
「期限切れ」という状態はありません¶
勤務日を過ぎても未確定の応募は、pending のままです。
画面でだけ「過去」に振り分けて 期限切れ(未確定) と出しています。
状態を増やすと、過ぎた瞬間に誰かが書き換える仕組みが要るためです。
勤怠(modules_shift.AttendanceLog.status)¶
| 保存される値 | 画面の表示 | 意味 |
|---|---|---|
before_work |
出勤前 |
まだ出勤を打刻していない |
working |
勤務中 |
出勤を打刻した |
break |
(出しません) | 使っていません。下記参照 |
done |
承認待ち |
退勤まで終わり、事業所の承認待ち |
approved |
承認済み |
事業所が承認した |
無断欠勤 は状態ではなく別の印です(is_no_show)。
状態と組み合わせて出します。
移り変わり¶
| 変わる前 | 変わった後 | 誰が | どこで |
|---|---|---|---|
| (無し) | before_work |
— | 応募が確定したときに自動で作られます |
before_work |
working |
スタッフ本人 | S-03 勤怠打刻 の「出勤する」 |
working |
done |
スタッフ本人 | 同画面の「退勤する」 |
done |
approved |
企業・事業所アカウント/管理者 | C-12 勤怠管理 の「承認する」 |
approved |
done |
同上 | 承認後に時刻を直すと承認前に戻ります |
| どの状態でも | before_work |
同上 | 「無断欠勤を取り消す」(時刻も消えます) |
事業所が時刻を手で入れた場合も、出勤と退勤がそろえば done、
出勤だけなら working になります。
打刻でも手入力でも同じ扱いにするためです。
変われないとき¶
| やろうとしたこと | 理由 |
|---|---|
| 打刻の時間帯の外で打刻する | 出勤は開始の 60 分前〜終了、退勤は終了の 3 時間後まで |
| 既に入っている時刻を打刻で上書きする | 手で入れた時刻を打刻で壊さないため |
| 請求を確定した月の勤怠を直す | 請求額と記録がずれるため |
使っていない値¶
break(休憩中)にはなりません。休憩を開始・終了する操作が
画面にも API にもないためです。break_start / break_end も常に空です。
くわしくは 09 未対応・保留 を見てください。
お仕事(modules_shift.Job.status)¶
| 保存される値 | 画面の表示 | 意味 |
|---|---|---|
draft |
下書き |
スタッフには見えない |
published |
公開中 |
スタッフが見て応募できる |
closed |
締切 |
募集を終えた |
移り変わり¶
| 変わる前 | 変わった後 | 誰が | どこで |
|---|---|---|---|
| (無し) | published |
企業・事業所アカウント/管理者 | C-06 お仕事の新規登録 |
draft |
published |
同上 | C-05 の「公開する」 |
published |
closed |
同上 | C-05 の「締め切る」 |
締め切っても、既に確定した応募と勤怠は残ります。 募集を止めるだけで、働く約束を取り消すものではないためです。
確定の方法(modules_shift.Job.confirmation_type)¶
| 保存される値 | 画面の表示 | 意味 |
|---|---|---|
manual |
手動確定 |
事業所が 1 件ずつ確定する |
auto |
自動確定 |
応募がそのまま確定になる |
auto のお仕事では、C-11 応募管理
に「確定」のボタンが出ません。確定する相手がいないためです。
公開範囲の性別(modules_shift.JobVisibilityScope.gender)¶
| 保存される値 | 画面の表示 |
|---|---|
all |
全員 |
male |
男性 |
female |
女性 |
年齢や性別での絞り込みは、法令の確認待ちで運用していません (09 未対応・保留)。
招待リンク¶
招待リンクに状態の項目はありません。有効か無効かの 2 つだけです
(is_active)。
| 表示 | 意味 |
|---|---|
有効 |
その URL から登録できる |
停止中 |
登録できない。停止した日時が出る |
| 変わる前 | 変わった後 | 誰が | どこで |
|---|---|---|---|
| (無し) | 有効 | 企業・事業所アカウント | C-16 招待リンク の「新規登録」 |
| 有効 | 停止中 | 同上 | 「停止」 |
| 停止中 | 有効 | 同上 | 「再有効化」 |
消すことはできません。 どの招待から入った人かを追えなくなるためです。
法人・事業所¶
どちらも状態の項目は持たず、有効か停止中かの 2 つです(is_active)。
| 対象 | 変える人 | どこで | 止めるとどうなるか |
|---|---|---|---|
| 法人 | Gipple 管理者 | A-05 法人の詳細 | 所属する人がログインできなくなります。集計から外れます |
| 事業所 | Gipple 管理者 | A-08 事業所の詳細 | 事業所の選択肢から消えます。集計から外れます |
どちらも過去のデータは消えません。消すと勤怠や請求の裏付けが 失われるためです。
法人のプラン(redpl_tenants.Tenant.plan)¶
| 保存される値 | 画面の表示 |
|---|---|
free |
フリー |
standard |
スタンダード |
metered |
従量課金 |
一覧・選択肢・内訳のどこでもこの表のとおりに出ます (A-02 / A-03 / A-04 / A-05)。
Gipple 管理者が A-05 で変えられます。
アカウント¶
ログインできるかどうか¶
アカウントに状態の項目はありません。有効かロック中かの 2 つです
(is_active)。
| 表示 | 意味 |
|---|---|
有効 |
ログインできる |
ロック中 |
ログインできない |
| 変わる前 | 変わった後 | 誰が | どこで |
|---|---|---|---|
| 有効 | ロック中 | Gipple 管理者 | A-11 アカウントの詳細 の「ロック」 |
| ロック中 | 有効 | 同上 | 「ロック解除」 |
消すことはできません。 消すと応募や勤怠まで失われるためです。
権限の種類(core_users.User.user_type)¶
| 保存される値 | 画面の表示 |
|---|---|
admin |
管理者 |
client |
クライアント |
staff |
スタッフ |
この値は Gipple 管理者かどうかの判定と、一覧での表示に使います。 会社の中での立場は、次の「会社への所属」で決まります。
会社への所属(core_memberships.TenantMembership)¶
1 人が複数の会社に所属できます。会社ごとに立場が決まります。
立場(core_memberships.TenantMembership.user_type)¶
| 保存される値 | 画面の表示 |
|---|---|
client |
クライアント |
staff |
スタッフ |
Gipple 管理者はどの会社にも所属しません。全部の会社を横断して見るためです。
役割(core_memberships.TenantMembership.role)¶
| 保存される値 | 画面の表示 | 意味 |
|---|---|---|
owner |
オーナー |
企業アカウント。会社の全事業所を見られます |
manager |
マネージャー |
いまは使っていません |
member |
メンバー |
事業所アカウント。割り当てられた事業所だけ |
staff |
スタッフ |
スタッフの所属 |
manager は将来のための入れ物で、アカウント発行の画面では選べません
(選ぼうとすると断られます)。
所属の状態(core_memberships.TenantMembership.status)¶
| 保存される値 | 画面の表示 | ログインできるか |
|---|---|---|
active |
在籍中 |
できる |
suspended |
停止中 |
できない |
withdrawn |
退会 |
できない |
invited |
招待中 |
できない |
active 以外でログインしようとすると、それぞれの理由が出ます
(C-01 / S-01)。
事業所への所属(core_staff.StaffOfficeAccess.status)¶
スタッフがどの事業所で働けるかを表します。
| 保存される値 | 画面の表示 | 意味 |
|---|---|---|
active |
利用中 |
その事業所で働ける |
suspended |
停止中 |
一時的に止めている |
withdrawn |
退会 |
その事業所を離れた |
withdrawn の人が同じ事業所の招待リンクを踏んでも、自動では戻りません
(退会済みのため再加入できません)。戻してよいかの判断が事業所側に
要るためです。
スタッフの属性¶
状態ではありませんが、選択肢のある項目です。
性別(core_staff.Staff.gender)¶
| 保存される値 | 画面の表示 |
|---|---|
| (空) | 未設定 |
male |
男性 |
female |
女性 |
other |
その他 |
任意の項目です。未設定のまま登録・更新できます。
口座の種別(core_staff.Staff.bank_account_type)¶
| 保存される値 | 画面の表示 |
|---|---|
ordinary |
普通 |
checking |
当座 |
savings |
貯蓄 |
管理者だけが扱うもの¶
法人への注意(redpl_tenants.TenantAlert)¶
重さ(redpl_tenants.TenantAlert.level)¶
| 保存される値 | 画面の表示 |
|---|---|
info |
注意 |
warning |
警告 |
critical |
要確認 |
種類(redpl_tenants.TenantAlert.alert_type)¶
| 保存される値 | 画面の表示 |
|---|---|
high_cancel_rate |
キャンセル率高い |
rapid_growth |
人数急増 |
other |
その他 |
対応の状況(redpl_tenants.TenantAlert.status)¶
| 保存される値 | 画面の表示 |
|---|---|
open |
未対応 |
in_progress |
確認中 |
resolved |
対応済 |
open の件数が A-02 ダッシュボード の
「未対応アラート」に出ます。
Gipple 管理者が A-05 で変えます。
請求書(redpl_tenants.TenantInvoice.status)¶
| 保存される値 | 画面の表示 | 意味 |
|---|---|---|
pending |
未送付 |
作っただけ |
sent |
送付済 |
送った |
paid |
入金済 |
入金を確認した |
overdue |
期限超過 |
期限を過ぎても入金がない |
cancelled |
キャンセル |
取り消した |
paid 以外の件数が A-02 の
「未入金件数」に出ます。
Gipple 管理者が A-05 で変えます。
メールの送信履歴(core_notifications.EmailLog.status)¶
画面には出ません。送ったメールの記録です。
| 保存される値 | 画面の表示 | 意味 |
|---|---|---|
queued |
送信前 |
まだ送っていない |
sent |
送信成功 |
送った |
failed |
送信失敗 |
送ろうとして失敗した |
blocked |
送信抑止 |
こちらの判断で送らなかった(検証環境の宛先制限) |
bounced |
バウンス |
届かずに戻ってきた |
complained |
苦情 |
迷惑メールとして報告された |
failed(送ろうとして失敗)と blocked(そもそも送らなかった)を
分けているのは、原因がまったく違うためです。
くわしくは 08 メール を見てください。