# vxopen

**Repository Path**: Cauchy_AQ/vxopen

## Basic Information

- **Project Name**: vxopen
- **Description**: 微信扫码登录 demo
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gitee.com/Cauchy_AQ/vxopen
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-09-11
- **Last Updated**: 2024-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 微信扫码登录模板

## vxopen demo

本项目 demo 主要目的用于学习接入微信二维码扫描登录，以及后续扩展了一个聊天（Chat）界面，一个首页（Dashboard）界面。

前端学习了一下 echarts 的使用，后端学习了基于 go-zero 微服务框架去进行开发。

本项目是不完善的，仅提供一个模板作用。可用于后续的其它项目开发，或进行二开完善该项目。

---

## 项目演示

- 首页（Dashboard）

![首页](./frontend/public/Dashboard.png)

- 聊天室（Chat）

![聊天室](./frontend/public/Chat.png)

----

## Docker 部署

- 拉取项目源码

```shell
git clone https://gitee.com/Cauchy_AQ/vxopen.git
```

- 前置工作

1. `vxopen\frontend\src\views\home\widget\Weather.vue` 文件中，修改你的 `api_key`

```ts
const api_key = 'your_api_key' // API: https://www.seniverse.com/products
```

2. `vxopen\frontend\.env.development` 文件中，修改对应的后端地址

```shell
VITE_APP_BASE_URL = 'http://127.0.0.1:8080'
VITE_APP_WS_CHAT = 'ws://127.0.0.1:8080/chat'
VITE_APP_WS_DASHBOARD = 'ws://127.0.0.1:8080/sysinfo'
```

3. `vxopen\backend\api` 和 `vxopen\backend\rpc\transfrom` 和 `vxopen\backend\rpc\wechat` 三个目录下的 `etc/*.yaml` 文件，修改对应的配置信息

另外如需支持微信测试公众号二维码扫码登录，更改如下配置：[获取微信测试公众号](https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index)

```yaml
WeChatConfig:
  AppId: YOUR_APP_ID
  AppSecret: YOUR_APP_SECRET
```


-----

上述前置工作完成后，通过 `docker compose` 工具一键部署本项目：

```shell
docker compose up --build -d
```


> 注意：如果是部署在服务器上，需要放行 8080 端口。