CabledocDesktop

KO | EN

gitlite — search

#ios #ui #computer-vision #large-language-models #kubernetes #proxy #markdown #hacktoberfest #deep-learning #csharp

CabledocDesktop

(★ 9)

Broadcast Cable and Infrastructure managment software

파일 탐색기

ZIP 다운로드

- - profiles_settings.xml
- .gitignore
- cabledoc_repository.iml
- misc.xml
- modules.xml
- vcs.xml
- cabledoc.cpython-312.pyc
- catalogos_basicos_ui.cpython-312.pyc
- imagen_conectores_ui.cpython-312.pyc
- modelo.cpython-312.pyc
- pantallas_comunes.cpython-312.pyc
- senal_catalogo_ui.cpython-312.pyc
- - __init__.cpython-314.pyc
  - diagnostico_falla.cpython-314.pyc
  - escenario_engine.cpython-314.pyc
  - graph_impact.cpython-314.pyc
  - i18n.cpython-314.pyc
  - modelo.cpython-314.pyc
  - senal_visual.cpython-314.pyc
  - signal_risk.cpython-314.pyc
- __init__.py
- diagnostico_falla.py
- escenario_engine.py
- graph_impact.py
- i18n.py
- logger_cabledoc.py
- modelo.py
- riesgo_analogico.py
- risk_engine.py
- senal_estado.py
- senal_propagation.py
- senal_visual.py
- signal_risk.py
- - .gitkeep
- - .gitkeep
- - .gitkeep
- - .gitkeep
- README.md
- schema_db.sql
- - acerca_de.cpython-314.pyc
  - arbol_conexiones_ui.cpython-314.pyc
  - busqueda_diagrama_ui.cpython-314.pyc
  - cables_conexiones_ui.cpython-314.pyc
  - catalogo_equipos_alta_rapida_ui.cpython-314.pyc
  - catalogo_equipos_ui.cpython-314.pyc
  - catalogo_simbolo_conector_ui.cpython-314.pyc
  - catalogos_basicos_ui.cpython-314.pyc
  - conectores_ui.cpython-314.pyc
  - diagnostico_ui.cpython-314.pyc
  - diagrama_conexiones_ui.cpython-314.pyc
  - diagrama_personalizado.cpython-314.pyc
  - dibujo_diagrama_ui.cpython-314.pyc
  - edicion_conexiones_diagrama_ui.cpython-314.pyc
  - editor_masivo_conectores_ui.cpython-314.pyc
  - editor_masivo_slots_ui.cpython-314.pyc
  - equipos_alta_rapida_ui.cpython-314.pyc
  - equipos_ui.cpython-314.pyc
  - escenario_ui.cpython-314.pyc
  - export_diagrama_ui.cpython-314.pyc
  - frame_slots_ui.cpython-314.pyc
  - frames_slots_ui.cpython-314.pyc
  - grafo_diagrama_ui.cpython-314.pyc
  - imagen_conectores_ui.cpython-314.pyc
  - impacto_ui.cpython-314.pyc
  - interaccion_diagrama_ui.cpython-314.pyc
  - layout_diagrama_ui.cpython-314.pyc
  - panel_arbol_ui.cpython-314.pyc
  - pantallas_avanzadas.cpython-314.pyc
  - pantallas_comunes.cpython-314.pyc
  - patcheras_ui.cpython-314.pyc
  - planos_ui.cpython-314.pyc
  - rack_ui.cpython-314.pyc
  - racks_salas_ui.cpython-314.pyc
  - riesgo_diagrama_ui.cpython-314.pyc
  - ruteo_interno_diagrama_ui.cpython-314.pyc
  - senal_catalogo_ui.cpython-314.pyc
  - senal_diagrama_ui.cpython-314.pyc
  - senal_visual_ui.cpython-314.pyc
  - signal_risk_diagrama_ui.cpython-314.pyc
- - CableDoc_BNC_128x128.png
  - CableDoc_BNC_16x16.png
  - CableDoc_BNC_192x192.png
  - CableDoc_BNC_256x256(1).png
  - CableDoc_BNC_256x256.png
  - CableDoc_BNC_32x32.png
  - CableDoc_BNC_48x48.png
  - CableDoc_BNC_64x64.png
  - CableDoc_BNC_96x96.png
  - CableDoc_BNC_multisize.ico
  - conexion_incompleta.png
  - icono_aplicacion.png
  - icono_buscar_cerrar.png
  - icono_buscar_lupa.png
  - icono_buscar_next.png
  - icono_buscar_prev.png
  - icono_critico.png
- - CableDoc_Review_Technical_2.pdf
  - CableDoc_Review_Technical_2.tex
  - CableDoc_Review_Tecnico.pdf
  - CableDoc_Review_Tecnico.tex
  - CableDoc_Review_Usuario.pdf
  - REFACTOR_CABLEDOC_TUTORIAL.md
  - TUTORIAL_alta_rapida_conexiones.md
  - TUTORIAL_aviso_fantasma_huerfano.md
  - tutorial_bitacora_incidentes.md
  - TUTORIAL_conexiones_incompletas.md
  - tutorial_extension_cable.md
  - TUTORIAL_funcionalidades_avanzadas.md
  - tutorial_imagenes_svg_y_coordenadas_porcentaje.md
  - TUTORIAL_linaje_de_senal.md
  - tutorial_marcar_extremo_desconectado.md
  - TUTORIAL_merge_funciones_20260826.md
  - TUTORIAL_remocion_estado_y_linaje.md
  - TUTORIAL_riesgo_de_senal.md
- acerca_de.py
- arbol_conexiones_ui.py
- bitacora_ui.py
- busqueda_diagrama_ui.py
- cabledoc.py
- cables_conexiones_ui.py
- catalogo_equipos_alta_rapida_ui.py
- catalogo_equipos_ui.py
- catalogo_simbolo_conector_ui.py
- catalogos_basicos_ui.py
- conectores_ui.py
- convertir_archivos.py
- diagnostico_ui.py
- diagrama_conexiones_ui.py
- diagrama_personalizado.py
- dibujo_diagrama_ui.py
- edicion_conexiones_diagrama_ui.py
- editor_masivo_conectores_ui.py
- editor_masivo_slots_ui.py
- equipos_alta_rapida_ui.py
- equipos_ui.py
- escenario_ui.py
- export_diagrama_ui.py
- extension_cable_ui.py
- frame_slots_ui.py
- frames_slots_ui.py
- grafo_diagrama_ui.py
- imagen_conectores_ui.py
- impacto_ui.py
- interaccion_diagrama_ui.py
- layout_diagrama_ui.py
- panel_arbol_ui.py
- pantallas_avanzadas.py
- pantallas_comunes.py
- patcheras_ui.py
- planos_ui.py
- rack_ui.py
- racks_salas_ui.py
- riesgo_diagrama_ui.py
- ruteo_interno_diagrama_ui.py
- senal_catalogo_ui.py
- senal_diagrama_ui.py
- senal_visual_ui.py
- signal_risk_diagrama_ui.py
- - pantallas_avanzadas.cpython-314.pyc
  - pantallas_busqueda_global.cpython-314.pyc
  - pantallas_cables.cpython-314.pyc
  - pantallas_catalogos.cpython-314.pyc
  - pantallas_conexiones.cpython-314.pyc
  - pantallas_diagrama.cpython-314.pyc
  - pantallas_editores_masivos.cpython-314.pyc
  - pantallas_equipos.cpython-314.pyc
  - pantallas_imagenes.cpython-314.pyc
  - pantallas_racks.cpython-314.pyc
  - pantallas_salas.cpython-314.pyc
  - pantallas_vistas.cpython-314.pyc
  - tema.cpython-314.pyc
  - widgets_base.cpython-314.pyc
- generar_iconos.py
- main.py
- pantallas_avanzadas.py
- pantallas_busqueda_global.py
- pantallas_cables.py
- pantallas_catalogos.py
- pantallas_conectores.py
- pantallas_conexiones.py
- pantallas_diagnostico.py
- pantallas_diagrama.py
- pantallas_editores_masivos.py
- pantallas_equipos.py
- pantallas_imagenes.py
- pantallas_racks.py
- pantallas_salas.py
- pantallas_vistas.py
- tema.py
- widgets_base.py
changelog.txt
context.md
lanzar.sh
lanzar_mobile.sh
LICENSE
PROGRESS.md
PROGRESS_INTEGRACION_MOBILE.md
PROGRESS_REFACTOR.md
PROGRESS_REFACTOR_CABLEDOC.md
README.md
requirements-desktop.txt
requirements-mobile.txt

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Broadcast cable and infrastructure management software.**

CableDoc is a desktop application for documenting and analyzing the cabling
and signal flow of a real broadcast/AV facility (fully digital video, aging
analog audio chain). It manages the physical infrastructure — equipment,
connectors, cables, connections, racks, frames, slots, patch bays
(`patcheras`), routing matrices, and signal entities — and layers impact
analysis, risk scoring, and fault diagnosis on top of it.

Development is driven by real cases found during on-site cabling surveys,
in particular the diagnosis of recurring audio failures traceable to
weaknesses in the analog chain.

> The application's UI, domain vocabulary, comments, and changelog are
> entirely in **Spanish**, since it is built for and used by a real
> broadcast facility. This README is in English for the repository; the
> application itself remains in Spanish, with English/Portuguese available
> as translated UI languages.

- **Origin**: successor to a VB.NET/WinForms predecessor, fully ported to
  Python/GTK3 (a ~26-page LaTeX/PDF technical write-up comparing both
  architectures lives in `help/`). The `CONEXIONES_AMBOS_EXTREMOS` SQL view
  survives from that era.
- **License**: GNU GPL v2 (see [`LICENSE`](./LICENSE)).
- **Author**: fschpp.

---

## What it does

- **Physical infrastructure documentation**: rooms, racks, frames, slots,
  equipment, connectors, and cables, positioned over reference images —
  including SVG images, which stay crisp at any zoom level. Position data
  is stored as **percentages of image width/height** (not raw pixels), so
  connector/slot positions survive swapping in a differently-sized image.
- **Cable & connector tracking**: full connection graph between equipment,
  including patch panels (`patchera`, with front/back row modeling —
  `A_BACK`/`B_BACK`/`A_FRONT`/`B_FRONT` — and full-normal jack bypass
  behavior), routing matrices (`rol_senal = ENRUTADOR`, with recursive
  resolution across cascaded matrices), and disconnected/"phantom"
  endpoints (`FANTASMA`) for cable ends confirmed absent in the field.
- **Cable extensions**: direct point-to-point cable joins (`Extensión`, as
  opposed to `Empalme`/barrel couplers), with full bidirectional chain
  resolution ("view full chain").
- **Signal chain modeling**: signals (`senal`) traced through connectors,
  with role tagging (`rol_senal`) and a documentation-only lineage graph
  (`senal_linaje`) that records how a signal was derived without feeding
  it into automated impact analysis.
- **"What breaks if I disconnect this?" impact analysis**
  (`graph_impact.py`, `GraphImpactAnalyzer`): propagates the effect of
  removing a cable/connector/equipment across AND/OR logical rules
  (`regla_logica`, e.g. DSK-style gates) and routing matrices, and reports
  exactly which downstream equipment and rules are affected — modeled at
  connector granularity so internal routing (e.g. inside a matrix) is
  simulated accurately.
- **Visual diagrams**: Cairo-rendered rack views, an interactive
  connections diagram (`DiagramaConexiones`) with drag-and-drop cabling,
  auto-layout, incomplete-connection overlays, and free-form custom
  diagrams (`diagrama_personalizado.py`), plus dedicated signal-risk and
  signal-state diagrams.
- **Incident log & analog risk tracking** (`bitacora_ui.py`,
  `riesgo_analogico.py`): records incidents, flags "suspect zones"
  (`zona_sospechosa`), and scores analog-chain risk using configurable,
  linear-decay weighting.
- **Structural signal risk** (`signal_risk.py`, `risk_engine.py` /
  Failure Risk Index): risk scoring based on balance, attenuation, and
  bandwidth characteristics of the signal chain.
- **Fault diagnosis assistant** (`diagnostico_falla.py`,
  `diagnostico_ui.py`): guided troubleshooting based on the documented
  signal chain and logged incidents.
- **Operational scenarios** (`escenario_engine.py`, `escenario_ui.py`):
  model and compare contingency/operational configurations — including
  virtual reconnection — against the documented infrastructure.
- **Catalog with JSON import/export** (equipment/frame/connector
  templates), with a deduplicated image pool.
- **Multi-language UI** (`i18n.py`): Spanish as the primary language, with
  English and Portuguese translations, and an AST-based string-wrapping
  pipeline (`auto_wrap.py`) to keep new code translatable.

## Architecture

The app follows a **mixin composition** pattern for its largest screens:
`DiagramaConexiones`, the interactive connections diagram, is assembled
from several focused `*Mixin` classes rather than one monolithic class.

| Layer | Files |
|---|---|
| Entry point / main window, ABM | `cabledoc.py` |
| Data access (SQLite) | `modelo.py`, `schema_db.sql` |
| Shared screen utilities (i18n bootstrap, icons, Cairo primitives, `PALETA`) | `pantallas_comunes.py` |
| Rack / frame / connector screens | `rack_ui.py`, `frame_slots_ui.py`, `imagen_conectores_ui.py`, `arbol_conexiones_ui.py` |
| Patch panels | `patcheras_ui.py` |
| Bulk editors (connectors / slots, real equipment & catalog) | `editor_masivo_conectores_ui.py`, `editor_masivo_slots_ui.py` |
| Connections diagram + mixins | `diagrama_conexiones_ui.py`, `grafo_diagrama_ui.py`, `dibujo_diagrama_ui.py`, `interaccion_diagrama_ui.py`, `edicion_conexiones_diagrama_ui.py`, `layout_diagrama_ui.py`, `busqueda_diagrama_ui.py`, `export_diagrama_ui.py`, `ruteo_interno_diagrama_ui.py` |
| `pantallas_avanzadas.py` | Pure facade (see below) |
| Impact analysis engine | `graph_impact.py` |
| Signal state, propagation & lineage | `senal_estado.py`, `senal_propagation.py`, `senal_visual.py`, `senal_visual_ui.py`, `senal_diagrama_ui.py` |
| Structural / analog signal risk | `signal_risk.py`, `signal_risk_diagrama_ui.py`, `riesgo_analogico.py`, `risk_engine.py`, `riesgo_diagrama_ui.py` |
| Incident log | `bitacora_ui.py` |
| Cable extensions | `extension_cable_ui.py` |
| Fault diagnosis | `diagnostico_falla.py`, `diagnostico_ui.py` |
| Operational scenarios | `escenario_engine.py`, `escenario_ui.py` |
| Custom diagrams | `diagrama_personalizado.py` |
| Localization | `i18n.py` |
| About dialog | `acerca_de.py` (renders this `README.md` and `changelog.txt` inside the app) |
| One-off migration script | `convertir_archivos.py` (pixel → percentage coordinate migration) |

### `pantallas_avanzadas.py`: from ~11,000-line monolith to a pure facade

`pantallas_avanzadas.py` originally held ~11,032 lines covering every
advanced screen in the app. It has been fully split, over six incremental
deliveries, into the focused modules listed above. **As of the final
delivery, `pantallas_avanzadas.py` defines no classes or functions of its
own** — it only re-exports names (`ArbolConexionesEquipo`, `VistaRack`,
`PatcherasVista`, `VistaFrameSlots`, `DiagramaConexiones` and its helper
dialogs, the bulk editors, etc.) from their new homes, under the exact
names `cabledoc.py` and `diagrama_personalizado.py` used before the
refactor. This facade pattern meant neither of those two consumers needed
any changes across the whole refactor.

The legacy custom-node "classic editor" (`EditorConexiones`), superseded by
reusing `DiagramaConexiones` for quick connection entry, was removed
entirely in the final delivery — it had been disabled in the menu for
several sessions with no other consumer.

## Requirements

- Python 3
- GTK3 via PyGObject
- SQLite (standard library `sqlite3`)
- Pillow (optional, for image preview support)
- **Rsvg GObject-introspection binding** (`gir1.2-rsvg-2.0` on
  Debian/Ubuntu, or the equivalent package for your distro — e.g.
  `mingw-w64-x86_64-librsvg` on MSYS2/Windows) — **required to display
  `.svg` reference images** (floor plans, connector layout images, etc.).
  This is a system-level typelib, not a `pip` package. Without it, SVG
  images degrade gracefully to a placeholder explaining what's missing
  instead of failing outright, but they won't render — install this
  package if any of your reference images are `.svg`.

```bash
apt install python3-gi gir1.2-gtk-3.0 gir1.2-rsvg-2.0
pip install pygobject pillow
```

> If a reference image screen shows the "Sin imagen" placeholder, it now
> states the specific reason (file not found, missing Rsvg binding,
> unreadable SVG, etc.) instead of a generic message — check that text
> first before assuming the image data itself is wrong.

## Running

```bash
python3 cabledoc.py
```

On first run, if `database/db.db` does not exist yet, it is created
automatically from `schema_db.sql` (schema only, no data), along with the
`imagen/`, `manuales/`, and `picon/` support directories.

## Project structure

```
cabledoc.py                # Main entry point / main window / ABM
modelo.py                  # Data access layer (SQLite), class Modelo
schema_db.sql              # Full database schema (~44 tables, 14 views)
pantallas_avanzadas.py     # Facade re-exporting screens from their modules
diagrama_conexiones_ui.py  # Interactive connections diagram + dialogs
*_diagrama_ui.py           # DiagramaConexiones mixins (drawing, layout, search, ...)
rack_ui.py, patcheras_ui.py, frame_slots_ui.py,
imagen_conectores_ui.py, arbol_conexiones_ui.py  # Individual screens
editor_masivo_*_ui.py      # Bulk connector/slot editors
graph_impact.py            # "What breaks if I disconnect this?" engine
riesgo_analogico.py        # Analog risk scoring
signal_risk.py             # Structural signal risk
risk_engine.py             # Failure Risk Index (IRF)
bitacora_ui.py             # Incident log UI
extension_cable_ui.py      # Cable extension ("view full chain")
diagnostico_falla.py       # Fault diagnosis assistant
escenario_engine.py        # Operational scenario engine
diagrama_personalizado.py  # Free-form diagram editor
i18n.py                    # Localization (es / en / pt)
acerca_de.py                # "About" dialog (renders README.md + changelog.txt)
assets/                    # App icons and images
help/                      # User tutorials (Markdown) and technical write-ups (LaTeX/PDF)
database/db.db              # SQLite database (created on first run)
imagen/                    # Stored reference/connector images
manuales/                  # Equipment manuals
picon/                     # Equipment picons/icons
```

## Development notes

- **`pyflakes` is mandatory before any delivery is considered complete.**
  It is the only tool that reliably catches `NameError`s inside GTK draw
  callbacks — GTK silences these at runtime (a black surface or a missing
  node, not a crash), so `ast.parse` / `py_compile` / import-chain smoke
  tests alone are not enough.
- **Facade pattern**: as modules are extracted, they re-export their
  public names back through `pantallas_avanzadas.py`, so dependent modules
  need zero changes per delivery.
- **Anti-hardcoding principle**: behavior is driven by explicit catalog
  columns (`tipo_equipo.rol_senal`, `tipo_conector.direccion`, etc.) with
  `COALESCE()`-based overrides, never by matching equipment/connector
  *names* or IDs in business logic — new equipment/connector types must
  work correctly without any code change.
- **`senal_linaje` is documentation-only by design** and intentionally
  does not feed `graph_impact.py` — this separation is deliberate, not an
  oversight.
- **`FANTASMA` means confirmed absence in the field**, not "unknown" — the
  impact-propagation engine already handles it without special-casing.
- Deferred, in-method imports are the established pattern for breaking
  circular dependencies between `cabledoc.py` ↔ `pantallas_avanzadas.py` ↔
  the `*_ui.py` modules — this must be preserved in any further refactor.
- Every delivery updates `PROGRESS.md` / `PROGRESS_REFACTOR.md`, appends a
  timestamped, one-line-per-change entry to `changelog.txt`, and bumps
  `APP_VERSION` in `cabledoc.py` (format `1.YYYYMMDDHHMMSS`).
- User-facing help lives in `help/TUTORIAL_*.md`, updated alongside each
  user-visible feature.

## License

GNU General Public License v2.0 — see [`LICENSE`](./LICENSE).

CabledocDesktop

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README