Adiciona documentação completa no README.md

Author: sara

README.md

@@ -0,0 +1,106 @@
+# 🧪 Mongoose Demo
+
+Este é um projeto simples de API REST criada com **Node.js**, **Express** e **MongoDB (Mongoose)**.  
+Permite criar, listar, atualizar e deletar usuários a partir de requisições HTTP.
+
+---
+
+## 🚀 Tecnologias Utilizadas
+
+- [Node.js](https://nodejs.org/)
+- [Express](https://expressjs.com/)
+- [MongoDB](https://www.mongodb.com/)
+- [Mongoose](https://mongoosejs.com/)
+- [Validator](https://www.npmjs.com/package/validator)
+- [CORS](https://www.npmjs.com/package/cors) *(para permitir acesso da interface HTML)*
+- [MongoDB Compass](https://www.mongodb.com/products/compass) *(para visualizar os dados)*
+
+---
+
+## 📂 Estrutura do Projeto
+
+mongoose-demo/
+├── controllers/
+│   └── userController.js
+├── models/
+│   └── user.js
+├── routes/
+│   └── userRoutes.js
+├── node_modules/         
+├── index.html          
+├── .env
+├── server.js
+├── package.json
+├── package-lock.json
+└── README.md
+
+
+
+---
+
+## 📌 Funcionalidades da API
+
+| Método | Rota             | Descrição                          |
+|--------|------------------|--------------------------------------|
+| GET    | `/users`         | Lista todos os usuários              |
+| GET    | `/users/:id`     | Mostra um usuário específico por ID  |
+| POST   | `/users`         | Cria um novo usuário                 |
+| PUT    | `/users/:id`     | Atualiza os dados de um usuário      |
+| DELETE | `/users/:id`     | Remove um usuário do banco de dados  |
+
+---
+
+## 📦 Como Rodar o Projeto
+
+1. Clone o repositório:
+   ```bash
+   git clone https://github.com/Sara-source01/api-users-node-mongoose-.git
+
+
+2. Instale as dependências:
+npm install express mongoose dotenv cors validator
+
+3. Configure o arquivo .env:
+MONGO_URI=mongodb://localhost:27017/mongoose_demo
+PORT=3000
+
+4. Inicie o servidor:
+node server.js
+
+
+
+🧪 Testando a API
+Você pode testar a API de três formas:
+
+1. Com Postman ou Insomnia:
+Envie requisições para:
+http://localhost:3000/users
+
+
+2. Com interface HTML (index.html):
+Abra o arquivo index.html no navegador, preencha os campos de nome e e-mail e clique em "Create".
+Isso envia um POST para a rota /users usando fetch().
+
+Atenção: o servidor precisa estar rodando e com CORS ativado.
+
+A biblioteca CORS permite que navegadores (como uma página HTML local) consigam acessar a API sem bloqueio.
+
+3. Via MongoDB Compass:
+Abra o MongoDB Compass.
+
+Conecte-se a:
+mongodb://localhost:27017
+
+Acesse o banco de dados mongoose_demo.
+
+Clique na coleção users para ver os dados inseridos pela API ou HTML.
+
+Dessa forma, você pode acompanhar visualmente as alterações feitas pelos endpoints da API.
+
+📄 Licença
+Este projeto é livre para estudos e testes.
+
+## 👩‍💻 Autor
+
+Desenvolvido por [Sara George](https://github.com/Sara-source01) 🚀  
+Sinta-se à vontade para entrar em contato ou contribuir com melhorias!