VkusVill_KZ-Landings

План действий при создании лендинга

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

📋 Последовательность действий

ШАГ 1: Получение пути к файлу

Что происходит:

Пользователь предоставляет путь к Excel-файлу (например: /path/to/file.xlsx)
Я подтверждаю получение файла

Мои действия:

✅ Получен файл: [путь к файлу]
📖 Готов начать создание лендинга

ШАГ 2: Вопрос о типе лендинга (ПЕРВЫЙ ВОПРОС)

Что я спрашиваю:

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

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

Варианты ответов пользователя:

“В наличии” / “в наличии” / “В Наличии” / “stock” / “stock-in”
“Под заказ” / “под заказ” / “под-заказ” / “order”

Что происходит после ответа:

Я нормализую ответ (привожу к стандартному формату: в-наличии или под-заказ)
Сохраняю тип лендинга для дальнейшей работы
НЕ начинаю проверку файла - перехожу к следующему вопросу

ШАГ 3: Вопрос о названии клиента (ВТОРОЙ ВОПРОС)

Что я спрашиваю:

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

Варианты ответов пользователя:

Любое текстовое название (например: “Dokovil”, “Тест Под Заказ”, “Алтындар”)

Что происходит после ответа:

Сохраняю название клиента
НЕ начинаю проверку файла - перехожу к проверке

ШАГ 4: Проверка файла на соответствие стандарту

Что я делаю:

Читаю Excel-файл с помощью pandas
Проверяю структуру файла против стандарта
Валидирую с помощью функции validate_excel_structure(df, landing_type)

Что проверяю:

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

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

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

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

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

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

Опциональные колонки (не критичны):

C (2): Подкатегория
E (4): Квант
F (5): Штрихкод
G (6): Срок годности (cутки) (альтернативы: “Срок годности (сутки)”, “Срок годности”)
H (7): Вес (гр/мл) (альтернативы: “Вес, гр (Объём, мл)”, “Вес”)
I (8): Цена Партнеру (альтернатива: “Стоимость товара в закупке, с НДС”)
J (9): Рекомендуемая Розничная Цена
K (10): Ссылка на фото
L (11): Ссылка на фото.1

ШАГ 5: Результат проверки файла

✅ СЦЕНАРИЙ А: Файл соответствует стандарту

Что я делаю:

Вывожу сообщение об успешной проверке
Начинаю генерацию лендинга

Запускаю команду генерации с параметрами:

python3 generate_landing.py "[путь к файлу]" "[название клиента]" "[short-name]" --type [тип]

Что происходит при генерации:

Чтение данных из Excel
Обработка данных (категории, товары, цены)
Генерация HTML-файла с:
- Заголовком: название клиента
- Подзаголовком: “В наличии на [дата]” или “Под заказ [дата]”
- Категориями товаров
- Корзиной с изоляцией по landing_id
Автоматический деплой на GitHub Pages
Открытие лендинга в браузере

Что я вывожу:

✅ Файл соответствует стандарту
🎨 Генерирую лендинг "[тип]" для клиента "[название клиента]"...

[Процесс генерации]

✅ Лендинг успешно создан!

🔗 Ссылка для клиента:
   https://gen202020212022-ui.github.io/VkusVill_KZ-Landings/[имя-файла]

✅ Эту ссылку можно отправлять клиенту - она работает для внешних пользователей
✅ Доступна на всех устройствах: компьютер, iPhone, Android

❌ СЦЕНАРИЙ Б: Файл НЕ соответствует стандарту

Что я делаю:

Вывожу сообщение об ошибке
НЕ начинаю генерацию
Перечисляю конкретные ошибки
Объясняю, как исправить файл

Что я вывожу:

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

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

Предупреждения:
- Столбец E (индекс 4): нестандартное название "Квантность" (ожидается "Квант")

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

💡 Рекомендации по исправлению:
1. Добавьте колонку "Остаток" в столбец M (для типа "В Наличии")
2. Убедитесь, что колонка "Категория" находится в столбце B
3. Переименуйте "Название товара" в "Наименование" (или оставьте как есть, если это альтернативное название)

После исправления файла, попробуйте снова.

Что происходит после ошибки:

Генерация НЕ начинается
Пользователь должен исправить файл
После исправления - повторный запуск с тем же процессом

🔄 Полный пример диалога

Пример 1: Успешное создание лендинга “В Наличии”

Пользователь: "Сделай мне лендинг по файлу /Users/crocodile/Desktop/file.xlsx"

AI: "✅ Получен файл: /Users/crocodile/Desktop/file.xlsx
📖 Готов начать создание лендинга

Какого типа лендинг нужно создать?
1. В наличии - лендинг с остатками товаров и проверкой доступности
2. Под заказ - лендинг для товаров под заказ (без остатков)"

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

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

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

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

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

[Процесс генерации]

✅ Лендинг успешно создан!
🌐 Доступен по адресу: https://gen202020212022-ui.github.io/VkusVill_KZ-B2B/landings/dokovil"

Пример 2: Ошибка валидации

Пользователь: "Сделай мне лендинг по файлу /Users/crocodile/Desktop/file.xlsx"

AI: "✅ Получен файл: /Users/crocodile/Desktop/file.xlsx
📖 Готов начать создание лендинга

Какого типа лендинг нужно создать?
1. В наличии - лендинг с остатками товаров и проверкой доступности
2. Под заказ - лендинг для товаров под заказ (без остатков)"

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

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

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

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

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

Ошибки:
- Отсутствует обязательная колонка "Остаток" (столбец M, индекс 12) для типа "В Наличии"

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

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

Пример 3: Создание лендинга “Под заказ”

Пользователь: "Сделай мне лендинг по файлу /Users/crocodile/Desktop/file.xlsx"

AI: "✅ Получен файл: /Users/crocodile/Desktop/file.xlsx
📖 Готов начать создание лендинга

Какого типа лендинг нужно создать?
1. В наличии - лендинг с остатками товаров и проверкой доступности
2. Под заказ - лендинг для товаров под заказ (без остатков)"

Пользователь: "Под заказ"

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

Пользователь: "Тест Под Заказ"

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

✅ Файл соответствует стандарту
🎨 Генерирую лендинг "Под заказ" для клиента "Тест Под Заказ"...

[Процесс генерации]

✅ Лендинг успешно создан!
🌐 Доступен по адресу: https://gen202020212022-ui.github.io/VkusVill_KZ-B2B/landings/test-pod-zakaz"

⚠️ Важные правила

1. Порядок вопросов

НИКОГДА не начинаю проверку файла до получения ответов на оба вопроса
ВСЕГДА спрашиваю тип лендинга первым
ВСЕГДА спрашиваю название клиента вторым

2. Валидация файла

НИКОГДА не начинаю генерацию при наличии ошибок (errors)
Предупреждения (warnings) не блокируют генерацию, но я их показываю

3. Тип лендинга

Для “В Наличии” - колонка “Остаток” ОБЯЗАТЕЛЬНА
Для “Под заказ” - колонка “Остаток” НЕ требуется

4. Название клиента

ОБЯЗАТЕЛЬНО для обоих типов лендингов
Используется в заголовке H1
Используется для генерации short_name (имя файла)

📋 Контрольный список перед генерацией

Перед началом генерации лендинга я проверяю:

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

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