# roobeerr13/memorando-interno---m-xima-urgencia---chronologistics architecture

> Architecture diagram of the GitHub repository roobeerr13/memorando-interno---m-xima-urgencia---chronologistics, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics
- Repository: https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics

## Overview

##### Project type and purpose
- This is a single-page interactive web application built with Streamlit (Python 3.9+).
- Purpose: Real-time crisis dashboard (“ChronoLogistics Crisis Dashboard”) with three functional tabs (Precog, Chronos, K-Lang) for risk monitoring, scenario simulation, and emergency protocol activation.

##### File structure
- Top-level
- app.py – Streamlit entry point
- precog.py – Risk-prediction engine
- protocols.json – Emergency protocol definitions
- dashboard/
- precog_tab.py, chronos_tab.py, klang_tab.py – UI controllers for each dashboard tab
- utils.py – Shared helper functions (data loading, plotting)
- requirements.txt – Dependencies (Streamlit, etc.)

##### README for additional insights
- Three tabs with distinct responsibilities:
- Precog: heatmap, real-time risk simulation
- Chronos: future-vision selector + GAN-generated imagery
- K-Lang: protocol selector + conditional simulator
- Business logic: `predecir_riesgo()` in precog.py
- Protocol triggers defined in protocols.json
- No external database: data and assets are local JSON/images

## Diagram (Mermaid)

```mermaid
flowchart TD
    User["User (Web Browser)"]:::external
    Server["Streamlit Server (app.py)"]:::server

    subgraph "UI Layer"
        PrecogTab["Precog Tab Controller"]:::ui
        ChronosTab["Chronos Tab Controller"]:::ui
        KLangTab["K-Lang Tab Controller"]:::ui
        UtilsUI["Shared UI Helpers"]:::ui
    end

    subgraph "Logic Layer"
        RiskEngine["Risk Engine\n(predecir_riesgo)"]:::logic
        ScenarioGen["Scenario Generator"]:::logic
        ProtocolEngine["Protocol Engine"]:::logic
    end

    subgraph "Data & Config Layer"
        Protocols["protocols.json"]:::data
        Images["Static Images (GAN Outputs)"]:::data
        requir["requirements.txt"]:::data
        README["README.md"]:::data
    end

    %% Relationships
    User <-->|"HTTP/WebSocket"| Server
    Server -->|"invokes UI controllers"| PrecogTab
    Server -->|"invokes UI controllers"| ChronosTab
    Server -->|"invokes UI controllers"| KLangTab

    PrecogTab -->|"calls risk engine"| RiskEngine
    ChronosTab -->|"calls scenario generator"| ScenarioGen
    KLangTab -->|"calls protocol engine"| ProtocolEngine

    PrecogTab -->|"uses helpers"| UtilsUI
    ChronosTab -->|"uses helpers"| UtilsUI
    KLangTab -->|"uses helpers"| UtilsUI
    ProtocolEngine -->|"uses loader helpers"| UtilsUI

    RiskEngine -->|"loads data/config"| Protocols
    ProtocolEngine -->|"reads definitions"| Protocols
    ScenarioGen -->|"retrieves images"| Images

    %% Click Events
    click Server "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/app.py"
    click PrecogTab "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/dashboard/precog_tab.py"
    click ChronosTab "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/dashboard/chronos_tab.py"
    click KLangTab "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/dashboard/klang_tab.py"
    click UtilsUI "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/dashboard/utils.py"
    click RiskEngine "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/precog.py"
    click Protocols "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/protocols.json"
    click requir "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/requirements.txt"
    click README "https://github.com/roobeerr13/memorando-interno---m-xima-urgencia---chronologistics/blob/main/README.md"

    %% Styles
    classDef external fill:#f2f2f2,stroke:#333,stroke-width:1px,color:#333;
    classDef server fill:#cce5ff,stroke:#004085,stroke-width:1px,color:#004085;
    classDef ui fill:#e2f0ff,stroke:#2b6cb0,stroke-width:1px,color:#2b6cb0;
    classDef logic fill:#d4edda,stroke:#155724,stroke-width:1px,color:#155724;
    classDef data fill:#fff3cd,stroke:#856404,stroke-width:1px,color:#856404;
```
