Documentation and housekeeping (#15)

1. **9d4c799** Added basic info about this repository in README. about
the project intent and how to execute this application in local machine
- more to come


1. **58b2ffb** Deleted project created in commit
de85a0a
- Commit subject: Create ASP.NET Core MVC project using VS Community
2022 (#1)
- The idea in the early stages of this repo was to create projects with
slightly different configuration (with and without top-level statements)
to show they are functionally equivalent
- My preference, though, favored the project with classic structure -
Program class without top-level statements and implicit usings.
- Now that project is coming to its end, it's time to clean up the
repository before final delivery as assignment

    Files deleted:
    - myfinance-web/Configurations-in-VS2022.png
    - myfinance-web/Controllers/HomeController.cs
    - myfinance-web/Models/ErrorViewModel.cs
    - myfinance-web/Program.cs
    - myfinance-web/Properties/launchSettings.json
    - myfinance-web/Views/Home/Index.cshtml
    - myfinance-web/Views/Home/Privacy.cshtml
    - myfinance-web/Views/Shared/Error.cshtml
    - myfinance-web/Views/Shared/_Layout.cshtml
    - myfinance-web/Views/Shared/_Layout.cshtml.css
    - myfinance-web/Views/Shared/_ValidationScriptsPartial.cshtml
    - myfinance-web/Views/_ViewImports.cshtml
    - myfinance-web/Views/_ViewStart.cshtml
    - myfinance-web/appsettings.Development.json
    - myfinance-web/appsettings.json
    - myfinance-web/myfinance-web.csproj
    - myfinance-web/myfinance-web.sln
    - myfinance-web/wwwroot/css/site.css
    - myfinance-web/wwwroot/favicon.ico
    - myfinance-web/wwwroot/js/site.js
    - myfinance-web/wwwroot/lib/bootstrap/LICENSE
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-grid.css
- myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-grid.css.map
- myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-grid.min.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-grid.min.css.map
- myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-grid.rtl.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-grid.rtl.css.map
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-grid.rtl.min.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-grid.rtl.min.css.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.css
- myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.css.map
- myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.min.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.min.css.map
- myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.rtl.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.rtl.css.map
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.rtl.min.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-reboot.rtl.min.css.map
- myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-utilities.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-utilities.css.map
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-utilities.min.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-utilities.min.css.map
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-utilities.rtl.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-utilities.rtl.css.map
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-utilities.rtl.min.css
-
myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap-utilities.rtl.min.css.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap.css
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap.css.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap.min.css
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap.min.css.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap.rtl.css
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap.rtl.css.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap.rtl.min.css
- myfinance-web/wwwroot/lib/bootstrap/dist/css/bootstrap.rtl.min.css.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.bundle.js
- myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.bundle.js.map
- myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.bundle.min.js
-
myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.bundle.min.js.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.esm.js
    - myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.esm.js.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.esm.min.js
- myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.esm.min.js.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.js
    - myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.js.map
    - myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.min.js
    - myfinance-web/wwwroot/lib/bootstrap/dist/js/bootstrap.min.js.map
- myfinance-web/wwwroot/lib/jquery-validation-unobtrusive/LICENSE.txt
-
myfinance-web/wwwroot/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js
-
myfinance-web/wwwroot/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js
    - myfinance-web/wwwroot/lib/jquery-validation/LICENSE.md
- myfinance-web/wwwroot/lib/jquery-validation/dist/additional-methods.js
-
myfinance-web/wwwroot/lib/jquery-validation/dist/additional-methods.min.js
- myfinance-web/wwwroot/lib/jquery-validation/dist/jquery.validate.js
-
myfinance-web/wwwroot/lib/jquery-validation/dist/jquery.validate.min.js
    - myfinance-web/wwwroot/lib/jquery/LICENSE.txt
    - myfinance-web/wwwroot/lib/jquery/dist/jquery.js
    - myfinance-web/wwwroot/lib/jquery/dist/jquery.min.js
    - myfinance-web/wwwroot/lib/jquery/dist/jquery.min.map

1. **7142aff** Moved main project one level up to reduce folder nesting

    Files renamed:
- {myfinance-web-wo-top-level-statement/Controllers =>
Controllers}/HomeController.cs (100%)
- {myfinance-web-wo-top-level-statement/Controllers =>
Controllers}/PlanoContaController.cs (100%)
- {myfinance-web-wo-top-level-statement/Domain => Domain}/PlanoConta.cs
(100%)
- {myfinance-web-wo-top-level-statement/Domain => Domain}/Transacao.cs
(100%)
- {myfinance-web-wo-top-level-statement/Infrastructure =>
Infrastructure}/MyFinanceDbContext.cs (100%)
- {myfinance-web-wo-top-level-statement/Models =>
Models}/ErrorViewModel.cs (100%)
- {myfinance-web-wo-top-level-statement/Models =>
Models}/PlanoContaModel.cs (100%)
- {myfinance-web-wo-top-level-statement/Models =>
Models}/PlanoContaModelExtensions.cs (100%)
- myfinance-web-wo-top-level-statement/Program.cs => Program.cs (100%)
- {myfinance-web-wo-top-level-statement/Properties =>
Properties}/launchSettings.json (100%)
- {myfinance-web-wo-top-level-statement/Scripts =>
Scripts}/DB-Creation-and-Configuration.sql (100%)
- {myfinance-web-wo-top-level-statement/Scripts =>
Scripts}/Feeding-Database.sql (100%)
- {myfinance-web-wo-top-level-statement/Scripts => Scripts}/Queries.sql
(100%)
- {myfinance-web-wo-top-level-statement/Services =>
Services}/IPlanoContaService.cs (100%)
- {myfinance-web-wo-top-level-statement/Services =>
Services}/PlanoContaService.cs (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/Home/Index.cshtml (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/Home/Privacy.cshtml (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/PlanoConta/Cadastro.cshtml (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/PlanoConta/Index.cshtml (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/Shared/Error.cshtml (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/Shared/_Layout.cshtml (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/Shared/_Layout.cshtml.css (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/Shared/_ValidationScriptsPartial.cshtml (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/_ViewImports.cshtml (100%)
- {myfinance-web-wo-top-level-statement/Views =>
Views}/_ViewStart.cshtml (100%)
- myfinance-web-wo-top-level-statement/appsettings.Development.json =>
appsettings.Development.json (100%)
- myfinance-web-wo-top-level-statement/appsettings.json =>
appsettings.json (100%)
-
myfinance-web-wo-top-level-statement/console-command-to-create-project-in-cli.png
=> console-command-to-create-project-in-cli.png (100%)
- myfinance-web-wo-top-level-statement/myfinance-web.csproj =>
myfinance-web.csproj (100%)
- myfinance-web-wo-top-level-statement/myfinance-web.sln =>
myfinance-web.sln (100%)
- {myfinance-web-wo-top-level-statement/wwwroot => wwwroot}/css/site.css
(100%)
- {myfinance-web-wo-top-level-statement/wwwroot => wwwroot}/favicon.ico
(100%)
- {myfinance-web-wo-top-level-statement/wwwroot => wwwroot}/js/site.js
(100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/LICENSE (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-grid.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-grid.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-grid.min.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-grid.min.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-grid.rtl.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-grid.rtl.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-grid.rtl.min.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-grid.rtl.min.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-reboot.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-reboot.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-reboot.min.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-reboot.min.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-reboot.rtl.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-reboot.rtl.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-reboot.rtl.min.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-reboot.rtl.min.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-utilities.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-utilities.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-utilities.min.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-utilities.min.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-utilities.rtl.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-utilities.rtl.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-utilities.rtl.min.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap-utilities.rtl.min.css.map
(100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap.min.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap.min.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap.rtl.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap.rtl.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap.rtl.min.css (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/css/bootstrap.rtl.min.css.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.bundle.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.bundle.js.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.bundle.min.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.bundle.min.js.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.esm.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.esm.js.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.esm.min.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.esm.min.js.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.js.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.min.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/bootstrap/dist/js/bootstrap.min.js.map (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery-validation-unobtrusive/LICENSE.txt (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.js
(100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js
(100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery-validation/LICENSE.md (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery-validation/dist/additional-methods.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery-validation/dist/additional-methods.min.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery-validation/dist/jquery.validate.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery-validation/dist/jquery.validate.min.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery/LICENSE.txt (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery/dist/jquery.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery/dist/jquery.min.js (100%)
- {myfinance-web-wo-top-level-statement/wwwroot =>
wwwroot}/lib/jquery/dist/jquery.min.map (100%)

1. **9bec618** Fixed path in GitHub workflows to account for folder
structure changes

.github/workflows/setup-ci-cd_my-finance-web-app-mvc.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: ./myfinance-web-wo-top-level-statement
+        working-directory: ./
 
     steps:
       - uses: actions/checkout@v4

.github/workflows/sonarqube-cloud.yml

@@ -32,15 +32,14 @@ jobs:
         id: cache-sonar-scanner
         uses: actions/cache@v4
         with:
-          path: myfinance-web-wo-top-level-statement\.sonar\scanner
+          path: .sonar\scanner
           key: ${{ runner.os }}-sonar-scanner
           restore-keys: ${{ runner.os }}-sonar-scanner
 
       - name: Install SonarQube Cloud scanner
         if: steps.cache-sonar-scanner.outputs.cache-hit != 'true'
         shell: powershell
         run: |
-          cd myfinance-web-wo-top-level-statement
           New-Item -Path .\.sonar\scanner -ItemType Directory
           dotnet tool update dotnet-sonarscanner --tool-path .\.sonar\scanner
 
@@ -50,7 +49,6 @@ jobs:
           SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
         shell: powershell
         run: |
-          cd myfinance-web-wo-top-level-statement
           .\.sonar\scanner\dotnet-sonarscanner begin /k:"dickson-souza-projects_myfinance-web-dotnet" /o:"dickson-souza-projects-sonarqube-cloud" /d:sonar.token="${{ secrets.SONAR_TOKEN }}" /d:sonar.host.url="https://sonarcloud.io"
           dotnet build
           .\.sonar\scanner\dotnet-sonarscanner end /d:sonar.token="${{ secrets.SONAR_TOKEN }}"

README.md

@@ -1,2 +1,30 @@
-# MyFinanceWeb
-Repositório com o conteúdo do trabalho prático da disciplina Práticas de Implementação e Evolução de Software
+# Sobre esse repositório
+
+Repositório com o conteúdo do trabalho prático da disciplina **Práticas de Implementação e Evolução de Software** da Pós graduação em Engenharia de Software - Oferta 7 - Turma 1 - do Instituto de Educação Continuada da PUC Minas
+
+# Sobre o projeto
+
+Esse projeto didático teve o intuito de criar uma pequena aplicação financeira para uso pessoal. A aplicação foi criada em ASP.NET MVC (Model-View-Controller) com Razor pages e persistência de dados em Microsoft SQL Server 2022, Developer Edition. O mapeamento dos dados foi feito usando Entity Framework Core 9.
+
+## Como executar a aplicação em ambiente local
+
+### Pré-requisitos
+Para executar essa aplicação são necessários os seguintes requisitos:
+- Ter o SDK do .NET instalado em versões iguais ou superiores ao **.NET 8**
+  - Para essa versão, consulte o link [Download .NET 8.0](https://dotnet.microsoft.com/en-us/download/dotnet/8.0));
+- Um **editor de código** como o `Visual Studio Code` ou uma **IDE** como `Visual Studio Community 2022`
+  - Essas são apenas sugestões de uso mas outros editores e IDEs podem ser também usados;
+- E uma versão do **Microsoft SQL Server 2022** instalada no seu computador (para criar o banco para o desenvolvimento e execução)
+  - Ou ainda acesso a uma instância do **Azure SQL Server** com permissão para criar um novo banco de dados.
+- Clonar esse repositório em seu computador usando os comandos abaixo:
+```bash
+# Escolher um diretório para clonar o repositório
+cd {diretório de sua preferência}
+
+# Comando para clonar o repositório
+git clone https://github.com/dickson-souza-projects/myfinance-web-dotnet.git
+
+# Acessar o conteúdo do repositório
+cd myfinance-web-dotnet
+```
+