A full-stack web application built for the chemical industry to manage product catalogs, regulatory compliance, sales operations, batch tracking, and invoicing in a single centralized system.

Live demo: cordeous.github.io/chemops GitHub: github.com/cordeous/chemops

• Role-based dashboards — Admin, Sales, Finance, Compliance each get a tailored view
• Product management — CAS/UN numbers, hazard classification, SDS documents, inventory levels
• Batch tracking — expiry badges, warehouse location, per-product batch history
• Order lifecycle — multi-item builder, auto-pricing, tax calc, status transitions (Pending → Approved → Shipped → Invoiced → Paid)
• Invoicing — auto-generated from orders, PDF export, Mark Paid, overdue detection
• Customer management — compliance status, credit limits, address book, full CRUD
• Compliance — SDS tracker, regulatory CSV export, customer verification workflow
• Reports & analytics — sales trends, top customers, inventory turnover, hazmat sales, outstanding receivables
• Admin panel — user management, feature flags, webhook config, audit log, low-stock alerts
• Landing page — public marketing page at /

• Node.js 18+
• MongoDB Atlas account (or local MongoDB)

git clone https://github.com/cordeous/chemops.git
cd chemops

cd backend
npm install

Create backend/.env:

PORT=5000
MONGO_URI=mongodb+srv://<user>:<pass>@cluster0.jn2jfkn.mongodb.net/chemops?retryWrites=true&w=majority
JWT_SECRET=your_jwt_secret_here

Seed the database (first time only):

node seed.js

Start backend:

npm run dev

Backend runs at http://localhost:5000

cd frontend-react
npm install
npm run dev

Frontend runs at http://localhost:5173

chemops/
├── backend/
│   ├── src/
│   │   ├── routes/          # Express route handlers
│   │   ├── models/          # Mongoose schemas
│   │   └── middleware/      # Auth, audit, validation
│   ├── server.js            # Express entry point (port 5000)
│   └── seed.js              # Database seed script
│
├── frontend-react/
│   ├── src/
│   │   ├── api/client.js    # Axios instance + auth interceptor
│   │   ├── context/         # AuthContext (JWT, user state)
│   │   ├── components/      # Layout, Sidebar, Modal, KpiCard, etc.
│   │   ├── pages/           # One file per route
│   │   │   └── dashboards/  # Role-specific dashboard components
│   │   └── utils/format.js  # Currency, date, status helpers
│   └── vite.config.js
│
└── .github/workflows/
    └── deploy.yml           # CI/CD → GitHub Pages

All endpoints require Authorization: Bearer <token> except /api/auth/login. All responses return { success: bool, data: ... }.

Frontend deploys automatically to GitHub Pages on every push to master via GitHub Actions.

To enable for your fork:

1. Go to Settings → Pages
2. Set Source to GitHub Actions

The workflow builds with VITE_API_URL pointing to the backend. For a fully live deployment, host the backend on Railway, Render, or similar.

MIT