+🚀 API REST densenvolvida em .NET Core!
+ +
+
-
+## Sobre
+O projeto IFound trata-se de uma API REST para prover dados a um site de achados e perdidos
-Seja bem-vindo a [Accurate Software](https://accurate.com.br).
+## Tabela de conteúdos
+
+ * [Sobre](#sobre)
+ * [Tabela de Conteúdos](#tabela-de-conteúdos)
+ * [Features](#features)
+ * [Tecnologias](#-tecnologias)
+ * [Pré-requisitos](#pré-requisitos)
+ * [Rodando a aplicação](#rodando-a-aplicação)
+ * [Testes](#testes)
+
-Temos diversas vagas para desenvolvedores: Frontend, Backend e Fullstack!
+### Features
-> Para conhecer melhor os candidatos, preparamos um desafio técnico. Não se preocupe em cumprir todos os requisitos propostos no desafio, este teste visa avaliar a sua capacidade de resolução de problemas. Abaixo serão apresentados dois desafios direcionados aos perfis frontend e backend, caso o seu perfil for voltado para fullstack fique a vontade em nos enviar uma solução completa abordando tanto frontend quanto backend!
+- [x] Cadastro de um “Achado”/”Perdido”
+- [x] Atualização de histórico de um “Achado”/”Perdido”
+- [x] Busca com opção de filtros
+- [x] Relatório de cruzamento de informações “Achados”/”Perdidos”, dado um categoria e um raio
-## Instruções
+### 🛠 Tecnologias
+Para a construção deste projeto, foram utilizadas as seguintes ferramentas:
+#### No Back-End:
+- [.NET Core](https://dotnet.microsoft.com/)
+- [Entity Framework Core](https://docs.microsoft.com/pt-br/ef/core/)
+- [SQL Server](https://www.microsoft.com/en-us/sql-server)
+- [XUnit](https://xunit.net/)
+- [OData](https://www.odata.org/)
-1. Para começar o desafio, realize um fork no repositório: https://github.com/accurate-software/accurate-software.github.io
+#### No Front-End
+- [Angular](https://angular.io/)
+- [Jasmine](https://jasmine.github.io/)
-2. O desafio deverá set commitado no fork.
+### Pré-requisitos
+Antes de começar, você precisará ter instalado em sua máquina as seguintes ferramentas:
+* Git (https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+* SDK Do ASP.NET Core Versão 3.1 (https://dotnet.microsoft.com/download/dotnet-core/3.1)
+* SQL Server LocalDB (https://docs.microsoft.com/pt-br/sql/database-engine/configure-windows/sql-server-express-localdb?view=sql-server-ver15) ou seu banco de dados de preferência
+* NPM (https://www.npmjs.com/get-npm)
+* CLI do Angular (https://cli.angular.io/)
-3. Após a finalização do desafio, solicite um pull request do fork no nosso repositório ;)
+### Rodando a aplicação
+#### API IFound
+Para instalar e rodar o projeto em sua máquina, siga os seguintes passos;
+* Rode o comando "git clone 'url-do-repositorio'" na sua máquina local
+* Para facilitar a criação das estruturas no banco, criei um script para o SQL Server (SetUpDB.sql), basta executá-lo
+* Mude a string de conexão com o banco no arquivo 'appsettings.json' com os seus dados de conexão
+* Mudar a string de conexão em 'appsettings.json' com os dados do seu banco
+* Dentro da pasta "ifound-api", rode o projeto via comando "dotnet run ifound-api.csproj"
-### Desafio Frontend
+#### Aplicação front-end
+* Na pasta 'front-end-ifound' instale os pacotes via 'npm install'
+* Execute a aplicação via comando 'ng serve'
-O seu desafio é realizar um desenvolvimento de uma aplicação frontend que compra os requisitos:
+### Testes
+As demonstrações dos testes foram todas feitas via ferramenta Postman (https://www.postman.com/). Neste artigo, foi feita uma simples demonstração de funcionalidade para cada feature existente no backlog do projeto.
-+ Consumo de API REST
-+ CRUD ou listagem de algum recurso da API
-+ Utilizar alguma API pública, podendo ser alguma do site: https://public-apis.xyz/
+#### Feature: Cadastro de um “Achado”/”Perdido”
+Para esta feature, foi feita uma demonstração com o cadastro de um produto por meio do endpoint "AddObject". A este endpoint foram passadas as informações do objeto, assim como sua categoria e dados das pessoas que perderam o objeto ou o encontraram. Desse modo, o objeto foi registrado com o id de categoria igual a 3 (por ser da categproa sapato) e foram assosiados a ele os ids 2 e 3 das pessoas que o perderam e o encontraram respectivamente.
-Vamos avaliar a sua capacidade como desenvolvedor frontend, observando os critérios:
+
-+ Uso semântico do HTML
-+ Estruturação do layout e tags CSS
-+ Layout acessível e responsivo
-+ Utilização de frameworks da atualizade, como: React, Vue, Angular ou algum outro de sua preferência.
-+ Lembre-se de documentar a solução com um README.MD :)
+#### Feature: Atualização de histórico de um “Achado”/”Perdido”
+Pada demonstrar esta feature, foi utilizado o endpoint "UpdateObject". Neste sentido, foram passados os dados do objeto a que se tem a intenção de atualizar. Para isso, foi escolhido o objeto de id igual a 5 (Smartphone Xiaomi Note 8). Foram atualizados os campos de descrição do objeto e o local em que foi perdido. A seguir, pode-se ver que os dados foram persisitidos ao se fazer uma consulta de todos os objetos via endpoint "GelAllObjects".
-### Desafio Backend
+
+
+#### Feature: Busca com opção de filtros
+Na demonstração desta feature foi utilizado o endpoint "GetAllObjects" para se validar a funcionalidade dos filtros. Estes foram implementados via pacote OData da Microsoft, que permite consultas personalizadas aos endpoints da API. Para demonstrar a eficiência dos filtros, primeiro fez-e uma consulta de todos osobjetos do endpoint. Logo após isso, fez-se uma consulta de todos os objetos que possuiam a propriedade "ObjectId" da entidade "Object" com valor igual a 5. Para isso, foi incorpordado à URL da requisição os seguintes parâmetros:
+
+* _"$Filter=Object/ObjectId eq 5"_
+
+A seguir, fez-se uma consulta de todos os objetos que possuiam a propriedade "CategoryId" da entidade "ObjectCategory" com valor igual a 1 (categoria de roupas), mudando os parâmetros como o axemplo:
+
+* _?$Filter=ObjectCategory/CategoryId eq 1_
+
+
+
+#### Feature: Relatório de cruzamento de informações “Achados”/”Perdidos”, dado uma categoria e um raio
+Por fim, para se demonstrar a última feature do backlog, foi feita uma consulta com o seguinte filtro:
+
+* _?$Filter=ObjectCategory/CategoryId eq 3 and Object/ObjectLostLocation eq 'São José do Rio Preto / SP'_
+
+Com isso, temos um relatório dos objetos com base em sua categoria e localização. Na demonstração, pode-se observar que foram encontrados dois produtos (Tênis da Nike e Tênis da Adidas), ambos com id de categoria igual a 3 (sapatos) e tambeém ambos com localização de onde foram perdidos igual a 'São José do Rio Preto / SP'
+
+
+
+#### Demonstrações no Front-End
+Para dar mais realismo ao projeto, foi desenvolvida uma aplicação front-end simples em Angular 10 que ilustra algumas de suas features.
+Primeiramente, pode-se ver na demosntração a seguir, como é feita a listagem dos objetos pela aplicação. Ao clicar sobre determinado objeto, são exibidas as suas informações.
+
+
+
+Em seguida, clicando no botão de editar, é possivel por meio da tela de detalhe do item, poder editar qualquer uma de suas informações. Na demonstração, assim que o item é editado e não ocorre nenhuma exceção é possível ver a modificação já na tela de listagem.
+
+
+
+Por fim, para ilustrar a operação de cadastro de um achado ou perdido, na demonstração a seguir é cadastrado um objeto via tela tela de cadastro e em seguida, a nova inserção pode ser visualizada na tela de listagem de itens.
+
+
-O seu desafio é realizar um desenvolvimento de uma API Rest para um site de achados e perfidos. Sua API deve conter as seguintes funcionalidades:
-+ Cadastro de um "Achado"/"Perdido"
-+ Atualização de histórico de um "Achado"/"Perdido"
-+ Busca com opção de filtros, como por exemplo: Categoria
-+ Relatório de cruzamento de informações "Achados"/"Perdidos", dado um categoria e um raio.
-Fique a vontade para usar a linguagem e framework de sua preferência, como: Java, C# e Node! Porém se atente aos seguintes pontos:
-+ Tratamento de erros e exceções
-+ Clareza e clean code no desenvolvimento da solução
-+ Documentação da solução - README.MD :)
diff --git a/SetUpDB.sql b/SetUpDB.sql
new file mode 100644
index 0000000..96a40dd
--- /dev/null
+++ b/SetUpDB.sql
@@ -0,0 +1,212 @@
+/*********************************************************************
+* *
+* SQL Server script to create and populate a database for IFound API *
+* *
+*********************************************************************/
+
+CREATE DATABASE IFound
+GO
+
+USE [IFound]
+GO
+
+SET ANSI_NULLS ON
+GO
+
+SET QUOTED_IDENTIFIER ON
+GO
+--Person table
+CREATE TABLE [dbo].[Person](
+ [PersonId] [int] NOT NULL,
+ [Name] [varchar](50) NULL,
+ [Age] [int] NULL,
+ [Nationality] [varchar](50) NULL,
+ [Telephone] [varchar](50) NULL,
+ [Email] [varchar](50) NULL,
+PRIMARY KEY CLUSTERED
+(
+ [PersonId] ASC
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
+) ON [PRIMARY]
+
+GO
+
+--Insert some data
+INSERT INTO [dbo].[Person]
+ ([PersonId]
+ ,[Name]
+ ,[Age]
+ ,[Nationality]
+ ,[Telephone]
+ ,[Email])
+ VALUES
+ (2
+ ,'Ana Moreira'
+ ,22
+ ,'Brasileiro(a)'
+ ,'(60) 63384-0485'
+ ,'ana@email.com.br')
+
+GO
+
+--Category table
+CREATE TABLE [dbo].[Category](
+ [CategoryId] [int] NOT NULL,
+ [CategoryDescription] [varchar](50) NULL,
+PRIMARY KEY CLUSTERED
+(
+ [CategoryId] ASC
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
+) ON [PRIMARY]
+
+GO
+
+--Insert Some DATABASE
+INSERT INTO [dbo].[Category]
+ ([CategoryId]
+ ,[CategoryDescription])
+ VALUES
+ (3
+ ,'Sapatos')
+
+GO
+
+--Object TABLE
+CREATE TABLE [dbo].[Object](
+ [ObjectName] [varchar](50) NULL,
+ [ObjectDescription] [varchar](50) NULL,
+ [ObjectStatus] [varchar](50) NULL,
+ [ObjectPhoto] [varchar](50) NULL,
+ [ObjectFoundLocation] [varchar](50) NULL,
+ [ObjectLostLocation] [varchar](50) NULL,
+ [ObjectCreationDate] [varchar](50) NULL,
+ [ObjectLastUpdate] [varchar](50) NULL,
+ [Category_FK] [int] NULL,
+ [PersonWhoFound_FK] [int] NULL,
+ [PersonWhoLost_FK] [int] NULL,
+ [ObjectId] [int] IDENTITY(1,1) NOT NULL,
+PRIMARY KEY CLUSTERED
+(
+ [ObjectId] ASC
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]
+) ON [PRIMARY]
+GO
+
+ALTER TABLE [dbo].[Object] WITH CHECK ADD FOREIGN KEY([Category_FK])
+REFERENCES [dbo].[Category] ([CategoryId])
+GO
+
+ALTER TABLE [dbo].[Object] WITH CHECK ADD FOREIGN KEY([PersonWhoFound_FK])
+REFERENCES [dbo].[Person] ([PersonId])
+GO
+
+ALTER TABLE [dbo].[Object] WITH CHECK ADD FOREIGN KEY([PersonWhoLost_FK])
+REFERENCES [dbo].[Person] ([PersonId])
+GO
+
+GO
+
+SET ANSI_NULLS ON
+GO
+
+SET QUOTED_IDENTIFIER ON
+GO
+
+--Procedure to add object
+CREATE PROCEDURE [dbo].[sp_AddFoundOrLost]
+ @ObjectName NVARCHAR(50) ,
+ @ObjectDescription NVARCHAR(50) ,
+ @ObjectStatus NVARCHAR(50) ,
+ @ObjectPhoto NVARCHAR(50) ,
+ @ObjectFoundLocation NVARCHAR(50) ,
+ @ObjectLostLocation NVARCHAR(50) ,
+ @ObjectCreationDate NVARCHAR(50) ,
+ @ObjectLastUpdate NVARCHAR(50),
+ @Category_FK integer,
+ @PersonWhoFound_FK integer,
+ @PersonWhoLost_FK integer,
+ @SuccessOnAdding int OUTPUT
+
+AS
+BEGIN
+
+ INSERT INTO [dbo].[Object]
+ (
+ ObjectName,
+ ObjectDescription,
+ ObjectStatus,
+ ObjectPhoto,
+ ObjectFoundLocation,
+ ObjectLostLocation,
+ ObjectCreationDate,
+ ObjectLastUpdate,
+ Category_FK,
+ PersonWhoFound_FK,
+ PersonWhoLost_FK
+ )
+ VALUES
+ (
+ @ObjectName,
+ @ObjectDescription,
+ @ObjectStatus,
+ @ObjectPhoto,
+ @ObjectFoundLocation,
+ @ObjectLostLocation,
+ @ObjectCreationDate,
+ @ObjectLastUpdate,
+ @Category_FK,
+ @PersonWhoFound_FK,
+ @PersonWhoLost_FK
+ )
+ IF(@@ROWCOUNT>0) SET @SuccessOnAdding=1
+ ELSE SET @SuccessOnAdding=0
+END
+
+GO
+
+--Procedure to update object
+CREATE PROCEDURE [dbo].[sp_UpdateFoundOrLost]
+ @ObjectId INTEGER,
+ @ObjectName NVARCHAR(50) ,
+ @ObjectDescription NVARCHAR(50) ,
+ @ObjectStatus NVARCHAR(50) ,
+ @ObjectPhoto NVARCHAR(50) ,
+ @ObjectFoundLocation NVARCHAR(50) ,
+ @ObjectLostLocation NVARCHAR(50) ,
+ @ObjectCreationDate NVARCHAR(50) ,
+ @ObjectLastUpdate NVARCHAR(50),
+ @Category_FK integer,
+ @PersonWhoFound_FK integer,
+ @PersonWhoLost_FK integer,
+ @SuccessOnUpdating int OUTPUT
+
+AS
+BEGIN
+ UPDATE [dbo].[Object]
+ SET
+ ObjectName = @ObjectName,
+ ObjectDescription = @ObjectDescription,
+ ObjectStatus = @ObjectStatus,
+ ObjectPhoto = @ObjectPhoto,
+ ObjectFoundLocation = @ObjectFoundLocation,
+ ObjectLostLocation = @ObjectLostLocation,
+ ObjectCreationDate = @ObjectCreationDate,
+ ObjectLastUpdate = @ObjectLastUpdate,
+ Category_FK = @Category_FK,
+ PersonWhoFound_FK = @PersonWhoFound_FK,
+ PersonWhoLost_FK = @PersonWhoLost_FK
+
+ WHERE
+ ObjectId = @ObjectId
+
+ IF(@@ROWCOUNT>0) SET @SuccessOnUpdating=1
+ ELSE SET @SuccessOnUpdating=0
+END
+GO
+
+
+
+
+
+
+
diff --git a/_config.yml b/_config.yml
index 847b377..aa90449 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,6 +1,6 @@
theme: jekyll-theme-architect
name: Accurate Software
-title: null
+title: ifound-api
#remote_theme: accurate-software/dactl
diff --git a/front-end-ifound/.browserslistrc b/front-end-ifound/.browserslistrc
new file mode 100644
index 0000000..fb92325
--- /dev/null
+++ b/front-end-ifound/.browserslistrc
@@ -0,0 +1,17 @@
+# This file is used by the build system to adjust CSS and JS output to support the specified browsers below.
+# For additional information regarding the format and rule options, please see:
+# https://github.com/browserslist/browserslist#queries
+
+# For the full list of supported browsers by the Angular framework, please see:
+# https://angular.io/guide/browser-support
+
+# You can see what browsers were selected by your queries by running:
+# npx browserslist
+
+last 1 Chrome version
+last 1 Firefox version
+last 2 Edge major versions
+last 2 Safari major version
+last 2 iOS major versions
+Firefox ESR
+not IE 9-11 # For IE 9-11 support, remove 'not'.
diff --git a/front-end-ifound/.editorconfig b/front-end-ifound/.editorconfig
new file mode 100644
index 0000000..59d9a3a
--- /dev/null
+++ b/front-end-ifound/.editorconfig
@@ -0,0 +1,16 @@
+# Editor configuration, see https://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.ts]
+quote_type = single
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false
diff --git a/front-end-ifound/.gitignore b/front-end-ifound/.gitignore
new file mode 100644
index 0000000..86d943a
--- /dev/null
+++ b/front-end-ifound/.gitignore
@@ -0,0 +1,46 @@
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+
+# compiled output
+/dist
+/tmp
+/out-tsc
+# Only exists if Bazel was run
+/bazel-out
+
+# dependencies
+/node_modules
+
+# profiling files
+chrome-profiler-events*.json
+speed-measure-plugin*.json
+
+# IDEs and editors
+/.idea
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.sublime-workspace
+
+# IDE - VSCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+.history/*
+
+# misc
+/.sass-cache
+/connect.lock
+/coverage
+/libpeerconnection.log
+npm-debug.log
+yarn-error.log
+testem.log
+/typings
+
+# System Files
+.DS_Store
+Thumbs.db
diff --git a/front-end-ifound/README.md b/front-end-ifound/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/front-end-ifound/angular.json b/front-end-ifound/angular.json
new file mode 100644
index 0000000..ea58cbe
--- /dev/null
+++ b/front-end-ifound/angular.json
@@ -0,0 +1,128 @@
+{
+ "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+ "version": 1,
+ "newProjectRoot": "projects",
+ "projects": {
+ "Angular10Crud": {
+ "projectType": "application",
+ "schematics": {},
+ "root": "",
+ "sourceRoot": "src",
+ "prefix": "app",
+ "architect": {
+ "build": {
+ "builder": "@angular-devkit/build-angular:browser",
+ "options": {
+ "outputPath": "dist/Angular10Crud",
+ "index": "src/index.html",
+ "main": "src/main.ts",
+ "polyfills": "src/polyfills.ts",
+ "tsConfig": "tsconfig.app.json",
+ "aot": true,
+ "assets": [
+ "src/favicon.ico",
+ "src/assets"
+ ],
+ "styles": [
+ "src/styles.css"
+ ],
+ "scripts": []
+ },
+ "configurations": {
+ "production": {
+ "fileReplacements": [
+ {
+ "replace": "src/environments/environment.ts",
+ "with": "src/environments/environment.prod.ts"
+ }
+ ],
+ "optimization": true,
+ "outputHashing": "all",
+ "sourceMap": false,
+ "extractCss": true,
+ "namedChunks": false,
+ "extractLicenses": true,
+ "vendorChunk": false,
+ "buildOptimizer": true,
+ "budgets": [
+ {
+ "type": "initial",
+ "maximumWarning": "2mb",
+ "maximumError": "5mb"
+ },
+ {
+ "type": "anyComponentStyle",
+ "maximumWarning": "6kb",
+ "maximumError": "10kb"
+ }
+ ]
+ }
+ }
+ },
+ "serve": {
+ "builder": "@angular-devkit/build-angular:dev-server",
+ "options": {
+ "browserTarget": "Angular10Crud:build"
+ },
+ "configurations": {
+ "production": {
+ "browserTarget": "Angular10Crud:build:production"
+ }
+ }
+ },
+ "extract-i18n": {
+ "builder": "@angular-devkit/build-angular:extract-i18n",
+ "options": {
+ "browserTarget": "Angular10Crud:build"
+ }
+ },
+ "test": {
+ "builder": "@angular-devkit/build-angular:karma",
+ "options": {
+ "main": "src/test.ts",
+ "polyfills": "src/polyfills.ts",
+ "tsConfig": "tsconfig.spec.json",
+ "karmaConfig": "karma.conf.js",
+ "assets": [
+ "src/favicon.ico",
+ "src/assets"
+ ],
+ "styles": [
+ "src/styles.css"
+ ],
+ "scripts": []
+ }
+ },
+ "lint": {
+ "builder": "@angular-devkit/build-angular:tslint",
+ "options": {
+ "tsConfig": [
+ "tsconfig.app.json",
+ "tsconfig.spec.json",
+ "e2e/tsconfig.json"
+ ],
+ "exclude": [
+ "**/node_modules/**"
+ ]
+ }
+ },
+ "e2e": {
+ "builder": "@angular-devkit/build-angular:protractor",
+ "options": {
+ "protractorConfig": "e2e/protractor.conf.js",
+ "devServerTarget": "Angular10Crud:serve"
+ },
+ "configurations": {
+ "production": {
+ "devServerTarget": "Angular10Crud:serve:production"
+ }
+ }
+ }
+ }
+ }
+ },
+ "defaultProject": "Angular10Crud",
+ "cli": {
+ "analytics": false
+ }
+}
\ No newline at end of file
diff --git a/front-end-ifound/e2e/protractor.conf.js b/front-end-ifound/e2e/protractor.conf.js
new file mode 100644
index 0000000..f238c0b
--- /dev/null
+++ b/front-end-ifound/e2e/protractor.conf.js
@@ -0,0 +1,36 @@
+// @ts-check
+// Protractor configuration file, see link for more information
+// https://github.com/angular/protractor/blob/master/lib/config.ts
+
+const { SpecReporter, StacktraceOption } = require('jasmine-spec-reporter');
+
+/**
+ * @type { import("protractor").Config }
+ */
+exports.config = {
+ allScriptsTimeout: 11000,
+ specs: [
+ './src/**/*.e2e-spec.ts'
+ ],
+ capabilities: {
+ browserName: 'chrome'
+ },
+ directConnect: true,
+ baseUrl: 'http://localhost:4200/',
+ framework: 'jasmine',
+ jasmineNodeOpts: {
+ showColors: true,
+ defaultTimeoutInterval: 30000,
+ print: function() {}
+ },
+ onPrepare() {
+ require('ts-node').register({
+ project: require('path').join(__dirname, './tsconfig.json')
+ });
+ jasmine.getEnv().addReporter(new SpecReporter({
+ spec: {
+ displayStacktrace: StacktraceOption.PRETTY
+ }
+ }));
+ }
+};
\ No newline at end of file
diff --git a/front-end-ifound/e2e/src/app.e2e-spec.ts b/front-end-ifound/e2e/src/app.e2e-spec.ts
new file mode 100644
index 0000000..8672776
--- /dev/null
+++ b/front-end-ifound/e2e/src/app.e2e-spec.ts
@@ -0,0 +1,23 @@
+import { AppPage } from './app.po';
+import { browser, logging } from 'protractor';
+
+describe('workspace-project App', () => {
+ let page: AppPage;
+
+ beforeEach(() => {
+ page = new AppPage();
+ });
+
+ it('should display welcome message', () => {
+ page.navigateTo();
+ expect(page.getTitleText()).toEqual('Angular10Crud app is running!');
+ });
+
+ afterEach(async () => {
+ // Assert that there are no errors emitted from the browser
+ const logs = await browser.manage().logs().get(logging.Type.BROWSER);
+ expect(logs).not.toContain(jasmine.objectContaining({
+ level: logging.Level.SEVERE,
+ } as logging.Entry));
+ });
+});
diff --git a/front-end-ifound/e2e/src/app.po.ts b/front-end-ifound/e2e/src/app.po.ts
new file mode 100644
index 0000000..b68475e
--- /dev/null
+++ b/front-end-ifound/e2e/src/app.po.ts
@@ -0,0 +1,11 @@
+import { browser, by, element } from 'protractor';
+
+export class AppPage {
+ navigateTo(): PromiseSelecione um objeto
+{{ message }}
+Cannot access this Tutorial...
+🚀 API REST para prover dados a um site de achados e perdidos
+ +
+
+
+## Sobre
+O projeto IFound trata-se de uma API REST para um site de achados e perdidos
+
+## Tabela de conteúdos
+
+ * [Sobre](#Sobre)
+ * [Tabela de Conteudo](#tabela-de-conteudo)
+ * [Features](#features)
+ * [Tecnologias](#tecnologias)
+ * [Pré-Requisitos](#pre-requisitos)
+ * [Rodadando a aplicação](#instalacao)
+ * [Testes](#testes)
+
+
+### Features
+
+- [x] Cadastro de um “Achado”/”Perdido”
+- [x] Atualização de histórico de um “Achado”/”Perdido”
+- [x] Busca com opção de filtros
+- [x] Relatório de cruzamento de informações “Achados”/”Perdidos”, dado um categoria e um raio
+
+### 🛠 Tecnologias
+
+Para a construção deste projeto, foram utilizadas as seguintes ferramentas:
+
+- [.NET Core](https://dotnet.microsoft.com/)
+- [Entity Framework Core](https://docs.microsoft.com/pt-br/ef/core/)
+- [SQL Server](https://www.microsoft.com/en-us/sql-server)
+- [XUnit](https://xunit.net/)
+- [OData](https://www.odata.org/)
+
+### Pré-requisitos
+Antes de começar, você precisará ter instaladas em sua máquina as seguintes ferramentas:
+* Git (https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+* SDK Do ASP.NET Core Versão 3.1 (https://dotnet.microsoft.com/download/dotnet-core/3.1)
+* SQL Server LocalDB (https://docs.microsoft.com/pt-br/sql/database-engine/configure-windows/sql-server-express-localdb?view=sql-server-ver15) ou seu banco de dados de preferência
+
+### Rodando a aplicação
+Para instalar e rodar o projeto em sua máquina, siga os seguintes passos;
+* Rode o comando "git clone 'url-do-repositorio'" na sua máquina local
+* Para facilitar a criação das estruturas no banco, criei um script para o SQL Server (SetUpDB.sql), basta executá-lo
+* Mude a string de conexão com o banco no arquivo 'appsettings.json' com os seus dados de conexão
+* Mudar a string de conexão em 'appsettings.json' com os dados do seu banco
+* Dentro da pasta "ifound-api", rode o projeto via comando "dotnet run ifound-api.csproj"
+
+### Testes
+As demonstrações dos testes foram todas feitas via ferramenta Postman. Para tal segue cada uma delas para cada feature presente no backlog do projeto:
+
+#### Feature: Cadastro de um “Achado”/”Perdido”
+Nesta demonstração, foi cadastrado um produto por meio do endpoint "AddObject". A este endpoint foram passadas as informações do objeto, assim como sua categoria e dados das pessoas que perderam o objeto ou o encontraram (se existirem). Desse modo, o objeto foi registrado com o id de categoria igual a 3 (por ser da categproa sapato) e foram assosiados a ele os ids de pessoas que perderam e o encontraram 2 e 3 respectivamente.
+
+
+
+#### Feature: Atualização de histórico de um “Achado”/”Perdido”
+Para esta demonstração, foi utilizado o endpoint "UpdateObject". Neste sentido, foram passados os dado do objeto a que se tem a intenção de atualizar, teste caso, o objeto de id igual a 5 (smartphone Xiaomi Note 8). Foram atualizados os camps de descrição do objeto e Local em que foi perdido. A seguir, pode-se ver que os dados foram persisitidos ao se fazer uma consulta de todos os objetos via endpoint "GelAllObjects"
+
+
+#### Feature: Busca com opção de filtros
+Aqui, foi utilizado o endpoint "GetAllObjects" para a demonstração dos filtros. Estes foram implementados via pacote OData da Microsoft, que permite consultas personalizadas aos endpoints da API. Para demonstrar a eficiência dos filtros, primeiro fez-e uma consulta de todos osobjetos do endpoint. Logo após isso, fez-se ma consulta de todos os objetos que possuiam a propriedade "ObjectId" da entidade "Object" com valor igual a 5 adicionando-se para esta finalidade, a seguinte descrição à requisição:
+"$Filter=Object/ObjectId eq 5"
+A seguir, fez-se uma consulta dde todos os objetos que possuiam a propriedade "CategoryId" da entidade "ObjectCategory" com valor igual a 1 (categoria de roupas). Para isso, foi adicionada a seguinte descrição à requisição:
+?$Filter=ObjectCategory/CategoryId eq 1
+
+
+#### Feature: Relatório de cruzamento de informações “Achados”/”Perdidos”, dado um categoria e um raio
+Neste caso para se fazer um relatório com base na categoria e na localização dos objetos, foi feita uma consulta com o seguinte filtro:
+?$Filter=ObjectCategory/CategoryId eq 3 and Object/ObjectLostLocation eq 'São José do Rio Preto / SP'
+Na demonstração, pode-se observar que foram encontrados dois produtos (tênis da Nike e Tênis da Adidas), ambos com id de categoria igual a 3 (sapatos) e tambeém ambos com localização de onde foram perdidos igual a 'São José do Rio Preto / SP'
+
+
+
diff --git a/ifound-api/Startup.cs b/ifound-api/Startup.cs
new file mode 100644
index 0000000..1d9c188
--- /dev/null
+++ b/ifound-api/Startup.cs
@@ -0,0 +1,71 @@
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using Microsoft.EntityFrameworkCore;
+using System;
+using System.Text.Json;
+using Newtonsoft.Json.Serialization;
+using System.Security.Principal;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNet.OData.Extensions;
+
+namespace ifound_api
+{
+ public class Startup
+ {
+ public IConfiguration Configuration { get; }
+ public Startup(IConfiguration configuration)
+ {
+ Configuration = configuration;
+ }
+
+ // This method gets called by the runtime. Use this method to add services to the container.
+ public void ConfigureServices(IServiceCollection services)
+ {
+ services.AddControllers(mvcOptions =>
+ mvcOptions.EnableEndpointRouting = false);
+ services.AddControllersServices();
+ services.AddMvcServices();
+ services.AddCors();
+ services.AddHttpContextAccessor();
+ services.ConfigureCompression();
+ services.AddJWTAuthentication(Configuration);
+ services.AddOData();
+ ContainerIoc.InitializeIoC(services);
+ }
+
+ // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
+ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
+ {
+ if (env.IsDevelopment())
+ app.UseDeveloperExceptionPage();
+ else
+ app.UseHttpsRedirection();
+
+ app.UseRouting();
+
+ // global cors policy
+ app.UseCors(x => x
+ .AllowAnyOrigin()
+ .AllowAnyMethod()
+ .AllowAnyHeader());
+
+ app.UseAuthentication();
+ app.UseAuthorization();
+
+ app.UseResponseCompression();
+
+ app.UseEndpoints(endpoints =>
+ {
+ endpoints.MapControllers();
+ });
+ app.UseMvc(routeBuilder =>
+ {
+ routeBuilder.EnableDependencyInjection();
+ routeBuilder.Expand().Select().Count().OrderBy().Filter();
+ });
+ }
+ }
+}
diff --git a/ifound-api/StartupExtensions.cs b/ifound-api/StartupExtensions.cs
new file mode 100644
index 0000000..53f0b62
--- /dev/null
+++ b/ifound-api/StartupExtensions.cs
@@ -0,0 +1,78 @@
+using System.IO.Compression;
+using System.Text;
+using System.Text.Json;
+using Core.Repository.EntityFramework;
+using Core.Web.Api.Filters;
+using Microsoft.AspNetCore.Authentication;
+using Microsoft.AspNetCore.Authentication.JwtBearer;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Mvc.Authorization;
+using Microsoft.AspNetCore.ResponseCompression;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.IdentityModel.Tokens;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Serialization;
+
+namespace ifound_api
+{
+ public static class StartupExtensions
+ {
+ public static void AddMvcServices(this IServiceCollection services)
+ {
+ services.AddMvc(config =>
+ {
+ var policy = new AuthorizationPolicyBuilder()
+ .RequireAuthenticatedUser()
+ .Build();
+ config.Filters.Add(new AuthorizeFilter(policy));
+ //config.Filters.Add(new APIExceptionFilter());
+ })
+ .AddNewtonsoftJson(x =>
+ {
+ x.SerializerSettings.ReferenceLoopHandling = Newtonsoft.Json.ReferenceLoopHandling.Ignore;
+ });
+ }
+
+ public static void AddControllersServices(this IServiceCollection services)
+ {
+ services.AddControllers()
+ .AddNewtonsoftJson(options =>
+ {
+ options.SerializerSettings.ContractResolver = new DefaultContractResolver();
+ options.SerializerSettings.ReferenceLoopHandling = Newtonsoft.Json.ReferenceLoopHandling.Ignore;
+ });
+ }
+
+ public static void ConfigureCompression(this IServiceCollection services)
+ {
+ // Configure Compression level
+ services.Configure