Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexfariakof/app-despesas-pessoais
Aplicação Angular e API Restful HATEOAS .Net Core 8.0 dockerizada com CI/CD.
https://github.com/alexfariakof/app-despesas-pessoais
aws aws-s3 bash cqrs csharp ddd design-patterns docker docker-compose dotnet entity-framework github-actions jwt-authentication mysql-server powershell sonarcloud sql-server swagger unitofwork xunit
Last synced: 30 days ago
JSON representation
Aplicação Angular e API Restful HATEOAS .Net Core 8.0 dockerizada com CI/CD.
- Host: GitHub
- URL: https://github.com/alexfariakof/app-despesas-pessoais
- Owner: alexfariakof
- License: gpl-3.0
- Created: 2023-04-26T01:36:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-12T01:12:34.000Z (8 months ago)
- Last Synced: 2024-06-12T08:03:09.270Z (8 months ago)
- Topics: aws, aws-s3, bash, cqrs, csharp, ddd, design-patterns, docker, docker-compose, dotnet, entity-framework, github-actions, jwt-authentication, mysql-server, powershell, sonarcloud, sql-server, swagger, unitofwork, xunit
- Language: C#
- Homepage: http://alexfariakof.com:42536/swagger
- Size: 1.53 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Backend API Restful Despesas Pessoais
## Introduction
In summary, this project involves an update of the Restful API application created in the current final project, upgrading from .NET Core 3.1 to .NET Core 8.0. Test-Driven Development (TDD) is implemented using XUnit, generating test coverage reports locally with ReportGenerator. CI/CD is implemented with GitActions/Workflows, which perform "Build, Unit Testing, and Static Code Analysis in the cloud using Sonar Cloud." The Restful HATEOAS API documentation is created using Swagger, and the application is dockerized. Document and image storage is done on an Amazon S3 bucket file server, with integration with either MySql Server or Sql Server through the Entity Framework using Migrations to control versioning of entities or tables created or updated during the project's evolution. The application is currently in production on an AWS EC2 server, ensuring high availability.
## Postman Documentation
This project can be access [Postman Documentation](https://bold-eclipse-872793.postman.co/workspace/local-api-despesas-pessoais~bb08206c-ff0d-44c9-b49e-55339a554a3b/overview)
## Application in Production
This project can be access at [Production API Restful Despesas Pessoais](http://alexfariakof.com:42535/swagger).
## Application in Development
This project can be access at [Development API Restful Despesas Pessoais](http://alexfariakof.com:42536/swagger).
## Build
Run `dotnet build -restore ` to build the project. The build artifacts will be stored in the `bin/` directory.
## Development server without automatically reload
* First way
Run `dotnet run --project ./despesas-backend-api-net-core`. Navigate to `http://localhost:42535/swagger` or `https://localhost/swagger`.
* Second way
Run `./run.ps1 ` if using windows, or Run `./run.sh` if using linux. Navigate to `http://localhost:42535/swagger` or `https://localhost/swagger`.
## Development server with automatically reload
Make sure have instaled tool watch, if not Run `dotnet tool install --global dotnet-watch`
* First way
Run `dotnet watch run --project ./despesas-backend-api-net-core`. Navigate to `http://localhost:42535/swagger` or `https://localhost/swagger`. The application automatically restart it when changes are detected.
* Second way
Run `./run.ps1 -w` if using windows, or Run `./run.sh -w` if using linux. The application will open in default browser and automatically restart it when changes are detected.
## Development server in Docker with Database Localy
Make sure have instaled Docker Engine instaled, if not go to [Install Docker Engine](https://docs.docker.com/engine/install/).
* First way
Run `docker-compose -f .\docker-compose.database.yml up -d`. Navigate to `http://localhost:42535/swagger`.
* Second way
Run `./rundocker.ps1 -local` if using windows, or Run `./rundocker.sh -local` is using linux. The application will open in default browser.
## Development server in Docker without Database Localy
In this case the application will work correctely only in branch database-in-memory
Make sure have instaled Docker Engine instaled, if not go to [Install Docker Engine](https://docs.docker.com/engine/install/).
* First way
Run `docker-compose -f .\docker-compose.yml up -d`. Navigate to `http://localhost:42535/swagger`.
* Second way
Run `./rundocker.ps1` if using windows, or Run `./rundocker.sh` if using linux. The application will open in default browser.
## Running Unit Tests
Run `dotnet test` to execute the unit tests.
## Running Unit Tests and Generate Report Test Coverage
Make sure have instaled tool ReportGenerator, if not Run `dotnet tool install --global dotnet-reportgenerator-globaltool`
Run `./generate_coverage_report.ps1` if using windows, or Run `./generate_coverage_report.sh` if using linux. The Report will open in default browser automatically.
[Overview Report Coverage Results](http://alexfariakof.com:42536/coveragereport/index.html)
## Security Settings
-
User Access/Password Control
Passwords are encrypted and not exposed in any requests, and they are managed by a key accessed by the Crypto class in a file created on the server. Ideally, the access should be through a key created within Azure or AWS, thereby enhancing security.
-
API Model-View Layer
The repository layer is independent, and its implementation is not visible because the model exposed in the endpoints is model-view objects that do not reveal the database implementation.
-
API Access
Only first access, such as user registration, user login, and password recovery, can be accessed without the need to log in with validated user and passwords. The rest of the API can only be accessed using an access token generated by the API.
-
User Control
Only users with administrator profiles can list users and delete users. For the security of registered user information, all accesses to the user endpoint require JWT Bearer Authentication.
## Sonar Cloud
SonarCloud is a cloud-based static code analysis platform that helps development teams maintain code quality and identify issues early in the software development process. It offers automated code review, continuous inspection, and code analytics. SonarCloud scans your code for bugs, vulnerabilities, and code smells, providing actionable feedback to improve code quality and security. It is an essential tool for ensuring that your software projects are maintainable, reliable, and secure. via [Sonar Cloud](https://sonarcloud.io/).
This project Overview in Sonar Cloud can be access at [Overview Project in Sonar Cloud](https://sonarcloud.io/project/overview?id=alexfariakof_app-despesas-pessoais))
