大学本科软件工程专业三年级：《基于微服务的校园竞赛平台全栈开发与教学资源设计》教学设计

大学本科软件工程专业三年级：《基于微服务的校园竞赛平台全栈开发与教学资源设计》教学设计

  一、教学理念与课程定位

  本教学设计立足于新工科建设与工程教育专业认证（OBE）的核心要求，深度融合项目式学习（PBL）、建构主义学习理论与产教协同育人模式。课程以“校园竞赛平台”这一真实、复杂且具有社会服务属性的项目为驱动，旨在打破传统软件工程课程中理论与实践、单一技术点与系统架构、编码能力与职业素养之间的壁垒。课程定位并非单纯的技能训练课，而是一门旨在培养学生“系统性思维、工程化能力、创新性设计与协同化素养”的顶峰课程。它要求学生在已修毕《Java程序设计》、《数据库原理》、《软件工程》、《Web前端开发》及《操作系统》等先导课程的基础上，综合运用全栈技术，并引入微服务架构、容器化、持续集成等现代软件工程实践，完成一个具备高可用、可扩展性且贴合校园实际需求的竞赛平台从0到1的构建。同时，课程创新性地将“教学资源（课件）设计”作为核心产出之一，要求学生以开发者兼教育者的双重视角，为平台所承载的各类竞赛制作标准化的技术支撑文档、交互式学习模块与项目复盘案例，从而将技术实践升华为可传播、可复用的教学资产，实现“做中学、学中教、教中研”的闭环。

  二、学情分析

  本课程面向大学本科软件工程专业三年级第二学期的学生。经过前五个学期的学习，学生已具备以下基础与特征：其一，技术基础层面，学生掌握了面向对象编程、基础数据结构和算法、关系型数据库设计与SQL操作、基本的Web开发（如SpringBoot,Vue.js等框架初步使用）及网络通信原理。其二，认知能力层面，学生抽象逻辑思维趋于成熟，具备分析中等复杂度问题的能力，但对大型软件系统的架构设计、模块分解与协同开发缺乏实战经验，对非功能性需求（如性能、安全、可维护性）考虑不足。其三，学习心理层面，学生对动手实践项目抱有极高热情，渴望接触企业级开发流程与技术栈，但对长期、高强度、团队协作的项目存在畏难情绪，需求分析与项目管理能力普遍薄弱。其四，职业发展层面，学生面临实习与就业压力，亟需能够浓缩展示其综合技术能力与工程素养的“硬核”项目经历，并对团队协作、沟通表达等软技能有提升诉求。基于此，本课程设计的挑战度设定在“跳一跳能够得着”的区间，既需要学生整合既有知识，又必须主动学习若干新技术，并通过严密的项目规划与团队协作来保障最终产出。

  三、教学目标

  （一）知识与技能目标

  1.系统阐述微服务架构的核心概念、优势、挑战及与单体架构的对比，并能针对“校园竞赛平台”的业务场景，合理完成服务拆分（如用户服务、竞赛服务、评审服务、公告服务、文件服务等），绘制系统架构图。

  2.熟练运用SpringCloudAlibaba生态（Nacos服务注册与发现、Sentinel流量控制、Gateway网关等）或等价技术栈，搭建微服务基础框架，实现服务间的通信（Feign/RestTemplate）、配置统一管理与负载均衡。

  3.掌握全栈开发关键技术：后端能使用SpringBoot+MyBatis-Plus高效开发RESTfulAPI，集成JWT实现分布式身份认证与授权（RBAC模型）；前端能使用Vue3（CompositionAPI）+ElementPlus+TypeScript构建模块化、响应式管理后台与用户门户；使用Docker进行容器化封装。

  4.实践现代化软件工程流程：运用Git进行团队协作与版本控制，基于GitLabCI/CD或Jenkins设计并实现自动化构建、测试与部署流水线；编写规范的API文档（如Swagger/OpenAPI）。

  5.独立设计并制作一套与“校园竞赛平台”某一核心模块（如“在线编程评测”、“团队项目管理与提交”或“多维度评分系统”）相匹配的交互式教学课件。课件需包含清晰的学习目标、原理讲解、平台操作指南、典型问题案例及拓展练习，形式可以是Markdown文档、静态网页或集成于平台内部的引导模块。

  （二）过程与方法目标

  1.完整经历从需求分析、架构设计、敏捷开发、测试部署到运维监控的软件全生命周期，形成工程化的问题解决思维。

  2.通过角色扮演（产品经理、开发工程师、测试工程师、运维工程师等）与Scrum等敏捷开发方法，提升在跨职能团队中的协作、沟通与冲突解决能力。

  3.学会利用多种渠道（技术文档、开源社区、学术论文、行业报告）自主学习新技术、新工具，并能进行技术选型的可行性分析与评估。

  4.掌握教学设计与资源开发的基本方法，能够将复杂的技术实现转化为逻辑清晰、循序渐进、利于学习者理解与掌握的教育资源。

  （三）情感、态度与价值观目标

  1.培养严谨求实、精益求精的工程伦理与工匠精神，树立代码质量、系统安全与数据隐私保护意识。

  2.增强团队责任感与集体荣誉感，体验在协作中创造价值的成就感。

  3.激发利用信息技术服务校园、赋能教育创新的社会责任感与主人翁意识。

  4.树立终身学习与技术传播的理念，认识到优秀开发者亦应是知识的有效组织者与传播者。

  四、教学重点与难点

  教学重点：

  1.微服务架构在具体项目中的落地实践，包括合理的服务边界划分、服务间API设计、分布式事务的应对策略（最终一致性）以及跨服务数据查询优化。

  2.全栈技术栈的深度融合与工程化整合，确保前后端分离架构下的高效协同开发、数据流清晰与部署一致性。

  3.基于真实需求的“教学课件”设计方法论，即如何从教育目标出发，反推技术实现要点，并组织成有效的学习材料。

  教学难点：

  1.分布式系统复杂性带来的挑战：如服务雪崩、链路追踪、分布式锁、配置动态更新等问题的识别与解决方案选择。

  2.在有限的课时与项目周期内，平衡功能开发的广度、深度与系统稳定性、代码质量之间的关系，有效进行项目风险管理。

  3.引导学生实现从“技术实现者”到“教育设计者”的角色转换，使其制作的课件不仅描述“是什么”和“怎么做”，更能阐释“为什么”，具备启发性和迁移价值。

  五、教学资源与工具

  1.开发环境与工具链：IntelliJIDEA/VSCode、JDK17+、Node.js18+、Maven/Gradle、Git、DockerDesktop、Postman/Apifox。

  2.主要技术栈：后端（SpringBoot3.x,SpringCloudAlibaba2022.x,MyBatis-Plus,Redis,MySQL8.0,RabbitMQ/RocketMQ）；前端（Vue3,TypeScript,Vite,Pinia,ElementPlus,Axios）；运维（Docker,DockerCompose,Nginx,Jenkins/GitLabRunner）。

  3.协作与管理平台：GitLab（代码仓库、CI/CD、Issue跟踪）、Notion/飞书文档（项目Wiki、需求文档、设计文档、会议记录）、墨刀/Figma（原型设计）。

  4.教学资源库：提供经典微服务案例源码、架构设计模式图谱、前后端开发规范手册、教学课件设计模板、历届优秀项目作品集。

  5.实验环境：基于云服务器或校内私有云提供的Kubernetes迷你集群，用于部署和体验微服务；统一的开发测试数据库与环境。

  六、教学实施过程（总学时：96学时，其中理论导引24学时，项目实践72学时）

  第一阶段：项目启航与需求洞察（12学时）

  本阶段目标是将学生从被动接收者转变为主动的“产品规划师”与“需求分析师”，深刻理解项目的社会与技术语境。

  1.情境植入与问题定义（4学时）：

    教师活动：展示国内外知名在线竞赛平台（如Kaggle,TopCoder，国内OJ）及高校自建平台的案例，剖析其核心功能、技术特点与用户体验。引入“校园竞赛数字化转型”的真实命题，组织讨论现有校园竞赛组织（如“挑战杯”、编程赛、创业计划赛、学术海报赛）在报名、组队、提交、评审、公示等环节的痛点。

    学生活动：分组进行“用户访谈”模拟，分别扮演竞赛组织者（教务处/团委/院系）、指导教师、参赛学生、评审专家等角色，挖掘多维度需求。使用“用户故事地图”方法，梳理从赛事发布到结果归档的端到端业务流程，并识别关键用户故事。

    设计意图：建立真实项目背景，激发内在动机，培养同理心和系统思考能力，明确项目价值。

  2.需求规格化与原型设计（8学时）：

    教师活动：讲解如何将模糊的用户需求转化为清晰的“功能需求”与“非功能需求”（性能、安全、可用性）。介绍用例图、活动图等UML工具，以及墨刀/Figma等原型设计工具的基本使用。

    学生活动：各项目小组（4-5人）在充分讨论后，产出本组的《校园竞赛平台需求规格说明书》（含业务背景、用户角色、功能列表、非功能性需求）和可交互的高保真原型。举行“需求评审会”，每组展示并接受其他小组及教师（模拟利益相关方）的质询，进行迭代修改。

    设计意图：训练需求分析与文档化能力，可视化设计思维，并通过peer-review初步体验软件工程中的评审文化。

  第二阶段：架构设计、技术选型与团队组建（12学时）

  本阶段目标是奠定坚实的技术基座与协作框架，实现“谋定而后动”。

  1.微服务架构深度研讨与设计（6学时）：

    教师活动：系统讲解微服务架构演进历程、核心模式（服务注册发现、配置中心、网关、熔断降级、链路追踪）、数据一致性解决方案（Saga、事件驱动）及面临的挑战。引导学生针对本平台业务，讨论服务拆分的粒度（按业务能力？按数据边界？）。

    学生活动：小组基于审定的需求文档，进行服务拆分设计。绘制详细的系统架构图（包括服务组件图、数据流图、部署草图），撰写《系统架构设计说明书》，重点论证拆分的合理性、服务间接口定义（初步）及关键技术选型理由（如为何选用Nacos而非Eureka）。

    设计意图：将抽象的架构理念与具体项目强关联，培养宏观设计能力与技术决策能力。

  2.技术栈统一与团队角色分工（6学时）：

    教师活动：宣布课程采用的主流技术栈（基于行业流行度与学习曲线平衡），提供基础项目脚手架。讲解敏捷开发Scrum框架中的角色（ProductOwner,ScrumMaster,DevelopmentTeam）与仪式（SprintPlanning,DailyStand-up,SprintReview,Retrospective）。

    学生活动：小组内部分工，确定每位成员在项目中的主要角色（可兼任）及技术侧重（前端、后端、DevOps等）。制定第一个Sprint（为期两周）的详细开发计划，将用户故事拆解为具体的开发任务，录入GitLabIssueBoard。共同设置团队协作规范（Git分支策略、代码提交规范、代码审查流程）。

    设计意图：建立高效的团队协作机制，明确个人责任，为后续高强度开发做好准备。

  第三阶段：迭代开发与核心功能实现（48学时）

  本阶段是课程的核心实践环节，采用“做中学、学中做”的模式，教师角色从讲授者转变为教练、顾问和障碍清除者。

  1.Sprint1：基础框架搭建与用户服务（16学时）：

    教师活动：深入讲解SpringCloudAlibaba基础组件的集成与配置，演示如何搭建第一个微服务“用户服务”。讲解JWT原理、SpringSecurity在微服务下的集成方案。指导编写单元测试与集成测试。

    学生活动：各小组搭建微服务父工程与通用依赖管理。独立完成“用户服务”的开发，实现用户注册、登录、JWT签发与验证、基础个人信息管理。实现网关的统一鉴权过滤。完成服务的容器化（Dockerfile编写）。部署至开发环境并通过Postman测试。

    设计意图：跑通微服务开发、测试、部署的完整闭环，攻克分布式认证授权这一早期关键难点。

  2.Sprint2：竞赛核心业务模块开发（16学时）：

    教师活动：聚焦复杂业务逻辑的实现，如竞赛的发布、报名（个人/团队）、多级审核流程的状态机设计。引入消息队列（如RabbitMQ）解耦异步任务（如报名成功通知）。讲解MyBatis-Plus高级特性与复杂查询优化。

    学生活动：开发“竞赛服务”与“报名服务”。实现竞赛的CRUD、多条件分页查询。实现灵活的报名表单配置（动态字段）。处理团队报名时的成员邀请与确认逻辑。集成消息队列发送系统通知。

    设计意图：深化对业务建模的理解，实践领域驱动设计（DDD）的初步思想，掌握应用中间件解决异步问题。

  3.Sprint3：作品提交、评审与文件服务（16学时）：

    教师活动：讲解分布式文件存储方案（如MinIO/FastDFS），以及大文件分片上传、断点续传的前端实现。设计多角色、多指标的评审模型（如专家评审、大众投票、AI初筛）。讲解WebSocket在实时通知（如评审进度、新消息）中的应用。

    学生活动：开发“文件服务”，提供统一上传接口。在“作品服务”中实现文件关联与版本管理。开发“评审服务”，设计灵活的评分项配置与权重设置，实现评审任务分配、打分、统计排名。开发管理后台的仪表盘，可视化竞赛数据。

    设计意图：应对高并发文件处理与复杂业务规则挑战，提升系统设计的灵活性与扩展性，强化前端交互复杂度。

  第四阶段：教学课件设计与开发（12学时）

  本阶段旨在培养学生的知识萃取与教学转化能力，是课程创新点所在。

  1.课件设计方法论（4学时）：

    教师活动：讲授ADDIE（分析、设计、开发、实施、评估）教学系统设计模型。展示优秀技术教学资源的特征（目标明确、结构清晰、案例驱动、交互性强）。引导学生思考：如何让未参与开发的同学/低年级学生通过你的课件，快速理解并使用（或二次开发）你负责的平台模块？

    学生活动：小组选定一个平台核心功能模块（如“基于JWT的微服务统一认证”或“使用RabbitMQ实现异步通知”），作为课件主题。进行学习者分析，确定课件的知识、技能与情感目标。绘制课件的详细内容大纲与脚本。

    设计意图：引入教育设计科学方法，为课件制作提供理论指导。

  2.课件资源开发与集成（8学时）：

    教师活动：提供多种课件形式的技术支持，如使用VuePress/Docusaurus制作静态技术文档网站，使用Storybook制作UI组件库文档，或在平台内开发“新手引导”交互式模块。

    学生活动：根据设计脚本，分工制作课件内容。内容需包含：原理图解、关键代码片段解析（附注释）、平台操作步骤截图/录屏、常见问题排查（QA）、进阶思考题。将最终课件以约定的形式（如独立网站、平台内嵌帮助中心）呈现，并确保其可访问性和美观性。

    设计意图：将技术实践成果显性化、结构化、可传播化，完成从“开发者”到“开发者兼教育者”的身份拓展。

  第五阶段：系统集成、测试、部署与项目复盘（12学时）

  本阶段关注工程质量的最后保障与项目的升华总结。

  1.集成测试、CI/CD与部署上线（6学时）：

    教师活动：讲解端到端集成测试策略，使用TestContainers进行依赖服务隔离测试。深入指导GitLabCI/CDPipeline的编写，实现代码提交后自动进行代码质量扫描（SonarQube）、构建、单元测试、打包Docker镜像并推送到镜像仓库。

    学生活动：各组编写关键业务流程的集成测试用例。完善CI/CD配置文件，实现自动化流水线。使用DockerCompose或Kubernetes编排文件，将所有微服务部署到测试/生产环境（云服务器或K8s集群），进行最终的系统联调与压力测试（初步）。

    设计意图：实践DevOps理念，建立质量内建与自动化意识，体验现代化软件部署运维流程。

  2.项目终期评审与教学反思（6学时）：

    学生活动：举办课程“项目成果发布会”。每组进行20分钟演示，内容需包括：产品亮点展示（现场操作）、核心架构与技术难点讲解、项目历程回顾（展示燃尽图、代码贡献图）、教学课件展示，以及团队协作心得分享。接受由教师、行业工程师（可线上）、其他小组代表组成的评审团提问。

    教师活动：组织评审，并从技术、工程、协作、创新等多维度给予综合评价。引导学生进行个人与团队的《项目复盘报告》撰写，使用“保持-停止-开始”反思模型，总结收获、遗憾与未来学习方向。

    设计意图：搭建高规格的成果展示与交流平台，锻炼综合表达能力；通过结构化反思，促进元认知发展，实现经验到能力的固化与迁移。

  七、教学评价与反馈

  本课程采用“过程性评价为主、终结性评价为辅，多元主体参与”的综合性评价体系，全面考核学生的知识、能力与素养。

  1.评价构成：

    (1)过程性评价（60%）：

      •个人与小组贡献（20%）：依据Git提交记录、代码审查参与度、任务完成情况