VkusVill_KZ-Landings

Стандарты работы над лендингами

Дата создания: 2026-01-09
Последнее обновление: 2026-01-09

---

📋 Процесс создания лендинга

Обязательная последовательность действий:

1. Запрос типа лендинга (ПЕРВЫЙ ВОПРОС)

Когда пользователь просит создать лендинг и предоставляет путь к файлу, ПЕРВЫМ вопросом должен быть:

“Какого типа лендинг нужно создать?”

• В наличии - лендинг с остатками товаров и проверкой доступности
• Под заказ - лендинг для товаров под заказ (без остатков)

Важно: Не начинать проверку файла до получения ответа на этот вопрос!

---

2. Запрос названия клиента (ВТОРОЙ ВОПРОС)

После получения ответа о типе лендинга, ВТОРЫМ вопросом должен быть:

“Введите название клиента для кого делаем лендинг?”

Особенности:

• Для типа “В наличии” - название клиента ОБЯЗАТЕЛЬНО
• Для типа “Под заказ” - название клиента ОБЯЗАТЕЛЬНО
• Если название клиента не указано при запуске генератора, он должен запросить его автоматически

Важно: Не начинать проверку файла до получения названия клиента!

---

3. Проверка файла на соответствие стандарту (ТРЕТИЙ ШАГ)

Только после получения ответов на оба вопроса:

1. Тип лендинга
2. Название клиента

Можно приступать к проверке файла на соответствие стандарту.

Действия:

• Прочитать файл Excel
• Проверить структуру против стандарта (EXCEL_STANDARD.md)
• Валидировать с помощью функции validate_excel_structure()

Результаты проверки:

✅ Если файл соответствует стандарту:

• Начать генерацию лендинга
• Использовать указанный тип лендинга
• Использовать указанное название клиента

❌ Если файл НЕ соответствует стандарту:

• НЕ начинать генерацию
• Указать пользователю конкретные ошибки
• Объяснить, как нужно скорректировать файл
• Предоставить ссылку на стандарт: EXCEL_STANDARD.md

---

📋 Пример диалога

Пользователь: "Давай создадим лендинг по файлу /path/to/file.xlsx"

AI: "Какого типа лендинг нужно создать? В наличии или Под заказ?"

Пользователь: "В наличии"

AI: "Введите название клиента для кого делаем лендинг?"

Пользователь: "Dokovil"

AI: "📖 Проверяю файл на соответствие стандарту..."

[Проверка файла]

✅ Файл соответствует стандарту
🎨 Генерирую лендинг "В Наличии" для клиента "Dokovil"...

Или в случае ошибки:

AI: "❌ Файл не соответствует стандарту"

Ошибки:
- Отсутствует обязательная колонка "Остаток" (столбец M, индекс 12)
- Не найдена колонка "Категория" (ожидается столбец B, индекс 1)

📋 СТАНДАРТ ФАЙЛА:
   Документация: Workspace/VkusVill_KZ/Landings/landings/EXCEL_STANDARD.md

💡 Рекомендация: 
1. Добавьте колонку "Остаток" в столбец M
2. Убедитесь, что колонка "Категория" находится в столбце B
3. Исправьте файл и попробуйте снова

---

🎯 Типы лендингов

1. В Наличии (--type в-наличии)

• Описание: Лендинг с остатками товаров и проверкой доступности
• Требования:
  • Обязательная колонка “Остаток” (столбец M, индекс 12)
  • Проверка остатков при добавлении в корзину
  • Отображение остатков в карточке товара
  • Отображение доступного товара в корзине
• Заголовок:
  • H1: Название клиента
  • Под заголовком: “В наличии на [дата]” (дата генерируется автоматически)

2. Под заказ (--type под-заказ)

• Описание: Лендинг для товаров под заказ (без остатков)
• Требования:
  • Колонка “Остаток” НЕ требуется
  • Нет проверки остатков
  • Нет отображения остатков
• Заголовок:
  • H1: Название клиента
  • Под заголовком: “Под заказ [дата]” (дата генерируется автоматически)

---

📋 Стандарт Excel-файла

Документация: Workspace/VkusVill_KZ/Landings/landings/EXCEL_STANDARD.md

Обязательные колонки (для всех типов):

• A (0): Артикул ✅ Обязательно
• B (1): Категория ✅ Обязательно
• D (3): Наименование ✅ Обязательно

Для типа “В Наличии”:

• M (12): Остаток ✅ Обязательно

Для типа “Под заказ”:

• M (12): Остаток ❌ Не требуется

---

🔧 Технические детали

Функция валидации:

validate_excel_structure(df, landing_type='обычный')

Параметры:

• df - DataFrame с данными Excel
• landing_type - тип лендинга (‘в-наличии’ или ‘под-заказ’)

Возвращает:

• is_valid - True если файл соответствует стандарту
• warnings - список предупреждений (некритичные проблемы)
• errors - список ошибок (критичные проблемы)

---

✅ Контрольный список

Перед началом генерации лендинга убедитесь:

• Получен ответ на вопрос о типе лендинга
• Получено название клиента
• Файл проверен на соответствие стандарту
• Нет критичных ошибок (errors)
• Предупреждения (warnings) учтены или исправлены

---

Статус: ✅ Активно используется
Последнее обновление: 2026-01-09