# 个人碳账户低碳积分平台

**Repository Path**: geqianjun/carbon-ledger

## Basic Information

- **Project Name**: 个人碳账户低碳积分平台
- **Description**: J2EE课程实践项目 - 个人碳账户·低碳积分平台（Spring Boot + Vue 3 + MySQL）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人碳账户 · 低碳积分平台

> 2025-2026 学年《J2EE 高级开发框架》课程实践项目

## 项目简介

个人碳账户平台通过量化、可激励的方式引导公众践行低碳行为。用户记录日常低碳行为（步行、骑行、光盘行动等），系统按可配置的折算规则计算减排量与积分，并通过等级、排行榜、积分商城等机制形成正向激励。

## 技术栈

| 层 | 技术 |
|----|------|
| 后端 | Spring Boot 2.7 + Spring MVC + MyBatis-Plus |
| 数据库 | MySQL 8.0 |
| 前端 | Vue 3 + Vite + Element Plus + Pinia |
| 鉴权 | JWT (jjwt 0.9.1) |
| 密码加密 | BCrypt |

## 核心功能

- 用户注册/登录（JWT 鉴权）
- 低碳行为打卡（防重复、折算规则可配置）
- 积分账户（明细可追溯、等级自动升级）
- 积分商城兑换（事务一致、乐观锁防超兑）
- 实时排行榜（日榜/周榜/总榜）
- 月度减排报告
- 管理员后台（用户/行为/商品/兑换/数据大盘）
- 统一异常处理 + 输入校验 + 审计日志

## 快速启动

### 1. 数据库初始化

```bash
mysql -u root -p < 源代码/sql/init.sql
```

### 2. 启动后端

```bash
cd 源代码/backend
mvn clean package -DskipTests
java -jar target/carbon-ledger-1.0.0.jar
```

### 3. 启动前端

```bash
cd 源代码/frontend
npm install
npm run dev
```

### 4. 访问

- 前端开发环境：http://localhost:5173
- 后端 API：http://localhost:8080/api
- 测试账号：admin / 123456

## 项目结构

```
源代码/
├── backend/          # Spring Boot 后端
├── frontend/         # Vue 3 前端
├── sql/              # 数据库初始化脚本
└── docs/             # 项目文档
```

## 开发信息

- 学号：20252160A1302
- 姓名：余旭
- 班级：2313班
- 指导老师：吴海子
- 学校：湖北师范大学