Модуль Suggestions: коллективный разум на страже качества контента

Как это работает с точки зрения пользователя

1. Вы видите пост с неточными тегами.
2. Нажимаете «Предложить правку».
3. Выбираете новые теги (или предлагаете новый заголовок, описание).
4. Система создаёт «предложение» и показывает его другим.
5. Если 3 человека (кворум) предложили точно такую же правку — изменения применяются автоматически.
6. Либо модератор может одобрить/отклонить предложение мгновенно.

Всё прозрачно: история изменений видна всем, лог действий модераторов — тоже.

Ключевые сущности

В модуле три основные сущности:

┌─────────────────┐         ┌─────────────────┐
│   Suggestion    │         │   ContentLog    │
│  (предложение)  │         │   (лог изменений)│
└────────┬────────┘         └────────┬────────┘
         │                           │
         │         ┌─────────┐       │
         └────────▶│  Story  │◀──────┘
                   │ (пост)  │
                   └─────────┘

• Suggestion — само предложение: кто, что, к какому контенту.
• ContentLog — история всех применённых изменений.
• Story / Comment — целевой контент.

Жизненный цикл предложения

Пользователь создаёт предложение
            │
            ▼
   ┌────────────────────┐
   │ Это модератор?     │
   └─────────┬──────────┘
             │
     ┌───────┴────────┐
     │                │
    ДА               НЕТ
     │                │
     ▼                ▼
applyChanges()   checkAndApplyQuorum()
     │                │
     │                ▼
     │        ┌───────────────────┐
     │        │ Совпадений >= 3?  │
     │        └─────────┬─────────┘
     │                  │
     │          ┌───────┴───────┐
     │         ДА              НЕТ
     │          │               │
     │          ▼               ▼
     │   applyChanges()    Ждём дальше
     │          │
     ▼          ▼
   Лог в ContentLog
   Удаление всех предложений
   для этого контента

1. ContentLog — история изменений контента

Каждое применённое предложение оставляет след:

$this->contentLogModel->create([
    'target_type' => $targetType,
    'target_id' => $targetId,
    'actor_id' => $actorId,
    'action_text' => $logText,
    // is_community_action: 0 = модератор, 1 = сообщество
    'is_community_action' => $isModeratorAction ? 0 : 1
]);

Любой пользователь может посмотреть, как менялся пост с течением времени.

2. audit_logs — лог действий модераторов

Когда модератор одобряет или отклоняет предложение, это записывается в общий аудит-лог:

private function logModeratorAction(
    int $moderatorId,
    string $action,
    array $suggestion,
    string $reason = ''
): void {
    $modLog = new \App\Modules\Moderations\Models\Moderation();
    $modLog->create([
        'user_id'     => $moderatorId,
        'username'    => $moderator['username'],
        'role'        => $moderator['role'],
        'ip_address'  => $ipAddress,
        'action'      => 'moderation.' . $action,
        'description' => $reason ?: "Модератор {$action} предложение #{$suggestion['id']}",
        'category'    => 'moderation',
        'payload'     => json_encode([
            'target_type' => strtolower($suggestion['target_type']),
            'target_id'   => (int) $suggestion['target_id'],
            'suggestion_id' => (int) $suggestion['id'],
        ], JSON_UNESCAPED_UNICODE),
    ]);
}

Это критически важно для доверия. В сообществах, где модерация закрыта, быстро зреет недовольство. Когда каждый видит, кто, что и почему сделал — доверие растёт.

1. Доверие к сообществу

Lobsters построен на доверии. Пригласительная система означает, что каждый участник рекомендован кем-то из существующих. И Suggestions расширяет это доверие: мы верим, что сообщество способно само улучшать контент.

2. Распределённая ответственность

Модераторы — не «надзиратели», а такие же участники, просто с дополнительными правами. Когда кворум из трёх пользователей сам применяет правки, модераторы освобождаются для действительно сложных случаев.

3. Прозрачность как принцип

Каждое изменение — в логе. Каждое действие модератора — в аудите. Нет «чёрных ящиков», нет «решений за закрытыми дверями». Это редкость в современных платформах.

4. Фокус на качестве, а не на количестве

Кворум в 3 человека — это не мало и не много. Это ровно столько, чтобы случайные правки не применялись, но консенсусные — да. Система отфильтровывает шум, оставляя сигнал.

1. Нормализация данных для сравнения

Если вы сравниваете «одинаковость» предложений — нормализуйте их. Сортируйте ключи, сортируйте массивы. Иначе ['php', 'sql'] и ['sql', 'php'] будут считаться разными.

2. Разделение «быстрых» и «медленных» путей

Модератор → мгновенное применение. Сообщество → ждём кворум. Это гибкость: система работает и в «ручном», и в «автоматическом» режиме.

3. Валидация на всех уровнях

Предложение проходит те же проверки, что и обычная правка. Нельзя обойти правила, «предложив» что-то запрещённое.

4. Логи — это не overhead, а фича

Прозрачные логи — это то, что отличает сообщество от платформы. Пользователи видят, что система честна.