# emreyesilyurt/bomer architecture

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

- Interactive diagram: https://gitdiagram.com/emreyesilyurt/bomer
- Repository: https://github.com/emreyesilyurt/bomer

## Overview

Bomer is a deterministic, CLI-first bill-of-materials analysis tool. A user runs `bomer analyze` with a BoM CSV and supplier JSON; the CLI calls the analysis API, which loads configuration and inputs, normalizes and validates the BoM, aggregates duplicate parts, and computes cost and risk. The CLI then writes CSV, JSON, and text reports. The graph follows the documented workflow and sampled call sites; it does not infer connections to unsampled internals.

Main entry points: [`src/bomer/api.py`](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/api.py) (Analysis API), [`src/bomer/cli.py`](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/cli.py) (Analyze CLI), [`src/bomer/core/loader.py`](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/loader.py) (Input loader), [`src/bomer/core/config.py`](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/config.py) (Configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Analysis workflow"]
  node_cli["Analyze CLI<br/>[cli.py]"]
  node_api["Analysis API<br/>[api.py]"]
end

subgraph group_preparation["Inputs and preparation"]
  node_config["Configuration<br/>[config.py]"]
  node_loader["Input loader<br/>[loader.py]"]
  node_schema["Normalize and validate<br/>[schema.py]"]
  node_errors["Domain errors<br/>[exceptions.py]"]
  node_bomfile["BoM CSV<br/>[sample_bom.csv]"]
  node_supplierfile["Supplier JSON<br/>[suppliers.json]"]
  node_configfile["YAML config<br/>[bomer.yaml]"]
end

subgraph group_analysis["Analysis engines"]
  node_optimizer["BoM optimizer<br/>[optimizer.py]"]
  node_cost["Cost analysis<br/>[cost.py]"]
  node_risk["Risk analysis<br/>[risk.py]"]
  node_models["Result models<br/>[models.py]"]
end

subgraph group_reporting["Reports and results"]
  node_writer["Report writers<br/>[report_writer.py]"]
  node_artifacts["Analysis artifacts<br/>[report_writer.py]"]
end

node_user(("User"))

node_user -->|"runs command"| node_cli
node_cli -->|"calls analysis"| node_api
node_api -->|"loads config"| node_config
node_api -->|"loads inputs"| node_loader
node_api -->|"normalizes and validates"| node_schema
node_api -->|"optimizes BoM"| node_optimizer
node_api -->|"computes cost"| node_cost
node_api -->|"scores risk"| node_risk
node_cli -->|"writes reports"| node_writer
node_config -->|"raises errors"| node_errors
node_loader -->|"raises errors"| node_errors
node_cli -->|"handles errors"| node_errors
node_cost -->|"creates summaries"| node_models
node_risk -->|"creates summaries"| node_models
node_writer -->|"serializes summaries"| node_models
node_loader -->|"reads CSV"| node_bomfile
node_loader -->|"reads JSON"| node_supplierfile
node_config -->|"loads YAML"| node_configfile
node_writer -->|"writes outputs"| node_artifacts

click node_cli "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/cli.py"
click node_api "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/api.py"
click node_config "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/config.py"
click node_loader "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/loader.py"
click node_schema "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/schema.py"
click node_errors "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/exceptions.py"
click node_optimizer "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/engines/optimizer.py"
click node_cost "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/engines/cost.py"
click node_risk "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/engines/risk.py"
click node_models "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/engines/models.py"
click node_writer "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/reporting/report_writer.py"
click node_bomfile "https://github.com/emreyesilyurt/bomer/blob/main/data/sample_bom.csv"
click node_supplierfile "https://github.com/emreyesilyurt/bomer/blob/main/data/suppliers.json"
click node_configfile "https://github.com/emreyesilyurt/bomer/blob/main/bomer.yaml"
click node_artifacts "https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/reporting/report_writer.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_cli,node_api,node_user toneBlue
class node_config,node_loader,node_schema,node_errors,node_bomfile,node_supplierfile,node_configfile toneAmber
class node_optimizer,node_cost,node_risk,node_models toneMint
class node_writer,node_artifacts toneRose
```

## Components

### Analysis workflow

- [Analyze CLI](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/cli.py): `src/bomer/cli.py`
- [Analysis API](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/api.py): `src/bomer/api.py`

### Inputs and preparation

- [Configuration](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/config.py): `src/bomer/core/config.py`
- [Input loader](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/loader.py): `src/bomer/core/loader.py`
- [Normalize and validate](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/schema.py): `src/bomer/core/schema.py`
- [Domain errors](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/core/exceptions.py): `src/bomer/core/exceptions.py`
- [BoM CSV](https://github.com/emreyesilyurt/bomer/blob/main/data/sample_bom.csv): `data/sample_bom.csv`
- [Supplier JSON](https://github.com/emreyesilyurt/bomer/blob/main/data/suppliers.json): `data/suppliers.json`
- [YAML config](https://github.com/emreyesilyurt/bomer/blob/main/bomer.yaml): `bomer.yaml`

### Analysis engines

- [BoM optimizer](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/engines/optimizer.py): `src/bomer/engines/optimizer.py`
- [Cost analysis](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/engines/cost.py): `src/bomer/engines/cost.py`
- [Risk analysis](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/engines/risk.py): `src/bomer/engines/risk.py`
- [Result models](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/engines/models.py): `src/bomer/engines/models.py`

### Reports and results

- [Report writers](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/reporting/report_writer.py): `src/bomer/reporting/report_writer.py`
- [Analysis artifacts](https://github.com/emreyesilyurt/bomer/blob/main/src/bomer/reporting/report_writer.py): `src/bomer/reporting/report_writer.py`

### Other components

- **User**

## Connections

- User → Analyze CLI: runs command (evidence: `README.md`)
- Analyze CLI → Analysis API: calls analysis (evidence: `src/bomer/cli.py`)
- Analysis API → Configuration: loads config (evidence: `src/bomer/api.py`)
- Analysis API → Input loader: loads inputs (evidence: `src/bomer/api.py`)
- Analysis API → Normalize and validate: normalizes and validates (evidence: `src/bomer/api.py`)
- Analysis API → BoM optimizer: optimizes BoM (evidence: `src/bomer/api.py`)
- Analysis API → Cost analysis: computes cost (evidence: `src/bomer/api.py`)
- Analysis API → Risk analysis: scores risk (evidence: `src/bomer/api.py`)
- Analyze CLI → Report writers: writes reports (evidence: `src/bomer/cli.py`)
- Configuration → Domain errors: raises errors (evidence: `src/bomer/core/config.py`)
- Input loader → Domain errors: raises errors (evidence: `src/bomer/core/loader.py`)
- Analyze CLI → Domain errors: handles errors (evidence: `src/bomer/cli.py`)
- Cost analysis → Result models: creates summaries (evidence: `src/bomer/engines/cost.py`)
- Risk analysis → Result models: creates summaries (evidence: `src/bomer/engines/risk.py`)
- Report writers → Result models: serializes summaries (evidence: `src/bomer/reporting/report_writer.py`)
- Input loader → BoM CSV: reads CSV (evidence: `src/bomer/core/loader.py`)
- Input loader → Supplier JSON: reads JSON (evidence: `src/bomer/core/loader.py`)
- Configuration → YAML config: loads YAML (evidence: `src/bomer/core/config.py`)
- Report writers → Analysis artifacts: writes outputs (evidence: `src/bomer/reporting/report_writer.py`)
