{"id":20564753,"url":"https://github.com/yagolopesmartins/fullstack_react-dashboard-admin-nest_api_auth","last_synced_at":"2026-04-02T04:45:57.010Z","repository":{"id":257040635,"uuid":"857135170","full_name":"YagoLopesMartins/FullStack_React-Dashboard-admin-nest_API_Auth","owner":"YagoLopesMartins","description":"Sistema completo CRUD de usuários com autenticação e recuperação de senha por e-mail (React/Nest)","archived":false,"fork":false,"pushed_at":"2024-09-26T22:53:17.000Z","size":14060,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-16T19:45:15.202Z","etag":null,"topics":["authentication","axios","email-verification","javascript","jwt-authentication","nestjs","passport-jwt","postgresql","prisma-orm","prismaorm","react","shadcn-ui","swagger","tailwindcss","typescript","vite","zod-validation"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/YagoLopesMartins.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}},"created_at":"2024-09-13T21:57:54.000Z","updated_at":"2024-11-02T02:41:18.000Z","dependencies_parsed_at":"2024-09-14T14:09:29.448Z","dependency_job_id":"2717acba-ddac-4b63-b257-a6e60b1f4b26","html_url":"https://github.com/YagoLopesMartins/FullStack_React-Dashboard-admin-nest_API_Auth","commit_stats":null,"previous_names":["yagolopesmartins/react-dashboard-admin-nest","yagolopesmartins/fullstack_react-dashboard-admin-nest_api_auth"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YagoLopesMartins%2FFullStack_React-Dashboard-admin-nest_API_Auth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YagoLopesMartins%2FFullStack_React-Dashboard-admin-nest_API_Auth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YagoLopesMartins%2FFullStack_React-Dashboard-admin-nest_API_Auth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YagoLopesMartins%2FFullStack_React-Dashboard-admin-nest_API_Auth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YagoLopesMartins","download_url":"https://codeload.github.com/YagoLopesMartins/FullStack_React-Dashboard-admin-nest_API_Auth/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242174723,"owners_count":20084251,"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":["authentication","axios","email-verification","javascript","jwt-authentication","nestjs","passport-jwt","postgresql","prisma-orm","prismaorm","react","shadcn-ui","swagger","tailwindcss","typescript","vite","zod-validation"],"created_at":"2024-11-16T04:28:52.180Z","updated_at":"2025-12-30T19:35:12.680Z","avatar_url":"https://github.com/YagoLopesMartins.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# API RESTful de Usuários (Backend e Frontend)\n\n### Overview\n\n- Sistema **CRUD** completo para gerenciamento de usuários\n- Abrange tanto o **Backend** quanto o **Frontend**\n- Desenvolvido em **NestJs (NodeJs)** para o backend e **ReactJs** para o frontend.\n- O sistema deve ser acessado **(Login)** com autenticação por token (**JWT**, Oauth2, etc).\n- O sistema possui sistema de **recuperação de senha** (validação de usuário cadstrado e **envio de e-mail**)\n- **Tecnologias**: Typescript, Vite, React, React-form-hooks, Axios, Zod, Tailwindcss, Shadcn/ui, PrismaORM, PostgreSQL, Nestjs, Passport, NodeMailer, JWT token, Swagger\n\n### Objetivo\n\n- Desenvolver um sistema CRUD completo para gerenciamento de usuários,\n  abrangendo tanto o backend quanto o frontend\n\n### Frontend\n\n- Utilizar um framework de front-end (**React**, Angular ou Vue.js) para\n  construir a aplicação.\n- Link da Spec (AdobeXD): https://xd.adobe.com/view/6c0ff585-36dd-4969-9d1f-b7661d820524-395c/screen/8f855f3a-02f9-4976-8dbe-1c0f054f892a/\n- Desenvolver uma **interface de usuário** e suas **validações**.\n- **Telas:**\n\n  - Apresentação (**HOME**)\n  - **Lista de usuários**\n\n    - Pesquisa por nome\n    - Paginação\n\n  - **Cadastro de usuários**\n\n    1. **Nome** - _Apenas Letras_\n    2. **Email** - _Apenas e-mails válidos_\n    3. **Matrícula** - _Apenas Números_\n    4. **Senha** - _Alfanuméricos de 6 dígitos_\n    5. _Habilitar botão de salvar apenas quando todos os campos forem válidos._\n    6. _Todos os campos são obrigatórios_\n\n  - **Edição de Usuário**\n  - **Deletar Usuário**\n  - Outras telas: **Login, ForgotPassword e ResetPassword**\n\n### Backend\n\n- Desenvolver endpoints para **CRUD** (Create, Read, Update, Delete) de\n  usuários.\n- Criar uma **API RESTful** utilizando **Nestjs**\n- Documentar com **Swagger UI**\n  - Para acessar a documentação, após a execução do projeto basta acessar: http://localhost:3000/api\n\n### Banco de Dados\n\n- Configurar um banco de dados relacional (MySQL ou **PostgreSQL**).\n- Criar tabelas necessárias para armazenar dados dos usuários.\n\n## Configuração do Projeto\n\n### Requisitos\n\n- Nodejs \u003e= 20\n- Npm\n- PostgreSQL\n- PrismaORM\n- Postman ou outro API Client for REST (Ex.: Insomnia, Thunder Client etc)\n\n### Instalação\n\n1. Clone o repositório ou Download ZIP:\n\n   ```bash\n   $ git clone https://github.com/YagoLopesMartins/react-dashboard-admin-nest.git\n   cd react-dashboard-admin-nest\n   ```\n\n2. Instale as dependências:\n\n   - 2.1 LOCAL\n     - 2.1.1 Crie seu banco de dados postgresql\n        ```bash\n         $  sudo -u postgres psql\n         $ postgres=# CREATE DATABASE nome_do_banco;\n       ```\n     - 2.1.2 Configure o arquivo `.env`:\n       - Renomeie o arquivo `.env.example` para `.env` e configure as variáveis de ambiente conforme necessário por exemplo: DATABASE_URL, JWT_SECRET, USER_EMAIL, USER_EMAIL_PASS\n\n     - 2.2.1 Acesso o diretório backend\n       ```bash\n         $ cd backend\n         $ npm install ou npm i\n         $ npx prisma generate\n         $ npx prisma migrate dev --name init\n         $ npx prisma db seed // Ex.: E-mail: teste@teste.com Senha: teste123 (verifique qual o usuário criado em prisma/seed.ts)\n         $ npm run build\n         $ npm run start:prod\n       ```\n       - 2.2.1.1 Acesse o diretorio postman e import os endpoints de testes\n       - 2.2.1.2 URI: `http://localhost:3000/`\n       - 2.2.1.3 Insira pelo menos um usuário (POST)\n    \n     - 2.2.3 Acesso o diretório frontend\n       ```bash\n         $ cd frontend\n         $ npm install ou npm i\n         $ npm run dev\n       ```\n       - Acese: http://localhost:5173/login (Entre com E-mail e senha cadastrados item 2.2.1.3)\n\n   - DOCKER\n     - $ docker compose build\n     - $ docker compose up\n     - Configure a conexão do bando por exemplo no DBeaver\n     - Acesse: http://localhost:3001/users\n     \n\n## Rotas da API\n\n- Aqui estão as principais rotas da API\n- A API estará disponível em: `http://localhost:3000`.\n\n### Autenticação\n\n- **Login de usuário**\n\n  - `POST /login`\n  - Valida usuário se possui credencial de entrada ao sistema. Requer um JSON com os seguintes campos:\n    - `email`: E-mail deve ser válido\n    - `password`: Senha (Minimo 6 digitos e alfanúmericos)\n\n### Recuperação de E-mail\n\n- `POST /send-reset-email`\n- Requer um JSON com os seguintes campos: (Se usuário existir envia-se e-mail para cadastrar nova senha)\n\n  - `email`: E-mail deve ser válido\n\n- `POST /reset-password/:token_jwt`\n- Requer um JSON com os seguintes campos:\n  - `newPassword`: Senha (Minimo 6 digitos e alfanúmericos)\n\n### Usuários\n\n- **Listar usuarios**\n\n  - `GET /users`\n  - Retorna uma lista de usuarios com paginação. Obs: 10 por página\n  - Query parameters:\n    - `search` (opcional): filtro por nome.\n    - `page` (opcional): Número da página.\n    - `limit` (opcional): Quantidade de itens por página.\n\n- **Exibir usuário**\n\n  - `GET /users/{id}`\n  - Retorna detalhes de um usuario específico.\n\n- **Criar usuário**\n\n  - `POST /users`\n  - Cria um novo usuário. Requer um JSON com os seguintes campos:\n    - `name`: Nome do usuário (Apenas letras)\n    - `email`: E-mail deve ser válido\n    - `registration`: Matricula do usuário (Apenas números)\n    - `password`: Senha (Minimo 6 digitos e alfanúmericos)\n\n- **Atualizar usuário**\n\n  - `PUT /users/{id}`\n  - Atualiza um usuario existente. Aceita os mesmos campos que a criação.\n\n- **Deletar usuário**\n  - `DELETE /users/{id}`\n  - Remove um usuario.\n\n## Contribuição\n\nSinta-se à vontade para contribuir para este projeto enviando pull requests ou relatando problemas. Para demais pedidos e sugestões enviar e-mail para: ylm@icomp.ufam.edu.br\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyagolopesmartins%2Ffullstack_react-dashboard-admin-nest_api_auth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyagolopesmartins%2Ffullstack_react-dashboard-admin-nest_api_auth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyagolopesmartins%2Ffullstack_react-dashboard-admin-nest_api_auth/lists"}