Разработка Workflow-системы публикации контента (черновик → модерация → публикация)

Разработка Workflow-системы публикации контента (черновик → модерация → публикация)

Workflow контента — система управления жизненным циклом публикаций. Вместо прямой публикации любым пользователем — настроенный процесс: черновик → редактура → модерация → публикация → архивирование. Критична для изданий, корпоративных блогов и платформ с пользовательским контентом.

Статусы и переходы

draft → review → approved → published → archived
  ↑                ↓
  └── rejected ←───┘
  └── revision_needed ←───── (частичный возврат)

content_states (
  id, content_type, content_id,
  status: draft | review | approved | published | rejected | archived | scheduled,
  assigned_to (editor/moderator id),
  comment,          -- комментарий при отклонении
  scheduled_at,     -- дата публикации для scheduled
  published_at, archived_at,
  transitioned_by, transitioned_at
)

content_state_history (
  id, content_type, content_id,
  from_status, to_status,
  changed_by, comment, changed_at
)

Определение разрешённых переходов

class ContentWorkflow
{
    private array $transitions = [
        'draft'    => ['review'],
        'review'   => ['approved', 'rejected', 'revision_needed'],
        'approved' => ['published', 'scheduled'],
        'rejected' => ['draft'],
        'revision_needed' => ['draft'],
        'published'=> ['archived', 'draft'],  // вернуть в черновик = депубликация
        'scheduled'=> ['published', 'draft']
    ];

    private array $permissions = [
        'draft → review'    => 'content.submit_for_review',
        'review → approved' => 'content.approve',
        'review → rejected' => 'content.approve',
        'approved → published' => 'content.publish'
    ];

    public function canTransition(User $user, Content $content, string $toStatus): bool
    {
        $fromStatus = $content->status;
        if (!in_array($toStatus, $this->transitions[$fromStatus] ?? [])) {
            return false;
        }

        $permKey = "{$fromStatus} → {$toStatus}";
        if (isset($this->permissions[$permKey])) {
            return $user->can($this->permissions[$permKey]);
        }

        return true;
    }

    public function transition(Content $content, string $toStatus, User $actor, ?string $comment = null): void
    {
        if (!$this->canTransition($actor, $content, $toStatus)) {
            throw new WorkflowException("Переход {$content->status} → {$toStatus} недоступен");
        }

        DB::transaction(function () use ($content, $toStatus, $actor, $comment) {
            ContentStateHistory::create([
                'content_type' => get_class($content),
                'content_id'   => $content->id,
                'from_status'  => $content->status,
                'to_status'    => $toStatus,
                'changed_by'   => $actor->id,
                'comment'      => $comment
            ]);

            $content->update([
                'status'       => $toStatus,
                'published_at' => $toStatus === 'published' ? now() : $content->published_at
            ]);

            event(new ContentStatusChanged($content, $toStatus, $actor, $comment));
        });
    }
}

Назначение рецензентов

// При отправке на ревью — автоназначение свободного редактора
class AssignReviewer
{
    public function assign(Content $content): User
    {
        $reviewer = User::where('role', 'editor')
            ->withCount(['assignedContent' => fn($q) => $q->where('status', 'review')])
            ->orderBy('assigned_content_count')  // наименее загруженный
            ->first();

        $content->update(['assigned_to' => $reviewer->id]);
        $reviewer->notify(new ContentAssignedForReview($content));

        return $reviewer;
    }
}

Дедлайны и напоминания

// Scheduled job: найти контент, ожидающий ревью более X часов
$overdue = Content::where('status', 'review')
    ->where('submitted_for_review_at', '<', now()->subHours(24))
    ->get();

foreach ($overdue as $content) {
    $content->assignedEditor?->notify(new ReviewOverdueNotification($content));
    Notification::sendToRole('chief_editor', new EscalationNotification($content));
}

Запланированная публикация

class PublishScheduledContent implements ShouldQueue
{
    public function handle(): void
    {
        Content::where('status', 'scheduled')
            ->where('scheduled_at', '<=', now())
            ->each(function (Content $content) {
                app(ContentWorkflow::class)->transition(
                    $content, 'published', User::find($content->created_by)
                );
            });
    }
}

Задача запускается каждые 5 минут через планировщик.

Интерфейс редакционной панели

Колонки по статусам (Kanban-подобный вид) или список с фильтрами. Для каждой записи:

• Текущий статус и ответственный
• Кнопки доступных переходов (зависят от роли)
• Комментарии модератора
• История изменений статуса

Срок разработки: 3–5 недель для полной workflow-системы с ролями, назначением, дедлайнами и историей.