Розробка системи версіонування контенту сайту

Розробка системи версионування контенту сайту

Система версионування зберігає історію змін кожної сторінки або записи. Редактор може порівняти версії, відновити попередню або повернутися до конкретної точки. Захищає від випадкової втрати контенту та дозволяє аудитувати зміни.

Варіанти реалізації

Event Sourcing — зберігати лише diff між версіями. Економія місця, але відновлення версії вимагає відтворення ланцюга змін.

Full snapshots — зберігати повний снимок кожної версії. Простіше в реалізації, займає більше місця, миттєве відновлення.

Гібрид — повний снимок кожні N версій, diff між ними.

Для більшості CMS — full snapshots: обсяг тексту невеликий, простота важливіша за економію.

Модель даних

content_versions (
  id, content_type, content_id,
  version_number,
  content (jsonb),     -- повний снимок даних
  title, excerpt,      -- для швидкого показу в списку версій
  changed_fields (jsonb), -- ['title', 'body'] — що саме змінилось
  change_summary,      -- 'Виправлена опечатка у заголовку'
  is_autosave,         -- автозбереження vs ручне збереження
  created_by, created_at
)

Автозбереження

// Автозбереження кожні 30 секунд при змінах
const { isDirty, formData } = useFormState();

useEffect(() => {
    if (!isDirty) return;

    const timer = setTimeout(async () => {
        await saveDraft(formData);
        setLastSaved(new Date());
    }, 30000);

    return () => clearTimeout(timer);
}, [formData, isDirty]);

Створення версії при збереженні

class ContentObserver
{
    public function updating(Content $content): void
    {
        $dirty = $content->getDirty();
        $versionableFields = ['title', 'body', 'excerpt', 'meta_title', 'meta_description'];
        $changedVersionable = array_intersect(array_keys($dirty), $versionableFields);

        if (empty($changedVersionable)) return;

        // Ліміт версій: зберігати не більше 50, видаляти старі автозбереження
        ContentVersion::where('content_type', get_class($content))
            ->where('content_id', $content->id)
            ->where('is_autosave', true)
            ->orderBy('created_at', 'desc')
            ->skip(10)  -- залишити 10 останніх автозбережень
            ->get()
            ->each->delete();

        ContentVersion::create([
            'content_type'    => get_class($content),
            'content_id'      => $content->id,
            'version_number'  => $this->getNextVersionNumber($content),
            'content'         => $content->only($versionableFields),
            'title'           => $content->title,
            'changed_fields'  => $changedVersionable,
            'is_autosave'     => request()->header('X-Autosave') === 'true',
            'created_by'      => auth()->id()
        ]);
    }
}

Diff між версіями

use cogpowered\FineDiff\Diff;
use cogpowered\FineDiff\Granularity\Word;

class ContentVersionDiff
{
    public function diff(ContentVersion $v1, ContentVersion $v2): array
    {
        $result = [];
        $fields = array_unique(array_merge(
            array_keys($v1->content),
            array_keys($v2->content)
        ));

        foreach ($fields as $field) {
            $old = $v1->content[$field] ?? '';
            $new = $v2->content[$field] ?? '';

            if ($old !== $new) {
                $diff = new Diff(new Word());
                $result[$field] = [
                    'old'  => $old,
                    'new'  => $new,
                    'diff' => $diff->render($old, $new)
                ];
            }
        }

        return $result;
    }
}

Відновлення версії

public function restore(Content $content, ContentVersion $version): void
{
    DB::transaction(function () use ($content, $version) {
        // Зберегти поточну як версію перед відновленням
        event(new ContentBeforeRestore($content));

        $content->update($version->content);
        $content->recordActivity('version_restored', [
            'restored_version' => $version->version_number
        ]);
    });
}

Інтерфейс історії версій

Бічна панель або окрема сторінка:

• Список версій: номер, дата, автор, змінені поля, тип (ручне/автозбереження)
• Клік по версії → попередній перегляд змісту
• Порівняння двох версій: вибрати "базову" та "порівнювану", переглад diff
• Кнопка "Відновити" з підтвердженням

Термін розробки: 2–4 тижні для повної системи з diff, автозбереженням та інтерфейсом порівняння версій.