Odoo 19 开发技术白皮书 — 全书索引
章表以本文件为准:
00-前言.md至49-Odoo环境部署.md、50-HTTP控制器与路由.md(第九篇补章)及99-附录.md与下表一一对应,便于分章排版、合并 PDF 或交付印刷厂。(若另需对外「纯目录」页,可从本表导出,无需单独维护同名.md文件。)
前言
| 文件 | 说明 |
|---|---|
| 00-前言.md | Odoo 沿革、版本与技术演进概览、应用领域;建议置于全书正文之前印刷 |
| 官方文档对照与延伸阅读.md | 与 Odoo 19.0 Developer 文档 的 Tutorials / How-to / Reference 分层说明,及教材章 ↔ 官方章节映射;可与各章交叉查阅,不编入正文页码亦可 |
教材体例说明
- 每章含 学习目标、分节 讲解、案例、截图占位(路径
./images/…;清单与补图说明 见images/README.md、images/MANIFEST.txt)、本节练习(含参考答案提示或「见某节」)。 - 本章综合练习 参考答案见 answers.md(建议教师版单独装订,勿与学员正文同印)。
- 截图请在排版前补全;占位图可先用 1×1 透明 PNG 或删除
![]()仅保留说明文字。
排版与合并建议
- 章文件命名:
00-前言.md,01-概念总论.md…48-AI集成.md,49-Odoo环境部署.md,50-HTTP控制器与路由.md(HTTP 路由专章),99-附录.md。(第五十一章~第九十八章 本分册未拆独立文件;附录 编为 第九十九章。) - Markdown 层级:每章一个一级标题
#;小节为##(对应目录中的「节」);必要时使用###。 - Pandoc 示例(按需调整模板与字体):
# 按两位数字章号排序合并(bash;`[0-9][0-9]-*.md` 已含 00-前言 与 99-附录,勿重复写)
mapfile -t _ch < <(printf '%s\n' [0-9][0-9]-*.md | LC_ALL=C sort)
# 可选:在队首插入全书索引 —— pandoc 全书索引.md "${_ch[@]}" ...
pandoc "${_ch[@]}" -o odoo19_devbook.pdf --pdf-engine=xelatex -V CJKmainfont="PingFang SC"
(若不需要将索引编入 PDF,可省略 全书索引.md,但建议保留 00-前言.md 作为开篇。)
- 分篇装订:可按「篇」将文件分组为五个 PDF,或使用
parts分隔页在排版阶段处理。
第一篇 基础知识
| 章 | 文件 | 标题 |
|---|---|---|
| 1 | 01-概念总论.md | 概念总论 |
| 2 | 02-模型.md | 模型(Models) |
| 3 | 03-字段类型.md | 字段类型 |
| 4 | 04-ORM核心操作.md | ORM 核心操作 |
| 5 | 05-小部件.md | 小部件(Widgets) |
| 6 | 06-交叉引用.md | 交叉引用 |
| 7 | 07-安全性.md | 安全性 |
| 8 | 08-视图.md | 视图(Views) |
| 9 | 09-动作.md | 动作(Actions) |
| 10 | 10-菜单.md | 菜单(Menus) |
| 11 | 11-数据文件.md | 数据文件 |
| 12 | 12-继承机制.md | 继承机制 |
| 13 | 13-QWeb模板.md | QWeb 模板 |
第二篇 Odoo 19 系统架构
| 章 | 文件 | 标题 |
|---|---|---|
| 14 | 14-系统架构总览.md | 系统架构总览 |
第三篇 数据库与数据管理
| 章 | 文件 | 标题 |
|---|---|---|
| 15 | 15-数据库操作.md | 数据库操作 |
| 16 | 16-Odoo核心数据结构.md | Odoo 核心数据结构 |
| 17 | 17-SmartButton设计.md | SmartButton 设计 |
| 18 | 18-工作流与状态机.md | 工作流与状态机 |
| 19 | 19-报表引擎.md | 报表引擎 |
| 20 | 20-邮件系统.md | 邮件系统 |
| 21 | 21-定时任务.md | 定时任务 |
| 22 | 22-序列号.md | 序列号 |
| 23 | 23-翻译与国际化.md | 翻译与国际化 |
| 24 | 24-向导.md | 向导(Wizard) |
| 25 | 25-看板与高级视图.md | 看板与高级视图 |
| 26 | 26-仪表盘.md | 仪表盘 |
第四篇 开发规范
| 章 | 文件 | 标题 |
|---|---|---|
| 27 | 27-编码规范.md | 编码规范 |
第五篇 调试与测试
| 章 | 文件 | 标题 |
|---|---|---|
| 28 | 28-调试工具.md | 调试工具 |
| 29 | 29-测试体系.md | 测试体系 |
第六篇 数据安全
| 章 | 文件 | 标题 |
|---|---|---|
| 30 | 30-权限与安全.md | 权限与安全 |
第七篇 性能优化
| 章 | 文件 | 标题 |
|---|---|---|
| 31 | 31-性能调优.md | 性能调优 |
第八篇 前端开发
| 章 | 文件 | 标题 |
|---|---|---|
| 32 | 32-OWL框架.md | OWL 框架 |
| 33 | 33-JavaScript开发.md | JavaScript 开发 |
| 34 | 34-CSS与样式.md | CSS/SCSS 与样式 |
| 35 | 35-组件开发.md | 组件开发 |
| 36 | 36-前端路由与控制器.md | 前端路由与控制器 |
第三十二章已整合《Odoo19_OWL框架开发指南》(生命周期、Hooks、Registries、Services、Patching、SCSS/资产、WebClient 速查与参考文献);第三十三、三十四章开头附有交叉引用说明。
第九篇 API 与系统集成
| 章 | 文件 | 标题 |
|---|---|---|
| 37 | 37-外部API.md | 外部 API |
| 38 | 38-REST与Webhook.md | REST API 与 Webhook |
| 39 | 39-ExtractAPI.md | Extract API |
| 50 | 50-HTTP控制器与路由.md | HTTP 控制器与 @http.route |
第十篇 IoT 与 AI 集成
| 章 | 文件 | 标题 |
|---|---|---|
| 40 | 40-IoT硬件集成.md | IoT 硬件集成 |
| 41 | 41-AI智能化集成.md | AI 智能化集成 |
第十一篇 部署与运维
| 章 | 文件 | 标题 |
|---|---|---|
| 42 | 42-安装与配置.md | 安装与配置 |
| 43 | 43-CICD与自动化运维.md | CI/CD 与自动化运维 |
第十二篇 版本管理与升级
| 章 | 文件 | 标题 |
|---|---|---|
| 44 | 44-版本管理.md | 版本管理 |
第十三篇 最佳实践
| 章 | 文件 | 标题 |
|---|---|---|
| 45 | 45-模块设计模式.md | 模块设计模式 |
第十四篇 高级主题
| 章 | 文件 | 标题 |
|---|---|---|
| 46 | 46-高级开发.md | 高级开发(含二维码、Sign、水印、Word 导出) |
第十五篇 场景与实践
| 章 | 文件 | 标题 |
|---|---|---|
| 47 | 47-常见应用场景.md | 常见应用场景(多公司、索引、批次、context、批量写入等) |
第十六篇 AI 工程集成
| 章 | 文件 | 标题 |
|---|---|---|
| 48 | 48-AI集成.md | AI 集成:ai/ 模块精读(RAG、向量、LLM 工具循环、Discuss/WS/SSE、Prompt) |
第十七篇 环境部署
| 章 | 文件 | 标题 |
|---|---|---|
| 49 | 49-Odoo环境部署.md | Odoo 环境部署(Ubuntu、Windows/WSL、macOS 分步流程) |
附录(第九十九章)
| 章 | 文件 | 标题 |
|---|---|---|
| 99 | 99-附录.md | 附录:ORM Changelog 要点、CLI、Domain、Widget 对照、术语表 |