外贸独立站项目

基于现代技术栈构建的完整外贸独立站解决方案。

• 框架: Next.js 14 (React 18)
• UI: TailwindCSS + shadcn/ui
• 国际化: next-i18next
• 状态管理: Zustand
• 表单: React Hook Form + Zod

• 框架: Node.js + NestJS
• 数据库: MySQL
• ORM: Prisma
• 认证: JWT + Passport
• 文件存储: 阿里云 OSS

• 前端: Vercel / Cloudflare Pages
• 后端: Render / 阿里云
• 数据库: MySQL (云数据库)
• CDN: Cloudflare

npm run install:all

# 复制环境变量文件
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env.local

# 生成 Prisma 客户端
npm run db:generate

# 推送数据库结构
npm run db:push

# 打开数据库管理界面
npm run db:studio

npm run dev

这将同时启动：

• 前端: http://localhost:3000
• 后端: http://localhost:3001

foreignTrade/
├── frontend/              # Next.js 前端项目
│   ├── src/
│   │   ├── app/          # App Router
│   │   ├── components/   # 组件
│   │   ├── lib/         # 工具函数
│   │   └── types/       # TypeScript 类型
├── backend/              # NestJS 后端服务
│   ├── src/
│   │   ├── modules/     # 功能模块
│   │   ├── common/      # 公共模块
│   │   └── prisma/      # 数据库模型
├── database/            # 数据库脚本
├── docs/               # 项目文档
└── shared/             # 前后端共享类型

• 🏠 响应式首页设计
• 🛍️ 产品展示和搜索
• 👤 用户注册登录
• 🛒 购物车和订单
• 📞 多语言支持
• 📱 移动端适配

• 🔐 JWT 身份认证
• 📦 产品管理 API
• 🛒 订单处理系统
• 💳 支付集成
• 📧 邮件通知
• 📊 数据统计

• 代码规范: ESLint + Prettier
• 类型检查: TypeScript
• API 文档: Swagger
• 数据库管理: Prisma Studio
• 错误监控: Sentry

详细开发文档请参考 docs/ 目录。