196 lines
4.0 KiB
Markdown
196 lines
4.0 KiB
Markdown
# Estructura de Directorios
|
|
|
|
Vista general de la raiz del proyecto:
|
|
|
|
```text
|
|
.
|
|
|-- cloud_conversion_ui/
|
|
|-- data/
|
|
|-- docs/
|
|
|-- input/
|
|
|-- logs/
|
|
|-- prompts/
|
|
|-- references/
|
|
|-- scripts/
|
|
|-- tests/
|
|
|-- .env.example
|
|
|-- .gitignore
|
|
|-- README.md
|
|
|-- requirements.txt
|
|
|-- send.py
|
|
`-- server.py
|
|
```
|
|
|
|
## `cloud_conversion_ui/`
|
|
|
|
Interfaz grafica Streamlit.
|
|
|
|
```text
|
|
cloud_conversion_ui/
|
|
|-- Home.py
|
|
|-- components.py
|
|
|-- models.py
|
|
|-- theme.py
|
|
|-- pages/
|
|
`-- services/
|
|
```
|
|
|
|
| Ruta | Uso |
|
|
| --- | --- |
|
|
| `Home.py` | Entrada de Streamlit. |
|
|
| `pages/01_Inventario.py` | Carga, seleccion y archivado de inventarios. |
|
|
| `pages/02_Catalogos.py` | Estado y actualizacion de catalogos. |
|
|
| `pages/03_Ejecucion.py` | Ejecucion paso a paso de AWS/OCI. |
|
|
| `pages/04_Dashboard.py` | Comparativo de costos y cobertura. |
|
|
| `pages/05_Logs_Artefactos.py` | Lectura y descarga de artefactos. |
|
|
| `services/pipeline_runner.py` | Adaptador que invoca scripts existentes. |
|
|
| `services/inventory_files.py` | Gestion de archivos de inventario. |
|
|
| `services/dashboard_data.py` | Calculos del dashboard. |
|
|
| `services/artifacts.py` | Busqueda de artefactos recientes. |
|
|
|
|
## `scripts/`
|
|
|
|
Scripts operativos y utilidades compartidas.
|
|
|
|
```text
|
|
scripts/
|
|
|-- aws_fetch_offer.py
|
|
|-- aws_eda.py
|
|
|-- aws_match.py
|
|
|-- oci_fetch_offer.py
|
|
|-- oci_match.py
|
|
|-- cloud-chat.py
|
|
|-- cloud_chat_runtime.py
|
|
|-- whatsapp_chatbot.py
|
|
|-- whatsapp_send.py
|
|
|-- whatsapp_logging.py
|
|
|-- match_shared.py
|
|
`-- cloud_conversion_logging.py
|
|
```
|
|
|
|
Los scripts CLI son utiles para automatizacion, reproduccion de problemas o ejecuciones sin Streamlit.
|
|
|
|
## `data/`
|
|
|
|
Datos crudos, catalogos y resultados.
|
|
|
|
```text
|
|
data/
|
|
|-- raw/
|
|
| |-- aws/
|
|
| `-- oci/
|
|
|-- catalog/
|
|
| |-- aws/
|
|
| `-- oci/
|
|
|-- match/
|
|
| |-- aws/
|
|
| `-- oci/
|
|
`-- eda/
|
|
`-- aws/
|
|
```
|
|
|
|
| Ruta | Uso |
|
|
| --- | --- |
|
|
| `data/raw/aws/index.json` | Offer AWS EC2 descargado. |
|
|
| `data/raw/oci/products.json` | Productos OCI descargados. |
|
|
| `data/catalog/aws/aws_ec2_catalog.csv` | Catalogo AWS plano. |
|
|
| `data/catalog/oci/oci_price_list.csv` | Catalogo OCI plano. |
|
|
| `data/match/aws/` | Salidas `MATCH-AWS-*.csv`. |
|
|
| `data/match/oci/` | Salidas `MATCH-OCI-*.csv`. |
|
|
| `data/eda/aws/` | Reportes Markdown de EDA AWS. |
|
|
|
|
Nota: `data/` puede ser grande. En este workspace pesa aproximadamente 8 GB.
|
|
|
|
## `input/`
|
|
|
|
Inventarios de entrada.
|
|
|
|
```text
|
|
input/
|
|
|-- done/
|
|
`-- gui_uploads/
|
|
```
|
|
|
|
| Ruta | Uso |
|
|
| --- | --- |
|
|
| `input/` | Inventarios activos disponibles para CLI/GUI. |
|
|
| `input/gui_uploads/` | Inventarios subidos desde Streamlit. |
|
|
| `input/done/` | Inventarios procesados o archivados. |
|
|
|
|
La GUI no mueve inventarios automaticamente al ejecutar matching. El archivado manual se hace desde la pagina `Inventario`.
|
|
|
|
## `logs/`
|
|
|
|
Bitacoras diarias generadas por scripts:
|
|
|
|
```text
|
|
logs/log_cloud_conversion_YYYYMMDD.txt
|
|
```
|
|
|
|
`logs/` esta en `.gitignore`. Revisa contenido antes de compartir.
|
|
|
|
## `prompts/`
|
|
|
|
Prompts usados por matching AWS y mapeo de columnas.
|
|
|
|
```text
|
|
prompts/aws_match_prompts.py
|
|
```
|
|
|
|
## `references/`
|
|
|
|
Material de referencia, notebooks y ejemplos historicos.
|
|
|
|
```text
|
|
references/
|
|
|-- Pricing-oci-example.xlsx
|
|
`-- aws-latest-json-eda-v1-1.ipynb
|
|
```
|
|
|
|
## `tests/`
|
|
|
|
Suite de pruebas Pytest.
|
|
|
|
Incluye pruebas para:
|
|
|
|
- AWS/OCI fetch y match.
|
|
- Cloud Chat.
|
|
- WhatsApp.
|
|
- Utilidades compartidas.
|
|
- Interfaz grafica y servicios UI.
|
|
|
|
Comando:
|
|
|
|
```bash
|
|
python -m pytest -q
|
|
```
|
|
|
|
## Archivos raiz
|
|
|
|
| Archivo | Uso |
|
|
| --- | --- |
|
|
| `README.md` | Entrada principal del proyecto. |
|
|
| `requirements.txt` | Dependencias Python. |
|
|
| `.env.example` | Plantilla segura de variables. |
|
|
| `.gitignore` | Exclusiones de secretos, venv, logs y caches. |
|
|
| `server.py` | Demo legacy Flask/Twilio. |
|
|
| `send.py` | Demo legacy de envio WhatsApp. |
|
|
|
|
## Que compartir
|
|
|
|
Compartir:
|
|
|
|
- Codigo fuente.
|
|
- Documentacion.
|
|
- `.env.example`.
|
|
- Datos actuales, si ya fueron revisados para uso interno.
|
|
|
|
No compartir:
|
|
|
|
- `.env`.
|
|
- `.venv/`.
|
|
- `logs/` sin revision.
|
|
- Caches de Python, Pytest, Ruff o sistema.
|
|
- Inventarios con informacion sensible no autorizada.
|
|
|