🚀 ProConnect Backend

ProConnect is a modern marketplace application connecting clients with service providers. This repository hosts the robust and scalable Backend Service, built using TypeScript, Express, and MongoDB.

🔗 Live Demo & Source Code

Name	Type	Link
Live Application	Frontend Deployment	Frontend Live
Backend API	API Deployment	Backend Live
Frontend Source	GitHub Repository	ProConnect-Frontend
Backend Source	GitHub Repository	ProConnect-Backend

🛠️ Tech Stack

Category	Technology	Version	Purpose
Language	TypeScript	5.8.3	Type safety & scalability
Runtime	Node.js	-	JavaScript runtime
Framework	Express.js	5.1.0	Web framework
Database	MongoDB	-	NoSQL document DB
ORM	Mongoose	8.16.1	MongoDB modeling
Validation	Zod	3.25.74	Schema validation
Authentication	JWT & Bcryptjs	9.0.2 & 3.0.3	Secure login & hashing
Payment Gateway	SSLCommerz	-	Payment processing
File Upload	Cloudinary & Multer	2.8.0 & 2.0.2	File storage & upload
Email Service	Nodemailer	7.0.11	Email sending
HTTP Client	Axios	1.13.2	API requests
Utilities	CORS, Cookie-Parser	-	Security & cookie management

✨ Key Features

🔐 User Authentication & Authorization: JWT-based login, registration, role-based access (Admin, Seller, Client)
🛠️ Service Management: Full CRUD operations for services with validation & error handling
📦 Order Processing: Place, track, and manage orders
💳 Payment Gateway Integration: SSLCommerz support, transaction tracking & status management
⭐ Review & Rating System: Leave reviews, ratings with moderation support
📊 Admin Dashboard: Analytics, user & transaction management, report oversight
💰 Wallet & Withdrawal: Wallet tracking, earnings withdrawal with transaction history
✉️ Messaging System: User-to-user messaging for communication and support
📑 Transaction Tracking: Complete financial audit trail
⚡ Robust Error Handling: Global error handler, custom AppError, Mongoose & Zod validation support
🧩 Custom Middleware: Authentication checks, request validation, error & CORS handling

📂 Project Structure

src/
├── app.ts # Express app setup
├── server.ts # DB connection & server start
├── app/
│ ├── config/ # Environment & upload configs
│ ├── errorHelpers/ # Custom error handling
│ ├── helpers/ # Error response helpers
│ ├── interfaces/ # TypeScript interfaces
│ ├── middlewares/ # Authentication, validation, error & 404 handlers
│ ├── modules/ # Feature modules (M-C-S)
│ │ ├── admin/ # Dashboard & analytics
│ │ ├── auth/ # Authentication
│ │ ├── order/ # Orders
│ │ ├── payment/ # Payment processing
│ │ ├── service/ # Services
│ │ ├── review/ # Ratings & reviews
│ │ ├── transaction/ # Transactions
│ │ ├── user/ # Users
│ │ ├── wallet/ # Wallet
│ │ ├── withdrawal/ # Withdrawals
│ │ ├── utility-messages/ # Messaging
│ │ ├── report/ # Reports
│ │ └── ssl/ # SSLCommerz integration
│ ├── routes/ # Routes
│ └── utils/ # Utility functions
├── tsconfig.json # TypeScript config
└── vercel.json # Vercel deployment config

⚙️ Local Setup Guide

Prerequisites

Node.js v18+
npm or pnpm
MongoDB server or MongoDB Atlas

1️⃣ Installation

git clone https://github.com/arman-miaa/ProConnect-Backend.git
cd ProConnect-Backend
pnpm install # or npm install

2️⃣ Environment Variables

Create .env in root:

PORT=5000
NODE_ENV=development
DATABASE_URL=<mongodb_connection_string>
JWT_SECRET=<your_jwt_secret>
JWT_EXPIRES_IN=7d
CLOUDINARY_CLOUD_NAME=<name>
CLOUDINARY_API_KEY=<key>
CLOUDINARY_API_SECRET=<secret>
SSL_STORE_ID=<ssl_id>
SSL_STORE_PASSWORD=<ssl_password>
EMAIL_USER=<email>
EMAIL_PASSWORD=<password>
EMAIL_FROM=noreply@proconnect.com
FRONTEND_URL=http://localhost:3000

3️⃣ Run Development

pnpm run dev # or npm run dev

4️⃣ Build & Production

pnpm run build
pnpm start

📜 Available Scripts

Script	Description	Command
dev	Run development server with live reload	`pnpm run dev`
build	Compile TS to JS (`/dist`)	`pnpm run build`
start	Run production build	`pnpm start`
lint	ESLint check	`pnpm run lint`
test	Run tests (not configured)	`pnpm run test`

🔑 Key Dependencies

Express.js: RESTful APIs & middleware
Mongoose: MongoDB modeling
TypeScript: Type safety
JWT & Bcryptjs: Secure auth
Zod: Runtime validation
Cloudinary & Multer: File uploads
Nodemailer: Email sending
Axios: API requests
CORS & Cookie-Parser: Security & session

🤝 Contributing

Fork repository
git checkout -b feature/awesome-feature
Commit changes git commit -m "feat: Added awesome feature"
Push git push origin feature/awesome-feature
Open Pull Request

👤 Author

Arman Mia - GitHub

📄 License

ISC License – See LICENSE file

Name		Name	Last commit message	Last commit date
dist		dist
src		src
.env.example		.env.example
.gitignore		.gitignore
ProConnect APIs.postman_collection.json		ProConnect APIs.postman_collection.json
README.md		README.md
eslint.config.mjs		eslint.config.mjs
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Navigation Menu

Latest commit

History

Folders and files

Repository files navigation

🚀 ProConnect Backend

🔗 Live Demo & Source Code

🛠️ Tech Stack

✨ Key Features

📂 Project Structure

⚙️ Local Setup Guide

Prerequisites

1️⃣ Installation

2️⃣ Environment Variables

3️⃣ Run Development

4️⃣ Build & Production

📜 Available Scripts

🔑 Key Dependencies

🤝 Contributing

👤 Author

📄 License

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages