*/ protected $casts = [ 'published' => 'boolean', 'signup_open_at' => 'datetime', 'signup_close_at' => 'datetime', 'branding_json' => 'array', 'settings' => 'array', 'scoring_rules_json' => 'array', ]; public function tracks(): HasMany { return $this->hasMany(CompetitionTrack::class)->orderBy('sort'); } public function signupChannels(): HasMany { return $this->hasMany(SignupChannel::class)->orderByDesc('id'); } public function formSchemaDefinitions(): HasMany { return $this->hasMany(FormSchemaDefinition::class, 'competition_id'); } /** * 嵌套路由参数 `{form_schema}` 的隐式绑定约定关系名为 formSchemas(见 Model::childRouteBindingRelationshipName)。 */ public function formSchemas(): HasMany { return $this->formSchemaDefinitions(); } public function formSchema(): BelongsTo { return $this->belongsTo(FormSchemaDefinition::class, 'form_schema_id'); } public function reviewFormSchema(): BelongsTo { return $this->belongsTo(FormSchemaDefinition::class, 'review_form_schema_id'); } /** * 评审端是否开放登录/访问。settings.review_portal.enabled 缺省或非 false 时视为开启。 */ public function isReviewPortalEnabled(): bool { $portal = $this->reviewPortalSettings(); if ($portal === null || ! array_key_exists('enabled', $portal)) { return true; } return $portal['enabled'] !== false && $portal['enabled'] !== 0 && $portal['enabled'] !== '0' && $portal['enabled'] !== 'false'; } /** * 关闭评审端时展示给评审员的说明(登录弹窗 / 接口提示)。 */ public function reviewPortalClosedMessage(): string { $portal = $this->reviewPortalSettings(); $message = is_array($portal) ? trim((string) ($portal['message'] ?? '')) : ''; if ($message === '') { return '评审通道暂未开放,请稍后再试'; } return mb_substr($message, 0, 2000); } /** * 公开接口用的评审端开关摘要。 * * @return array{enabled: bool, message: string} */ public function reviewPortalPublicPayload(): array { $enabled = $this->isReviewPortalEnabled(); $portal = $this->reviewPortalSettings(); $stored = is_array($portal) ? trim((string) ($portal['message'] ?? '')) : ''; return [ 'enabled' => $enabled, 'message' => $enabled ? mb_substr($stored, 0, 2000) : $this->reviewPortalClosedMessage(), ]; } /** * @return array|null */ private function reviewPortalSettings(): ?array { $settings = is_array($this->settings) ? $this->settings : []; $portal = $settings['review_portal'] ?? null; return is_array($portal) ? $portal : null; } }