ye-yellow/bytedanceliveauctioni

This is a demo live auction platform built for a ByteDance e-commerce challenge. It models the kind of real-time auction experience used in live-stream shopping apps, where sellers list items and buyers place bids while watching a live session. The project is a working full-stack application, not a prototype, and covers the entire flow from a merchant creating auction lots to buyers bidding, winners being determined, and orders being created. The system has three main parts: a backend service written in Go, a merchant control panel for the browser, and a buyer-facing mobile web client. The backend handles bid validation, winner resolution, and state management. Both client applications are built with React and TypeScript and connect to the backend over standard HTTP and WebSocket connections. Real-time updates are central to the design. When a buyer places a bid or the auction countdown changes, all connected participants see the new state within milliseconds via WebSocket push. To keep bid decisions consistent even under high concurrency, the backend uses Redis with Lua scripts, which run atomically and prevent two buyers from winning the same lot at the same time. Final business records, like orders and payment status, go into a MySQL database for durability. There is also an optional semantic search feature for finding auction lots by description rather than exact keywords. This uses a PostgreSQL extension called pgvector along with an external AI embedding service. For local development, mock responses are used so the full system runs without any cloud credentials. Setting up the project locally requires Docker, Go, and Node.js. A provided Docker Compose file starts MySQL, Redis, and supporting services with one command. The README includes a default admin username and password for the merchant console, and separate start commands for each of the three components.