klevze/SkinbaseNova
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

Build world campaigns rewards and recaps

Browse Source
This commit is contained in:
Gregor Klevže
2026-05-01 11:44:41 +02:00
parent 28e7e46e13
commit 257b0dbef6
100 changed files with 11300 additions and 367 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
app/Http/Controllers/Api/WorldAnalyticsEventController.php Normal file
View File

@@ -0,0 +1,43 @@
<?php
declare(strict_types=1);
namespace App\Http\Controllers\Api;
use App\Http\Controllers\Controller;
use App\Services\Worlds\WorldAnalyticsService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
final class WorldAnalyticsEventController extends Controller
{
public function __construct(
private readonly WorldAnalyticsService $analytics,
) {
}
public function store(Request $request): JsonResponse
{
$payload = $request->validate([
'world_id' => ['required', 'integer', 'exists:worlds,id'],
'event_type' => ['required', 'string', Rule::in($this->analytics->allowedEventTypes())],
'section_key' => ['sometimes', 'nullable', 'string', 'max:80'],
'cta_key' => ['sometimes', 'nullable', 'string', 'max:80'],
'entity_type' => ['sometimes', 'nullable', 'string', 'max:40'],
'entity_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
'entity_title' => ['sometimes', 'nullable', 'string', 'max:180'],
'challenge_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
'source_surface' => ['sometimes', 'nullable', 'string', Rule::in($this->analytics->allowedSourceSurfaces())],
'source_detail' => ['sometimes', 'nullable', 'string', 'max:80'],
'visitor_token' => ['sometimes', 'nullable', 'string', 'max:100'],
'meta' => ['sometimes', 'array'],
]);
$this->analytics->recordEvent($request, $payload);
return response()->json([
'ok' => true,
], 202);
}
}

3
app/Http/Controllers/GroupChallengeController.php
View File

@@ -10,6 +10,7 @@ use App\Models\Group;
use App\Models\GroupChallenge;
use App\Services\GroupChallengeService;
use App\Services\GroupService;
use App\Services\Worlds\WorldService;
use App\Support\Seo\SeoFactory;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
@@ -22,6 +23,7 @@ class GroupChallengeController extends Controller
public function __construct(
private readonly GroupService $groups,
private readonly GroupChallengeService $challenges,
private readonly WorldService $worlds,
) {
}
@@ -56,6 +58,7 @@ class GroupChallengeController extends Controller
return Inertia::render('Group/GroupChallengeShow', [
'group' => $groupPayload,
'challenge' => $challengePayload,
'linkedWorld' => $this->worlds->linkedWorldForChallenge($challenge),
'seo' => $seo,
])->rootView('collections');
}

3
app/Http/Controllers/Studio/GroupChallengeStudioController.php
View File

@@ -11,6 +11,7 @@ use App\Http\Requests\Groups\UpdateGroupChallengeRequest;
use App\Models\Artwork;
use App\Models\Group;
use App\Models\GroupChallenge;
use App\Models\GroupChallengeOutcome;
use App\Services\GroupChallengeService;
use App\Services\GroupService;
use Illuminate\Http\RedirectResponse;
@@ -53,6 +54,7 @@ class GroupChallengeStudioController extends Controller
'visibilityOptions' => collect((array) config('groups.challenges.visibility_options', []))->map(fn (string $value): array => ['value' => $value, 'label' => ucfirst($value)])->values()->all(),
'participationScopeOptions' => collect((array) config('groups.challenges.participation_scopes', []))->map(fn (string $value): array => ['value' => $value, 'label' => ucwords(str_replace('_', ' ', $value))])->values()->all(),
'judgingModeOptions' => collect((array) config('groups.challenges.judging_modes', []))->map(fn (string $value): array => ['value' => $value, 'label' => ucwords(str_replace('_', ' ', $value))])->values()->all(),
'outcomeTypeOptions' => collect(GroupChallengeOutcome::supportedTypes())->map(fn (string $value): array => ['value' => $value, 'label' => GroupChallengeOutcome::labelForType($value)])->values()->all(),
'collectionOptions' => $group->collections()->orderBy('title')->get(['id', 'title'])->map(fn ($collection): array => ['id' => (int) $collection->id, 'title' => $collection->title])->values()->all(),
'projectOptions' => $group->projects()->orderBy('title')->get(['id', 'title'])->map(fn ($project): array => ['id' => (int) $project->id, 'title' => $project->title])->values()->all(),
'artworkOptions' => $group->artworks()->whereNull('deleted_at')->latest('updated_at')->limit(30)->get(['id', 'title'])->map(fn ($artwork): array => ['id' => (int) $artwork->id, 'title' => $artwork->title])->values()->all(),
@@ -84,6 +86,7 @@ class GroupChallengeStudioController extends Controller
'visibilityOptions' => collect((array) config('groups.challenges.visibility_options', []))->map(fn (string $value): array => ['value' => $value, 'label' => ucfirst($value)])->values()->all(),
'participationScopeOptions' => collect((array) config('groups.challenges.participation_scopes', []))->map(fn (string $value): array => ['value' => $value, 'label' => ucwords(str_replace('_', ' ', $value))])->values()->all(),
'judgingModeOptions' => collect((array) config('groups.challenges.judging_modes', []))->map(fn (string $value): array => ['value' => $value, 'label' => ucwords(str_replace('_', ' ', $value))])->values()->all(),
'outcomeTypeOptions' => collect(GroupChallengeOutcome::supportedTypes())->map(fn (string $value): array => ['value' => $value, 'label' => GroupChallengeOutcome::labelForType($value)])->values()->all(),
'collectionOptions' => $group->collections()->orderBy('title')->get(['id', 'title'])->map(fn ($collection): array => ['id' => (int) $collection->id, 'title' => $collection->title])->values()->all(),
'projectOptions' => $group->projects()->orderBy('title')->get(['id', 'title'])->map(fn ($project): array => ['id' => (int) $project->id, 'title' => $project->title])->values()->all(),
'artworkOptions' => $group->artworks()->whereNull('deleted_at')->latest('updated_at')->limit(30)->get(['id', 'title'])->map(fn ($artwork): array => ['id' => (int) $artwork->id, 'title' => $artwork->title])->values()->all(),

192
app/Http/Controllers/Studio/StudioWorldController.php
View File

@@ -4,11 +4,15 @@ declare(strict_types=1);
namespace App\Http\Controllers\Studio;
use App\Enums\WorldRewardType;
use App\Http\Controllers\Controller;
use App\Http\Requests\Worlds\StoreWorldRequest;
use App\Http\Requests\Worlds\UpdateWorldRequest;
use App\Models\World;
use App\Models\WorldSubmission;
use App\Services\Worlds\WorldAnalyticsService;
use App\Services\Worlds\WorldEditorialSuggestionService;
use App\Services\Worlds\WorldRewardService;
use App\Services\Worlds\WorldService;
use App\Services\Worlds\WorldSubmissionService;
use App\Support\Seo\SeoFactory;
@@ -22,7 +26,10 @@ final class StudioWorldController extends Controller
{
public function __construct(
private readonly WorldService $worlds,
private readonly WorldEditorialSuggestionService $editorialSuggestions,
private readonly WorldSubmissionService $submissions,
private readonly WorldRewardService $rewards,
private readonly WorldAnalyticsService $analytics,
)
{
}
@@ -35,6 +42,7 @@ final class StudioWorldController extends Controller
'title' => 'Worlds',
'description' => 'Create and manage seasonal, event, and campaign destinations across Skinbase Nova.',
'listing' => $this->worlds->studioListing($request->only(['q', 'status', 'type', 'per_page'])),
'analytics' => $this->analytics->portfolioReport(),
'statusOptions' => [
['value' => World::STATUS_DRAFT, 'label' => 'Draft'],
['value' => World::STATUS_PUBLISHED, 'label' => 'Published'],
@@ -76,6 +84,8 @@ final class StudioWorldController extends Controller
],
'storeUrl' => route('studio.worlds.store'),
'entitySearchUrl' => route('studio.worlds.entity-search'),
'suggestions' => null,
'suggestionActions' => null,
'duplicateActions' => null,
'mediaSupport' => [
'picker_available' => false,
@@ -123,12 +133,23 @@ final class StudioWorldController extends Controller
'updateUrl' => route('studio.worlds.update', ['world' => $world]),
'previewUrl' => route('studio.worlds.preview', ['world' => $world]),
'publishUrl' => route('studio.worlds.publish', ['world' => $world]),
'publishRecapUrl' => route('studio.worlds.recap.publish', ['world' => $world]),
'archiveUrl' => route('studio.worlds.archive', ['world' => $world]),
'entitySearchUrl' => route('studio.worlds.entity-search'),
'suggestions' => $this->editorialSuggestions->editorPayload($world, $request->user()),
'suggestionActions' => [
'add' => route('studio.worlds.suggestions.add', ['world' => $world]),
'pin' => route('studio.worlds.suggestions.pin', ['world' => $world]),
'dismiss' => route('studio.worlds.suggestions.dismiss', ['world' => $world]),
'notRelevant' => route('studio.worlds.suggestions.not-relevant', ['world' => $world]),
'restore' => route('studio.worlds.suggestions.restore', ['world' => $world]),
],
'duplicateActions' => [
'duplicateUrl' => route('studio.worlds.duplicate', ['world' => $world]),
'newEditionUrl' => route('studio.worlds.new-edition', ['world' => $world]),
'canCreateEdition' => $this->worlds->canCreateNewEdition($world),
'duplicateModeOptions' => $this->worlds->duplicateModeOptions(false),
'newEditionModeOptions' => $this->worlds->duplicateModeOptions(true),
],
'mediaSupport' => [
'picker_available' => false,
@@ -169,12 +190,33 @@ final class StudioWorldController extends Controller
return back()->with('success', 'World archived.');
}
public function publishRecap(Request $request, World $world): RedirectResponse
{
$this->authorize('update', $world);
$this->worlds->publishRecap($world);
return back()->with('success', 'World recap published.');
}
public function duplicate(Request $request, World $world): RedirectResponse
{
$this->authorize('create', World::class);
$this->authorize('update', $world);
$duplicate = $this->worlds->duplicate($world, $request->user(), false);
$validated = $request->validate([
'copy_mode' => ['nullable', 'string', 'in:' . implode(',', [
WorldService::COPY_MODE_STRUCTURE_ONLY,
WorldService::COPY_MODE_WITH_RELATIONS,
])],
]);
$duplicate = $this->worlds->duplicateWithMode(
$world,
$request->user(),
false,
(string) ($validated['copy_mode'] ?? WorldService::COPY_MODE_WITH_RELATIONS),
);
return redirect()->route('studio.worlds.edit', ['world' => $duplicate])->with('success', 'World duplicated into a new draft.');
}
@@ -184,7 +226,19 @@ final class StudioWorldController extends Controller
$this->authorize('create', World::class);
$this->authorize('update', $world);
$edition = $this->worlds->duplicate($world, $request->user(), true);
$validated = $request->validate([
'copy_mode' => ['nullable', 'string', 'in:' . implode(',', [
WorldService::COPY_MODE_STRUCTURE_ONLY,
WorldService::COPY_MODE_WITH_RELATIONS,
])],
]);
$edition = $this->worlds->duplicateWithMode(
$world,
$request->user(),
true,
(string) ($validated['copy_mode'] ?? WorldService::COPY_MODE_WITH_RELATIONS),
);
return redirect()->route('studio.worlds.edit', ['world' => $edition])->with('success', 'Next edition draft created.');
}
@@ -203,6 +257,106 @@ final class StudioWorldController extends Controller
]);
}
public function addSuggestion(Request $request, World $world): JsonResponse
{
$this->authorize('update', $world);
$validated = $request->validate([
'related_type' => ['required', 'string'],
'related_id' => ['required', 'integer', 'min:1'],
'section_key' => ['required', 'string'],
'is_featured' => ['nullable', 'boolean'],
]);
return response()->json(
$this->editorialSuggestions->addSuggestionToSection(
$world,
$request->user(),
(string) $validated['related_type'],
(int) $validated['related_id'],
(string) $validated['section_key'],
(bool) ($validated['is_featured'] ?? false),
)
);
}
public function pinSuggestion(Request $request, World $world): JsonResponse
{
$this->authorize('update', $world);
$validated = $request->validate([
'related_type' => ['required', 'string'],
'related_id' => ['required', 'integer', 'min:1'],
'section_key' => ['nullable', 'string'],
]);
return response()->json(
$this->editorialSuggestions->pinSuggestion(
$world,
$request->user(),
(string) $validated['related_type'],
(int) $validated['related_id'],
(string) ($validated['section_key'] ?? ''),
)
);
}
public function dismissSuggestion(Request $request, World $world): JsonResponse
{
$this->authorize('update', $world);
$validated = $request->validate([
'related_type' => ['required', 'string'],
'related_id' => ['required', 'integer', 'min:1'],
]);
return response()->json(
$this->editorialSuggestions->dismissSuggestion(
$world,
$request->user(),
(string) $validated['related_type'],
(int) $validated['related_id'],
)
);
}
public function markSuggestionNotRelevant(Request $request, World $world): JsonResponse
{
$this->authorize('update', $world);
$validated = $request->validate([
'related_type' => ['required', 'string'],
'related_id' => ['required', 'integer', 'min:1'],
]);
return response()->json(
$this->editorialSuggestions->markSuggestionNotRelevant(
$world,
$request->user(),
(string) $validated['related_type'],
(int) $validated['related_id'],
)
);
}
public function restoreSuggestion(Request $request, World $world): JsonResponse
{
$this->authorize('update', $world);
$validated = $request->validate([
'related_type' => ['required', 'string'],
'related_id' => ['required', 'integer', 'min:1'],
]);
return response()->json(
$this->editorialSuggestions->restoreSuggestion(
$world,
(string) $validated['related_type'],
(int) $validated['related_id'],
)
);
}
public function approveSubmission(Request $request, World $world, WorldSubmission $submission): RedirectResponse
{
return $this->transitionSubmission($request, $world, $submission, WorldSubmission::STATUS_LIVE, 'Submission approved and is now live.');
@@ -243,11 +397,43 @@ final class StudioWorldController extends Controller
return $this->transitionSubmission($request, $world, $submission, WorldSubmission::STATUS_PENDING, 'Submission returned to pending.');
}
public function grantSubmissionReward(Request $request, World $world, WorldSubmission $submission, string $rewardType): RedirectResponse
{
$this->authorize('update', $world);
abort_unless((int) $submission->world_id === (int) $world->id, 404);
$reward = WorldRewardType::tryFrom($rewardType);
abort_if($reward === null || $reward->isAutomatic(), 404);
$validated = $request->validate([
'review_note' => ['nullable', 'string', 'max:1000'],
]);
$this->rewards->grantManualReward($submission, $request->user(), $reward, (string) ($validated['review_note'] ?? ''));
return back()->with('success', $reward->label() . ' reward granted.');
}
public function revokeSubmissionReward(Request $request, World $world, WorldSubmission $submission, string $rewardType): RedirectResponse
{
$this->authorize('update', $world);
abort_unless((int) $submission->world_id === (int) $world->id, 404);
$reward = WorldRewardType::tryFrom($rewardType);
abort_if($reward === null || $reward->isAutomatic(), 404);
$this->rewards->revokeManualReward($submission, $reward);
return back()->with('success', $reward->label() . ' reward revoked.');
}
public function preview(Request $request, World $world): \Inertia\Response
{
$this->authorize('update', $world);
$payload = $this->worlds->publicShowPayload($world, $request->user());
$payload = $this->worlds->publicShowPayload($world, $request->user(), true);
$seo = app(SeoFactory::class)->collectionPage(
$world->seo_title ?: ($world->title . ' — Skinbase Nova Preview'),
$world->seo_description ?: ($world->summary ?: $world->description ?: 'Preview world page'),