Cocoders Flow czyli jak staramy się modelować i tworzyć aplikacje webowe.

Kim jesteśmy?

Jak zaczynamy modelowanie aplikacji?

BIZNES i jego cele!

Hipotetyczny klient Klient który posiada trzy placówki medyczne, chce systemu do zarządzania tymi placówkami

Po ustaleniach z klientem dochodzimy do takiej historyjki...

As a receptionist in the clinic, I would like arrange a visit without worrying about whether patient is insured so I should be able check such information in the system instead of calling insurance company

Ilustrowanie historyjki przykładami

Przykład 1 – pacjent bez ubezpieczenia Scenario: Checking information for patient without insurance Given I am receptionist in the clinic And patient does not have medical insurance When I am find and open that patient case Then I should see that the patient can not be scheduled for a medical visit because he is not insured

Przykład 2 – ubezpieczony pacjent Scenario: Checking information for patient with insurance Given I am receptionist in the clinic And patient has medical insurance When I am find and open that patient case Then I should see that the patient can be scheduled for a medical visit

No dobra ale mieliśmy gadać o kodzie!!

Kandydaci na nasze obiekty domeny Scenario: Checking information for patient without insurance Given I am receptionist in the clinic And patient does not have medical insurance When I am find and open that patient case Then I should see that the patient can not be scheduled for a medical visit because he is not insured

Jak przełożyć zdania na obiekty w PHP-ie?

BEHAT Tłumaczy nam na przykład zdanie “Given I am receptionist in the clinic” na kod w PHP-ie

BEHAT class FeatureContext implements Context { /** * @Given I am receptionist in the clinic */ public function iAmReceptionistInTheClinic() { //tutaj jakiś mój kod } }

Kandydaci na nasze obiekty domeny – Placówka Scenario: Checking information for patient without insurance Given I am receptionist in the clinic And patient does not have medical insurance When I am find and open that patient case Then I should see that the patient can not be scheduled for a medical visit because he is not insured

Modelowanie domeny class FeatureContext implements Context { public function __construct() { $this->clinic = new Clinic(); } }

Modelowanie domeny /** * @Given I am receptionist in the clinic */ public function iAmReceptionistInTheClinic() { $this->clinic->hireReceptionist( $firstName = 'Jan', $lastName = 'Kowalski', $idNumber = '80081012345' ); }

Modelowanie domeny /** * @Given I am receptionist in the clinic */ public function iAmReceptionistInTheClinic() { $this->clinic->hireEmployee( new Receptionist( $firstName = 'Jan', $lastName = 'Kowalski', $idNumber = '80081012345' ) ); }

Modelowanie domeny Co jest nam potrzebne do utworzenia obiektu “Clinic”? Jakie dane są nam potrzebne i po co są nam potrzebne?

Modelowanie domeny $this->clinic = new Clinic( 'Clinic name', new Address( $postalCode = '80-283', $city = 'Gdańsk', $street = 'Królewskie Wzgórze' ), new TaxIdentificationNumber('123-456-32-18'), new NationalEconomyRegisterNumber('123456785') ) ;

Hermetyzacja modelu – anemic model $this->clinic = new Clinic(); $this->clinic->setPostalCode('80-283'); $this->clinic->setCity('Gdańsk'); $this->clinic->setStreet('Królewskie Wzgórze'); $this->clinic->setTaxIdNumber('123-456-32-18'); $this ->clinic ->setNationalEconomyRegisterNumber('123456785') ;

Utworzyliśmy podstawowy model. Teraz czas na aplikacje!

Modelowanie aplikacji – od modelu do aplikacji $this->clinic = new Clinic( 'Clinic name', new Address( $postalCode = '80-283', $city = 'Gdańsk', $street = 'Królewskie Wzgórze' ), new TaxIdentificationNumber('123-456-32-18'), new NationalEconomyRegisterNumber('123456785') ) ; //tutaj musimy zapisać placówke w bazie

Modelowanie aplikacji – abstrakcja oraz porty namespace Cocoders\MedicalClinic; interface ClinicRegistry { public function add(Clinic $clinic); public function find( Clinic\TaxIdentificationNumber $taxIdentificationNumber ); }

Modelowanie aplikacji – od modelu do aplikacji $clinicRegistry = new InMemory\ClinicRegistry() $this->clinic = new Clinic( 'Clinic name', new Address( $postalCode = '80-283', $city = 'Gdańsk', $street = 'Królewskie Wzgórze' ), new TaxIdentificationNumber('123-456-32-18'), new NationalEconomyRegisterNumber('123456785') ) ; $clinicRegistry->add($this->clinic);

Modelowanie aplikacji – przykładowy przypadek użycia use Cocoders\MedicalClinic\ClinicRegistry; class SettingUpClinic { /** * @var ClinicRegistry */ private $registry; public function __construct(ClinicRegistry $registry) { $this->registry = $registry; } public function execute(SettingUpClinic\Command $command) }

class SettingUpClinic { public function execute(SettingUpClinic\Command $command) { $services = array_map(function ($serviceName) { return new Clinic\Service($serviceName); }, $command->services); $clinic = new Clinic( $command->name, new Clinic\Address( $command->postalCode, $command->city, $command->street ), $services, new Clinic\TaxIdentificationNumber($command->taxIdNumber), new Clinic\NationalEconomyRegisterNumber( $command->nationalRegistryNumber ) ); $this->registry->add($clinic); }

Modelowanie aplikacji – od modelu do aplikacji $clinicRegistry = new InMemory\ClinicRegistry(); $settingUpClinic = new SettingUpClinic($clinicRegistry); $settingUpClinic->execute(new SettingUpClinic\Command( $name = 'Clinic name', $postalCode = '80-283', $city = 'Gdańsk', $street = 'Królewskie Wzgórze', $services = [ 'MRI', 'CT' ], $taxIdNumber = '123-456-32-18', $nationalRegistryNumber= '123456785' ));

No content

Modelowanie aplikacji – następny przypadek użycia class FeatureContext implements Context { public function __construct() { // settingUpClinic use case $this->hireReceptionist = new HireReceptionist( $this->clinicRegistry ); } }

Modelowanie aplikacji – następny przypadek użycia /** * @Given I am receptionist in the clinic */ public function iAmReceptionistInTheClinic() { $this->hireReceptionist->execute( new HireReceptionist\Command( $taxIdNumber = '123-456-32-18', $firstName = 'Jan', $lastName = 'Kowalski', $idNumber = '80081012345' ) ); }

Integracja z frameworkiem – Doctrine w Symfony doctrine: dbal: #... orm: entity_managers: default: auto_mapping: true mappings: MedicalClinic: type: yml dir: %kernel.root_dir %/../src/Cocoders/Adapters/Doctrine/ORM/mapping/MedicalCli nic prefix: Cocoders\MedicalClinic is_bundle: false

use Cocoders\MedicalClinic\ClinicRegistry as ClinicRegistryInterface; use Doctrine\Common\Persistence\ObjectManager; class ClinicRegistry implements ClinicRegistryInterface { private $manager; public function __construct(ObjectManager $manager) { $this->manager = $manager; } public function add(Clinic $clinic) { $this->manager->persist($clinic); $this->manager->flush($clinic); } public function find(Clinic\TaxIdentificationNumber $taxIdentificationNumber) { return $this ->manager ->getRepository(Clinic::class) ->findOneBy(['taxNumber' => (string) $taxIdentificationNumber]) ; }

Integracja z frameworkiem – Symfony DIC services: cocoders.medical_clinic.clinic_registry: class: Cocoders\Adapters\Doctrine\ClinicRegistry arguments: ["@doctrine.orm.default_entity_manager"] cocoders.medical_clinic.use_case.setting_up_clinic: class: Cocoders\MedicalClinic\UseCase\SettingUpClinic arguments: ["@cocoders.medical_clinic.clinic_registry"] cocoders.medical_clinic.use_case.hire_receptionist: class: Cocoders\MedicalClinic\UseCase\HireReceptionist arguments: ["@cocoders.medical_clinic.clinic_registry"]

Integracja z frameworkiem – Kontroler /** * @Route("/clinic/{taxNumber}/receptionist") * @Method({"GET", "POST"}) */ public function hireReceptionistAction(Clinic $clinic, Request $request) { $form = $this->createForm(new HireReceptionistFormType()); $form->handleRequest($request); if ($form->isValid()) { $this ->get('cocoders.medical_clinic.use_case.hire_receptionist') ->execute(new HireReceptionist\Command( (string) $clinic->getTaxIdNumber(), $form->get('firstName')->getData(), $form->get('lastName')->getData(), $form->get('idNumber')->getData() )); //return $this->redirectToRoute() } //return $this->render() }

Legacy code a takie podejście

Plusy

Minusy

To by było na tyle! Pytania?

@skowii @l3l0 @cocoders https://github.com/cocoders/playground http://cocoders.com