# ubc-mds-2026-27/dsci-522-group-38 architecture

> Architecture diagram of the GitHub repository ubc-mds-2026-27/dsci-522-group-38, 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/ubc-mds-2026-27/dsci-522-group-38
- Repository: https://github.com/ubc-mds-2026-27/dsci-522-group-38

## Overview

This repository is a reproducible analysis project estimating elapsed days from Vancouver permit-number creation to first issuance—not a production wait-time service. Its principal workflow uses a saved raw permit snapshot, prepares selected modeling data, compares linear regression with a mean-predicting dummy baseline, and reports held-out and cross-validation results. The README documents these stages and the report’s optional download behavior; the report source was not excerpted, so internal implementation details and calls cannot be verified.

Main entry points: [`analysis/permit-processing-time-prediction.qmd`](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd) (Permit analysis report), [`data/raw/raw_data.csv`](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/data/raw/raw_data.csv) (Raw permit snapshot), [`data/processed/model_input.csv`](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/data/processed/model_input.csv) (Selected model data), [`analysis/permit-processing-time-prediction.html`](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.html) (Rendered report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Permit data"]
  node_raw[("Raw permit snapshot<br/>[raw_data.csv]")]
  node_modeldata[("Selected model data<br/>[model_input.csv]")]
end

subgraph group_analysis["Analysis workflow"]
  node_report["Permit analysis report"]
  node_preparation["Feature preparation"]
  node_validation["Split and cross-validation"]
  node_models["Regression comparison"]
  node_metrics["Model evaluation"]
end

subgraph group_outputs["Analysis outputs"]
  node_rendered["Rendered report"]
end

node_city["City data portal"]

node_city -.->|"supplies if missing"| node_raw
node_raw -->|"reads snapshot"| node_report
node_report -->|"writes selected data"| node_modeldata
node_report -->|"prepares features"| node_preparation
node_preparation -->|"feeds evaluation split"| node_validation
node_validation -->|"evaluates models"| node_models
node_models -->|"compares predictions"| node_metrics
node_report -->|"renders report"| node_rendered

click node_raw "https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/data/raw/raw_data.csv"
click node_report "https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd"
click node_modeldata "https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/data/processed/model_input.csv"
click node_preparation "https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd"
click node_validation "https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd"
click node_models "https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd"
click node_metrics "https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd"
click node_rendered "https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.html"

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_raw,node_modeldata toneBlue
class node_report,node_preparation,node_validation,node_models,node_metrics toneAmber
class node_rendered toneMint
class node_city toneIndigo
```

## Components

### Permit data

- [Raw permit snapshot](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/data/raw/raw_data.csv): `data/raw/raw_data.csv`
- [Selected model data](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/data/processed/model_input.csv): `data/processed/model_input.csv`

### Analysis workflow

- [Permit analysis report](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd): `analysis/permit-processing-time-prediction.qmd`
- [Feature preparation](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd): `analysis/permit-processing-time-prediction.qmd`
- [Split and cross-validation](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd): `analysis/permit-processing-time-prediction.qmd`
- [Regression comparison](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd): `analysis/permit-processing-time-prediction.qmd`
- [Model evaluation](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.qmd): `analysis/permit-processing-time-prediction.qmd`

### Analysis outputs

- [Rendered report](https://github.com/ubc-mds-2026-27/dsci-522-group-38/blob/main/analysis/permit-processing-time-prediction.html): `analysis/permit-processing-time-prediction.html`

### Other components

- **City data portal**

## Connections

- City data portal → Raw permit snapshot: supplies if missing (evidence: `README.md`)
- Raw permit snapshot → Permit analysis report: reads snapshot (evidence: `README.md`)
- Permit analysis report → Selected model data: writes selected data (evidence: `README.md`)
- Permit analysis report → Feature preparation: prepares features (evidence: `README.md`)
- Feature preparation → Split and cross-validation: feeds evaluation split (evidence: `README.md`)
- Split and cross-validation → Regression comparison: evaluates models (evidence: `README.md`)
- Regression comparison → Model evaluation: compares predictions (evidence: `README.md`)
- Permit analysis report → Rendered report: renders report (evidence: `README.md`)
