https://github.com/rivalcoder/inventra-agent
Inventra is an AI-powered inventory management webapp designed to make stock control smarter, faster, and easier.
https://github.com/rivalcoder/inventra-agent
gemini-ai multithreading nextjs
Last synced: 9 months ago
JSON representation
Inventra is an AI-powered inventory management webapp designed to make stock control smarter, faster, and easier.
- Host: GitHub
- URL: https://github.com/rivalcoder/inventra-agent
- Owner: Rivalcoder
- Created: 2025-06-06T04:53:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-02T15:47:50.000Z (10 months ago)
- Last Synced: 2025-09-02T17:38:07.808Z (10 months ago)
- Topics: gemini-ai, multithreading, nextjs
- Language: TypeScript
- Homepage:
- Size: 1.01 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
---
# 🚀 Inventra-Agent
> ✨ AI-Powered Inventory & Sales Management System ✨
Inventra-Agent is a modern, full-stack inventory and sales management platform supercharged with AI analytics and natural language querying. Track products, manage sales, generate beautiful reports, and get instant insights with the power of Google Gemini AI.
---
## 🌟 Features
- 📊 **Dashboard** — Real-time revenue, inventory value, sales, and low stock alerts
- 📦 **Inventory Management** — Add, edit, delete, and view products with live stock tracking
- 🛒 **Sales Management** — Record, view, and manage sales transactions
- 🤖 **AI Query Console** — Ask natural language questions and get instant, AI-generated insights and SQL
- 📈 **Reports** — Generate and download detailed sales/inventory reports (PDF/CSV)
- 🛠️ **Settings** — Customize company info, currency, notifications, backup, and more
- 🔔 **Notifications** — Low stock and important event alerts
- 🌗 **Theme Support** — Light, dark, and system themes
- 💾 **Data Backup & Restore** — Export/import your database for safety and migration
---
## 🛠️ Tech Stack
| Frontend | Backend | AI | Data | UI/UX |
|:--------:|:-------:|:--:|:----:|:-----:|
| 
 | 
 | 
 | 
 | 
 |
---
## 🗄️ Database Schema
Click to expand
### products
| Field | Type | Description |
|-------------|--------------|-----------------------------------|
| id | VARCHAR(36) | Primary Key |
| name | VARCHAR(255) | Product name (unique) |
| description | TEXT | Product description |
| category | VARCHAR(100) | Product category |
| price | DECIMAL(10,2)| Unit price |
| stock | INT | Current stock |
| minStock | INT | Minimum stock for alerts |
| supplier | VARCHAR(255) | Supplier name |
| createdAt | DATETIME | Creation timestamp |
| updatedAt | DATETIME | Last update timestamp |
### sales
| Field | Type | Description |
|-------------|--------------|-----------------------------------|
| id | VARCHAR(36) | Primary Key |
| productId | VARCHAR(36) | Foreign Key to products |
| productName | VARCHAR(255) | Product name |
| quantity | INT | Quantity sold |
| price | DECIMAL(10,2)| Unit price at sale |
| total | DECIMAL(10,2)| Total sale amount |
| date | DATETIME | Sale date |
| customer | VARCHAR(255) | Customer name (default: Anonymous)|
### settings
| Field | Type | Description |
|---------------|--------------|-----------------------------------|
| id | VARCHAR(36) | Primary Key |
| setting_key | VARCHAR(255) | Unique key |
| value | TEXT | Value |
| type | VARCHAR(50) | Data type |
| description | TEXT | Description |
| isEncrypted | BOOLEAN | Is value encrypted? |
| createdAt | DATETIME | Creation timestamp |
| updatedAt | DATETIME | Last update timestamp |
---
## 🚦 Quick Start
```sh
# 1. Clone the repo
$ git clone
$ cd Ai_Inventory
# 2. Install dependencies
$ npm install
# 3. Configure environment variables
$ cp .env.example .env
# Edit .env with your MySQL & Google API credentials
# 4. Run the app
$ npm run dev
# Visit http://localhost:3000
```
---
## 🧠 AI Query Console
> 🤖 Ask questions like:
> - What are our top 5 selling products?
> - Which products are running low on stock?
> - Show me the total sales for this month.
- The AI will analyze your data, generate insights, and even provide SQL queries for data modifications.
- Responses are formatted with tables, lists, and markdown for clarity.
---
## 📂 Project Structure
```text
app/
api/ # API routes (AI, DB)
inventory/ # Inventory management UI
sales/ # Sales management UI
query/ # AI query console
reports/ # Reporting UI
settings/ # Settings UI
components/ # Reusable UI components
lib/ # Data fetching, context, types, utils
hooks/ # Custom React hooks
public/ # Static assets
```
---
## 🤝 Contributing
1. Fork the repo
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
---
## Made By Rivalcoder