Fix/publishing accommodation

backend/.editorconfig

@@ -0,0 +1,9 @@
+#Configuracoes para defini os parametros do editor de texto, Ex tamanho do espacamento dentre outros.
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace =

backend/.env.example

@@ -0,0 +1,2 @@
+ENV=DEV
+PORT=5001

backend/.eslintrc

@@ -0,0 +1,10 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["no-unused-expressions"],
+  "rules": {
+    "no-unused-expressions": [
+      "warn",
+      { "allowShortCircuit": true, "allowTernary": true }
+    ]
+  }
+}

backend/.gitignore

@@ -0,0 +1,36 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+coverage/
+
+# Dependency directories
+node_modules/
+
+# Optional npm cache directory
+.npm
+
+# TypeScript cache
+*.tsbuildinfo
+
+# System files
+.DS_Store
+Thumbs.db
+
+# Editor files
+.vscode/
+
+# Build files
+dist/
+lib/
+
+# Env
+.env
+.env.test
+.env.dev
+.env.prod
+
+# Deploy
+.vercel

backend/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npm run lint 

backend/.husky/pre-push

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npm run test

backend/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "es5"
+}

backend/README.md

@@ -0,0 +1,80 @@
+# ESS Back-end Node.js
+
+This is the Back-end base project in Node.js for the Software and Systems Engineering discipline, offered by the Informatics Center (CIn) of the Federal University of Pernambuco (UFPE).
+
+## Table of Contents
+
+1. [Getting Started](##getting-started)
+2. [Scripts](#scripts)
+3. [Dependencies](#dependencies)
+4. [Architecture](#architecture)
+
+## Getting Started
+
+These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
+
+### Prerequisites
+
+To run this project, you'll need to have the following software installed on your system:
+
+- Node.js
+- npm (Node Package Manager)
+
+### Installing
+
+Clone the repository and install the dependencies by running the following command in the project directory:
+
+```
+npm install
+```
+
+### First time running ?
+
+Run the follow scripts
+
+```
+chmod +x .husky/pre-commit
+chmod +x .husky/pre-push
+```
+
+```
+npm run
+```
+
+### Environment
+
+This project uses `.env` files to manage environment variables. You can create a `.env.dev` file in the project directory and set the environment variables in the file (iou can create it from .`env.example`). The `env` script in the `package.json` file uses the `env-cmd` package to load the environment variables from the `.env.dev` file.
+
+### Running the Server
+
+To start the server, run the following command:
+
+```
+env=dev npm run start
+```
+
+This command will run the TypeScript compiler in watch mode and start the server using nodemon.
+
+## Scripts
+
+The following scripts are available in the `package.json` file:
+
+- `start`: Runs the TypeScript compiler in watch mode and starts the server using nodemon.
+- `build`: Compiles the TypeScript code.
+- `test`: Runs the Jest tests for the project.
+- `prettier`: Formats the code using Prettier.
+- `lint`: Lints the code using ESLint.
+
+## Dependencies
+
+The following dependencies are used in the project:
+
+- [env-cmd](https://github.com/toddbluhm/env-cmd): A simple way to manage your environment variables in npm scripts.
+- [express](https://github.com/expressjs/express): Fast, unopinionated, minimalist web framework for Node.js.
+- [typescript](https://github.com/microsoft/TypeScript): A typed superset of JavaScript that compiles to plain JavaScript.
+- [jest](https://github.com/microsoft/TypeScript): Jest is a delightful JavaScript Testing Framework with a focus on simplicity.
+- [pino](https://github.com/pinojs/pino): Very low overhead Node.js logger.
+
+## Architecture
+
+To understand and learn more details about the structure of the project, click [here](./docs/architecture-pattern.md) to be redirected to the README that contains this information.

backend/docs/architecture-pattern.md

@@ -0,0 +1,82 @@
+# Architecture Pattern
+
+The base project was created to give a quick "start" to the discipline's team projects. But, at the same time, we didn't want to give up a certain level of organization that helps to develop features safely and makes it easier to create tests.
+
+## Table of Contents
+
+1. [Layered architecture](#layered-architecture)
+2. [What is the Model for?](#what-is-the-model-for)
+3. [Dependency Injection](#dependency-injection)
+4. [Database](#database)
+5. [Routes](#routes)
+6. [Conclusion](#conclusion)
+
+---
+
+# Layered architecture
+
+Layered architecture is a software design approach where the software is separated into different layers (functional areas), each with a specific role and responsibility. In a typical layered architecture, you will find the following layers:
+
+## Entities Layer
+
+This layer represents the business data and the rules or logic that govern access to and updates of this data. These are typically the business objects (like Users, Products, Orders, etc.) and are independent of any specific technological choice (database, external services, etc.). They just contain data and methods to manipulate this data.
+
+## Repository Layer
+
+This layer acts as a bridge between the entities (business data) and the database. It is responsible for all database operations like create, read, update, and delete (CRUD). It basically interacts with your database or any other storage system.
+
+## Service Layer
+
+This layer contains the business logic of your application. It uses the repository layer to persist or retrieve the business data, performs necessary processing and passes the data to the controller. The service layer acts as an intermediary between the web layer (controllers) and the data access layer (repositories).
+
+## Controller Layer
+
+This layer is responsible for handling user requests and controlling the flow of the application. It interacts with the service layer to perform business operations and sends back the responses to the client. In a web application, these are typically the endpoints of your API.
+
+The layered architecture approach helps in separating concerns, making the software solution scalable, and also promotes high cohesion and low coupling. This design pattern is beneficial because it aligns with the Single Responsibility Principle (SRP), which is a key aspect of SOLID principles in software design and architecture. Each layer has a specific role and does not need to concern itself with the responsibilities of any other layer. This makes each layer independently modifiable and testable, leading to a software design that is easier to maintain and expand.
+
+---
+
+# What is the Model for?
+
+Models here are not absolutely essential, but are primarily used as a final representation of returned data. Unlike entities, which we can think of as a direct representation of a database table in code, we use models to represent what we could return in an endpoint.
+For example, when retrieving a user from the database, we might not want to return its password. In this case, the model could represent a user excluding the password field.
+
+But we can follow for example the idea of [​​DTOs](https://www.okta.com/identity-101/dto/), which would also be a good idea.
+Feel free to explore alternatives for representing these data operations.
+
+# Dependency Injection
+
+Is a design pattern that allows a system to be more flexible, testable, and modular. It's a form of Inversion of Control (IoC) which means that the control is inverted - instead of an object controlling its own dependencies, it's controlled by an outside party.
+
+In our case, we came up with a "homemade" solution that, overall, works very well. We use the Injector class, which is in charge of controlling our application's dependencies through its methods: registerService, getService, registerRepository and getRepository. The use of this class can be seen in the index.ts file, located in the **src/di folder**.
+
+# Database
+
+The idea of ​​a base project may seem complex when it proposes to cover many possibilities of use. Considering a practical and simple case, in this base project we are using the idea of ​​a "database" at runtime. In the **src/database/index.ts** file, we can observe the implementation of a simple interface for a database, where each "table" would be a set of key-values. Please don't see this as a limiter. If you prefer, you can choose to use a real database, be it SQL or NoSQL. By maintaining a similar level of project organization, the benefits will be the same.
+
+To manipulate our database with base methods, we have a class called BaseRepository. This will be extended by other repositories, thus allowing the inheritance of these methods and the reuse of our code's logic.
+
+# Routes
+
+Worth mentioning is our backend routes/endpoints definition file located at **src/routes/index.ts**. Its idea is simple: for each new controller, you can configure it inside 'export default' using **'app.use'**.
+
+```
+export default (app: Express) => {
+  app.use(
+    prefix,
+    new TestController(router, di.getService(TestService)).router
+  );
+  app.use(
+    prefix,
+    new ExampleController(router, di.getService(ExampleService)).router
+  );
+};
+
+```
+
+There is already an example in the file and the approach would be the same for all controllers. Thus, the controllers and their endpoints are registered and recognized in the application.
+
+# Conclusion
+
+Certainly, there are more details about the functionalities that are used in the project. However, the **Test** example case already covers many aspects, including testing. The base project is designed to make it easy, not to limit your preferences. What needs to be emphasized is that the main idea is the architecture used, which clearly distributes code responsibilities, thus facilitating maintenance and testing.

backend/jest.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  moduleFileExtensions: ['js', 'json', 'ts'],
+  rootDir: '',
+  testRegex: ['.steps.ts$'],
+  transform: {
+    '^.+\\.(t|j)s$': 'ts-jest',
+  },
+  setupFilesAfterEnv: ['./setupTests.ts'],
+};
+