This project structure is inspired in clean architecture code structure, by Uncle Bob. The main purpose of clean architecture is creating a strong project structure, splitting all the application in layers. The best advantages of using it, is create a application independent of any frameworks, tool, database or technology, being easy to handle the code, create a new features, fix any issue, or change some framework, thanks to the adapters and ports.

root
├── .github                 - Github setup files
│     └── assets
│     └── workflow
├── src                     - Application main code
│    │── app                - Composition layer, entry point code
│    │    └── routes        - routes files
│    │    └── setup         - server config (middlewares, cors, body-parser)
│    │    └── builds        - classes instances
│    │    └── adapters      - components adapters
│    ├── config             - Some global config files (.env, path alias, logger)
│    ├── domain             - Business rules definition
│    │     └── entities
│    │     └── usecases
│    ├── infra              - External frameworks and libs implementation
│    ├── presentation       - External api communication layer (controllers, presenters, validators)
│    └── useCases           - Usecases implementation
└─── tests                  - Components tests
      └── e2e
      └── unit

All controllers unexpected errors are stored in the database, becoming available for future analysis and corrections. Having a console available, the errors and the requests data can be logged on console, for faster viewing while running the application.

To run this project locally, you will have to install Nodejs and PostgreSQL on the machine, or run everything with Docker. After run the project, go to .env.example file, on project root, and rename it to .env, filling all the properties in the file with your information.

git clone https://github.com/gabriellopes00/help-women.git
or
git clone [email protected]:gabriellopes00/help-women.git

docker-compose up

npm install
npm run build
npm run start

• All ❯ yarn test
• Coverage ❯ yarn test:ci
• Unit ❯ yarn test:unit
• e2e ❯ yarn test:e2e

• Lint(eslint) ❯ yarn lint
• Style(prettier) ❯ yarn style

Following the standard of the Conventional Commits.

• feature commits(amount) ❯ git shortlog -s --grep feat
• test commits(amount) ❯ git shortlog -s --grep test
• refactor commits(amount) ❯ git shortlog -s --grep refactor
• chore commits(amount) ❯ git shortlog -s --grep chore
• docs commits(amount) ❯ git shortlog -s --grep docs
• build commits(amount) ❯ git shortlog -s --grep build