【免费下载链接】learn-to-cloud-appThe best open source courseware to learn cloud engineering项目地址https://gitcode.com/gh_mirrors/le/learn-to-cloud-app点击查看免费下载Learn to Cloud App 是一款学习云工程cloud engineering的开源课程应用负责跟踪学习者在 8 个阶段课程中的进度。它的课程目录curriculum没有塞进数据库而是走了一条干净利落的路线YAML 写作 → 编译为确定性 JSON → 加载进内存目录。本文将带你完整走一遍这段设计之旅。内容流转全景一条单向流水线整个课程内容的流动可以用一行概括见 docs/curriculum.mdYAML files - strict validation - curriculum.json - in-memory catalog这条流水线有三个关键角色角色文件职责作者源content/phases/人写的 YAML 课程文件编译产物curriculum.json提交进仓库的标准化 JSON运行时目录curriculum/catalog.py每个进程加载一次的内存索引 一个重要的边界PostgreSQL 只存学习者的状态账号、进度、验证记录不存课程内容。这层分离是后面所有设计的基石。第一步用 YAML 写作课程课程作者只需要写纯文本 YAML。以 Phase 0 为例phase0/_phase.yaml 声明了阶段名称、时长估算、前置条件以及topics:列表——主题和要求的顺序完全由这个列表的书写位置决定这是唯一的顺序事实来源。每个主题再对应一个独立文件例如 phase0/linux.yaml其中包含学习目标learning_objectives和学习步骤learning_steps每个条目都带有稳定的 UUIDuuid: 9974bac3-6879-4373-80bc-044693360a06 slug: linux name: What is Linux learning_steps: - uuid: 90cba226-9b47-483e-abe9-06265b378f45 action: Watch: title: Linux Documentary (The Story of Linux) slug: phase0-topic1-watch-linux-documentary-the-story 写作时有两个贴心设计Schema 提示文件头通过$schema注释引用 schemas/ 下的 JSON Schema如 phase.schema.json编辑器可实时校验单一顺序来源主题文件里不允许再写order字段加载器会直接拒绝避免两处定义顺序打架见 yaml_loader.py。第二步编译成确定性的 curriculum.json运行编译脚本入口在 scripts/compile_curriculum.pyuv run python scripts/compile_curriculum.py核心实现在 curriculum/compiler.py它有三个硬核保证1. 严格Strict任何文件缺失、YAML 语法错误、Schema 校验失败、跨文件不一致重复 UUID、未解析的 slug、阶段顺序不连续都会直接报错绝不容错放行。2. 确定性Deterministic对象的键按字母排序canonical_json但数组顺序原样保留——因为数组顺序承载课程含义按字母排会毁掉教学顺序同一份 YAML 编译两次产出逐字节一致的 JSON。CI 会重新编译并与提交版本做 diff防止漂移。3. 版本化Versioned产物里带三件套字段作用artifact_schema_versionJSON 结构本身的版本号读取端据此判断兼容性curriculum_version作者维护的课程内容版本定义在 curriculum.meta.yamlcontent_hash对规范化内容的 SHA-256用于发现文件被篡改或损坏版本策略由 _check_version_policy 强制执行版本只能升不能降内容变了就必须升版本否则编译直接失败。第三步加载为带索引的内存目录应用启动时catalog.py 加载打包好的curriculum.json并一次性构建全套索引from_phasesphases_by_slug按 slug 查阶段steps_by_uuid/requirements_by_uuid按 UUID 直查步骤与实操要求topic_by_step_uuid从步骤直接反查所属主题phase_order_by_step_uuid聚合学习者进度时无需再查表 加载时还有两道快速失败关卡_validate_artifact_payloadSchema 版本不匹配、content_hash对不上进程在启动时就拒绝工作而不是等到第一个用户请求才暴露问题。目录通过lru_cache成为进程级单例get_curriculum_catalog一个进程只加载、校验一次之后所有查询都是纯内存操作。第四步对外的只读 API业务代码永远不直接碰目录而是走 curriculum/reads.py 这个公开读接口def get_phase_by_slug(slug: str) - Phase | None: return get_curriculum_catalog().phases_by_slug.get(slug)注意这些函数全部是同步、无 I/O的——没有 AsyncSession、不碰数据库、不发网络请求。比如 get_required_step_counts_by_phase 只是数一下内存索引里的条目毫秒级完成。为什么这样设计内容更新不再需要数据库迁移这套架构最妙的好处藏在这里增删课程内容完全不需要数据库迁移。数据库里学习者的进度只记录我完成了哪些 UUID见 docs/curriculum.md这些 UUID 故意不与课程表建外键。于是下线一个旧主题 → 它不在新目录里 → 进度自动不再计入历史数据原样保留新增一个阶段 → 重新编译 JSON、升级版本号完事想参与课程编写的话完整流程见 docs/curriculum.md改 YAML → 提升curriculum_version→ 运行uv run poe static重新生成curriculum.json→ 提交。小结一张图记住整个设计作者写 YAMLphases/ 目录 │ 严格校验 版本号策略 ▼ curriculum.json确定性、带哈希、入库提交 │ 启动时加载一次 哈希校验 ▼ CurriculumCatalog进程内单例UUID/slug 全索引 │ reads.py 同步只读 API ▼ 页面与进度服务数据库只存学习者状态内容像代码一样编译读取像查表一样快变更像发版一样可追溯——这就是 Learn to Cloud App 课程架构给开源学习平台的一个教科书级示范。赞分享【免费下载链接】learn-to-cloud-appThe best open source courseware to learn cloud engineering项目地址https://gitcode.com/gh_mirrors/le/learn-to-cloud-app点击查看免费下载相关推荐DOUBLEPULSAR检测脚本完全指南从安装到实战网络扫描DOUBLEPULSAR检测脚本完全指南从安装到实战网络扫描 想要快速检测Windows系统中的DOUBLEPULSAR后门植入吗这份完整指南将带您深入了解Learn to Cloudlearn-to-cloud开源课程路线图从零到云工程师的 6 个月学习路径Learn to Cloudlearn to cloud开源课程路线图从零到云工程师的 6 个月学习路径 Learn to CloudL2C是一套面向教程云原生learn-to-cloud 课程文档调研learn to cloud 课程文档调研 我已经完成了对关联文档 docs/phase2/2 api.md 的完整阅读并并行调研了同阶段的 1 python教程云原生上一篇解锁掌机潜能Steam Deck玩家的插件扩展完全指南下一篇在 Convex 中编写后端函数query、mutation 与 React 接入实战附 Clerk 认证示例创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考