artem-prozorov / ffa Goto Github PK

Добавить 2 класса: App\Actions\Attack и App\Actions\Take. Оба класса должны наследоваться от App\Actions\AbstractAction.
Метод isAvailable класса Attack должен возвращать true, если $subject реализует интерфейс App\Contracts\AttackableInterface
Метод isAvailable класса Take должен возвращать true, если $subject реализует интерфейс App\Contracts\TakeableInterface

Методы getTitle и getDescription класса Attack должны возвращать фразу "Атаковать".
Методы getTitle и getDescription класса Take должны возвращать фразу "Взять"

Нужно использовать штатный функционал Ларавеля для реализации переводов. Файл с переводами можно разместить в файле resources/lang/ru/actions.php

Нужно создать класс \App\Exceptions\InvalidArgumentException, которое должно наследоваться от базового класса \InvalidArgumentException.

Конструктор должен принимать в себя ларавелевскую коллекцию.

Примерно так

use InvalidArgumentException as BaseInvalidArgumentException;
use Illuminate\Support\Collection;

class InvalidArgumentException extends BaseInvalidArgumentException

Должно быть защищенное свойство $errors и сеттер и геттер для него

интерфейс - https://github.com/artem-prozorov/FFA/blob/game_settings_implementation/app/Contracts/Game/GameServiceInterface.php

нужно создать класс App\Services\Game\GameService, реализующий этот интерфейс

метод createNewGame должен получить в качестве аргумента объект, реализующий интерфейс настроек, затем создать новую игру (App\Models\Game), установить для нее статус App\Dictionaries\GameStatuses::NEW_GAME, сгенерировать для нее новую карту с артефактами. Вернуть объект Game.

Для того, чтобы сгенерировать новую карту, нужно обратиться к методу create вот этого интерфейса https://github.com/artem-prozorov/FFA/blob/game_settings_implementation/app/Contracts/Map/MapGeneratorInterface.php

Для взаимодействия с этим интерфейсом нужно воспользоваться паттерном Dependency Injection. Для этого в Ларавеле делают так:

protected $mapGenerator;

public function __construct(MapGeneratorInterface $mapGenerator)
{
    $this->mapGenerator = $mapGenerator;
}

и потом внутри класса обращаться к генератору карт через $this->mapGenerator

Метод applyUserForGame должен проверить статус игры ($game->status), если он не равен App\Dictionaries\GameStatuses::NEW_GAME, то нужно выбросить исключение \InvalidArgumentException

Если статус игры соответствует, то нужно проверить сколько у нее уже игроков ($game->players()->count()), если игроков больше 8, то тоже нужно выбросить это исключение.

Также если существующий пользователь уже участвует в игре, то тоже нужно выбросить исключение

Если все ок, нужно создать новую модель Player и привязать ее к пользователю и игре.

Метод startTheGame должен проверить статус переданной игры, и если он равен App\Dictionaries\GameStatuses::NEW_GAME, то нужно изменить его на App\Dictionaries\GameStatuses::ACTIVE. В противном случае, нужно выбросить исключение.
Также здесь нужно проверить, что у игры есть минимум 2 игрока. Если их меньше 2, то нужно выбросить исключение

Когда будет готова задача #29 нужно в классе App\Services\Game\Settings заменить исключение \InvalidArgumentException исключением App\Exceptions\InvalidArgumentException

В это исключение нужно передать коллекцию ошибок
Вместо этого:

throw new \InvalidArgumentException();

Сделать так:

throw (new \App\Exceptions\InvalidArgumentException())->setErrorsCollection($validator->errors());

Создать класс App\Collections\PositionablesCollection
Этот класс должен наследоваться от Gamez\Illuminate\Support\TypedCollection и позволять в себе хранить только объекты, реализующие интерфейс App\Contracts\PositionableInterface

Работать в ветке

Нужно разработать класс App\Services\Game\AvailableActionsService, реализующий вот этот интерфейс: https://github.com/artem-prozorov/FFA/blob/available_actions/app/Contracts/Game/AvailableActionsServiceInterface.php

У этого класса должно быть защищенное свойство, содержащее список классов типа App\Actions\AbstractActionProvider
Примерно так:

protected $providers = [
    ProviderA::class,
    ProviderB::class,
];

Метод getAvailableActions должен работать следующим образом:

1. Нужно создать пустую коллекцию действий (App\Collections\ActionsCollection)
2. Получить список провайдеров, каждый из них создать, выполнить и получить из него доступные действия, добавить их в текущую коллекцию действий
3. Вернуть коллекцию действий

1. Создать класс App\Actions\PositionableActionFactory
2. у класса должен быть публичный метод

use App\Contracts\PositionableInterface;
use App\Models\Player;

public function getSuitableAction(Player $player, PositionableInterface $positionable): App\Actions\AbstractAction

Если $positionable реализует интерфейс App\Contracts\AttackableInterface, то нужно вернуть App\Actions\Attack, если же он реализует App\Contracts\TakeableInterface, нужно вернуть App\Actions\Take

Если ни один из вариантов не верен, нужно бросить исключение App\Exceptions\InvalidActionException, которое должно расширять \InvalidArgumentException

В сервисе координат добавился метод getPositionablesNearby, который нужно реализовать и исправить существующие тесты.

Метод должен возвращать типизированную коллекцию объектов, реализующих интерфейс App\Contracts\PositionableInterface

Для этого сервис должен взять карту и посчитать, какие объекты находятся на заданном расстоянии от текущего игрока.

В качестве расстояния берем 20% от ширины карты

Работу вести в ветке add_getPositionablesNearby_method

Работу вести в ветке distance_calculation

Нужно реализовать вот этот интерфейс и метод: https://github.com/artem-prozorov/FFA/blob/distance_calculation/app/Contracts/Map/CoordinatesServiceInterface.php#L27

Метод getNonOccupiedPoint пока что игнорировать, просто возвращать пустую позицию.

Класс должен быть такой: App\Services\Map\Coordinates

1. Нужно создать 3 интерфейса (пустых, без методов)

• App/Contracts/PositionableInterface
• App/Contracts/AttackableInterface
• App/Contracts/TakeableInterface

2. Модель App/Models/Player должна реализовывать AttackableInterface
3. Модель App/Models/Artifact должна реализовывать TakeableInterface

Создать класс App\Services\Map\MapGenerator, реализующий интерфейс App\Contracts\Map\MapGeneratorInterface

Метод create должен создавать модель App\Models\Map с заданной в SettingsInterface высотой и шириной, также должен создать радномное количество артефактов (скажем от 10 до 100) и расположить их на карте. Артефакты не должны наслаиваться друг на друга, но реализовывать это не нужно, для получения уникальной не занятой позиции на карте нужно обращаться к методу getNonOccupiedPoint сервиса App\Contracts\Map\CoordinatesServiceInterface

Работу нужно вести в ветке map_service

По окончанию работы все текущие юнит тесты должны работать

1. Установить вот эту библиотеку https://github.com/jeromegamez/typed-collection
2. Создать класс App\Collections\ActionCollection
3. Этот класс должен наследоваться от Gamez\Illuminate\Support\TypedCollection и позволять в себе хранить только объекты класса App\Actions\AbstractAction