Golden Textile Dyers ERP

Full-stack ERP platform for Golden Textile Dyers (Erode) covering inventory, procurement, production, customer and supplier portals, dispatch, HR, analytics, and reporting.

Status: Active and production-ready baseline (updated March 20, 2026)

Current Stack

• Frontend: React 19, TypeScript, Vite 7, Tailwind CSS, React Router 7, TanStack Query, Recharts, Framer Motion
• Backend: Node.js, Express 5, TypeScript, MongoDB (Mongoose), Socket.IO
• Reporting: PDFKit (server), jsPDF (client), json2csv, Nodemailer, node-cron

Recent Updates

• Added robust frontend API env fallback logic (VITE_API_URL or VITE_API_BASE_URL)
• Added wildcard-aware backend CORS matching for hosted frontends (for example https://*.vercel.app)
• Expanded role workflows for customer and supplier portals
• Refined procurement, dispatch, production, and HR flows
• Continued analytics and reporting improvements

Roles

Internal roles:

• ADMIN
• MANAGER
• STORE_MANAGER
• SUPERVISOR
• HR_MANAGER

External portal roles:

• CUSTOMER
• SUPPLIER

Key Modules

• Inventory and material master
• Material Request System (MRS)
• Purchase inward and approvals
• Supplier RFQ and quotation workflow
• Production planning, execution, and live monitor
• Customer orders and dispatch lifecycle
• HR operations (workers, attendance, shifts, leaves, assignments)
• Analytics dashboards and scheduled reports
• Audit logs and CSV export

Repository Layout

Consultancy_Project/
|- client/
|- server/
|- README.md
|- PROJECT_EXPLANATION.md
|- BACKEND_EXPLANATION.md
|- FRONTEND_EXPLANATION.md
|- HOSTING_GUIDE.md

Local Setup

Prerequisites:

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

1. Install dependencies

cd server
npm install
cd ../client
npm install

2. Configure environment files

Server (server/.env):

PORT=3000
MONGO_URI=mongodb://127.0.0.1:27017/consultancy_db
JWT_SECRET=replace_with_secure_secret
CLIENT_ORIGIN=http://localhost:5173
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your_email
SMTP_PASS=your_password_or_app_password
SMTP_FROM=Golden Textile Dyers <noreply@example.com>

Client (client/.env):

VITE_API_URL=http://localhost:3000/api
VITE_SOCKET_URL=http://localhost:3000

3. Run the apps

# terminal 1
cd server
npm run dev

# terminal 2
cd client
npm run dev

Build and Run

Backend:

cd server
npm run build
npm start

Frontend:

cd client
npm run build
npm run preview

Additional Documentation

• Architecture and business flow: PROJECT_EXPLANATION.md
• Backend details: BACKEND_EXPLANATION.md
• Frontend details: FRONTEND_EXPLANATION.md
• Deployment guidance: HOSTING_GUIDE.md

License

MIT