En esta charla hablé de: - cómo gestionamos un nuevo proyecto, - automatizamos el setup con Docker, - utilizamos los pipelines de Bitbucket para ejecutar los tests automáticamente - de cómo encapsulamos el dominio del proyecto con DDD. - y garantizamos la calidad y el correcto funcionamiento con TDD, La charla se enfoca desde un punto práctico, con ejemplos y mostrando aquellas partes que más problemas nos han dado y las soluciones que planteamos. Charla impartida en @phpmad en https://www.meetup.com/es-ES/PHPMad/events/246861723/

1. Learned lessons in a
real world project
Luis Rovirosa
@luisrovirosa
www.codium.team

2. About me
+10 years doing web
applications
Team transformations
Lean & Craftsmanship

3. Agenda
Context
How to deal with a new project
Automate everything
Domain at heart
Ensure quality

4. Context

5. 2 + 1 month project
2 part time developers
Green field project
Turn system
Context

6. How to deal with a
new project

7. There is no trust
We don’t know each other
Lack of business knowledge
Problems at beginning
Difficult to estimate

8. 10-100 pages
1+ requirement documents
All must be done
What we usually receive
Everything is important

9. User stories
Split into Sprints
Vertical slices
Our recipe: the Sprint 0
Prioritize / Reduce scope
Iterative

10. 2nd - Support final hardware
1st - Minimal functionality
1 CCU, 1 dispenser & 1 display.
No services | No printing real tickets
Neither users nor roles
3rd - Services + basic actions
How we broke it
4th - Roles & permissions

11. Learned lessons
Sprint 0 is the key
Simplify the problem
Prioritize
Deal with expectations

12. How we develop

13. Ensure quality
Automate everything
Domain at heart
How we develop

14. Automate everything

15. Automate infrastructure
Public docker images
Our own docker images
Docker-compose

16. Own docker image
// Dockerfile
FROM php:7.1-apache
# Dependencies
RUN docker-php-ext-install mysqli pdo pdo_mysql
RUN a2enmod rewrite
RUN curl -sS https://getcomposer.org/installer | php &&
mv composer.phar /usr/local/bin/composer
# Configuration
COPY apache.conf
/etc/apache2/sites-available/001-our-project.conf
RUN ln -s /etc/apache2/sites-available/001-our-project.conf
/etc/apache2/sites-enabled/
# Git and unzip to use composer
RUN apt-get update && apt-get install git unzip -y

17. Docker-compose
version: '3.3'
services:
webserver:
container_name: our_project_webserver
image: our-project-apache
build:
context: .
dockerfile: docker/apache/Dockerfile
volumes:
- .:/var/www/html
- ./vendor:/var/www/html/vendor:delegated

18. Automate test execution
// bitbucket-pipelines.yml
image: composer:latest
pipelines:
branches:
master:
- step:
caches:
- composer
script:
- composer install
- composer tests:unit
definitions:
caches:
composer: vendor

19. Automate commands
// Composer.json
"scripts": {
"server:code:update":[
"git pull",
"docker exec own-project_webserver
composer local:dependencies:update"
],
"local:dependencies:update":[
"composer install",
"composer local:database:update",
"composer local:cache:clear"
],

20. Learned lessons
Easy setup/update
Documentation
Double check on tests

21. Domain at heart

22. Ubiquitous language
Use Business names
Only 1 word for concept

23. Ubiquitous language

24. DDD
Framework
Application
Domain
Infrastructure

25. Framework Example
/**
* @Route("/callNextCustomer", name="call_next_customer")
*/
public function callNextCustomerAction(Request $request)
{
$deviceId = $request->get('deviceId');
/** @var CallNextCustomer $action */
$action = $this->container->get(CallNextCustomer::class);
$response = $action->execute(
new CallNextCustomerRequest($deviceId)
);
return new JsonResponse($response->turn());
}

26. Framework Example
/** @Route("/call_next_customer", name="call_next_customer")*/
public function callNextCustomerAction(Request $request)
{
return new JsonResponse(
$this->execute('call_next_customer_action', $request)
);
}
protected function execute(string $name, Request $request)
{
/** @var ActionSequence $action */
$action = $this->get($name);
return $action->execute($request);
}

27. Application Example
public function execute(Request $request): Response
{
/** @var CallNextCustomerRequest $request */
$device = $this->findDevice($request);
$turn = $this->findNextTurn($device);
$user = $this->findUser($request);
$this->markTurnAsCalled($turn, $device, $user);
$this->showOnDisplays($turn);
$this->notifyPendingCustomerStats();
return new CallNextCustomerResponse(
$turn->id(), $turn->value(), $turn->service()->id()
);
}

28. Domain Example
namespace MyProjectDomainModelUser;
interface UserRepository
{
public function save(User $user): void;
public function findById(string $id): User;
public function all(): Users;
}

29. First class collection
class Users extends ArrayCollection
{
public function canTalkTo(User $theUser): Users
{
// Code
}
public function orderByFullName(): Users
{
// Code
}
}

30. Decoupling Libraries
and Infrastructure
Domain Interface
Infrastructure implementation

31. // Message.Message.orm.yml
MyProjectDomainMessageMessage:
type: entity
table: message
id:
id:
type: string
fields:
fromUserId:
type: string
toUserId:
type: string
message:
type: string
Database mapping

32. Learned lessons
Simplifies the communication
Really decoupled
Increases complexity

33. Ensure quality

34. TDD Development
Different levels of testing
Test doubles manually

35. Acceptance tests

36. /** @test */
public function its_possible_to_access_the_counter
_call_unit_when_you_are_log_in()
{
$this->loginAsEmployee();
$this->makeGetRequest('/counter_call_unit');
$this->assertResponseIsSuccessful();
}
Framework tests

37. /** @test */
public function the_first_value_generated_is_1()
{
$generator = $this->aGenerator();
$nextValue = $generator->next();
$this->assertSame(1, $nextValue);
}
Unit tests

38. public function retrieve_a_persisted_device_using_its_id()
{
$repository = $this->getRepository();
$message = $this->createNewMessage();
$repository->save($message);
$theMessage = $repository->findById($message->id());
$this->assertEquals($message->id(), $theMessage->id());
}
abstract protected function getRepository();
Infrastructure tests

39. class InMemoryMessageRepository
implements MessageRepository
{
private $messages = [];
public function save(Message $message): void
{
$this->messages[$message->id()] = $message;
}
public function findById(string $id): Message
{
return $this->messages[$id];
}
}
Fake implementations

40. class DummyPrinter implements Printer
{
public function printTurn(Turn $turn): void
{
}
}
Dummy implementation

41. // services_test.yml
services:
MyProjectDomainMessageMessageRepository:
class: MyProjectInfrastructurePersistence
InMemoryInMemoryMessageRepository
MyProjectDomainPrinterPrinter:
class: TestsMyProjectDomainPrinterDummyPrinter
public: true
Test dependencies

42. Learned lessons
High confidence
Allows refactoring
Simplifies the code
Needs discipline

43. Take aways

44. Try to simplify the problem
Talk the business language
Automate from the beginning
Use different TDD strategies
Try some DDD patterns
Take aways

45. Thank you
Questions?
Luis Rovirosa
@luisrovirosa
www.codium.team