Odoo 19 开发技术白皮书 — 全书索引

章表以本文件为准00-前言.md49-Odoo环境部署.md50-HTTP控制器与路由.md(第九篇补章)及 99-附录.md 与下表一一对应,便于分章排版、合并 PDF 或交付印刷厂。(若另需对外「纯目录」页,可从本表导出,无需单独维护同名 .md 文件。)

前言

文件 说明
00-前言.md Odoo 沿革、版本与技术演进概览、应用领域;建议置于全书正文之前印刷
官方文档对照与延伸阅读.md Odoo 19.0 Developer 文档 的 Tutorials / How-to / Reference 分层说明,及教材章 ↔ 官方章节映射;可与各章交叉查阅,不编入正文页码亦可

教材体例说明

  • 每章含 学习目标、分节 讲解案例截图占位(路径 ./images/…清单与补图说明images/README.mdimages/MANIFEST.txt)、本节练习(含参考答案提示或「见某节」)。
  • 本章综合练习 参考答案见 answers.md(建议教师版单独装订,勿与学员正文同印)。
  • 截图请在排版前补全;占位图可先用 1×1 透明 PNG 或删除 ![]() 仅保留说明文字。

排版与合并建议

  • 章文件命名00-前言.md01-概念总论.md48-AI集成.md49-Odoo环境部署.md50-HTTP控制器与路由.mdHTTP 路由专章),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 对照、术语表

参考链接