Перейти к содержанию

Синхронизация юридических текстов (SPA ↔ docs)

Два канала публикации

Канал Аудитория Путь
SPA Пользователи сайта /legal/:slug, контент в frontend/src/content/legal/
MkDocs Разработчики, контрибьютеры docs/legal/*.md, сборка в site/

Тексты должны совпадать по смыслу. Юридически значимая публикация для пользователя — SPA; docs — для команды и ревью.

Процедура изменения

  1. Отредактировать русский модуль: frontend/src/content/legal/ru/<slug>.js.
  2. При необходимости — английский: frontend/src/content/legal/en/<slug>.js.
  3. Скопировать содержание разделов в docs/legal/<соответствующий>.md (заменить {{operatorName}} на «Команда проекта Konstructorium» или актуальное из env).
  4. Обновить version / effectiveDate в обоих местах.
  5. Обновить VITE_LEGAL_DOCUMENT_VERSION в frontend/.env.example и ENV_FILES.md.
  6. Прогнать npm test (legal content) и mkdocs build --strict.

Соответствие slug ↔ файлов

slug JS (ru) docs/legal
privacy ru/privacy.js privacy-policy.md
cookies ru/cookies.js cookie-policy.md
terms ru/terms.js terms-of-use.md
offer ru/offer.js public-offer.md
seller-terms ru/seller-terms.js seller-rules.md
content-license ru/content-license.js content-license.md
imprint ru/imprint.js imprint.md

Автоматизация (не реализована)

Генерация markdown из JS или наоборот возможна скриптом, но сейчас ручная синхронизация — чтобы ревьюер видел diff в обоих каналах.