# Documentación Base – Cálculo Hidráulico (Gas y Líquido)

## 1. Objetivo

Este documento describe la estructura actual del módulo de cálculo hidráulico dentro del proyecto, incluyendo:

- Arquitectura general
- Módulos y funciones existentes
- Entradas y salidas
- Librerías utilizadas
- Modelo de cálculo
- Riesgos identificados

Sirve como base antes de integrar NeqSIM para equipos y elementos avanzados.

---

## 2. Arquitectura General

### Capas del sistema

| Capa | Archivo / módulo | Rol |
|------|------------------|-----|
| UI | `app.ipynb` | Punto de entrada en JupyterLab |
| UI | `src/ui/flow_ui.py` | Interfaz tabular, filtros, ejecución de cálculo |
| Lógica | `src/logic/gas_calc.py` | Cálculo hidráulico para gas |
| Lógica | `src/logic/liquid_calc.py` | Cálculo hidráulico para líquido |
| DB | `src/db/connection.py` | Conexión a SQL Server |

---

## 3. Flujo de Operación

1. El usuario selecciona:
   - Empresa
   - Proyecto
   - Línea
   - ISO

2. Se cargan datos desde base de datos.
3. Se muestran en una tabla editable (`ipysheet`).
4. Cada fila representa un tramo hidráulico.
5. Se ejecuta el cálculo mediante botón **Calcular Flujo**.
6. Se genera un DataFrame de resultados.
7. Los resultados se exportan a SQL Server.

---

## 4. Funciones Principales

### 4.1 Gas

```python
def calcular_gas(df_input):
    return df_resultados