# CC校友会小程序

**Repository Path**: dongeast/CCSmartTXL

## Basic Information

- **Project Name**: CC校友会小程序
- **Description**: 本项目采用云开发技术（无须部署服务端），希望通过微信小程序，构建一款无广告，真实可靠的毕业校友通讯录。 简约：只做最基础功能，不臃肿，主打内容极简，功能简洁直击痛点 安全：保护校友的信息安全，隐私内容需要申请后可见。 方便：上传自己的个人信息，方便在需要时取得联系。小程序无需下载APP随用随走。
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master1
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 65
- **Created**: 2025-09-10
- **Last Updated**: 2025-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CC校友录小程序

## 项目介绍

CC校友录是一款基于微信小程序的校友社交平台，支持互助信息发布、相册分享、校友交流等功能。

## 项目特点

1. **模块化设计**：采用模块化架构，便于功能扩展和维护
2. **前后端分离**：支持云开发和HTTP API两种模式
3. **丰富的功能**：包含互助、相册、用户、个人中心等多个功能模块
4. **易于迁移**：提供完整的迁移指南，可轻松迁移到Spring Boot后端

## 项目结构

```
CCSmartTXL/
├── cloudfunctions/     # 云函数
├── miniprogram/        # 小程序前端代码
│   ├── biz/           # 业务逻辑层
│   ├── cmpts/         # 组件
│   ├── helper/        # 工具类
│   ├── pages/         # 页面
│   └── app.js         # 小程序入口文件
├── PROJECT_FUNCTION.md # 项目功能说明
├── SPRING_BOOT_BACKEND_GUIDE.md # Spring Boot后端开发指南
└── README.md          # 项目说明文档
```

## 运行方式

### 1. 云开发模式（默认）

1. 使用微信开发者工具导入项目
2. 在`project.config.json`中配置云环境ID
3. 部署云函数到微信云开发环境
4. 运行小程序

### 2. HTTP API模式

1. 修改`miniprogram/helper/setting.js`中的`API_MODE`为`true`
2. 根据`SPRING_BOOT_BACKEND_GUIDE.md`搭建后端服务
3. 在`miniprogram/helper/api_helper.js`中配置后端服务地址
4. 运行小程序

## 功能模块

### 互助模块
- 发布互助信息
- 浏览互助列表
- 查看互助详情
- 编辑/删除自己的互助信息
- 点赞互助信息

### 相册模块
- 创建相册
- 浏览相册列表
- 查看相册详情
- 编辑/删除自己的相册
- 点赞相册

### 用户模块
- 用户注册/登录
- 个人信息管理
- 浏览校友列表
- 查看校友详情

### 个人中心
- 我发布的互助信息
- 我发布的相册
- 我邀请的人
- 个人资料修改

## 技术栈

### 前端
- 微信小程序原生开发
- JavaScript
- WXML/WXSS

### 后端（可选）
- 微信云开发（云函数）
- Spring Boot（HTTP API模式）

### 数据库（可选）
- 微信云数据库
- MySQL（Spring Boot模式）

## 迁移指南

项目提供了完整的前后端分离迁移方案：

1. 查看`PROJECT_FUNCTION.md`了解项目功能结构
2. 参考`SPRING_BOOT_BACKEND_GUIDE.md`搭建Spring Boot后端
3. 根据需要修改`API_MODE`配置切换运行模式

## 配置说明

### 云开发模式配置
在`miniprogram/helper/setting.js`中：
```javascript
API_MODE: false,  // 关闭API模式，使用云函数
CLOUD_ID: 'your-cloud-env-id'  // 你的云环境ID
```

### HTTP API模式配置
在`miniprogram/helper/setting.js`中：
```javascript
API_MODE: true,   // 启用API模式，使用HTTP请求
```

在`miniprogram/helper/api_helper.js`中修改请求地址：
```javascript
// 修改request方法中的请求地址
const baseUrl = 'http://localhost:8080';  // 后端服务地址
```

## 开发建议

1. **保持接口一致性**：在迁移到HTTP API模式时，尽量保持接口路由与云函数一致
2. **数据结构兼容**：确保前后端数据结构一致，减少前端修改
3. **错误处理**：统一错误处理机制，提供友好的用户提示
4. **性能优化**：合理使用缓存，优化图片加载等

## 文件说明

- `PROJECT_FUNCTION.md`：详细的功能模块和接口说明
- `SPRING_BOOT_BACKEND_GUIDE.md`：Spring Boot后端开发完整指南
- `miniprogram/helper/cloud_helper.js`：云函数调用封装，支持双模式切换
- `miniprogram/helper/api_helper.js`：HTTP API调用封装，提供模拟数据

## 注意事项

1. 在使用云开发模式时，需要配置正确的云环境ID
2. 在使用HTTP API模式时，需要先启动后端服务
3. 图片上传功能在API模式下为模拟实现，实际使用时需要实现真实的文件上传接口
4. 项目中的模拟数据仅用于演示，实际使用时需要连接真实的数据源

## 联系方式

如有问题，请提交Issue或联系项目维护者。