Spaces:
Runtime error
Runtime error
| title: CampusLoop Backend | |
| emoji: 🎓 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: docker | |
| pinned: false | |
| license: mit | |
| app_port: 7860 | |
| startup_duration_timeout: 60s | |
| # CampusLoop Backend API | |
| 校园圈社交应用后端服务，提供用户管理、动态发布、论坛讨论、活动管理等功能。 | |
| ## 🚀 功能特性 | |
| - 🔐 **用户认证系统** - 注册、登录、JWT认证 | |
| - 📝 **动态发布** - 文字、图片动态发布与评论 | |
| - 💬 **论坛讨论** - 多话题论坛交流 | |
| - 🎉 **活动管理** - 校园活动发布与参与 | |
| - 📚 **课程表管理** - 个人课程安排 | |
| - 🔍 **失物招领** - 校园失物发布与寻找 | |
| - 📊 **成绩管理** - 学生成绩查询 | |
| - 🔔 **消息通知** - 实时消息推送 | |
| ## 📡 API 接口文档 | |
| ### 认证接口 | |
| - `POST /api/auth/register` - 用户注册 | |
| - `POST /api/auth/login` - 用户登录 | |
| - `GET /api/user/profile` - 获取用户信息 | |
| ### 动态接口 | |
| - `GET /api/posts` - 获取动态列表 | |
| - `POST /api/posts` - 发布动态 | |
| - `GET /api/posts/:id/comments` - 获取动态评论 | |
| - `POST /api/posts/:id/comments` - 添加评论 | |
| - `POST /api/posts/:id/like` - 点赞动态 | |
| ### 论坛接口 | |
| - `GET /api/forum/posts` - 获取论坛帖子 | |
| - `POST /api/forum/posts` - 创建论坛帖子 | |
| - `GET /api/forum/posts/:id` - 获取帖子详情 | |
| ### 活动接口 | |
| - `GET /api/activities` - 获取活动列表 | |
| - `POST /api/activities` - 创建活动 | |
| - `POST /api/activities/:id/join` - 参加活动 | |
| ### 课程表接口 | |
| - `GET /api/schedule` - 获取课程表 | |
| - `POST /api/schedule` - 添加课程 | |
| ### 失物招领接口 | |
| - `GET /api/lostfound` - 获取失物信息 | |
| - `POST /api/lostfound` - 发布失物信息 | |
| ### 成绩接口 | |
| - `GET /api/grades` - 获取成绩 | |
| - `POST /api/grades` - 添加成绩 | |
| ### 通知接口 | |
| - `GET /api/notifications` - 获取通知列表 | |
| - `POST /api/notifications/:id/read` - 标记通知已读 | |
| ## 🏥 健康检查 | |
| 访问 `/api/health` 查看服务状态： | |
| ```json | |
| { | |
| "status": "ok", | |
| "timestamp": "2024-11-14T03:00:00.000Z", | |
| "service": "campusloop-backend" | |
| } | |
| ``` | |
| ## 🛠 技术栈 | |
| - **后端框架**: Node.js + Express.js | |
| - **数据库**: MySQL | |
| - **认证**: JWT (JSON Web Tokens) | |
| - **文件上传**: Multer | |
| - **日志系统**: Winston | |
| - **实时通信**: Socket.io | |
| - **安全**: Helmet + CORS | |
| - **容器化**: Docker | |
| ## 🔧 环境配置 | |
| 应用需要以下环境变量： | |
| ```bash | |
| NODE_ENV=production | |
| PORT=7860 | |
| MYSQL_HOST=your_mysql_host | |
| MYSQL_PORT=your_mysql_port | |
| MYSQL_USER=your_mysql_user | |
| MYSQL_PASSWORD=your_mysql_password | |
| MYSQL_DATABASE=campus_circle | |
| JWT_SECRET=your_jwt_secret | |
| ``` | |
| ## 📝 使用说明 | |
| 1. **健康检查**: `GET /api/health` | |
| 2. **用户注册**: `POST /api/auth/register` | |
| 3. **用户登录**: `POST /api/auth/login` | |
| 4. **获取动态**: `GET /api/posts` | |
| ## 🎯 部署信息 | |
| - **平台**: Hugging Face Spaces | |
| - **端口**: 7860 | |
| - **协议**: HTTPS | |
| - **域名**: 自动分配 `.hf.space` 域名 | |
| ## 📄 许可证 | |
| MIT License - 详见 LICENSE 文件 | |
| --- | |
| 由响指AI开发 🤖 | |