https://github.com/zenithexe/inventory-management-app
This is a full-stack Inventory Management Web App
https://github.com/zenithexe/inventory-management-app
Last synced: about 2 months ago
JSON representation
This is a full-stack Inventory Management Web App
- Host: GitHub
- URL: https://github.com/zenithexe/inventory-management-app
- Owner: zenithexe
- Created: 2024-07-01T15:35:21.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-15T18:02:09.000Z (almost 2 years ago)
- Last Synced: 2026-01-01T21:59:54.497Z (6 months ago)
- Language: JavaScript
- Homepage: https://inventory-management-app-ruby.vercel.app
- Size: 556 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Inventory Management App 💼
This is a full-stack Inventory Management App Project, that is built using Next.js and MongoDB (Mongoose).
Deployment : https://inventory-management-app-ruby.vercel.app/
## Features
- **User Authentication**: Secure login and registration.
- **User Authorization**: Role-based Authorization. There are mainly two roles, `user` and `admin`.
- **Product Management**: Add, edit, and delete products.
- **Category Management** : Manage product categories.
- **User Management** : Admin are able to manage othe users.
- **Search and Filter** : Easily find products with advanced search, filter, sort options.
## Installation
1. Clone the repository:
```bash
git clone https://github.com/zenithexe/inventory-management-app.git
```
2. Navigate to the project directory:
```bash
cd inventory-management-app
```
3. Install dependencies:
```bash
npm install
```
4. Set up the environment variables. Create a `.env` file in the root directory and add the necessary variables:
```plaintext
MONGODB_URI="your_database_url"
NEXTAUTH_SECRET="Generate_your_own_secret_key"
NEXTAUTH_URL="http://localhost:3000/"
```
5. Integrate your MongoDB Database with the project.
```
just google it man :)
```
6. Start the development server :
```bash
npm run dev
```
## App-Routes
Once the server is running, you can access the application at `http://localhost:3000`.
These are the different routes :
- **/** : Basic Home-page. Content about the project.
- **/profile** : Manage your account.
- **/inventory** : Advance view of your inventory.
- **/category** : Advance view to manage the `item-category`.
- **/users** : Advance view to manage `users`. Admins are only able to manage other users.
- **/login** : User Login Page
- **/register** : User Registration Page
## App-Role Permessions
`User Role` :
- Add/Edit inventory items.
- View Categories
- View other users. Edit their own profile.
`Admin Role` :
- Add/Edit/Delete inventory items.
- Add/Edit/Delete Category
- Edit/Delete/Promote/Demote other users.
## Dependencies
These are the library used in the project.
- `shadcnn` : UI Library
- `Tanstack React Tables` : Headless React UI library to create complete Table UI.
- `NextAuth (Auth.js)` : User Authentication and Session Control