This project is a REST API for user management, developed using NestJS, MySQL and Typescript. The API includes functionalities for user authentication and authorization using JWT, password encryption with Bcrypt, and data validation with class-validator. Administrators have the ability to create, edit, and delete users, while regular users can view and update some of their own information.
- User Authentication: Secure user authentication using JSON Web Tokens (JWT).
- Password Encryption: Passwords are securely stored using Bcrypt.
- User Management:
- Administrators: Create, edit, and delete user accounts. Edit their own info except RUT and email.
- Regular Users: View their own information and update their name, email, country or password.
- Data Validation: Input validation using class-validator to ensure data integrity.
- Database Integration: MySQL database integration using TypeORM.
- NestJS: A progressive Node.js framework for building efficient, reliable, and scalable server-side applications.
- TypeORM: An ORM for TypeScript and JavaScript (ES7, ES6, ES5) that supports MySQL and other databases.
- class-validator: A library for validation in TypeScript.
- MySQL: A relational database management system.
- Bcrypt: A library to help you hash passwords.
- JWT (JSON Web Tokens): A compact, URL-safe means of representing claims to be transferred between two parties.
- Clone the repository:
git clone https://github.com/your-username/your-repository.git cd your-repository - Install the dependencies:
pnpm install # or npm install depending on package manager - Configure the environment variables. Create a .env file in the root directory and add the following variables:
DB_USER=your-database-user DB_PASSWORD=your-database-password JWT_SECRET=your-jwt-secret SALT=number-of-rounds-to-generate-salt DB_TYPE=mysql # optional, 'mysql' by default DB_HOST=localhost # optional, 'localhost' by default DB_PORT=3306 #optional, 3306 by default DB_NAME=your-db-name # optional, 'talent_manager_db' by default BACKEND_PORT=3000 # optional, 3000 by default
- Start the application:
pnpm start # or pnpm start:dev to start on watch mode
Once the application is running, you can interact with the API using tools like Postman, Insomnia or cURL. You will need to obtain a JWT token through the login endpoint to access protected routes.
- POST /auth/signup: Register a new user.
- POST /auth/login: Log in and obtain a JWT token.
- POST /users: Create a new user.
- GET /users: Get a list of all users. Optional query param: search (search by name, surname, email and password).
- GET /users/:id: Get details of a specific user.
- GET /users/info: Get details of current user (auth token must be for same user as id).
- GET /users/country/:country: Get a list of all users from country.
- PATCH /users/:id: Update a specific user's information.
- PATCH /users/me/:id: Update the authenticated user's password.
- DELETE /users/:id: Delete a specific user.
- GET /users/info: Get details of current authenticated user.
- PATCH /users/:id: Update the authenticated user name, surname or country.
- PATCH /users/me/:id: Update the authenticated user's password.
We welcome contributions from the community. Please follow these steps to contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature). - Make your changes.
- Commit your changes (
git commit -am 'Add some feature'). - Push to the branch (
git push origin feature/your-feature). - Create a new Pull Request.
This project is licensed under the MIT License. See the LICENSE file for details.