# hope-mp

**Repository Path**: akaedu2012/hope-mp

## Basic Information

- **Project Name**: hope-mp
- **Description**: Uniapp+Vue3+SpringBoot+WebSocket+MySQL实现的社会公益小程序
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-11-11
- **Last Updated**: 2024-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 id="NgSQX">希望之光社会公益小程序</h1>

<h3 id="Kjxus">一、项目概述</h3>

 > 本社会公益小程序旨在为用户提供一个便捷的平台，用于参与各种公益活动、了解公益项目信息、进行捐赠以及志愿者报名等。通过这个小程序，我们希望能够促进公益事业的发展，提高社会公众对公益活动的关注度和参与度，共同为社会做出积极贡献。

<h3 id="gc9Mm">二、技术栈</h3>小程序

* 核心框架: `Uniapp`、`Vue3`
* 构建工具: `Vite`
* 类型支持: `TypeScript`
* CSS预处理器: `Sass`
* 状态管理: `Pinia`
* 日期格式化: `Dayjs`
* 富文本渲染: `mp-html`
* 地图功能: `腾讯地图API`

后端

* 核心框架：`SpringBoot`
* 持久层：`Mybatis`
* 数据库：`MySql`
* 身份校验：`JWT`
* 文件存储：`Aliyun OSS`
* 分页功能：`PageHelper`

<h3 id="Lqwak">三、项目模块</h3>

1. 用户模块
+ 用户微信授权一键登录
+ 修改用户信息
+ 上传修改用户头像
+ 管理员测试账号
+ map地图选点设置地址
+ 创建动态
+ 每日签到 + 积分

2. 公益项目模块
+ 公益项目列表分页展示
+ 公益项目详情
+ 公益项目捐款

3. 志愿者活动模块
+ 志愿者活动列表分页展示
+ 志愿者活动详情
+ 志愿者活动报名/取消报名
+ 活动地址导航
+ 活动地址路线规划
4. 社区动态模块
+ 用户发布动态
+ 动态评论
+ 动态点赞
5. 管理员模块
+ 创建/删除公益项目
+ 创建/删除通知
+ 创建/删除志愿者活动

<h3 id="nKPn8">四、使用说明</h3>

<h4 id="kgiTZ">小程序</h4>

使用命令克隆仓库 `git clone https://gitee.com/lianqingqian/hope-mp.git`

使用`VSCode`打开`hope-mp`，运行`pnpm i`安装依赖

修改`.env.development`

```py
# 这里修改为你的后端服务基础路径
HOPE_API_BASE_URL = "http://localhost:8080"
# 这里修改为你的腾讯地图key
HOPE_TX_MAP_KEY = "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"
# 这里修改为你的腾讯地图APP名称
HOPE_TX_MAP_APP_NAME = "XXXXX"
```

修改`manifest.config.ts`配置文件下的`mp-weixin`的`appid`字段为自己的

接着运行`pnpm dev:mp-weixin`编译为微信小程序

使用`微信开发者工具`打开根目录下的`dist/dev/mp-weixin`运行

<h4 id="oyR2z">后端</h4>

克隆后端仓库`git clone https://gitee.com/lianqingqian/hope_mp_back.git`

使用`idea`打开`hope_mp_back`

修改`application.yml`配置

``` yaml
wechat:
  # 这是你的微信 appid
  app-id: xxxxxxxxxxxxxxx
  # 这是你的微信 secret
  secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

alis:
  oss:
    # 这是你的阿里云OSS endpoint
    endpoint: endpoint
    # 这是你的阿里云OSS accessKeyId
    access-key-id: acessKeyId
    # 这是你的阿里云OSS accessKeySecret
    access-key-secret: accessKeySecret
    # 这是你的阿里云OSS bucketName
    bucket-name: bucketName
```

之后安装依赖`maven`依赖即可运行

<h3 id="QDwiQ">项目贡献者</h3>

[lian-qing-qian](https://gitee.com/lian-qing-qian)  [linxianzhen](https://gitee.com/lin-lin-is-the-most-handsome)   [lijie](https://gitee.com/lijiezuishua)