Skip to content

monlai-dev/koi_auction_website

Repository files navigation

🐠 Prestige Koi Auction

A Modern Platform for Premium Koi Fish Auctions

FeaturesInstallationUsageDocumentationSupport

Build Status Version License JavaScript Java


🎯 Overview

Prestige Koi Auction is a sophisticated digital marketplace designed specifically for the premium koi fish auction industry. Our platform bridges the gap between koi breeders and enthusiasts, offering a transparent, secure, and efficient auction experience.

🎭 Key Roles

  • Koi Breeders: Showcase and sell premium koi
  • Managers: Oversee auction operations
  • Staff: Handle inspections and verifications
  • Members: Participate in auctions
  • Guests: Browse available lots

✨ Features

🔐 Security & Authentication

  • JWT-based secure authentication
  • Role-based access control
  • Protected transaction handling

🏷️ Auction Management

  • Multiple Auction Types
    • Fixed Price Sales
    • Sealed Bids
    • Ascending Auctions
    • Descending Auctions
  • Real-time bidding system
  • Automated slot management

💎 Premium Features

  • Quality Assurance
    • Professional fish inspection
    • Detailed documentation
    • Verification process
  • Financial Management
    • Secure deposit system
    • Automated refunds
    • Transparent fee structure

🛠️ Tech Stack

Layer Technologies
Frontend React Vite Tailwind
Backend Java Spring
Database MSSQL
DevOps Docker AWS

🚀 Installation

Prerequisites

Java 21
Node.js 18+
MSSQL 2019+
Maven 3.9+
Redis Server

Database Setup

  1. Create the database:
CREATE DATABASE Koi_project
  1. Configure connection in application.properties:
spring.datasource.url=jdbc:sqlserver://localhost:1433;databaseName=Koi_project;encrypt=true;trustServerCertificate=true
spring.datasource.username=sa
spring.datasource.password=Password@123
  1. Initialize core data:
INSERT INTO AuctionType(auctionTypeName) VALUES
('FIXED_PRICE_SALE'),
('SEALED_BID'),
('ASCENDING_BID'),
('DESCENDING_BID');

INSERT INTO Variety(varietyName) VALUES
('Kohaku'),
('Taisho Sanke'),
('Showa'),
('Shiro Utsuri'),
('Utsurimono'),
('Beni Kikokuryu'),
('Asagi'),
('Kikokuryu'),
('Hikari Muji'),
('Goshiki');

Backend Setup

  1. Start Redis server
  2. Launch the Spring Boot application
  3. Create initial manager account:
GET http://localhost:8080/authenticate/create-manager-account

Frontend Setup

npm install
npm run dev

📚 Documentation

Project Structure

prestige-koi-auction/
├── backend/
│   ├── src/
│   └── pom.xml
├── frontend/
│   ├── src/
│   └── package.json
└── README.md

Default Credentials

Manager Account:
Email: [email protected]
Password: @manager1

VNPay Test Card:
Card Number: 9704195798459170488
Name: NGUYEN VAN A
Issue Date: 07/15
OTP: 123456

🤝 Support

Need help? We're here for you!

📄 License

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


Made with ❤️ by the Prestige Koi Auction Team

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published