Skip to content

SamarthKasar123/rishabh-instruments-ems

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

28 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages