SmartStock AI - Intelligent Inventory Management System

SmartStock AI is a revolutionary inventory management application that leverages artificial intelligence to transform traditional stock management. Built with Next.js 15 and TypeScript, this comprehensive solution automates inventory processes through intelligent data extraction and modern web technologies.

🌐 Live Demo

🚀 Visit SmartStock AI

Alternative deployment: https://smartstock-95glfz1u4-antriksh-sharmas-projects.vercel.app

Experience the power of AI-driven inventory management in action!

🚀 Features

AI-Powered Processing

• Multi-Format Support: CSV, Excel, PDF, and image files
• Google Cloud Vision AI: Intelligent text extraction from images
• Google Vertex AI: Advanced data processing and recognition
• Smart Column Mapping: Automatic detection of product data fields

Modern User Interface

• Dark Theme: Professional, modern design
• Responsive Design: Works seamlessly on desktop and mobile
• Drag & Drop: Intuitive file upload experience
• Camera Integration: Direct photo capture for inventory sheets
• Real-time Charts: Interactive data visualization

Comprehensive Management

• Stock Inventory: Complete CRUD operations with status tracking
• Import History: Detailed logging of all data imports
• User Authentication: Secure JWT-based authentication
• Dashboard Analytics: Real-time insights and statistics

🛠️ Tech Stack

• Frontend: Next.js 15, React 18, TypeScript
• Styling: Tailwind CSS, shadcn/ui components
• Backend: Next.js API Routes, Node.js
• Database: MongoDB Atlas
• Authentication: JWT (JSON Web Tokens)
• AI Services: Google Cloud Vision, Google Vertex AI
• File Processing: CSV Parser, XLSX, PDF Parse
• Deployment: Vercel (recommended)

📋 Prerequisites

• Node.js 18+
• npm or yarn
• MongoDB Atlas account
• Google Cloud Platform account
• Git

🔧 Installation

1. Clone the repository

   git clone https://github.com/antriksh999/smartstock-ai.git
   cd smartstock-ai

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env.local

   Fill in your environment variables:

   # Database
   MONGODB_URI=your_mongodb_connection_string
   
   # Authentication
   JWT_SECRET=your_jwt_secret_key
   
   # Google Cloud
   GOOGLE_APPLICATION_CREDENTIALS=./path-to-service-account.json
   GOOGLE_CLOUD_PROJECT_ID=your_project_id
   GOOGLE_VISION_API_KEY=your_vision_api_key

4. Set up Google Cloud Services

   • Enable Vision AI and Vertex AI APIs
   • Download service account credentials
   • Place the JSON file in your project root

5. Run the development server

   npm run dev

6. Open your browser Navigate to http://localhost:3000

🎯 Usage

1. Register/Login: Create an account or sign in
2. Upload Data: Use drag & drop or camera to upload inventory files
3. AI Processing: Let AI extract and organize your data
4. Manage Inventory: View and manage your stock items
5. Track History: Monitor all import activities

📁 Project Structure

smartstock-ai/
├── app/                    # Next.js App Router
│   ├── api/               # API routes
│   ├── dashboard/         # Dashboard pages
│   ├── data-import/       # Import functionality
│   └── page.tsx          # Home page
├── components/            # Reusable UI components
├── lib/                   # Utility functions
│   ├── database.ts       # MongoDB operations
│   ├── data-processor.ts # AI processing logic
│   └── google-cloud.ts  # Google Cloud integration
├── public/               # Static assets
└── types/               # TypeScript definitions

🔑 Environment Variables

Variable	Description	Required
MONGODB_URI	MongoDB connection string	✅
JWT_SECRET	JWT secret for authentication	✅
GOOGLE_APPLICATION_CREDENTIALS	Path to Google service account	✅
GOOGLE_CLOUD_PROJECT_ID	Google Cloud project ID	✅
GOOGLE_VISION_API_KEY	Google Vision API key	✅

🚀 Deployment

Vercel (Recommended) ✅

The application is currently deployed on Vercel. To deploy your own instance:

1. Fork this repository

2. Connect to Vercel

   • Go to vercel.com
   • Import your GitHub repository
   • Choose "Next.js" framework

3. Set environment variables in Vercel Dashboard:

   NEXTAUTH_SECRET=your-nextauth-secret
   NEXTAUTH_URL=https://your-domain.vercel.app
   MONGODB_URI=your-mongodb-connection-string
   JWT_SECRET=your-jwt-secret
   GOOGLE_VISION_API_KEY=your-google-vision-key
   GOOGLE_CLOUD_PROJECT_ID=your-google-project-id
   RESEND_API_KEY=your-resend-key (optional)
   UPLOADTHING_SECRET=your-uploadthing-secret (optional)
   UPLOADTHING_APP_ID=your-uploadthing-app-id (optional)

4. Deploy

   • Vercel will automatically build and deploy
   • Access your live application!

Manual Deployment

1. Build the project

   npm run build

2. Start production server

   npm start

Docker Deployment

# Use the official Node.js image
FROM node:18-alpine

# Set working directory
WORKDIR /app

# Copy package files
COPY package*.json ./

# Install dependencies
RUN npm ci --only=production

# Copy source code
COPY . .

# Build the application
RUN npm run build

# Expose port
EXPOSE 3000

# Start the application
CMD ["npm", "start"]

📊 Performance & Features

✅ Successfully Deployed Features

• Multi-format File Processing: CSV, Excel, PDF, and image support
• AI-Powered Data Extraction: Google Cloud Vision integration
• Real-time Dashboard: Interactive charts and analytics
• Secure Authentication: JWT-based user management
• Responsive Design: Mobile-first, modern UI
• Database Integration: MongoDB Atlas with optimized queries
• Import History: Complete audit trail of all imports
• Error Handling: Comprehensive error management and logging

🎯 Production Ready

• Build Status: ✅ Passing
• TypeScript: ✅ Type-safe codebase
• ESLint: ✅ Code quality maintained
• Deployment: ✅ Live on Vercel
• Database: ✅ MongoDB Atlas connected
• API Integration: ✅ All services operational

🤝 Contributing

1. Fork the repository
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

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Antriksh Sharma

• GitHub: @antriksh999
• Project Link: SmartStock AI
• Live Demo: smartstock-16h0otc5p-antriksh-sharmas-projects.vercel.app

🙏 Acknowledgments

• Next.js - React framework
• Vercel - Deployment platform
• MongoDB Atlas - Database service
• Google Cloud - AI services
• Tailwind CSS - Styling framework
• shadcn/ui - UI components

---

Built with ❤️ using Next.js, TypeScript, and AI