# psmiguelvazquez/proper architecture

> Architecture diagram of the GitHub repository psmiguelvazquez/proper, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/psmiguelvazquez/proper
- Repository: https://github.com/psmiguelvazquez/proper

## Overview

##### Project type and purpose
- This is a collection of Odoo “addons” (modules). Each top-level folder (e.g. account_move_proper, carta_porte, sale_purchase_confirm, etc.) is a self-contained Odoo module that plugs into the core Odoo server.
- The purpose is to extend and customize Odoo’s accounting, sales, stock, CRM and other business flows by defining new models, views, wizards, security rules, data files and static assets.

##### File structure
- __manifest__.py – module metadata and dependencies
- models/ – Python classes extending Odoo’s ORM (model definitions, method overrides)
- views/ – XML definitions for forms, trees, kanban, reports
- wizard/ – Python + XML for multi-step dialogs
- security/ – access control CSVs, record-rules, groups
- data/ – initial data or sequences
- static/ – JavaScript widgets, CSS, images
- controllers/ – HTTP route handlers for web endpoints
- Common patterns: MVC (models + views + controllers), plugin architecture (each module injected at startup), layered business-logic (wizards, helpers, reports).

##### README
- The README (“# proper”) is minimal and only labels the project. All architectural information must be inferred from the file tree and standard Odoo conventions.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client
    UI["Browser (JS Client)"]:::client

    %% Core
    subgraph "Odoo Server"
        Core["Odoo Core Server"]:::core
        Loader["Add-ons Loader"]:::core
    end

    %% Modules Groups
    subgraph "Accounting Modules"
        AMB["account_bank_statement_proper"]:::module
        AMO["account_move_proper"]:::module
    end

    subgraph "Sales & CRM Modules"
        SPC["sale_purchase_confirm"]:::module
    end

    subgraph "Inventory/Warehouse Modules"
        SQC["stock_quant_client"]:::module
    end

    subgraph "Utilities & Widgets"
        APW["account_payment_widget_amount"]:::module
        OMR["om_data_remove"]:::module
    end

    %% Database
    DB["PostgreSQL Database"]:::db

    %% Data Flows
    UI -->|"HTTP/WebSocket"| Core
    Core --> Loader
    Loader --> AMB
    Loader --> AMO
    Loader --> SPC
    Loader --> SQC
    Loader --> APW
    Loader --> OMR
    AMB -->|extends ORM Models| Core
    AMO -->|extends ORM Models| Core
    SPC -->|adds Controllers| Core
    SQC -->|adds Controllers| Core
    APW -->|adds JS Widget| UI
    OMR -->|adds Static Pages| UI
    Core -->|"ORM CRUD"| DB
    DB -->|returns Data| Core

    %% Click Events
    click AMB "https://github.com/psmiguelvazquez/proper/blob/main/account_bank_statement_proper/__manifest__.py"
    click AMO "https://github.com/psmiguelvazquez/proper/blob/main/account_move_proper/__manifest__.py"
    click SPC "https://github.com/psmiguelvazquez/proper/tree/main/sale_purchase_confirm/static/img/"
    click SQC "https://github.com/psmiguelvazquez/proper/blob/main/stock_quant_client/controllers/controllers.py"
    click APW "https://github.com/psmiguelvazquez/proper/blob/main/account_payment_widget_amount/static/src/js/account_payment_field.js"
    click OMR "https://github.com/psmiguelvazquez/proper/blob/main/om_data_remove/static/description/index.html"

    %% Styles
    classDef core fill:#DDDDDD,stroke:#888888,color:#000000;
    classDef client fill:#FFCC99,stroke:#CC6600,color:#000000;
    classDef module fill:#99CCFF,stroke:#3366CC,color:#000000;
    classDef db fill:#99FF99,stroke:#33CC33,color:#000000;
```
