本地开发指南

一、环境要求

组件 版本/要求 备注
JDK 1.8 若大于20，lombok依赖会报错
PostgreSQL 14 / 15 关系型数据库
Redis 6.2.21 中间件
前端框架 Vue 3 Web管理后台
小程序 Uniapp、Vue 2 微信小程序
构建工具 Maven >= 3.0 后端构建

二、API 项目开发

项目运行配置文件位于：charging-api/xingchuan-admin/src/main/resources/application.yml，核心配置可参考 charging-api/.docker.env，支持环境变量注入。 

# 数据库配置
DB_HOST=127.0.0.1
DB_PORT=5432
DB_NAME=charge
DB_USER=postgres
DB_PASSWORD=postgres

# Redis 配置
REDIS_HOST=localhost
REDIS_PORT=6379

# RocketMQ 配置
ROCKETMQ_NAME_SERVER=127.0.0.1:9876

三、Web 前端开发

  • 环境要求： Node.js >= 18，包管理器 Yarn。
  • 安装依赖： 在 charging-web 目录下执行 yarn install。
  • 配置 API 地址： 在 vite.config.js 中修改 proxy target 为您的本地或测试 API 地址 (如 http://localhost:8080/)。
  • 启动服务： 执行 yarn dev。
  • 构建打包： 执行 yarn build，生成 dist 文件夹。

四、小程序开发

  • 注册与权限： 注册微信小程序，开通所需权限，并申请腾讯地图 API Key。
  • 开发工具： 安装 HbuilderX 和 微信开发者工具。
  • 配置 AppID： 在 manifest.json 中配置微信小程序 AppID。
  • 安装依赖： 在 charging-mini 目录执行 npm i sass -D 和 npm i sass-loader -D 安装 uview-ui 依赖。
  • 环境配置： 在 static/js/app.js 中设置 appid, api (接口地址), qqMapKey。
  • 运行调试： 在 HbuilderX 中选择 运行 -> 运行到小程序模拟器 -> 微信开发者工具。
`