['type' => 'integer', 'description' => 'The unique identifier of the team.'], 'name' => ['type' => 'string', 'description' => 'The name of the team.'], 'description' => ['type' => 'string', 'description' => 'The description of the team.'], 'personal_team' => ['type' => 'boolean', 'description' => 'Whether the team is personal or not.'], 'created_at' => ['type' => 'string', 'description' => 'The date and time the team was created.'], 'updated_at' => ['type' => 'string', 'description' => 'The date and time the team was last updated.'], 'show_boarding' => ['type' => 'boolean', 'description' => 'Whether to show the boarding screen or not.'], 'custom_server_limit' => ['type' => 'string', 'description' => 'The custom server limit.'], 'is_build_server_fallback_enabled' => ['type' => 'boolean', 'description' => 'Whether deployments can fall back to the deployment server when no usable dedicated build server is available.'], 'members' => new OA\Property( property: 'members', type: 'array', items: new OA\Items(ref: '#/components/schemas/User'), description: 'The members of the team.' ), ] )] class Team extends Model implements SendsDiscord, SendsEmail, SendsPushover, SendsSlack { use Auditable, HasFactory, HasNotificationSettings, HasSafeStringAttribute; use Notifiable { notify as sendNotification; } protected $fillable = [ 'name', 'description', 'personal_team', 'show_boarding', 'custom_server_limit', 'is_mcp_server_enabled', 'is_build_server_fallback_enabled', 'is_two_factor_required', ]; protected $attributes = [ 'is_mcp_server_enabled' => true, 'is_build_server_fallback_enabled' => true, 'is_two_factor_required' => false, ]; protected $casts = [ 'personal_team' => 'boolean', 'is_mcp_server_enabled' => 'boolean', 'is_build_server_fallback_enabled' => 'boolean', 'is_two_factor_required' => 'boolean', ]; protected static function booted() { static::created(function (Team $team) { $team->createDefaultNotificationSettings(); }); static::updating(function ($team) { if (auth()->user()?->roleInTeam($team->id) === 'member') { throw new \Exception('You are not allowed to update this team.'); } }); static::deleting(function (Team $team) { $team->deleteOwnedRecords(); }); static::deleted(function (Team $team) { app(TeamAvatarStorageService::class)->deleteTeamFile($team); }); } /** * Creates the notification settings rows every team needs, with their default values. */ public function createDefaultNotificationSettings(): void { $this->emailNotificationSettings()->create([ 'use_instance_email_settings' => isDev(), ]); $this->discordNotificationSettings()->create(); $this->slackNotificationSettings()->create(); $this->telegramNotificationSettings()->create(); $this->pushoverNotificationSettings()->create(); $this->webhookNotificationSettings()->create(); } /** * Deletes the API tokens, private keys, sources, tags, shared variables, and S3 storages of the * team. Instance-wide sources move to the root team instead. */ public function deleteOwnedRecords(): void { RevokeUserTeamTokens::forTeam($this->id); foreach ($this->privateKeys()->get() as $key) { $key->delete(); } // Transfer instance-wide sources to root team so they remain available $systemWideSources = GithubApp::where('team_id', $this->id)->where('is_system_wide', true)->get() ->concat(GitlabApp::where('team_id', $this->id)->where('is_system_wide', true)->get()) ->concat(GiteaApp::where('team_id', $this->id)->where('is_system_wide', true)->get()); foreach ($systemWideSources as $source) { $source->update(['team_id' => 0]); } // Delete non-instance-wide sources owned by this team $teamSources = GithubApp::where('team_id', $this->id)->get() ->concat(GitlabApp::where('team_id', $this->id)->get()) ->concat(GiteaApp::where('team_id', $this->id)->get()); foreach ($teamSources as $source) { $source->delete(); } foreach (Tag::whereTeamId($this->id)->get() as $tag) { $tag->delete(); } foreach ($this->environment_variables()->get() as $sharedVariable) { $sharedVariable->delete(); } // Also unusable storages, which the s3s relation hides. foreach (S3Storage::query()->where('team_id', $this->id)->get() as $s3) { $s3->delete(); } } public static function serverLimitReached(?Team $team = null) { $team = $team ?? currentTeam(); if (! $team) { return true; } $serverLimit = Team::serverLimit($team); $servers = $team->managedServers()->count(); return $servers >= $serverLimit; } public static function createServerWithinLimit(int $teamId, array $attributes): Server { return DB::transaction(function () use ($teamId, $attributes): Server { self::ensureServerCapacity($teamId); return Server::create($attributes); }); } /** Call within a transaction so the team lock lasts through the server insert. */ public static function ensureServerCapacity(int $teamId): void { $team = self::query()->lockForUpdate()->findOrFail($teamId); if (self::serverLimitReached($team)) { throw ValidationException::withMessages(['server' => 'Server limit reached for your subscription.']); } } public function subscriptionPastOverDue() { if (isCloud()) { return $this->subscription?->stripe_past_due; } return false; } public function serverOverflow() { if (Team::serverLimit($this) < $this->managedServers()->count()) { return true; } return false; } public static function serverLimit(?Team $team = null) { $team = $team ?? currentTeam(); if (! $team) { return 0; } if ($team->id === 0 && isDev()) { return 9999999; } $team = Team::find($team->id); if (! $team) { return 0; } return data_get($team, 'limits', 0); } public function limits(): Attribute { return Attribute::make( get: function () { if (config('constants.coolify.self_hosted') || $this->id === 0) { return 999999999999; } return $this->custom_server_limit ?? 2; } ); } public function routeNotificationForDiscord() { return data_get($this, 'discord_webhook_url', null); } public function routeNotificationForTelegram() { return [ 'token' => data_get($this, 'telegram_token', null), 'chat_id' => data_get($this, 'telegram_chat_id', null), ]; } public function routeNotificationForSlack() { return data_get($this, 'slack_webhook_url', null); } public function routeNotificationForPushover() { return [ 'user' => data_get($this, 'pushover_user_key', null), 'token' => data_get($this, 'pushover_api_token', null), ]; } public function getRecipients(): array { $recipients = $this->members()->pluck('email')->toArray(); $validatedEmails = array_filter($recipients, function ($email) { return filter_var($email, FILTER_VALIDATE_EMAIL); }); if (is_null($validatedEmails)) { return []; } return array_values($validatedEmails); } public function isAnyNotificationEnabled() { if (isCloud()) { return true; } return $this->getNotificationSettings('email')?->isEnabled() || $this->getNotificationSettings('discord')?->isEnabled() || $this->getNotificationSettings('slack')?->isEnabled() || $this->getNotificationSettings('telegram')?->isEnabled() || $this->getNotificationSettings('pushover')?->isEnabled() || $this->getNotificationSettings('webhook')?->isEnabled(); } /** * Ends one subscription row. The servers stay usable while another row of the team still pays. */ public function subscriptionEnded(Subscription $subscription): void { $subscription->update([ 'stripe_subscription_id' => null, 'stripe_cancel_at_period_end' => false, 'stripe_invoice_paid' => false, 'stripe_trial_already_ended' => false, 'stripe_past_due' => false, ]); if ($this->subscriptions()->get()->contains(fn (Subscription $other): bool => $other->isPaying())) { return; } foreach ($this->servers as $server) { $server->settings()->update([ 'is_usable' => false, 'is_reachable' => false, ]); ServerReachabilityChanged::dispatch($server); $server->unreachable_count = 3; $server->save(); NotificationThrottle::record($server, Unreachable::class); } } /** * Send a notification, unless it is throttled and was already sent within its interval. * A throttle claim is released when sending throws, so a failed send is retried on the next check. */ public function notify($instance): void { $subject = $instance instanceof ThrottledNotification ? $instance->throttleSubject() : null; if ($subject === null) { $this->sendNotification($instance); return; } NotificationThrottle::sendOnce( $subject, $instance::class, now()->subMinutes($instance->throttleIntervalMinutes()), fn () => $this->sendNotification($instance), ); } public function environment_variables() { return $this->hasMany(SharedEnvironmentVariable::class)->where('type', 'team'); } public function members() { return $this->belongsToMany(User::class, 'team_user', 'team_id', 'user_id')->withPivot('role', 'access'); } public function subscription() { return $this->hasOne(Subscription::class); } /** * A team can have more than one subscription row, for example after it subscribed again. */ public function subscriptions(): HasMany { return $this->hasMany(Subscription::class); } public function applications() { return $this->hasManyThrough(Application::class, Project::class); } public function invitations() { return $this->hasMany(TeamInvitation::class); } /** * @return array */ public function deletionBlockers(): array { return array_filter([ 'projects' => $this->projects()->count(), 'servers' => $this->servers()->count(), 'sources' => GithubApp::query()->where('team_id', $this->id)->where('is_system_wide', false)->count() + GitlabApp::query()->where('team_id', $this->id)->where('is_system_wide', false)->count() + GiteaApp::query()->where('team_id', $this->id)->where('is_system_wide', false)->count(), ]); } public function isEmpty(): bool { return $this->deletionBlockers() === []; } public function projects() { return $this->hasMany(Project::class); } public function servers() { return $this->hasMany(Server::class); } /** * Servers that use a server slot. Archives of transferred servers are left out. */ public function managedServers() { return $this->servers()->notTransferredAway(); } public function usesSwarm(): bool { return $this->servers() ->where(function ($query) { $query->whereHas('settings', function ($settings) { $settings->where('is_swarm_manager', true) ->orWhere('is_swarm_worker', true); })->orWhereHas('swarmDockers'); }) ->exists(); } public function privateKeys() { return $this->hasMany(PrivateKey::class); } public function cloudProviderTokens() { return $this->hasMany(CloudProviderToken::class); } public function integrationTokens() { return $this->hasMany(IntegrationToken::class); } public function sources() { $sources = collect([]); $github_apps = GithubApp::where(function ($query) { $query->where(function ($q) { $q->where('team_id', $this->id) ->orWhere('is_system_wide', true); })->where('is_public', false); })->get(); $gitlab_apps = GitlabApp::where(function ($query) { $query->where(function ($q) { $q->where('team_id', $this->id) ->orWhere('is_system_wide', true); })->where('is_public', false); })->get(); $gitea_apps = GiteaApp::where(function ($query) { $query->where(function ($q) { $q->where('team_id', $this->id) ->orWhere('is_system_wide', true); })->where('is_public', false); })->get(); return $sources->merge($github_apps)->merge($gitlab_apps)->merge($gitea_apps); } public function s3s() { return $this->hasMany(S3Storage::class)->where('is_usable', true); } public function emailNotificationSettings() { return $this->hasOne(EmailNotificationSettings::class); } public function discordNotificationSettings() { return $this->hasOne(DiscordNotificationSettings::class); } public function telegramNotificationSettings() { return $this->hasOne(TelegramNotificationSettings::class); } public function slackNotificationSettings() { return $this->hasOne(SlackNotificationSettings::class); } public function pushoverNotificationSettings() { return $this->hasOne(PushoverNotificationSettings::class); } public function webhookNotificationSettings() { return $this->hasOne(WebhookNotificationSettings::class); } }