gc-test/deal-commands

Framework-agnostic command processing package for CRM deals

v0.1.0 2025-10-13 08:59 UTC

Requires

• php: ^8.2
• ext-mbstring: *
• psr/log: ^3.0

Requires (Dev)

• composer/xdebug-handler: ^3.0
• ergebnis/composer-normalize: ^2.48
• friendsofphp/php-cs-fixer: ^3.88
• illuminate/support: ^12.0
• phpunit/phpunit: ^10.5
• savinmikhail/dist-size-optimizer: ^0.2.5

MIT

README

Цель

Разработать PHP пакет для обработки текстовых команд пользователя. Пакет должен быть независим от фреймворка, но легко интегрироваться с Laravel приложениями через Composer.

Контекст

Пакет будет использоваться в CRM-системе, где пользователи вводят текстовые команды для управления сделками. Все команды выполняются в контексте конкретной сделки.

Примеры команд для реализации

• /принято 500 офис — устанавливает свойство сделки #14 = 500, а #15 = офис
• /контакт — выводит служебное сообщение в сделку с текстом, содержащим контакт клиента по текущей сделке
• /причина_закрытия удалена транзакция — устанавливает свойство сделки #222 в "удалена транзакция"
• /причина — выводит служебное сообщение в сделку с текстом, содержащим свойство #222 текущей сделки

Требования

1. Код должен быть написан на PHP 8+
2. Пакет должен быть установлен через Composer
3. Необходимо реализовать логирование вызовов команд
4. Бизнес-логика должна быть изолирована от инфраструктуры
5. Решение должно быть расширяемым для добавления новых команд

Ограничения

• Пакет должен быть написан на чистом PHP без прямых зависимостей от Laravel

Критерии оценки

1. Архитектурное решение
2. Чистота и стиль кода
3. Наличие тестов
4. Возможность расширения функциональности
5. Правильность настройки Composer для использования в Laravel

Установка и интеграция с Laravel

1. Установка

composer require gc-test/deal-commands

1. Автодискавери

• Ничего добавлять в config/app.php не нужно: провайдер пакета подключится автоматически.

1. Публикация конфига

php artisan vendor:publish --tag=deal-commands-config

1. Настройка config/deal-commands.php

'adapter' => App\Infrastructure\Crm\DealGateway::class,
'commands' => [
    GcTest\DealCommands\Application\Commands\AcceptedCommand::class,
    GcTest\DealCommands\Application\Commands\ContactCommand::class,
    GcTest\DealCommands\Application\Commands\CloseReasonSetCommand::class,
    GcTest\DealCommands\Application\Commands\CloseReasonShowCommand::class,
],

1. Использование

use GcTest\DealCommands\Application\CommandProcessor;
use GcTest\DealCommands\Domain\Contracts\DealGatewayInterface;

$processor = app(CommandProcessor::class);
$gateway = app(DealGatewayInterface::class); // ваша реализация из конфига

$response = $processor->process($input, $gateway);