Claude Code, Codex и Cursor на одном трудном ТЗ

1Ты работаешь в пустом репозитории. Нужен модуль расчёта корзины интернет-магазина на 64-разрядной сборке PHP 8.2 с declare(strict_types=1), PSR-4 и неймспейсом Alto\Cart. В рантайме не должно быть внешних зависимостей, Composer нужен для автозагрузки и PHPUnit, а рабочий код должен обходиться стандартными возможностями PHP. Все денежные значения на входе, внутри расчёта и в ответе задаются целыми копейками; float, неявные преобразования к float и округление через round() в денежной логике запрещены.

2Входной JSON — объект с обязательным массивом items и необязательным promo_code, равным строке или null; другие поля корня недопустимы. Каждый элемент items — объект с ровно шестью полями sku, name, unit_price, quantity, category и unit_weight_g. sku, name и category — строки, остальные три поля — именно JSON-целые, не числа с экспонентой, не числовые строки и не boolean. Цена и вес неотрицательны и не превышают 1 000 000 000 000 копеек и 1 000 000 000 граммов соответственно, quantity лежит от нуля до 1 000 000. sku состоит из 1–64 ASCII-символов A–Z, 0–9, точки, дефиса или подчёркивания, причём первым идёт буква или цифра. name и category должны быть непустыми корректными UTF-8 строками длиной не более 256 байт без управляющих символов. Код промокода, если передан, состоит из 1–32 печатных ASCII-символов; его нельзя обрезать, менять регистр или Unicode-нормализовать.

3Строки с одинаковым sku сначала схлопываются, их quantity складывается с проверкой границы, а name, unit_price, category и unit_weight_g обязаны совпасть побайтово; конфликт делает весь вход некорректным. Нулевое quantity допустимо: такая позиция остаётся в разбивке, но даёт ноль в сумму и вес. Важна буквальная формулировка условия WELCOME: для него «в корзине есть позиция категории Электроника» означает наличие схлопнутой позиции, а не положительного количества, поэтому даже нулевая строка «Электроники» активирует код. Это выглядит сомнительно с точки зрения бизнеса, но до уточнения владельцем реализуй именно так и отдельно зафиксируй последствие в NOTES.md. Порядок строк входа не должен менять результат: в ответе позиции отсортированы по sku как по байтам ASCII.

4Сумма позиции до скидок равна unit_price, умноженной на сложенное quantity. Для категории «Аксессуары» скидка 10% считается не от суммы позиции: сначала 10% цены одной единицы округляются до копейки, затем результат умножается на quantity. Все упомянутые здесь округления денег — к ближайшей целой копейке, половина всегда вверх. Это правило нельзя заменять округлением общей суммы.

5Промокод SUMMER26 даёт 15% на каждую позицию, если общая сумма до скидок не меньше 500 000 копеек. Его 15% округляются один раз от всей суммы уже схлопнутой позиции. На «Аксессуарах» эти 15% не складываются с 10%: для каждой позиции в целых копейках выбирается большая скидка, а при равенстве побеждает категорийная. SUMMER26 действует по 31.08.2026 23:59:59 включительно по часовому поясу Europe/Moscow. Текущее время не приходит из JSON: библиотечный API должен позволять подменить часы или момент времени, а CLI использует системное время.

6Промокод WELCOME бессрочно даёт 50 000 копеек на корзину при описанном выше наличии «Электроники». Вопреки обычному правилу несложения, WELCOME применяется уже после категорийной скидки и складывается с ней; SUMMER26 и WELCOME одновременно передать нельзя, поскольку promo_code один. Фиксированная скидка ограничивается суммой товаров после 10%, поэтому итог не уходит в минус. Её точная сумма распределяется пропорционально суммам позиций после категорийной скидки: каждая позиция сначала получает целую часть точной доли, а оставшиеся копейки по одной раздаются позициям с большими дробными остатками; равные остатки разрешаются по возрастанию sku. На нулевую после 10% позицию ничего не выделяется. Сумма распределённых копеек должна в точности равняться общей фиксированной скидке.

7Неизвестный или просроченный промокод не является ошибкой: расчёт продолжается без него, а в promo ответа возвращаются исходный code и status unknown или expired. Для отсутствующего или равного null кода status равен not_provided, для известного, но не прошедшего порог или условие категории, — ineligible, для применённого — applied. WELCOME, прошедший условие, имеет applied даже при нулевой фактической скидке.

8Доставка бесплатна, если квалифицирующаяся сумма товаров не меньше 1 000 000 копеек. Для корзины без промокода или с WELCOME это сумма после категорийной скидки, но до вычета WELCOME; фиксированный код здесь считается способом оплаты. Для SUMMER26 берётся сумма после победивших позиционных скидок. Это правило применяется и к ровно 1 000 000 копеек. В остальных случаях доставка стоит 35 000 копеек плюс 2 000 копеек за каждый полный килограмм сверх 5 000 граммов: при 5 999 граммах надбавки ещё нет, при 6 000 есть одна. Вес позиции — unit_weight_g, умноженный на quantity, общий вес суммируется в граммах.

9НДС 20% уже включён и в цены, и в платную доставку, а не начисляется сверху. Он выделяется после всех скидок как 20/120, причём округление делается отдельно для каждой схлопнутой товарной позиции и отдельно для доставки, после чего округлённые величины складываются. Нельзя сначала сложить товары с доставкой и выделить НДС одним округлением. Показанный НДС не меняет итог к оплате.

10Ответ содержит items с одной строкой на схлопнутый sku и полями sku, name, category, unit_price, quantity, gross, discount, net, vat и applied_discounts, где applied_discounts — массив строк category_10, SUMMER26 или WELCOME в фактическом порядке применения; несработавшая или нулевая скидка в него не включается. Наряду с items нужны subtotal, discount_total, shipping, vat, total и объект promo с code и status. subtotal равен сумме gross, discount_total — сумме discount, total — сумме net плюс shipping, и все эти тождества должны сходиться до копейки. code равен null, если код не передан или передан как null. JSON-вывод должен быть детерминирован при одинаковом моменте времени и логически тождественном входе, включая перестановку его строк.

11Вход считается недоверенным. bin/cart.php обязан отклонить stdin длиннее 1 048 576 байт ещё до JSON-декодирования, JSON глубже 32 уровней и более 1 000 исходных элементов items до схлопывания. Некорректный UTF-8, неизвестные поля, лишние уровни, неверные типы и выход любого промежуточного результата за PHP_INT_MAX делают весь вход некорректным. Проверять нужно каждое сложение и умножение, включая сумму дублей, цену и вес позиции, вес и деньги корзины, скидку, доставку и итог. Валидные по отдельности большие операнды нельзя сначала перемножать с переполнением и лишь потом делить; формулы процентов, 20/120 и пропорционального распределения должны давать тот же целочисленный результат без такого опасного промежуточного умножения.

12Кроме библиотеки нужен исполняемый bin/cart.php: он читает ровно один JSON из stdin и пишет ровно один JSON-результат в stdout. При некорректном входе stdout остаётся пустым, в stderr попадает однострочный JSON с объектом error, содержащим только безопасные code и message, а процесс завершается с кодом 2. Неожиданный Throwable на границе CLI нужно перехватить, вернуть тот же формат с кодом INTERNAL_ERROR и завершиться с кодом 1. Ни в одном ответе об ошибке нельзя показывать трассировку, классы исключений, пути файлов и строки кода, фрагменты входа или другие внутренние детали; недопустимы также eval, unserialize и запуск команд на основе входа.

13Обязательны PHPUnit-тесты, запускаемые через composer test. Они должны проверять не только happy path, но и разницу между поштучным и позиционным округлением, раздачу остаточных копеек с ничьей по sku, построчный НДС, переставленные дубли и конфликт их атрибутов, нулевую «Электронику», пустую корзину, вес 5 000, 5 999 и 6 000 граммов, границы обоих промокодов и бесплатной доставки, некорректный UTF-8, слишком большой и глубокий JSON, ложные типы чисел, переполнение и санитарный формат ошибок CLI. Время в тестах подменяется, поэтому они одинаково проходят и сегодня, и в 2027 году, и в любом системном часовом поясе.

14В README.md опиши установку, запуск тестов, публичный API, форматы входа и ответа и дай рабочий пример CLI. В CHANGELOG.md зафиксируй сделанное, в NOTES.md — принятые решения, неочевидные инварианты и всё, что в формулировках показалось сомнительным. Перед завершением прогони composer test. Если хоть что-то из этого задания не сделано, в конце ответа сообщи об этом прямым текстом.