Databox Backend Engineer Challenge MS is an API, serving as a bridge between Databox API and 3rd party service providers (such as Facebook, Google Analytics, GitHub etc.).

To be able to run the service, you must ensure you have the following tools installed:

• Node.js: version 20.6.1 or higher. You can download and install it from here.

We encourage you to use nvm to install, update and maintain multiple Node.js versions at the same time on your machine.

In case you use macOS with Homebrew package manager, you can install it via the following commands:

# Node.js
$ brew install node

• TypeScript - Typed JavaScript programming language used for developing the service.
• NestJS - Framework for building efficient, scalable Node.js server-side applications, used to define the architecture and structure of the service.
• class-validator - Decorator-based property validation for classes, used to perform request validation.
• swagger-ui-express - Serve auto-generated Swagger UI for express-based applications.
• Jest - Testing framework.

For installing all required dependencies, make sure you have npm installed on your machine.

Then, you just need to execute the following command:

$ npm install

Once the installation is finished, you should see something like this:

added 941 packages from 670 contributors and audited 957 packages in <seconds>

122 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities

Before running the service, you must define the ENV variables, required to make the integrations work.

Here you can find the complete list of ENV variables that the Databox Challenge MS uses:

Add your application configuration to your .env file in the root of your project by duplicating .env-example file:

DEVICE_CONFIGURATION_MODE=development
SECRET_X_API_KEY=SERVICEAPIKEY
...

Make sure you have Docker installed.

To create an instance of your database, run one of the following commands:

# For Apple Silicon chips
$ docker-compose -f docker-compose.arm.yml up

# For every other chip
$ docker-compose up

After executing these commands you should have the db container up and running.

After successfully starting the database in docker, run migrations and seeder to populate some test data:

$ npm run typeorm:migration:run

$ npm run seed

After executing these commands you should have the entities created and ready to be used with some autogenerated data.

You can run the service in development mode with:

# development mode
$ npm run start

That's it! This way, the service should be running on port 3000, with the configuration from your local .env file, accessible through http://localhost:3000.

Run the service in development mode, watching file changes and reloading the running service with:

# watch mode
$ npm run start:dev

The tests are located in the test directory and named as the classes they test. Testing files have a .spec or .test suffix.

To only execute unit tests, use the following script:

# unit tests
$ npm run test:unit

The service is using the Swagger module for NestJS to define and expose the databox-challenge MS API specification.

When the service is running, the API definition is exposed via Swagger UI in the /api endpoint.

In case you want to get the corresponding JSON file of the specification, you can get it from the /api-json endpoint.

When running the service on your machine, you can get to them via:

• http://localhost:3000/api - Swagger UI
• http://localhost:3000/api-json - JSON file

The structure used for the project follows the domain-based design, so each module/feature is isolated in its own folder, like databox, auth, health, making it easy to find and locate where the different functionalities exposed from the service might be.

The naming convention used for the files follows the pattern <name>.<type>.ts, where:

• name: The name of the component, class, or model you are defining.
• type: The type of content you have inside that file, e.g., module, controller, service, guard, interceptor, entity, etc.

# Examples:

databox.module.ts
databox.controller.ts
databox.service.ts
databox-session.entity.ts
databox.dto.ts

If the name is complex, we use hyphens to separate the different words, e.g. api-key-identification.entity.ts (Kebab Case)

• Databox - Webpage - Official company website.
• Databox - Documentation - General development documentation (Push API etc.).

• GitHub - Webpage - Official company website.
• GitHub - Documentation - General development documentation (GitHub Apps, OAuth apps, Marketplace etc.).

• CoinCap - Webpage - Official company website.
• CoinCap - Documentation - General development documentation (RESTful API & WebSocket docs).