Полное условие и решение

Рабочий материал для самостоятельного использования. Скопируй текст в свой документ и адаптируй под свою задачу. Данные не отправляются.

Практикум: рассчитать сумму без скрытых правил

API получает объект с обязательными полями amount, quantity, discount и currency. Дополнительные поля запрещены в этом учебном контракте. Amount — JSON-число от 0 до 1000000; quantity — целочисленный JSON-литерал без дробной части и экспоненты от 1 до 1000; discount — JSON-число от 0 до 0.30 включительно; currency должна быть RUB. Amount и discount допускают не более 3 десятичных знаков после точки: произвольно малые дроби не входят в контракт. Строки, bool и null не подменяют числа.

Формула: amount × quantity × (1−discount). Итог округляется до двух знаков только после полного расчёта, с правилом MidpointRounding.AwayFromZero. Все суммы неотрицательные. Нулевой итог нормализуется к строке 0.00, включая допустимый вход −0.0. Отмена до начала расчёта возвращает cancelled, без вычисленного total. Налоги, конверсия валют, сохранение в БД и скидки на отдельные позиции не входят в условие.

Это авторская тренировка, а не финансовый документ. Правило округления задано для решения; из него не следует обязательный порядок любого реального бухгалтерского расчёта.

Что спросить до ответа

Выясни валюту, допустимый диапазон, формат входа, разрешённое количество десятичных знаков и точку округления. Спроси, применяется ли скидка к единице или к сумме, есть ли построчное округление и что считается ошибкой контракта. Отдельно уточни, какую отмену моделируем: до старта, во время I/O или после commit.

В данном кейсе ответы уже зафиксированы. Не добавляй округление каждой цены только потому, что в другом проекте было так принято. Если работодатель не указал правило, предложи допущение и последствия, а не скрывай его внутри вызова Math.Round.

Решение и расчёт

Ответ интервьюеру:

Сначала проверю структуру и типы, затем диапазоны и валюту. После подтверждения допустимого входа выполню десятичный расчёт без промежуточного округления и округлю итог по заданному правилу. Ошибки внешнего контракта отделю от отмены и от неожиданной ошибки выполнения. Значения default не должны маскировать отсутствующие обязательные поля.

Для amount=19.995, quantity=3, discount=0.10: сумма до скидки 59.985; после скидки 53.9865; итог 53.99. Если сначала округлить цену до 20.00, получится 54.00. Разница в одну копейку — не спор о предпочтениях типов: это нарушение прямо заданной точки округления.

Для 1.005 при количестве 1 и нулевой скидке результат 1.01. При amount=0 итог 0.00. На верхних границах 1000000 × 1000 × 0.70 = 700000000.00. Эти числа позволяют заранее проверить формулу и границы независимо от будущего C#-кода.

Полные классы проверок

Вход или событиеОжидаемый результат
Основной пример 19.995 ×3 со скидкой 10%ok, total=53.99
1.005 ×1 без скидкиok, total=1.01
amount=0ok, total=0.00
Верхние границы и скидка 30%ok, total= 700000000.00
amount=null, строка или отрицательное числоinvalid, поле amount
quantity=true, 1.0, 1e0, 0 или 1001invalid, поле quantity
discount=0.301invalid, поле discount
currency=USDinvalid, поле currency
Неисправный JSON с запятой внутри числаbad_json
Отмена до начала обработкиcancelled, без total

Здесь имена состояний — контракт упражнения. Их перенос в Problem Details, HTTP-ответ или типизированный Result требует отдельного решения приложения. Не выдавай таблицу за поведение любого ASP.NET-метода по умолчанию.

Что проверено в приложении

Файл vectors.json содержит 20 полных входов и ожидаемых результатов. Команда python3 check.py проверяет их на Python 3.9.6 со стандартным Decimal. Все входы арифметики неотрицательны, поэтому используемый ROUND_HALF_UP даёт нужное направление для заданных midpoint-примеров. Это не общее равенство всех возможностей Python Decimal и C# decimal.

Команда python3 check.py --negative намеренно округляет цену раньше времени. Она отклонена с кодом 2: основной пример даёт 54.00 вместо 53.99. Такой контроль подтверждает, что набор замечает конкретную ошибку алгоритма. Он не проверяет сборку C#, особенности сериализации CLR, cancellation middleware или драйвер БД.

Заверши репетицию объяснением границ: «Я согласовал числовой контракт, отличаю null от 0 и задаю округление явно. Для .NET-реализации дополнительно проверю binding, cancellation, типы и ошибки провайдера в выбранной версии». Затем спроси у команды, где у неё определяются денежные правила и как они тестируются между API, сервисом и базой.