# redward42/comprecommendation architecture

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

- Interactive diagram: https://gitdiagram.com/redward42/comprecommendation
- Repository: https://github.com/redward42/comprecommendation

## Overview

This is a small, notebook-based real-estate analysis project. A user runs the notebook against the JSON appraisal dataset; the documented analysis parses and flattens nested data, geocodes addresses, visualizes property locations and features, and prepares data for modeling and clustering. The README documents these capabilities but no source excerpts were provided, so the graph represents only those documented relationships and does not infer specific libraries, services, or implementation details.

Main entry points: [`analysis.ipynb`](https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb) (Analysis notebook), [`appraisals_dataset.json`](https://github.com/RedWARd42/CompRecommendation/blob/main/appraisals_dataset.json) (Appraisal data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Analysis input"]
  node_dataset["Appraisal data"]
end

subgraph group_analysis["Notebook analysis"]
  node_notebook["Analysis notebook<br/>[analysis.ipynb]"]
  node_flatten["Parse and flatten<br/>[analysis.ipynb]"]
  node_geocode["Geocode addresses<br/>[analysis.ipynb]"]
end

subgraph group_outputs["Analysis outputs"]
  node_visualize["Visualize properties<br/>[analysis.ipynb]"]
  node_prepare["Prepare modeling data<br/>[analysis.ipynb]"]
end

node_user(("Analyst"))

node_user -->|"runs"| node_notebook
node_dataset -->|"provides data"| node_notebook
node_notebook -->|"parses and flattens"| node_flatten
node_notebook -->|"geocodes"| node_geocode
node_notebook -->|"visualizes"| node_visualize
node_notebook -->|"prepares data"| node_prepare

click node_dataset "https://github.com/RedWARd42/CompRecommendation/blob/main/appraisals_dataset.json"
click node_notebook "https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb"
click node_flatten "https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb"
click node_geocode "https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb"
click node_visualize "https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb"
click node_prepare "https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb"

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_dataset toneBlue
class node_notebook,node_flatten,node_geocode toneAmber
class node_visualize,node_prepare toneMint
class node_user toneIndigo
```

## Components

### Analysis input

- [Appraisal data](https://github.com/RedWARd42/CompRecommendation/blob/main/appraisals_dataset.json): `appraisals_dataset.json`

### Notebook analysis

- [Analysis notebook](https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb): `analysis.ipynb`
- [Parse and flatten](https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb): `analysis.ipynb`
- [Geocode addresses](https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb): `analysis.ipynb`

### Analysis outputs

- [Visualize properties](https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb): `analysis.ipynb`
- [Prepare modeling data](https://github.com/RedWARd42/CompRecommendation/blob/main/analysis.ipynb): `analysis.ipynb`

### Other components

- **Analyst**

## Connections

- Analyst → Analysis notebook: runs (evidence: `README.md`)
- Appraisal data → Analysis notebook: provides data (evidence: `README.md`)
- Analysis notebook → Parse and flatten: parses and flattens (evidence: `README.md`)
- Analysis notebook → Geocode addresses: geocodes (evidence: `README.md`)
- Analysis notebook → Visualize properties: visualizes (evidence: `README.md`)
- Analysis notebook → Prepare modeling data: prepares data (evidence: `README.md`)
