🚀 A comprehensive NestJS application with MongoDB Atlas integration, JWT authentication, payment processing, and transaction management.

🏗️ NestJS Framework - Progressive Node.js framework with TypeScript

🍃 MongoDB Atlas - Cloud database with Mongoose ODM

🔐 JWT Authentication - Secure authentication with Passport strategies

💳 Payment Gateway - Edviron payment integration with JWT signing

🔗 Webhook Processing - Real-time payment status updates

📊 Transaction APIs - Advanced querying with pagination and sorting

🛡️ Security - Helmet, CORS, input validation, and rate limiting

✅ Validation - Comprehensive request validation with class-validator

📁 Clean Architecture - Well-organized modular structure

📚 API Documentation - Complete Postman collection included

src/ ├── config/ │ └── configuration.ts # Environment configuration ├── decorators/ │ └── public.decorator.ts # Custom decorators ├── dto/ │ ├── create-user.dto.ts # User validation DTOs │ ├── create-payment.dto.ts # Payment validation DTOs │ ├── webhook.dto.ts # Webhook validation DTOs │ └── transaction-query.dto.ts # Transaction query DTOs ├── guards/ │ ├── jwt-auth.guard.ts # JWT authentication guard │ ├── jwt-auth-enhanced.guard.ts # Enhanced JWT guard with public routes │ ├── jwt.strategy.ts # JWT Passport strategy │ └── local.strategy.ts # Local Passport strategy ├── middlewares/ │ └── logger.middleware.ts # HTTP request logging ├── modules/ │ ├── auth/ │ │ ├── auth.controller.ts # Authentication endpoints │ │ ├── auth.service.ts # Authentication logic │ │ └── auth.module.ts # Auth module configuration │ ├── user/ │ │ ├── user.controller.ts # User CRUD endpoints │ │ ├── user.service.ts # User business logic │ │ └── user.module.ts # User module configuration │ └── payment/ │ ├── payment.controller.ts # Payment endpoints │ ├── payment.service.ts # Payment processing logic │ ├── webhook.service.ts # Webhook processing │ ├── transaction.service.ts # Transaction queries │ ├── transaction.controller.ts # Transaction endpoints │ └── payment.module.ts # Payment module configuration ├── schemas/ │ ├── user.schema.ts # User MongoDB schema │ ├── order.schema.ts # Order MongoDB schema │ ├── order-status.schema.ts # OrderStatus MongoDB schema │ └── webhook-logs.schema.ts # WebhookLogs MongoDB schema ├── app.controller.ts ├── app.module.ts # Main application module ├── app.service.ts └── main.ts # Application entry point

Node.js (v18 or higher)

npm or yarn

MongoDB Atlas account

Postman (optional, for API testing)

# Clone the repository git clone <repository-url> cd edviron # Install dependencies npm install

# Copy environment template cp .env.example .env

Edit the .env file with your configuration:

# Application Configuration PORT=3000 NODE_ENV=development # CORS Configuration CORS_ORIGIN=http://localhost:3000,http://localhost:3001 # Payment Gateway Configuration PAYMENT_API_KEY=your-edviron-api-key PG_KEY=your-payment-gateway-key PAYMENT_BASE_URL=https://dev-vanilla.edviron.com # Security Configuration BCRYPT_SALT_ROUNDS=10 API_KEY=your-api-key-here

Create Account: Visit MongoDB Atlas

Create Cluster: Set up a free tier cluster

Database User: Create a user with read/write permissions

Network Access: Whitelist your IP (use 0.0.0.0/0 for development)

Connection String: Copy and update MONGODB_URI in .env

# Development mode with hot reload npm run start:dev # Production mode npm run start:prod # Debug mode npm run start:debug

🎉 Application will be available at:http://localhost:3000

# 1. Create a user curl -X POST http://localhost:3000/users \ -H "Content-Type: application/json" \ -d '{ "username": "johndoe", "email": "john@example.com", "password": "password123", "firstName": "John", "lastName": "Doe" }' # 2. Login to get JWT token curl -X POST http://localhost:3000/auth/login \ -H "Content-Type: application/json" \ -d '{ "email": "john@example.com", "password": "password123" }' # 3. Use JWT token for protected routes curl -X GET http://localhost:3000/auth/profile \ -H "Authorization: Bearer YOUR_JWT_TOKEN"

Import the included Postman collection for easy API testing:

Open Postman

Click Import

Select Edviron-API.postman_collection.json

Update environment variables:

This project is MIT licensed.