# bs-activity

**Repository Path**: David_zlx/bs-activity

## Basic Information

- **Project Name**: bs-activity
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-07
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mental

高校学术活动协作平台（MVP）。

- 后端：`Express.js + Sequelize + MySQL`
- 前端：`uni-app + Vue 3 + uview-plus`

## 目录

- `backend/`：API 服务、数据库脚本
- `my-vue3-project/`：uni-app 客户端

## 功能范围

- 登录注册：微信小程序手机号授权登录
- 活动管理：活动发布、审核、查询、详情
- 报名签到：报名审核、扫码签到、手动签到
- 学术检索：活动与资料统一检索
- 学术交流：讨论发帖、回复、状态管理
- 个人中心：资料维护、我的报名、消息通知
- 管理后台：用户、活动、报名、资料、消息、统计

## 环境要求

- Node.js 18+
- MySQL 8+
- 微信开发者工具

## 快速启动

1. 初始化数据库

```sql
source backend/sql/init.sql;
```

2. 启动后端

```bash
cd backend
cp .env.example .env
npm install
npm run dev
```

默认服务地址：`http://127.0.0.1:3000`

3. 配置后端环境变量（`backend/.env`）

```env
PORT=3000
JWT_SECRET=replace_with_a_secure_secret
JWT_EXPIRES_IN=7d

DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=mental
DB_USER=root
DB_PASSWORD=123456

WECHAT_MOCK=false
WECHAT_APPID=your_wechat_miniprogram_appid
WECHAT_SECRET=your_wechat_miniprogram_secret
```

4. 启动 uni-app 小程序前端

```bash
cd my-vue3-project
npm install
npm run dev:mp-weixin
```

5. 打开微信开发者工具并导入 `my-vue3-project/dist/dev/mp-weixin/`

## 常用命令

```bash
# 后端开发
cd backend
npm run dev

# 后端语法检查
npm run check

# uni-app 微信小程序开发
cd ../my-vue3-project
npm run dev:mp-weixin
```

## 演示账号

后端首次启动会自动写入示例账号，便于本地联调和角色初始化验证：

- 管理员：`13800000000`
- 主办方：`13900000000`
- 普通用户：`13700000000`

## 核心接口前缀

`/api/v1`

常用接口包含：`/auth`、`/users`、`/events`、`/registrations`、`/checkins`、`/resources`、`/discussions`、`/messages`、`/stats`。