Skip to content

Latest commit

Β 

History

28 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏭 Rishabh Instruments - Enterprise Management System

Live Demo Backend API

A comprehensive Enterprise Management System designed for manufacturing operations, featuring materials tracking, project management, BOM creation, maintenance scheduling, and task management.

✨ Features

πŸ” Authentication & User Management

  • Secure user authentication with JWT tokens
  • Role-based access control (Admin, Manager, Operator)
  • User profile management

πŸ“¦ Materials Management

  • Complete inventory tracking
  • Low stock alerts and notifications
  • Material categorization and search
  • Quantity management with history

πŸ—οΈ Project Management

  • Full project lifecycle management
  • Milestone tracking and progress monitoring
  • Resource allocation and planning
  • Status updates and reporting

πŸ“‹ Bill of Materials (BOM)

  • Create and manage product BOMs
  • Component tracking and costing
  • Version control and approval workflow
  • Cost analysis and reporting

πŸ”§ Maintenance Management

  • Preventive maintenance scheduling
  • Equipment tracking and history
  • Maintenance task management
  • Compliance monitoring

βœ… Task Management

  • Task creation and assignment
  • Progress tracking and updates
  • Priority management
  • Team collaboration features

πŸ“Š Dashboard & Analytics

  • Real-time operational overview
  • Performance metrics and KPIs
  • Interactive charts and visualizations
  • Customizable reporting

πŸ”” Notifications System

  • Real-time notifications
  • Alert management
  • Email notifications (configurable)
  • System-wide announcements

πŸš€ Live Demo

🌐 Application: https://rishabh-instruments.netlify.app

Demo Credentials:

Role Email Password
Admin admin@rishabh.co.in admin123
Manager manager@rishabh.co.in manager123
Operator operator@rishabh.co.in operator123

πŸ› οΈ Tech Stack

Frontend

  • React 18 - Modern UI framework
  • Material-UI (MUI) - Professional component library
  • React Router - Client-side routing
  • Axios - HTTP client
  • React Hook Form - Form management
  • Recharts - Data visualization
  • React Toastify - Notifications

Backend

  • Node.js - Runtime environment
  • Express.js - Web framework
  • MongoDB - Database
  • Mongoose - ODM for MongoDB
  • JWT - Authentication
  • bcryptjs - Password hashing
  • CORS - Cross-origin resource sharing
  • Helmet - Security middleware

Deployment & Infrastructure

  • Frontend: Netlify (Continuous Deployment)
  • Backend: Render (Cloud Platform)
  • Database: MongoDB Atlas (Cloud Database)
  • Version Control: Git & GitHub

πŸ“ Project Structure

rishabh-system/
β”œβ”€β”€ frontend/                 # React frontend application
β”‚   β”œβ”€β”€ public/              # Static assets
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/      # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ pages/          # Main application pages
β”‚   β”‚   β”œβ”€β”€ context/        # React context providers
β”‚   β”‚   β”œβ”€β”€ services/       # API service layer
β”‚   β”‚   └── App.js          # Main application component
β”‚   └── package.json
β”œβ”€β”€ backend/                 # Node.js backend API
β”‚   β”œβ”€β”€ models/             # Database models
β”‚   β”œβ”€β”€ routes/             # API route handlers
β”‚   β”œβ”€β”€ middleware/         # Custom middleware
β”‚   β”œβ”€β”€ server.js           # Main server file
β”‚   └── package.json
β”œβ”€β”€ mongodb-backup/         # Database backup files
β”œβ”€β”€ DEPLOYMENT_CHECKLIST.md # Deployment guide
└── README.md              # This file

πŸš€ Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • MongoDB (local or Atlas)
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/SamarthKasar123/rishabh-system.git
    cd rishabh-system
  2. Setup Backend

    cd backend
    npm install
    cp .env.example .env
    # Edit .env with your configuration
    npm start
  3. Setup Frontend

    cd frontend
    npm install
    npm start
  4. Seed Demo Data (Optional)

    cd backend
    node seedUsers.js
    node create-sample-materials.js
    node create-sample-projects.js

Environment Variables

Backend (.env):

NODE_ENV=development
PORT=5000
MONGODB_URI=mongodb://localhost:27017/rishabh-instruments
JWT_SECRET=your_jwt_secret_here
JWT_EXPIRE=7d
CLIENT_URL=http://localhost:3000

Frontend (.env):

REACT_APP_API_URL=http://localhost:5000/api

πŸ“± Screenshots

Dashboard Overview

Dashboard

Materials Management

Materials

Project Management

Projects

🚒 Deployment

This project is configured for easy deployment:

  • Frontend: Automatically deploys to Netlify on push to main branch
  • Backend: Automatically deploys to Render on push to main branch
  • Database: MongoDB Atlas for production data

See DEPLOYMENT_CHECKLIST.md for detailed deployment instructions.

πŸ“Š API Documentation

Base URL

  • Production: https://rishabh-instruments-backend.onrender.com/api
  • Development: http://localhost:5000/api

Authentication

All API endpoints require authentication via JWT token in the Authorization header:

Authorization: Bearer <jwt_token>

Key Endpoints

  • POST /auth/login - User authentication
  • GET /dashboard/overview - Dashboard data
  • GET /materials - Materials list
  • GET /projects - Projects list
  • GET /bom - BOMs list
  • GET /maintenance - Maintenance records
  • GET /tasks - Tasks list

🀝 Contributing

  1. Fork the repository
  2. Create a 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 ISC License - see the LICENSE file for details.

πŸ‘¨β€πŸ’» Author

Samarth Kasar

πŸ™ Acknowledgments

  • Material-UI team for the excellent component library
  • MongoDB team for the robust database solution
  • Netlify and Render for seamless deployment platforms
  • React community for continuous innovation

πŸ“ˆ Future Enhancements

  • Advanced reporting and analytics
  • Real-time collaboration features
  • Mobile app development
  • Integration with external ERP systems
  • Advanced inventory optimization
  • Multi-language support
  • Dark mode theme

⭐ Star this repository if you found it helpful!

Made with ❀️ for the manufacturing industry

About

🏭 Full-stack Enterprise Management System for manufacturing operations with materials tracking, project management, BOM creation, maintenance scheduling, and task management. Built with React, Node.js, and MongoDB.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages