# nox456/proyecto_calculo_numerico architecture

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

- Interactive diagram: https://gitdiagram.com/nox456/proyecto_calculo_numerico
- Repository: https://github.com/nox456/proyecto_calculo_numerico

## Overview

##### Project type and purpose
- This is a Python-based numerical library/CLI tool that implements abstract data types (ADTs) for significant figures, elemental operations, and various error‐propagation calculations. Its goal is to validate inputs, perform core numerical processes (rounding, error propagation, numeric system conversions), and expose them via `main.py`.

##### File structure
- Top-level:
- README.md – high-level TODOs and feature checklist
- src/main.py – entry point
- src/composables – (currently empty) potential UI/CLI components
- src/helpers – utility functions (e.g., array helpers)
- src/proccess – core process functions (figures, files, numbers)
- src/repositories – domain ADTs (AbsoluteError, RelativeError, SigFigures, ElementalOperations, etc.)
- src/storage – (currently empty) abstraction for persistence
- src/validations – input and domain validations (files, operations, numeric systems, sig figs)
- Patterns: layered structure—validations → process → repositories (domain) → storage.

##### README for additional insights
- The TODO list ties together modules: main.py must initialize SigFigs and ElemsOps ADTs; validations and process modules must be fleshed out to wire ADTs into the computation pipeline.

##### Detailed, essential architectural elements
- Six main package roles (application, validation, processing, domain, utility, storage)
- Do not overthink—represent every directory as a component, show dependencies, and clearly label data flows

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Application Layer
    subgraph "Application Layer"
        direction TB
        Main["main.py\n(CLI Orchestrator)"]:::app
    end

    %% Validation Layer
    subgraph "Validation Layer"
        direction TB
        FilesVal["files.py"]:::val
        OpsVal["operations.py"]:::val
        SelectorVal["selector.py"]:::val
        SystemsVal["systems.py"]:::val
        SigFigsVal["valFigs.py"]:::val
    end

    %% Processing Layer
    subgraph "Processing Layer"
        direction TB
        FigProc["figures.py"]:::proc
        NumProc["numbers.py"]:::proc
        FileProc["files.py"]:::proc
    end

    %% Domain Layer
    subgraph "Domain ADTs"
        direction TB
        AbsErr["AbsoluteError.py"]:::domain
        RelErr["RelativeError.py"]:::domain
        RoundErr["RoundingError.py"]:::domain
        TruncErr["TruncateError.py"]:::domain
        GenErr["Error.py"]:::domain
        SigFigsADT["SigFigures.py"]:::domain
        ElemOps["ElementalOperations.py"]:::domain
        NumSys["NumericSystem.py"]:::domain
        NumAbs["Number.py"]:::domain
        FileEntry["FileEntry.py"]:::domain
        FileMgr["FileManager.py"]:::domain
    end

    %% Persistence Layer
    Storage["Storage (future)"]:::storage

    %% Utility Layer
    subgraph "Utility Modules"
        direction TB
        Helpers["arrays.py"]:::util
        Composables[".gitkeep\n(composables)"]:::util
    end

    %% Dependencies
    Main -->|"validates input"| FilesVal
    Main --> OpsVal
    Main --> SelectorVal
    Main --> SystemsVal
    Main --> SigFigsVal

    FilesVal -->|"on success"| FigProc
    OpsVal --> FigProc
    SelectorVal --> NumProc
    SystemsVal --> NumProc
    SigFigsVal --> FigProc

    FigProc --> AbsErr
    FigProc --> RelErr
    FigProc --> RoundErr
    FigProc --> TruncErr
    FigProc --> GenErr
    FigProc --> SigFigsADT
    NumProc --> ElemOps
    NumProc --> NumSys
    NumProc --> NumAbs
    FileProc --> FileEntry
    FileProc --> FileMgr

    AbsErr --> FileProc
    RelErr --> FileProc
    RoundErr --> FileProc
    TruncErr --> FileProc
    GenErr --> FileProc

    FileProc --> Storage

    %% Utilities cross-cutting
    FilesVal -.-> Helpers
    OpsVal -.-> Helpers
    SelectorVal -.-> Helpers
    SystemsVal -.-> Helpers
    SigFigsVal -.-> Helpers
    FigProc -.-> Helpers
    NumProc -.-> Helpers
    FileProc -.-> Helpers
    Main -.-> Composables

    %% Click Events
    click Main "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/main.py"
    click FilesVal "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/validations/files.py"
    click OpsVal "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/validations/operations.py"
    click SelectorVal "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/validations/selector.py"
    click SystemsVal "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/validations/systems.py"
    click SigFigsVal "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/validations/valFigs.py"
    click FigProc "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/proccess/figures.py"
    click NumProc "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/proccess/numbers.py"
    click FileProc "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/proccess/files.py"
    click AbsErr "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/AbsoluteError.py"
    click RelErr "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/RelativeError.py"
    click RoundErr "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/RoundingError.py"
    click TruncErr "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/TruncateError.py"
    click GenErr "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/Error.py"
    click SigFigsADT "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/SigFigures.py"
    click ElemOps "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/ElementalOperations.py"
    click NumSys "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/NumericSystem.py"
    click NumAbs "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/Number.py"
    click FileEntry "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/FileEntry.py"
    click FileMgr "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/repositories/FileManager.py"
    click Helpers "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/helpers/arrays.py"
    click Composables "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/composables/.gitkeep"
    click Storage "https://github.com/nox456/proyecto_calculo_numerico/blob/master/src/storage/.gitkeep"

    %% Styles
    classDef app fill:#cce5ff,stroke:#333,stroke-width:1px;
    classDef val fill:#e6ccff,stroke:#333,stroke-width:1px;
    classDef proc fill:#ccffcc,stroke:#333,stroke-width:1px;
    classDef domain fill:#ffebcc,stroke:#333,stroke-width:1px;
    classDef storage fill:#ffe6e6,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5;
    classDef util fill:#f2f2f2,stroke:#666,stroke-dasharray: 2 2;
```
