<?php

declare(strict_types=1);

namespace Amuzcorp\Nexia\Workshop\Descriptors;

use Amuzcorp\Nexia\Workshop\Enums\NoteStatus;
use Nexia\AppDescriptors\AppDescriptorSet;
use Nexia\AppDescriptors\Contracts\AppDescriptorContribution;
use Nexia\AppDescriptors\ProcessWorkActionDescriptor;

final class WorkshopProcessActions implements AppDescriptorContribution
{
    public const ARCHIVE_NOTE = 'note.archive';

    public static function appDescriptors(): AppDescriptorSet
    {
        return AppDescriptorSet::of(
            new ProcessWorkActionDescriptor(
                kind: 'serviceTask',
                appKey: 'workshop',
                actionKey: self::ARCHIVE_NOTE,
                labelKey: 'workshop.process_actions.note.archive.label',
                topic: 'workshop.note.archive',
                outputContract: [
                    'note_public_id' => ['type' => 'string'],
                    'status' => [
                        'type' => 'string',
                        'enum' => NoteStatus::values(),
                    ],
                ],
            ),
        );
    }
}1234567891011121314151617181920212223242526272829303132333435

<?php

declare(strict_types=1);

namespace Amuzcorp\Nexia\Workshop\Process;

use Amuzcorp\Nexia\Workshop\Enums\NoteStatus;
use Amuzcorp\Nexia\Workshop\Models\Note;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Gate;
use Nexia\Process\Contracts\ProcessWorkActionHandler;
use Nexia\Process\Domain\ProcessWorkActionException;
use Nexia\Process\ProcessWorkActionInvocation;
use Nexia\Process\ProcessWorkActionResult;

final readonly class ArchiveNoteProcessWorkActionHandler implements ProcessWorkActionHandler
{
    public function handle(ProcessWorkActionInvocation $invocation): ProcessWorkActionResult
    {
        if ($invocation->resourceRef->appKey !== 'workshop'
            || $invocation->resourceRef->resourceKey !== 'workshop.note') {
            throw new ProcessWorkActionException(
                'The Process instance is not anchored to a Workshop note.',
                'workshop_note_resource_mismatch',
            );
        }

        return DB::transaction(function () use ($invocation): ProcessWorkActionResult {
            $note = Note::query()
                ->where('public_id', $invocation->resourceRef->resourceId)
                ->where('legal_entity_id', $invocation->legalEntity->key())
                ->lockForUpdate()
                ->first();

            if (! $note instanceof Note) {
                throw new ProcessWorkActionException(
                    'The Workshop note is not available in this Legal Entity.',
                    'workshop_note_unavailable',
                );
            }

            Gate::forUser($invocation->actor)->authorize('archive', $note);

            if ($note->status !== NoteStatus::Archived) {
                $note->forceFill(['status' => NoteStatus::Archived])->save();
            }

            return new ProcessWorkActionResult(output: [
                'note_public_id' => (string) $note->public_id,
                'status' => NoteStatus::Archived->value,
            ]);
        });
    }
}123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354

<?php

declare(strict_types=1);

use Amuzcorp\Nexia\Workshop\Descriptors\WorkshopProcessActions;
use Nexia\AppDescriptors\ProcessWorkActionDescriptor;
use Nexia\Process\Contracts\ProcessWorkActionRegistrar;
use Nexia\Testing\ProcessWorkActionConformance;

test('every Workshop Process service task has a registered handler', function (): void {
    ProcessWorkActionConformance::assert(
        'workshop',
        WorkshopProcessActions::appDescriptors()->ofType(ProcessWorkActionDescriptor::class),
        app(ProcessWorkActionRegistrar::class),
    );
});12345678910111213141516

#!/usr/bin/env sh
set -eu

for required in \
  packages/workshop/src/Descriptors/WorkshopProcessActions.php \
  packages/workshop/src/Process/ArchiveNoteProcessWorkActionHandler.php \
  packages/workshop/tests/Feature/WorkshopProcessWorkActionTest.php
do
  test -f "$required" || {
    printf 'Missing Workshop Process source: %s\n' "$required" >&2
    exit 1
  }
done

grep -Fq 'WorkshopProcessActions::ARCHIVE_NOTE' \
  packages/workshop/src/WorkshopServiceProvider.php || {
    printf '%s\n' 'WorkshopServiceProvider has not registered the Process work-action handler.' >&2
    exit 1
  }

grep -Fq 'function archive' packages/workshop/src/Policies/NotePolicy.php || {
  printf '%s\n' 'NotePolicy does not authorize the archive business action.' >&2
  exit 1
}

task artisan -- nexia-runtime:refresh-runtime-caches --if-route-cached --no-ansi
task artisan -- nexia-apps:validate-app-descriptors workshop --no-ansi
task artisan -- nexia-apps:doctor-package-app workshop --no-ansi
task test -- packages/workshop/tests/Feature/WorkshopProcessWorkActionTest.php --compact

printf '%s\n' 'Workshop Business Process work action is catalogued and paired with a registered handler.'12345678910111213141516171819202122232425262728293031