# zanderdhancock/inventory_management_system architecture

> Architecture diagram of the GitHub repository zanderdhancock/inventory_management_system, 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/zanderdhancock/inventory_management_system
- Repository: https://github.com/zanderdhancock/inventory_management_system

## Overview

Oceanus is a Streamlit inventory-management app backed by Supabase. A team member enters an access code, selects their name, and can view inventory metrics, search and filter items, or add and edit inventory; those changes are persisted and recorded in activity history. The app also checks for duplicate additions and summarizes edits. The graph follows the visible entry-point orchestration and separates UI, inventory logic, and persistence. Source excerpts do not show deletion wired into the app, so it is not presented as an available workflow.

Main entry points: [`main.py`](https://github.com/zanderdhancock/inventory_management_system/blob/main/main.py) (App and access flow), [`components.py`](https://github.com/zanderdhancock/inventory_management_system/blob/main/components.py) (Inventory UI), [`database.py`](https://github.com/zanderdhancock/inventory_management_system/blob/main/database.py) (Supabase data access), [`options.py`](https://github.com/zanderdhancock/inventory_management_system/blob/main/options.py) (Inventory options)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entrypoint["App and access flow<br/>[main.py]"]
  node_presentation["Inventory UI<br/>[components.py]"]
  node_styling["Page styling<br/>[styles.py]"]
end

subgraph group_domain["Inventory domain"]
  node_catalog["Inventory operations<br/>[inventory.py]"]
  node_taxonomy["Inventory options<br/>[options.py]"]
end

subgraph group_persistence["Persistence"]
  node_data_access["Supabase data access<br/>[database.py]"]
end

node_team_member(("Team member"))
node_supabase[("Supabase")]

node_team_member -->|"uses"| node_entrypoint
node_entrypoint -->|"applies"| node_styling
node_entrypoint -->|"renders"| node_presentation
node_entrypoint -->|"calls"| node_catalog
node_entrypoint -->|"loads and writes"| node_data_access
node_presentation -->|"uses choices"| node_taxonomy
node_entrypoint -->|"selects members"| node_taxonomy
node_data_access -->|"queries"| node_supabase

click node_entrypoint "https://github.com/zanderdhancock/inventory_management_system/blob/main/main.py"
click node_presentation "https://github.com/zanderdhancock/inventory_management_system/blob/main/components.py"
click node_styling "https://github.com/zanderdhancock/inventory_management_system/blob/main/styles.py"
click node_catalog "https://github.com/zanderdhancock/inventory_management_system/blob/main/inventory.py"
click node_taxonomy "https://github.com/zanderdhancock/inventory_management_system/blob/main/options.py"
click node_data_access "https://github.com/zanderdhancock/inventory_management_system/blob/main/database.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_entrypoint,node_presentation,node_styling toneBlue
class node_catalog,node_taxonomy,node_supabase toneAmber
class node_data_access toneMint
class node_team_member toneIndigo
```

## Components

### Application

- [App and access flow](https://github.com/zanderdhancock/inventory_management_system/blob/main/main.py): `main.py`
- [Inventory UI](https://github.com/zanderdhancock/inventory_management_system/blob/main/components.py): `components.py`
- [Page styling](https://github.com/zanderdhancock/inventory_management_system/blob/main/styles.py): `styles.py`

### Inventory domain

- [Inventory operations](https://github.com/zanderdhancock/inventory_management_system/blob/main/inventory.py): `inventory.py`
- [Inventory options](https://github.com/zanderdhancock/inventory_management_system/blob/main/options.py): `options.py`

### Persistence

- [Supabase data access](https://github.com/zanderdhancock/inventory_management_system/blob/main/database.py): `database.py`

### Other components

- **Team member**
- **Supabase**

## Connections

- Team member → App and access flow: uses (evidence: `main.py`)
- App and access flow → Page styling: applies (evidence: `main.py`)
- App and access flow → Inventory UI: renders (evidence: `main.py`)
- App and access flow → Inventory operations: calls (evidence: `main.py`)
- App and access flow → Supabase data access: loads and writes (evidence: `main.py`)
- Inventory UI → Inventory options: uses choices (evidence: `components.py`)
- App and access flow → Inventory options: selects members (evidence: `main.py`)
- Supabase data access → Supabase: queries (evidence: `database.py`)
