https://github.com/m-ahmedk/node-mongo-api

Node.js project that implements a user CRUD system, backed by MongoDB and documented with Swagger UI. It allows users to create, read, update, and delete user data, which is stored and retrieved with the Mongoose ORM.
https://github.com/m-ahmedk/node-mongo-api

expressjs mongoose nodejs swagger-ui user-crud winston-logger

Last synced: 5 months ago
JSON representation

Node.js project that implements a user CRUD system, backed by MongoDB and documented with Swagger UI. It allows users to create, read, update, and delete user data, which is stored and retrieved with the Mongoose ORM.

• Host: GitHub
• URL: https://github.com/m-ahmedk/node-mongo-api
• Owner: m-ahmedk
• License: mit
• Created: 2023-03-31T21:25:06.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-03-31T23:05:16.000Z (over 2 years ago)
• Last Synced: 2024-12-29T05:08:11.110Z (7 months ago)
• Topics: expressjs, mongoose, nodejs, swagger-ui, user-crud, winston-logger
• Language: JavaScript
• Homepage:
• Size: 43.9 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# User CRUD API + MongoDB / Mongoose ORM

This is a Node.js project that implements a user CRUD system, backed by MongoDB and documented with Swagger UI. It allows users to create, read, update, and delete user data, which is stored and retrieved with the Mongoose ORM.

Additionally, the project opens a swagger documentation (http://localhost:3000/api-docs) which displays all the available requests, their description, and the methods.

## Features

- User CRUD operations (create, read, update, delete)

- Mongoose ORM for database integration

- Swagger UI for API documentation

- Third-party middlewares (helmet, xss-clean, cors, and express rate limit) for security and performance improvements

- A generic response module for all CRUD operations

- Log all errors using Winston logger

- Store logs in a file and automatically delete after 3 days

## Getting Started

To get started with this project, follow these steps:

1. Clone the repository: git clone https://github.com/m-ahmedk/node-mongo-api.git

2. Install dependencies: npm install

3. Start the server: npm start

4. Access the Swagger UI documentation in your web browser at http://localhost:3002

## Prerequisites

To run this project, you need:

- Node.js

- MongoDB

- npm

## Configuration

This project uses environment variables for configuration. The following variables are required:

- MONGO_URI: the URI of the MongoDB database to use

- PORT: default port to run the local host

You can set these variables in a .env file in the root directory of the project.

## Built With

Node.js

Express

Mongoose

Winston

Swagger

## Contributing

If you would like to contribute to the project, please reach out to the repository owner.

## License

This project is licensed under the MIT License - see the [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/m-ahmedk/node-mongo-api/blob/main/LICENSE) file for details.