一、项目简介绿色出行碳积分激励平台是一套基于 Spring Boot 3 React 18 前后端分离的碳普惠系统。平台围绕“出行-核算-积分-兑换”这一业务闭环实现用户出行记录管理、碳减排量自动核算、积分获取与商品兑换并引入区块链存证机制保证关键数据不可篡改。系统采用标准的前后端分离架构后端提供 RESTful API前端为单页应用SPA通过 JWT 完成无状态认证。系统包含普通用户与管理员两个角色分别面向 C 端出行激励场景与后台运营管理场景覆盖积分规则配置、出行数据统计、兑换流程管理等完整业务流程。二、技术栈技术说明后端框架Spring Boot 3.xORMMyBatis-Plus自动分页、自动填充、Lambda 查询权限认证Spring Security JWT无状态 Token 认证密码加密BCryptPasswordEncoder前端框架React 18 React Router 6UI 组件库Ant Design 5.x状态管理React Context localStorage构建工具Vite数据库MySQL 8.x文件上传MultipartFile 本地存储三、功能模块管理员端管理仪表盘展示注册用户数、出行记录数、兑换记录数、出行方式分布统计图以及月度碳减排趋势图便于运营人员掌握平台整体运行状况。用户管理查看所有用户列表支持按用户名/昵称/手机号模糊搜索可对用户执行启用、禁用与删除操作实现账号生命周期管理。碳积分规则管理维护碳积分核算规则表支持新增、编辑、删除与启停用每条规则包含出行类型、每公里碳减排量、每公里获得积分、规则描述与启用状态后端根据启用规则自动计算积分。积分商品管理管理兑换商品库支持商品分页浏览、新增、编辑与删除商品字段包含名称、描述、图片、所需积分、库存、分类与上下架状态上下架控制用户端可见性。兑换记录管理查看全量用户的兑换记录支持订单状态流转操作包括标记已发货、确认收货、取消订单形成完整的兑换履约流程。数据统计分析查看平台总碳减排量、总出行次数、总出行里程按出行方式统计次数/里程/碳减排量查看月度碳减排趋势图支持按出行方式筛选全部出行记录明细辅助运营决策。普通用户端注册与登录新用户填写用户名、昵称、密码完成注册系统自动赋予 USER 角色登录基于用户名密码成功后返回 JWT Token、用户信息与角色标识。个人仪表盘展示总积分、总碳减排量、出行次数、兑换次数等核心指标并内置月度出行统计图表帮助用户直观了解自身绿色出行贡献。新增出行记录选择出行方式公交/地铁/骑行/步行填写里程、起点、终点与出行日期后端根据启用的积分规则自动计算本次出行的碳减排量与获得积分并同步更新总积分。出行记录列表分页展示个人全部出行记录支持按出行方式筛选每条记录包含出行日期、里程、碳减排量、获得积分以及区块链存证哈希确保数据可追溯。积分明细查询展示个人积分变动流水支持按积分类型EARN/SPEND筛选每条明细记录时间、分值、类型与描述用户可清楚掌握积分来源与去向。积分商品浏览浏览积分兑换商品列表支持按分类筛选商品按所需积分升序排列展示商品名称、图片、所需积分与库存状态。积分商品兑换选择商品后消耗对应积分完成兑换系统自动扣减用户总积分、减少商品库存并生成兑换记录与积分支出明细保证库存与积分一致性。兑换记录查看展示个人历史兑换记录包含兑换商品名称、消耗积分、兑换时间与订单状态用户可随时跟踪兑换进度。个人资料编辑支持修改昵称、头像、手机号、邮箱等基本信息头像通过文件上传接口保存并返回可访问 URL。修改登录密码需验证旧密码输入新密码后以 BCrypt 加密保存保障账号安全。文件上传提供通用图片上传接口基于 MultipartFile 实现本地存储返回可访问的 URL 路径用于更新头像与商品图片等场景。四、项目总结本项目在技术选型上采用当前主流的 Spring Boot 3 React 18 前后端分离架构后端以 MyBatis-Plus 提升开发效率前端以 Ant Design 保证管理界面与用户界面的专业度JWT 无状态认证与 BCrypt 密码加密提供了基础安全保障。业务上覆盖碳减排核算、积分流转、商品兑换与订单管理完整闭环并引入区块链存证哈希增强数据可信度适合作为碳普惠、绿色出行、积分激励等方向的课程设计、毕业设计或企业级项目二次开发的基础工程。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K202
