# darrindellwork/mini-process-miner architecture

> Architecture diagram of the GitHub repository darrindellwork/mini-process-miner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/darrindellwork/mini-process-miner
- Repository: https://github.com/darrindellwork/mini-process-miner

## Overview

##### Project type and purpose
- This is a lightweight, single-page, monolithic web application built with Streamlit.
- It provides a browser-based UI for process mining on user-uploaded event logs using PM4Py and pandas.
- All logic lives in app.py, with dependencies declared in requirements.txt/packages.txt.

##### File structure
- Top‐level files:
– app.py: the entry point (Streamlit app).
– Code/ (if present): extra Python modules called by app.py.
– requirements.txt & packages.txt: Python dependencies.
– runtime.txt: Python runtime version (for deployment on e.g., Heroku).
– README.md: project description.
– LICENSE: open source license.
- There are no separate “frontend” and “backend” directories—Streamlit handles UI & server in one process.
- No external database: input CSVs are read into memory, processed, and results streamed back to the browser.

##### README for additional insights
- Key features: process map (clean, frequency, performance), directly‐follows graph (DFG), filtering controls, sliders.
- Stack: Streamlit for UI, pandas for tabular data, PM4Py for process-mining algorithms.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User and Input
    User["User Browser"]:::ui
    CSV["CSV File Upload"]:::io

    %% Streamlit App Core
    subgraph "Streamlit App"
        direction TB
        AppServer["Streamlit App (app.py)"]:::app
        subgraph "Modules"
            direction TB
            Ingest["Data Ingestion Module\n(pandas CSV reader)"]:::processing
            Mining["Process Mining Engine\n(PM4Py integration)"]:::processing
            Viz["Visualization Module\n(Streamlit charts)"]:::ui
        end
        Store[(In-Memory Data Store)]:::store
    end

    %% External Dependencies
    subgraph "External Libraries"
        direction TB
        Pandas["pandas"]:::lib
        PM4PyLib["PM4Py"]:::lib
        StreamlitLib["Streamlit"]:::lib
    end

    %% Configuration & Docs
    Reqs["Dependencies Files\n(requirements.txt & packages.txt)"]:::config
    Runtime["Runtime Config\n(runtime.txt)"]:::config
    Docs["Project Documentation\n(README.md)"]:::doc
    License["License File\n(LICENSE)"]:::doc

    %% Connections
    User -->|HTTP Request / UI Interaction| AppServer
    User -->|Uploads CSV| CSV
    CSV -->|provides data to| Ingest
    AppServer -->|calls| Ingest
    Ingest -->|stores DataFrame in| Store
    AppServer -->|invokes| Mining
    Store -->|feeds DataFrame to| Mining
    Mining -->|outputs results to| Store
    AppServer -->|renders with| Viz
    Store -->|provides data to| Viz
    Viz -->|renders charts back to| User

    AppServer -->|imports| Pandas
    AppServer -->|imports| PM4PyLib
    AppServer -->|imports| StreamlitLib

    AppServer -->|depends on| Reqs
    AppServer -->|config via| Runtime
    AppServer -->|documented by| Docs
    AppServer -->|licensed under| License

    %% Click Events
    click AppServer "https://github.com/darrindellwork/mini-process-miner/blob/main/app.py"
    click Ingest "https://github.com/darrindellwork/mini-process-miner/tree/main/Code/"
    click Reqs "https://github.com/darrindellwork/mini-process-miner/blob/main/requirements.txt & packages.txt"
    click Runtime "https://github.com/darrindellwork/mini-process-miner/blob/main/runtime.txt"
    click Docs "https://github.com/darrindellwork/mini-process-miner/blob/main/README.md"
    click License "https://github.com/darrindellwork/mini-process-miner/tree/main/LICENSE"

    %% Styling
    classDef ui fill:#E0F7FA,stroke:#0288D1,color:#000
    classDef io fill:#FFF3E0,stroke:#FB8C00,color:#000
    classDef app fill:#BBDEFB,stroke:#1976D2,color:#000
    classDef processing fill:#C8E6C9,stroke:#388E3C,color:#000
    classDef store fill:#FFE0B2,stroke:#F57C00,color:#000
    classDef lib fill:#ECEFF1,stroke:#90A4AE,color:#000
    classDef config fill:#FFF9C4,stroke:#FBC02D,color:#000
    classDef doc fill:#F5F5F5,stroke:#BDBDBD,color:#000
```
