Self-Claim Link

A modern Next.js application for digital product delivery through order ID claiming. Customers can claim virtual products using order IDs, while administrators manage products and orders through a comprehensive dashboard.

🚀 Features

Customer Interface

• Simple Claiming Process: Enter order ID to claim digital products
• Instant Download Links: Automatic generation of secure download links
• Multi-Product Support: Handle multiple products per order
• Expiration Management: Time-limited access to prevent abuse
• One-Time Use Control: Configurable claim restrictions

Admin Dashboard

• Product Management: Create, edit, and delete digital products
• Order Management: Generate orders with product assignments
• Flexible Configuration: Set expiration dates and usage limits
• Secure Authentication: JWT-based admin access
• Real-Time Status: Track claim counts and order status

🛠️ Tech Stack

• Frontend: Next.js 15.4.6, React 18, TypeScript
• Styling: Tailwind CSS with responsive design
• Backend: Next.js API Routes
• Database: SQLite with structured schema
• Authentication: JWT tokens with bcrypt hashing
• Icons: Lucide React

📦 Installation

1. Clone the repository

   git clone https://github.com/your-username/self-claim-link.git
   cd self-claim-link

2. Install dependencies

   npm install --legacy-peer-deps

3. Start development server

   npm run dev

4. Access the application

   • Customer interface: http://localhost:3000
   • Admin dashboard: http://localhost:3000/admin

🔧 Configuration

Create a .env.local file in the root directory. Do not commit this file to version control.

# Required: A strong, unique secret for JWT token signing.
# In production, GENERATE A RANDOM, LONG, AND COMPLEX KEY (e.g., using `openssl rand -base64 32`).
# Example (Development): JWT_SECRET=super-dev-secret
JWT_SECRET=your-super-secret-jwt-key-here 

# Set to 'production' for production deployments.
NODE_ENV=development 

Default Admin Account

• Development Only: A default admin account (username: admin, password: password) is automatically created ONLY when NODE_ENV is NOT production. This is for convenience during development.
• Production Warning: In a production environment, this default admin account is NOT created. You MUST manually create the first administrator account with strong, unique credentials. Refer to "Deployment" for production setup.
• NEVER use default credentials in production!

🏗️ Database Migrations

To ensure robust schema management and facilitate easier updates, it is highly recommended to integrate a database migration tool. This helps in versioning your database schema and applying changes in a controlled manner across different environments.

Recommended Tools:

• Knex.js: A popular SQL query builder that includes migration capabilities.
• Prisma Migrate: A declarative, type-safe database migration system.

Getting Started:

1. Install your chosen migration tool (e.g., npm install knex or npm install prisma --save-dev and npm install @prisma/cli --save-dev).
2. Configure the tool to connect to your database.sqlite file.
3. Create initial migration files to define your current schema (products, orders, order_products, settings, admins).
4. Run migrations using the tool's command-line interface to set up the database schema.

This practice will significantly improve maintainability and reduce potential conflicts during development and deployment.

📊 Database Schema

The application uses SQLite with the following tables:

• products: Digital products with download links
• orders: Order tracking with claim status and expiration
• order_products: Many-to-many relationship between orders and products
• admins: Admin user authentication
• settings: System configuration

🔐 API Endpoints

Public Endpoints

• POST /api/claim - Claim products with order ID

Admin Endpoints (Requires Authentication)

• POST /api/auth/login - Admin login
• GET /api/admin/me - Get admin info
• GET|POST|PUT|DELETE /api/products - Product management
• GET|POST|PUT|DELETE /api/orders - Order management
• GET|PUT /api/settings - System settings

🎯 Usage

For Customers

1. Visit the main page
2. Enter your order ID in the input field
3. Click "Claim Products"
4. Download your products using the provided links

For Administrators

1. Navigate to /admin/login
2. Login with admin credentials
3. Use the dashboard to:
   • Create and manage digital products
   • Generate orders with product assignments
   • Configure system settings
   • Monitor claim activity

🏗️ Project Structure

self-claim-link/
├── app/
│   ├── admin/
│   │   ├── login/
│   │   └── page.tsx          # Admin dashboard
│   ├── api/
│   │   ├── admin/
│   │   ├── auth/
│   │   ├── claim/
│   │   ├── orders/
│   │   ├── products/
│   │   └── settings/
│   ├── globals.css
│   ├── layout.tsx
│   └── page.tsx              # Customer interface
├── lib/
│   ├── database.ts           # Database configuration
│   └── types.ts              # TypeScript interfaces
├── package.json
└── README.md

🚀 Deployment

Build for Production

npm run build
npm start

Environment Setup

1. Set NODE_ENV=production
2. Configure secure JWT_SECRET
3. Set up proper database backup strategy
4. Configure reverse proxy (nginx/Apache)
5. Enable HTTPS in production

🔒 Security Considerations

• Change default admin credentials
• Use strong JWT secrets
• Implement rate limiting for production
• Regular database backups
• HTTPS enforcement
• Input validation and sanitization (all API routes)
• Explicit CORS configuration for production environments (if client and server are on different domains)

📝 Development

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run lint - Run ESLint

Adding New Features

1. Create API routes in app/api/
2. Update database schema in lib/database.ts
3. Add TypeScript interfaces in lib/types.ts
4. Implement UI components in respective pages

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md for details on how to get started.

📜 Changelog

See the CHANGELOG.md for a history of changes.

🎉 Acknowledgments

• Built with Next.js
• Styled with Tailwind CSS
• Icons by Lucide

🏗️ Project Structure

self-claim-link/
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── feature_request.md
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── workflows/
│       └── ci.yml
├── app/
│   ├── admin/
│   │   ├── login/
│   │   └── page.tsx          # Admin dashboard
│   ├── api/
│   │   ├── admin/
│   │   ├── auth/
│   │   ├── claim/
│   │   ├── orders/
│   │   ├── products/
│   │   └── settings/
│   ├── globals.css
│   ├── layout.tsx
│   └── page.tsx              # Customer interface
├── lib/
│   ├── database.ts           # Database configuration
│   └── types.ts              # TypeScript interfaces
├── .dockerignore
├── Dockerfile
├── docker-compose.yml
├── .env.example
├── CONTRIBUTING.md
├── CHANGELOG.md
├── LICENSE
├── package.json
└── README.md