platform

README

<p align="center">
 <a target="_blank" href="https://gitee.com/fuyang_lipengjun/platform/blob/master/LICENSE"><img src="https://img.shields.io/github/license/lipengjun92/platform-wxshop"/></a>
 <a href='https://gitee.com/fuyang_lipengjun/platform/stargazers'><img src='https://gitee.com/fuyang_lipengjun/platform/badge/star.svg?theme=gvp' alt='star'/></a>
 <a href='https://gitee.com/fuyang_lipengjun/platform/members'><img src='https://gitee.com/fuyang_lipengjun/platform/badge/fork.svg?theme=gvp' alt='fork'/></a>
 <a target="_blank" href="https://gitee.com/fuyang_lipe ngjun/platform/contributors?ref=master"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgitee.com%2Ffuyang_lipengjun%2Fplatform%2Fcontributors_count%3Fref%3Dmaster&query=contributors_count&label=Contributors&color=green"/></a>
 <a target="_blank" href="http://makeapullrequest.com"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome" title="PRs Welcome"></a>
</p>
<p align="center">
 <img src="https://img.shields.io/github/languages/count/lipengjun92/platform-wxshop?color=red"/>
 <img src="https://img.shields.io/badge/Java-21-blue.svg"/>
 <img src="https://img.shields.io/badge/SpringBoot-2.7.15-blue.svg"/>
 <img src="https://img.shields.io/badge/MyBatisPlus-3.5.3-blue.svg"/>
 <img src="https://img.shields.io/badge/weixin%20java-4.5.2-blue.svg"/>
 <img src="https://img.shields.io/badge/MySQL-8.0-blue.svg"/>
</p>

## 前后端全部开源微信小程序商城（Java + uniapp）

### 技术站：
- SpringBoot
- Vue2、ElementUI

### 重要说明
- 微信 Ai 能力已经接入，需要在微信公众平台开通`AI 能力`，手机体验微信版本最低 `8.0.75`，开发工具中调试基础库最低`3.16.1`
- 微信 Ai 能力还在灰度内测，暂未开放提审
- 如果开发中遇到不清楚的地方可以添加下方客服微信，请注明来意
- 项目合作洽谈，请联系客服微信（使用微信扫码添加好友，请注明来意）。
- 如需购买 [商业版源码](https://openwtai.com/blogs) 请联系客服。<br>
  <img height="564" src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/2c05419f3beecaecbef33814.png" title="微信" width="444"/>

## 使用须知
### ✅允许
- 个人学习使用
- 允许用于学习、毕设等
- 允许进行商业使用，请自觉遵守使用协议，如需要商业使用推荐购买[商业版源码](https://openwtai.com/blogs)
- 请遵守 Apache License2.0 协议，再次开源请注明出处
- 推荐Watch、Star项目，获取项目第一时间更新，同时也是对项目最好的支持
- 希望大家多多支持原创作品

### 重要链接
- 官网：[https://openwtai.com](https://openwtai.com)
- 开发文档：[http://doc.openwtai.com](http://doc.openwtai.com)
- 在线体验：[https://doc.openwtai.com/zh-CN/start/view.html](https://doc.openwtai.com/zh-CN/start/view.html)
- Gitee仓库：[https://gitee.com/fuyang_lipengjun/platform](https://gitee.com/fuyang_lipengjun/platform)
- Github仓库：[https://github.com/lipengjun92/platform-wxshop](https://github.com/lipengjun92/platform-wxshop)

### QQ交流群
<a target="_blank" href="https://qm.qq.com/cgi-bin/qm/qr?k=NI1TX8jkEeRITDnYv-oZ-9onMwNN9MNs&jump_from=webapi&authKey=a/L8SQ0vmI4X9Vomv7JK8Z3t94OxROqmNUW8gUGsldCHpcbd7db26DVB410gNhZv"><img border="0" src="https://img.shields.io/badge/点击加入-66502035-green.svg" alt="微同科技 ①群" title="微同科技 ①群"></a>
<a target="_blank" href="https://qm.qq.com/cgi-bin/qm/qr?k=qB5gb43KlRIN-5dsIstw-gljfwD-LxDt&jump_from=webapi&authKey=Ua6s5QIIHy9Gf7Df/h1w93wBqaJax3hBPzUmREwDU31H7TMWO5pAh2ua9Bw9z231"><img border="0" src="https://img.shields.io/badge/点击加入-870579539-green.svg" alt="微同科技 ②群" title="微同科技 ②群"></a>
<a target="_blank" href="https://qm.qq.com/cgi-bin/qm/qr?k=21agOH-MqJLZ5YqxNb-sBcPCB5PTl7XH&jump_from=webapi&authKey=hV6jd0tppJqvTWE/iSEHwLJg5EsTaz/aY/1bj8gWg4giQ4JdDEzYiK12F+u1TnuZ"><img border="0" src="https://img.shields.io/badge/点击加入-151602347-green.svg" alt="微同科技 ③群" title="微同科技 ③群"></a>
<a target="_blank" href="https://qm.qq.com/cgi-bin/qm/qr?k=-uoUHqs9-qKf8rI5Ni1N7XPWmuUjqW2j&jump_from=webapi&authKey=f1FbGXYVKDo/gfgV9ZOY4XGkmn9huc+0Qx+1IbPP6kJsFyZo3SNOEXJYdWzk8jnu"><img border="0" src="https://img.shields.io/badge/点击加入-476734088-green.svg" alt="微同科技 ④群" title="微同科技 ④群"></a>
<a target="_blank" href="https://qm.qq.com/q/rzuWvSHsbY"><img border="0" src="https://img.shields.io/badge/点击加入-690637772-green.svg" alt="微同科技 ⑤群" title="微同科技 ⑤群"></a>

## 系统架构图
![](./images/system-architecture.png "系统架构图")

## 时序架构图
![](./images/sequence.png "时序架构图")

## 项目结构
~~~
platform
|--_sql 初始化数据库脚本
|--platform-admin 后台管理接口服务
|--platform-admin-ui 后台管理页面
|--platform-api 微信小程序商城api接口服务
|--platform-biz 业务代码
|--platform-common 公共模块
|--uni-mall uniapp版商城
|--wx-mall 微信小程序原生商城
~~~

## 安装教程

### 方式一：把项目丢给 AI 助手（最省事）⭐

本项目自带 AGENTS.md，Claude Code / Codex / Cursor / Trae / Windsurf / Cline 等 AI 编程助手会自动读取它。

**还没下载项目？** 直接对 AI 说：

> 请帮我启动这个项目：https://raw.githubusercontent.com/lipengjun92/platform-wxshop/refs/heads/master/AGENTS.md

AI 会读取启动说明，先克隆项目，再继续配置和启动。链接文件名区分大小写；

**也可以先自己下载项目：**

```bash
git clone https://gitee.com/fuyang_lipengjun/platform.git
cd platform
```

然后把目录丢给你的 AI 助手，说一句：

> 按 AGENTS.md 把这个项目跑起来

它会自动检查运行时、装依赖、引导你填配置、建表、启动、并验证页面能打开。首次配置大约 10 分钟。

### 方式二：自己动手

* 配置环境（推荐Java21、maven3.8、mysql8.0、redis4.0.1）
* 创建数据库
* 依次初始化sql脚本 
    * /_sql/base.sql
    * /_sql/mall.sql
    * /_sql/sys_region.sql

* 导入项目到IDE中
* 导入支付证书至/platform-admin/src/main/resources/cert/目录下（申请商户号、开通微信支付、下载支付证书）
* 导入支付证书至/platform-api/src/main/resources/cert/目录下
* 修改配置文件 /platform-admin/src/main/resources/application.yml
* 修改配置文件 /platform-api/src/main/resources/application.yml
  * 微信公众号配置
  * 微信小程序配置
  * 微信支付配置
* 修改配置文件 /platform-admin/src/main/resources/application-dev.yml
* 修改配置文件 /platform-api/src/main/resources/application-dev.yml
  * 数据库配置
* 启动redis服务
* 启动后台项目
  * 启动类：PlatformAdminApplication.java
  * 启动类：PlatformApiApplication.java
* 打开微信开发者工具
* 导入 /wx-mall填写appId
* 修改 /wx-mall/config/api.js里API_BASE_URL的值
* 使用idea启动项目访问路径
    * [http://localhost:8000](http://localhost:8000)

## Docker 一键启动

适用前提：

```bash
scripts/build-jars.sh
scripts/build-admin-ui.sh
```

输出到：

* `deploy/packages/platform-admin.jar`
* `deploy/packages/platform-api.jar`
* `deploy/packages/platform-admin-ui-dist/`

首次启动前，如需调整 Maven profile、端口、数据库密码或 JVM 参数，先复制配置文件：

```bash
cp deploy/.env.example deploy/.env
```

其中：

* `MAVEN_PROFILE` 控制 `scripts/build-jars.sh` 使用的 Maven profile，默认 `dev`
* `NGINX_PORT` 默认 `8888`
* `MYSQL_ROOT_PASSWORD` 默认 `root1234`

启动：

```bash
scripts/docker-u