# eta-dt/agentic_analysis architecture

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

- Interactive diagram: https://gitdiagram.com/eta-dt/agentic_analysis
- Repository: https://github.com/eta-dt/agentic_analysis

## Overview

##### Main Components
- Entry Point: The file main.py is likely the starting point of the application.
- Core Analysis Module: The file agenticRAG.py is probably the key module that implements the “agentic” analysis logic or RAG functionality.
- Configuration Management: Files config.ini and .env show that configuration and environment variables are used. They should be represented as a configuration component accessed by the main application and core modules.
- Dependency Management: The requirements.txt file indicates external libraries and packages required by the system. While not a runtime component, it influences the technologies used.
- Development Environment: The .devcontainer folder (with its JSON) portrays the project’s containerized development configuration.
- Documentation and Specification: The “2024-Budget-Note de Cadrage.docx” and the “Documents RAG” directory hint at external documentation and perhaps other resources or sample data. Even if not part of the runtime system, their presence may influence the development and review processes.

##### Relationships and Interactions
- The main.py script likely initializes the application, loads configuration from config.ini and .env, and then calls functions or classes defined in agenticRAG.py.
- The agenticRAG.py module is central to the analysis; thus, any output (data, reports, or logs) would flow back to main.py or potentially write to external stores.
- External libraries (declared in requirements.txt) support both main.py and agenticRAG.py, so represent them as a dependency layer.
- The container configuration (.devcontainer) encapsulates the entire development environment, so include it as an external environment component that “wraps” the application.

##### Architectural Patterns and Design Principles
- Modular design: Separating the entry point (main.py) from the core functionality (agenticRAG.py) along with external configuration implies a clean separation of concerns.
- Configuration-Driven Behavior: Using config.ini and .env files shows the use of externalized configuration.
- Containerization: The .devcontainer folder indicates a modern development practice that ensures consistency across development environments.
- Documentation and Specification: Although external to the runtime system, the documentation files suggest a careful planning process for the project’s scope and budget.

## Diagram (Mermaid)

```mermaid
flowchart TD
    D1("Development Environment (.devcontainer)"):::dev
    R2("External Libraries (requirements.txt)"):::dependency
    C1("Configuration File (config.ini)"):::config
    C2("Environment Variables (.env)"):::config
    M("Application Initialization (main.py)"):::runtime
    A("Core Analysis Engine (agenticRAG.py)"):::runtime
    Doc1("Budget & Planning (2024-Budget-Note de Cadrage.docx)"):::documentation
    Doc2("Resource Documents (Documents RAG)"):::documentation

    D1 --> M
    D1 --> A
    R2 --> M
    R2 --> A
    C1 --> M
    C1 --> A
    C2 --> M
    C2 --> A
    M -->|"invokes"| A
    Doc1 --> A
    Doc2 --> A

    click D1 "https://github.com/eta-dt/agentic_analysis/blob/main/.devcontainer/devcontainer.json"
    click R2 "https://github.com/eta-dt/agentic_analysis/blob/main/requirements.txt"
    click C1 "https://github.com/eta-dt/agentic_analysis/blob/main/config.ini"
    click C2 "https://github.com/eta-dt/agentic_analysis/blob/main/.env"
    click M "https://github.com/eta-dt/agentic_analysis/blob/main/main.py"
    click A "https://github.com/eta-dt/agentic_analysis/blob/main/agenticRAG.py"
    click Doc1 "https://github.com/eta-dt/agentic_analysis/blob/main/2024-Budget-Note de Cadrage.docx"
    click Doc2 "https://github.com/eta-dt/agentic_analysis/tree/main/Documents RAG"

    classDef dev fill:#b3cde0,stroke:#6497b1,stroke-width:2px;
    classDef runtime fill:#ccebc5,stroke:#55a630,stroke-width:2px;
    classDef config fill:#fbb4ae,stroke:#d9534f,stroke-width:2px;
    classDef dependency fill:#decbe4,stroke:#6a51a3,stroke-width:2px;
    classDef documentation fill:#ffffb3,stroke:#ffd700,stroke-width:2px;
```
