Рабочий материал для самостоятельного использования. Скопируй текст в свой документ и адаптируй под свою задачу. Данные не отправляются.
Практикум: рассчитать сумму без скрытых правил
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#-кода.
Полные классы проверок
Здесь имена состояний — контракт упражнения. Их перенос в 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, сервисом и базой.