This code shows an example of an application structure in Node.js modeled with some Domain Driven Design concepts.
More details about the basis of this project can be seen in this presentation in portuguese.
The user stories that we will model are:
- "The address must be used in the GPS to calculate the route"
- "I must be able to save my home and work addresses in the application"
- "An address is unique in the system and must have a street, number, zip code, city, and type (home or work)"
- "A route is a set of ordered instructions that describe the direction to follow to the destination"
The requirements to run this code are:
- Node.js 12 (how to install?)
- Yarn package manager (how to install?)
- Docker, with docker-compose (how to install?)
- Run the
yarn installcommand in the code root folder to install the dependencies; -
- Start the Postgres database in a docker container with
docker-compose up -d
- Start the Postgres database in a docker container with
- Create the initial database data with
yarn db:migrate - Start the application with
yarn start
Access the url http://localhost:4000 in your browser, and once the GraphQL Playground has been loaded, perform the following steps:
- Run the
SaveDatamutation to insert the data into the database:
mutation SaveData {
saveAddress(address: {
name: "Rodovia Virgílio Varzea",
number: 400,
zipCode: "88032000",
city: "Florianópolis",
state: "Santa Catarina",
kind: "work"
}) {
id
name
number
complement
zipCode
city
state
kind
}
saveAddress(address: {
name: "Rua Gomes de Carvalho",
number: 1666,
complement: "Bloco 2",
zipCode: "04547006",
city: "São Paulo",
state: "São Paulo",
kind: "work"
}) {
id
name
number
complement
zipCode
city
state
kind
}
saveGPS(gps: {
type: "gmaps"
}) {
type
}
saveGPS(gps: {
type: "troll"
}) {
type
}
}
- Execute the mutation
TraceRouteTrollto run the use case:
query TraceRouteTroll {
traceRoute(originId: 11, destinationId: 12, gpsType: "troll") {
origin {
name
number
city
}
destination {
name
number
city
}
instructions {
order
description
}
}
}
This code is an example of how to apply DDD theory to a Node.js / Javascript project, with some adaptations relevant to the language.
Feel free to contact me if you have any questions at @danielbdias