Hung Yen E-commerce Platform
Overview
Hung Yen E-commerce is a comprehensive B2B e-commerce solution built on MedusaJS, designed to handle complex business requirements including approval workflows, company management, and quote systems.
Key Features
B2B Capabilities
- 🏢 Company Management: Multi-company support with hierarchical structures
- 👥 Employee Management: Role-based access for company employees
- ✅ Approval Workflows: Customizable approval chains for purchases
- 💰 Spending Limits: Budget controls at company and employee levels
- 📋 Quote System: Request and manage quotes from suppliers
Core E-commerce Features
- 🛍️ Product Catalog: Advanced product management with variants
- 🛒 Shopping Cart: B2B-optimized cart with approval requirements
- 📦 Order Management: Complex order workflows
- 💳 Payment Integration: Multiple payment methods
- 🚚 Shipping: Flexible shipping options
Technology Stack
Backend
- MedusaJS: E-commerce engine
- PostgreSQL: Database
- Redis: Caching and sessions
- TypeScript: Type safety
Frontend
- Next.js: Storefront application
- Tailwind CSS: Styling
- TypeScript: Type safety
Admin
- MedusaJS Admin: Extended with custom modules
- React: UI framework
Architecture
hung-yen-ecommerce/
├── backend/ # MedusaJS backend
│ ├── src/
│ │ ├── modules/ # Custom modules (company, approval, quote)
│ │ ├── api/ # API extensions
│ │ └── workflows/ # Business workflows
├── storefront/ # Next.js frontend
└── admin/ # Admin panel customizations
Custom Modules
Company Module
- Company registration and management
- Employee invitation system
- Company settings and preferences
Approval Module
- Approval chain configuration
- Spending limit enforcement
- Approval status tracking
Quote Module
- Quote request creation
- Quote management
- Quote-to-order conversion
Getting Started
- Backend Setup: See Setup Guide
- Storefront Development: Check Storefront Guide
- Admin Customization: Review Admin Panel
Integration Points
- ERP Systems: Order and inventory sync
- Accounting Software: Financial data export
- CRM: Customer data synchronization
- Email Service: Transactional emails
Deployment
The platform is containerized and deployed using:
- Docker for containerization
- Kubernetes for orchestration
- GitHub Actions for CI/CD
Key Workflows
Purchase Approval Flow
- Employee adds items to cart
- System checks spending limits
- Approval request created if needed
- Approver reviews and approves/rejects
- Order proceeds if approved
Quote Request Flow
- Employee creates quote request
- Admin processes quote request
- Quote sent to customer
- Customer accepts/negotiates
- Quote converted to order
Support
For assistance:
- Review the B2B Features Guide
- Check the FAQ
- Contact the e-commerce team