# luisabeccar/anemias_r architecture

> Architecture diagram of the GitHub repository luisabeccar/anemias_r, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luisabeccar/anemias_r
- Repository: https://github.com/luisabeccar/anemias_r

## Overview

##### Project Type and Purpose
- This is an R-based data‐analysis pipeline focused on processing clinical/anemia documents, performing word counts and patient‐decision analyses, then generating summary reports.
- There is no web UI or database; instead it’s a batch ETL + analytics + reporting tool implemented as a set of R scripts.

##### High‐Level Architectural Components
a. Data Sources
– Raw DOCX files (clinical notes, epicrisis)
b. Ingestion & Preprocessing
– docx_a_txt.R: converts DOCX → plain text
– contar_palabras_todo.R: counts words across all texts
c. Core Analysis
– analisis_resultados.R: performs main statistical/clinical analyses
– decision_pacientes_02.R: applies business rules / patient‐decision logic
– funciones.R: shared helper functions used by multiple analysis scripts
d. Orchestration
– ejecutar.R / ejecutar_2.R: pipeline drivers that call the above modules in sequence
e. Reporting
– generar_reporte.R / generar_reporte_2.R: assemble results into final reports
– docx or other target formats (e.g., Word/PDF)
f. Configuration & Dependencies
– librerias.R: installs or loads required R packages
– PaulaAnemias.Rproj: RStudio project settings
– scripts_viejos/: archival scripts (for reference)

##### Interactions and Data Flow
- Raw DOCX → docx_a_txt.R → text files
- Text files → contar_palabras_todo.R → word‐count tables
- Word‐count tables + definitions → analisis_resultados.R → intermediate result datasets
- Intermediate datasets → decision_pacientes_02.R → flagged patient decisions
- All intermediate results → generar_reporte(.R) → final reports
- ejecutar(.R) orchestrates the full chain
- librerias.R is sourced at the start of each script to ensure dependencies

##### Architectural Patterns & Principles
- Pipeline pattern: linear ETL + analysis + reporting stages
- Modular scripts: each R file is a reusable component (single responsibility)
- Orchestrator scripts drive reproducibility and ordering
- Separation of concerns: ingestion vs analysis vs reporting

##### Detailed Elements
- Title: “Anemias_R Processing Pipeline”
[librerias.R] → [docx_a_txt.R] → [contar_palabras_todo.R] →
[analisis_resultados.R] → [decision_pacientes_02.R] → [generar_reporte.R]

## Diagram (Mermaid)

```mermaid
flowchart TD
    title["Anemias_R Processing Pipeline"]

    subgraph "Master Orchestrator" 
        MO["ejecutar.R / ejecutar_2.R"]:::orchestrator
    end

    subgraph "Configuration & Dependencies"
        LIB["librerias.R"]:::config
        PROJ["PaulaAnemias.Rproj"]:::config
    end

    subgraph "Ingestion & Preprocessing"
        A["docx_a_txt.R\n(convert DOCX → TXT)"]:::ingestion
        B["contar_palabras_todo.R\n(word count)"]:::ingestion
    end

    subgraph "Core Analysis"
        F["funciones.R"]:::helper
        C["analisis_resultados.R\n(statistical analysis)"]:::analysis
        D["decision_pacientes_02.R\n(apply patient rules)"]:::analysis
    end

    subgraph "Reporting"
        E1["generar_reporte.R\n(final reports)"]:::reporting
        E2["generar_reporte_2.R\n(final reports)"]:::reporting
    end

    subgraph "Archive (scripts_viejos)"
        ARCH["scripts_viejos/"]:::archive
    end

    DS_RAW["Raw DOCX Files"]:::data
    DS_INT["Intermediate Data Tables"]:::data
    DS_OUT["Final Reports"]:::data

    MO -->|orchestrates| LIB
    LIB --> A
    A -->|plain_text| B
    B -->|word_count.csv| DS_INT
    B --> C
    C -->|intermediate_results| D
    D -->|flagged_patients| DS_INT
    D --> E1
    D --> E2
    E1 -->|reports| DS_OUT
    E2 -->|reports| DS_OUT

    DSC --> ARCH

    MO --> ARCH
    MO --> PROJ
    MO --> README["README.md"]:::doc

    click LIB "https://github.com/luisabeccar/anemias_r/blob/main/librerias.R"
    click MO "https://github.com/luisabeccar/anemias_r/blob/main/ejecutar.R"
    click MO "https://github.com/luisabeccar/anemias_r/blob/main/ejecutar_2.R"
    click A "https://github.com/luisabeccar/anemias_r/blob/main/docx_a_txt.R"
    click B "https://github.com/luisabeccar/anemias_r/blob/main/contar_palabras_todo.R"
    click C "https://github.com/luisabeccar/anemias_r/blob/main/analisis_resultados.R"
    click D "https://github.com/luisabeccar/anemias_r/blob/main/decision_pacientes_02.R"
    click F "https://github.com/luisabeccar/anemias_r/blob/main/funciones.R"
    click E1 "https://github.com/luisabeccar/anemias_r/blob/main/generar_reporte.R"
    click E2 "https://github.com/luisabeccar/anemias_r/blob/main/generar_reporte_2.R"
    click PROJ "https://github.com/luisabeccar/anemias_r/blob/main/PaulaAnemias.Rproj"
    click ARCH "https://github.com/luisabeccar/anemias_r/tree/main/scripts_viejos/"
    click README "https://github.com/luisabeccar/anemias_r/blob/main/README.md"

    classDef ingestion fill:#cfe2f3,stroke:#0353a4,color:#0353a4;
    classDef analysis fill:#d9ead3,stroke:#38761d,color:#38761d;
    classDef reporting fill:#fce5cd,stroke:#b45f06,color:#b45f06;
    classDef orchestrator fill:#d9d2e9,stroke:#674ea7,color:#674ea7;
    classDef config fill:#eeeeee,stroke:#888888,color:#333333;
    classDef helper fill:#fff2cc,stroke:#bf9000,color:#bf9000;
    classDef data fill:#ffffff,stroke:#000000,stroke-width:2px,shape:cylinder;
    classDef archive fill:#f4cccc,stroke:#a61c00,color:#a61c00;
    classDef doc fill:#d0e0e3,stroke:#0b5394,color:#0b5394;
```
