├── settings.gradle ├── .gitignore ├── DDD-Workshop.pptx ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── src ├── main │ └── java │ │ ├── com │ │ └── github │ │ │ └── mkopylec │ │ │ └── projectmanager │ │ │ ├── domain │ │ │ └── exceptions │ │ │ │ ├── ErrorCode.java │ │ │ │ ├── InvalidEntityException.java │ │ │ │ ├── MissingEntityException.java │ │ │ │ ├── EntityAlreadyExistsException.java │ │ │ │ ├── DomainException.java │ │ │ │ └── PreCondition.java │ │ │ ├── ApplicationStarter.java │ │ │ └── infrastructure │ │ │ └── error │ │ │ ├── ErrorMessage.java │ │ │ └── ErrorHandler.java │ │ └── layers │ │ ├── domain │ │ ├── services │ │ │ ├── VinProvider.java │ │ │ └── OrderFinalizer.java │ │ ├── order │ │ │ ├── RebateCalculator.java │ │ │ ├── OrderFactory.java │ │ │ ├── StudentRebateCalculator.java │ │ │ ├── WeekendRebateCalculator.java │ │ │ └── Order.java │ │ ├── car │ │ │ ├── CarRepository.java │ │ │ ├── CarSold.java │ │ │ ├── CarFactory.java │ │ │ └── Car.java │ │ └── values │ │ │ └── CarType.java │ │ ├── infrastructure │ │ ├── services │ │ │ ├── SoldCarsReporter.java │ │ │ └── ExternalSystemVinProvider.java │ │ └── persistence │ │ │ └── MongoDbCarRepository.java │ │ ├── application │ │ ├── dto │ │ │ ├── BuyResult.java │ │ │ └── NewCar.java │ │ └── CarService.java │ │ └── api │ │ └── CarController.java └── test │ └── groovy │ └── com │ └── github │ └── mkopylec │ └── projectmanager │ └── BasicSpecification.groovy ├── gradlew.bat ├── gradlew ├── README.md └── LICENSE /settings.gradle: -------------------------------------------------------------------------------- 1 | rootProject.name = 'project-manager' 2 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .idea 2 | .gradle 3 | build 4 | classes 5 | out 6 | *.iml 7 | -------------------------------------------------------------------------------- /DDD-Workshop.pptx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/mkopylec/project-manager/HEAD/DDD-Workshop.pptx -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/mkopylec/project-manager/HEAD/gradle/wrapper/gradle-wrapper.jar -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/domain/exceptions/ErrorCode.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager.domain.exceptions; 2 | 3 | public enum ErrorCode { 4 | 5 | UNEXPECTED_ERROR 6 | } -------------------------------------------------------------------------------- /src/main/java/layers/domain/services/VinProvider.java: -------------------------------------------------------------------------------- 1 | package layers.domain.services; 2 | 3 | /** 4 | * Domain service 5 | */ 6 | public interface VinProvider { 7 | 8 | String getVin(String licencePlates); 9 | } 10 | -------------------------------------------------------------------------------- /gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | distributionBase=GRADLE_USER_HOME 2 | distributionPath=wrapper/dists 3 | distributionUrl=https\://services.gradle.org/distributions/gradle-4.7-bin.zip 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/order/RebateCalculator.java: -------------------------------------------------------------------------------- 1 | package layers.domain.order; 2 | 3 | import java.math.BigDecimal; 4 | 5 | /** 6 | * Policy 7 | */ 8 | public interface RebateCalculator { 9 | 10 | BigDecimal calculateRebate(BigDecimal stockPrise); 11 | } 12 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/order/OrderFactory.java: -------------------------------------------------------------------------------- 1 | package layers.domain.order; 2 | 3 | import static java.math.BigDecimal.ZERO; 4 | 5 | public class OrderFactory { 6 | 7 | public Order createOrder(String identifier) { 8 | return new Order(identifier, ZERO); 9 | } 10 | } 11 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/car/CarRepository.java: -------------------------------------------------------------------------------- 1 | package layers.domain.car; 2 | 3 | import java.util.List; 4 | 5 | /** 6 | * Repository 7 | */ 8 | public interface CarRepository { 9 | 10 | Car findByVin(String vin); 11 | 12 | List findAll(); 13 | 14 | void save(Car car); 15 | } 16 | -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/domain/exceptions/InvalidEntityException.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager.domain.exceptions; 2 | 3 | public class InvalidEntityException extends DomainException { 4 | 5 | InvalidEntityException(String message, ErrorCode code) { 6 | super(message, code); 7 | } 8 | } -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/domain/exceptions/MissingEntityException.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager.domain.exceptions; 2 | 3 | public class MissingEntityException extends DomainException { 4 | 5 | MissingEntityException(String message, ErrorCode code) { 6 | super(message, code); 7 | } 8 | } -------------------------------------------------------------------------------- /src/main/java/layers/domain/car/CarSold.java: -------------------------------------------------------------------------------- 1 | package layers.domain.car; 2 | 3 | /** 4 | * Domain event 5 | */ 6 | public class CarSold { 7 | 8 | private String vin; 9 | 10 | CarSold(String vin) { 11 | this.vin = vin; 12 | } 13 | 14 | public String getVin() { 15 | return vin; 16 | } 17 | } 18 | -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/domain/exceptions/EntityAlreadyExistsException.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager.domain.exceptions; 2 | 3 | public class EntityAlreadyExistsException extends DomainException { 4 | 5 | EntityAlreadyExistsException(String message, ErrorCode code) { 6 | super(message, code); 7 | } 8 | } -------------------------------------------------------------------------------- /src/main/java/layers/infrastructure/services/SoldCarsReporter.java: -------------------------------------------------------------------------------- 1 | package layers.infrastructure.services; 2 | 3 | import layers.domain.car.CarSold; 4 | import org.springframework.context.event.EventListener; 5 | 6 | /** 7 | * Domain event listener 8 | */ 9 | class SoldCarsReporter { 10 | 11 | @EventListener 12 | public void reportSoldCar(CarSold carSold) { 13 | 14 | } 15 | } 16 | -------------------------------------------------------------------------------- /src/main/java/layers/infrastructure/services/ExternalSystemVinProvider.java: -------------------------------------------------------------------------------- 1 | package layers.infrastructure.services; 2 | 3 | import layers.domain.services.VinProvider; 4 | 5 | /** 6 | * Domain service implementation 7 | */ 8 | class ExternalSystemVinProvider implements VinProvider { 9 | 10 | @Override 11 | public String getVin(String licencePlates) { 12 | return null; 13 | } 14 | } 15 | -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/ApplicationStarter.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager; 2 | 3 | import org.springframework.boot.autoconfigure.SpringBootApplication; 4 | 5 | import static org.springframework.boot.SpringApplication.run; 6 | 7 | @SpringBootApplication 8 | public class ApplicationStarter { 9 | 10 | public static void main(String[] args) { 11 | run(ApplicationStarter.class, args); 12 | } 13 | } 14 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/order/StudentRebateCalculator.java: -------------------------------------------------------------------------------- 1 | package layers.domain.order; 2 | 3 | import java.math.BigDecimal; 4 | 5 | import static java.math.BigDecimal.valueOf; 6 | 7 | /** 8 | * Policy variant 9 | */ 10 | public class StudentRebateCalculator implements RebateCalculator { 11 | 12 | @Override 13 | public BigDecimal calculateRebate(BigDecimal stockPrise) { 14 | return stockPrise.multiply(valueOf(0.1)); 15 | } 16 | } 17 | -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/infrastructure/error/ErrorMessage.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager.infrastructure.error; 2 | 3 | import com.github.mkopylec.projectmanager.domain.exceptions.ErrorCode; 4 | 5 | class ErrorMessage { 6 | 7 | private ErrorCode code; 8 | 9 | ErrorMessage(ErrorCode code) { 10 | this.code = code; 11 | } 12 | 13 | public ErrorCode getCode() { 14 | return code; 15 | } 16 | } -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/domain/exceptions/DomainException.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager.domain.exceptions; 2 | 3 | public abstract class DomainException extends RuntimeException { 4 | 5 | private ErrorCode code; 6 | 7 | DomainException(String message, ErrorCode code) { 8 | super(message); 9 | this.code = code; 10 | } 11 | 12 | public ErrorCode getCode() { 13 | return code; 14 | } 15 | } -------------------------------------------------------------------------------- /src/main/java/layers/application/dto/BuyResult.java: -------------------------------------------------------------------------------- 1 | package layers.application.dto; 2 | 3 | /** 4 | * Data transfer object 5 | */ 6 | public class BuyResult { 7 | 8 | private String carVin; 9 | private boolean bought; 10 | 11 | public String getCarVin() { 12 | return carVin; 13 | } 14 | 15 | public void setCarVin(String carVin) { 16 | this.carVin = carVin; 17 | } 18 | 19 | public boolean isBought() { 20 | return bought; 21 | } 22 | 23 | public void setBought(boolean bought) { 24 | this.bought = bought; 25 | } 26 | } 27 | -------------------------------------------------------------------------------- /src/main/java/layers/infrastructure/persistence/MongoDbCarRepository.java: -------------------------------------------------------------------------------- 1 | package layers.infrastructure.persistence; 2 | 3 | import layers.domain.car.Car; 4 | import layers.domain.car.CarRepository; 5 | 6 | import java.util.List; 7 | 8 | /** 9 | * Repository implementation 10 | */ 11 | class MongoDbCarRepository implements CarRepository { 12 | 13 | @Override 14 | public Car findByVin(String vin) { 15 | return null; 16 | } 17 | 18 | @Override 19 | public List findAll() { 20 | return null; 21 | } 22 | 23 | @Override 24 | public void save(Car car) { 25 | 26 | } 27 | } 28 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/services/OrderFinalizer.java: -------------------------------------------------------------------------------- 1 | package layers.domain.services; 2 | 3 | import layers.domain.car.Car; 4 | import layers.domain.order.Order; 5 | import org.springframework.context.ApplicationEventPublisher; 6 | 7 | /** 8 | * Domain service 9 | */ 10 | public class OrderFinalizer { 11 | 12 | private ApplicationEventPublisher publisher; 13 | 14 | public OrderFinalizer(ApplicationEventPublisher publisher) { 15 | this.publisher = publisher; 16 | } 17 | 18 | public void finalizeOrder(Order order, Car car) { 19 | car.sell(publisher); 20 | order.fulfill(); 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/car/CarFactory.java: -------------------------------------------------------------------------------- 1 | package layers.domain.car; 2 | 3 | import layers.domain.services.VinProvider; 4 | import layers.domain.values.CarType; 5 | 6 | import java.time.ZonedDateTime; 7 | 8 | /** 9 | * Factory 10 | */ 11 | public class CarFactory { 12 | 13 | private VinProvider vinProvider; 14 | 15 | public CarFactory(VinProvider vinProvider) { 16 | this.vinProvider = vinProvider; 17 | } 18 | 19 | public Car createCar(String licencePlates, String brand, ZonedDateTime productionDate) { 20 | String vin = vinProvider.getVin(licencePlates); 21 | CarType type = new CarType(brand, null); 22 | return new Car(vin, productionDate, type, false); 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /src/main/java/layers/api/CarController.java: -------------------------------------------------------------------------------- 1 | package layers.api; 2 | 3 | import layers.application.CarService; 4 | import layers.application.dto.BuyResult; 5 | import layers.application.dto.NewCar; 6 | import org.springframework.web.bind.annotation.PostMapping; 7 | import org.springframework.web.bind.annotation.RestController; 8 | 9 | /** 10 | * API 11 | */ 12 | @RestController 13 | public class CarController { 14 | 15 | private CarService carService; 16 | 17 | @PostMapping("/car") 18 | public void addNewCar(NewCar newCar) { 19 | carService.addNewCar(newCar); 20 | } 21 | 22 | @PostMapping("/car/buy") 23 | public BuyResult buyCar(String vin) { 24 | return carService.buyCar(vin); 25 | } 26 | } 27 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/values/CarType.java: -------------------------------------------------------------------------------- 1 | package layers.domain.values; 2 | 3 | import static org.apache.commons.lang3.StringUtils.isNotBlank; 4 | 5 | /** 6 | * Value object 7 | */ 8 | public class CarType { 9 | 10 | private String brand; 11 | private String model; 12 | 13 | public CarType(String brand, String model) { 14 | this.brand = brand; 15 | this.model = model; 16 | } 17 | 18 | public String getBrand() { 19 | return brand; 20 | } 21 | 22 | public String getModel() { 23 | return model; 24 | } 25 | 26 | public boolean hasModel() { 27 | return isNotBlank(model); 28 | } 29 | 30 | public CarType changeModel(String model) { 31 | return new CarType(brand, model); 32 | } 33 | } 34 | -------------------------------------------------------------------------------- /src/main/java/layers/application/dto/NewCar.java: -------------------------------------------------------------------------------- 1 | package layers.application.dto; 2 | 3 | import java.time.ZonedDateTime; 4 | 5 | public class NewCar { 6 | 7 | private String licencePlates; 8 | private String brand; 9 | private ZonedDateTime productionDate; 10 | 11 | public NewCar(String licencePlates, String brand, ZonedDateTime productionDate) { 12 | this.licencePlates = licencePlates; 13 | this.brand = brand; 14 | this.productionDate = productionDate; 15 | } 16 | 17 | public String getLicencePlates() { 18 | return licencePlates; 19 | } 20 | 21 | public String getBrand() { 22 | return brand; 23 | } 24 | 25 | public ZonedDateTime getProductionDate() { 26 | return productionDate; 27 | } 28 | } 29 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/order/WeekendRebateCalculator.java: -------------------------------------------------------------------------------- 1 | package layers.domain.order; 2 | 3 | import java.math.BigDecimal; 4 | import java.time.DayOfWeek; 5 | 6 | import static java.math.BigDecimal.ZERO; 7 | import static java.math.BigDecimal.valueOf; 8 | import static java.time.DayOfWeek.SATURDAY; 9 | import static java.time.DayOfWeek.SUNDAY; 10 | import static java.time.ZonedDateTime.now; 11 | 12 | /** 13 | * Policy variant 14 | */ 15 | public class WeekendRebateCalculator implements RebateCalculator { 16 | 17 | @Override 18 | public BigDecimal calculateRebate(BigDecimal stockPrise) { 19 | return isWeekend() ? stockPrise.multiply(valueOf(0.05)) : ZERO; 20 | } 21 | 22 | private boolean isWeekend() { 23 | DayOfWeek day = now().getDayOfWeek(); 24 | return day == SATURDAY || day == SUNDAY; 25 | } 26 | } 27 | -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/domain/exceptions/PreCondition.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager.domain.exceptions; 2 | 3 | import java.util.function.Supplier; 4 | 5 | public class PreCondition { 6 | 7 | private boolean condition; 8 | 9 | private PreCondition(boolean condition) { 10 | this.condition = condition; 11 | } 12 | 13 | public static PreCondition when(boolean condition) { 14 | return new PreCondition(condition); 15 | } 16 | 17 | public void thenInvalidEntity(ErrorCode code, String message) { 18 | thenThrow(() -> new InvalidEntityException(message, code)); 19 | } 20 | 21 | public void thenEntityAlreadyExists(ErrorCode code, String message) { 22 | thenThrow(() -> new EntityAlreadyExistsException(message, code)); 23 | } 24 | 25 | public void thenMissingEntity(ErrorCode code, String message) { 26 | thenThrow(() -> new MissingEntityException(message, code)); 27 | } 28 | 29 | private void thenThrow(Supplier exceptionCreator) { 30 | if (condition) { 31 | throw exceptionCreator.get(); 32 | } 33 | } 34 | } -------------------------------------------------------------------------------- /src/main/java/layers/application/CarService.java: -------------------------------------------------------------------------------- 1 | package layers.application; 2 | 3 | import layers.application.dto.BuyResult; 4 | import layers.application.dto.NewCar; 5 | import layers.domain.car.Car; 6 | import layers.domain.car.CarFactory; 7 | import layers.domain.car.CarRepository; 8 | import layers.domain.order.Order; 9 | import layers.domain.order.OrderFactory; 10 | import layers.domain.services.OrderFinalizer; 11 | 12 | /** 13 | * Application service 14 | */ 15 | public class CarService { 16 | 17 | private CarFactory carFactory; 18 | private CarRepository carRepository; 19 | private OrderFactory orderFactory; 20 | private OrderFinalizer orderFinalizer; 21 | 22 | public void addNewCar(NewCar newCar) { 23 | Car car = carFactory.createCar(newCar.getLicencePlates(), newCar.getBrand(), newCar.getProductionDate()); 24 | carRepository.save(car); 25 | } 26 | 27 | public BuyResult buyCar(String vin) { 28 | Car car = carRepository.findByVin(vin); 29 | Order order = orderFactory.createOrder("order-id"); 30 | orderFinalizer.finalizeOrder(order, car); 31 | return new BuyResult(); 32 | } 33 | } 34 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/order/Order.java: -------------------------------------------------------------------------------- 1 | package layers.domain.order; 2 | 3 | import java.math.BigDecimal; 4 | 5 | import static java.math.BigDecimal.ZERO; 6 | import static org.apache.commons.lang3.StringUtils.isBlank; 7 | 8 | /** 9 | * Entity 10 | */ 11 | public class Order { 12 | 13 | private String identifier; 14 | private boolean fulfilled; 15 | private BigDecimal price; 16 | 17 | Order(String identifier, BigDecimal price) { 18 | validateIdentifier(identifier); 19 | validateIdentifier(price); 20 | this.identifier = identifier; 21 | this.price = price; 22 | this.fulfilled = false; 23 | } 24 | 25 | public String getIdentifier() { 26 | return identifier; 27 | } 28 | 29 | public void fulfill() { 30 | fulfilled = true; 31 | } 32 | 33 | public boolean isFulfilled() { 34 | return fulfilled; 35 | } 36 | 37 | public void calculateFinalPrice(RebateCalculator rebateCalculator) { 38 | price = price.subtract(rebateCalculator.calculateRebate(price)); 39 | } 40 | 41 | public BigDecimal getPrice() { 42 | return price; 43 | } 44 | 45 | private void validateIdentifier(String identifier) { 46 | if (isBlank(identifier)) { 47 | throw new IllegalArgumentException("Empty order's identifier"); 48 | } 49 | } 50 | 51 | private void validateIdentifier(BigDecimal price) { 52 | if (price == null) { 53 | throw new IllegalArgumentException("Empty order's price"); 54 | } 55 | if (price.compareTo(ZERO) < 0) { 56 | throw new IllegalArgumentException("Invalid order's price"); 57 | } 58 | } 59 | } 60 | -------------------------------------------------------------------------------- /src/main/java/layers/domain/car/Car.java: -------------------------------------------------------------------------------- 1 | package layers.domain.car; 2 | 3 | import layers.domain.values.CarType; 4 | import org.springframework.context.ApplicationEventPublisher; 5 | 6 | import java.time.ZonedDateTime; 7 | 8 | import static java.time.ZoneOffset.UTC; 9 | import static java.time.ZonedDateTime.of; 10 | import static org.apache.commons.lang3.StringUtils.isBlank; 11 | 12 | /** 13 | * Entity 14 | */ 15 | public class Car { 16 | 17 | private String vin; 18 | private ZonedDateTime productionDate; 19 | private CarType type; 20 | private boolean sold; 21 | 22 | Car(String vin, ZonedDateTime productionDate, CarType type, boolean sold) { 23 | validateVin(vin); 24 | validateCarType(type); 25 | validateProductionDate(productionDate); 26 | this.vin = vin; 27 | this.productionDate = productionDate; 28 | this.type = type; 29 | this.sold = sold; 30 | } 31 | 32 | public boolean hasVin(String vin) { 33 | return this.vin.equals(vin); 34 | } 35 | 36 | public boolean isAntique() { 37 | return productionDate.isBefore(of(1980, 1, 1, 1, 1, 1, 1, UTC)); 38 | } 39 | 40 | public CarType getType() { 41 | return type; 42 | } 43 | 44 | public void changeType(CarType type) { 45 | validateCarType(type); 46 | this.type = type; 47 | } 48 | 49 | public void sell(ApplicationEventPublisher publisher) { 50 | sold = true; 51 | CarSold event = new CarSold(vin); 52 | publisher.publishEvent(event); 53 | } 54 | 55 | private void validateVin(String vin) { 56 | if (isBlank(vin)) { 57 | throw new IllegalArgumentException("Empty VIN"); 58 | } 59 | } 60 | 61 | private void validateCarType(CarType type) { 62 | if (type == null) { 63 | throw new IllegalArgumentException("Empty car type"); 64 | } 65 | } 66 | 67 | private void validateProductionDate(ZonedDateTime productionDate) { 68 | if (productionDate == null) { 69 | throw new IllegalArgumentException("Empty car production date"); 70 | } 71 | } 72 | } 73 | -------------------------------------------------------------------------------- /gradlew.bat: -------------------------------------------------------------------------------- 1 | @if "%DEBUG%" == "" @echo off 2 | @rem ########################################################################## 3 | @rem 4 | @rem Gradle startup script for Windows 5 | @rem 6 | @rem ########################################################################## 7 | 8 | @rem Set local scope for the variables with windows NT shell 9 | if "%OS%"=="Windows_NT" setlocal 10 | 11 | set DIRNAME=%~dp0 12 | if "%DIRNAME%" == "" set DIRNAME=. 13 | set APP_BASE_NAME=%~n0 14 | set APP_HOME=%DIRNAME% 15 | 16 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 17 | set DEFAULT_JVM_OPTS= 18 | 19 | @rem Find java.exe 20 | if defined JAVA_HOME goto findJavaFromJavaHome 21 | 22 | set JAVA_EXE=java.exe 23 | %JAVA_EXE% -version >NUL 2>&1 24 | if "%ERRORLEVEL%" == "0" goto init 25 | 26 | echo. 27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 28 | echo. 29 | echo Please set the JAVA_HOME variable in your environment to match the 30 | echo location of your Java installation. 31 | 32 | goto fail 33 | 34 | :findJavaFromJavaHome 35 | set JAVA_HOME=%JAVA_HOME:"=% 36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe 37 | 38 | if exist "%JAVA_EXE%" goto init 39 | 40 | echo. 41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 42 | echo. 43 | echo Please set the JAVA_HOME variable in your environment to match the 44 | echo location of your Java installation. 45 | 46 | goto fail 47 | 48 | :init 49 | @rem Get command-line arguments, handling Windows variants 50 | 51 | if not "%OS%" == "Windows_NT" goto win9xME_args 52 | 53 | :win9xME_args 54 | @rem Slurp the command line arguments. 55 | set CMD_LINE_ARGS= 56 | set _SKIP=2 57 | 58 | :win9xME_args_slurp 59 | if "x%~1" == "x" goto execute 60 | 61 | set CMD_LINE_ARGS=%* 62 | 63 | :execute 64 | @rem Setup the command line 65 | 66 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar 67 | 68 | @rem Execute Gradle 69 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% 70 | 71 | :end 72 | @rem End local scope for the variables with windows NT shell 73 | if "%ERRORLEVEL%"=="0" goto mainEnd 74 | 75 | :fail 76 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of 77 | rem the _cmd.exe /c_ return code! 78 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 79 | exit /b 1 80 | 81 | :mainEnd 82 | if "%OS%"=="Windows_NT" endlocal 83 | 84 | :omega 85 | -------------------------------------------------------------------------------- /src/main/java/com/github/mkopylec/projectmanager/infrastructure/error/ErrorHandler.java: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager.infrastructure.error; 2 | 3 | import com.github.mkopylec.projectmanager.domain.exceptions.DomainException; 4 | import com.github.mkopylec.projectmanager.domain.exceptions.EntityAlreadyExistsException; 5 | import com.github.mkopylec.projectmanager.domain.exceptions.ErrorCode; 6 | import com.github.mkopylec.projectmanager.domain.exceptions.InvalidEntityException; 7 | import com.github.mkopylec.projectmanager.domain.exceptions.MissingEntityException; 8 | import org.slf4j.Logger; 9 | import org.springframework.http.HttpStatus; 10 | import org.springframework.http.ResponseEntity; 11 | import org.springframework.web.bind.annotation.ExceptionHandler; 12 | import org.springframework.web.bind.annotation.RestControllerAdvice; 13 | 14 | import javax.servlet.http.HttpServletRequest; 15 | 16 | import static com.github.mkopylec.projectmanager.domain.exceptions.ErrorCode.UNEXPECTED_ERROR; 17 | import static org.slf4j.LoggerFactory.getLogger; 18 | import static org.springframework.http.HttpStatus.INTERNAL_SERVER_ERROR; 19 | import static org.springframework.http.HttpStatus.NOT_FOUND; 20 | import static org.springframework.http.HttpStatus.UNPROCESSABLE_ENTITY; 21 | import static org.springframework.http.ResponseEntity.status; 22 | 23 | @RestControllerAdvice 24 | class ErrorHandler { 25 | 26 | private static final Logger log = getLogger(ErrorHandler.class); 27 | 28 | @ExceptionHandler(EntityAlreadyExistsException.class) 29 | public ResponseEntity handleEntityAlreadyExistsException(EntityAlreadyExistsException ex, HttpServletRequest request) { 30 | return handleDomainException(ex, request, UNPROCESSABLE_ENTITY); 31 | } 32 | 33 | @ExceptionHandler(InvalidEntityException.class) 34 | public ResponseEntity handleInvalidEntityException(InvalidEntityException ex, HttpServletRequest request) { 35 | return handleDomainException(ex, request, UNPROCESSABLE_ENTITY); 36 | } 37 | 38 | @ExceptionHandler(MissingEntityException.class) 39 | public ResponseEntity handleMissingEntityException(MissingEntityException ex, HttpServletRequest request) { 40 | return handleDomainException(ex, request, NOT_FOUND); 41 | } 42 | 43 | @ExceptionHandler(Exception.class) 44 | public ResponseEntity handleException(Exception ex, HttpServletRequest request) { 45 | log.error(createLog(request, INTERNAL_SERVER_ERROR, UNEXPECTED_ERROR, ex.getMessage()), ex); 46 | return status(INTERNAL_SERVER_ERROR) 47 | .body(new ErrorMessage(UNEXPECTED_ERROR)); 48 | } 49 | 50 | private ResponseEntity handleDomainException(DomainException ex, HttpServletRequest request, HttpStatus status) { 51 | log.warn(createLog(request, status, ex.getCode(), ex.getMessage())); 52 | return status(status) 53 | .body(new ErrorMessage(ex.getCode())); 54 | } 55 | 56 | private String createLog(HttpServletRequest request, HttpStatus status, ErrorCode code, String message) { 57 | return request.getMethod() + " " + request.getRequestURI() + " " + status.value() + " | " + code + " | " + message; 58 | } 59 | } -------------------------------------------------------------------------------- /src/test/groovy/com/github/mkopylec/projectmanager/BasicSpecification.groovy: -------------------------------------------------------------------------------- 1 | package com.github.mkopylec.projectmanager 2 | 3 | import com.github.tomakehurst.wiremock.junit.WireMockRule 4 | import org.junit.Rule 5 | import org.springframework.beans.factory.annotation.Autowired 6 | import org.springframework.boot.test.context.SpringBootTest 7 | import org.springframework.boot.test.web.client.TestRestTemplate 8 | import org.springframework.core.ParameterizedTypeReference 9 | import org.springframework.data.mongodb.core.MongoTemplate 10 | import org.springframework.http.HttpEntity 11 | import org.springframework.http.HttpMethod 12 | import org.springframework.http.ResponseEntity 13 | import spock.lang.Specification 14 | 15 | import static com.github.tomakehurst.wiremock.client.WireMock.aResponse 16 | import static com.github.tomakehurst.wiremock.client.WireMock.containing 17 | import static com.github.tomakehurst.wiremock.client.WireMock.post 18 | import static com.github.tomakehurst.wiremock.client.WireMock.postRequestedFor 19 | import static com.github.tomakehurst.wiremock.client.WireMock.stubFor 20 | import static com.github.tomakehurst.wiremock.client.WireMock.urlEqualTo 21 | import static com.github.tomakehurst.wiremock.client.WireMock.verify 22 | import static java.util.concurrent.TimeUnit.SECONDS 23 | import static org.awaitility.Awaitility.await 24 | import static org.springframework.boot.test.context.SpringBootTest.WebEnvironment.RANDOM_PORT 25 | import static org.springframework.http.HttpMethod.GET 26 | import static org.springframework.http.HttpMethod.PATCH 27 | import static org.springframework.http.HttpMethod.POST 28 | import static org.springframework.http.HttpMethod.PUT 29 | 30 | @SpringBootTest(webEnvironment = RANDOM_PORT) 31 | abstract class BasicSpecification extends Specification { 32 | 33 | @Rule 34 | public WireMockRule reportingService = new WireMockRule(8081) 35 | @Autowired 36 | private TestRestTemplate restTemplate 37 | @Autowired 38 | private MongoTemplate mongo 39 | 40 | void setupSpec() { 41 | fixWireMock() 42 | } 43 | 44 | void setup() { 45 | clearMongoDb() 46 | } 47 | 48 | protected static void stubReportingService() { 49 | stubFor(post(urlEqualTo('/reports/projects')).willReturn(aResponse().withStatus(201))) 50 | } 51 | 52 | protected static void verifyReportWasSent(String projectIdentifier) { 53 | verifyReportSending(1, projectIdentifier) 54 | } 55 | 56 | protected static void verifyReportWasNotSent(String projectIdentifier) { 57 | verifyReportSending(0, projectIdentifier) 58 | } 59 | 60 | protected ResponseEntity get(String uri, Class responseBodyType) { 61 | return sendRequest(uri, GET, null, responseBodyType) 62 | } 63 | 64 | protected ResponseEntity get(String uri, ParameterizedTypeReference responseBodyType) { 65 | return sendRequest(uri, GET, null, responseBodyType) 66 | } 67 | 68 | protected ResponseEntity post(String uri, Object requestBody) { 69 | return sendRequest(uri, POST, requestBody, Object) 70 | } 71 | 72 | protected ResponseEntity put(String uri, Object requestBody) { 73 | return sendRequest(uri, PUT, requestBody, Object) 74 | } 75 | 76 | protected ResponseEntity patch(String uri) { 77 | return sendRequest(uri, PATCH, null, Object) 78 | } 79 | 80 | protected ResponseEntity patch(String uri, Object requestBody) { 81 | return sendRequest(uri, PATCH, requestBody, Object) 82 | } 83 | 84 | private ResponseEntity sendRequest(String uri, HttpMethod method, Object requestBody, Class responseBodyType) { 85 | def entity = new HttpEntity<>(requestBody) 86 | return restTemplate.exchange(uri, method, entity, responseBodyType) 87 | } 88 | 89 | private ResponseEntity sendRequest(String uri, HttpMethod method, Object requestBody, ParameterizedTypeReference responseBodyType) { 90 | def entity = new HttpEntity<>(requestBody) 91 | return restTemplate.exchange(uri, method, entity, responseBodyType) 92 | } 93 | 94 | private static void fixWireMock() { 95 | System.setProperty('http.keepAlive', 'false') 96 | System.setProperty('http.maxConnections', '1') 97 | } 98 | 99 | private void clearMongoDb() { 100 | for (def collection : mongo.collectionNames) { 101 | mongo.dropCollection(collection) 102 | } 103 | } 104 | 105 | private static void verifyReportSending(int count, String projectIdentifier) { 106 | await().atMost(1, SECONDS).untilAsserted { 107 | verify(count, postRequestedFor(urlEqualTo('/reports/projects')).withRequestBody(containing(projectIdentifier))) 108 | } 109 | } 110 | } -------------------------------------------------------------------------------- /gradlew: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env sh 2 | 3 | ############################################################################## 4 | ## 5 | ## Gradle start up script for UN*X 6 | ## 7 | ############################################################################## 8 | 9 | # Attempt to set APP_HOME 10 | # Resolve links: $0 may be a link 11 | PRG="$0" 12 | # Need this for relative symlinks. 13 | while [ -h "$PRG" ] ; do 14 | ls=`ls -ld "$PRG"` 15 | link=`expr "$ls" : '.*-> \(.*\)$'` 16 | if expr "$link" : '/.*' > /dev/null; then 17 | PRG="$link" 18 | else 19 | PRG=`dirname "$PRG"`"/$link" 20 | fi 21 | done 22 | SAVED="`pwd`" 23 | cd "`dirname \"$PRG\"`/" >/dev/null 24 | APP_HOME="`pwd -P`" 25 | cd "$SAVED" >/dev/null 26 | 27 | APP_NAME="Gradle" 28 | APP_BASE_NAME=`basename "$0"` 29 | 30 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. 31 | DEFAULT_JVM_OPTS="" 32 | 33 | # Use the maximum available, or set MAX_FD != -1 to use that value. 34 | MAX_FD="maximum" 35 | 36 | warn () { 37 | echo "$*" 38 | } 39 | 40 | die () { 41 | echo 42 | echo "$*" 43 | echo 44 | exit 1 45 | } 46 | 47 | # OS specific support (must be 'true' or 'false'). 48 | cygwin=false 49 | msys=false 50 | darwin=false 51 | nonstop=false 52 | case "`uname`" in 53 | CYGWIN* ) 54 | cygwin=true 55 | ;; 56 | Darwin* ) 57 | darwin=true 58 | ;; 59 | MINGW* ) 60 | msys=true 61 | ;; 62 | NONSTOP* ) 63 | nonstop=true 64 | ;; 65 | esac 66 | 67 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar 68 | 69 | # Determine the Java command to use to start the JVM. 70 | if [ -n "$JAVA_HOME" ] ; then 71 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 72 | # IBM's JDK on AIX uses strange locations for the executables 73 | JAVACMD="$JAVA_HOME/jre/sh/java" 74 | else 75 | JAVACMD="$JAVA_HOME/bin/java" 76 | fi 77 | if [ ! -x "$JAVACMD" ] ; then 78 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME 79 | 80 | Please set the JAVA_HOME variable in your environment to match the 81 | location of your Java installation." 82 | fi 83 | else 84 | JAVACMD="java" 85 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 86 | 87 | Please set the JAVA_HOME variable in your environment to match the 88 | location of your Java installation." 89 | fi 90 | 91 | # Increase the maximum file descriptors if we can. 92 | if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then 93 | MAX_FD_LIMIT=`ulimit -H -n` 94 | if [ $? -eq 0 ] ; then 95 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then 96 | MAX_FD="$MAX_FD_LIMIT" 97 | fi 98 | ulimit -n $MAX_FD 99 | if [ $? -ne 0 ] ; then 100 | warn "Could not set maximum file descriptor limit: $MAX_FD" 101 | fi 102 | else 103 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" 104 | fi 105 | fi 106 | 107 | # For Darwin, add options to specify how the application appears in the dock 108 | if $darwin; then 109 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" 110 | fi 111 | 112 | # For Cygwin, switch paths to Windows format before running java 113 | if $cygwin ; then 114 | APP_HOME=`cygpath --path --mixed "$APP_HOME"` 115 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` 116 | JAVACMD=`cygpath --unix "$JAVACMD"` 117 | 118 | # We build the pattern for arguments to be converted via cygpath 119 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` 120 | SEP="" 121 | for dir in $ROOTDIRSRAW ; do 122 | ROOTDIRS="$ROOTDIRS$SEP$dir" 123 | SEP="|" 124 | done 125 | OURCYGPATTERN="(^($ROOTDIRS))" 126 | # Add a user-defined pattern to the cygpath arguments 127 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then 128 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" 129 | fi 130 | # Now convert the arguments - kludge to limit ourselves to /bin/sh 131 | i=0 132 | for arg in "$@" ; do 133 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` 134 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option 135 | 136 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition 137 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` 138 | else 139 | eval `echo args$i`="\"$arg\"" 140 | fi 141 | i=$((i+1)) 142 | done 143 | case $i in 144 | (0) set -- ;; 145 | (1) set -- "$args0" ;; 146 | (2) set -- "$args0" "$args1" ;; 147 | (3) set -- "$args0" "$args1" "$args2" ;; 148 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;; 149 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; 150 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; 151 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; 152 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; 153 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; 154 | esac 155 | fi 156 | 157 | # Escape application args 158 | save () { 159 | for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done 160 | echo " " 161 | } 162 | APP_ARGS=$(save "$@") 163 | 164 | # Collect all arguments for the java command, following the shell quoting and substitution rules 165 | eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" 166 | 167 | # by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong 168 | if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then 169 | cd "$(dirname "$0")" 170 | fi 171 | 172 | exec "$JAVACMD" "$@" 173 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Project Manager - Domain-Driven Design workshop application 2 | Project Manager is a sample REST service implemented using Domain-Driven Design technique. 3 | Its primary goal is to help me to conduct a Domain-Driven Design workshops. 4 | During the workshop developers implement the application on their own, following the steps in right order. 5 | 6 | > :bulb: 7 | > Currently I organize the source code someway different. See the [hexagonal_architecture](https://github.com/mkopylec/project-manager/tree/hexagonal_architecture) and/or [hexagonal_architecture_unit_of_work](https://github.com/mkopylec/project-manager/tree/hexagonal_architecture_unit_of_work) and/or [denormalized_model](https://github.com/mkopylec/project-manager/tree/denormalized_model) and/or [api_implementation_achitecture](https://github.com/mkopylec/project-manager/tree/api_implementation_achitecture) branch and also [my blog post](https://allegro.tech/2019/12/grouping-and-organizing-classes.html) for more details. Neverless the following workshop is still a valueable way to get familiar with DDD. 8 | 9 | ## Application summary 10 | The Project Manager is a simple application for managing business projects at IT company. 11 | The application is directed to project managers. 12 | Using the application they can add projects, monitor their progress and assign teams to work on the projects. 13 | 14 | ## Working with application 15 | To run the application execute: 16 | ```bash 17 | ./gradlew bootRun 18 | ``` 19 | To run tests execute: 20 | ```bash 21 | ./gradlew test 22 | ``` 23 | 24 | ## Steps to implement 25 | Each branch of the repository represents a subsequent step of the overall task. 26 | The task is to implement each step using Domain-Driven Design rules, so the unit tests can successfully pass. 27 | Checkout the _master_ branch. 28 | Get known with the starting code, it contains the parts that are not focused on Domain-Driven Design modelling but are necessary for application to work properly. 29 | 30 | The following describes steps to implement using an ubiquitous language. 31 | The description contains hints on how to design a model from the business requirements. 32 | A hint is a bold part of the text with a suggestion on what domain building block or block part should be used: 33 | - _(E)_ - entity 34 | - _(EP)_ - entity property 35 | - _(VO)_ - value object 36 | - _(VOP)_ - value object property 37 | - _(DS)_ - domain service 38 | - _(?)_ - try to guess :-) 39 | 40 | The [layers](src/main/java/layers) package contains examples on how to properly implement and organize Domain-Driven Design building blocks and other component types. 41 | 42 | ### Step 1 - Create a team 43 | The user can create a new **team**_(E)_. 44 | Every team must be **named**_(EP)_. 45 | To manage teams more efficient the user will need an information on how busy a team currently is. 46 | To fulfil this requirement the application must display **how many projects a team is currently implementing**_(EP)_. 47 | A team cannot be created if it already exists. 48 | 49 | ##### To do 50 | Checkout the _step-1-start_ branch. 51 | Implement the `TeamController.createTeam(...)` method, so the unit tests can successfully pass. 52 | Compare your solution with the _step-1-finish_ branch. 53 | 54 | ### Step 2 - Add a member to a team 55 | The user can add a member to a team. 56 | Every team consists of **members**_(EP)_ that are company's **employees**_(VO)_. 57 | It is important for an employee that, besides of having a **first**_(VOP)_ and **last name**_(VOP)_, he has a known **job position**_(VOP)_. 58 | Job position can be one of: developer, scrum master or product owner. 59 | 60 | ##### To do 61 | Checkout the _step-2-start_ branch. 62 | Implement the `TeamController.addMemberToTeam(...)` method, so the unit tests can successfully pass. 63 | Compare your solution with the _step-2-finish_ branch. 64 | 65 | ### Step 3 - Show teams 66 | The user can browse teams. 67 | He can see their members and on how many projects teams are working right now. 68 | If a team is working on more than 3 projects the user sees it as a busy team. 69 | 70 | ##### To do 71 | Checkout the _step-3-start_ branch. 72 | Implement the `TeamController.getTeams(...)` method, so the unit tests can successfully pass. 73 | Compare your solution with the _step-3-finish_ branch. 74 | 75 | ### Step 4 - Create a project draft 76 | The user can create **project**_(E)_ drafts. 77 | A project draft includes minimum information about the project. 78 | It requires a project **name**_(EP)_ and an automatically **generated unique project identifier**_(DS)_. 79 | A newly created project has a "to do" **status**_(EP)_. 80 | No **team**_(EP)_ is assigned to work on a newly created project. 81 | 82 | ##### To do 83 | Checkout the _step-4-start_ branch. 84 | Implement the `ProjectController.createProject(...)` method, so the unit tests can successfully pass. 85 | Compare your solution with the _step-4-finish_ branch. 86 | 87 | ### Step 5 - Create a full project 88 | The user can also create a full project. 89 | A full project is a project draft with extra information. 90 | It must contain a list of **features**_(EP)_ that are required to implement within the project. 91 | Every **feature**_(VO)_ has to be **named**_(VOP)_ and it must have **status**_(VOP)_ and **requirement**_(VOP)_ defined. 92 | For the newly created feature a "to do" status has to be set. 93 | Requirement can be one of: optional, recommended or necessary. 94 | 95 | ##### To do 96 | Checkout the _step-5-start_ branch. 97 | Implement the `ProjectController.createProject(...)` method, so the unit tests can successfully pass. 98 | Compare your solution with the _step-5-finish_ branch. 99 | 100 | ### Step 6 - Show projects 101 | The user can browse projects. 102 | He can see their list. 103 | Every item on the list contains a project identifier and name. 104 | 105 | ##### To do 106 | Checkout the _step-6-start_ branch. 107 | Implement the `ProjectController.getProjects(...)` method, so the unit tests can successfully pass. 108 | Compare your solution with the _step-6-finish_ branch. 109 | 110 | ### Step 7 - Show a specific project 111 | The user can also browse a specific project when he clicks on it in the projects list. 112 | He can see all information about the clicked project. 113 | 114 | ##### To do 115 | Checkout the _step-7-start_ branch. 116 | Implement the `ProjectController.getProject(...)` method, so the unit tests can successfully pass. 117 | Compare your solution with the _step-7-finish_ branch. 118 | 119 | ### Step 8 - Edit a project 120 | The user can edit created projects. 121 | He can update its name, features and he can **assign a team**_(DS)_ to work on a project. 122 | Feature status can be change to one of: to do, in progress or done. 123 | If a team is assigned to a project then the project counts as a project implemented by the team. 124 | 125 | ##### To do 126 | Checkout the _step-8-start_ branch. 127 | Implement the `ProjectController.updateProject(...)` method, so the unit tests can successfully pass. 128 | Compare your solution with the _step-8-finish_ branch. 129 | 130 | ### Step 9 - Start a project 131 | The user can start a project only if the project is assigned to a team. 132 | When the project starts its status is changed to "in progress". 133 | 134 | ##### To do 135 | Checkout the _step-9-start_ branch. 136 | Implement the `ProjectController.startProject(...)` method, so the unit tests can successfully pass. 137 | Compare your solution with the _step-9-finish_ branch. 138 | 139 | ### Step 10 - End a project 140 | The user can end a started project when **all of the features in the project are done**_(?)_. 141 | Sometimes the users supervisor can give him a permission to end a project when **only the necessary features are done**_(?)_. 142 | Ended projects don't count as projects implemented by a team. 143 | Ended projects needs to be reported in the company's end year review. 144 | To do that the application needs to inform a Reporting Service about the **ended project**_(?)_ by sending its **identifier**_(?)_. 145 | 146 | ##### To do 147 | Checkout the _step-10-start_ branch. 148 | Implement the `ProjectController.endProject(...)` method, so the unit tests can successfully pass. 149 | Compare your solution with the _step-10-finish_ branch. 150 | 151 | ## Hexagonal architecture 152 | Following the workshop's steps creates an application designed in classic layered architecture. 153 | The [hexagonal_architecture](https://github.com/mkopylec/project-manager/tree/hexagonal_architecture) branch shows the fully implemented application in hexagonal architecture. 154 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "{}" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright {yyyy} {name of copyright owner} 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | --------------------------------------------------------------------------------