适用读者：在旧站看到"附录A…附录L"却不知道从哪读的人；本系列维护者。
性质：归档说明 + 模块映射表。10 篇附录合计约 185 万字符，为《学成在线》（xuecheng-plus）项目各模块的逐文件源码讲解。
覆盖旧文：4368（附录A 公共基础）、4369（附录B 验证码）、4370（附录C 认证授权中心）、4371（附录D 内容管理）、4372（附录E 媒资）、4373（附录F 学习）、4374（附录G 订单）、4376（附录I 搜索）、4378（附录K 网关）、4379（附录L 代码生成器）→ 10 篇。
1. 先说清这批东西是什么
| 项 | 事实 |
|---|---|
| 体量 | 10 篇 / 1,849,791 字符（≈ 全站正文 1.52 M 的 1.2 倍） |
| 结构 | 每篇 1 个 ## 标题 + 原文正文（4379 有 6 节），正文为"模块概览 → 目录树 → 逐文件代码 + 行内注释" |
| 风格 | 代码块占绝大多数；注释被自动追加为 // 定义方法 ... // 代码块结束 形式 |
| 性质 | 教材附录，不是独立博文：离开教材主线（课程模块的开发过程）后，单看附录价值有限 |
| 技术栈 | Spring Boot + Spring Cloud（Feign/Gateway）+ MyBatis-Plus + Redis + ES + RabbitMQ + FreeMarker + XXL-Job |
判据："逐文件讲解"属于教材载体，不属于博客文章——它没有"问题→判据→反例"的结构，只有"这个文件里写了什么"。
2. 模块映射表（查什么 →
| 附录 | 旧文 | 模块 | 主要内容 | 对应主讲篇 |
|---|---|---|---|---|
| A | 4368 |
xuecheng-plus-base / parent |
统一配置、异常体系、Jackson 序列化、Hibernate Validator 校验、雪花 ID、加解密工具 | S07（Spring 配置与 Bean）、S08-B02（参数与结果映射） |
| B | 4369 |
checkcode |
Kaptcha 图形码、短信码、Redis 存储与校验 | S27-J03（验证码与风控）、S12（Redis 用法） |
| C | 4370 |
auth |
Spring Security OAuth2 统一认证、账号/第三方登录、JWT 与网关 Token 下发 | S07（Security 与鉴权链）、S17（服务间鉴权） |
| D | 4371 |
content-api/-service/-model |
课程/分类/教学计划、发布流程、FreeMarker 静态化、XXL-Job 调度 | S27-J05（架构演进）、S17-J03（异步与任务） |
| E | 4372 |
media |
媒资上传、分片与断点续传、视频转码（FFmpeg）、文件去重 | S27-B03（文件上传与文档处理） |
| F | 4373 |
learning |
选课、学习进度、任务与积分 | S20（业务数据建模思路）、S11（表设计） |
| H | 4375 |
system |
数据字典、通用配置、分页与缓存 | S11（配置与字典表）、S07（通用配置） |
| J | 4377 |
message-sdk |
可靠消息投递与补偿、消息任务表、消费确认 | S27-J01、S17（消息一致性） |
| G | 4374 |
orders + message-sdk |
订单、支付回调、消息 SDK（RabbitMQ 可靠投递） | S27-J01（分布式可靠性四件套）、S17（消息一致性） |
| I | 4376 |
search |
ES 索引设计、课程搜索、关键词与过滤 | S13（搜索与检索） |
| K | 4378 |
gateway |
Spring Cloud Gateway 路由、过滤器、鉴权前置、限流 | S17 / S18-A06（网关与七层负载） |
| L | 4379 |
generator |
代码生成器：模板、元数据、生成流程（6 节，结构最完整） | S06（工程化与代码生成）、S09-A03（规范与自动化） |
路由修正：附录 H（4375，66,365 字符）与 J（4377，63,547 字符）在初次路由中被 cat 默认映射分到了 S15 批次；二次核对标题后归回本表。至此 A–L 十二个附录全部在册。
3. 为什么不做点位级吸收
| 理由 | 说明 |
|---|---|
| 体量不可回收 | 185 万字符逐点位登记会产出约 3 万个"代码行级"点位，其中 90% 是逐行注释（"定义 class""代码块结束"），无独立知识价值 |
| 机制已有主讲篇 | 每个模块的核心机制（Security、MyBatis-Plus、MQ 可靠投递、ES 索引、网关）都已有对应系列的主讲文章，见 §2 右列 |
| 教材主线缺失 | 附录的价值依附于"教材第 N 章为什么要这么写"；主线不在语料里，单读附录等于读代码字典 |
| 重复度高 | 各模块的 pom、日志配置、启动类、application.yml 结构高度相似，逐篇重写会产生 8 份雷同内容 |
处置：全部判 appendix（归档），本表即"从旧文 ID → 新文章"的定位入口；正文不复制代码，只在对应主讲篇以判据形式保留结论。
4. 需要使用这批素材时的三条路径
① 想知道某模块「怎么组织」→ 看 §2 的模块行，再去对应主讲篇看结构判据
② 想找某段具体实现（如分片上传、支付回调）→ 按附录号检索原文，取其"调用链"而非逐行代码
③ 想复现项目 → 按 L（代码生成器）→ A（公共基础）→ K（网关）→ C（认证）→ 业务模块的顺序读
判据：读附录要带问题（"这个模块的边界在哪""这个回调怎么防重复"），否则 49 万字符的附录D 会把人埋掉。
5. 缺口与待核
| 项 | 状态 |
|---|---|
| 附录 H、J 路由 | ✅ 已修正：4375/4377 在后批语料中出现，已并入本表 |
| 附录内代码对应的项目版本 | 待核：pom 中 Spring Boot / Cloud 版本随教程迭代，未逐一核对 |
| 逐行注释是否为自动生成 | 推断为工具生成（形式统一、含"代码块结束"），待核 |
| 各模块是否仍可构建 | 未复现（需完整工程与依赖），标待核 |
6. 下一篇
S27 系列验收（v2） —— 16 篇 / 39,012 点位 / 22 篇尾部旧文 100% 登记 / 下一系列（P15：S06 16 篇）前置依赖。
本篇属于系列《S27 · 杂项归档与工具实测》。旧文来源：A-4368–4379（《学成在线》附录 A–L 源码详解，10 篇 / 约 185 万字符）；扩展点 E-S27-024。附录 H、J 未在恢复语料中，标待核。
上一篇：S27-B05 · 自建站点与私有服务实操：从买机器到自动部署