A production-ready backend system for managing coupons in a medicine ordering platform, built with Go.

• Admin Coupon Creation & Management
• Coupon Validation
• Concurrent Request Handling
• Caching with Redis
• PostgreSQL Database
• OpenAPI Documentation
• Docker Support

• Go 1.21+
• Gin Web Framework
• PostgreSQL
• Redis
• GORM
• Docker
• Swagger/OpenAPI

• Go 1.21 or higher
• Docker and Docker Compose
• PostgreSQL
• Redis

1. Clone the repository:

   git clone https://github.com/raman20/crazy-coupon.git
   cd crazy-coupon

2. Copy the environment file and update variables:

   cp .env.example .env

3. Install dependencies:

   go mod download

4. Run with Docker:

   docker compose up --build

   Or run locally:

   go run cmd/main.go

Once the server is running, access the Swagger documentation at:

http://localhost:8080/swagger/index.html

1. Models: Defines the data structures for coupons and related entities
2. Repository: Handles database operations
3. Service: Implements business logic
4. Handler: Manages HTTP requests and responses
5. Middleware: Handles cross-cutting concerns

• Uses Redis for caching frequently accessed coupons
• Implements mutex locks for concurrent coupon validations
• Database-level safety with PostgreSQL transactions

go test ./...

swag init -g cmd/main.go

Contributions are welcome! Please open issues or submit pull requests for improvements or bug fixes.

For support, open an issue on GitHub or contact the maintainer at [email protected].

MIT License