# WooCommerce — обновление цен и остатков из CSV

Independent concept by Ki33. Самостоятельный технический демонстрационный проект, не коммерческий заказ.

Работающий WordPress с WooCommerce, каталогом из 12 вымышленных товаров и собственным PHP-плагином Ki33 Catalog CSV. Статус комплекта: функционал, исходники, CSV, PNG и обложка готовы. Запись экрана готова: MP4, 57 секунд, 1920×1080, H.264, 30 fps, короткие русские титры. Весь интерфейс в ролике взят из настоящей записи ScreenCutter. Ничего не опубликовано на Freelancehunt или публичном PHP-хостинге.

## Проверенное окружение

| Компонент | Версия |
|---|---|
| Windows | 64-bit, PowerShell 5.1+ |
| WordPress | 7.1.3 |
| WooCommerce | 11.2.1 |
| PHP | 8.4.26, Windows x64 |
| MariaDB | 11.8.9, InnoDB |
| Собственный плагин | 1.0.0 |

Это зафиксированные версии проверенной локальной сборки, не обещание поддержки любых версий. Для PHP нужны mysqli, mbstring, curl, openssl, zip, gd, intl, fileinfo и exif; конфигурация входит в запуск. На проверенной машине необходимые Windows VC runtime уже установлены. Если на другой машине отсутствует DLL, понадобится официальный Microsoft Visual C++ Redistributable x64. Пакет не устанавливает службы Windows и ничего не публикует в сеть.

## Быстрый запуск переносной сборки Windows

1. Распаковать `ki33-woocommerce-portable-windows.zip` в доступную для записи папку. Разрешён путь с пробелами — это проверено отдельной чистой установкой. Не запускать из ZIP и не использовать папку рабочего магазина.
2. Открыть `Start-demo.cmd`. Первый запуск создаёт локальную базу, генерирует wp-config.php с новыми salts, устанавливает WordPress/WooCommerce и 12 товаров с изображениями. Дождаться адресов в консоли; первое создание занимает несколько минут. Для этого варианта PHP/MariaDB/WordPress/WooCommerce уже лежат внутри ZIP, интернет не требуется.
3. Магазин: http://127.0.0.1:8787/ . Админка: http://127.0.0.1:8787/wp-admin/admin.php?page=ki33-catalog-csv&view=catalog .
4. Администратор: `ki33_admin` / `Ki33Demo!2026`. Пользователь без прав импорта: `ki33_viewer` / `Ki33Viewer!2026`.
5. `Stop-demo.cmd` останавливает только процессы этой сборки с совпадающими PID и путями. Данные сохраняются. Повторный Start не создаёт дубли.
6. `Reset-demo.cmd` возвращает только 12 демонстрационных SKU к исходным ценам и остаткам; другие товары не удаляет. Предпросмотр после сброса нужно создать заново.

Порты по умолчанию: HTTP 8787, MariaDB 33077. При занятом порте запуск выдаёт ошибку, а не завершает чужой процесс. Для второй независимой копии **до первого запуска** поменять `setup/settings.json` (например, 8788 / 33078). После создания базы не менять настройки без перенастройки wp-config.php. Нельзя одновременно запускать две копии с одинаковыми портами.

Демо-учётные данные открыто указаны в исходниках; они предназначены исключительно для loopback. PHP слушает 127.0.0.1, MariaDB — 127.0.0.1. Не открывать их наружу, не переносить локальный wp-config.php и local-demo MU-плагин в production. У PHP встроенный сервер для разработки, не production-сервер. В локальном wp-config отключены внешние HTTP-запросы, WP Cron и автообновления; локальный MU-плагин отключает асинхронные loopback-задачи WooCommerce, чтобы однопоточный Windows PHP-сервер не блокировал сам себя.

## Установка только плагина в обычный WordPress

1. Подготовить WordPress и бесплатный WooCommerce на PHP 8.3+ с mysqli и mbstring, таблицы posts/postmeta/wc_product_meta_lookup — InnoDB. Реально проверена комбинация версий выше.
2. Админка → Плагины → Добавить плагин → Загрузить: `ki33-catalog-csv-1.0.0.zip`. Активировать WooCommerce, затем Ki33 Catalog CSV.
3. Использовать существующие простые товары с уникальными SKU, включённым учётом остатков и без акционной цены. Плагин товары не создаёт. CSV-примеры рассчитаны на 12 SKU из `setup/products.php`, автоматически создаваемых переносной демосборкой.
4. Открыть WooCommerce → CatalogOps · CSV. Нужны `manage_woocommerce`, `edit_products` и право `edit_post` для каждого товара. Обычный подписчик доступа не имеет.

Для полноценного воспроизведения всех изображений и исходных значений использовать переносную сборку либо адаптировать CLI seed к своей **тестовой** установке. Не выполнять seed или автоматические тесты на рабочем магазине.

## Формат и сценарий

Ровно три колонки с заголовком `sku,price,stock`; разделитель запятая, UTF-8 (BOM допустим). Цена неотрицательная, десятичный разделитель точка, число знаков определяется настройкой валюты WooCommerce (в демо EUR, 2 знака). Целый остаток 0–9999999. SKU: 1–64 ASCII-символа, буквы, цифры, точка, дефис, подчёркивание; первый символ буква/цифра. Пустое значение любого поля недопустимо. SKU сопоставляются с существующими товарами, повторения в файле проверяются без учёта регистра. Пробелы по краям значений обрезаются, пустые записи пропускаются. До 1 МБ и 1000 записей. Номера ошибок — номера CSV-записей с учётом заголовка, а не физических строк внутри кавычек.

`examples/errors.csv`: 5 записей, 5 ошибок: дублирующий SKU, неизвестный SKU, отрицательная цена, отрицательный остаток, пропущенная цена. Все ошибки показываются вместе; кнопки применения нет; ни один товар не меняется.

`examples/valid.csv`: 12 записей. Меняются 4 товара:

| SKU | Цена до → после, EUR | Остаток до → после |
|---|---|---|
| K33-NB-001 | 18.50 → 21.90 | 24 → 18 |
| K33-MUG-002 | 24.00 → 26.50 | 16 → 22 |
| K33-PEN-003 | 6.90 → 7.50 | 60 → 48 |
| K33-LMP-004 | 59.00 → 59.00 | 8 → 0 |

Остальные 8 не меняются. Загрузить → «Проверить файл» → сверить предпросмотр → «Подтвердить обновление (4)». До подтверждения значения остаются исходными. После применения: обновлено 4, без изменений 8, создано 0. Лампа получает статус «Нет в наличии» (в демо предзаказ выключен). Повторная загрузка valid.csv показывает «Новых изменений нет», без кнопки применения; товаров по-прежнему 12.

Предпросмотр хранится на сервере, привязан к пользователю, действует 15 минут. Новая загрузка заменяет предыдущую. Отдельные nonce для загрузки/применения, одноразовый token плана, клиентские цены не принимаются. Перед записью повторно проверяются права и все исходные значения; устаревший предпросмотр отклоняется. Обновление выполняется WooCommerce CRUD API внутри транзакции с блокировками и очисткой кэшей. При ошибке сохранения изменения БД откатываются.

## Проверка

Проверять только на одноразовой демобазе: тесты меняют и затем сбрасывают 12 тестовых товаров. Перед тестами запустить сборку.

PowerShell из корня распакованной сборки:

```powershell
.\runtime\php\php.exe -c .\runtime\php\php.ini .\tests\integration.php
python .\tests\http_security.py
```

Второй тест требует Python 3.10+ со стандартной библиотекой; для обычного запуска магазина Python не нужен. Отчёты пишутся в `artifacts/`. Интеграционные проверки: 38, HTTP-проверки: 24, все пройдены. Вторая чистая копия с пробелом в пути, новой БД, без wp-config.php и uploads также прошла 38+24 проверки. Оригиналы отчётов находятся в `artifacts/` и `artifacts/reproduction/`.

Проверены: неизменность до подтверждения и при ошибках; четыре обновления через WooCommerce; повторный файл без дублей; отказ анонимному пользователю/подписчику; неправильный nonce; повторное применение token; игнорирование подменённых клиентских цен; изменение товара после предпросмотра; откат первого сохранения при искусственной ошибке второго; BOM, CRLF, нулевые значения и некорректный CSV. Сбросы тестов не являются частью обычного импорта.

Ручная браузерная проверка: настоящий администратор, загрузка обоих файлов, подтверждение, повторный импорт; снимки сделаны из работающего WP. Витрина и страница товара проверены на ширине viewport 390 px: горизонтального переполнения страницы нет. Мобильные снимки — дополнительные; обязательные четыре PNG имеют ровно 1440×900.

## Комплект

- `ki33-catalog-csv-1.0.0.zip` — устанавливаемый плагин без локальной конфигурации и учётных записей.
- `ki33-woocommerce-source.zip` — собственный код PHP/CSS, тема, 12 оригинальных SVG/PNG иллюстраций товаров, bootstrap, тесты, примеры и документация.
- `ki33-woocommerce-portable-windows.zip` — самостоятельная локальная Windows-сборка с официальными бесплатными компонентами; база и wp-config генерируются при запуске, существующая БД в архив не включена.
- `screenshots/01-before.png`, `02-errors.png`, `03-preview.png`, `04-result.png` — четыре настоящих экрана 1440×900; `05-repeat.png` — дополнительный повторный импорт.
- `cover-1600x1000.png`, исходник генерации обложки и `CASE-FREELANCEHUNT-RU.md`.
- `video/Ki33-WooCommerce-CSV-57s.mp4` — готовая запись, 57 секунд, 1920×1080, H.264, 30 fps; `captions-ru.srt` и кадр `poster.png`.
- `RECORDING-PLAN.md` — выполненный сценарий и монтажные таймкоды. В исходниках есть очищенная от посторонних окон запись браузера, план склеек, титры и код сборки видео.

## Границы и ограничения

Поддерживаются простые товары с управлением остатками, без акционной цены. Вариации, создание товаров, массовые фоновые задания, история импортов, экспорт, мультивалютность, налоговая логика, CRM/ERP, платежи и оформление заказов вне объёма. Обзор в админке показывает до 100 опубликованных простых товаров; предпросмотр CSV показывает все валидные записи в пределах лимита. Демокаталог не осуществляет продажи.

Транзакция защищает записи проверенных InnoDB-таблиц в данной сборке. Сторонние плагины могут выполнять внешние действия на WooCommerce hooks; откат отправленного письма или внешнего API-запроса транзакция не обеспечивает. Совместимость с такими расширениями и нагрузкой рабочего магазина отдельно не проверялась. Для production нужны резервная копия, staging-проверка, нормальный PHP-хостинг, индивидуальные учётные данные и настройка фоновых задач. PHP на Netlify здесь не запускается; публичный хостинг не подготовлен и не обещан.

## Происхождение и лицензии

WordPress, WooCommerce и MariaDB получены из официальных источников; URL и SHA-256 фактически загруженных архивов — в `provenance/download-manifest.json`. MariaDB дополнительно сверена с официальным sha256sums. PHP 8.4.26 использован из уже имеющегося локального Windows runtime; лицензии и сведения о поставляемых DLL сохранены в runtime/php. Переносной архив включает лицензии компонентов; собственный PHP-плагин и тема — GPL-2.0-or-later. Иллюстрации товаров созданы для этого независимого кейса. Никаких платных компонентов, реальных клиентов, отзывов или выдуманных бизнес-результатов.
