roncoo-education v26.0.0：用 Spring Cloud 微服务搭一套在线教育系统，从架构到落地

// 视频云统一适配接口
public interface VideoCloudAdapter {

    /** 上传视频文件，返回云端视频ID */
    String upload(String localFilePath, String title);

    /** 获取播放地址（带防盗链签名） */
    String getPlayUrl(String videoId, long expireSeconds);

    /** 删除云端视频 */
    boolean delete(String videoId);
}

// 腾讯云实现示例
@Component
@ConditionalOnProperty(name = "video.cloud.provider", havingValue = "tencent")
public class TencentVideoAdapter implements VideoCloudAdapter {

    @Override
    public String upload(String localFilePath, String title) {
        // 调用腾讯云点播 SDK 上传
        VodUploadRequest request = new VodUploadRequest();
        request.setMediaFilePath(localFilePath);
        request.setMediaName(title);
        VodUploadResponse response = vodClient.uploadMedia(request);
        return response.getFileId();
    }

    @Override
    public String getPlayUrl(String videoId, long expireSeconds) {
        // 签名播放地址
        SignResult sign = signUtil.generatePlaySign(videoId, expireSeconds);
        return String.format("https://vod.tencentcloudapi.com/play/%s?sign=%s", videoId, sign.getSign());
    }

    @Override
    public boolean delete(String videoId) {
        vodClient.deleteMedia(videoId);
        return true;
    }
}

# application-video.yml
video:
  cloud:
    provider: tencent   # 改为 aliyun / qiniu 即切换

# 1. 克隆项目
git clone https://github.com/roncoo/roncoo-education.git
cd roncoo-education
git checkout v26.0.0

# 2. 确认本地环境（需要 JDK 17+、Maven 3.8+、MySQL 8.0、Redis 6+）
java -version
mvn -version

# 3. 初始化数据库——各服务有独立的 SQL 脚本
# 以课程服务为例
mysql -u root -p < edu-course/sql/edu_course.sql

# 4. 先启动基础设施（Nacos / Sentinel 等）
# 如果本地没有 Nacos，用 Docker 快速拉一个
docker run -d --name nacos \
  -e MODE=standalone \
  -p 8848:8848 \
  nacos/nacos-server:v2.3.0

# 5. 修改各服务的 bootstrap.yml，指向本地 Nacos
# 默认配置一般已指向 localhost:8848，确认即可

# 6. 按顺序启动服务
# Gateway -> Config -> User -> Course -> Video -> Attachment
# IDEA 中直接跑各服务的 Application 主类，或用 Maven：
mvn spring-boot:run -pl edu-gateway
mvn spring-boot:run -pl edu-course
# ...依次启动

# 7. 前台 Vue 项目
cd roncoo-education-web
npm install
npm run dev
# 默认访问 http://localhost:8080

# application-oss.yml
minio:
  endpoint: http://127.0.0.1:9000
  accessKey: minioadmin
  secretKey: minioadmin
  bucketName: edu-attachments

# 课程附件上传时按课程ID建子目录
# 对象路径格式: {courseId}/{chapterId}/{filename}

# 本地开发用 Docker 起 MinIO
docker run -d --name minio \
  -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=minioadmin \
  -e MINIO_ROOT_PASSWORD=minioadmin \
  minio/minio server /data --console-address ":9001"