GroupMember.php 2.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. <?php
  2. namespace App\Models;
  3. use Illuminate\Database\Eloquent\Factories\HasFactory;
  4. use Illuminate\Database\Eloquent\Model;
  5. use Illuminate\Database\Eloquent\Relations\BelongsTo;
  6. /**
  7. * 团队(group)成员。表 `group_members`。
  8. *
  9. * 角色有两列:v2 的 `power`(0 owner / 1 manager / 2 member)与 v3 的 `role`
  10. * (owner / manager / editor / reader)。v2 只会插入、从不改 power;v3 改角色时两列同写。
  11. * 读角色一律走 {@see self::effectiveRole()}。
  12. */
  13. class GroupMember extends Model
  14. {
  15. use HasFactory;
  16. public const ROLE_OWNER = 'owner';
  17. public const ROLE_MANAGER = 'manager';
  18. public const ROLE_EDITOR = 'editor';
  19. public const ROLE_READER = 'reader';
  20. /** v3 可以分配的角色;owner 只在建团队时产生,不能经改角色得到 */
  21. public const ASSIGNABLE_ROLES = [self::ROLE_MANAGER, self::ROLE_EDITOR, self::ROLE_READER];
  22. protected $primaryKey = 'id';
  23. protected $casts = [
  24. 'id' => 'string',
  25. ];
  26. /**
  27. * 实际角色:`role` 有值就用它,为空按 v2 的 `power` 推导。
  28. *
  29. * TODO v4 下线后:按 power 回填 role、列改 NOT NULL,删掉这段推导直接读 role。
  30. */
  31. public function effectiveRole(): string
  32. {
  33. if ($this->role) {
  34. return $this->role;
  35. }
  36. return match ((int) $this->power) {
  37. 0 => self::ROLE_OWNER,
  38. 1 => self::ROLE_MANAGER,
  39. default => self::ROLE_READER,
  40. };
  41. }
  42. /**
  43. * 与角色对应的 v2 `power`,v3 改角色时同写,让 v4 的显示与删除权限保持一致。
  44. */
  45. public static function powerOf(string $role): int
  46. {
  47. return match ($role) {
  48. self::ROLE_OWNER => 0,
  49. self::ROLE_MANAGER => 1,
  50. default => 2,
  51. };
  52. }
  53. /**
  54. * 成员本人。`user_id` 是 uuid,对 `user_infos.userid`。
  55. */
  56. public function user(): BelongsTo
  57. {
  58. return $this->belongsTo(UserInfo::class, 'user_id', 'userid');
  59. }
  60. /**
  61. * 所属团队。`group_id` 对 `group_infos.uid`。
  62. */
  63. public function group(): BelongsTo
  64. {
  65. return $this->belongsTo(GroupInfo::class, 'group_id', 'uid');
  66. }
  67. }