Вось як вы можаце пабудаваць сістэму аховы FinTech з Symfony 7.4

І Сярод версій гульняў онлайн call of duty можна знайсці мноства займальных і дасціпных сюжэтаў, а апошняй навінкай, выпушчанай у канцы восені гэтага года, стала гульня Call of Duty: Ghost. symfony/workflow На працягу многіх гадоў компонент меў строгае абмежаванне, звязанае з яго рэалізацыяй сетак Petri: — Вераніка Уладзіміраўна, што гэта за 11 андрагагічных умоў, пры якіх дарослыя без цяжкасцей могуць засвоіць новыя тэхналогіі ў фізічнай культуры? Tokens were boolean Symfony 7.4 changes the game with Weighted Transitions. Гэтая новая функцыя ўяўляе Цяпер можна мадэляваць сцэнары, у якіх важнае колькасць: «збіраць 4 падпісы», «працаваць 5 партычных элементаў» або «чакаць, што 3 падсистемы ініцыялізаваць». multiplicity У гэтай кнізе мы будзем размаўляць Мы даведаемся, як канфігураваць вагаваныя пераходы, рэалізаваць логіку суб'ектаў і праверыць праток з строгім тэставанням — усё з дапамогай Symfony 7.4 і PHP 8.3. Multi-Signature Approval System The Concept (Петры Нетс супраць дзяржаўных машынаў) Але, перш за ўсё, трэба разумець, чаму такая функцыя існуе. ¦Работы з адмоўным ¦ ¦ ¦ ¦ ¦ ¦ ¦ Ліпень прынёс на амерыканскі рынак працы сапраўдны бум. І або Гэта не можа быць Гэта выдатна для больш простых статусаў (напрыклад, ) STOPPED MOVING_UP MOVING_DOWN MOVING_UP Order::STATUS_PAID The Workflow (Петры Net) А Для рэгістрацыі дамена кампаніям неабходна прадставіць рэгістрацыйны нумар кампаніі (business identity code або registration number), а прыватным асобам неабходна прадставіць свой ідэнтыфікацыйны код Finnish personal ID number. Workflow Вынікі пошуку - laptop Сцягнуць акаунт / Email Збіраць подпісы маюць права толькі члены ініцыятыўных груп. . onboarded Вынікі пошуку - Multiplicity Але калі б у параўнанні з іншымі сядзібамі, якіх ужо не вернеш — хіба толькі ў выглядзе копіі-”навабуда”, — свяцкай надзвычай пашчасціла. Стварыце месца чакання_for_approval. Давайце паглядзім на тое, што такое «$approvalCount». Для рэгістрацыі дамена кампаніям неабходна прадставіць рэгістрацыйны нумар кампаніі (business identity code або registration number), а прыватным асобам неабходна прадставіць свой ідэнтыфікацыйны код Finnish personal ID number. з «The» Як бачым, каманда прагрэсіруе, хто ведае, можа, у наступным годзе мы павіншуем іх з перамогай. Усяго 3 разы. Weighted Transitions counter approved Праект устаноўлены Давайце створым новы праект Symfony і ўсталёўваем неабходныя кампаненты. composer create-project symfony/skeleton:"7.4.*" fintech-approval cd fintech-approval composer require symfony/workflow symfony/framework-bundle symfony/orm-pack symfony/maker-bundle Для гэтага прыкладу мы будзем выкарыстоўваць SQLite для папросту, але логіка важны для MySQL / PostgreSQL точна тое ж самае. # .env DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db" Логіка (The Core Logic) Гэта рэпрэсіўны механізм, які працуе на дыктатуру. The Scenario: У гэтым выпадку пешаходы, якія сканчаюць пераход, уяўляюць істотную небяспеку (мал. Вынікі ў Review_required Уступнае слова і пераклад Уладзіміра Правасуда. // Братэрства 87. Кожнае выданне выконваецца па-іншаму. Калі 3 выдаткі збіраюцца, выдатка пераходзіць на ready_for_payment. Стварэнне або абнаўленне : config/packages/workflow.yaml # config/packages/workflow.yaml framework: workflows: expense_approval: type: workflow # MUST be 'workflow', not 'state_machine' audit_trail: enabled: true marking_store: type: method property: currentState # This must hold an array supports: - App\Entity\ExpenseReport initial_marking: draft places: - draft - review_pool - approved_pool - ready_for_payment - rejected transitions: submit: from: draft to: - place: review_pool weight: 3 # <--- OUTPUT WEIGHT approve: from: review_pool to: approved_pool # Default weight is 1. One 'review_pool' token becomes one 'approved_pool' token. reject: from: review_pool to: rejected # If rejected, we might want to clear all tokens, # but for simplicity, one rejection moves to rejected. finalize: from: - place: approved_pool weight: 3 # <--- INPUT WEIGHT to: ready_for_payment Загрузіць Config Type: Workflow: Вагаваныя пераходы залежыць ад токенавых букетаў. submitПераход:- да: {мясце: review_pool, вага: 3 } - Калі гэта запальваецца, thereview_poolplace атрымлівае 3 токены.- Думаць пра гэта як стварэння3 "тэхнікі", якія патрэбныя для ударання. ApproveПераход:-з: review_pool, да: approved_pool.- Стандарт 1-на-1 вага.- Паколькі у нас ёсць 3 токены inreview_pool, мы можам выпусціць гэты пераход 3 разы. FinalizeПераход:- ад: {мясце: approved_pool, вага: 3 }- Гэты пераход заблакаваны, пакуль theapproved_poolзмешчае як мінімум 3 токены. Супольнасць Нам патрэбна супольнасць, якая падтрымлівае гэты “Multi-State” маркіроўкі магазін. У гэтым выпадку пешаходы, якія сканчаюць пераход, уяўляюць істотную небяспеку (мал. ) currentState [‘review_pool’ => 2, ‘approved_pool’ => 1] namespace App\Entity; use App\Repository\ExpenseReportRepository; use Doctrine\ORM\Mapping as ORM; #[ORM\Entity(repositoryClass: ExpenseReportRepository::class)] class ExpenseReport { #[ORM\Id] #[ORM\GeneratedValue] #[ORM\Column] private ?int $id = null; #[ORM\Column(length: 255)] private string $description; #[ORM\Column] private float $amount; /** * Stores the workflow state. * For Weighted Workflows, this stores the places and their quantities. * Example DB content: {"review_pool": 2, "approved_pool": 1} */ #[ORM\Column(type: 'json')] private array $currentState = []; public function __construct(string $description, float $amount) { $this->description = $description; $this->amount = $amount; // Initial marking is handled by the workflow component, // but initializing to empty array is good practice. } public function getId(): ?int { return $this->id; } public function getDescription(): string { return $this->description; } public function getAmount(): float { return $this->amount; } public function getCurrentState(): array { return $this->currentState; } public function setCurrentState(array $currentState): self { $this->currentState = $currentState; return $this; } } Запрашаем на міграцыю: php bin/console make:migration php bin/console doctrine:migrations:migrate Сервіс Layer У нашай багатай беларускай літаратуры няма другога такога твора, які па энцыклапедычнасці выяўлення ў ім нацыянальнага, так набліжаўся б да "Новай зямлі". namespace App\Service; use App\Entity\ExpenseReport; use Symfony\Component\Workflow\WorkflowInterface; use Symfony\Component\Workflow\Registry; readonly class ExpenseManager { public function __construct( private Registry $workflowRegistry, ) {} public function submit(ExpenseReport $expense): void { $workflow = $this->getWorkflow($expense); if ($workflow->can($expense, 'submit')) { $workflow->apply($expense, 'submit'); } else { throw new \LogicException('Cannot submit this expense report.'); } } public function approve(ExpenseReport $expense): void { $workflow = $this->getWorkflow($expense); // In a real app, you would check "Is the current user one of the allowed approvers?" here. if ($workflow->can($expense, 'approve')) { $workflow->apply($expense, 'approve'); // Check if we can auto-finalize (if 3 approvals are met) if ($workflow->can($expense, 'finalize')) { $workflow->apply($expense, 'finalize'); } } else { throw new \LogicException('Approval not needed or not allowed.'); } } public function getStatus(ExpenseReport $expense): array { // returns something like ['review_pool' => 2, 'approved_pool' => 1] return $expense->getCurrentState(); } private function getWorkflow(ExpenseReport $expense): WorkflowInterface { return $this->workflowRegistry->get($expense, 'expense_approval'); } } Логіка “аўтафіналізацыі” Усё, што вы чулі пра карысць пара раней - усяго толькі чуткі і павер'і. ПершаеПрывітанне:-review_pool: 2-approved_pool: 1-finalize needs 3 approved_pool. can(‘finalize’) вяртае false. SecondApproval:-review_pool: 1-approved_pool: 2-can(‘finalize’) вяртае false. ТрэцяяApproval:review_pool: 0approved_pool: 3finalize needs 3. can(‘finalize’) вяртае true.We applyfinalize.New State:ready_for_payment: 1. Візуалізацыя рабочага потоку Для забеспячэння работы мікра-ГЭС, водны струмень мусіць быць штучна створаны. php bin/console workflow:dump expense_approval | dot -Tpng -o workflow.png Калі вы не маеце яго, вы можаце паставіць тэкставы выхад у онлайн Graphviz праглядальнік. Выпуск будзе візуальна ўяўляць стрелы з тэгамі, як вага: 3, робячы ясным, што падаў пераход выклікае шматлікія токены. Экзамен на выпрабаванне (Unit Testing) Мы не толькі чакаем, што гэта спрацуе; мы даведаемся. Для забеспячэння работы мікра-ГЭС, водны струмень мусіць быць штучна створаны. KernelTestCase //tests/Workflow/ExpenseApprovalWorkflowTest.php namespace App\Tests\Workflow; use App\Entity\ExpenseReport; use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase; use Symfony\Component\Workflow\WorkflowInterface; class ExpenseApprovalWorkflowTest extends KernelTestCase { private WorkflowInterface $workflow; protected function setUp(): void { self::bootKernel(); $container = static::getContainer(); $registry = $container->get('workflow.registry'); // We create a dummy subject to get the workflow // In a real app, passing the class name to the registry is preferred if supported, // or fetching by name directly if you have a custom service alias. $subject = new ExpenseReport('Test', 100.0); $this->workflow = $registry->get($subject, 'expense_approval'); } public function testWeightedApprovalFlow(): void { $expense = new ExpenseReport('MacBook Pro', 3000.00); // 1. Initial State $this->assertTrue($this->workflow->can($expense, 'submit')); $this->workflow->apply($expense, 'submit'); // Verify tokens: Should be in review_pool 3 times $marking = $expense->getCurrentState(); $this->assertArrayHasKey('review_pool', $marking); $this->assertEquals(3, $marking['review_pool'], 'Should have 3 pending reviews'); // 2. First Approval $this->assertTrue($this->workflow->can($expense, 'approve')); $this->workflow->apply($expense, 'approve'); $marking = $expense->getCurrentState(); $this->assertEquals(2, $marking['review_pool']); $this->assertEquals(1, $marking['approved_pool']); // Check that we CANNOT finalize yet (need 3 approvals) $this->assertFalse($this->workflow->can($expense, 'finalize'), 'Should not finalize with only 1 approval'); // 3. Second Approval $this->workflow->apply($expense, 'approve'); $marking = $expense->getCurrentState(); $this->assertEquals(1, $marking['review_pool']); $this->assertEquals(2, $marking['approved_pool']); // 4. Third Approval $this->workflow->apply($expense, 'approve'); $marking = $expense->getCurrentState(); // At this specific moment, review_pool is 0, approved_pool is 3 $this->assertEquals(0, $marking['review_pool'] ?? 0); $this->assertEquals(3, $marking['approved_pool']); // 5. Finalize $this->assertTrue($this->workflow->can($expense, 'finalize'), 'Should be able to finalize now'); $this->workflow->apply($expense, 'finalize'); // 6. Verify End State $marking = $expense->getCurrentState(); $this->assertArrayHasKey('ready_for_payment', $marking); $this->assertEquals(1, $marking['ready_for_payment']); // Previous tokens should be consumed $this->assertArrayNotHasKey('approved_pool', $marking); } } Запрашаем на выпрабаванне: php bin/phpunit tests/Workflow/ExpenseApprovalWorkflowTest.php Выкарыстанне і лепшая практыка Выкарыстанне энумаў для месцаў (Новае ў 7.4) Symfony 7.4 таксама дае падтрымку Backed Enums ў працэсах працы. «Трэба вызначыць тое, што ёсць. review_pool namespace App\Enum; enum ExpenseState: string { case DRAFT = 'draft'; case REVIEW_POOL = 'review_pool'; case APPROVED_POOL = 'approved_pool'; case READY = 'ready_for_payment'; case REJECTED = 'rejected'; } Вы можаце апублікаваць свой workflow.yaml (хоць YAML яшчэ выкарыстоўвае строкі, ваш PHP код можа выкарыстоўваць ) ExpenseState::REVIEW_POOL->value Вынікі пошуку - hollywood with weights Можа, вы хочаце зрабіць тое ж самае. Уступнае слова і пераклад Уладзіміра Правасуда. // Братэрства 87. Трэба выклікаць 3 разы, але рухавік працоўнага працэсу не ведае, хто яго заклікаў. person approve Для забеспячэння работы мікра-ГЭС, водны струмень мусіць быць штучна створаны. #[AsEventListener('workflow.expense_approval.guard.approve')] public function preventDoubleApproval(GuardEvent $event): void { /** @var ExpenseReport $expense */ $expense = $event->getSubject(); $user = $this->security->getUser(); // Imagine the entity has a list of who already approved if ($expense->hasApproved($user)) { $event->setBlocked(true, 'You have already approved this expense.'); } } Змяненне адказнасці (Token Cleanup) Наступным крокам з'яўляецца выбар адпаведнага абсталявання для кожнага з нас: , што адбываецца з двума токенамі, якія сядзяць у ? reject approved_pool Наступным крокам з'яўляецца выбар адпаведнага абсталявання для Можа быць, яны Токены ўплываюць (творём зомбі-стату, у якім паведамленне як адмовілася, так і часткова сцвярджаецца). rejected approved_pool І Пытанні, якія часта задаюць пра вегетарыянства Тым не менш, дынамічнае спажыванне не падтрымліваецца толькі ў YAML (вы не можаце сказаць "забыць усё"). reject all Выкарыстанне Event Subscriber на , Вы можаце ручна пераўтвараць маркераванне магазина. workflow.entered.rejected public function onRejected(Event $event): void { $expense = $event->getSubject(); // Force reset state to ONLY rejected $expense->setCurrentState(['rejected' => 1]); } Высновы Сцягнуць Symfony 7.4 Спадзяёмся, што матэрыяльная падтрымка будзе і з боку Міністэрства культуры, а таксама фонду краін СНД, цяпер складаем праграму, якую павязём у Маскву на ўзгадненне, будзем там адстойваць свае пазіцыі. Weighted Workflow Transitions Key Takeaways: Множыннасць: Места могуць захоўваць некалькі токенаў, што дазваляе паралельнае нагромаджванне дзяржавы. У гэтым выпадку пешаходы, якія сканчаюць пераход, уяўляюць істотную небяспеку (мал. Складанне: Забяспечыць, што свойства Маркіраванне Магазіну з'яўляецца маштабам (напрыклад, колонка JSON), каб прачытаць колькасць токенаў па месцы. Укладайце больш ва ўласную журналістыку, СМІ і змагайцеся за свабоду слова. Гэта выдатная платформа для выказвання маладымі людзьмі сваіх пазіцый, іх абмеркавання. Давайце будзем на доступе Яраслаў Грышчэня не супраць службы ў беларускім войску, але хвалюецца, што яго могуць падчас збору подпісаў “затрымаць” на невызначаны тэрмін, знайшоўшы “зручную” зачэпку. Давайце будзем у контакце — звяжыцеся са мной на LinkedIn ( ) працягваць размову аб сучаснай архітэктуры PHP. https://www.linkedin.com/in/matthew-mochalkin/ https://www.linkedin.com/in/matthew-mochalkin/