# devmatt-hmm/campus-navigation-system architecture

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

- Interactive diagram: https://gitdiagram.com/devmatt-hmm/campus-navigation-system
- Repository: https://github.com/devmatt-hmm/campus-navigation-system

## Overview

This is a small, console-based campus directory demonstrating array-based DSA concepts. The user selects a menu action to search building names, view recent searches, or count and filter buildings by category. Search and statistics read the campus-location array; the array contains Location objects. Route planning is listed as a future module but its menu action is currently a no-op. The map reflects the sampled runtime files; planned roadmap modules are not implemented.

Main entry points: [`sandbox/main.py`](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py) (Main menu), [`sandbox/database.py`](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/database.py) (Campus locations), [`sandbox/models.py`](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/models.py) (Location model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Console interaction"]
  node_menu["Main menu<br/>[main.py]"]
end

subgraph group_features["Directory features"]
  node_search["Building search<br/>[main.py]"]
  node_history["Search history<br/>[main.py]"]
  node_stats["Building stats<br/>[main.py]"]
end

subgraph group_data["Campus data"]
  node_locations[("Campus locations<br/>[database.py]")]
  node_location["Location model<br/>[models.py]"]
end

node_user(("User"))

node_user -->|"selects action"| node_menu
node_menu -->|"dispatches to"| node_search
node_menu -->|"dispatches to"| node_history
node_menu -->|"dispatches to"| node_stats
node_search -->|"searches"| node_locations
node_stats -->|"filters and counts"| node_locations
node_locations -->|"creates entries"| node_location

click node_menu "https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py"
click node_search "https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py"
click node_history "https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py"
click node_stats "https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py"
click node_locations "https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/database.py"
click node_location "https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/models.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_menu,node_user toneBlue
class node_search,node_history,node_stats toneAmber
class node_locations,node_location toneMint
```

## Components

### Console interaction

- [Main menu](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py): `sandbox/main.py`

### Directory features

- [Building search](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py): `sandbox/main.py`
- [Search history](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py): `sandbox/main.py`
- [Building stats](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/main.py): `sandbox/main.py`

### Campus data

- [Campus locations](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/database.py): `sandbox/database.py`
- [Location model](https://github.com/devmatt-hmm/campus-navigation-system/blob/main/sandbox/models.py): `sandbox/models.py`

### Other components

- **User**

## Connections

- User → Main menu: selects action (evidence: `sandbox/main.py`)
- Main menu → Building search: dispatches to (evidence: `sandbox/main.py`)
- Main menu → Search history: dispatches to (evidence: `sandbox/main.py`)
- Main menu → Building stats: dispatches to (evidence: `sandbox/main.py`)
- Building search → Campus locations: searches (evidence: `sandbox/main.py`)
- Building stats → Campus locations: filters and counts (evidence: `sandbox/main.py`)
- Campus locations → Location model: creates entries (evidence: `sandbox/database.py`)
