A Next.js application that implements a fair coupon distribution system with abuse prevention mechanisms.

This system distributes coupons in a round-robin fashion while preventing abuse through IP tracking and cookie-based monitoring. Built with Next.js 14, MongoDB, and modern web technologies.

Last Updated: 2025-03-12 08:35:26 UTC
Maintained by: vikasyadav01234

• Sequential coupon assignment ensuring fair distribution
• Automatic tracking of coupon usage and limits
• Support for coupon expiration dates

• IP-based tracking with cooldown periods
• Browser session monitoring via cookies
• Rate limiting for claim attempts

• No login required for claiming coupons
• Clear feedback messages
• Responsive design
• Real-time coupon availability status

• Frontend: Next.js 14, React 18
• Backend: Next.js API Routes
• Database: MongoDB
• State Management: React Hooks
• Styling: CSS Modules

• Node.js 18.x or higher
• MongoDB Atlas account or local MongoDB instance
• npm or yarn package manager

1. Clone the repository:

git clone https://github.com/vikasyadav01234/round-robin-coupon-distribution.git
cd round-robin-coupon-distribution

2. Install dependencies:

npm install

3. Create a .env.local file in the root directory:

MONGODB_URI=mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/coupon-system?retryWrites=true&w=majority

4. Seed the database with initial coupons:

npm run seed

5. Start the development server:

npm run dev

round-robin-coupon-distribution/
├── src/
│   ├── app/
│   │   ├── api/
│   │   │   └── claimCoupon/
│   │   │       └── route.js
│   │   ├── layout.js
│   │   └── page.js
│   ├── components/
│   │   ├── CouponClaimForm.js
│   │   └── CouponMessage.js
│   ├── models/
│   │   └── coupon.js
│   ├── styles/
│   │   ├── globals.css
│   │   └── Home.module.css
│   └── utils/
│       ├── coupons.js
│       └── dbConnect.js
├── scripts/
│   └── seed-coupons.js
├── .env.local
├── package.json
└── README.md

Claims a coupon for the current user.

Response:

{
  "message": "Successfully claimed coupon: SAVE10",
  "coupon": "SAVE10"
}

Error Response:

{
  "message": "Please wait 45 minutes before claiming another coupon"
}

{
  code: String,          // Coupon code
  isActive: Boolean,     // Coupon availability status
  createdAt: Date,       // Creation timestamp
  expiresAt: Date,       // Expiration date
  usageLimit: Number,    // Maximum number of claims
  usageCount: Number     // Current number of claims
}

{
  couponId: ObjectId,    // Reference to claimed coupon
  ipAddress: String,     // Claimer's IP address
  sessionId: String,     // Browser session ID
  claimedAt: Date        // Claim timestamp
}

1. IP Tracking

   • 10 Minutes cooldown between claims
   • IP address validation

2. Session Management

   • Secure cookie settings
   • HTTP-only cookies
   • SameSite cookie policy

3. Rate Limiting

   • Request rate limiting
   • Abuse prevention mechanisms

npm run test

npm run build

npm run dev

1. Fork the repository
2. Create your 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

This project is licensed under the MIT License - see the LICENSE file for details.

• Next.js team for the amazing framework
• MongoDB team for the reliable database
• All contributors and maintainers

For support, please create an issue in the repository or contact vikasyadav01234.

Built with ❤️ by vikasyadav01234