refactor: migrate backend framework from Express to NestJS

This commit is contained in:
2026-02-07 01:45:53 +08:00
parent 2c006c3330
commit 1eb8abb447
31 changed files with 6052 additions and 995 deletions

View File

@@ -1,13 +1,12 @@
# 溯源管理平台 - 后端服务
浙江贝凡溯源管理平台的后端服务,基于 Node.js + TypeScript + Express + SQLite。
浙江贝凡溯源管理平台的后端服务,基于 NestJS + TypeScript + SQLite。
## 技术栈
- **Node.js**: 运行时环境
- **NestJS**: 渐进式 Node.js 框架
- **TypeScript**: 类型安全
- **Express**: Web 框架
- **SQLite**: 数据库
- **SQLite**: 轻量级数据库
- **JWT**: 身份认证
- **bcryptjs**: 密码加密
@@ -15,24 +14,37 @@
```
backend/
├── routes/ # API 路由
│ ├── auth.ts # 认证路由
│ ├── serials.ts # 序列号路由
└── companies.ts # 企业路由
├── middleware/ # 中间件
── auth.ts # 认证中间件
├── scripts/ # 脚本
── init-db.ts # 数据库初始化
├── utils/ # 工具函数
└── database.ts # 数据库连接
├── types/ # 类型定义
── index.d.ts # TypeScript 类型
├── data/ # 数据文件
│ └── database.sqlite
├── server.ts # 服务器入口
├── tsconfig.json # TypeScript 配置
├── .env # 环境变量
└── package.json # 项目配置
├── src/
│ ├── auth/ # 认证模块
│ ├── auth.controller.ts
│ ├── auth.guard.ts
│ │ ├── auth.module.ts
│ ├── auth.service.ts
└── dto/
── companies/ # 企业模块
│ │ ├── companies.controller.ts
│ ├── companies.module.ts
└── companies.service.ts
── database/ # 数据库模块
│ │ ├── database.module.ts
│ └── database.service.ts
├── serials/ # 序列号模块
│ │ ├── serials.controller.ts
├── serials.module.ts
│ │ ├── serials.service.ts
│ │ └── dto/
│ ├── types/ # 类型定义
│ │ └── index.d.ts
│ ├── utils/ # 工具函数
│ ├── app.module.ts # 根模块
│ ├── health.controller.ts
│ └── main.ts # 应用入口
├── data/ # 数据文件
├── scripts/ # 脚本
├── .env # 环境变量
├── package.json
├── tsconfig.json
└── README.md
```
## 安装
@@ -46,7 +58,7 @@ pnpm install
启动开发服务器(支持热重载):
```bash
pnpm dev
pnpm start:dev
```
服务器将在 http://localhost:3000 运行
@@ -64,7 +76,7 @@ pnpm build
启动生产服务器:
```bash
pnpm start
pnpm start:prod
```
## 数据库初始化