# nosolotec/web architecture

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

- Interactive diagram: https://gitdiagram.com/nosolotec/web
- Repository: https://github.com/nosolotec/web

## Overview

##### Project Type and Purpose
- This is an Odoo module repository with multiple web-related addons. Its primary purpose is to enhance the Odoo backend’s web interface with custom widgets, additional search capabilities, dark mode support, responsive design, and more.
- The README lists each addon with its version and a short description. This shows that the overall architecture is plugin‐based, in which each module adds or modifies specific parts of the Odoo web client.

##### File Structure
- At the top level, you have configuration files (.editorconfig, .eslintrc.yml, etc.), CI/CD workflows (.github/workflows/…), and setup scripts (under the “setup” directory). These files help maintain code quality and manage the packaging of addons.
- Under “setup” there are directories for grouping addons (e.g., setup/web_action_conditionable, setup/web_advanced_search, etc.) organized into an “odoo” structure to mimic an Odoo instance directory with its “addons” folder.
- Additionally, many individual addon directories (like “web_action_conditionable”, “web_advanced_search”, etc.) contain the usual Odoo addon files: __init__.py, __manifest__.py, controllers, models, views (XML), javascript and static assets, translation files (i18n), and tests.

##### Determining the Main Components
- Odoo Core: Represent the Odoo server or instance that loads addons.
- Addon Modules: Each addon (e.g., web_dark_mode, web_help, web_notify) is a discrete component that plugs into the Odoo environment.
- Shared Services and Assets: Notice static files (JavaScript, SCSS, XML) and libraries that are used on the web client side.
- Testing and CI/CD: Separate components that ensure code quality (tests directories, GitHub workflows, lint configurations).

– Rectangles for individual addon modules.
- Annotations that highlight important design principles like separation of concerns (modules dealing with different aspects of functionality), clean integration via manifests, and modular extensibility.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Addon Modules"
        darkMode["Dark Mode Addon"]:::addon
        advSearch["Advanced Search Addon"]:::addon
        helpAddon["Help Addon"]:::addon
        notify["Notification Addon"]:::addon
        otherEnh["Other Web Enhancements"]:::addon
    end

    OdooCore["Odoo Server Core"]:::core
    shared["Shared Assets (Static, JS/CSS)"]:::shared
    cd["Testing & CI/CD Pipeline"]:::cd

    darkMode -->|"hooksInto"| OdooCore
    advSearch -->|"hooksInto"| OdooCore
    helpAddon -->|"hooksInto"| OdooCore
    notify -->|"hooksInto"| OdooCore
    otherEnh -->|"hooksInto"| OdooCore

    OdooCore -->|"servesStatic"| shared
    OdooCore -->|"verifiedBy"| cd

    %% Click Events
    click OdooCore "https://github.com/nosolotec/web/tree/16.0/setup/_metapackage"
    click darkMode "https://github.com/nosolotec/web/blob/16.0/web_dark_mode/__manifest__.py"
    click advSearch "https://github.com/nosolotec/web/blob/16.0/web_advanced_search/__manifest__.py"
    click helpAddon "https://github.com/nosolotec/web/blob/16.0/web_help/__manifest__.py"
    click notify "https://github.com/nosolotec/web/blob/16.0/web_notify/__manifest__.py"
    click cd "https://github.com/nosolotec/web/tree/16.0/.github/workflows"

    %% Styles
    classDef core fill:#ffe0b3,stroke:#cc6600,stroke-width:2px;
    classDef addon fill:#cce5ff,stroke:#3399ff,stroke-width:2px;
    classDef shared fill:#d5f5e3,stroke:#28a745,stroke-width:2px;
    classDef cd fill:#f8d7da,stroke:#dc3545,stroke-width:2px;
```
