• 电商
  • 后端
  • 前端

【免费下载链接】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.

项目地址: https://gitcode.com/gh_mirrors/el/Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS
点击查看 免费下载

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/ 目录中,克隆下来即可直接使用:

![免费开源Next.js电商商城首页耳机商品横幅](https://raw.gitcode.com/gh_mirrors/el/Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS/raw/79fc75ce252ee9a3d97df1c3524a7a3f8ea325db/public/slider image 1.webp?utm_source=gitcode_repo_files)

二、快速上手: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,一个完整的全栈电商商城就跑起来了!桌面端浏览效果类似下图,页面完全响应式,手机端同样可用:

全栈Next.js电商商城电脑端浏览演示

三、新手第一逛:核心功能怎么用?

跑起来之后,建议按这个顺序体验一遍:

  1. 逛商品:首页横幅下方就是商品分区,进入 /shop 可以看全部商品,支持分类筛选、价格区间、排序和分页
  2. 看详情:每个商品有独立 slug 路由(/product/xxx),展示多图、库存状态、购买数量
  3. 加购与结算:加入购物车后在 /cart 调整数量,去 /checkout 填写收货信息下单,订单会实时写入 Customer_order 表
  4. 收藏:登录后可用爱心按钮把商品加入 Wishlist,收藏与用户通过级联删除绑定(见 prisma/schema.prisma 中的 Wishlist 模型)

下图是商城内置的相机类商品展示图,商品详情页的多图切换效果与此类似:

![Next.js电商商城相机类商品展示](https://raw.gitcode.com/gh_mirrors/el/Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS/raw/79fc75ce252ee9a3d97df1c3524a7a3f8ea325db/public/slider image 3.webp?utm_source=gitcode_repo_files)

四、管理后台指南:从创建管理员到批量上传商品

后台是这个项目最大的亮点,所有管理页面都在 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 管理用户角色和商家档案

![电商商城后台管理的鼠标类商品配图](https://raw.gitcode.com/gh_mirrors/el/Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS/raw/79fc75ce252ee9a3d97df1c3524a7a3f8ea325db/public/mouse 1 2.png?utm_source=gitcode_repo_files)

3️⃣ CSV 批量上传:一次上架上千个商品

后台 /admin/bulk-upload 支持拖拽上传 CSV,内置模板、实时分类校验和上传历史,甚至支持按批次删除。完整用法见 BULK-UPLOAD-QUICK-REFERENCE.md,示例 CSV 文件可直接参考 bulk-upload-example.csv,核心解析逻辑在 server/services/bulkUploadService.js。

![电商商城演示用的笔记本电脑商品图](https://raw.gitcode.com/gh_mirrors/el/Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS/raw/79fc75ce252ee9a3d97df1c3524a7a3f8ea325db/public/laptop 2.png?utm_source=gitcode_repo_files)

五、想改配置?关键代码都在这几个文件

想二次开发时,按这张"地图"找代码最省事:

需求文件位置
前后端端口与 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.

项目地址: https://gitcode.com/gh_mirrors/el/Electronics-eCommerce-Shop-With-Admin-Dashboard-NextJS-NodeJS
点击查看 免费下载
Logo

电商企业物流数字化转型必备!快递鸟 API 接口,72 小时快速完成物流系统集成。全流程实战1V1指导,营造开放的API技术生态圈。

更多推荐