# bilbonet/bilbonet-tsm architecture

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

- Interactive diagram: https://gitdiagram.com/bilbonet/bilbonet-tsm
- Repository: https://github.com/bilbonet/bilbonet-tsm

## Overview

##### Project type and purpose
- This is a suite of Odoo “addons” (modules) collectively called “bilbonet-tsm” for Technical Support Management.
- Its purpose is to extend Odoo’s core ERP with support-centric features: tasks, materials tracking, timesheets, assets, time-packing, and commission settlement.

##### File structure
- Top-level directories and files:
- setup/…: packaging/layout for each module under “setup/tsm_*”
- tsm_base, tsm_task_material, tsm_task_timesheet, tsm_tech_assets, tsm_time_pack, tsm_timesheet_commission: each is an Odoo addon
- Standard Odoo addon structure: __manifest__.py, models/, views/, data/, security/, report/, static/, readme/
- Architectural indication: a modular, plug-in pattern where tsm_base is the core that other tsm_* modules depend upon.
- Configuration/build scripts: setup/ folder holds setuptools wrappers to install each addon as a Python package.

##### README
- Very brief: “Technical Support Management,” confirming this is an Odoo extension suite.

##### Detail and comprehensiveness
- Tsm_base as the foundational component.
- Keep it modular—this will clearly show how future tsm_* modules plug into the same architecture.

## Diagram (Mermaid)

```mermaid
graph TB
    %% External User and Client
    Browser["Web Browser"]:::external
    SMTP["SMTP Server"]:::external
    LDAP["LDAP/SSO (Optional)"]:::external

    %% Database
    subgraph "Database"
        Postgres[(PostgreSQL)]:::database
    end

    %% Odoo Application
    subgraph "Odoo Application Server"
        direction TB

        Core["Odoo Core"]:::core

        subgraph "tsm_base (Core Addon)" 
            direction TB
            Base["tsm_base"]:::base
        end

        subgraph "tsm Extensions" 
            direction TB
            TMAT["tsm_task_material"]:::extension
            TTIM["tsm_task_timesheet"]:::extension
            TAST["tsm_tech_assets"]:::extension
            TPACK["tsm_time_pack"]:::extension
            TCOM["tsm_timesheet_commission"]:::extension
        end
    end

    %% Interactions
    Browser -->|"HTTP Request"| Core
    Core -->|"Controllers & ORM"| Postgres
    Base -->|"Defines Models & Views"| Core
    TMAT -->|"Inherits from"| Base
    TTIM -->|"Inherits from"| Base
    TAST -->|"Inherits from"| Base
    TPACK -->|"Inherits from"| Base
    TCOM -->|"Inherits from"| Base

    %% Data flows
    TMAT -->|"ORM Read/Write"| Postgres
    TTIM -->|"ORM Read/Write"| Postgres
    TAST -->|"ORM Read/Write"| Postgres
    TPACK -->|"ORM Read/Write"| Postgres
    TCOM -->|"ORM Read/Write"| Postgres

    %% Email
    Base -->|"Email Templates"| SMTP
    TMAT -->|"Static Assets & Descriptions"| Browser
    TTIM -->|"Static Assets & Descriptions"| Browser
    TAST -->|"Static Assets & Descriptions"| Browser
    TPACK -->|"Static Assets & Descriptions"| Browser
    TCOM -->|"Static Assets & Descriptions"| Browser

    %% Optional External
    Core -->|"Auth"| LDAP

    %% Click Events
    click Base "https://github.com/bilbonet/bilbonet-tsm/tree/15.0/tsm_base/"
    click TMAT "https://github.com/bilbonet/bilbonet-tsm/tree/15.0/tsm_task_material/"
    click TTIM "https://github.com/bilbonet/bilbonet-tsm/tree/15.0/tsm_task_timesheet/"
    click TAST "https://github.com/bilbonet/bilbonet-tsm/tree/15.0/tsm_tech_assets/"
    click TPACK "https://github.com/bilbonet/bilbonet-tsm/tree/15.0/tsm_time_pack/"
    click TCOM "https://github.com/bilbonet/bilbonet-tsm/tree/15.0/tsm_timesheet_commission/"

    %% Styles
    classDef external fill:#FFEBCC,stroke:#E69500;
    classDef database fill:#E0E0E0,stroke:#AAA;
    classDef core fill:#CFE2F3,stroke:#2F75B5;
    classDef base fill:#BDD7EE,stroke:#255E91;
    classDef extension fill:#D9EAD3,stroke:#70AD47;
```
