Для работы приложения требуется установить при помощи Composer зависимости из файла сomposer.lock и сформировать автозагрузчик классов.

Для хранения данных использовалась СУБД MariaDB v.10.5.11, перед запуском приложения необходимо развернуть дамп базы данных из файла testtask.sql. Настройка DSN-строки для подключения к БД осуществляется в файле src/Database.php:

/** @var string DSN-строка для подключения к БД */
private static string $dsn = 'mysql:dbname=testtask;host=127.0.0.1';

Там же указываются логин и пароль пользователя БД (так как тестирование проводилось на локальной машине, то оставлен дефолтный для Open Server root без пароля):

/** @var string Имя пользователя БД */
private static string $user = 'root';

/** @var string Пароль пользователя БД */
private static string $password = '';

Количество денег, доступное в приложении для генерирования денежных призов можно указать как параметр в таблице БД settings:

Доступные для использования при генерации призов предметы хранятся в таблице БД available_things. Выбранный случайным образом предмет удаляется из таблицы. В случае, если пользователь в последствии отказывается от приза-предмета после его получения, запись о предмете снова помещается в таблицу доступных предметов и он может быть использован при генерации последующих призов.

При генерации денежных призов пропорционально уменьшается значение параметра available_money указанной выше таблицы, при отказе пользователя от денежного приза, сумма возвращается к доступным средствам.

В таблице users уже имеется запись о пользователе, для авторизации в приложении можно использовать следующие данные:

• логин: lucky
• пароль: 12345

Для перечисления денежного приза на счет пользователя в банке осуществляется HTTP-запрос по адресу http://test/api.php, данные о призе отправляются в формате JSON (метод transferToBank() класса src/Controller/MoneyPrizeController.php). Для возможности преобразования объекта в JSON, класс src/Entity/MoneyPrize.php реализует метод jsonSerialize() интерфейса JsonSerializable. Отправляемые данные имеют следующую структуру:

{"id":266,"type":"money","amount":210}

Консольная команда для пакетной отправки в банк данных о всех ранее не отправленных денежных призах пользователей принимает два обязательных параметра: transfer (название операции) и количество передаваемых призов в одном HTTP-запросе. Данные отправляются также в формате JSON по указанному выше адресу. Пример вызова консольной команды из корневой директории проекта:

php bin/cli.php transfer 10

Для написания модульных тестов использовался PHPUnit, класс теста находится в файле tests/Helper/MoneyHelperTest.php.