# archd3sai/customer-survival-analysis-and-churn-prediction architecture

> Architecture diagram of the GitHub repository archd3sai/customer-survival-analysis-and-churn-prediction, 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/archd3sai/customer-survival-analysis-and-churn-prediction
- Repository: https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction

## Overview

This repository is a Flask customer churn and survival-analysis app. A user submits customer details; the app prepares model features, predicts churn, explains the prediction, estimates hazard, survival and lifetime value, then renders the results. The notebooks document exploratory analysis and model development as separate project stages. The README describes additional analysis capabilities; unsampled notebook internals and static assets are represented only at the level supported by the tree and documentation.

Main entry points: [`app.py`](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py) (Flask routes), [`survivemodel.pkl`](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/survivemodel.pkl) (Cox model), [`templates/index.html`](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/templates/index.html) (Input form), [`Churn Prediction Model.ipynb`](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/Churn%20Prediction%20Model.ipynb) (Churn modeling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Web application"]
  node_flask["Flask routes<br/>[app.py]"]
  node_form["Input form<br/>[index.html]"]
  node_results["Result display<br/>[index.html]"]
  node_plots["App plots"]
end

subgraph group_prediction["Churn prediction"]
  node_features["Feature preparation<br/>[app.py]"]
  node_classifier["Churn classifier<br/>[model.pkl]"]
  node_explanation["SHAP explanation<br/>[app.py]"]
  node_explainer["SHAP explainer<br/>[explainer.bz2]"]
end

subgraph group_survival["Survival analysis"]
  node_survival_model["Cox model<br/>[survivemodel.pkl]"]
  node_hazard["Hazard curve<br/>[app.py]"]
  node_survival_curve["Survival curve<br/>[app.py]"]
  node_lifetime["Lifetime value<br/>[app.py]"]
end

subgraph group_analysis["Project analysis"]
  node_eda["Exploratory analysis"]
  node_churn_modeling["Churn modeling"]
  node_survival_study["Survival study"]
end

node_user(("Customer"))

node_user -->|"enters details"| node_form
node_form -.->|"submits form"| node_flask
node_flask -->|"renders page"| node_form
node_flask -->|"prepares features"| node_features
node_flask -->|"loads and predicts"| node_classifier
node_flask -->|"builds explanation"| node_explanation
node_explanation -->|"loads explainer"| node_explainer
node_flask -->|"loads model"| node_survival_model
node_flask -->|"plots hazard"| node_hazard
node_hazard -->|"predicts hazard"| node_survival_model
node_flask -->|"plots survival"| node_survival_curve
node_survival_curve -->|"predicts survival"| node_survival_model
node_flask -->|"estimates value"| node_lifetime
node_lifetime -->|"predicts survival"| node_survival_model
node_flask -->|"renders results"| node_results
node_flask -.->|"embeds plots"| node_plots
node_eda -.->|"informs modeling"| node_churn_modeling
node_survival_study -.->|"develops model"| node_survival_model
node_churn_modeling -.->|"develops model"| node_classifier

click node_flask "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py"
click node_form "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/templates/index.html"
click node_features "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py"
click node_classifier "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/model.pkl"
click node_explanation "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py"
click node_explainer "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/explainer.bz2"
click node_survival_model "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/survivemodel.pkl"
click node_hazard "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py"
click node_survival_curve "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py"
click node_lifetime "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py"
click node_results "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/templates/index.html"
click node_eda "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/Exploratory%20Data%20Analysis.ipynb"
click node_churn_modeling "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/Churn%20Prediction%20Model.ipynb"
click node_survival_study "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/Customers%20Survival%20Analysis.ipynb"
click node_plots "https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/tree/master/static/images"

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_flask,node_form,node_results,node_plots toneBlue
class node_features,node_classifier,node_explanation,node_explainer toneAmber
class node_survival_model,node_hazard,node_survival_curve,node_lifetime toneMint
class node_eda,node_churn_modeling,node_survival_study toneRose
class node_user toneIndigo
```

## Components

### Web application

- [Flask routes](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py): `app.py`
- [Input form](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/templates/index.html): `templates/index.html`
- [Result display](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/templates/index.html): `templates/index.html`
- [App plots](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/tree/master/static/images): `static/images`

### Churn prediction

- [Feature preparation](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py): `app.py`
- [Churn classifier](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/model.pkl): `model.pkl`
- [SHAP explanation](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py): `app.py`
- [SHAP explainer](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/explainer.bz2): `explainer.bz2`

### Survival analysis

- [Cox model](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/survivemodel.pkl): `survivemodel.pkl`
- [Hazard curve](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py): `app.py`
- [Survival curve](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py): `app.py`
- [Lifetime value](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/app.py): `app.py`

### Project analysis

- [Exploratory analysis](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/Exploratory%20Data%20Analysis.ipynb): `Exploratory Data Analysis.ipynb`
- [Churn modeling](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/Churn%20Prediction%20Model.ipynb): `Churn Prediction Model.ipynb`
- [Survival study](https://github.com/archd3sai/customer-survival-analysis-and-churn-prediction/blob/master/Customers%20Survival%20Analysis.ipynb): `Customers Survival Analysis.ipynb`

### Other components

- **Customer**

## Connections

- Customer → Input form: enters details (evidence: `README.md`)
- Input form → Flask routes: submits form
- Flask routes → Input form: renders page (evidence: `app.py`)
- Flask routes → Feature preparation: prepares features (evidence: `app.py`)
- Flask routes → Churn classifier: loads and predicts (evidence: `app.py`)
- Flask routes → SHAP explanation: builds explanation (evidence: `app.py`)
- SHAP explanation → SHAP explainer: loads explainer (evidence: `app.py`)
- Flask routes → Cox model: loads model (evidence: `app.py`)
- Flask routes → Hazard curve: plots hazard (evidence: `app.py`)
- Hazard curve → Cox model: predicts hazard (evidence: `app.py`)
- Flask routes → Survival curve: plots survival (evidence: `app.py`)
- Survival curve → Cox model: predicts survival (evidence: `app.py`)
- Flask routes → Lifetime value: estimates value (evidence: `app.py`)
- Lifetime value → Cox model: predicts survival (evidence: `app.py`)
- Flask routes → Result display: renders results (evidence: `app.py`)
- Flask routes → App plots: embeds plots
- Exploratory analysis → Churn modeling: informs modeling
- Survival study → Cox model: develops model (evidence: `README.md`)
- Churn modeling → Churn classifier: develops model (evidence: `README.md`)
