# low-carbon-platform

**Repository Path**: fsfree79/low-carbon-platform

## Basic Information

- **Project Name**: low-carbon-platform
- **Description**: 面向生态文明建设的低碳积分管理与数据可视化平台 - 基于 Spring Boot + Vue3 的全栈项目
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🌱 面向生态文明建设的低碳积分管理与数据可视化平台

## 项目运行部署指南

尊敬的老师，您好！

本项目为《面向生态文明建设的低碳积分管理与数据可视化平台》。采用 **Spring Boot 2.7 + Vue 3 + MySQL + Redis** 架构。

---

## 一、环境准备

| 环境 | 位置 / 版本要求 | 用途 |
|------|----------------|------|
| **JDK** | Java 8 或以上 | 运行后端 |
| **Node.js** | v14 或以上 | 运行前端 |
| **MySQL** | 位于 `D:\mysql` | 数据存储 |
| **Redis** | 位于 `D:\Redis-x64-5.0.14.1` | 登录 Token 存储 |
| **IntelliJ IDEA** | 已安装 | 运行后端 |

> 💡 **无需手动创建数据库和表！** 后端启动时会自动完成。

---

## 二、启动基础设施

### 1️⃣ 启动 MySQL

打开终端，运行：

```cmd
D:\mysql\bin\mysqld.exe
```

保持这个窗口开着。

### 2️⃣ 启动 Redis

打开另一个终端，运行：

```cmd
D:\Redis-x64-5.0.14.1\redis-server.exe
```

看到 Redis 图标和端口号说明启动成功，保持这个窗口开着。

---

## 三、启动后端（Spring Boot，两种方式选其一）

### 方式 A：在 IDEA 中直接运行（推荐）

1. 用 IntelliJ IDEA 打开项目 `D:\@Devcode\JavaHomeWork\low-carbon-platform`
2. IDEA 会自动识别为 Maven 项目并下载依赖（等待右下角进度条跑完）
3. 找到 `LowCarbonApplication.java`（路径：`backend/src/main/java/com/lowcarbon/LowCarbonApplication.java`）
4. **右键 → Run 'LowCarbonApplication'**（或者点类名左边的绿色三角 ▶）
5. 看到以下输出表示启动成功：
   ```
   ✓ 用户数据初始化完成 (admin/admin123, zhangsan/123456)
   低碳生活平台后端服务启动成功
   ```

### 方式 B：在终端中运行

```cmd
cd D:\@Devcode\JavaHomeWork\low-carbon-platform\backend
mvn spring-boot:run
```

> 如果提示 `mvn` 不是命令，请先下载 Maven：https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.zip
> 解压到任意目录，将其 `bin` 文件夹路径添加到系统环境变量 `Path` 中。

后端运行在 **http://localhost:8088**。

---

## 四、启动前端（Vue 3 + Vite）

打开**另一个终端**（后端要保持运行），依次运行：

```cmd
cd D:\@Devcode\JavaHomeWork\low-carbon-platform\frontend

rem 首次运行需要安装依赖（仅执行一次，以后可跳过）
npm install

rem 启动开发服务器
npm run dev
```

看到以下输出表示启动成功：

```
  VITE v8.x.x  ready in xxx ms
  ➜  Local:   http://localhost:3000/
```

在浏览器打开 **http://localhost:3000/login** 即可访问。

> 📌 前端已配置代理，`/api` 请求会自动转发到后端 8088 端口，无需额外配置。

---

## 五、体验账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | `admin` | `admin123` |
| 普通用户 | `zhangsan` | `123456` |

> ✅ **每次重启后端，密码都会重置为上述默认值**，保证不论部署多少次，都能用同样的账号登录。

---

## 六、项目结构

```
low-carbon-platform/
├── backend/                        # Spring Boot 后端（端口 8088）
│   ├── src/main/java/com/lowcarbon/
│   │   ├── controller/             # API 接口
│   │   ├── service/                # 业务逻辑
│   │   ├── mapper/                 # 数据访问
│   │   ├── entity/                 # 数据实体
│   │   ├── config/                 # 配置（CORS、拦截器）
│   │   └── util/                   # 工具类（MD5加密、数据初始化）
│   └── src/main/resources/
│       ├── application.yml         # 配置文件
│       └── schema.sql              # 自动建表
├── frontend/                       # Vue 3 前端（端口 3000）
│   └── src/
│       ├── views/                  # 页面
│       ├── router/                 # 路由
│       ├── store/                  # 状态管理
│       ├── api/                    # API 封装
│       └── utils/                  # 工具（请求拦截器）
└── README.md
```

---

## 七、常见问题

**Q：MySQL 启动后闪退？**
检查 `D:\mysql\data` 目录下有没有错误日志，或者检查 3306 端口是否被占用：
```cmd
netstat -ano | findstr 3306
```

**Q：Redis 启动后闪退？**
检查 6379 端口是否被占用：
```cmd
netstat -ano | findstr 6379
```

**Q：前端 `npm install` 太慢？**
设置国内镜像加速：
```cmd
npm config set registry https://registry.npmmirror.com
npm install
```

**Q：登录提示"用户名或密码错误"？**
确认后端是否已经完全启动（看到成功横幅），且 MySQL 和 Redis 都已经提前运行。

---

感谢您的审阅！祝工作顺利！