Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS完全指南:免费开源Next.js+Node.js全栈电商商城如何快速跑起来
【免费下载链接】Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS
Singitronic is Next.js and Node.js full-stack e-commerce website with a free source code. Our application comes with the fully functional admin panel and it is fully open-source. Our free online store website is completely responsive and manually tested. You can use our e-commerce project as a template or boilerplate for you next project.
Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS 是一个免费开源的 Next.js + Node.js 全栈电商商城项目(名为 Singitronic),内置完整管理后台,基于 MySQL 数据库,支持商品管理、购物车、下单、收藏、用户管理等电商核心功能。本指南面向新手,教你用最少的步骤把这个全栈电商网站跑起来,并看懂后台管理的每一个入口。
一、这个免费电商商城能做什么?
先快速认识一下项目的能力边界,方便你判断它是否适合作为你下一个电商项目的模板或样板(boilerplate):
- 🛒 完整的购物流程:首页 → 商品列表 → 商品详情 → 购物车 → 结算下单,一条链路全部打通
- ❤️ 用户系统:基于 NextAuth 的注册/登录,支持收藏夹(Wishlist)和站内通知
- 📊 功能齐全的管理后台:
/admin路由下可以管理商品、分类、订单、用户和商家 - 📦 CSV 批量上传:支持一次上传 5~1000+ 个商品,带校验和历史记录
- 🔒 工程化细节:接口限流、CORS 白名单、请求日志、错误处理、安全中间件一应俱全
技术栈一览(都是主流技术,学起来不费劲):
| 层次 | 技术 |
|---|---|
| 前端 | Next.js 15 + React 18 + TypeScript + Tailwind CSS |
| 后端 | Node.js + Express |
| 数据库 | MySQL + Prisma ORM |
| 状态管理 | Zustand |
下图就是商城首页的轮播横幅风格,商品图全部内置在项目 public/ 目录中,克隆下来即可直接使用:
二、快速上手:4 步跑起全栈电商商城
整个部署过程只需要 Node.js + MySQL 两个前置条件,跟着下面四步走即可。
第 1 步:安装依赖
先安装 Node.js(含 npm),再安装 MySQL。然后克隆仓库并安装前后端依赖:
git clone https://gitcode.com/gh_mirrors/el/Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS
cd Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS
npm install # 前端依赖
cd server && npm install && cd ..
前端依赖清单见 package.json,后端依赖清单见 server/package.json。
第 2 步:配置 .env 环境变量
在项目根目录创建 .env 文件(把 username/password 换成你的 MySQL 账号密码):
NEXT_PUBLIC_API_BASE_URL=http://localhost:3001
NODE_ENV=development
DATABASE_URL="mysql://username:password@localhost:3306/singitronic_nextjs?sslmode=disabled"
NEXTAUTH_SECRET=12D16C923BA17672F89B18C1DB22A
NEXTAUTH_URL=http://localhost:3000
再在 server/ 目录创建 .env:
NODE_ENV=development
DATABASE_URL="mysql://username:password@localhost:3306/singitronic_nextjs?sslmode=disabled"
💡 前端访问后端的地址由 lib/config.ts 读取
NEXT_PUBLIC_API_BASE_URL,默认就是http://localhost:3001,本地开发不用改。
第 3 步:初始化数据库并插入演示数据
在 server 目录执行 Prisma 迁移,自动建表:
cd server
npx prisma migrate dev
数据表结构(商品、用户、订单、分类、收藏等)定义在 prisma/schema.prisma 中。迁移完成后插入演示商品:
cd utills
node insertDemoData.js
该脚本会写入 1 个演示商家、12 个分类(手机、相机、耳机、鼠标、打印机等)和一批演示商品,源码在 server/utills/insertDemoData.js。
第 4 步:启动前后端,打开浏览器
开两个终端,一个跑后端,一个跑前端:
# 终端 1:server 目录下启动后端(端口 3001)
node app.js
# 终端 2:项目根目录启动前端(端口 3000)
npm run dev
打开 http://localhost:3000,一个完整的全栈电商商城就跑起来了!桌面端浏览效果类似下图,页面完全响应式,手机端同样可用:
三、新手第一逛:核心功能怎么用?
跑起来之后,建议按这个顺序体验一遍:
- 逛商品:首页横幅下方就是商品分区,进入
/shop可以看全部商品,支持分类筛选、价格区间、排序和分页 - 看详情:每个商品有独立 slug 路由(
/product/xxx),展示多图、库存状态、购买数量 - 加购与结算:加入购物车后在
/cart调整数量,去/checkout填写收货信息下单,订单会实时写入Customer_order表 - 收藏:登录后可用爱心按钮把商品加入 Wishlist,收藏与用户通过级联删除绑定(见 prisma/schema.prisma 中的
Wishlist模型)
下图是商城内置的相机类商品展示图,商品详情页的多图切换效果与此类似:
四、管理后台指南:从创建管理员到批量上传商品
后台是这个项目最大的亮点,所有管理页面都在 app/(dashboard)/admin//admin/) 目录下。
1️⃣ 先创建一个管理员账号
访问 /admin 需要 role: "admin" 的登录态,路由守卫实现在 middleware.ts。普通注册的用户没有权限,用内置脚本直接创建管理员(在 server 目录执行):
node createAdminUser.js admin@example.com 你的密码
脚本见 server/createAdminUser.js。已有账号也可以事后提权:
node makeUserAdmin.js user@example.com
2️⃣ 管理商品、分类与订单
登录管理员后进入 /admin,左侧 DashboardSidebar 提供所有入口:
- 商品管理:app/(dashboard)/admin/products//admin/products/) 支持列表、新增、编辑,新增页表单会先做字段清洗再提交 API
- 分类管理:
/admin/categories,商品与分类为级联删除关系 - 订单管理:
/admin/orders,查看每一单的收货信息、状态和商品明细 - 用户与商家:
/admin/users、/admin/merchant管理用户角色和商家档案
3️⃣ CSV 批量上传:一次上架上千个商品
后台 /admin/bulk-upload 支持拖拽上传 CSV,内置模板、实时分类校验和上传历史,甚至支持按批次删除。完整用法见 BULK-UPLOAD-QUICK-REFERENCE.md,示例 CSV 文件可直接参考 bulk-upload-example.csv,核心解析逻辑在 server/services/bulkUploadService.js。
五、想改配置?关键代码都在这几个文件
想二次开发时,按这张"地图"找代码最省事:
| 需求 | 文件位置 |
|---|---|
| 前后端端口与 API 地址 | lib/config.ts |
| 数据库表结构 | prisma/schema.prisma |
| 后端路由与中间件挂载 | server/app.js |
| 限流策略 | server/middleware/rateLimiter.js |
| 登录态与 admin 路由守卫 | middleware.ts |
| 批量上传接口 | server/routes/bulkUpload.js |
| 下单结算表单 | app/checkout/page.tsx |
六、常见问题速查(FAQ)
- 启动后页面空白? 先确认后端终端显示监听
3001端口成功,前端请求的http://localhost:3001是数据源 - Prisma 迁移报错
Can't reach database? 检查 MySQL 是否已启动、.env中DATABASE_URL的账号密码和库名(singitronic_nextjs)是否正确 /admin总是跳回首页? 你登录的不是管理员,运行node makeUserAdmin.js 你的邮箱提权后重新登录- 端口被占用? 改
.env中NEXT_PUBLIC_API_BASE_URL与server/app.js的监听端口,保持两处一致即可
写在最后
从克隆到打开首页,整个过程不到 10 分钟:装依赖、配 .env、跑迁移、起前后端,四个动作完成。作为一份免费开源的全栈电商模板,它把商品、购物车、订单、收藏、通知、批量上传和限流这些电商必备件都准备好了,非常适合作为你学习 Next.js + Node.js 全栈开发、甚至直接孵化自己商城项目的起点。
动手跑起来,剩下的交给探索!
【免费下载链接】Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS
Singitronic is Next.js and Node.js full-stack e-commerce website with a free source code. Our application comes with the fully functional admin panel and it is fully open-source. Our free online store website is completely responsive and manually tested. You can use our e-commerce project as a template or boilerplate for you next project.
更多推荐






所有评论(0)