# ihssane-oukhssane/odoo-sales-workflow architecture

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

- Interactive diagram: https://gitdiagram.com/ihssane-oukhssane/odoo-sales-workflow
- Repository: https://github.com/ihssane-oukhssane/odoo-sales-workflow

## Overview

This repository packages an Odoo 18 deployment setup and a custom sales-procurement addon. The main operator workflow is to provision an instance, start it, and access Odoo; the addon then extends sales confirmation with stock checks and purchasing, tracks fulfilment through invoicing and payment, and exposes configuration and dashboard views. The README documents deployment, PostgreSQL, and live-chat capabilities. Addon relationships below are based on sampled model code; view and cron internals were not sampled, so their links are limited to documented or explicitly configured relationships.

Main entry points: [`addons/sale_auto_procurement/models/sale_order.py`](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/sale_order.py) (Sales order checks), [`addons/sale_auto_procurement/models/stock_picking.py`](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/stock_picking.py) (Stock operations), [`docker-compose.yml`](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml) (Odoo stack), [`addons/sale_auto_procurement/models/procurement_config.py`](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/procurement_config.py) (Procurement rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Deployment"]
  node_installer["Instance setup<br/>[run.sh]"]
  node_compose["Odoo stack<br/>[docker-compose.yml]"]
  node_odoo["Odoo 18<br/>[docker-compose.yml]"]
  node_postgres[("PostgreSQL 17<br/>[docker-compose.yml]")]
  node_livechat["Live chat endpoint<br/>[docker-compose.yml]"]
  node_odoo_config["Odoo configuration<br/>[odoo.conf]"]
end

subgraph group_addon_flow["Sales procurement"]
  node_sale_order["Sales order checks<br/>[sale_order.py]"]
  node_procurement_config["Procurement rules"]
  node_purchase_orders["Purchase orders<br/>[sale_order.py]"]
  node_stock_picking["Stock operations<br/>[stock_picking.py]"]
end

subgraph group_addon_tracking["Lifecycle tracking"]
  node_invoice_tracking["Invoice tracking<br/>[account_move.py]"]
  node_payment_tracking["Payment tracking<br/>[account_payment.py]"]
  node_delay_alerts["Delay alerts<br/>[sale_order.py]"]
  node_scheduled_check["Scheduled delay check<br/>[cron.xml]"]
end

subgraph group_addon_admin["Addon administration"]
  node_settings["Odoo settings"]
  node_dashboard["Procurement dashboard<br/>[dashboard.xml]"]
  node_dashboard_kanban["Dashboard kanban"]
  node_addon_manifest["Addon registration<br/>[__manifest__.py]"]
end

node_operator(("Instance operator"))
node_sales_user(("Sales user"))

node_operator -->|"runs setup"| node_installer
node_operator -->|"starts stack"| node_compose
node_compose -.->|"runs service"| node_odoo
node_compose -.->|"runs service"| node_postgres
node_operator -->|"configures"| node_odoo_config
node_operator -->|"routes traffic"| node_livechat
node_sales_user -.->|"confirms order"| node_sale_order
node_sale_order -->|"reads rules"| node_procurement_config
node_sale_order -->|"creates RFQ"| node_purchase_orders
node_stock_picking -->|"updates order"| node_sale_order
node_stock_picking -->|"reads thresholds"| node_procurement_config
node_stock_picking -->|"creates replenishment"| node_purchase_orders
node_invoice_tracking -->|"updates invoice dates"| node_sale_order
node_payment_tracking -->|"updates payment state"| node_sale_order
node_scheduled_check -.->|"runs delay checks"| node_sale_order
node_sale_order -->|"computes alerts"| node_delay_alerts
node_settings -.->|"stores parameters"| node_procurement_config
node_addon_manifest -->|"loads view"| node_dashboard
node_addon_manifest -->|"loads view"| node_dashboard_kanban

click node_installer "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/run.sh"
click node_compose "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml"
click node_odoo "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml"
click node_postgres "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml"
click node_livechat "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml"
click node_odoo_config "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/etc/odoo.conf"
click node_sale_order "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/sale_order.py"
click node_procurement_config "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/procurement_config.py"
click node_purchase_orders "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/sale_order.py"
click node_stock_picking "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/stock_picking.py"
click node_invoice_tracking "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/account_move.py"
click node_payment_tracking "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/account_payment.py"
click node_delay_alerts "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/sale_order.py"
click node_scheduled_check "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/data/cron.xml"
click node_settings "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/res_config_settings.py"
click node_dashboard "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/views/dashboard.xml"
click node_dashboard_kanban "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/views/dashboard_kanban.xml"
click node_addon_manifest "https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/__manifest__.py"

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_installer,node_compose,node_odoo,node_postgres,node_livechat,node_odoo_config,node_sales_user toneBlue
class node_sale_order,node_procurement_config,node_purchase_orders,node_stock_picking toneAmber
class node_invoice_tracking,node_payment_tracking,node_delay_alerts,node_scheduled_check toneMint
class node_settings,node_dashboard,node_dashboard_kanban,node_addon_manifest toneRose
class node_operator toneIndigo
```

## Components

### Deployment

- [Instance setup](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/run.sh): `run.sh`
- [Odoo stack](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml): `docker-compose.yml`
- [Odoo 18](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml): `docker-compose.yml`
- [PostgreSQL 17](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml): `docker-compose.yml`
- [Live chat endpoint](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/docker-compose.yml): `docker-compose.yml`
- [Odoo configuration](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/etc/odoo.conf): `etc/odoo.conf`

### Sales procurement

- [Sales order checks](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/sale_order.py): `addons/sale_auto_procurement/models/sale_order.py`
- [Procurement rules](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/procurement_config.py): `addons/sale_auto_procurement/models/procurement_config.py`
- [Purchase orders](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/sale_order.py): `addons/sale_auto_procurement/models/sale_order.py`
- [Stock operations](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/stock_picking.py): `addons/sale_auto_procurement/models/stock_picking.py`

### Lifecycle tracking

- [Invoice tracking](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/account_move.py): `addons/sale_auto_procurement/models/account_move.py`
- [Payment tracking](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/account_payment.py): `addons/sale_auto_procurement/models/account_payment.py`
- [Delay alerts](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/sale_order.py): `addons/sale_auto_procurement/models/sale_order.py`
- [Scheduled delay check](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/data/cron.xml): `addons/sale_auto_procurement/data/cron.xml`

### Addon administration

- [Odoo settings](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/models/res_config_settings.py): `addons/sale_auto_procurement/models/res_config_settings.py`
- [Procurement dashboard](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/views/dashboard.xml): `addons/sale_auto_procurement/views/dashboard.xml`
- [Dashboard kanban](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/views/dashboard_kanban.xml): `addons/sale_auto_procurement/views/dashboard_kanban.xml`
- [Addon registration](https://github.com/ihssane-oukhssane/odoo-sales-workflow/blob/main/addons/sale_auto_procurement/__manifest__.py): `addons/sale_auto_procurement/__manifest__.py`

### Other components

- **Instance operator**
- **Sales user**

## Connections

- Instance operator → Instance setup: runs setup (evidence: `README.md`)
- Instance operator → Odoo stack: starts stack (evidence: `README.md`)
- Odoo stack → Odoo 18: runs service
- Odoo stack → PostgreSQL 17: runs service
- Instance operator → Odoo configuration: configures (evidence: `README.md`)
- Instance operator → Live chat endpoint: routes traffic (evidence: `README.md`)
- Sales user → Sales order checks: confirms order
- Sales order checks → Procurement rules: reads rules (evidence: `addons/sale_auto_procurement/models/sale_order.py`)
- Sales order checks → Purchase orders: creates RFQ (evidence: `addons/sale_auto_procurement/models/sale_order.py`)
- Stock operations → Sales order checks: updates order (evidence: `addons/sale_auto_procurement/models/stock_picking.py`)
- Stock operations → Procurement rules: reads thresholds (evidence: `addons/sale_auto_procurement/models/stock_picking.py`)
- Stock operations → Purchase orders: creates replenishment (evidence: `addons/sale_auto_procurement/models/stock_picking.py`)
- Invoice tracking → Sales order checks: updates invoice dates (evidence: `addons/sale_auto_procurement/models/account_move.py`)
- Payment tracking → Sales order checks: updates payment state (evidence: `addons/sale_auto_procurement/models/account_payment.py`)
- Scheduled delay check → Sales order checks: runs delay checks
- Sales order checks → Delay alerts: computes alerts (evidence: `addons/sale_auto_procurement/models/sale_order.py`)
- Odoo settings → Procurement rules: stores parameters
- Addon registration → Procurement dashboard: loads view (evidence: `addons/sale_auto_procurement/__manifest__.py`)
- Addon registration → Dashboard kanban: loads view (evidence: `addons/sale_auto_procurement/__manifest__.py`)
