Learned lessons in a real world project
3 likes548 views
This document summarizes lessons learned from a 2-month project with 2 part-time developers. It discusses automating infrastructure with Docker and Docker Compose, ensuring quality with testing practices like TDD and acceptance tests, and keeping the domain model at the heart of the project using DDD principles. Automation provides easy setup and updates but must be double checked. TDD allows for refactoring and simplifies code. DDD simplifies communication but increases complexity. Going deeper requires a focus on software craftsmanship.
![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"
],](https://image.slidesharecdn.com/learnedlessonsinarealworldproject-171115073932/85/Learned-lessons-in-a-real-world-project-12-320.jpg)
![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](https://image.slidesharecdn.com/learnedlessonsinarealworldproject-171115073932/85/Learned-lessons-in-a-real-world-project-19-320.jpg)
Learned lessons in a real world project
- 1. Learned lessons in a real world project Luis Rovirosa @luisrovirosa www.codium.team
- 3. Context
- 4. 2 month project 2 part time developers Green field project Context PHP
- 5. Automate everything Vertical slices Always working software Vision Decoupled code
- 7. Automate infrastructure Public docker images Our own docker images Docker-compose
- 8. 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
- 9. 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 network_mode: "host" restart: unless-stopped
- 11. 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
- 12. 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" ],
- 13. Ensure quality
- 14. Acceptance tests Unit testing Infrastructure tests Test doubles TDD Development
- 15. Acceptance tests
- 16. /** @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
- 17. /** @test */ public function the_first_value_generated_is_1() { $generator = $this->aGenerator(); $nextValue = $generator->next(); $this->assertSame(1, $nextValue); } Unit tests
- 18. public function retrieve_a_persisted_device_using_its_id() { $repository = $this->getRepository(); $message = $this->createNewEmail(); $repository->save($message); $theMessage = $repository->findById($message->id()); $this->assertEquals($message->id(), $theMessage->id()); } abstract protected function getRepository(); Infrastructure tests
- 19. 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
- 20. class DummyPrinter implements Printer { public function printTurn(Turn $turn): void { } } Dummy implementation
- 21. // services_test.yml services: MyProjectDomainMessageMessageRepository: class: MyProjectInfrastructurePersistence InMemoryInMemoryMessageRepository MyProjectDomainPrinterPrinter: class: TestsMyProjectDomainPrinterDummyPrinter public: true Test dependencies
- 22. Domain at heart
- 23. Ubiquitous language Use Business names Only 1 word for concept
- 25. // 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
- 26. Learned lessons
- 28. TDD High confidence Allows refactoring Simplifies the code
- 29. DDD Simplifies the communication Really decoupled Increases complexity