filipemata/clean_architecture_typescript_example

This repository provides an implementation (or at least an attempt) of Uncle Bob's Clean Architecture with Typescript.

Clean Architecture with Typescript

This repository provides an implementation (or at least an attempt) of Uncle Bob's Clean Architecture with Typescript.

Basically there is a folder representing each required layer:

• entities: This folder contains all enterprise business rules. It's represented by domain classes with most critical business rules.
• use-cases: This folder contains all aplication business rules. It's encapsulated in modules containing the use case interactors and its ports (one specific use case gateway interface and/or one specific use case presenter interface)
• adapters: This folder contains all kind of code that adapts interfaces most familiar to infrastructure layer to interfaces most familiar do use case layer. For example, sometimes it's needed to adapt one or more data access classes to an specific use case gateway interface.
• infrastructure: This folder contains all libraries, frameworks and drivers needed by the aplication. It's less important aplication layer, always depending on adapter's layer.

Execution Instructions

To configure and execute this project, the Docker framework was used. And for the database MySQL was chosen.

Initial configurations

On the first stage, it is important to create the database in which store our data for the app.

make database

On the second stage, we will build the required images from Dockerfile/Docker Compose to initialize its contexts(network, port, volume)

make build

After having our database properly created, it is necessary to run a setup. At this point we are executing the migrations, seeds and building the packages we need to run the App.

make setup

Running the App

Finally, after configuring the project, you can start up the project running following command.

make up logs

clean_architecture_typescript_example's Issues

Missing file

Hey Filipe ✋

This is a great repository that I'm willing to give it a try.

Unfortunately the command make setup shows up the following error:

ERROR: Cannot find "/application/src/infrastructure/db/databases.json".

How could this be fixed?

Best,
Cesar

Base-repository abstractFindAll

There is a miss typing error at base-repository.ts file.
At certain point of abstractFindAll method, you check whether the entity was loaded or not, in that case it wasn't, then you should add to the entityMap list, and the given object should be entity instead of loaded(which should be null/undefined anyways).

Below is an example of how it should be in my point of view.

Congrats for the architecture.