Save workspace changes

This commit is contained in:
2026-04-18 17:02:56 +02:00
parent f02ea9a711
commit 87d60af5a9
4220 changed files with 1388603 additions and 1554 deletions

View File

@@ -0,0 +1,310 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Models\Artwork;
use App\Models\ArtworkMaturityAuditFinding;
use App\Models\User;
use App\Services\Maturity\ArtworkMaturityAuditService;
use App\Services\Maturity\ArtworkMaturityService;
use App\Services\ThumbnailPresenter;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Str;
use Inertia\Inertia;
use Inertia\Response;
final class ArtworkMaturityAdminController extends Controller
{
public function __construct(
private readonly ArtworkMaturityService $maturity,
private readonly ArtworkMaturityAuditService $audit,
)
{
}
public function index(Request $request): Response
{
$stats = $this->queueStats();
$status = $this->initialStatus($request, $stats);
$routes = $this->routeNamesForRequest($request);
return Inertia::render('Moderation/ArtworkMaturityQueue', [
'title' => 'Artwork Maturity Queue',
'initialItems' => $this->queueItems($status),
'initialFilters' => [
'status' => $status,
'ai_action' => 'all',
'ai_status' => 'all',
],
'stats' => $stats,
'endpoints' => [
'list' => route($routes['list']),
'reviewPattern' => route($routes['review'], ['artwork' => '__ARTWORK__']),
],
'filterOptions' => [
'aiAction' => [
['value' => 'all', 'label' => 'All actions'],
['value' => ArtworkMaturityService::AI_ACTION_SAFE, 'label' => 'Safe'],
['value' => ArtworkMaturityService::AI_ACTION_REVIEW, 'label' => 'Review'],
['value' => ArtworkMaturityService::AI_ACTION_FLAG_HIGH, 'label' => 'Flag high'],
],
'aiStatus' => [
['value' => 'all', 'label' => 'All statuses'],
['value' => ArtworkMaturityService::AI_STATUS_SUCCEEDED, 'label' => 'Succeeded'],
['value' => ArtworkMaturityService::AI_STATUS_PENDING, 'label' => 'Pending'],
['value' => ArtworkMaturityService::AI_STATUS_FAILED, 'label' => 'Failed'],
['value' => ArtworkMaturityService::AI_STATUS_SKIPPED, 'label' => 'Skipped'],
],
],
'reviewActions' => [
['value' => 'mark_safe', 'label' => 'Mark safe'],
['value' => 'mark_mature', 'label' => 'Mark mature'],
['value' => 'confirm_current', 'label' => 'Confirm current state'],
],
])->rootView('moderation');
}
public function list(Request $request): JsonResponse
{
$status = $this->normalizeStatus((string) $request->query('status', 'suspected'));
$aiAction = strtolower((string) $request->query('ai_action', 'all'));
$aiStatus = strtolower((string) $request->query('ai_status', 'all'));
return response()->json([
'data' => $this->queueItems($status, $aiAction, $aiStatus),
'meta' => [
'stats' => $this->queueStats(),
'status' => $status,
'filters' => [
'ai_action' => $aiAction,
'ai_status' => $aiStatus,
],
],
]);
}
public function review(Request $request, Artwork $artwork): JsonResponse
{
$validated = $request->validate([
'action' => ['required', 'in:mark_safe,mark_mature,confirm_current'],
'note' => ['nullable', 'string', 'max:2000'],
]);
/** @var User $moderator */
$moderator = $request->user('controlpanel') ?? $request->user() ?? abort(403, 'Admin access required.');
$artwork = $this->maturity->review($artwork, (string) $validated['action'], $moderator, $validated['note'] ?? null);
$this->audit->resolveFindingForReview($artwork, $moderator, (string) $validated['action'], $validated['note'] ?? null);
return response()->json([
'success' => true,
'artwork' => $this->mapQueueItem($artwork->loadMissing(['user.profile', 'group', 'categories.contentType'])),
'stats' => $this->queueStats(),
]);
}
/**
* @return array<int, array<string, mixed>>
*/
private function queueItems(string $status, string $aiAction = 'all', string $aiStatus = 'all'): array
{
if ($status === 'audit') {
return $this->auditQueueItems($aiAction, $aiStatus);
}
$query = Artwork::query()
->with(['user.profile', 'group', 'categories.contentType'])
->where(function ($builder): void {
$builder->where('maturity_status', ArtworkMaturityService::STATUS_SUSPECTED)
->orWhere(function ($reviewed): void {
$reviewed->where('maturity_status', ArtworkMaturityService::STATUS_REVIEWED)
->whereNotNull('maturity_reviewed_at');
});
})
->latest('maturity_flagged_at')
->latest('published_at')
->limit(100);
if ($status === 'reviewed') {
$query->where('maturity_status', ArtworkMaturityService::STATUS_REVIEWED);
} else {
$query->where('maturity_status', ArtworkMaturityService::STATUS_SUSPECTED);
}
if (in_array($aiAction, [
ArtworkMaturityService::AI_ACTION_SAFE,
ArtworkMaturityService::AI_ACTION_REVIEW,
ArtworkMaturityService::AI_ACTION_FLAG_HIGH,
], true)) {
$query->where('maturity_ai_action_hint', $aiAction);
}
if (in_array($aiStatus, [
ArtworkMaturityService::AI_STATUS_SUCCEEDED,
ArtworkMaturityService::AI_STATUS_PENDING,
ArtworkMaturityService::AI_STATUS_FAILED,
ArtworkMaturityService::AI_STATUS_SKIPPED,
], true)) {
$query->where('maturity_ai_status', $aiStatus);
}
return $query->get()->map(fn (Artwork $artwork): array => $this->mapQueueItem($artwork))->all();
}
/**
* @return array<int, array<string, mixed>>
*/
private function auditQueueItems(string $aiAction = 'all', string $aiStatus = 'all'): array
{
$query = $this->audit->openFindingsQuery()
->latest('detected_at')
->latest('updated_at')
->limit(100);
if (in_array($aiAction, [
ArtworkMaturityService::AI_ACTION_SAFE,
ArtworkMaturityService::AI_ACTION_REVIEW,
ArtworkMaturityService::AI_ACTION_FLAG_HIGH,
], true)) {
$query->where('ai_action_hint', $aiAction);
}
if (in_array($aiStatus, [
ArtworkMaturityService::AI_STATUS_SUCCEEDED,
ArtworkMaturityService::AI_STATUS_PENDING,
ArtworkMaturityService::AI_STATUS_FAILED,
ArtworkMaturityService::AI_STATUS_SKIPPED,
ArtworkMaturityService::AI_STATUS_NOT_REQUESTED,
], true)) {
$query->where('ai_status', $aiStatus);
}
return $query->get()->map(fn (ArtworkMaturityAuditFinding $finding): array => $this->mapAuditQueueItem($finding))->all();
}
/**
* @return array<string, int>
*/
private function queueStats(): array
{
return [
'suspected' => (int) Artwork::query()->where('maturity_status', ArtworkMaturityService::STATUS_SUSPECTED)->count(),
'audit' => $this->audit->openFindingsCount(),
'reviewed' => (int) Artwork::query()->where('maturity_status', ArtworkMaturityService::STATUS_REVIEWED)->count(),
'mature' => (int) Artwork::query()->where('is_mature', true)->count(),
];
}
/**
* @return array<string, mixed>
*/
private function mapAuditQueueItem(ArtworkMaturityAuditFinding $finding): array
{
$artwork = $finding->artwork;
return $this->mapQueueItem($artwork, [
'status' => (string) $finding->status,
'thumbnail_variant' => $finding->thumbnail_variant,
'detected_at' => optional($finding->detected_at)->toIsoString(),
'last_scanned_at' => optional($finding->last_scanned_at)->toIsoString(),
'ai_label' => $finding->ai_label,
'ai_confidence' => $finding->ai_confidence,
'ai_score' => $finding->ai_score,
'ai_labels' => $finding->ai_labels,
'ai_model' => $finding->ai_model,
'ai_threshold_used' => $finding->ai_threshold_used,
'ai_analysis_time_ms' => $finding->ai_analysis_time_ms,
'ai_action_hint' => $finding->ai_action_hint,
'ai_status' => $finding->ai_status,
'ai_advisory' => $finding->ai_advisory,
'legacy_unset' => $this->audit->isArtworkEligible($artwork),
]);
}
/**
* @return array<string, mixed>
*/
private function mapQueueItem(Artwork $artwork, ?array $audit = null): array
{
$category = $artwork->categories->sortBy('sort_order')->first();
$publisherName = $artwork->group?->name ?: $artwork->user?->name ?: $artwork->user?->username ?: 'Artist';
$thumb = ThumbnailPresenter::present($artwork, 'md');
$preview = ThumbnailPresenter::present($artwork, 'xl');
return [
'id' => (int) $artwork->id,
'title' => (string) $artwork->title,
'url' => route('art.show', ['id' => $artwork->id, 'slug' => Str::slug((string) ($artwork->slug ?: $artwork->title)) ?: (string) $artwork->id]),
'admin_url' => route('admin.cp.artworks.edit', ['id' => $artwork->id]),
'thumbnail' => $thumb['url'] ?? null,
'preview_image' => $preview['url'] ?? ($thumb['url'] ?? null),
'publisher' => $publisherName,
'published_at' => optional($artwork->published_at)->toIsoString(),
'content_type' => $category?->contentType?->name,
'category' => $category?->name,
'maturity' => $this->maturity->presentation($artwork, null),
'audit' => $audit,
'review' => [
'reviewed_at' => optional($artwork->maturity_reviewed_at)->toIsoString(),
'reviewed_by' => $artwork->maturity_reviewed_by,
'reviewer_note' => $artwork->maturity_reviewer_note,
],
];
}
private function normalizeStatus(string $status): string
{
$normalized = Str::lower(trim($status));
return in_array($normalized, ['suspected', 'reviewed', 'audit'], true)
? $normalized
: 'suspected';
}
/**
* @param array<string, int> $stats
*/
private function initialStatus(Request $request, array $stats): string
{
if ($request->query->has('status')) {
return $this->normalizeStatus((string) $request->query('status'));
}
if (($stats['suspected'] ?? 0) > 0) {
return 'suspected';
}
if (($stats['audit'] ?? 0) > 0) {
return 'audit';
}
if (($stats['reviewed'] ?? 0) > 0) {
return 'reviewed';
}
return 'suspected';
}
/**
* @return array{list: string, review: string}
*/
private function routeNamesForRequest(Request $request): array
{
$routeName = (string) $request->route()?->getName();
if (Str::startsWith($routeName, 'admin.cp.artworks.maturity.')) {
return [
'list' => 'admin.cp.artworks.maturity.queue',
'review' => 'admin.cp.artworks.maturity.review',
];
}
return [
'list' => 'cp.maturity.list',
'review' => 'cp.maturity.review',
];
}
}

View File

@@ -0,0 +1,145 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Models\Collection;
use App\Services\CollectionAiCurationService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class CollectionAiController extends Controller
{
public function __construct(
private readonly CollectionAiCurationService $ai,
) {
}
public function suggestTitle(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestTitle($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestSummary(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestSummary($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestCover(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestCover($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestGrouping(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestGrouping($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestRelatedArtworks(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestRelatedArtworks($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestTags(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestTags($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestSeoDescription(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestSeoDescription($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function explainSmartRules(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->explainSmartRules($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestSplitThemes(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestSplitThemes($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestMergeIdea(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestMergeIdea($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function detectWeakMetadata(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->detectWeakMetadata($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestStaleRefresh(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestStaleRefresh($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestCampaignFit(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestCampaignFit($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
public function suggestRelatedCollectionsToLink(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'suggestion' => $this->ai->suggestRelatedCollectionsToLink($collection->loadMissing('user'), (array) $request->input('draft', [])),
]);
}
}

View File

@@ -0,0 +1,342 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Http\Requests\Collections\CollectionBulkActionsRequest;
use App\Http\Requests\Collections\CollectionOwnerSearchRequest;
use App\Http\Requests\Collections\CollectionTargetActionRequest;
use App\Http\Requests\Collections\UpdateCollectionWorkflowRequest;
use App\Models\Collection;
use App\Models\CollectionHistory;
use App\Services\CollectionAiOperationsService;
use App\Services\CollectionAnalyticsService;
use App\Services\CollectionBackgroundJobService;
use App\Services\CollectionBulkActionService;
use App\Services\CollectionCanonicalService;
use App\Services\CollectionDashboardService;
use App\Services\CollectionHistoryService;
use App\Services\CollectionHealthService;
use App\Services\CollectionMergeService;
use App\Services\CollectionSearchService;
use App\Services\CollectionService;
use App\Services\CollectionWorkflowService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Inertia\Inertia;
use Inertia\Response;
class CollectionInsightsController extends Controller
{
public function __construct(
private readonly CollectionDashboardService $dashboard,
private readonly CollectionAnalyticsService $analytics,
private readonly CollectionHistoryService $history,
private readonly CollectionAiOperationsService $aiOperations,
private readonly CollectionBackgroundJobService $backgroundJobs,
private readonly CollectionBulkActionService $bulkActions,
private readonly CollectionService $collections,
private readonly CollectionSearchService $search,
private readonly CollectionHealthService $health,
private readonly CollectionWorkflowService $workflow,
private readonly CollectionCanonicalService $canonical,
private readonly CollectionMergeService $merge,
) {
}
public function dashboard(Request $request): Response
{
$payload = $this->dashboard->build($request->user());
return Inertia::render('Collection/CollectionDashboard', [
'summary' => $payload['summary'],
'topPerforming' => $this->collections->mapCollectionCardPayloads($payload['top_performing'], true),
'needsAttention' => $this->collections->mapCollectionCardPayloads($payload['needs_attention'], true),
'expiringCampaigns' => $this->collections->mapCollectionCardPayloads($payload['expiring_campaigns'], true),
'healthWarnings' => $payload['health_warnings'],
'filterOptions' => [
'types' => [
Collection::TYPE_PERSONAL,
Collection::TYPE_COMMUNITY,
Collection::TYPE_EDITORIAL,
],
'visibilities' => [
Collection::VISIBILITY_PUBLIC,
Collection::VISIBILITY_UNLISTED,
Collection::VISIBILITY_PRIVATE,
],
'lifecycleStates' => [
Collection::LIFECYCLE_DRAFT,
Collection::LIFECYCLE_SCHEDULED,
Collection::LIFECYCLE_PUBLISHED,
Collection::LIFECYCLE_FEATURED,
Collection::LIFECYCLE_ARCHIVED,
Collection::LIFECYCLE_HIDDEN,
Collection::LIFECYCLE_RESTRICTED,
Collection::LIFECYCLE_UNDER_REVIEW,
Collection::LIFECYCLE_EXPIRED,
],
'workflowStates' => [
Collection::WORKFLOW_DRAFT,
Collection::WORKFLOW_IN_REVIEW,
Collection::WORKFLOW_APPROVED,
Collection::WORKFLOW_PROGRAMMED,
Collection::WORKFLOW_ARCHIVED,
],
'healthStates' => [
Collection::HEALTH_HEALTHY,
Collection::HEALTH_NEEDS_METADATA,
Collection::HEALTH_STALE,
Collection::HEALTH_LOW_CONTENT,
Collection::HEALTH_BROKEN_ITEMS,
Collection::HEALTH_WEAK_COVER,
Collection::HEALTH_LOW_ENGAGEMENT,
Collection::HEALTH_ATTRIBUTION_INCOMPLETE,
Collection::HEALTH_NEEDS_REVIEW,
Collection::HEALTH_DUPLICATE_RISK,
Collection::HEALTH_MERGE_CANDIDATE,
],
],
'endpoints' => [
'managePattern' => route('settings.collections.show', ['collection' => '__COLLECTION__']),
'analyticsPattern' => route('settings.collections.analytics', ['collection' => '__COLLECTION__']),
'historyPattern' => route('settings.collections.history', ['collection' => '__COLLECTION__']),
'healthPattern' => route('settings.collections.health', ['collection' => '__COLLECTION__']),
'search' => route('settings.collections.search'),
'bulkActions' => route('settings.collections.bulk-actions'),
],
'seo' => [
'title' => 'Collections Dashboard — Skinbase Nova',
'description' => 'Overview of collection lifecycle, quality, activity, and upcoming collection campaigns.',
'canonical' => route('settings.collections.dashboard'),
'robots' => 'noindex,follow',
],
])->rootView('collections');
}
public function analytics(Request $request, Collection $collection): Response
{
$this->authorize('update', $collection);
$collection->loadMissing(['user.profile', 'coverArtwork']);
return Inertia::render('Collection/CollectionAnalytics', [
'collection' => $this->collections->mapCollectionDetailPayload($collection, true),
'analytics' => $this->analytics->overview($collection, (int) $request->integer('days', 30)),
'historyUrl' => route('settings.collections.history', ['collection' => $collection->id]),
'dashboardUrl' => route('settings.collections.dashboard'),
'seo' => [
'title' => sprintf('%s Analytics — Skinbase Nova', $collection->title),
'description' => sprintf('Analytics and performance history for the %s collection.', $collection->title),
'canonical' => route('settings.collections.analytics', ['collection' => $collection->id]),
'robots' => 'noindex,follow',
],
])->rootView('collections');
}
public function history(Request $request, Collection $collection): Response
{
$this->authorize('update', $collection);
$collection->loadMissing(['user.profile', 'coverArtwork']);
$history = $this->history->historyFor($collection, (int) $request->integer('per_page', 40));
return Inertia::render('Collection/CollectionHistory', [
'collection' => $this->collections->mapCollectionDetailPayload($collection, true),
'history' => $this->history->mapPaginator($history),
'canRestoreHistory' => $this->isStaff($request),
'dashboardUrl' => route('settings.collections.dashboard'),
'analyticsUrl' => route('settings.collections.analytics', ['collection' => $collection->id]),
'restorePattern' => route('settings.collections.history.restore', ['collection' => $collection->id, 'history' => '__HISTORY__']),
'seo' => [
'title' => sprintf('%s History — Skinbase Nova', $collection->title),
'description' => sprintf('Audit history and lifecycle changes for the %s collection.', $collection->title),
'canonical' => route('settings.collections.history', ['collection' => $collection->id]),
'robots' => 'noindex,follow',
],
])->rootView('collections');
}
public function restoreHistory(Request $request, Collection $collection, CollectionHistory $history): JsonResponse
{
$this->authorize('update', $collection);
abort_unless($this->isStaff($request), 403);
$collection = $this->history->restore($collection->loadMissing('user'), $history, $request->user());
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'health' => $this->health->summary($collection),
'restored_history_entry_id' => (int) $history->id,
]);
}
public function qualityReview(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'ok' => true,
'review' => $this->aiOperations->qualityReview($collection->loadMissing(['user.profile', 'coverArtwork'])),
]);
}
public function search(CollectionOwnerSearchRequest $request): JsonResponse
{
$filters = $request->validated();
$results = $this->search->ownerSearch($request->user(), $filters, (int) config('collections.v5.search.owner_per_page', 20));
return response()->json([
'ok' => true,
'collections' => $this->collections->mapCollectionCardPayloads($results->items(), true),
'filters' => $filters,
'meta' => [
'current_page' => $results->currentPage(),
'last_page' => $results->lastPage(),
'per_page' => $results->perPage(),
'total' => $results->total(),
],
]);
}
public function bulkActions(CollectionBulkActionsRequest $request): JsonResponse
{
$payload = $request->validated();
$result = $this->bulkActions->apply($request->user(), $payload);
$dashboard = $this->dashboard->build($request->user());
return response()->json([
'ok' => true,
'action' => $result['action'],
'count' => $result['count'],
'message' => $result['message'],
'collections' => $this->collections->mapCollectionCardPayloads($result['collections'], true),
'items' => $result['items'],
'summary' => $dashboard['summary'],
'healthWarnings' => $dashboard['health_warnings'],
]);
}
public function health(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$collection->loadMissing(['user.profile', 'coverArtwork']);
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection, true),
'health' => $this->health->summary($collection),
'duplicate_candidates' => $this->collections->mapCollectionCardPayloads($this->merge->duplicateCandidates($collection), true),
'history_url' => route('settings.collections.history', ['collection' => $collection->id]),
]);
}
public function workflowUpdate(UpdateCollectionWorkflowRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$payload = $request->validated();
if (! $this->isStaff($request)) {
unset($payload['program_key'], $payload['partner_key'], $payload['experiment_key'], $payload['placement_eligibility']);
}
$collection = $this->workflow->update($collection->loadMissing('user'), $payload, $request->user());
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'health' => $this->health->summary($collection),
]);
}
public function qualityRefresh(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return response()->json([
'ok' => true,
'queued' => true,
'result' => $this->backgroundJobs->dispatchQualityRefresh($collection->loadMissing('user'), $request->user()),
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'health' => $this->health->summary($collection),
]);
}
public function canonicalize(CollectionTargetActionRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$payload = $request->validated();
$target = Collection::query()->findOrFail((int) $payload['target_collection_id']);
$this->authorize('update', $target);
$collection = $this->canonical->designate($collection->loadMissing('user'), $target->loadMissing('user'), $request->user());
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'target' => $this->collections->mapCollectionCardPayloads([$target->fresh()->loadMissing('user')], true)[0],
'canonical_target' => $this->collections->mapCollectionCardPayloads([$target->fresh()->loadMissing('user')], true)[0],
'duplicate_candidates' => $this->merge->reviewCandidates($collection->fresh()->loadMissing('user'), true),
]);
}
public function merge(CollectionTargetActionRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$payload = $request->validated();
$target = Collection::query()->findOrFail((int) $payload['target_collection_id']);
$this->authorize('update', $target);
$result = $this->merge->mergeInto($collection->loadMissing('user'), $target->loadMissing('user'), $request->user());
return response()->json([
'ok' => true,
'source' => $this->collections->mapCollectionDetailPayload($result['source']->loadMissing('user'), true),
'target' => $this->collections->mapCollectionDetailPayload($result['target']->loadMissing('user'), true),
'attached_artwork_ids' => $result['attached_artwork_ids'],
'canonical_target' => $this->collections->mapCollectionCardPayloads([$result['target']->loadMissing('user')], true)[0],
'duplicate_candidates' => $this->merge->reviewCandidates($result['source']->fresh()->loadMissing('user'), true),
]);
}
public function rejectDuplicate(CollectionTargetActionRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$payload = $request->validated();
$target = Collection::query()->findOrFail((int) $payload['target_collection_id']);
$this->authorize('update', $target);
$collection = $this->merge->rejectCandidate($collection->loadMissing('user'), $target->loadMissing('user'), $request->user());
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'duplicate_candidates' => $this->merge->reviewCandidates($collection->fresh()->loadMissing('user'), true),
'canonical_target' => $collection->canonical_collection_id
? $this->collections->mapCollectionCardPayloads([
Collection::query()->findOrFail((int) $collection->canonical_collection_id)->loadMissing('user'),
], true)[0]
: null,
]);
}
private function isStaff(Request $request): bool
{
$user = $request->user();
return $user !== null && ($user->isAdmin() || $user->isModerator());
}
}

View File

@@ -0,0 +1,545 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Http\Requests\Collections\AttachCollectionArtworksRequest;
use App\Http\Requests\Collections\ReorderCollectionArtworksRequest;
use App\Http\Requests\Collections\ReorderProfileCollectionsRequest;
use App\Http\Requests\Collections\SmartCollectionRulesRequest;
use App\Http\Requests\Collections\StoreCollectionRequest;
use App\Http\Requests\Collections\UpdateCollectionCampaignRequest;
use App\Http\Requests\Collections\UpdateCollectionEntityLinksRequest;
use App\Http\Requests\Collections\UpdateCollectionRequest;
use App\Http\Requests\Collections\UpdateCollectionLifecycleRequest;
use App\Http\Requests\Collections\UpdateCollectionLinkedCollectionsRequest;
use App\Http\Requests\Collections\UpdateCollectionPresentationRequest;
use App\Http\Requests\Collections\UpdateCollectionSeriesRequest;
use App\Models\Artwork;
use App\Models\Collection;
use App\Models\Group;
use App\Services\CollectionCollaborationService;
use App\Services\CollectionCampaignService;
use App\Services\CollectionCommentService;
use App\Services\CollectionLinkService;
use App\Services\CollectionLinkedCollectionsService;
use App\Services\CollectionMergeService;
use App\Services\CollectionSeriesService;
use App\Services\CollectionSubmissionService;
use App\Services\CollectionService;
use App\Support\AvatarUrl;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Inertia\Inertia;
class CollectionManageController extends Controller
{
public function __construct(
private readonly CollectionService $collections,
private readonly CollectionCampaignService $campaigns,
private readonly CollectionCollaborationService $collaborators,
private readonly CollectionSubmissionService $submissions,
private readonly CollectionCommentService $comments,
private readonly CollectionLinkService $entityLinks,
private readonly CollectionLinkedCollectionsService $linkedCollections,
private readonly CollectionMergeService $merge,
private readonly CollectionSeriesService $series,
) {
}
public function create(Request $request)
{
$this->authorize('create', Collection::class);
$initialMode = $request->query('mode') === Collection::MODE_SMART
? Collection::MODE_SMART
: Collection::MODE_MANUAL;
$group = null;
if ($request->filled('group')) {
$group = Group::query()->with(['owner.profile', 'members'])->where('slug', (string) $request->query('group'))->first();
abort_if($group && ! $group->canManageCollections($request->user()), 403);
}
return Inertia::render('Collection/CollectionManage', [
'mode' => 'create',
'collection' => null,
'layoutModules' => $this->collections->getLayoutModuleDefinitions(),
'attachedArtworks' => [],
'availableArtworks' => [],
'smartPreview' => null,
'smartRuleOptions' => $this->collections->getSmartRuleOptions($request->user()),
'initialMode' => $initialMode,
'featuredLimit' => (int) config('collections.featured_limit', 3),
'owner' => $this->ownerPayload($request, $group),
'members' => [],
'submissions' => [],
'comments' => [],
'duplicateCandidates' => [],
'canonicalTarget' => null,
'inviteExpiryDays' => (int) config('collections.invites.expires_after_days', 7),
'endpoints' => [
'store' => route('settings.collections.store', $group ? ['group' => $group->slug] : []),
'smartPreview' => route('settings.collections.smart.preview'),
'profileCollections' => route('profile.tab', [
'username' => strtolower((string) $request->user()->username),
'tab' => 'collections',
]),
],
])->rootView('collections');
}
public function show(Request $request, Collection $collection)
{
$this->authorize('manageArtworks', $collection);
$collection->loadMissing(['user.profile', 'coverArtwork']);
return Inertia::render('Collection/CollectionManage', [
'mode' => 'edit',
'collection' => $this->collections->mapCollectionDetailPayload($collection, true),
'layoutModules' => $this->collections->mapCollectionDetailPayload($collection, true)['layout_modules'],
'attachedArtworks' => $this->collections->mapAttachedArtworks($collection),
'availableArtworks' => $this->collections->getAvailableArtworkOptions($collection, $request->user()),
'smartPreview' => $collection->isSmart() && is_array($collection->smart_rules_json)
? $this->collections->previewSmartCollection($request->user(), $collection->smart_rules_json)
: null,
'smartRuleOptions' => $this->collections->getSmartRuleOptions($request->user()),
'initialMode' => $collection->mode,
'featuredLimit' => (int) config('collections.featured_limit', 3),
'owner' => $this->ownerPayload($request),
'members' => $this->collaborators->mapMembers($collection, $request->user()),
'submissions' => $this->submissions->mapSubmissions($collection, $request->user()),
'comments' => $this->comments->mapComments($collection, $request->user()),
'duplicateCandidates' => $this->merge->reviewCandidates($collection->loadMissing('user'), true),
'canonicalTarget' => $collection->canonical_collection_id
? $this->collections->mapCollectionCardPayloads([
Collection::query()->findOrFail((int) $collection->canonical_collection_id)->loadMissing('user'),
], true)[0]
: null,
'linkedCollections' => $this->collections->mapCollectionCardPayloads($this->linkedCollections->linkedCollections($collection), true),
'linkedCollectionOptions' => $this->collections->mapCollectionCardPayloads($this->linkedCollections->manageableLinkOptions($collection, $request->user()), true),
'entityLinks' => $this->entityLinks->links($collection, false),
'entityLinkOptions' => $this->entityLinks->manageableOptions($collection),
'inviteExpiryDays' => (int) config('collections.invites.expires_after_days', 7),
'endpoints' => [
'update' => route('settings.collections.update', ['collection' => $collection->id]),
'updatePresentation' => route('settings.collections.presentation', ['collection' => $collection->id]),
'updateCampaign' => route('settings.collections.campaign', ['collection' => $collection->id]),
'updateSeries' => route('settings.collections.series', ['collection' => $collection->id]),
'updateLifecycle' => route('settings.collections.lifecycle', ['collection' => $collection->id]),
'syncLinkedCollections' => route('settings.collections.linked.sync', ['collection' => $collection->id]),
'syncEntityLinks' => route('settings.collections.entity-links.sync', ['collection' => $collection->id]),
'delete' => route('settings.collections.destroy', ['collection' => $collection->id]),
'attach' => route('settings.collections.artworks.attach', ['collection' => $collection->id]),
'reorder' => route('settings.collections.artworks.reorder', ['collection' => $collection->id]),
'available' => route('settings.collections.artworks.available', ['collection' => $collection->id]),
'removePattern' => route('settings.collections.artworks.remove', ['collection' => $collection->id, 'artwork' => '__ARTWORK__']),
'edit' => route('settings.collections.edit', ['collection' => $collection->id]),
'feature' => route('settings.collections.feature', ['collection' => $collection->id]),
'unfeature' => route('settings.collections.unfeature', ['collection' => $collection->id]),
'smartPreview' => route('settings.collections.smart.preview'),
'aiSuggestTitle' => route('settings.collections.ai.suggest-title', ['collection' => $collection->id]),
'aiSuggestSummary' => route('settings.collections.ai.suggest-summary', ['collection' => $collection->id]),
'aiSuggestCover' => route('settings.collections.ai.suggest-cover', ['collection' => $collection->id]),
'aiSuggestGrouping' => route('settings.collections.ai.suggest-grouping', ['collection' => $collection->id]),
'aiSuggestRelatedArtworks' => route('settings.collections.ai.suggest-related-artworks', ['collection' => $collection->id]),
'aiSuggestTags' => route('settings.collections.ai.suggest-tags', ['collection' => $collection->id]),
'aiSuggestSeoDescription' => route('settings.collections.ai.suggest-seo-description', ['collection' => $collection->id]),
'aiExplainSmartRules' => route('settings.collections.ai.explain-smart-rules', ['collection' => $collection->id]),
'aiSuggestSplitThemes' => route('settings.collections.ai.suggest-split-themes', ['collection' => $collection->id]),
'aiSuggestMergeIdea' => route('settings.collections.ai.suggest-merge-idea', ['collection' => $collection->id]),
'aiQualityReview' => route('settings.collections.ai.quality-review', ['collection' => $collection->id]),
'updateSmartRules' => route('settings.collections.smart.rules', ['collection' => $collection->id]),
'inviteMember' => route('settings.collections.members.store', ['collection' => $collection->id]),
'memberUpdatePattern' => route('settings.collections.members.update', ['collection' => $collection->id, 'member' => '__MEMBER__']),
'memberTransferPattern' => route('settings.collections.members.transfer', ['collection' => $collection->id, 'member' => '__MEMBER__']),
'memberDeletePattern' => route('settings.collections.members.destroy', ['collection' => $collection->id, 'member' => '__MEMBER__']),
'acceptMemberPattern' => route('settings.collections.members.accept', ['member' => '__MEMBER__']),
'declineMemberPattern' => route('settings.collections.members.decline', ['member' => '__MEMBER__']),
'adminModerationUpdate' => $this->isAdmin($request) ? route('api.admin.collections.moderation.update', ['collection' => $collection->id]) : null,
'adminInteractionsUpdate' => $this->isAdmin($request) ? route('api.admin.collections.interactions.update', ['collection' => $collection->id]) : null,
'adminUnfeature' => $this->isAdmin($request) ? route('api.admin.collections.unfeature', ['collection' => $collection->id]) : null,
'adminMemberRemovePattern' => $this->isAdmin($request) ? route('api.admin.collections.members.destroy', ['collection' => $collection->id, 'member' => '__MEMBER__']) : null,
'submissionStore' => route('collections.submissions.store', ['collection' => $collection->id]),
'submissionApprovePattern' => route('collections.submissions.approve', ['submission' => '__SUBMISSION__']),
'submissionRejectPattern' => route('collections.submissions.reject', ['submission' => '__SUBMISSION__']),
'submissionDeletePattern' => route('collections.submissions.destroy', ['submission' => '__SUBMISSION__']),
'commentsIndex' => route('collections.comments.index', ['collection' => $collection->id]),
'commentsStore' => route('collections.comments.store', ['collection' => $collection->id]),
'commentDeletePattern' => route('collections.comments.destroy', ['collection' => $collection->id, 'comment' => '__COMMENT__']),
'public' => route('profile.collections.show', [
'username' => strtolower((string) $collection->user->username),
'slug' => $collection->slug,
]),
'dashboard' => route('settings.collections.dashboard'),
'analytics' => route('settings.collections.analytics', ['collection' => $collection->id]),
'history' => route('settings.collections.history', ['collection' => $collection->id]),
'canonicalize' => route('settings.collections.canonicalize', ['collection' => $collection->id]),
'merge' => route('settings.collections.merge', ['collection' => $collection->id]),
'rejectDuplicate' => route('settings.collections.merge.reject', ['collection' => $collection->id]),
'staffSurfaces' => $this->isAdmin($request) ? route('settings.collections.surfaces.index') : null,
'staffProgramming' => $this->isAdmin($request) ? route('staff.collections.programming') : null,
'profileCollections' => route('profile.tab', [
'username' => strtolower((string) $collection->user->username),
'tab' => 'collections',
]),
],
'viewer' => [
'is_admin' => $this->isAdmin($request),
],
])->rootView('collections');
}
public function edit(Request $request, Collection $collection)
{
return $this->show($request, $collection);
}
public function store(StoreCollectionRequest $request): RedirectResponse|JsonResponse
{
$this->authorize('create', Collection::class);
$collection = $this->collections->createCollection($request->user(), $request->validated());
$redirectTo = (string) route('settings.collections.show', ['collection' => $collection->id]);
return $this->jsonOrRedirect($request, [
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'members' => $this->collaborators->mapMembers($collection, $request->user()),
'submissions' => $this->submissions->mapSubmissions($collection, $request->user()),
'comments' => $this->comments->mapComments($collection, $request->user()),
'redirect' => $redirectTo,
], $redirectTo);
}
public function update(UpdateCollectionRequest $request, Collection $collection): RedirectResponse|JsonResponse
{
$this->authorize('update', $collection);
$collection = $this->collections->updateCollection($collection->loadMissing('user'), $request->validated(), $request->user());
$redirectTo = (string) route('settings.collections.show', ['collection' => $collection->id]);
return $this->jsonOrRedirect($request, [
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'attachedArtworks' => $this->collections->mapAttachedArtworks($collection),
'members' => $this->collaborators->mapMembers($collection, $request->user()),
'submissions' => $this->submissions->mapSubmissions($collection, $request->user()),
'comments' => $this->comments->mapComments($collection, $request->user()),
'redirect' => $redirectTo,
], $redirectTo);
}
public function updatePresentation(UpdateCollectionPresentationRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return $this->updateScopedSettings($request, $collection, $request->validated());
}
public function updateCampaign(UpdateCollectionCampaignRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$collection = $this->campaigns->updateCampaign($collection, $request->validated(), $request->user());
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'campaign' => $this->campaigns->campaignSummary($collection),
'attachedArtworks' => $this->collections->mapAttachedArtworks($collection),
'members' => $this->collaborators->mapMembers($collection, $request->user()),
'submissions' => $this->submissions->mapSubmissions($collection, $request->user()),
'comments' => $this->comments->mapComments($collection, $request->user()),
]);
}
public function updateSeries(UpdateCollectionSeriesRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$collection = $this->series->updateSeries($collection, $request->validated(), $request->user());
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'series' => $this->series->summary($collection),
'attachedArtworks' => $this->collections->mapAttachedArtworks($collection),
'members' => $this->collaborators->mapMembers($collection, $request->user()),
'submissions' => $this->submissions->mapSubmissions($collection, $request->user()),
'comments' => $this->comments->mapComments($collection, $request->user()),
]);
}
public function updateLifecycle(UpdateCollectionLifecycleRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
return $this->updateScopedSettings($request, $collection, $request->validated());
}
public function syncLinkedCollections(UpdateCollectionLinkedCollectionsRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$collection = $this->linkedCollections->syncLinks($collection->loadMissing('user'), $request->user(), $request->validated('related_collection_ids', []));
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'linkedCollections' => $this->collections->mapCollectionCardPayloads($this->linkedCollections->linkedCollections($collection), true),
'linkedCollectionOptions' => $this->collections->mapCollectionCardPayloads($this->linkedCollections->manageableLinkOptions($collection, $request->user()), true),
]);
}
public function syncEntityLinks(UpdateCollectionEntityLinksRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$collection = $this->entityLinks->syncLinks($collection->loadMissing('user'), $request->user(), $request->validated('entity_links', []));
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'entityLinks' => $this->entityLinks->links($collection, false),
'entityLinkOptions' => $this->entityLinks->manageableOptions($collection),
]);
}
public function destroy(Request $request, Collection $collection): RedirectResponse|JsonResponse
{
$this->authorize('delete', $collection);
$profileCollectionsUrl = (string) route('profile.tab', [
'username' => strtolower((string) $collection->user->username),
'tab' => 'collections',
]);
$this->collections->deleteCollection($collection);
return $this->jsonOrRedirect($request, [
'ok' => true,
'redirect' => $profileCollectionsUrl,
], $profileCollectionsUrl);
}
public function attachArtworks(AttachCollectionArtworksRequest $request, Collection $collection): JsonResponse
{
$this->authorize('manageArtworks', $collection);
$collection = $this->collections->attachArtworks($collection->loadMissing('user'), $request->user(), $request->validated('artwork_ids'));
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'attachedArtworks' => $this->collections->mapAttachedArtworks($collection),
'availableArtworks' => $this->collections->getAvailableArtworkOptions($collection, $request->user()),
]);
}
public function artworkCollectionOptions(Request $request): JsonResponse
{
$artwork = $this->resolveArtworkFromRequest($request, 4);
if ((int) ($artwork->group_id ?? 0) > 0) {
abort_unless($artwork->group?->canManageCollections($request->user()) ?? false, 404);
} else {
abort_unless((int) $artwork->user_id === (int) $request->user()->id, 404);
}
return response()->json([
'data' => $this->collections->getCollectionOptionsForArtwork($request->user(), $artwork),
'meta' => [
'create_url' => route('settings.collections.create'),
'artwork_id' => (int) $artwork->id,
],
]);
}
public function removeArtwork(Request $request, Collection $collection): JsonResponse
{
$this->authorize('manageArtworks', $collection);
$artwork = $this->resolveArtworkFromRequest($request, 5);
$isAttached = $collection->artworks()->where('artworks.id', $artwork->id)->exists();
abort_unless($isAttached, 404);
$collection = $this->collections->removeArtwork($collection->loadMissing('user'), $artwork);
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'attachedArtworks' => $this->collections->mapAttachedArtworks($collection),
'availableArtworks' => $this->collections->getAvailableArtworkOptions($collection, $request->user()),
]);
}
public function reorderArtworks(ReorderCollectionArtworksRequest $request, Collection $collection): JsonResponse
{
$this->authorize('manageArtworks', $collection);
$collection = $this->collections->reorderArtworks($collection->loadMissing('user'), $request->validated('ordered_artwork_ids'));
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'attachedArtworks' => $this->collections->mapAttachedArtworks($collection),
]);
}
public function availableArtworks(Request $request, Collection $collection): JsonResponse
{
$this->authorize('manageArtworks', $collection);
$request->validate([
'search' => ['nullable', 'string', 'max:120'],
]);
return response()->json([
'data' => $this->collections->getAvailableArtworkOptions($collection, $request->user(), (string) $request->input('search', '')),
]);
}
public function feature(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$collection = $this->collections->featureCollection($collection);
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
]);
}
public function unfeature(Request $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$collection = $this->collections->unfeatureCollection($collection);
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
]);
}
public function reorderProfile(ReorderProfileCollectionsRequest $request): JsonResponse
{
$this->collections->reorderProfileCollections($request->user(), $request->validated('collection_ids'));
$items = $this->collections->getProfileCollections($request->user(), $request->user(), 24);
return response()->json([
'ok' => true,
'collections' => $this->collections->mapCollectionCardPayloads($items, true),
]);
}
public function smartPreview(SmartCollectionRulesRequest $request): JsonResponse
{
return response()->json([
'ok' => true,
'preview' => $this->collections->previewSmartCollection($request->user(), $request->validated('smart_rules_json')),
]);
}
public function updateSmartRules(SmartCollectionRulesRequest $request, Collection $collection): JsonResponse
{
$this->authorize('update', $collection);
$collection = $this->collections->updateCollection($collection->loadMissing('user'), [
'title' => $collection->title,
'slug' => $collection->slug,
'description' => $collection->description,
'subtitle' => $collection->subtitle,
'summary' => $collection->summary,
'visibility' => $collection->visibility,
'mode' => Collection::MODE_SMART,
'sort_mode' => (string) (($request->validated('smart_rules_json')['sort'] ?? null) ?: $collection->sort_mode),
'smart_rules_json' => $request->validated('smart_rules_json'),
]);
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'preview' => $this->collections->previewSmartCollection($request->user(), $collection->smart_rules_json ?? []),
]);
}
private function ownerPayload(Request $request): array
{
$user = $request->user();
if ($request->filled('group')) {
$group = Group::query()->with('owner.profile')->where('slug', (string) $request->query('group'))->first();
if ($group && $group->canManageCollections($user)) {
return [
'id' => $group->id,
'username' => null,
'name' => $group->name,
'avatar_url' => $group->avatarUrl(),
'group_slug' => $group->slug,
'profile_url' => $group->publicUrl(),
];
}
}
return [
'id' => $user->id,
'username' => $user->username,
'name' => $user->name,
'avatar_url' => AvatarUrl::forUser((int) $user->id, $user->profile?->avatar_hash, 96),
];
}
private function isAdmin(Request $request): bool
{
$user = $request->user();
return $user !== null && method_exists($user, 'hasRole') && $user->hasRole('admin');
}
private function updateScopedSettings(Request $request, Collection $collection, array $attributes): JsonResponse
{
$collection = $this->collections->updateCollection($collection->loadMissing('user'), $attributes, $request->user());
return response()->json([
'ok' => true,
'collection' => $this->collections->mapCollectionDetailPayload($collection->loadMissing('user'), true),
'attachedArtworks' => $this->collections->mapAttachedArtworks($collection),
'members' => $this->collaborators->mapMembers($collection, $request->user()),
'submissions' => $this->submissions->mapSubmissions($collection, $request->user()),
'comments' => $this->comments->mapComments($collection, $request->user()),
]);
}
private function jsonOrRedirect(Request $request, array $payload, string $redirectTo): RedirectResponse|JsonResponse
{
if ($request->expectsJson()) {
return response()->json($payload);
}
return redirect($redirectTo);
}
private function resolveArtworkFromRequest(Request $request, int $fallbackSegment): Artwork
{
$routeValue = $request->route('artwork');
if ($routeValue instanceof Artwork) {
return $routeValue;
}
$artworkId = is_scalar($routeValue)
? (int) $routeValue
: (int) $request->segment($fallbackSegment);
return Artwork::query()->findOrFail($artworkId);
}
}

View File

@@ -0,0 +1,309 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Http\Requests\Collections\CollectionProgramAssignmentRequest;
use App\Http\Requests\Collections\CollectionProgrammingCollectionRequest;
use App\Http\Requests\Collections\CollectionProgrammingMergePairRequest;
use App\Http\Requests\Collections\CollectionProgrammingMetadataRequest;
use App\Http\Requests\Collections\CollectionProgrammingPreviewRequest;
use App\Models\Collection;
use App\Models\CollectionProgramAssignment;
use App\Services\CollectionBackgroundJobService;
use App\Services\CollectionObservabilityService;
use App\Services\CollectionProgrammingService;
use App\Services\CollectionService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Inertia\Inertia;
use Inertia\Response;
class CollectionProgrammingController extends Controller
{
public function __construct(
private readonly CollectionProgrammingService $programming,
private readonly CollectionService $collections,
private readonly CollectionBackgroundJobService $backgroundJobs,
private readonly CollectionObservabilityService $observability,
) {
}
public function index(Request $request): Response|JsonResponse
{
$this->authorizeStaff($request);
$assignments = $this->programming->assignments();
if ($request->expectsJson()) {
return response()->json([
'ok' => true,
'assignments' => $assignments->map(fn (CollectionProgramAssignment $assignment): array => $this->mapAssignment($assignment))->values()->all(),
]);
}
$collectionOptions = Collection::query()
->with(['user:id,username,name', 'coverArtwork:id,user_id,title,slug,hash,thumb_ext,published_at,is_public,is_approved,deleted_at'])
->where(function ($query): void {
$query->where(function ($public): void {
$public->where('visibility', Collection::VISIBILITY_PUBLIC)
->whereIn('lifecycle_state', [Collection::LIFECYCLE_PUBLISHED, Collection::LIFECYCLE_FEATURED])
->where('moderation_status', Collection::MODERATION_ACTIVE);
})->orWhereNotNull('program_key');
})
->orderByDesc('ranking_score')
->orderByDesc('updated_at')
->limit(40)
->get();
$programKeyOptions = $assignments->pluck('program_key')
->merge($collectionOptions->pluck('program_key'))
->filter(fn ($value): bool => is_string($value) && $value !== '')
->unique()
->sort()
->values()
->all();
return Inertia::render('Collection/CollectionStaffProgramming', [
'assignments' => $assignments->map(fn (CollectionProgramAssignment $assignment): array => $this->mapAssignment($assignment))->values()->all(),
'collectionOptions' => $this->collections->mapCollectionCardPayloads($collectionOptions, true),
'programKeyOptions' => $programKeyOptions,
'mergeQueue' => $this->programming->mergeQueue(true),
'observabilitySummary' => $this->observability->summary(),
'historyPattern' => route('settings.collections.history', ['collection' => '__COLLECTION__']),
'viewer' => [
'isAdmin' => $this->isAdmin($request),
],
'endpoints' => [
'store' => route('staff.collections.programs.store'),
'updatePattern' => route('staff.collections.programs.update', ['program' => '__PROGRAM__']),
'publicProgramPattern' => route('collections.program.show', ['programKey' => '__PROGRAM__']),
'preview' => route('staff.collections.surfaces.preview'),
'refreshEligibility' => route('staff.collections.eligibility.refresh'),
'duplicateScan' => route('staff.collections.duplicate-scan'),
'refreshRecommendations' => route('staff.collections.recommendation-refresh'),
'metadataUpdate' => route('staff.collections.metadata.update'),
'canonicalizeCandidate' => route('staff.collections.merge-queue.canonicalize'),
'mergeCandidate' => route('staff.collections.merge-queue.merge'),
'rejectCandidate' => route('staff.collections.merge-queue.reject'),
'managePattern' => route('settings.collections.show', ['collection' => '__COLLECTION__']),
'surfaces' => route('settings.collections.surfaces.index'),
],
'seo' => [
'title' => 'Collection Programming — Skinbase Nova',
'description' => 'Staff programming tools for assignments, previews, eligibility diagnostics, and recommendation refreshes.',
'canonical' => route('staff.collections.programming'),
'robots' => 'noindex,follow',
],
])->rootView('collections');
}
public function storeProgram(CollectionProgramAssignmentRequest $request): JsonResponse
{
$this->authorizeStaff($request);
$assignment = $this->programming->upsertAssignment($request->validated(), $request->user());
return response()->json([
'ok' => true,
'assignment' => $this->mapAssignment($assignment),
]);
}
public function updateProgram(CollectionProgramAssignmentRequest $request, CollectionProgramAssignment $program): JsonResponse
{
$this->authorizeStaff($request);
$payload = $request->validated();
$payload['id'] = (int) $program->id;
$assignment = $this->programming->upsertAssignment($payload, $request->user());
return response()->json([
'ok' => true,
'assignment' => $this->mapAssignment($assignment),
]);
}
public function preview(CollectionProgrammingPreviewRequest $request): JsonResponse
{
$this->authorizeStaff($request);
$payload = $request->validated();
return response()->json([
'ok' => true,
'collections' => $this->collections->mapCollectionCardPayloads(
$this->programming->previewProgram((string) $payload['program_key'], (int) ($payload['limit'] ?? 12)),
true,
),
]);
}
public function refreshEligibility(CollectionProgrammingCollectionRequest $request): JsonResponse
{
$this->authorizeStaff($request);
$collection = $this->resolveCollection($request);
return response()->json([
'ok' => true,
'queued' => true,
'result' => $this->backgroundJobs->dispatchHealthRefresh($collection, $request->user()),
]);
}
public function duplicateScan(CollectionProgrammingCollectionRequest $request): JsonResponse
{
$this->authorizeStaff($request);
$collection = $this->resolveCollection($request);
return response()->json([
'ok' => true,
'queued' => true,
'result' => $this->backgroundJobs->dispatchDuplicateScan($collection, $request->user()),
]);
}
public function refreshRecommendations(CollectionProgrammingCollectionRequest $request): JsonResponse
{
$this->authorizeStaff($request);
$collection = $this->resolveCollection($request);
return response()->json([
'ok' => true,
'queued' => true,
'result' => $this->backgroundJobs->dispatchRecommendationRefresh($collection, $request->user()),
]);
}
public function updateMetadata(CollectionProgrammingMetadataRequest $request): JsonResponse
{
$this->authorizeStaff($request);
$payload = $request->validated();
$collection = Collection::query()->findOrFail((int) $payload['collection_id']);
$result = $this->programming->syncHooks($collection, $payload, $request->user());
return response()->json([
'ok' => true,
'message' => 'Experiment and program governance hooks updated.',
'collection' => $this->collections->mapCollectionCardPayloads([$result['collection']->loadMissing('user')], true)[0],
'diagnostics' => $result['diagnostics'],
]);
}
public function canonicalizeCandidate(CollectionProgrammingMergePairRequest $request): JsonResponse
{
$this->authorizeStaff($request);
[$source, $target] = $this->resolveMergePair($request);
$payload = $this->programming->canonicalizePair($source, $target, $request->user());
return response()->json([
'ok' => true,
'message' => 'Canonical target updated from the staff merge queue.',
'source' => $this->collections->mapCollectionCardPayloads([$payload['source']->loadMissing('user')], true)[0],
'target' => $this->collections->mapCollectionCardPayloads([$payload['target']->loadMissing('user')], true)[0],
'mergeQueue' => $payload['mergeQueue'],
]);
}
public function mergeCandidate(CollectionProgrammingMergePairRequest $request): JsonResponse
{
$this->authorizeStaff($request);
[$source, $target] = $this->resolveMergePair($request);
$payload = $this->programming->mergePair($source, $target, $request->user());
return response()->json([
'ok' => true,
'message' => 'Collections merged from the staff merge queue.',
'source' => $this->collections->mapCollectionCardPayloads([$payload['source']->loadMissing('user')], true)[0],
'target' => $this->collections->mapCollectionCardPayloads([$payload['target']->loadMissing('user')], true)[0],
'attached_artwork_ids' => $payload['attached_artwork_ids'],
'mergeQueue' => $payload['mergeQueue'],
]);
}
public function rejectCandidate(CollectionProgrammingMergePairRequest $request): JsonResponse
{
$this->authorizeStaff($request);
[$source, $target] = $this->resolveMergePair($request);
$payload = $this->programming->rejectPair($source, $target, $request->user());
return response()->json([
'ok' => true,
'message' => 'Duplicate candidate dismissed from the staff merge queue.',
'source' => $this->collections->mapCollectionCardPayloads([$payload['source']->loadMissing('user')], true)[0],
'target' => $this->collections->mapCollectionCardPayloads([$payload['target']->loadMissing('user')], true)[0],
'mergeQueue' => $payload['mergeQueue'],
]);
}
private function resolveCollection(CollectionProgrammingCollectionRequest $request): ?Collection
{
$payload = $request->validated();
if (! isset($payload['collection_id'])) {
return null;
}
return Collection::query()->find((int) $payload['collection_id']);
}
/**
* @return array{0: Collection, 1: Collection}
*/
private function resolveMergePair(CollectionProgrammingMergePairRequest $request): array
{
$payload = $request->validated();
return [
Collection::query()->findOrFail((int) $payload['source_collection_id']),
Collection::query()->findOrFail((int) $payload['target_collection_id']),
];
}
private function mapAssignment(CollectionProgramAssignment $assignment): array
{
$assignment->loadMissing(['collection.user', 'creator']);
return [
'id' => (int) $assignment->id,
'program_key' => (string) $assignment->program_key,
'campaign_key' => $assignment->campaign_key,
'placement_scope' => $assignment->placement_scope,
'starts_at' => optional($assignment->starts_at)?->toISOString(),
'ends_at' => optional($assignment->ends_at)?->toISOString(),
'priority' => (int) $assignment->priority,
'notes' => $assignment->notes,
'collection' => $this->collections->mapCollectionCardPayloads([$assignment->collection], true)[0],
'creator' => $assignment->creator ? [
'id' => (int) $assignment->creator->id,
'username' => (string) $assignment->creator->username,
'name' => $assignment->creator->name,
] : null,
];
}
private function authorizeStaff(Request $request): void
{
$user = $request->user();
abort_unless($user && ($user->isAdmin() || $user->isModerator()), 403);
}
private function isAdmin(Request $request): bool
{
$user = $request->user();
return $user !== null && $user->isAdmin();
}
}

View File

@@ -0,0 +1,459 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Models\Collection;
use App\Models\CollectionSurfaceDefinition;
use App\Models\CollectionSurfacePlacement;
use App\Services\CollectionCampaignService;
use App\Services\CollectionHistoryService;
use App\Services\CollectionService;
use App\Services\CollectionSurfaceService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
use Illuminate\Support\Facades\DB;
use Inertia\Inertia;
use Inertia\Response;
class CollectionSurfaceController extends Controller
{
public function __construct(
private readonly CollectionSurfaceService $surfaces,
private readonly CollectionService $collections,
private readonly CollectionHistoryService $history,
private readonly CollectionCampaignService $campaigns,
) {
}
public function index(Request $request): Response
{
$this->authorizeStaff($request);
$conflicts = $this->surfaces->placementConflicts();
$conflictPlacementIds = $conflicts->pluck('placement_ids')->flatten()->unique()->map(fn ($id) => (int) $id)->all();
$definitions = $this->surfaces->definitions()->map(function ($definition): array {
return $this->mapDefinition($definition);
})->values()->all();
$placements = $this->surfaces->placements()->map(function ($placement) use ($conflictPlacementIds): array {
return array_merge($this->mapPlacement($placement), [
'has_conflict' => in_array((int) $placement->id, $conflictPlacementIds, true),
]);
})->values()->all();
return Inertia::render('Collection/CollectionStaffSurfaces', [
'definitions' => $definitions,
'placements' => $placements,
'conflicts' => $conflicts->all(),
'surfaceKeyOptions' => collect($definitions)->pluck('surface_key')->values()->all(),
'collectionOptions' => $this->collections->mapCollectionCardPayloads(
Collection::query()->public()->orderByDesc('ranking_score')->limit(30)->get(),
true,
),
'endpoints' => [
'definitionsStore' => route('settings.collections.surfaces.definitions.store'),
'definitionsUpdatePattern' => route('settings.collections.surfaces.definitions.update', ['definition' => '__DEFINITION__']),
'definitionsDeletePattern' => route('settings.collections.surfaces.definitions.destroy', ['definition' => '__DEFINITION__']),
'placementsStore' => route('settings.collections.surfaces.placements.store'),
'placementsUpdatePattern' => route('settings.collections.surfaces.placements.update', ['placement' => '__PLACEMENT__']),
'placementsDeletePattern' => route('settings.collections.surfaces.placements.destroy', ['placement' => '__PLACEMENT__']),
'previewPattern' => route('settings.collections.surfaces.preview', ['definition' => '__DEFINITION__']),
'batchEditorial' => route('settings.collections.surfaces.batch-editorial'),
],
'seo' => [
'title' => 'Collection Surfaces - Skinbase Nova',
'description' => 'Staff tools for homepage, discovery, and campaign collection surfaces.',
'canonical' => route('settings.collections.surfaces.index'),
'robots' => 'noindex,follow',
],
])->rootView('collections');
}
public function storeDefinition(Request $request): JsonResponse
{
$this->authorizeStaff($request);
$definition = $this->surfaces->upsertDefinition($this->validateDefinition($request));
return response()->json([
'ok' => true,
'definition' => $this->mapDefinition($definition->fresh()),
]);
}
public function updateDefinition(Request $request, CollectionSurfaceDefinition $definition): JsonResponse
{
$this->authorizeStaff($request);
$payload = $this->validateDefinition($request);
$payload['surface_key'] = $definition->surface_key;
$updatedDefinition = $this->surfaces->upsertDefinition($payload);
return response()->json([
'ok' => true,
'definition' => $this->mapDefinition($updatedDefinition->fresh()),
]);
}
public function destroyDefinition(Request $request, CollectionSurfaceDefinition $definition): JsonResponse
{
$this->authorizeStaff($request);
abort_if(
CollectionSurfacePlacement::query()->where('surface_key', $definition->surface_key)->exists(),
422,
'Remove all placements from this surface before deleting the definition.'
);
$deletedId = (int) $definition->id;
$definition->delete();
return response()->json([
'ok' => true,
'deleted_definition_id' => $deletedId,
]);
}
public function storePlacement(Request $request): JsonResponse
{
$this->authorizeStaff($request);
$payload = $this->validatePlacement($request);
$payload['created_by_user_id'] = $request->user()?->id;
$collection = Collection::query()->findOrFail((int) $payload['collection_id']);
abort_unless($collection->isFeatureablePublicly(), 422, 'Only public, active collections can be placed on public surfaces.');
$placement = $this->surfaces->upsertPlacement($payload)->loadMissing([
'collection.user:id,username,name',
'collection.coverArtwork:id,user_id,title,slug,hash,thumb_ext,published_at,is_public,is_approved,deleted_at',
]);
$this->history->record(
$collection->fresh(),
$request->user(),
'placement_assigned',
'Collection assigned to a staff surface.',
null,
$this->placementHistoryPayload($placement)
);
return response()->json([
'ok' => true,
'placement' => $this->mapPlacement($placement),
'conflicts' => $this->surfaces->placementConflicts()->all(),
]);
}
public function updatePlacement(Request $request, CollectionSurfacePlacement $placement): JsonResponse
{
$this->authorizeStaff($request);
$before = $this->placementHistoryPayload($placement);
$originalCollectionId = (int) $placement->collection_id;
$payload = $this->validatePlacement($request);
$payload['id'] = (int) $placement->id;
$payload['created_by_user_id'] = $placement->created_by_user_id ?: $request->user()?->id;
$collection = Collection::query()->findOrFail((int) $payload['collection_id']);
abort_unless($collection->isFeatureablePublicly(), 422, 'Only public, active collections can be placed on public surfaces.');
$updatedPlacement = $this->surfaces->upsertPlacement($payload)->loadMissing([
'collection.user:id,username,name',
'collection.coverArtwork:id,user_id,title,slug,hash,thumb_ext,published_at,is_public,is_approved,deleted_at',
]);
if ($originalCollectionId !== (int) $updatedPlacement->collection_id) {
$originalCollection = Collection::query()->find($originalCollectionId);
if ($originalCollection) {
$this->history->record(
$originalCollection->fresh(),
$request->user(),
'placement_removed',
'Collection removed from a staff surface assignment.',
$before,
null
);
}
$this->history->record(
$collection->fresh(),
$request->user(),
'placement_assigned',
'Collection assigned to a staff surface.',
null,
$this->placementHistoryPayload($updatedPlacement)
);
} else {
$this->history->record(
$collection->fresh(),
$request->user(),
'placement_updated',
'Collection staff surface assignment updated.',
$before,
$this->placementHistoryPayload($updatedPlacement)
);
}
return response()->json([
'ok' => true,
'placement' => $this->mapPlacement($updatedPlacement),
'conflicts' => $this->surfaces->placementConflicts()->all(),
]);
}
public function destroyPlacement(Request $request, CollectionSurfacePlacement $placement): JsonResponse
{
$this->authorizeStaff($request);
$before = $this->placementHistoryPayload($placement);
$collection = $placement->collection()->first();
$deletedId = (int) $placement->id;
$this->surfaces->deletePlacement($placement);
if ($collection) {
$this->history->record(
$collection->fresh(),
$request->user(),
'placement_removed',
'Collection removed from a staff surface assignment.',
$before,
null
);
}
return response()->json([
'ok' => true,
'deleted_placement_id' => $deletedId,
'conflicts' => $this->surfaces->placementConflicts()->all(),
]);
}
public function preview(Request $request, CollectionSurfaceDefinition $definition): JsonResponse
{
$this->authorizeStaff($request);
$items = $this->surfaces->resolveSurfaceItems(
$definition->surface_key,
(int) $request->integer('limit', (int) $definition->max_items)
);
return response()->json([
'ok' => true,
'collections' => $this->collections->mapCollectionCardPayloads($items, true),
]);
}
public function batchEditorial(Request $request): JsonResponse
{
$this->authorizeStaff($request);
$payload = $this->validateBatchEditorial($request);
$collectionIds = collect($payload['collection_ids'] ?? [])->map(fn ($id) => (int) $id)->filter()->values()->all();
abort_if(count($collectionIds) === 0, 422, 'Choose at least one collection for the batch editorial run.');
if (! ($payload['apply'] ?? false)) {
return response()->json([
'ok' => true,
'mode' => 'preview',
'plan' => $this->campaigns->batchEditorialPlan($collectionIds, $payload),
]);
}
$result = DB::transaction(function () use ($collectionIds, $payload, $request): array {
$actor = $request->user();
$applied = $this->campaigns->applyBatchEditorialPlan($collectionIds, $payload, $actor);
$resultsByCollection = collect($applied['results'] ?? [])->keyBy('collection_id');
foreach ($applied['plan']['items'] as $item) {
$collectionId = (int) Arr::get($item, 'collection.id');
$collection = Collection::query()->find($collectionId);
$itemResult = $resultsByCollection->get($collectionId, []);
if (! $collection) {
continue;
}
$summaryParts = [];
if (count($item['campaign_updates'] ?? []) > 0) {
$summaryParts[] = 'campaign metadata refreshed';
}
if (is_array($item['placement'] ?? null)) {
$summaryParts[] = ($item['placement']['eligible'] ?? false)
? sprintf('placement planned for %s', (string) $item['placement']['surface_key'])
: 'placement skipped';
}
if (($itemResult['placement']['status'] ?? null) === 'created') {
$this->history->record(
$collection->fresh(),
$actor,
'placement_assigned',
'Collection assigned to a staff surface via batch editorial tools.',
null,
$item['placement'] ?? null
);
}
if (($itemResult['placement']['status'] ?? null) === 'updated') {
$this->history->record(
$collection->fresh(),
$actor,
'placement_updated',
'Collection staff surface assignment updated via batch editorial tools.',
null,
$item['placement'] ?? null
);
}
$this->history->record(
$collection->fresh(),
$actor,
'batch_editorial_updated',
'Staff batch editorial tools updated campaign planning.',
null,
[
'summary' => $summaryParts,
'campaign_updates' => $item['campaign_updates'] ?? [],
'placement' => $item['placement'] ?? null,
]
);
}
return $applied;
});
return response()->json([
'ok' => true,
'mode' => 'apply',
'plan' => $result['plan'],
'results' => $result['results'],
'placements' => $this->surfaces->placements()->map(fn ($placement): array => $this->mapPlacement($placement))->values()->all(),
'conflicts' => $this->surfaces->placementConflicts()->all(),
]);
}
private function authorizeStaff(Request $request): void
{
$user = $request->user();
abort_unless($user && ($user->isAdmin() || $user->isModerator()), 403);
}
private function validateDefinition(Request $request): array
{
return $request->validate([
'surface_key' => ['required', 'string', 'max:120'],
'title' => ['required', 'string', 'max:160'],
'description' => ['nullable', 'string', 'max:400'],
'mode' => ['required', 'in:manual,automatic,hybrid'],
'ranking_mode' => ['required', 'in:ranking_score,recent_activity,quality_score'],
'max_items' => ['nullable', 'integer', 'min:1', 'max:24'],
'is_active' => ['nullable', 'boolean'],
'starts_at' => ['nullable', 'date'],
'ends_at' => ['nullable', 'date', 'after:starts_at'],
'fallback_surface_key' => ['nullable', 'string', 'max:120', 'different:surface_key'],
'rules_json' => ['nullable', 'array'],
]);
}
private function validatePlacement(Request $request): array
{
return $request->validate([
'id' => ['nullable', 'integer', 'exists:collection_surface_placements,id'],
'surface_key' => ['required', 'string', 'max:120'],
'collection_id' => ['required', 'integer', 'exists:collections,id'],
'placement_type' => ['required', 'in:manual,campaign,scheduled_override'],
'priority' => ['nullable', 'integer', 'min:-100', 'max:100'],
'starts_at' => ['nullable', 'date'],
'ends_at' => ['nullable', 'date', 'after:starts_at'],
'is_active' => ['nullable', 'boolean'],
'campaign_key' => ['nullable', 'string', 'max:80'],
'notes' => ['nullable', 'string', 'max:1000'],
]);
}
private function validateBatchEditorial(Request $request): array
{
return $request->validate([
'collection_ids' => ['required', 'array', 'min:1', 'max:24'],
'collection_ids.*' => ['integer', 'distinct', 'exists:collections,id'],
'campaign_key' => ['nullable', 'string', 'max:80'],
'campaign_label' => ['nullable', 'string', 'max:120'],
'event_key' => ['nullable', 'string', 'max:80'],
'event_label' => ['nullable', 'string', 'max:120'],
'season_key' => ['nullable', 'string', 'max:80'],
'banner_text' => ['nullable', 'string', 'max:160'],
'badge_label' => ['nullable', 'string', 'max:80'],
'spotlight_style' => ['nullable', 'string', 'max:60'],
'editorial_notes' => ['nullable', 'string', 'max:4000'],
'surface_key' => ['nullable', 'string', 'max:120'],
'placement_type' => ['nullable', 'string', 'in:manual,campaign,scheduled_override'],
'priority' => ['nullable', 'integer', 'min:-100', 'max:100'],
'starts_at' => ['nullable', 'date'],
'ends_at' => ['nullable', 'date', 'after_or_equal:starts_at'],
'is_active' => ['nullable', 'boolean'],
'notes' => ['nullable', 'string', 'max:1000'],
'apply' => ['nullable', 'boolean'],
]);
}
private function mapDefinition(CollectionSurfaceDefinition $definition): array
{
return [
'id' => (int) $definition->id,
'surface_key' => $definition->surface_key,
'title' => $definition->title,
'description' => $definition->description,
'mode' => $definition->mode,
'ranking_mode' => $definition->ranking_mode,
'max_items' => (int) $definition->max_items,
'is_active' => (bool) $definition->is_active,
'starts_at' => $definition->starts_at?->toISOString(),
'ends_at' => $definition->ends_at?->toISOString(),
'fallback_surface_key' => $definition->fallback_surface_key,
'rules_json' => $definition->rules_json,
];
}
private function mapPlacement(CollectionSurfacePlacement $placement): array
{
return [
'id' => (int) $placement->id,
'surface_key' => $placement->surface_key,
'placement_type' => $placement->placement_type,
'priority' => (int) $placement->priority,
'starts_at' => $placement->starts_at?->toISOString(),
'ends_at' => $placement->ends_at?->toISOString(),
'is_active' => (bool) $placement->is_active,
'campaign_key' => $placement->campaign_key,
'notes' => $placement->notes,
'collection' => $placement->collection
? ($this->collections->mapCollectionCardPayloads(collect([$placement->collection]), true)[0] ?? null)
: null,
];
}
private function placementHistoryPayload(CollectionSurfacePlacement $placement): array
{
return [
'placement_id' => (int) $placement->id,
'surface_key' => (string) $placement->surface_key,
'collection_id' => (int) $placement->collection_id,
'placement_type' => (string) $placement->placement_type,
'priority' => (int) $placement->priority,
'starts_at' => $placement->starts_at?->toISOString(),
'ends_at' => $placement->ends_at?->toISOString(),
'is_active' => (bool) $placement->is_active,
'campaign_key' => $placement->campaign_key,
'notes' => $placement->notes,
];
}
}

View File

@@ -0,0 +1,215 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Models\ArtworkFeature;
use App\Services\FeaturedArtworkAdminService;
use Carbon\Carbon;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Schema;
use Illuminate\Validation\Rule;
use Illuminate\Validation\ValidationException;
use Inertia\Inertia;
use Inertia\Response;
class FeaturedArtworkAdminController extends Controller
{
public function __construct(private readonly FeaturedArtworkAdminService $featuredArtworks)
{
}
public function index(): Response
{
return Inertia::render('Collection/FeaturedArtworksAdmin', array_merge(
$this->featuredArtworks->pageProps(),
[
'endpoints' => [
'search' => route('admin.cp.artworks.featured.search'),
'store' => route('admin.cp.artworks.featured.store'),
'updatePattern' => route('admin.cp.artworks.featured.update', ['feature' => '__FEATURE__']),
'togglePattern' => route('admin.cp.artworks.featured.toggle', ['feature' => '__FEATURE__']),
'forceHeroPattern' => route('admin.cp.artworks.featured.force-hero', ['feature' => '__FEATURE__']),
'destroyPattern' => route('admin.cp.artworks.featured.delete', ['feature' => '__FEATURE__']),
],
'capabilities' => [
'forceHeroEnabled' => $this->hasForceHeroColumn(),
],
'seo' => [
'title' => 'Featured Artworks — Skinbase Nova',
'description' => 'Editorial controls for homepage featured artworks and the current hero winner.',
'canonical' => route('admin.cp.artworks.featured.main'),
'robots' => 'noindex,follow',
],
],
))->rootView('collections');
}
public function search(Request $request): JsonResponse
{
$validated = $request->validate([
'q' => ['required', 'string', 'min:1', 'max:120'],
]);
return response()->json([
'ok' => true,
'results' => $this->featuredArtworks->searchArtworks((string) $validated['q']),
]);
}
public function store(Request $request): JsonResponse
{
$validated = $this->validateStore($request);
$actor = $this->currentActor($request);
ArtworkFeature::query()->create([
'artwork_id' => (int) $validated['artwork_id'],
'priority' => (int) $validated['priority'],
'featured_at' => Carbon::parse((string) $validated['featured_at']),
'expires_at' => filled($validated['expires_at'] ?? null) ? Carbon::parse((string) $validated['expires_at']) : null,
'is_active' => (bool) $validated['is_active'],
'created_by' => (int) $actor->id,
]);
return $this->mutationResponse('Featured artwork added.');
}
public function update(Request $request, ArtworkFeature $feature): JsonResponse
{
$validated = $this->validateUpdate($request);
$this->ensureStateAvailable($feature, (bool) $validated['is_active']);
$feature->fill([
'priority' => (int) $validated['priority'],
'featured_at' => Carbon::parse((string) $validated['featured_at']),
'expires_at' => filled($validated['expires_at'] ?? null) ? Carbon::parse((string) $validated['expires_at']) : null,
'is_active' => (bool) $validated['is_active'],
]);
$feature->save();
return $this->mutationResponse('Featured artwork updated.');
}
public function toggle(ArtworkFeature $feature): JsonResponse
{
$nextState = ! (bool) $feature->is_active;
$this->ensureStateAvailable($feature, $nextState);
$feature->forceFill([
'is_active' => $nextState,
])->save();
return $this->mutationResponse($nextState ? 'Featured artwork activated.' : 'Featured artwork deactivated.');
}
public function toggleForceHero(ArtworkFeature $feature): JsonResponse
{
$this->ensureForceHeroAvailable();
$nextState = ! (bool) $feature->force_hero;
DB::transaction(function () use ($feature, $nextState): void {
if ($nextState) {
ArtworkFeature::query()
->where('force_hero', true)
->whereNull('deleted_at')
->whereKeyNot($feature->id)
->update(['force_hero' => false]);
}
$feature->forceFill([
'force_hero' => $nextState,
])->save();
});
return $this->mutationResponse($nextState ? 'Force hero enabled.' : 'Force hero disabled.');
}
public function destroy(ArtworkFeature $feature): JsonResponse
{
$feature->delete();
return $this->mutationResponse('Featured artwork entry deleted.');
}
/**
* @return array<string, mixed>
*/
private function validateStore(Request $request): array
{
return $request->validate([
'artwork_id' => [
'required',
'integer',
Rule::exists('artworks', 'id'),
Rule::unique('artwork_features', 'artwork_id')->where(fn ($query) => $query->whereNull('deleted_at')),
],
'priority' => ['required', 'integer', 'min:0', 'max:65535'],
'featured_at' => ['required', 'date'],
'expires_at' => ['nullable', 'date', 'after:featured_at'],
'is_active' => ['required', 'boolean'],
], [
'artwork_id.unique' => 'This artwork already has a featured entry. Edit the existing row instead.',
]);
}
/**
* @return array<string, mixed>
*/
private function validateUpdate(Request $request): array
{
return $request->validate([
'priority' => ['required', 'integer', 'min:0', 'max:65535'],
'featured_at' => ['required', 'date'],
'expires_at' => ['nullable', 'date', 'after:featured_at'],
'is_active' => ['required', 'boolean'],
]);
}
private function ensureStateAvailable(ArtworkFeature $feature, bool $isActive): void
{
$conflictExists = ArtworkFeature::query()
->where('artwork_id', $feature->artwork_id)
->where('is_active', $isActive)
->whereNull('deleted_at')
->whereKeyNot($feature->id)
->exists();
if ($conflictExists) {
throw ValidationException::withMessages([
'is_active' => 'Another featured entry for this artwork already uses that active state.',
]);
}
}
private function mutationResponse(string $message): JsonResponse
{
return response()->json(array_merge([
'ok' => true,
'message' => $message,
], $this->featuredArtworks->pageProps()));
}
private function currentActor(Request $request): object
{
return $request->user('controlpanel') ?? $request->user() ?? abort(403, 'Admin access required.');
}
private function ensureForceHeroAvailable(): void
{
if (! $this->hasForceHeroColumn()) {
throw ValidationException::withMessages([
'force_hero' => 'Run php artisan migrate to enable force hero controls.',
]);
}
}
private function hasForceHeroColumn(): bool
{
return Schema::hasColumn('artwork_features', 'force_hero');
}
}

View File

@@ -0,0 +1,545 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Settings;
use App\Http\Controllers\Controller;
use App\Http\Requests\NovaCards\AdminStoreNovaCardAssetPackRequest;
use App\Http\Requests\NovaCards\AdminStoreNovaCardCategoryRequest;
use App\Http\Requests\NovaCards\AdminStoreNovaCardChallengeRequest;
use App\Http\Requests\NovaCards\AdminStoreNovaCardTemplateRequest;
use App\Http\Requests\NovaCards\AdminUpdateNovaCardRequest;
use App\Models\NovaCardAssetPack;
use App\Models\NovaCard;
use App\Models\NovaCardCategory;
use App\Models\NovaCardChallenge;
use App\Models\NovaCardCollection;
use App\Models\Report;
use App\Models\NovaCardTemplate;
use App\Models\User;
use App\Services\NovaCards\NovaCardCollectionService;
use App\Services\NovaCards\NovaCardPublishModerationService;
use App\Services\NovaCards\NovaCardPresenter;
use App\Support\Moderation\ReportTargetResolver;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Inertia\Inertia;
use Inertia\Response;
class NovaCardAdminController extends Controller
{
public function __construct(
private readonly NovaCardPresenter $presenter,
private readonly ReportTargetResolver $reportTargets,
private readonly NovaCardCollectionService $collections,
private readonly NovaCardPublishModerationService $moderation,
) {}
public function index(Request $request): Response
{
$cards = NovaCard::query()
->with(['user.profile', 'category', 'template', 'backgroundImage', 'tags'])
->latest('updated_at')
->paginate(24)
->withQueryString();
$featuredCreators = User::query()
->whereHas('novaCards', fn ($query) => $query->publiclyVisible())
->withCount([
'novaCards as public_cards_count' => fn ($query) => $query->publiclyVisible(),
'novaCards as featured_cards_count' => fn ($query) => $query->publiclyVisible()->where('featured', true),
])
->withSum([
'novaCards as total_views_count' => fn ($query) => $query->publiclyVisible(),
], 'views_count')
->orderByDesc('nova_featured_creator')
->orderByDesc('featured_cards_count')
->orderByDesc('public_cards_count')
->orderBy('username')
->limit(8)
->get();
$reportCounts = Report::query()
->selectRaw('status, COUNT(*) as aggregate')
->whereIn('target_type', $this->reportTargets->novaCardTargetTypes())
->groupBy('status')
->pluck('aggregate', 'status');
return Inertia::render('Collection/NovaCardsAdminIndex', [
'cards' => $this->presenter->paginator($cards, false, $request->user()),
'featuredCreators' => $featuredCreators->map(fn (User $creator): array => [
'id' => (int) $creator->id,
'username' => (string) $creator->username,
'name' => $creator->name,
'display_name' => $creator->name ?: '@' . $creator->username,
'public_url' => route('cards.creator', ['username' => $creator->username]),
'nova_featured_creator' => (bool) $creator->nova_featured_creator,
'public_cards_count' => (int) ($creator->public_cards_count ?? 0),
'featured_cards_count' => (int) ($creator->featured_cards_count ?? 0),
'total_views_count' => (int) ($creator->total_views_count ?? 0),
])->values()->all(),
'categories' => NovaCardCategory::query()->orderBy('order_num')->orderBy('name')->get()->map(fn (NovaCardCategory $category): array => [
'id' => (int) $category->id,
'slug' => (string) $category->slug,
'name' => (string) $category->name,
'description' => $category->description,
'active' => (bool) $category->active,
'order_num' => (int) $category->order_num,
'cards_count' => (int) $category->cards()->count(),
])->values()->all(),
'stats' => [
'pending' => NovaCard::query()->where('moderation_status', NovaCard::MOD_PENDING)->count(),
'flagged' => NovaCard::query()->where('moderation_status', NovaCard::MOD_FLAGGED)->count(),
'featured' => NovaCard::query()->where('featured', true)->count(),
'published' => NovaCard::query()->where('status', NovaCard::STATUS_PUBLISHED)->count(),
'remixable' => NovaCard::query()->where('allow_remix', true)->count(),
'challenges' => NovaCardChallenge::query()->count(),
],
'reportingQueue' => [
'enabled' => true,
'pending' => (int) ($reportCounts['open'] ?? 0),
'label' => 'Nova Cards report queue',
'description' => 'Review open, investigating, and resolved reports for cards, challenge prompts, and challenge entries.',
'statuses' => [
'open' => (int) ($reportCounts['open'] ?? 0),
'reviewing' => (int) ($reportCounts['reviewing'] ?? 0),
'closed' => (int) ($reportCounts['closed'] ?? 0),
],
],
'endpoints' => [
'updateCardPattern' => route('cp.cards.update', ['card' => '__CARD__']),
'updateCreatorPattern' => route('cp.cards.creators.update', ['user' => '__CREATOR__']),
'templates' => route('cp.cards.templates.index'),
'assetPacks' => route('cp.cards.asset-packs.index'),
'challenges' => route('cp.cards.challenges.index'),
'collections' => route('cp.cards.collections.index'),
'storeCategory' => route('cp.cards.categories.store'),
'updateCategoryPattern' => route('cp.cards.categories.update', ['category' => '__CATEGORY__']),
'reportsQueue' => route('api.admin.reports.queue', ['group' => 'nova_cards']),
'updateReportPattern' => route('api.admin.reports.update', ['report' => '__REPORT__']),
'moderateReportTargetPattern' => route('api.admin.reports.moderate-target', ['report' => '__REPORT__']),
],
'moderationDispositionOptions' => [
NovaCard::MOD_PENDING => $this->moderation->dispositionOptions(NovaCard::MOD_PENDING),
NovaCard::MOD_APPROVED => $this->moderation->dispositionOptions(NovaCard::MOD_APPROVED),
NovaCard::MOD_FLAGGED => $this->moderation->dispositionOptions(NovaCard::MOD_FLAGGED),
NovaCard::MOD_REJECTED => $this->moderation->dispositionOptions(NovaCard::MOD_REJECTED),
],
'editorOptions' => $this->presenter->options(),
])->rootView('collections');
}
public function templates(Request $request): Response
{
return Inertia::render('Collection/NovaCardsTemplateAdmin', [
'templates' => NovaCardTemplate::query()->orderBy('order_num')->orderBy('name')->get()->map(fn (NovaCardTemplate $template): array => [
'id' => (int) $template->id,
'slug' => (string) $template->slug,
'name' => (string) $template->name,
'description' => $template->description,
'preview_image' => $template->preview_image,
'config_json' => $template->config_json,
'supported_formats' => $template->supported_formats,
'active' => (bool) $template->active,
'official' => (bool) $template->official,
'order_num' => (int) $template->order_num,
])->values()->all(),
'editorOptions' => $this->presenter->options(),
'endpoints' => [
'store' => route('cp.cards.templates.store'),
'updatePattern' => route('cp.cards.templates.update', ['template' => '__TEMPLATE__']),
'cards' => route('cp.cards.index'),
],
])->rootView('collections');
}
public function assetPacks(Request $request): Response
{
return Inertia::render('Collection/NovaCardsAssetPackAdmin', [
'packs' => NovaCardAssetPack::query()->orderBy('type')->orderBy('order_num')->orderBy('name')->get()->map(fn (NovaCardAssetPack $pack): array => [
'id' => (int) $pack->id,
'slug' => (string) $pack->slug,
'name' => (string) $pack->name,
'description' => $pack->description,
'type' => (string) $pack->type,
'preview_image' => $pack->preview_image,
'manifest_json' => $pack->manifest_json,
'official' => (bool) $pack->official,
'active' => (bool) $pack->active,
'order_num' => (int) $pack->order_num,
])->values()->all(),
'endpoints' => [
'store' => route('cp.cards.asset-packs.store'),
'updatePattern' => route('cp.cards.asset-packs.update', ['assetPack' => '__PACK__']),
'cards' => route('cp.cards.index'),
],
])->rootView('collections');
}
public function challenges(Request $request): Response
{
return Inertia::render('Collection/NovaCardsChallengeAdmin', [
'challenges' => NovaCardChallenge::query()->with('winnerCard')->orderByDesc('featured')->orderByDesc('starts_at')->get()->map(fn (NovaCardChallenge $challenge): array => [
'id' => (int) $challenge->id,
'slug' => (string) $challenge->slug,
'title' => (string) $challenge->title,
'description' => $challenge->description,
'prompt' => $challenge->prompt,
'rules_json' => $challenge->rules_json,
'status' => (string) $challenge->status,
'official' => (bool) $challenge->official,
'featured' => (bool) $challenge->featured,
'winner_card_id' => $challenge->winner_card_id ? (int) $challenge->winner_card_id : null,
'entries_count' => (int) $challenge->entries_count,
'starts_at' => optional($challenge->starts_at)?->format('Y-m-d\TH:i'),
'ends_at' => optional($challenge->ends_at)?->format('Y-m-d\TH:i'),
])->values()->all(),
'cards' => NovaCard::query()->published()->latest('published_at')->limit(100)->get()->map(fn (NovaCard $card): array => [
'id' => (int) $card->id,
'title' => (string) $card->title,
])->values()->all(),
'endpoints' => [
'store' => route('cp.cards.challenges.store'),
'updatePattern' => route('cp.cards.challenges.update', ['challenge' => '__CHALLENGE__']),
'cards' => route('cp.cards.index'),
],
])->rootView('collections');
}
public function collections(Request $request): Response
{
return Inertia::render('Collection/NovaCardsCollectionAdmin', [
'collections' => NovaCardCollection::query()
->with(['user', 'items.card.user.profile', 'items.card.category', 'items.card.template', 'items.card.backgroundImage', 'items.card.tags'])
->orderByDesc('featured')
->orderByDesc('official')
->orderByDesc('updated_at')
->get()
->map(fn (NovaCardCollection $collection): array => $this->presenter->collection($collection, $request->user(), true))
->values()
->all(),
'cards' => NovaCard::query()
->published()
->latest('published_at')
->limit(200)
->get()
->map(fn (NovaCard $card): array => [
'id' => (int) $card->id,
'title' => (string) $card->title,
'slug' => (string) $card->slug,
'creator' => $card->user?->username,
])
->values()
->all(),
'admins' => \App\Models\User::query()
->whereIn('role', ['admin', 'moderator'])
->orderBy('username')
->limit(50)
->get(['id', 'username', 'name'])
->map(fn ($user): array => [
'id' => (int) $user->id,
'username' => (string) $user->username,
'name' => $user->name,
])
->values()
->all(),
'endpoints' => [
'store' => route('cp.cards.collections.store'),
'updatePattern' => route('cp.cards.collections.update', ['collection' => '__COLLECTION__']),
'attachCardPattern' => route('cp.cards.collections.cards.store', ['collection' => '__COLLECTION__']),
'detachCardPattern' => route('cp.cards.collections.cards.destroy', ['collection' => '__COLLECTION__', 'card' => '__CARD__']),
'cards' => route('cp.cards.index'),
],
])->rootView('collections');
}
public function storeTemplate(AdminStoreNovaCardTemplateRequest $request): JsonResponse
{
$template = NovaCardTemplate::query()->create($request->validated());
return response()->json([
'template' => [
'id' => (int) $template->id,
'slug' => (string) $template->slug,
'name' => (string) $template->name,
'description' => $template->description,
'preview_image' => $template->preview_image,
'config_json' => $template->config_json,
'supported_formats' => $template->supported_formats,
'active' => (bool) $template->active,
'official' => (bool) $template->official,
'order_num' => (int) $template->order_num,
],
]);
}
public function updateTemplate(AdminStoreNovaCardTemplateRequest $request, NovaCardTemplate $template): JsonResponse
{
$template->update($request->validated());
return response()->json([
'template' => [
'id' => (int) $template->id,
'slug' => (string) $template->slug,
'name' => (string) $template->name,
'description' => $template->description,
'preview_image' => $template->preview_image,
'config_json' => $template->config_json,
'supported_formats' => $template->supported_formats,
'active' => (bool) $template->active,
'official' => (bool) $template->official,
'order_num' => (int) $template->order_num,
],
]);
}
public function storeAssetPack(AdminStoreNovaCardAssetPackRequest $request): JsonResponse
{
$pack = NovaCardAssetPack::query()->create($request->validated());
return response()->json([
'pack' => [
'id' => (int) $pack->id,
'slug' => (string) $pack->slug,
'name' => (string) $pack->name,
'description' => $pack->description,
'type' => (string) $pack->type,
'preview_image' => $pack->preview_image,
'manifest_json' => $pack->manifest_json,
'official' => (bool) $pack->official,
'active' => (bool) $pack->active,
'order_num' => (int) $pack->order_num,
],
]);
}
public function updateAssetPack(AdminStoreNovaCardAssetPackRequest $request, NovaCardAssetPack $assetPack): JsonResponse
{
$assetPack->update($request->validated());
return response()->json([
'pack' => [
'id' => (int) $assetPack->id,
'slug' => (string) $assetPack->slug,
'name' => (string) $assetPack->name,
'description' => $assetPack->description,
'type' => (string) $assetPack->type,
'preview_image' => $assetPack->preview_image,
'manifest_json' => $assetPack->manifest_json,
'official' => (bool) $assetPack->official,
'active' => (bool) $assetPack->active,
'order_num' => (int) $assetPack->order_num,
],
]);
}
public function storeChallenge(AdminStoreNovaCardChallengeRequest $request): JsonResponse
{
$challenge = NovaCardChallenge::query()->create($request->validated() + [
'user_id' => $request->user()->id,
]);
return response()->json([
'challenge' => [
'id' => (int) $challenge->id,
'slug' => (string) $challenge->slug,
'title' => (string) $challenge->title,
'description' => $challenge->description,
'prompt' => $challenge->prompt,
'rules_json' => $challenge->rules_json,
'status' => (string) $challenge->status,
'official' => (bool) $challenge->official,
'featured' => (bool) $challenge->featured,
'winner_card_id' => $challenge->winner_card_id ? (int) $challenge->winner_card_id : null,
'entries_count' => (int) $challenge->entries_count,
'starts_at' => optional($challenge->starts_at)?->format('Y-m-d\TH:i'),
'ends_at' => optional($challenge->ends_at)?->format('Y-m-d\TH:i'),
],
]);
}
public function updateChallenge(AdminStoreNovaCardChallengeRequest $request, NovaCardChallenge $challenge): JsonResponse
{
$challenge->update($request->validated());
return response()->json([
'challenge' => [
'id' => (int) $challenge->id,
'slug' => (string) $challenge->slug,
'title' => (string) $challenge->title,
'description' => $challenge->description,
'prompt' => $challenge->prompt,
'rules_json' => $challenge->rules_json,
'status' => (string) $challenge->status,
'official' => (bool) $challenge->official,
'featured' => (bool) $challenge->featured,
'winner_card_id' => $challenge->winner_card_id ? (int) $challenge->winner_card_id : null,
'entries_count' => (int) $challenge->entries_count,
'starts_at' => optional($challenge->starts_at)?->format('Y-m-d\TH:i'),
'ends_at' => optional($challenge->ends_at)?->format('Y-m-d\TH:i'),
],
]);
}
public function storeCategory(AdminStoreNovaCardCategoryRequest $request): JsonResponse
{
$category = NovaCardCategory::query()->create($request->validated());
return response()->json([
'category' => [
'id' => (int) $category->id,
'slug' => (string) $category->slug,
'name' => (string) $category->name,
'description' => $category->description,
'active' => (bool) $category->active,
'order_num' => (int) $category->order_num,
],
]);
}
public function updateCategory(AdminStoreNovaCardCategoryRequest $request, NovaCardCategory $category): JsonResponse
{
$category->update($request->validated());
return response()->json([
'category' => [
'id' => (int) $category->id,
'slug' => (string) $category->slug,
'name' => (string) $category->name,
'description' => $category->description,
'active' => (bool) $category->active,
'order_num' => (int) $category->order_num,
],
]);
}
public function storeCollection(Request $request): JsonResponse
{
$payload = $request->validate([
'user_id' => ['required', 'integer', 'exists:users,id'],
'slug' => ['nullable', 'string', 'max:140'],
'name' => ['required', 'string', 'min:2', 'max:120'],
'description' => ['nullable', 'string', 'max:1000'],
'visibility' => ['required', 'in:private,public'],
'official' => ['nullable', 'boolean'],
'featured' => ['nullable', 'boolean'],
]);
$collection = $this->collections->createManagedCollection($payload);
return response()->json([
'collection' => $this->presenter->collection($collection->fresh(['user', 'items.card.user.profile', 'items.card.category', 'items.card.template', 'items.card.backgroundImage', 'items.card.tags']), $request->user(), true),
]);
}
public function updateCollection(Request $request, NovaCardCollection $collection): JsonResponse
{
$payload = $request->validate([
'user_id' => ['required', 'integer', 'exists:users,id'],
'slug' => ['required', 'string', 'max:140'],
'name' => ['required', 'string', 'min:2', 'max:120'],
'description' => ['nullable', 'string', 'max:1000'],
'visibility' => ['required', 'in:private,public'],
'official' => ['nullable', 'boolean'],
'featured' => ['nullable', 'boolean'],
]);
$collection->update([
'user_id' => (int) $payload['user_id'],
'slug' => $payload['slug'],
'name' => $payload['name'],
'description' => $payload['description'] ?? null,
'visibility' => $payload['visibility'],
'official' => (bool) ($payload['official'] ?? false),
'featured' => (bool) ($payload['featured'] ?? false),
]);
return response()->json([
'collection' => $this->presenter->collection($collection->fresh(['user', 'items.card.user.profile', 'items.card.category', 'items.card.template', 'items.card.backgroundImage', 'items.card.tags']), $request->user(), true),
]);
}
public function storeCollectionCard(Request $request, NovaCardCollection $collection): JsonResponse
{
$payload = $request->validate([
'card_id' => ['required', 'integer', 'exists:nova_cards,id'],
'note' => ['nullable', 'string', 'max:1000'],
]);
$card = NovaCard::query()->findOrFail((int) $payload['card_id']);
$this->collections->addCardToCollection($collection, $card, $payload['note'] ?? null);
return response()->json([
'collection' => $this->presenter->collection($collection->fresh(['user', 'items.card.user.profile', 'items.card.category', 'items.card.template', 'items.card.backgroundImage', 'items.card.tags']), $request->user(), true),
]);
}
public function destroyCollectionCard(Request $request, NovaCardCollection $collection, NovaCard $card): JsonResponse
{
$this->collections->removeCardFromCollection($collection, $card);
return response()->json([
'collection' => $this->presenter->collection($collection->fresh(['user', 'items.card.user.profile', 'items.card.category', 'items.card.template', 'items.card.backgroundImage', 'items.card.tags']), $request->user(), true),
]);
}
public function updateCard(AdminUpdateNovaCardRequest $request, NovaCard $card): JsonResponse
{
$attributes = $request->validated();
$requestedDisposition = $attributes['disposition'] ?? null;
$hasModerationChange = array_key_exists('moderation_status', $attributes)
&& $attributes['moderation_status'] !== $card->moderation_status;
$hasDispositionChange = array_key_exists('disposition', $attributes)
&& $requestedDisposition !== (($this->moderation->latestOverride($card) ?? [])['disposition'] ?? null);
if (isset($attributes['featured']) && (! isset($attributes['status']) || $attributes['status'] !== NovaCard::STATUS_PUBLISHED)) {
$attributes['featured'] = (bool) $attributes['featured'] && $card->status === NovaCard::STATUS_PUBLISHED;
}
unset($attributes['disposition']);
$card->update($attributes);
if ($hasModerationChange || $hasDispositionChange) {
$card = $this->moderation->recordStaffOverride(
$card->fresh(),
(string) ($attributes['moderation_status'] ?? $card->moderation_status),
$request->user(),
'admin_card_update',
[
'disposition' => $requestedDisposition,
],
);
}
return response()->json([
'card' => $this->presenter->card($card->fresh()->loadMissing(['user.profile', 'category', 'template', 'backgroundImage', 'tags']), false, $request->user()),
]);
}
public function updateCreator(Request $request, User $user): JsonResponse
{
$attributes = $request->validate([
'nova_featured_creator' => ['required', 'boolean'],
]);
$user->update($attributes);
$publicCardsCount = $user->novaCards()->publiclyVisible()->count();
$featuredCardsCount = $user->novaCards()->publiclyVisible()->where('featured', true)->count();
$totalViewsCount = (int) ($user->novaCards()->publiclyVisible()->sum('views_count') ?? 0);
return response()->json([
'creator' => [
'id' => (int) $user->id,
'username' => (string) $user->username,
'name' => $user->name,
'display_name' => $user->name ?: '@' . $user->username,
'public_url' => route('cards.creator', ['username' => $user->username]),
'nova_featured_creator' => (bool) $user->nova_featured_creator,
'public_cards_count' => $publicCardsCount,
'featured_cards_count' => $featuredCardsCount,
'total_views_count' => $totalViewsCount,
],
]);
}
}