# elizajose/poupamed architecture

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

- Interactive diagram: https://gitdiagram.com/elizajose/poupamed
- Repository: https://github.com/elizajose/poupamed

## Overview

PoupaMed is a Streamlit application for comparing hospital purchasing requests with supplier quotations. The user uploads a wish list and one or more supplier quotes; the application extracts and standardizes their contents, matches products, calculates audited costs, and presents a supplier ranking, with PDF audit reports as an export. The repository is a single 35 KB Python file, so these are conceptual responsibilities within one implementation, not separate services. The excerpts show semantic scoring and supplier-specific PDF dispatch; other capability links rely on README documentation.

Main entry points: [`PoupaMed.py`](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py) (File extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["Inputs and extraction"]
  node_app["Streamlit application<br/>[PoupaMed.py]"]
  node_wish["Wish-list input<br/>[PoupaMed.py]"]
  node_quote["Supplier quotations<br/>[PoupaMed.py]"]
  node_extract["File extraction<br/>[PoupaMed.py]"]
  node_supplier_pdf["Supplier PDF parsers<br/>[PoupaMed.py]"]
end

subgraph group_analysis["Comparison and audit"]
  node_standardize["Data standardization<br/>[PoupaMed.py]"]
  node_matching["Semantic matching<br/>[PoupaMed.py]"]
  node_scoring["Compatibility scoring<br/>[PoupaMed.py]"]
  node_finance["Financial calculation<br/>[PoupaMed.py]"]
  node_audit["Audit details<br/>[PoupaMed.py]"]
end

subgraph group_presentation["Results and export"]
  node_ranking["Supplier ranking<br/>[PoupaMed.py]"]
  node_results["Comparison results<br/>[PoupaMed.py]"]
  node_pdf_export["PDF report export<br/>[PoupaMed.py]"]
end

node_user(("Hospital buyer"))

node_user -->|"uploads files"| node_app
node_app -->|"accepts wish list"| node_wish
node_app -->|"accepts quotations"| node_quote
node_wish -->|"extracts data"| node_extract
node_quote -->|"extracts data"| node_extract
node_extract -->|"dispatches PDFs"| node_supplier_pdf
node_extract -->|"standardizes data"| node_standardize
node_supplier_pdf -->|"standardizes output"| node_standardize
node_standardize -.->|"prepares comparison"| node_matching
node_matching -->|"scores candidates"| node_scoring
node_scoring -->|"records compatibility"| node_audit
node_audit -->|"calculates costs"| node_finance
node_finance -->|"ranks suppliers"| node_ranking
node_ranking -->|"presents ranking"| node_results
node_audit -->|"exports report"| node_pdf_export
node_results -->|"shows results"| node_user
node_pdf_export -->|"provides report"| node_user

click node_app "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_wish "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_quote "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_extract "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_supplier_pdf "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_standardize "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_matching "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_scoring "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_finance "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_audit "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_ranking "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_results "https://github.com/elizajose/poupamed/blob/main/PoupaMed.py"
click node_pdf_export "https://github.com/elizajose/poupamed/blob/main/PoupaMed.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_app,node_wish,node_quote,node_extract,node_supplier_pdf toneBlue
class node_standardize,node_matching,node_scoring,node_finance,node_audit toneAmber
class node_ranking,node_results,node_pdf_export toneMint
class node_user toneIndigo
```

## Components

### Inputs and extraction

- [Streamlit application](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [Wish-list input](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [Supplier quotations](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [File extraction](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [Supplier PDF parsers](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`

### Comparison and audit

- [Data standardization](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [Semantic matching](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [Compatibility scoring](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [Financial calculation](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [Audit details](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`

### Results and export

- [Supplier ranking](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [Comparison results](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`
- [PDF report export](https://github.com/elizajose/poupamed/blob/main/PoupaMed.py): `PoupaMed.py`

### Other components

- **Hospital buyer**

## Connections

- Hospital buyer → Streamlit application: uploads files (evidence: `README.md`)
- Streamlit application → Wish-list input: accepts wish list (evidence: `README.md`)
- Streamlit application → Supplier quotations: accepts quotations (evidence: `README.md`)
- Wish-list input → File extraction: extracts data (evidence: `README.md`)
- Supplier quotations → File extraction: extracts data (evidence: `README.md`)
- File extraction → Supplier PDF parsers: dispatches PDFs (evidence: `PoupaMed.py`)
- File extraction → Data standardization: standardizes data (evidence: `PoupaMed.py`)
- Supplier PDF parsers → Data standardization: standardizes output (evidence: `PoupaMed.py`)
- Data standardization → Semantic matching: prepares comparison (evidence: `PoupaMed.py`)
- Semantic matching → Compatibility scoring: scores candidates (evidence: `PoupaMed.py`)
- Compatibility scoring → Audit details: records compatibility (evidence: `README.md`)
- Audit details → Financial calculation: calculates costs (evidence: `README.md`)
- Financial calculation → Supplier ranking: ranks suppliers (evidence: `README.md`)
- Supplier ranking → Comparison results: presents ranking (evidence: `README.md`)
- Audit details → PDF report export: exports report (evidence: `README.md`)
- Comparison results → Hospital buyer: shows results (evidence: `README.md`)
- PDF report export → Hospital buyer: provides report (evidence: `README.md`)
