文档说明

本书定位

《ECShopX Java 技术说明文档》描述商派对 Spring Boot 多模块工程的约定：Bundle 分层、HTTP 路由分组、跨模块协作、数据库访问与定时任务等。读者对象为在 ECShopX Java 上进行二次开发的工程师。

本书不替代通用框架官方文档。涉及 Spring Boot、MyBatis-Plus、XXL-JOB、Flyway、Redis 等基础能力时，以官方说明为准，本书只补充本仓库内的落位与约定。

与官方文档的关系

能力	本书章节	官方文档
模块化与分层	Bundle、Controller 等	—
Web / DI / 配置	路由与 API 分组	Spring Boot Reference
数据访问	Mapper / Domain	MyBatis-Plus 文档
数据库迁移	技术说明	Flyway Documentation
定时任务	Bundle cron 节	XXL-JOB 官方文档
缓存 / 队列	技术说明	Spring Data Redis

推荐阅读顺序

1. 架构说明 / 技术说明 — 事实锚点
2. 本书「框架」篇 — Bundle 词汇表与请求分层（本篇起）
3. 规范说明 及子章节 — 命名、代码、数据库等团队约定
4. 快速入门 — 典型开发流程

官方文档链接

• Java：https://docs.oracle.com/en/java/javase/17/
• Spring Boot 3：https://docs.spring.io/spring-boot/reference/
• Spring Framework：https://docs.spring.io/spring-framework/reference/
• MyBatis-Plus：https://baomidou.com/
• Flyway：https://documentation.red-gate.com/flyway
• XXL-JOB：https://www.xuxueli.com/xxl-job/
• Redis：https://redis.io/docs/
• MySQL 8.0：https://dev.mysql.com/doc/refman/8.0/en/
• Maven：https://maven.apache.org/guides/