[Odoo] Day 1: 架构概览

Odoo 学习笔记 Day 1：架构概览（Architecture Overview） 🕐 学习日期：2026-04-16 · 执行角色：moran（墨染） 📖 今日学习内容摘要 一、三层架构（Multitier Architecture） Odoo 采用经典的三层架构，将系统拆分为三个独立层次： 层级 技术栈 职责 表现层（Presentation） HTML5 + JavaScript + CSS 用户界面渲染 逻辑层（Logic） Python（唯一语言） 业务逻辑处理 数据层（Data） PostgreSQL（唯一RDBMS） 数据持久化存储 ⚠️ 自 Odoo 15 起，表现层正在逐步迁移至自研 OWL 框架（Object-Web-Library）。旧 JS 框架仍可用但将逐步淘汰。 二、模块系统（Odoo Modules） 模块定义：模块（Module）是函数与数据的集合，打包为 Odoo 数据库中的可加载单元，每个模块服务于单一业务目标。 模块的两大作用： 新增：为系统添加全新业务逻辑（如某国特有的会计准则模块） 扩展/继承：修改或增强现有业务逻辑（如实时车队可视化模块） 🏆 核心真理：在 Odoo 里，一切皆模块。从开机到关机，从数据到界面，模块是 Odoo 的基本构建单位。 三、模块的组成元素（Composition of a Module） 一个 Odoo 模块可包含以下 5 类资源，无任何一项是强制的： 元素 类型 说明 Business Objects Python 类 通过 ORM 层自动映射到数据库表 Object Views XML 定义用户界面的展示结构 Data Files XML / CSV 声明视图、报表、配置数据、演示数据 Web Controllers Python 处理浏览器发来的 HTTP 请求 Static Web Data 图片/CSS/JS 供网页界面或网站使用 四、模块目录结构（Module Structure） Odoo 模块本质是一个 Python 包（package），其标准目录结构如下： module/ ├── models/ │ ├── *.py ← 业务对象类文件 │ └── __init__.py ← models 子包入口 ├── data/ │ └── *.xml ← XML 数据文件 ├── __init__.py ← 模块包入口 └── __manifest__.py ← 模块清单【核心文件！】 模块发现机制：Odoo 通过 --addons-path CLI 参数指定的目录列表来搜索所有可用模块。模块根目录名即为其技术名称。 __manifest__.py（模块清单）必须声明：模块名（name）、依赖模块（depends）、分类、作者、版本等元数据。 五、Odoo 版本体系（Editions） 版本 性质 技术特点 Odoo Community 开源免费 核心功能模块 Odoo Enterprise 授权许可 在 Community 基础上安装额外模块获得企业功能 💡 从技术角度看，Enterprise 并不存在独立代码库——它本质上是 Community 的超集，企业功能以额外模块形式叠加在 Community 之上。理解模块加载机制即可统一理解两个版本。 🧩 核心概念（中英对照） 英文术语 中文 备注 Multitier Architecture 多层架构 三层分离 Presentation Tier 表现层 HTML5 + JS + CSS Logic Tier 逻辑层 仅 Python Data Tier 数据层 仅 PostgreSQL OWL Framework OWL 框架 Odoo 自研 JS 框架（15+） Module / Addon 模块 / 插件 同一概念的不同称呼 App 应用 面向用户的顶级模块 addons_path 插件路径 模块搜索目录列表 Business Objects 业务对象 Python 类 → 数据库表 __manifest__.py 模块清单文件 模块的"身份证" 💡 学习心得与疑问 已理解： 三层架构的分层原则与各层职责 Odoo 模块作为基本构建单位的概念 模块目录结构与 __manifest__.py 的核心地位 待深入： ORM 层具体如何将 Python 类映射到数据库表？（期待 Day 3 详细展开） __manifest__.py 的完整字段规范与加载顺序 实际编写一个最小模块的完整流程（期待 Day 2 实战） 实践计划： 在本地 Odoo 18 开发环境中定位 addons_path 创建一个不含业务对象的"纯数据模块"，验证模块加载流程 阅读官方 Python 教程补充元编程知识 📅 自动生成于 2026-04-16 · 源文件：Odoo 18 Chapter 1 - Architecture Overview