Hyundai Ecommerce

B2B E-commerce Platform for Industrial Equipment

A modern, high-performance B2B e-commerce system specialized in heavy machinery and industrial power generators (Hyundai, Mitsubishi, Kubota, etc.), built with focus on complex quote negotiation, multi-warehouse logistics, and enterprise-grade architecture.

---

🚀 Live Sites

• Main Storefront: https://hyundainhatnang.ngxc.io.vn
• Technical Documentation: https://docs.hyundainhatnang.ngxc.io.vn

---

✨ Key Features

• Advanced product filtering on technical specifications (JSONB)
• Full B2B quote negotiation workflow (Request → Review → Final Price → Payment)
• Multi-warehouse inventory with real-time stock management
• Dealer tier-based automatic pricing
• Secure guest + user cart with concurrency control
• Auto-generated technical documentation (Fumadocs)
• End-to-end type safety from database to frontend

---

🛠 Tech Stack

• Framework: Next.js 16 (App Router + React Server Components)
• Runtime: Bun
• Monorepo: Turborepo
• Database: Neon Serverless PostgreSQL + Drizzle ORM v1
• Authentication: Better Auth
• Documentation: Fumadocs
• UI: shadcn/ui + Tailwind CSS v4
• State Management: Zustand
• Background Jobs: Inngest
• Caching: Upstash Redis

---

📁 Project Structure

hyundai-ecommerce/
├── apps/
│   ├── storefront/          # Customer-facing website
│   └── docs/                # Technical documentation site (Fumadocs)
├── packages/
│   ├── database/            # Drizzle schemas, queries & migrations
│   ├── types/               # Shared TypeScript types
│   ├── typescript-config/   # Shared TS config
│   └── eslint-config/       # Shared ESLint configuration
├── .github/workflows/       # CI/CD pipelines
└── turbo.json

---

🚀 Getting Started

Prerequisites

• Bun (recommended)

Local Development

bun install

# Run both apps
bun run dev

Or run separately:

bun --filter=storefront run dev     # → http://localhost:3000
bun --filter=docs run dev --port 3001   # → http://localhost:3001

---

📦 Scripts

bun run dev          # Start all development servers
bun run build        # Build all apps
bun run lint         # Run ESLint
bun run db:generate  # Generate Drizzle migrations
bun run db:push      # Push schema to database

---

📄 License

This project is licensed under the MIT License.

---

🤝 Contributing

We welcome contributions! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

---

🗺 Roadmap

• Admin Panel (CMS)
• Advanced AI Product Recommendation Chatbot
• Multi-stage payment (deposit + final payment)
• PDF Quote Generation with official stamps
• Dynamic form builder for product attributes
• Internationalization (multi-language support)

---

Built with ❤️ for industrial equipment distribution.