Referencia: Estructura del Repositorio

Mapa práctico de la estructura actual.

Directorios Principales

• src/url_monitor/ código de aplicación
• tests/ suite de tests
• docs/ documentación MkDocs
• .github/workflows/ CI/CD
• scripts/ scripts utilitarios
• data/ datos locales runtime

Código de Aplicación

src/url_monitor/core/

Lógica principal:

• mitm_addon.py pipeline request/response
• filter_manager.py matching, update y stats de filtros
• database.py capa SQLite
• alerts.py notificaciones
• block_pages.py páginas sintéticas de bloqueo

src/url_monitor/qt/

UI desktop:

• main_window.py orquestación shell
• panels/ vistas principales
• backend/ monitor manager, workers, cert manager, signals
• widgets/ componentes reutilizables
• styles/ sistema de tema/colores
• branding.py logo, links y metadata

src/url_monitor/i18n/

Helpers de locales y normalización.

Datos Runtime

Configurados en Config:

• data/settings.json
• data/url_monitor.db
• data/filters/

Suite de Tests

Incluye:

• core y config
• i18n
• regresiones de paneles Qt
• comportamiento de workers y carga

Estructura de Docs

Layout bilingüe actual:

• docs/en/...
• docs/es/...

docs/index.md es landing de selección de idioma.