# 云校园 **Repository Path**: zfb12345/cloud-campus ## Basic Information - **Project Name**: 云校园 - **Description**: 一个云校园系统，集后台和前台于一体，目标打造一个通用的校园娱乐系统，和校园工具，包括校园贴吧，聊天室，跳蚤市场，校园活动等 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 14 - **Forks**: 4 - **Created**: 2024-10-22 - **Last Updated**: 2026-07-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: 后台管理, 校园分享 ## README # 校园云平台 (SchoolCloud)

一个面向高校的综合性服务平台

项目简介 • 功能特性 • 技术架构 • 快速开始 • 文档导航 • 贡献指南

--- ## 项目简介校园云平台是一个为学生、老师和学校管理人员提供服务的综合性平台。基于Spring Cloud Alibaba微服务架构，用户可以在平台上发布和观看教学视频、发帖交友、聊天、创建校内跳蚤市场、发布和参与校内活动，旨在为校园生活提供便利。注：本文档暂时由AI生成，相关内容还未实现。 ### 核心亮点 - 🏗️ **微服务架构**：基于Spring Cloud Alibaba，模块化设计，易于扩展和维护 - 🔐 **安全认证**：采用Sa-Token实现网关鉴权，支持多账户体系 - 📦 **文件存储**：集成MinIO对象存储，支持大文件分片上传 - 🚀 **高性能**：Redis缓存 + MySQL主从，支持高并发访问 - 📱 **响应式设计**：支持PC端和移动端访问 --- ## 功能特性 ### 🌐 社交功能 | 功能 | 描述 | |-----|------| | 校园贴吧 | 创建贴吧、发布帖子、评论互动、点赞收藏 | | 校园活动 | 发布活动、报名参与、活动管理、活动风采 | | 聊天交友 | 实时消息、私信功能、消息通知 | ### 🛠️ 服务功能 | 功能 | 描述 | |-----|------| | 失物招领 | 发布失物/招领信息、认领流程管理 | | 跳蚤市场 | 发布二手物品、分类搜索、在线交易 | ### 📚 分享功能 | 功能 | 描述 | |-----|------| | 教学视频 | 上传、观看、分享教学视频 | | 视频集管理 | 创建和管理视频合集 | ### 👤 用户中心 | 功能 | 描述 | |-----|------| | 个人信息管理 | 修改个人资料、头像设置 | | 发布内容管理 | 管理自己发布的帖子、活动、视频等 | ### ⚙️ 后台管理 | 功能 | 描述 | |-----|------| | 用户管理 | 系统用户管理、权限分配 | | 角色管理 | 创建和管理角色 | | 权限管理 | 分配系统权限 | | 内容管理 | 管理贴吧、帖子、活动、失物信息等 | --- ## 技术架构 ### 技术栈 #### 后端技术 | 技术 | 版本 | 说明 | |-----|------|------| | Java | 17 | JDK版本 | | Spring Boot | 3.2.4 | 基础框架 | | Spring Cloud | 2023.0.3 | 微服务框架 | | Spring Cloud Alibaba | 2023.0.0 | 阿里巴巴微服务套件 | | Nacos | 2.2+ | 注册配置中心 | | Sa-Token | 1.39.0 | 权限认证框架 | | MyBatis Plus | 3.5.10 | ORM框架 | | MySQL | 8.0+ | 关系数据库 | | Redis | 6.0+ | 缓存数据库 | | MinIO | Latest | 对象存储 | | RocketMQ | 5.x | 消息队列 | #### 前端技术 | 技术 | 版本 | 说明 | |-----|------|------| | Vue | 3.x | 渐进式框架 | | Vue Router | 4.x | 路由管理 | | Pinia | 2.x | 状态管理 | | TypeScript | 5.x | 类型支持 | | Element Plus | 2.x | UI组件库 | | Axios | 1.x | HTTP请求 | | Vite | 5.x | 构建工具 | ### 系统架构 ``` ┌─────────────────┐ │ 用户终端 │ └────────┬────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────┐ │ Nginx (负载均衡) │ └────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────┐ │ sc-gateway (网关服务) │ │ 路由转发 │ 权限校验 │ 限流熔断 │ 日志追踪 │ └────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────┐ │ 业务服务层 │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ sc-auth │ │sc-system │ │sc-social │ │ sc-serve │ │ sc-file │ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │sc-share │ │sc-message│ │ sc-front │ │ │ └──────────┘ └──────────┘ └──────────┘ │ └────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌────────────────────────────────────────────────────────────────────────┐ │ 支撑服务层 │ │ Nacos (注册中心) │ Redis (缓存) │ MinIO (存储) │ MySQL (数据库) │ └────────────────────────────────────────────────────────────────────────┘ ``` ### 模块说明 | 模块 | 说明 | |-----|------| | sc-gateway | 网关服务 - 统一入口、路由、鉴权 | | sc-auth | 认证服务 - 用户认证、Token管理 | | sc-system | 系统服务 - 用户、角色、权限管理 | | sc-front | 前台服务 - 前台用户管理 | | sc-forum | 论坛服务 - 贴吧、帖子管理 | | sc-activity | 活动服务 - 校园活动管理 | | sc-lost-found | 失物招领服务 - 失物和招领信息管理 | | sc-market | 跳蚤市场服务 - 二手物品交易管理 | | sc-share | 分享服务 - 视频、视频集管理 | | sc-file | 文件服务 - 文件上传、存储 | | sc-message | 消息服务 - 私信、通知 | | sc-ai | AI服务 - 智能助手功能 | | sc-common | 公共模块 - 通用工具、实体 | | sc-api | API模块 - Feign客户端、DTO | | sc-dao-mybatisplus | DAO模块 - MyBatis Plus配置 | | sc-message-client | 消息客户端模块 - 消息服务客户端 | --- ## 快速开始 ### 环境要求 | 软件 | 版本要求 | |-----|---------| | JDK | 17+ | | Maven | 3.8+ | | Node.js | 18+ | | MySQL | 8.0+ | | Redis | 6.0+ | | Nacos | 2.2+ | | MinIO | Latest | ### 后端启动 ```bash # 1. 克隆项目 git clone https://github.com/your-repo/SchoolCloud.git cd SchoolCloud # 2. 初始化数据库 mysql -u root -p < sc-script/sc-system.sql mysql -u root -p < sc-script/sc-social.sql mysql -u root -p < sc-script/sc-serve.sql mysql -u root -p < sc-script/sc-front.sql # 3. 启动Nacos (或其他方式) # 下载并启动Nacos，访问 http://localhost:8848/nacos # 4. 构建项目 mvn clean package -DskipTests # 5. 启动服务 (按顺序) java -jar sc-gateway/target/sc-gateway.jar java -jar sc-auth/target/sc-auth.jar java -jar sc-system/target/sc-system.jar # ... 启动其他服务 ``` ### 前端启动 ```bash # 进入前端目录 cd sc-ui/sc_web # 安装依赖 npm install # 启动开发服务器 npm run dev # 构建生产版本 npm run build ``` ### Docker快速启动 ```bash # 启动中间件 docker-compose -f docker-compose-dev.yml up -d # 等待服务启动后，启动应用服务 ``` --- ## 文档导航 | 文档 | 说明 | |-----|------| | [架构设计文档](docs/architecture.md) | 系统架构设计、模块设计、技术选型 | | [部署文档](docs/deployment.md) | 单机部署、集群部署、Docker部署 | | [开发指南](docs/development.md) | 开发环境搭建、开发规范、开发流程 | | [数据库设计](docs/database.md) | 数据库架构、表结构设计、索引设计 | | [API接口文档](docs/api.md) | 接口规范、接口列表、错误码说明 | | [安全设计文档](docs/security.md) | 认证授权、数据安全、接口安全 | | [环境配置文档](docs/environment.md) | 环境搭建、配置说明 | | [常见问题](docs/faq.md) | 问题排查、解决方案 | | [更新日志](CHANGELOG.md) | 版本更新记录 | | [贡献指南](CONTRIBUTING.md) | 如何参与项目贡献 | --- ## 项目预览 ### 前台系统 | 主页 | 登录 | |:---:|:---:| | ![主页](sc-doc/img/frontHome.png) | ![登录](sc-doc/img/frontLogin.png) | | 校园贴吧 | 帖子详情 | |:---:|:---:| | ![贴吧](sc-doc/img/forum-index.png) | ![帖子](sc-doc/img/post-detail.png) | | 校园活动 | | 失物招领 | |:---:|:---:| | ![活动](sc-doc/img/event-home.png) | ![失物](sc-doc/img/lost-list.png) | ### 后台系统 | 后台首页 | 用户管理 | |:---:|:---:| | ![后台首页](sc-doc/img/adminHome.png) | ![用户管理](sc-doc/img/adminUserManage.png) | | 角色管理 | 权限管理 | |:---:|:---:| | ![角色管理](sc-doc/img/adminRoleManage.png) | ![权限管理](sc-doc/img/adminPermissionManage.png) | --- ## 贡献指南我们欢迎所有形式的贡献，包括但不限于： - 🐛 提交Bug报告 - 💡 提出新功能建议 - 📝 完善文档 - 🔧 提交代码修复详细贡献指南请查看 [CONTRIBUTING.md](CONTRIBUTING.md)

Made with ❤️ by SchoolCloud Team