# antoniocruz-dev/odoo architecture

> Architecture diagram of the GitHub repository antoniocruz-dev/odoo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antoniocruz-dev/odoo
- Repository: https://github.com/antoniocruz-dev/odoo

## Overview

Odoo is a web-based suite of business applications that can be used independently or integrated as an ERP. Its principal user workflow is an HTTP request dispatched to an application controller; the controller produces a business-facing response. The repository also includes core ORM, server, and utility layers, plus documented capabilities such as CRM, accounting, inventory, and HR. The excerpts establish HTTP dispatch and some core module relationships, but do not show most application-to-ORM calls, so those links are omitted.

Main entry points: [`odoo/http.py`](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/http.py) (HTTP dispatch), [`odoo/orm/models.py`](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/orm/models.py) (ORM models), [`odoo/service/server.py`](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/service/server.py) (Application server), [`odoo/orm/fields.py`](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/orm/fields.py) (ORM fields)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Platform runtime"]
  node_http["HTTP dispatch<br/>[http.py]"]
  node_server["Application server<br/>[server.py]"]
  node_controllers["App controllers"]
end

subgraph group_orm["Data and ORM"]
  node_ormmodels["ORM models<br/>[models.py]"]
  node_ormfields["ORM fields<br/>[fields.py]"]
  node_api["ORM API<br/>[__init__.py]"]
  node_database[("PostgreSQL")]
end

subgraph group_core["Core services"]
  node_exceptions["Error types<br/>[exceptions.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_utilities["Shared utilities<br/>[misc.py]"]
  node_json["JSON handling<br/>[json.py]"]
  node_translation["Translation<br/>[translate.py]"]
end

subgraph group_business["Business applications"]
  node_crm["CRM"]
  node_website["Website and ecommerce"]
  node_inventory["Warehouse management"]
  node_accounting["Billing and accounting"]
  node_projects["Project management"]
  node_pos["Point of sale"]
  node_hr["Human resources"]
  node_marketing["Marketing"]
  node_manufacturing["Manufacturing"]
end

node_user(("User"))

node_user -->|"sends request"| node_http
node_http -->|"dispatches to"| node_controllers
node_server -->|"opens connection"| node_database
node_ormfields -->|"supports models"| node_ormmodels
node_api -->|"exports model API"| node_ormmodels

click node_http "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/http.py"
click node_server "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/service/server.py"
click node_controllers "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons"
click node_ormmodels "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/orm/models.py"
click node_ormfields "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/orm/fields.py"
click node_api "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/api/__init__.py"
click node_exceptions "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/exceptions.py"
click node_config "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/tools/config.py"
click node_utilities "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/tools/misc.py"
click node_json "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/tools/json.py"
click node_translation "https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/tools/translate.py"
click node_crm "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/crm"
click node_website "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/website_sale"
click node_inventory "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/stock"
click node_accounting "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/account"
click node_projects "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/project"
click node_pos "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/point_of_sale"
click node_hr "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/hr"
click node_marketing "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/mass_mailing"
click node_manufacturing "https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/mrp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_http,node_server,node_controllers,node_user toneBlue
class node_ormmodels,node_ormfields,node_api,node_database toneAmber
class node_exceptions,node_config,node_utilities,node_json,node_translation toneMint
class node_crm,node_website,node_inventory,node_accounting,node_projects,node_pos,node_hr,node_marketing,node_manufacturing toneRose
```

## Components

### Platform runtime

- [HTTP dispatch](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/http.py): `odoo/http.py`
- [Application server](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/service/server.py): `odoo/service/server.py`
- [App controllers](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons): `addons`

### Data and ORM

- [ORM models](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/orm/models.py): `odoo/orm/models.py`
- [ORM fields](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/orm/fields.py): `odoo/orm/fields.py`
- [ORM API](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/api/__init__.py): `odoo/api/__init__.py`
- **PostgreSQL**

### Core services

- [Error types](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/exceptions.py): `odoo/exceptions.py`
- [Runtime configuration](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/tools/config.py): `odoo/tools/config.py`
- [Shared utilities](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/tools/misc.py): `odoo/tools/misc.py`
- [JSON handling](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/tools/json.py): `odoo/tools/json.py`
- [Translation](https://github.com/antoniocruz-dev/odoo/blob/19.0/odoo/tools/translate.py): `odoo/tools/translate.py`

### Business applications

- [CRM](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/crm): `addons/crm`
- [Website and ecommerce](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/website_sale): `addons/website_sale`
- [Warehouse management](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/stock): `addons/stock`
- [Billing and accounting](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/account): `addons/account`
- [Project management](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/project): `addons/project`
- [Point of sale](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/point_of_sale): `addons/point_of_sale`
- [Human resources](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/hr): `addons/hr`
- [Marketing](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/mass_mailing): `addons/mass_mailing`
- [Manufacturing](https://github.com/antoniocruz-dev/odoo/tree/19.0/addons/mrp): `addons/mrp`

### Other components

- **User**

## Connections

- User → HTTP dispatch: sends request (evidence: `odoo/http.py`)
- HTTP dispatch → App controllers: dispatches to (evidence: `odoo/http.py`)
- Application server → PostgreSQL: opens connection (evidence: `odoo/service/server.py`)
- ORM fields → ORM models: supports models (evidence: `odoo/fields/__init__.py`)
- ORM API → ORM models: exports model API (evidence: `odoo/api/__init__.py`)
