{"id":28051548,"url":"https://github.com/giacominimarco/systemlogin","last_synced_at":"2026-04-10T13:31:58.403Z","repository":{"id":290680226,"uuid":"975176148","full_name":"giacominimarco/SystemLogin","owner":"giacominimarco","description":"Authentication and Redirection of Routes with Valid Credences","archived":false,"fork":false,"pushed_at":"2025-05-07T16:47:41.000Z","size":77,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-12T01:55:11.671Z","etag":null,"topics":["axios","jwt-token","react","sql-server","vite"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/giacominimarco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-29T22:54:29.000Z","updated_at":"2025-05-08T19:07:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"9f9bfc96-439e-44c2-be7c-dfcf3d858a39","html_url":"https://github.com/giacominimarco/SystemLogin","commit_stats":null,"previous_names":["giacominimarco/systemlogin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giacominimarco%2FSystemLogin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giacominimarco%2FSystemLogin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giacominimarco%2FSystemLogin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giacominimarco%2FSystemLogin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/giacominimarco","download_url":"https://codeload.github.com/giacominimarco/SystemLogin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253660837,"owners_count":21943823,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","jwt-token","react","sql-server","vite"],"created_at":"2025-05-12T01:55:24.270Z","updated_at":"2025-12-30T21:29:30.526Z","avatar_url":"https://github.com/giacominimarco.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SystemLogin\n\nSistema de Login com React, .NET Core e SQL Server\n\nEste projeto é um sistema de login completo que utiliza React para o frontend, .NET Core para o backend e SQL Server para armazenamento de dados. Ele implementa autenticação via REST API com suporte a paginação para listar usuários.\n\n---\n\n## Estrutura do Projeto\n\nO projeto está dividido em três partes principais:\n\n- **Frontend**: Aplicação React utilizando Vite para desenvolvimento rápido.\n- **Backend**: API REST desenvolvida com ASP.NET Core para autenticação e gerenciamento de usuários.\n- **Testes Unitários**: Projeto de testes com `xUnit` para validar o comportamento da aplicação no backend.\n\n---\n\n## Tecnologias Utilizadas\n\n### Backend\n- **ASP.NET Core 8.0**\n- **SQL Server**\n- **Entity Framework Core**\n- **JWT (JSON Web Tokens)**\n- **xUnit** (para testes)\n- **Moq** (para mocks em testes)\n\n### Frontend\n- **React 18.x**\n- **TypeScript**\n- **Vite**\n- **Axios**\n\n---\n\n## Como Rodar o Projeto\n\n### 1. Rodando o Backend (API)\n\n#### Pré-requisitos\n- **.NET 8.0 SDK** instalado (Baixe o .NET SDK)\n- **SQL Server** (ou SQL Server Express) instalado e rodando (Baixe o SQL Server)\n\n#### Passos\n\n1. **Clone o repositório**: Clone o repositório do projeto para o seu diretório local:\n\n    ```bash\n    git clone https://github.com/giacominimarco/SystemLogin.git\n    ```\n\n2. **Navegue até a pasta do backend**: No terminal, vá até a pasta do projeto backend:\n\n    ```bash\n    cd SystemLogin/ProjetoLogin.API\n    ```\n\n3. **Restaurar as dependências**: Restaure as dependências do projeto backend:\n\n    ```bash\n    dotnet restore\n    ```\n\n4. **Configurar o banco de dados**: No arquivo `appsettings.json`, configure a string de conexão para o banco de dados SQL Server:\n\n    ```json\n    {\n      \"ConnectionStrings\": {\n        \"DefaultConnection\": \"Server=localhost;Database=SystemLogin;Trusted_Connection=True;\"\n      }\n    }\n    ```\n\n    **Nota**: Se você estiver usando o SQL Server Express, pode ser necessário ajustar a string de conexão, por exemplo, para:\n\n    ```json\n    \"DefaultConnection\": \"Server=localhost\\\\SQLEXPRESS;Database=SystemLogin;Trusted_Connection=True;\"\n    ```\n\n5. **Criar o banco de dados e as tabelas**: Crie o banco de dados e as tabelas utilizando Entity Framework Core. Execute o comando de migração:\n\n    ```bash\n    dotnet ef database update\n    ```\n\n    Esse comando criará as tabelas no banco de dados de acordo com os modelos definidos no código.\n\n6. **Rodar a aplicação**: Após as configurações, inicie o servidor da API:\n\n    ```bash\n    dotnet run\n    ```\n\n    O backend estará rodando por padrão em `http://localhost:5129`.\n\n### 2. Rodando o Frontend (React)\n\n#### Pré-requisitos\n- **Node.js** (versão \u003e= 16.8) instalado (Baixe o Node.js)\n- **npm** ou **yarn** instalado (gerenciador de pacotes)\n\n#### Passos\n\n1. **Navegue até a pasta do frontend**: No terminal, vá até a pasta do frontend:\n\n    ```bash\n    cd SystemLogin/frontend-login\n    ```\n\n2. **Instalar as dependências do frontend**: Instale as dependências necessárias do frontend:\n\n    ```bash\n    npm install\n    ```\n\n    Ou se estiver usando o **yarn**:\n\n    ```bash\n    yarn install\n    ```\n\n3. **Rodar a aplicação frontend**: Após a instalação das dependências, inicie o servidor de desenvolvimento:\n\n    ```bash\n    npm run dev\n    ```\n\n    Ou se estiver usando o **yarn**:\n\n    ```bash\n    yarn dev\n    ```\n\n    O frontend estará rodando em `http://localhost:5173`.\n\n\n\n### 3. Rodando os Testes Unitários\n\n#### Estrutura de Testes\n\nOs testes do backend estão localizados no projeto:\n\n```\nSystemLogin/ProjetoLogin.API.Tests/\n```\n\nEste projeto utiliza **xUnit** como framework de testes e **Moq** para criação de objetos simulados (mocks). Os testes abrangem, principalmente, a lógica de autenticação e geração de tokens da camada `UserService`.\n\n#### Executando os testes\n\n1. Navegue até a raiz do repositório (ou mantenha-se lá mesmo):\n```bash\ncd SystemLogin\n```\n\n2. Execute os testes com o comando:\n\n```bash\ndotnet test\n```\n\nEsse comando compilará o projeto de testes, executará os testes e exibirá um resumo com os resultados (total, sucesso ou falha).\n\n#### Dependências utilizadas nos testes\n\n- `xunit`\n- `xunit.runner.visualstudio`\n- `Moq`\n- `Microsoft.NET.Test.Sdk`\n\nEstas dependências já estão configuradas no `.csproj` do projeto de testes.\n\n\n### Sobre `UnitTest1.cs`\n\nO arquivo `UnitTest1.cs` é criado automaticamente como exemplo ao iniciar o projeto de testes com `xUnit`. Ele **pode ser removido com segurança** se você já escreveu seus próprios testes (ex: `UserServiceTests.cs`).\n\n---\n\n## O que deve estar instalado\n\nAntes de rodar o projeto, certifique-se de que você tem os seguintes softwares instalados:\n\n- **.NET SDK 8.0**: [Baixe o .NET SDK](https://dotnet.microsoft.com/download)\n- **SQL Server** (ou SQL Server Express): [Baixe o SQL Server](https://www.microsoft.com/pt-br/sql-server/sql-server-downloads)\n- **Node.js** (versão \u003e= 16.8): [Baixe o Node.js](https://nodejs.org/en/download/)\n- **npm** (gerenciador de pacotes do Node.js): O npm já vem com o Node.js, então, ao instalar o Node.js, o npm também será instalado.\n- **Visual Studio Code** (opcional, mas recomendado): [Baixe o Visual Studio Code](https://code.visualstudio.com/)\n- **Ferramentas do Entity Framework Core**: Instale as ferramentas do EF Core para rodar as migrações:\n\n    ```bash\n    dotnet tool install --global dotnet-ef\n    ```\n\n## Endpoints da API\n\nA API possui os seguintes endpoints:\n\n- **POST /api/user/login**: Realiza o login do usuário.\n\n    **Body** (exemplo):\n\n    ```json\n    {\n      \"username\": \"admin\",\n      \"password\": \"1234\"\n    }\n    ```\n\n- **GET /api/user/list**: Lista os usuários com paginação.\n\n    **Query Parameters**:\n    - **page**: Página (padrão 1)\n    - **pageSize**: Quantidade de itens por página (padrão 10)\n\n## Problemas Comuns\n\n- **Erro 404 na API**: Verifique se a API está rodando corretamente e acessível na URL correta (`http://localhost:5129`).\n- **Erro ao conectar ao banco de dados**: Verifique a string de conexão no arquivo `appsettings.json` e se o SQL Server está rodando corretamente.\n- **Erro de dependências no frontend**: Certifique-se de que todas as dependências foram instaladas corretamente com `npm install` ou `yarn install`.\n\n## Conclusão\n\nEste projeto demonstra uma aplicação full stack moderna com autenticação via JWT e testes automatizados no backend.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiacominimarco%2Fsystemlogin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiacominimarco%2Fsystemlogin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiacominimarco%2Fsystemlogin/lists"}