# samudralaajaykumarrr/ai-assisted-living-finder architecture

> Architecture diagram of the GitHub repository samudralaajaykumarrr/ai-assisted-living-finder, 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/samudralaajaykumarrr/ai-assisted-living-finder
- Repository: https://github.com/samudralaajaykumarrr/ai-assisted-living-finder

## Overview

This Streamlit prototype helps families compare assisted-living facilities: it loads facility data from a Google Sheet, normalizes columns and estimates monthly costs, then filters results and presents matches, summary metrics, and downloadable or raw data. The stages are implemented together in app.py; the graph separates them by responsibility, not by module. The README describes a blank-app template, while the sampled source shows this finder workflow.

Main entry points: [`app.py`](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py) (Facility filters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Facility data"]
  node_sheet[("Facility spreadsheet")]
  node_cleanup["Column cleanup<br/>[app.py]"]
  node_cost["Cost estimates<br/>[app.py]"]
end

subgraph group_workflow["Finder workflow"]
  node_finder["Streamlit finder<br/>[app.py]"]
  node_filters["Facility filters<br/>[app.py]"]
end

subgraph group_outputs["Results and export"]
  node_matches["Top matches<br/>[app.py]"]
  node_metrics["Summary metrics<br/>[app.py]"]
  node_download["CSV download<br/>[app.py]"]
  node_raw["Raw data view<br/>[app.py]"]
end

node_family(("Family member"))

node_family -->|"uses"| node_finder
node_finder -->|"reads CSV"| node_sheet
node_finder -->|"cleans columns"| node_cleanup
node_cleanup -->|"estimates costs"| node_cost
node_cost -->|"filters data"| node_filters
node_filters -->|"displays"| node_matches
node_filters -->|"summarizes"| node_metrics
node_filters -->|"exports CSV"| node_download
node_filters -->|"displays"| node_raw

click node_finder "https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py"
click node_cleanup "https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py"
click node_cost "https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py"
click node_filters "https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py"
click node_matches "https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py"
click node_metrics "https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py"
click node_download "https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py"
click node_raw "https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.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_sheet,node_cleanup,node_cost toneBlue
class node_finder,node_filters toneAmber
class node_matches,node_metrics,node_download,node_raw toneMint
class node_family toneIndigo
```

## Components

### Facility data

- **Facility spreadsheet**
- [Column cleanup](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py): `app.py`
- [Cost estimates](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py): `app.py`

### Finder workflow

- [Streamlit finder](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py): `app.py`
- [Facility filters](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py): `app.py`

### Results and export

- [Top matches](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py): `app.py`
- [Summary metrics](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py): `app.py`
- [CSV download](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py): `app.py`
- [Raw data view](https://github.com/samudralaajaykumarrr/ai-assisted-living-finder/blob/main/app.py): `app.py`

### Other components

- **Family member**

## Connections

- Family member → Streamlit finder: uses (evidence: `app.py`)
- Streamlit finder → Facility spreadsheet: reads CSV (evidence: `app.py`)
- Streamlit finder → Column cleanup: cleans columns (evidence: `app.py`)
- Column cleanup → Cost estimates: estimates costs (evidence: `app.py`)
- Cost estimates → Facility filters: filters data (evidence: `app.py`)
- Facility filters → Top matches: displays (evidence: `app.py`)
- Facility filters → Summary metrics: summarizes (evidence: `app.py`)
- Facility filters → CSV download: exports CSV (evidence: `app.py`)
- Facility filters → Raw data view: displays (evidence: `app.py`)
