# jaypatel1511/nmtc-application-builder architecture

> Architecture diagram of the GitHub repository jaypatel1511/nmtc-application-builder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jaypatel1511/nmtc-application-builder
- Repository: https://github.com/jaypatel1511/nmtc-application-builder

## Overview

NMTC Application Builder helps CDE teams assess and prepare competitive New Markets Tax Credit allocation applications. The main workflow is to provide a CDE profile and project pipeline, analyze and validate them, review alignment scores and recommendations, optionally optimize the project subset, then generate application drafts. The repository also exposes a Streamlit analyzer and CLI, eligibility enrichment integrations, and geographic visualizations. Several analysis and rendering modules are documented but unsampled; those branches are represented at their known subsystem paths, with links limited to documented or indexed relationships.

Main entry points: [`nmtcapp/core/application.py`](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/application.py) (Application), [`nmtcapp/intelligence/pipeline_analyzer.py`](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/pipeline_analyzer.py) (Pipeline Analysis), [`nmtcapp/core/pipeline.py`](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/pipeline.py) (Project Pipeline), [`streamlit_app/pages/1_Pipeline_Analyzer.py`](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/streamlit_app/pages/1_Pipeline_Analyzer.py) (Pipeline Analyzer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_streamlit["Streamlit App<br/>[app.py]"]
  node_analyzer_page["Pipeline Analyzer"]
  node_cli["Command Line<br/>[cli.py]"]
end

subgraph group_core["Application Core"]
  node_application["Application<br/>[application.py]"]
  node_cde_profile["CDE Profile<br/>[cde.py]"]
  node_pipeline["Project Pipeline<br/>[pipeline.py]"]
  node_schema["Domain Schema<br/>[schema.py]"]
  node_upload["Upload Handler<br/>[upload_handler.py]"]
end

subgraph group_intelligence["Pipeline Intelligence"]
  node_analyzer["Pipeline Analysis"]
  node_distress["Distress Analysis"]
  node_geo["Geographic Analysis"]
  node_sector["Sector Analysis<br/>[sector_analysis.py]"]
  node_impact["Impact Analysis"]
  node_win_score["Alignment Scoring<br/>[win_probability.py]"]
  node_recommendations["Recommendations<br/>[recommendations.py]"]
end

subgraph group_decision["Validation &amp; Optimization"]
  node_validation["Application Validation"]
  node_optimizer["Pipeline Optimizer"]
end

subgraph group_outputs["Application Outputs"]
  node_visualization["Geographic Visuals<br/>[maps.py]"]
  node_renderers["Document Renderers"]
end

node_cde_user(("CDE Applicant"))

node_cde_user -->|"uses"| node_streamlit
node_cde_user -->|"runs"| node_cli
node_streamlit -.->|"offers"| node_analyzer_page
node_analyzer_page -->|"uses"| node_application
node_analyzer_page -->|"imports"| node_upload
node_cli -->|"uses"| node_application
node_cli -->|"loads"| node_pipeline
node_application -->|"accepts"| node_cde_profile
node_application -->|"accepts"| node_pipeline
node_pipeline -->|"uses"| node_schema
node_upload -->|"creates"| node_pipeline
node_application -->|"analyzes"| node_analyzer
node_analyzer -->|"uses"| node_distress
node_analyzer -->|"uses"| node_geo
node_analyzer -->|"uses"| node_sector
node_analyzer -->|"uses"| node_impact
node_application -->|"scores"| node_win_score
node_application -->|"requests"| node_recommendations
node_application -->|"validates"| node_validation
node_application -->|"optimizes"| node_optimizer
node_application -->|"generates drafts"| node_renderers
node_application -.->|"supports maps"| node_visualization
node_renderers -->|"uses"| node_schema
node_renderers -->|"renders tables"| node_distress

click node_streamlit "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/streamlit_app/app.py"
click node_analyzer_page "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/streamlit_app/pages/1_Pipeline_Analyzer.py"
click node_cli "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/cli.py"
click node_application "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/application.py"
click node_cde_profile "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/cde.py"
click node_pipeline "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/pipeline.py"
click node_schema "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/data/schema.py"
click node_upload "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/upload_handler.py"
click node_analyzer "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/pipeline_analyzer.py"
click node_distress "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/distress_analysis.py"
click node_geo "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/geographic_analysis.py"
click node_sector "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/sector_analysis.py"
click node_impact "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/impact_aggregator.py"
click node_win_score "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/win_probability.py"
click node_recommendations "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/recommendations.py"
click node_validation "https://github.com/jaypatel1511/nmtc-application-builder/tree/main/nmtcapp/validation"
click node_optimizer "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/optimizer/pipeline_optimizer.py"
click node_visualization "https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/visualization/maps.py"
click node_renderers "https://github.com/jaypatel1511/nmtc-application-builder/tree/main/nmtcapp/renderers"

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_streamlit,node_analyzer_page,node_cli toneBlue
class node_application,node_cde_profile,node_pipeline,node_schema,node_upload toneAmber
class node_analyzer,node_distress,node_geo,node_sector,node_impact,node_win_score,node_recommendations toneMint
class node_validation,node_optimizer toneRose
class node_visualization,node_renderers,node_cde_user toneIndigo
```

## Components

### User Experience

- [Streamlit App](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/streamlit_app/app.py): `streamlit_app/app.py`
- [Pipeline Analyzer](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/streamlit_app/pages/1_Pipeline_Analyzer.py): `streamlit_app/pages/1_Pipeline_Analyzer.py`
- [Command Line](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/cli.py): `nmtcapp/cli.py`

### Application Core

- [Application](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/application.py): `nmtcapp/core/application.py`
- [CDE Profile](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/cde.py): `nmtcapp/core/cde.py`
- [Project Pipeline](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/pipeline.py): `nmtcapp/core/pipeline.py`
- [Domain Schema](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/data/schema.py): `nmtcapp/data/schema.py`
- [Upload Handler](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/core/upload_handler.py): `nmtcapp/core/upload_handler.py`

### Pipeline Intelligence

- [Pipeline Analysis](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/pipeline_analyzer.py): `nmtcapp/intelligence/pipeline_analyzer.py`
- [Distress Analysis](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/distress_analysis.py): `nmtcapp/intelligence/distress_analysis.py`
- [Geographic Analysis](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/geographic_analysis.py): `nmtcapp/intelligence/geographic_analysis.py`
- [Sector Analysis](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/sector_analysis.py): `nmtcapp/intelligence/sector_analysis.py`
- [Impact Analysis](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/impact_aggregator.py): `nmtcapp/intelligence/impact_aggregator.py`
- [Alignment Scoring](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/win_probability.py): `nmtcapp/intelligence/win_probability.py`
- [Recommendations](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/intelligence/recommendations.py): `nmtcapp/intelligence/recommendations.py`

### Validation & Optimization

- [Application Validation](https://github.com/jaypatel1511/nmtc-application-builder/tree/main/nmtcapp/validation): `nmtcapp/validation`
- [Pipeline Optimizer](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/optimizer/pipeline_optimizer.py): `nmtcapp/optimizer/pipeline_optimizer.py`

### Application Outputs

- [Geographic Visuals](https://github.com/jaypatel1511/nmtc-application-builder/blob/main/nmtcapp/visualization/maps.py): `nmtcapp/visualization/maps.py`
- [Document Renderers](https://github.com/jaypatel1511/nmtc-application-builder/tree/main/nmtcapp/renderers): `nmtcapp/renderers`

### Other components

- **CDE Applicant**

## Connections

- CDE Applicant → Streamlit App: uses (evidence: `README.md`)
- CDE Applicant → Command Line: runs (evidence: `README.md`)
- Streamlit App → Pipeline Analyzer: offers
- Pipeline Analyzer → Application: uses (evidence: `streamlit_app/pages/1_Pipeline_Analyzer.py`)
- Pipeline Analyzer → Upload Handler: imports (evidence: `streamlit_app/pages/1_Pipeline_Analyzer.py`)
- Command Line → Application: uses (evidence: `nmtcapp/cli.py`)
- Command Line → Project Pipeline: loads (evidence: `nmtcapp/cli.py`)
- Application → CDE Profile: accepts (evidence: `nmtcapp/core/application.py`)
- Application → Project Pipeline: accepts (evidence: `nmtcapp/core/application.py`)
- Project Pipeline → Domain Schema: uses (evidence: `nmtcapp/core/pipeline.py`)
- Upload Handler → Project Pipeline: creates (evidence: `nmtcapp/core/upload_handler.py`)
- Application → Pipeline Analysis: analyzes (evidence: `nmtcapp/core/application.py`)
- Pipeline Analysis → Distress Analysis: uses (evidence: `nmtcapp/intelligence/pipeline_analyzer.py`)
- Pipeline Analysis → Geographic Analysis: uses (evidence: `nmtcapp/intelligence/pipeline_analyzer.py`)
- Pipeline Analysis → Sector Analysis: uses (evidence: `nmtcapp/intelligence/pipeline_analyzer.py`)
- Pipeline Analysis → Impact Analysis: uses (evidence: `nmtcapp/intelligence/pipeline_analyzer.py`)
- Application → Alignment Scoring: scores (evidence: `nmtcapp/core/application.py`)
- Application → Recommendations: requests (evidence: `nmtcapp/core/application.py`)
- Application → Application Validation: validates (evidence: `nmtcapp/core/application.py`)
- Application → Pipeline Optimizer: optimizes (evidence: `nmtcapp/core/application.py`)
- Application → Document Renderers: generates drafts (evidence: `README.md`)
- Application → Geographic Visuals: supports maps (evidence: `nmtcapp/visualization/maps.py`)
- Document Renderers → Domain Schema: uses (evidence: `nmtcapp/renderers/pdf_builder.py`)
- Document Renderers → Distress Analysis: renders tables (evidence: `nmtcapp/renderers/pdf_builder.py`)
