Projeto: LINCEU LIGHTHOUSE
Versão: v0.1.3.0
Autores: Fernando Nillsson Cidade

Descrição: Visibilidade e Controle sobre Seus Arquivos

Linceu Lighthouse é uma ferramenta de monitoramento que aplica os princípios de Integridade de Arquivos (File Integrity Monitoring - FIM) para fornecer um registro detalhado e transparente de todas as atividades em seus diretórios mais importantes.

Em vez de interpretar a intenção por trás de uma mudança, seu foco é registrar factualmente cada operação—criação, modificação, exclusão e renomeação — dando a você controle e conhecimento total sobre o que acontece.

Principais Casos de Uso

O Linceu Lighthouse oferece a visibilidade necessária para diversos cenários práticos:

• Auditoria de Atividades em Pastas: Ideal para ambientes onde múltiplos usuários ou processos acessam os mesmos diretórios. Saiba exatamente quando um arquivo foi modificado, quem o renomeou ou por que um documento foi excluído.
• Controle de Versões e Projetos: Monitore pastas de projetos para entender o fluxo de trabalho. Veja o histórico de alterações em códigos-fonte, documentos de design ou outros materiais, ajudando a evitar perdas acidentais ou alterações não autorizadas.
• Organização e Limpeza de Arquivos: Identifique arquivos temporários, duplicados ou que não são modificados há muito tempo. Use os relatórios para tomar decisões informadas sobre o que arquivar, mover ou excluir, mantendo seus diretórios enxutos e organizados.
• Investigação de Eventos Específicos: Se um arquivo importante desaparece ou um projeto para de funcionar, o Linceu Lighthouse fornece o histórico cronológico de eventos para ajudar você a rastrear a causa raiz do problema.

Como o Linceu Lighthouse Funciona?

O processo é direto e focado em fornecer dados claros para sua análise:

1. Estabelecimento da Linha de Base (Baseline): Ao iniciar o monitoramento de um diretório, o Linceu Lighthouse realiza um escaneamento completo para criar um "snapshot" inicial do estado de todos os arquivos e pastas.
2. Monitoramento Contínuo: A partir da linha de base, a ferramenta monitora em tempo real e registra cada evento de criação, modificação, exclusão, movimentação ou renomeação que ocorre no diretório.
3. Análise e Relatório: Qualquer desvio da linha de base é imediatamente listado na interface gráfica. A partir daí, você tem total poder para analisar o que aconteceu, utilizando as ferramentas que o software oferece.

Ferramentas de Análise à sua Disposição

Para transformar o grande volume de dados de monitoramento em informação útil, o Linceu Lighthouse oferece:

• Filtros Avançados: Não se perca em meio a milhares de eventos. Isole rapidamente o que importa, filtrando por tipo de operação (ex: ver apenas arquivos excluídos), por data, por extensão (.docx, .jpg), ou por usuário.
• Visualização de Estatísticas: Transforme dados brutos em insights visuais. Com gráficos intuitivos, você pode entender padrões de atividade, como os horários de pico de modificações, os tipos de arquivos mais alterados, e muito mais.
• Exportação Flexível de Dados: Crie um registro permanente e auditável. Exporte os logs de monitoramento para diversos formatos (Excel, CSV, JSON, XML), seja para arquivamento, para compartilhar com sua equipe, ou para importar em outros sistemas.

MANUAL DE UTILIZAÇÃO RÁPIDO:

Como usar:

1. Execute o aplicativo para iniciar a interface gráfica.
2. Selecione um diretório para monitorar.
3. Utilize os botões e menus para iniciar/parar o monitoramento, aplicar filtros, exportar dados e visualizar estatísticas.

MANUAL DE UTILIZAÇÃO DETALHADO:

Requisitos do Sistema: - Sistema Operacional: Windows 10 ou superior.

Instalação: - Instale o arquivo executável do programa, siga as instruções do instalador e execute o programa.

Configuração Inicial: - A interface será exibida com a tabela de monitoramento vazia. - O idioma padrão será selecionado de acordo com a configuração do sistema. - Observe a barra lateral esquerda para acessar as funções principais.

Monitoramento de Diretórios: 1. Selecionar um Diretório: - Clique no botão "Selecionar Diretório" ou selecione "Arquivo → Selecionar Diretório" - O caminho do diretório selecionado será exibido acima da tabela

2. Iniciar/Parar Monitoramento:
   - Clique no botão "Iniciar/Parar" ou selecione "Arquivo → Iniciar/Parar"
   - Um escaneamento inicial do diretório será realizado com barra de progresso
   - Para interromper o monitoramento, clique novamente no mesmo botão

Interface Principal: - Barra de Menu: Acesso a todas as funções do programa - Barra Lateral: Botões de ações rápidas - Rótulo de Diretório: Exibe o diretório monitorado - Rótulo de Resultado: Mostra o status atual da operação - Tabela de Dados: Exibe todos os eventos de monitoramento - Barra de Progresso: Visível durante operações de longa duração

Campos padrão da tabela:
- Tipo de Operação: Adicionado, Excluído, Modificado, Renomeado ou Movido
- Nome: Nome do arquivo
- Diretório Anterior: Local original do arquivo (quando aplicável)
- Diretório Atual: Local atual do arquivo
- Data de Criação: Data em que o arquivo foi criado
- Data de Modificação: Data da última modificação
- Tipo: Tipo/extensão do arquivo

Filtros e Pesquisa: 1. Filtros Rápidos: - No menu "Configurações → Filtros", marque/desmarque tipos de operações (Movido, Renomeado, Adicionado, Excluído, Modificado)

2. Filtros Avançados:
   - Acesse "Configurações → Filtros → Filtros Avançados"
   - Filtro de Operação: Selecione tipos de operações a visualizar
   - Pesquisa: Busca por texto em nome e diretórios
   - Filtro por Extensão: Filtre por tipos específicos de arquivo
   - Filtro de Data: Defina o período para os eventos
   - Use o botão de calendário para seleção de datas
   - "Limpar Filtros" reseta todas as configurações

Visualização de Estatísticas: - Acesse pelo botão "Estatísticas" ou "Arquivo → Estatísticas" - Gráficos disponíveis: * Distribuição de Operações: Proporção de cada tipo de operação * Top 10 Tipos de Arquivo: Tipos de arquivo mais comuns * Timeline de Operações: Linha do tempo de eventos * Mapa de Árvore: Visualização de tamanho por tipos * Distribuição por Hora: Horários com mais operações * Análise de Pareto: Frequência e percentual acumulado * Operações por Dia: Operações agrupadas por data - Salvar gráficos: Clique em "Salvar Todos" e selecione destino

Exportação de Dados: - Clique em "Salvar Como" ou "Arquivo → Salvar Como" - Formatos disponíveis: * Excel (.xlsx) * CSV (.csv) * Texto (.txt) * JSON (.json) * XML (.xml) * Banco de Dados (.db) - Para exportações futuras do mesmo conjunto, use "Arquivo → Salvar"

Configuração de Colunas: - Acesse "Configurações → Configurar Colunas" - Marque/desmarque colunas desejadas na tabela: (Tipo de Operação, Nome, Diretório Anterior, Diretório Atual, etc.) - Alterações são aplicadas imediatamente - Restauração padrão: "Configurações → Configurar Colunas → Resetar Colunas"

Alteração de Idioma: - Acesse "Opções → Idioma" e selecione o idioma desejado - O programa será reiniciado com o novo idioma após confirmação

Resolução de Problemas: 1. Monitoramento não inicia: - Verifique permissões de acesso ao diretório - Certifique-se que não há outro programa monitorando o mesmo diretório - Reinicie o aplicativo

2. Eventos não aparecem:
    - Verifique se o monitoramento está ativo
    - Confira se os filtros não estão ocultando eventos
    - Teste modificando um arquivo manualmente

3. Alto consumo de recursos:
    - Evite monitorar diretórios de sistema ou com milhares de arquivos
    - Monitore subdiretórios específicos em vez de diretórios raiz

4. Erros nas estatísticas:
    - Certifique-se que há eventos suficientes para gerar gráficos
    - Verifique se todas as bibliotecas estão corretamente instaladas

Linceu Lighthouse é uma aplicação desktop desenvolvida em Python/PySide6 para monitoramento em tempo real de operações em sistemas de arquivos (criação, modificação, exclusão, renomeação, movimentação). Oferece análise estatística avançada, visualização de dados e exportação em múltiplos formatos.

• Framework GUI: PySide6 (Qt6)
• Análise de Dados: pandas, numpy
• Visualização: matplotlib, seaborn, plotly
• Banco de Dados: SQLite3 (com otimizações WAL)
• Multithreading: QThread, concurrent.futures
• Internacionalização: Qt Linguist (6 idiomas)

• [S] Single Responsibility: Cada módulo tem uma responsabilidade única
• [O] Open/Closed: Extensível via herança (BaseGerador, BaseEvento)
• [L] Liskov Substitution: Todos os geradores de gráfico são intercambiáveis
• [I] Interface Segregation: Interfaces específicas por tipo de evento
• [D] Dependency Inversion: Injeção de dependências (loc, interface, db_path)

• Observer Pattern: Monitoramento de arquivos
• Factory Pattern: Criação de botões e componentes
• Strategy Pattern: Diferentes estratégias de exportação
• Singleton Pattern: LogManager, DatabaseWriter
• Model-View-Controller: EventTableModel + QTableView
• Template Method: BaseGerador define esqueleto
• Facade Pattern: GerenciadorEstatisticasUI simplifica acesso

• QThread para operações longas (escaneamento, gráficos)
• ThreadPoolExecutor para processamento paralelo
• DatabaseWriter com thread dedicada
• Debouncing inteligente para eventos
• Cache com invalidação seletiva
• Batch processing para inserções

• SQLite com modo WAL (Write-Ahead Logging)
• Índices em colunas frequentes
• Transações em lote
• PRAGMA optimizations
• Thread dedicada para I/O

1. INICIALIZAÇÃO
   └─> QApplication.instance()
   └─> Internacionalizador.inicializar_sistema_traducao()
   └─> InterfaceMonitor.__init__()

2. SELEÇÃO DE DIRETÓRIO
   └─> GerenciadorBotoes.selecionar_diretorio()
   └─> QFileDialog.getExistingDirectory()

3. INÍCIO DO MONITORAMENTO
   └─> Observador.iniciar()
   ├─> DiretorioScanner.scan_directory() [Thread]
   └─> Observador.monitorar() [Thread]

4. PROCESSAMENTO DE EVENTOS
   └─> Observador.processar_evento()
   ├─> EventoAdicionado.processar()
   ├─> EventoExcluido.processar()
   ├─> EventoModificado.processar()
   ├─> EventoRenomeado.processar()
   └─> EventoMovido.verificar_movimentacao()

5. ATUALIZAÇÃO DA INTERFACE
   └─> InterfaceMonitor.inserir_evento_streaming()
   └─> GerenciadorTabela.atualizar_linha_mais_recente()

6. GERAÇÃO DE ESTATÍSTICAS
   └─> GerenciadorEstatisticasUI.mostrar_estatisticas()
   └─> GeradorEstatisticas._gerar_todos_graficos()

7. EXPORTAÇÃO DE DADOS
   └─> GerenciadorBotoes.exportar_dados()
   ├─> Excel: pandas.to_excel()
   ├─> CSV: pandas.to_csv()
   ├─> JSON: json.dump()
   └─> XML: ElementTree

8. MUDANÇA DE IDIOMA
   └─> GerenciadorEventosUI.alterar_idioma()
   └─> LocalizadorQt.set_idioma()

PySide6>=6.5.0           # Framework Qt6
pandas>=2.0.0            # Análise de dados
matplotlib>=3.7.0        # Visualização de gráficos
seaborn>=0.12.0          # Gráficos estatísticos
plotly==5.22.0           # Gráficos interativos
Pillow>=10.0.0           # Processamento de imagens
tinytag>=1.10.0          # Metadados de áudio
pymediainfo>=6.0.0       # Metadados de vídeo
PyPDF2>=3.0.0            # Metadados de PDF
openpyxl>=3.1.0          # Leitura/escrita Excel
python-docx>=0.8.11      # Metadados de DOCX
chardet>=5.1.0           # Detecção de encoding
squarify>=0.4.3          # Gráficos treemap
psutil>=5.9.0            # Monitoramento de sistema
pywin32>=305             # API Windows

• Sistema Operacional: Windows 10/11 (64-bit)
• Python: 3.10+
• RAM: 4GB mínimo (8GB recomendado)
• Disco: 100MB espaço disponível

• ✓ Nomes descritivos e autoexplicativos
• ✓ Funções pequenas e focadas (< 50 linhas)
• ✓ Evitar números mágicos (usar constantes)
• ✓ Documentação no código (docstrings)
• ✓ Formatação consistente
• ✓ Evitar duplicação de código (DRY)

• ✓ Lazy loading de metadados
• ✓ Cache de resultados frequentes
• ✓ Processamento assíncrono
• ✓ Batch processing
• ✓ Índices otimizados no banco
• ✓ Uso eficiente de memória

• ✓ Modularização extrema (200+ módulos)
• ✓ Separação de responsabilidades
• ✓ Baixo acoplamento
• ✓ Alta coesão
• ✓ Padrões de nomenclatura consistentes

• Novo tipo de gráfico: Herdar de data/GeradorEstatisticas/gst_01_base_gerador.py
• Novo tipo de evento: Herdar de services/ob_02_BaseEvento.py
• Nova coluna: Adicionar getter em services/ob_09_GerenciadorColunas.py
• Novo idioma: Criar linceu_XX.ts em source/locale/
• Novo filtro: Adicionar em tools/GerenciamentoAdministradorFiltros/

futures==3.0.5
kaleido==0.2.1
plotly==5.22.0

• monitoramento.db - Banco de dados principal (SQLite)
• language_config.json - Preferência de idioma
• colunas_coloridas.json - Configuração de cores
• cores_operacoes.json - Cores por tipo de operação
• config.json - Configurações gerais

Sistema de logs com rotação automática em:

%APPDATA%/Linceu_Lighthouse/logs/

Autores: Fernando Nillsson Cidade
Versão: v0.1.3.0
Licença: GNU Affero General Public License v3.0 (AGPL-3.0)

Para mais informações, consulte a documentação específica de cada módulo no código-fonte.

Project: LINCEU LIGHTHOUSE
Version: v0.1.3.0
Authors: Fernando Nillsson Cidade

Description: Visibility and Control Over Your Files

Linceu Lighthouse is a monitoring tool that applies the principles of File Integrity Monitoring (FIM) to provide a detailed and transparent log of all activities in your most important directories.

Instead of interpreting the intent behind a change, its focus is to factually record every operation—creation, modification, deletion, and renaming—giving you total control and knowledge of what happens.

Main Use Cases

Linceu Lighthouse provides the necessary visibility for various practical scenarios:

• Auditing Folder Activities: Ideal for environments where multiple users or processes access the same directories. Know exactly when a file was modified, who renamed it, or why a document was deleted.
• Version and Project Control: Monitor project folders to understand the workflow. View the history of changes in source code, design documents, or other materials, helping to prevent accidental losses or unauthorized changes.
• File Organization and Cleanup: Identify temporary, duplicate, or long-unmodified files. Use the reports to make informed decisions about what to archive, move, or delete, keeping your directories lean and organized.
• Investigating Specific Events: If an important file disappears or a project stops working, Linceu Lighthouse provides a chronological history of events to help you trace the root cause of the problem.

How Linceu Lighthouse Works

The process is straightforward and focused on providing clear data for your analysis:

1. Establishing the Baseline: When starting to monitor a directory, Linceu Lighthouse performs a full scan to create an initial "snapshot," or baseline, of the state of all files and folders.
2. Continuous Monitoring: From the baseline, the tool monitors in real-time and records every creation, modification, deletion, move, or renaming event that occurs in the directory.
3. Analysis and Reporting: Any deviation from the baseline is immediately listed in the graphical interface. From there, you have full power to analyze what happened, using the tools the software offers.

Analysis Tools at Your Disposal

To transform the large volume of monitoring data into useful information, Linceu Lighthouse offers:

• Advanced Filters: Don't get lost among thousands of events. Quickly isolate what matters by filtering by operation type (e.g., view only deleted files), by date, by extension (.docx, .jpg), or by user.
• Statistics Visualization: Turn raw data into visual insights. With intuitive charts, you can understand activity patterns, such as peak modification times, the most frequently changed file types, and more.
• Flexible Data Export: Create a permanent and auditable record. Export monitoring logs to various formats (Excel, CSV, JSON, XML), whether for archiving, sharing with your team, or importing into other systems.

QUICK USE MANUAL:

How to use:

1. Run the application to start the graphical interface.
2. Select a directory to monitor.
3. Use the buttons and menus to start/stop monitoring, apply filters, export data, and view statistics.

DETAILED USER MANUAL:

System Requirements: - Operating System: Windows 10 or higher.

Installation: - Install the program's executable file, follow the installer's instructions, and run the program.

Initial Setup: - The interface will be displayed with an empty monitoring table. - The default language will be selected according to the system settings. - Note the left sidebar to access the main functions.

Directory Monitoring: 1. Select a Directory: - Click the "Select Directory" button or select "File → Select Directory" - The path of the selected directory will be displayed above the table

2. Start/Stop Monitoring:
   - Click the "Start/Stop" button or select "File → Start/Stop"
   - An initial scan of the directory will be performed with a progress bar
   - To stop monitoring, click the same button again

Main Interface: - Menu Bar: Access to all program functions - Sidebar: Quick action buttons - Directory Label: Displays the monitored directory - Result Label: Shows the current status of the operation - Data Table: Displays all monitoring events - Progress Bar: Visible during long-running operations

Default table fields:
- Operation Type: Added, Deleted, Modified, Renamed, or Moved
- Name: File name
- Previous Directory: Original location of the file (when applicable)
- Current Directory: Current location of the file
- Creation Date: Date the file was created
- Modification Date: Date of the last modification
- Type: File type/extension

Filters and Search: 1. Quick Filters: - In the "Settings → Filters" menu, check/uncheck operation types (Moved, Renamed, Added, Deleted, Modified)

2. Advanced Filters:
   - Access "Settings → Filters → Advanced Filters"
   - Operation Filter: Select operation types to view
   - Search: Search for text in names and directories
   - Extension Filter: Filter by specific file types
   - Date Filter: Define the period for events
   - Use the calendar button for date selection
   - "Clear Filters" resets all settings

Statistics Visualization: - Access via the "Statistics" button or "File → Statistics" - Available charts: * Operation Distribution: Proportion of each operation type * Top 10 File Types: Most common file types * Operation Timeline: Timeline of events * Tree Map: Size visualization by types * Distribution by Hour: Times with the most operations * Pareto Analysis: Frequency and cumulative percentage * Operations by Day: Operations grouped by date - Save charts: Click "Save All" and select a destination

Data Export: - Click "Save As" or "File → Save As" - Available formats: * Excel (.xlsx) * CSV (.csv) * Text (.txt) * JSON (.json) * XML (.xml) * Database (.db) - For future exports of the same set, use "File → Save"

Column Configuration: - Access "Settings → Configure Columns" - Check/uncheck desired columns in the table: (Operation Type, Name, Previous Directory, Current Directory, etc.) - Changes are applied immediately - Default restoration: "Settings → Configure Columns → Reset Columns"

Language Change: - Access "Options → Language" and select the desired language - The program will restart with the new language after confirmation

Troubleshooting: 1. Monitoring does not start: - Check directory access permissions - Make sure no other program is monitoring the same directory - Restart the application

2. Events do not appear:
    - Check if monitoring is active
    - Check if filters are not hiding events
    - Test by manually modifying a file

3. High resource consumption:
    - Avoid monitoring system directories or those with thousands of files
    - Monitor specific subdirectories instead of root directories

4. Errors in statistics:
    - Ensure there are enough events to generate charts
    - Check if all libraries are correctly installed

Linceu Lighthouse is a desktop application developed in Python/PySide6 for real-time monitoring of file system operations (creation, modification, deletion, renaming, moving). It offers advanced statistical analysis, data visualization, and export in multiple formats.

• GUI Framework: PySide6 (Qt6)
• Data Analysis: pandas, numpy
• Visualization: matplotlib, seaborn, plotly
• Database: SQLite3 (with WAL optimizations)
• Multithreading: QThread, concurrent.futures
• Internationalization: Qt Linguist (6 languages)

• [S] Single Responsibility: Each module has a single responsibility
• [O] Open/Closed: Extensible via inheritance (BaseGerador, BaseEvento)
• [L] Liskov Substitution: All chart generators are interchangeable
• [I] Interface Segregation: Specific interfaces per event type
• [D] Dependency Inversion: Dependency injection (loc, interface, db_path)

• Observer Pattern: File monitoring
• Factory Pattern: Button and component creation
• Strategy Pattern: Different export strategies
• Singleton Pattern: LogManager, DatabaseWriter
• Model-View-Controller: EventTableModel + QTableView
• Template Method: BaseGerador defines skeleton
• Facade Pattern: GerenciadorEstatisticasUI simplifies access

• QThread for long operations (scanning, charts)
• ThreadPoolExecutor for parallel processing
• DatabaseWriter with dedicated thread
• Smart debouncing for events
• Cache with selective invalidation
• Batch processing for insertions

• SQLite with WAL mode (Write-Ahead Logging)
• Indexes on frequent columns
• Batch transactions
• PRAGMA optimizations
• Dedicated thread for I/O

1. INITIALIZATION
   └─> QApplication.instance()
   └─> Internacionalizador.inicializar_sistema_traducao()
   └─> InterfaceMonitor.__init__()

2. DIRECTORY SELECTION
   └─> GerenciadorBotoes.selecionar_diretorio()
   └─> QFileDialog.getExistingDirectory()

3. START MONITORING
   └─> Observador.iniciar()
   ├─> DiretorioScanner.scan_directory() [Thread]
   └─> Observador.monitorar() [Thread]

4. EVENT PROCESSING
   └─> Observador.processar_evento()
   ├─> EventoAdicionado.processar()
   ├─> EventoExcluido.processar()
   ├─> EventoModificado.processar()
   ├─> EventoRenomeado.processar()
   └─> EventoMovido.verificar_movimentacao()

5. INTERFACE UPDATE
   └─> InterfaceMonitor.inserir_evento_streaming()
   └─> GerenciadorTabela.atualizar_linha_mais_recente()

6. STATISTICS GENERATION
   └─> GerenciadorEstatisticasUI.mostrar_estatisticas()
   └─> GeradorEstatisticas._gerar_todos_graficos()

7. DATA EXPORT
   └─> GerenciadorBotoes.exportar_dados()
   ├─> Excel: pandas.to_excel()
   ├─> CSV: pandas.to_csv()
   ├─> JSON: json.dump()
   └─> XML: ElementTree

8. LANGUAGE CHANGE
   └─> GerenciadorEventosUI.alterar_idioma()
   └─> LocalizadorQt.set_idioma()

PySide6>=6.5.0           # Qt6 Framework
pandas>=2.0.0            # Data analysis
matplotlib>=3.7.0        # Chart visualization
seaborn>=0.12.0          # Statistical charts
plotly==5.22.0           # Interactive charts
Pillow>=10.0.0           # Image processing
tinytag>=1.10.0          # Audio metadata
pymediainfo>=6.0.0       # Video metadata
PyPDF2>=3.0.0            # PDF metadata
openpyxl>=3.1.0          # Excel read/write
python-docx>=0.8.11      # DOCX metadata
chardet>=5.1.0           # Encoding detection
squarify>=0.4.3          # Treemap charts
psutil>=5.9.0            # System monitoring
pywin32>=305             # Windows API

• Operating System: Windows 10/11 (64-bit)
• Python: 3.10+
• RAM: 4GB minimum (8GB recommended)
• Disk: 100MB available space

• ✓ Descriptive and self-explanatory names
• ✓ Small and focused functions (< 50 lines)
• ✓ Avoid magic numbers (use constants)
• ✓ Code documentation (docstrings)
• ✓ Consistent formatting
• ✓ Avoid code duplication (DRY)

• ✓ Lazy loading of metadata
• ✓ Frequent result caching
• ✓ Asynchronous processing
• ✓ Batch processing
• ✓ Optimized database indexes
• ✓ Efficient memory usage

• ✓ Extreme modularization (200+ modules)
• ✓ Separation of concerns
• ✓ Low coupling
• ✓ High cohesion
• ✓ Consistent naming patterns

• New chart type: Inherit from data/GeradorEstatisticas/gst_01_base_gerador.py
• New event type: Inherit from services/ob_02_BaseEvento.py
• New column: Add getter in services/ob_09_GerenciadorColunas.py
• New language: Create linceu_XX.ts in source/locale/
• New filter: Add in tools/GerenciamentoAdministradorFiltros/

futures==3.0.5
kaleido==0.2.1
plotly==5.22.0

• monitoramento.db - Main database (SQLite)
• language_config.json - Language preference
• colunas_coloridas.json - Color configuration
• cores_operacoes.json - Colors by operation type
• config.json - General settings

Logging system with automatic rotation at:

%APPDATA%/Linceu_Lighthouse/logs/

Authors: Fernando Nillsson Cidade
Version: v0.1.3.0
License: GNU Affero General Public License v3.0 (AGPL-3.0)

For more information, consult the specific documentation of each module in the source code.

Proyecto: LINCEU LIGHTHOUSE
Versión: v0.1.3.0
Autores: Fernando Nillsson Cidade

Descripción: Visibilidad y Control sobre Tus Archivos

Linceu Lighthouse es una herramienta de monitoreo que aplica los principios de Monitoreo de Integridad de Archivos (File Integrity Monitoring - FIM) para proporcionar un registro detallado y transparente de todas las actividades en tus directorios más importantes.

En lugar de interpretar la intención detrás de un cambio, su enfoque é registrar de maneira fáctica cada operação—criação, modificação, exclusão e renomeação—dándote controle e conhecimento total sobre o que acontece.

Principais Casos de Uso

Linceu Lighthouse oferece a visibilidade necessária para diversos cenários práticos:

• Auditoría de Actividades em Carpetas: Ideal para entornos onde múltiplos usuários ou processos acessan os mesmos diretórios. Conoce exactamente cuándo se modificó un archivo, quién lo renombró o por qué se eliminó un documento.
• Control de Versiones y Proyectos: Monitorea carpetas de proyectos para entender el flujo de trabajo. Visualiza el historial de cambios en códigos fuente, documentos de diseño u otros materiales, ayudando a evitar pérdidas acidentales o cambios no autorizados.
• Organización y Limpieza de Archivos: Identifica archivos temporales, duplicados o que no se han modificado durante mucho tiempo. Utiliza los informes para tomar decisiones informadas sobre qué archivar, mover o eliminar, manteniendo tus directorios organizados.
• Investigación de Eventos Específicos: Si un archivo importante desaparece o un proyecto deja de funcionar, Linceu Lighthouse proporciona el historial cronológico de eventos para ayudarte a rastrear la causa raíz del problema.

¿Cómo Funciona Linceu Lighthouse?

El proceso es directo y se centra en proporcionar dados claros para tu análisis:

1. Establecimiento de la Línea Base (Baseline): Al iniciar el monitoreo de un directorio, Linceu Lighthouse realiza un escaneamento completo para crear una "instantánea" inicial del estado de todos los archivos y carpetas.
2. Monitoreo Continuo: A partir de la línea base, la herramienta monitorea en tiempo real y registra cada evento de creación, modificación, eliminación, movimiento o renombrado que ocurre en el directorio.
3. Análisis e Informe: Cualquier desviación de la línea base se lista inmediatamente en la interfaz gráfica. Desde allí, tienes total poder para analizar lo que sucedió, utilizando las herramientas que ofrece el software.

Herramientas de Análisis a Tu Disposición

Para transformar el gran volumen de datos de monitoreo en información útil, Linceu Lighthouse ofrece:

• Filtros Avanzados: No te pierdas entre miles de eventos. Aísla rápidamente lo que importa, filtrando por tipo de operação (ej: ver solo archivos eliminados), por fecha, por extensión (.docx, .jpg), o por usuario.
• Visualización de Estadísticas: Transforma datos brutos en conocimientos visuales. Com gráficos intuitivos, você pode entender padrões de atividade, como os horários de pico de modificações, os tipos de arquivos mais alterados, e muito mais.
• Exportación Flexible de Datos: Crea un registro permanente y auditável. Exporte os logs de monitoramento para diversos formatos (Excel, CSV, JSON, XML), já seja para arquivamento, para compartilhar com sua equipe, ou para importar em outros sistemas.

MANUAL DE USO RÁPIDO:

Cómo usar:

1. Ejecuta la aplicación para iniciar la interfaz gráfica.
2. Selecciona un directorio para monitorear.
3. Utiliza los botones y menús para iniciar/detener el monitoreo, aplicar filtros, exportar datos y visualizar estadísticas.

MANUAL DE USO DETALLADO:

Requisitos del Sistema: - Sistema Operativo: Windows 10 o superior.

Instalación: - Instala el archivo ejecutable del programa, sigue las instrucciones del instalador y ejecuta el programa.

Configuración Inicial: - La interfaz se mostrará con la tabla de monitoreo vacía. - El idioma predeterminado se seleccionará según la configuración del sistema. - Observa la barra lateral izquierda para acceder a las funciones principales.

Monitoreo de Directorios: 1. Seleccionar un Directorio: - Haz clic en el botón "Seleccionar Directorio" o selecciona "Archivo → Seleccionar Directorio" - La ruta del directorio seleccionado se mostrará encima de la tabla

2. Iniciar/Detener Monitoreo:
   - Haz clic en el botón "Iniciar/Detener" o selecciona "Archivo → Iniciar/Detener"
   - Se realizará un escaneado inicial del directorio con barra de progresso
   - Para interrumpir el monitoreo, haz clic nuevamente en el mismo botón

Interfaz Principal: - Barra de Menú: Acceso a todas as funções do programa - Barra Lateral: Botões de ações rápidas - Etiqueta de Directorio: Muestra el directorio monitorizado - Etiqueta de Resultado: Muestra el estado atual da operação - Tabla de Datos: Muestra todos los eventos de monitoreo - Barra de Progreso: Visível durante operações de longa duração

Campos predeterminados de la tabla:
- Tipo de Operación: Adicionado, Excluído, Modificado, Renomeado o Movido
- Nombre: Nombre del archivo
- Directorio Anterior: Ubicación original del archivo (cuando aplica)
- Directorio Actual: Ubicación actual del archivo
- Fecha de Creación: Fecha en que se creó el archivo
- Fecha de Modificación: Fecha de la última modificación
- Tipo: Tipo/extensión del archivo

Filtros y Búsqueda: 1. Filtros Rápidos: - En el menú "Configuración → Filtros", marca/desmarca tipos de operações (Movido, Renomeado, Adicionado, Excluído, Modificado)

2. Filtros Avanzados:
   - Accede a "Configuración → Filtros → Filtros Avanzados"
   - Filtro de Operación: Selecciona tipos de operações a visualizar
   - Búsqueda: Busca por texto em nome e diretórios
   - Filtro por Extensión: Filtra por tipos específicos de arquivo
   - Filtro de Fecha: Define el período para los eventos
   - Usa el botón de calendario para selección de fechas
   - "Limpiar Filtros" restablece todas las configuraciones

Visualización de Estadísticas: - Accede mediante el botón "Estadísticas" o "Archivo → Estadísticas" - Gráficos disponibles: * Distribución de Operaciones: Proporción de cada tipo de operación * Top 10 Tipos de Archivo: Tipos de archivo más comunes * Línea de Tiempo de Operaciones: Línea temporal de eventos * Mapa de Árbol: Visualización de tamaño por tipos * Distribución por Hora: Horarios con más operaciones * Análisis de Pareto: Frecuencia y porcentaje acumulado * Operaciones por Día: Operaciones agrupadas por fecha - Guardar gráficos: Haz clic en "Guardar Todos" y selecciona destino

Exportación de Datos: - Haz clic en "Guardar Como" o "Archivo → Guardar Como" - Formatos disponibles: * Excel (.xlsx) * CSV (.csv) * Texto (.txt) * JSON (.json) * XML (.xml) * Base de Datos (.db) - Para exportaciones futuras del mismo conjunto, usa "Archivo → Guardar"

Configuración de Columnas: - Accede a "Configuración → Configurar Columnas" - Marca/desmarca columnas deseadas en la tabla: (Tipo de Operación, Nombre, Directorio Anterior, Directorio Actual, etc.) - Los cambios se aplican inmediatamente - Restauración predeterminada: "Configuración → Configurar Columnas → Restablecer Columnas"

Cambio de Idioma: - Accede a "Opciones → Idioma" y selecciona el idioma deseado - El programa se reiniciará con el nuevo idioma después de la confirmación

Resolución de Problemas: 1. El monitoreo no inicia: - Verifica los permisos de acceso al directorio - Asegúrate de que no hay otro programa monitoreando el mismo directorio - Reinicia la aplicación

2. Los eventos no aparecen:
    - Verifica si el monitoreo está activo
    - Comprueba si los filtros no están ocultando eventos
    - Prueba modificando un archivo manualmente

3. Alto consumo de recursos:
    - Evita monitorear directorios del sistema o con miles de archivos
    - Monitorea subdirectorios específicos en lugar de directorios raíz

4. Errores en las estadísticas:
    - Asegúrate de que hay suficientes eventos para generar gráficos
    - Verifica si todas las bibliotecas están correctamente instaladas

Linceu Lighthouse es una aplicación de escritorio desarrollada en Python/PySide6 para monitoreo en tiempo real de operaciones en sistemas de archivos (creación, modificación, eliminación, renombrado, movimiento). Ofrece análisis estadístico avanzado, visualización de datos y exportación en múltiples formatos.

• Framework GUI: PySide6 (Qt6)
• Análisis de Datos: pandas, numpy
• Visualización: matplotlib, seaborn, plotly
• Base de Datos: SQLite3 (con optimizaciones WAL)
• Multithreading: QThread, concurrent.futures
• Internacionalización: Qt Linguist (6 idiomas)

• [S] Single Responsibility: Cada módulo tiene una responsabilidad única
• [O] Open/Closed: Extensible vía herencia (BaseGerador, BaseEvento)
• [L] Liskov Substitution: Todos los generadores de gráfico son intercambiables
• [I] Interface Segregation: Interfaces específicas por tipo de evento
• [D] Dependency Inversion: Inyección de dependencias (loc, interface, db_path)

• Observer Pattern: Monitoreo de archivos
• Factory Pattern: Creación de botones y componentes
• Strategy Pattern: Diferentes estrategias de exportación
• Singleton Pattern: LogManager, DatabaseWriter
• Model-View-Controller: EventTableModel + QTableView
• Template Method: BaseGerador define esqueleto
• Facade Pattern: GerenciadorEstatisticasUI simplifica acceso

• QThread para operaciones largas (escaneo, gráficos)
• ThreadPoolExecutor para procesamiento paralelo
• DatabaseWriter con hilo dedicado
• Debouncing inteligente para eventos
• Caché con invalidación selectiva
• Batch processing para inserciones

• SQLite con modo WAL (Write-Ahead Logging)
• Índices en columnas frecuentes
• Transacciones en lote
• Optimizaciones PRAGMA
• Hilo dedicado para I/O

1. INICIALIZACIÓN
   └─> QApplication.instance()
   └─> Internacionalizador.inicializar_sistema_traducao()
   └─> InterfaceMonitor.__init__()

2. SELECCIÓN DE DIRECTORIO
   └─> GerenciadorBotoes.selecionar_diretorio()
   └─> QFileDialog.getExistingDirectory()

3. INICIO DEL MONITOREO
   └─> Observador.iniciar()
   ├─> DiretorioScanner.scan_directory() [Thread]
   └─> Observador.monitorar() [Thread]

4. PROCESAMIENTO DE EVENTOS
   └─> Observador.processar_evento()
   ├─> EventoAdicionado.processar()
   ├─> EventoExcluido.processar()
   ├─> EventoModificado.processar()
   ├─> EventoRenomeado.processar()
   └─> EventoMovido.verificar_movimentacao()

5. ACTUALIZACIÓN DE LA INTERFAZ
   └─> InterfaceMonitor.inserir_evento_streaming()
   └─> GerenciadorTabela.atualizar_linha_mais_recente()

6. GENERACIÓN DE ESTADÍSTICAS
   └─> GerenciadorEstatisticasUI.mostrar_estatisticas()
   └─> GeradorEstatisticas._gerar_todos_graficos()

7. EXPORTACIÓN DE DATOS
   └─> GerenciadorBotoes.exportar_dados()
   ├─> Excel: pandas.to_excel()
   ├─> CSV: pandas.to_csv()
   ├─> JSON: json.dump()
   └─> XML: ElementTree

8. CAMBIO DE IDIOMA
   └─> GerenciadorEventosUI.alterar_idioma()
   └─> LocalizadorQt.set_idioma()

PySide6>=6.5.0           # Framework Qt6
pandas>=2.0.0            # Análisis de datos
matplotlib>=3.7.0        # Visualización de gráficos
seaborn>=0.12.0          # Gráficos estadísticos
plotly==5.22.0           # Gráficos interactivos
Pillow>=10.0.0           # Procesamiento de imágenes
tinytag>=1.10.0          # Metadatos de audio
pymediainfo>=6.0.0       # Metadatos de video
PyPDF2>=3.0.0            # Metadatos de PDF
openpyxl>=3.1.0          # Lectura/escritura Excel
python-docx>=0.8.11      # Metadatos de DOCX
chardet>=5.1.0           # Detección de codificación
squarify>=0.4.3          # Gráficos treemap
psutil>=5.9.0            # Monitoreo de sistema
pywin32>=305             # API Windows

• Sistema Operativo: Windows 10/11 (64-bit)
• Python: 3.10+
• RAM: 4GB mínimo (8GB recomendado)
• Disco: 100MB espacio disponible

• ✓ Nombres descriptivos y autoexplicativos
• ✓ Funciones pequeñas y enfocadas (< 50 líneas)
• ✓ Evitar números mágicos (usar constantes)
• ✓ Documentación en el código (docstrings)
• ✓ Formato consistente
• ✓ Evitar duplicación de código (DRY)

• ✓ Lazy loading de metadatos
• ✓ Caché de resultados frecuentes
• ✓ Procesamiento asíncrono
• ✓ Batch processing
• ✓ Índices optimizados en la base
• ✓ Uso eficiente de memoria

• ✓ Modularización extrema (200+ módulos)
• ✓ Separación de responsabilidades
• ✓ Bajo acoplamiento
• ✓ Alta cohesión
• ✓ Patrones de nomenclatura consistentes

• Nuevo tipo de gráfico: Heredar de data/GeradorEstatisticas/gst_01_base_gerador.py
• Nuevo tipo de evento: Heredar de services/ob_02_BaseEvento.py
• Nueva columna: Añadir getter en services/ob_09_GerenciadorColunas.py
• Nuevo idioma: Crear linceu_XX.ts en source/locale/
• Nuevo filtro: Añadir en tools/GerenciamentoAdministradorFiltros/

futures==3.0.5
kaleido==0.2.1
plotly==5.22.0

• monitoramento.db - Base de datos principal (SQLite)
• language_config.json - Preferencia de idioma
• colunas_coloridas.json - Configuración de colores
• cores_operacoes.json - Colores por tipo de operación
• config.json - Configuraciones generales

Sistema de logs con rotación automática en:

%APPDATA%/Linceu_Lighthouse/logs/

Autores: Fernando Nillsson Cidade
Versión: v0.1.3.0
Licencia: GNU Affero General Public License v3.0 (AGPL-3.0)

Para más información, consulte la documentación específica de cada módulo en el código fuente.

Projet : LINCEU LIGHTHOUSE
Version : v0.1.3.0
Auteurs : Fernando Nillsson Cidade

Description : Visibilité et Contrôle sur Vos Fichiers

Linceu Lighthouse est un outil de surveillance qui applique les principes de Surveillance de l'Intégrité des Fichiers (File Integrity Monitoring - FIM) pour fournir un journal détaillé et transparent de toutes les activités dans vos répertoires les plus importants.

Au lieu d'interpréter l'intention derrière un changement, son objectif est d'enregistrer factuellement chaque opération—création, modification, suppression et renommage—vous donnant un contrôle et une connaissance totale de ce qui se passe.

Principaux Cas d'Usage

Linceu Lighthouse fournit la visibilité nécessaire pour divers scénarios pratiques :

• Audit des Activités dans les Dossiers : Idéal pour les environnements où plusieurs utilisateurs ou processus accèdent aux mêmes répertoires. Sachez exactement quand un fichier a été modifié, qui l'a renommé ou pourquoi un document a été supprimé.
• Contrôle des Versions et des Projets : Surveillez les dossiers de projets pour comprendre le flux de travail. Consultez l'historique des modifications dans le code source, les documents de conception ou d'autres matériaux, aidant à prévenir les pertes accidentelles ou les modifications non autorisées.
• Organisation et Nettoyage des Fichiers : Identifiez les fichiers temporaires, en double ou qui n'ont pas été modifiés depuis longtemps. Utilisez les rapports pour prendre des décisions éclairées sur ce qu'il faut archiver, déplacer ou supprimer, gardant vos répertoires organisés.
• Enquête sur des Événements Spécifiques : Si un fichier important disparaît ou qu'un projet cesse de fonctionner, Linceu Lighthouse fournit l'historique chronologique des événements pour vous aider à retracer la cause première du problème.

Comment Fonctionne Linceu Lighthouse ?

Le processus est simple et axé sur la fourniture de données claires pour votre analyse :

1. Établissement de la Ligne de Base (Baseline) : Lors du démarrage de la surveillance d'un répertoire, Linceu Lighthouse effectue une analyse complète pour créer un "instantané" initial de l'état de tous les fichiers et dossiers.
2. Surveillance Continue : À partir de la ligne de base, l'outil surveille en temps réel et enregistre chaque événement de création, modification, suppression, déplacement ou renommage qui se produit dans le répertoire.
3. Analyse et Rapport : Tout écart par rapport à la ligne de base est immédiatement répertorié dans l'interface graphique. De là, vous avez le plein pouvoir d'analyser ce qui s'est passé, en utilisant les outils que le logiciel offre.

Outils d'Analyse à Votre Disposition

Pour transformer le grand volume de données de surveillance en informations utiles, Linceu Lighthouse offre :

• Filtres Avancés : Ne vous perdez pas parmi des milliers d'événements. Isolez rapidement ce qui compte en filtrant par type d'opération (ex : voir uniquement les fichiers supprimés), par date, par extension (.docx, .jpg), ou par utilisateur.
• Visualisation des Statistiques : Transformez les données brutes en informations visuelles. Avec des graphiques intuitifs, vous pouvez comprendre les modèles d'activité, tels que les heures de pointe des modifications, les types de fichiers les plus modifiés, et bien plus encore.
• Exportation Flexible des Données : Créez un enregistrement permanent et vérifiable. Exportez les journaux de surveillance vers divers formats (Excel, CSV, JSON, XML), que ce soit pour l'archivage, le partage avec votre équipe ou l'importation dans d'autres systèmes.

MANUEL D'UTILISATION RAPIDE :

Comment utiliser :

1. Exécutez l'application pour démarrer l'interface graphique.
2. Sélectionnez un répertoire à surveiller.
3. Utilisez les boutons et menus pour démarrer/arrêter la surveillance, appliquer des filtres, exporter des données et visualiser des statistiques.

MANUEL D'UTILISATION DÉTAILLÉ :

Configuration Système Requise : - Système d'Exploitation : Windows 10 ou supérieur.

Installation : - Installez le fichier exécutable du programme, suivez les instructions de l'installateur et exécutez le programme.

Configuration Initiale : - L'interface s'affichera avec le tableau de surveillance vide. - La langue par défaut sera sélectionnée selon les paramètres du système. - Observez la barre latérale gauche pour accéder aux fonctions principales.

Surveillance des Répertoires : 1. Sélectionner un Répertoire : - Cliquez sur le bouton "Sélectionner un Répertoire" ou sélectionnez "Fichier → Sélectionner un Répertoire" - Le chemin du répertoire sélectionné sera affiché au-dessus du tableau

2. Démarrer/Arrêter la Surveillance :
   - Cliquez sur le bouton "Démarrer/Arrêter" ou sélectionnez "Fichier → Démarrer/Arrêter"
   - Une analyse initiale du répertoire sera effectuée avec une barre de progression
   - Pour arrêter la surveillance, cliquez à nouveau sur le même bouton

Interface Principale : - Barre de Menu : Accès à toutes les fonctions du programme - Barre Latérale : Boutons d'actions rapides - Étiquette de Répertoire : Affiche le répertoire surveillé - Étiquette de Résultat : Affiche l'état actuel de l'opération - Tableau de Données : Affiche tous les événements de surveillance - Barre de Progression : Visible pendant les opérations de longue durée

Champs par défaut du tableau :
- Type d'Opération : Ajouté, Supprimé, Modifié, Renommé ou Déplacé
- Nom : Nom du fichier
- Répertoire Précédent : Emplacement d'origine du fichier (le cas échéant)
- Répertoire Actuel : Emplacement actuel du fichier
- Date de Création : Date à laquelle le fichier a été créé
- Date de Modification : Date de la dernière modification
- Type : Type/extension du fichier

Filtres et Recherche : 1. Filtres Rapides : - Dans le menu "Paramètres → Filtres", cochez/décochez les types d'opérations (Déplacé, Renommé, Ajouté, Supprimé, Modifié)

2. Filtres Avancés :
   - Accédez à "Paramètres → Filtres → Filtres Avancés"
   - Filtre d'Opération : Sélectionnez les types d'opérations à visualiser
   - Recherche : Recherche de texte dans les noms et répertoires
   - Filtre par Extension : Filtrez par types de fichiers spécifiques
   - Filtre de Date : Définissez la période pour les événements
   - Utilisez le bouton calendrier pour la sélection des dates
   - "Effacer les Filtres" réinitialise tous les paramètres

Visualisation des Statistiques : - Accédez via le bouton "Statistiques" ou "Fichier → Statistiques" - Graphiques disponibles : * Distribution des Opérations : Proportion de chaque type d'opération * Top 10 des Types de Fichiers : Types de fichiers les plus courants * Chronologie des Opérations : Ligne de temps des événements * Carte Arborescente : Visualisation de la taille par types * Distribution par Heure : Heures avec le plus d'opérations * Analyse de Pareto : Fréquence et pourcentage cumulé * Opérations par Jour : Opérations regroupées par date - Enregistrer les graphiques : Cliquez sur "Tout Enregistrer" et sélectionnez la destination

Exportation des Données : - Cliquez sur "Enregistrer Sous" ou "Fichier → Enregistrer Sous" - Formats disponibles : * Excel (.xlsx) * CSV (.csv) * Texte (.txt) * JSON (.json) * XML (.xml) * Base de Données (.db) - Pour les exportations futures du même ensemble, utilisez "Fichier → Enregistrer"

Configuration des Colonnes : - Accédez à "Paramètres → Configurer les Colonnes" - Cochez/décochez les colonnes souhaitées dans le tableau : (Type d'Opération, Nom, Répertoire Précédent, Répertoire Actuel, etc.) - Les modifications sont appliquées immédiatement - Restauration par défaut : "Paramètres → Configurer les Colonnes → Réinitialiser les Colonnes"

Changement de Langue : - Accédez à "Options → Langue" et sélectionnez la langue souhaitée - Le programme redémarrera avec la nouvelle langue après confirmation

Résolution de Problèmes : 1. La surveillance ne démarre pas : - Vérifiez les autorisations d'accès au répertoire - Assurez-vous qu'aucun autre programme ne surveille le même répertoire - Redémarrez l'application

2. Les événements n'apparaissent pas :
    - Vérifiez si la surveillance est active
    - Vérifiez si les filtres ne cachent pas les événements
    - Testez en modifiant manuellement un fichier

3. Consommation élevée de ressources :
    - Évitez de surveiller les répertoires système ou ceux contenant des milliers de fichiers
    - Surveillez des sous-répertoires spécifiques au lieu des répertoires racine

4. Erreurs dans les statistiques :
    - Assurez-vous qu'il y a suffisamment d'événements pour générer des graphiques
    - Vérifiez si toutes les bibliothèques sont correctement installées

Linceu Lighthouse est une application de bureau développée en Python/PySide6 pour la surveillance en temps réel des opérations sur les systèmes de fichiers (création, modification, suppression, renommage, déplacement). Elle offre une analyse statistique avancée, la visualisation des données et l'exportation dans plusieurs formats.

• Framework GUI: PySide6 (Qt6)
• Analyse de Données: pandas, numpy
• Visualisation: matplotlib, seaborn, plotly
• Base de Données: SQLite3 (avec optimisations WAL)
• Multithreading: QThread, concurrent.futures
• Internationalisation: Qt Linguist (6 langues)

• [S] Single Responsibility: Chaque module a une responsabilité unique
• [O] Open/Closed: Extensible via héritage (BaseGerador, BaseEvento)
• [L] Liskov Substitution: Tous les générateurs de graphiques sont interchangeables
• [I] Interface Segregation: Interfaces spécifiques par type d'événement
• [D] Dependency Inversion: Injection de dépendances (loc, interface, db_path)

• Observer Pattern: Surveillance des fichiers
• Factory Pattern: Création de boutons et composants
• Strategy Pattern: Différentes stratégies d'exportation
• Singleton Pattern: LogManager, DatabaseWriter
• Model-View-Controller: EventTableModel + QTableView
• Template Method: BaseGerador définit le squelette
• Facade Pattern: GerenciadorEstatisticasUI simplifie l'accès

• QThread pour les opérations longues (analyse, graphiques)
• ThreadPoolExecutor pour le traitement parallèle
• DatabaseWriter avec thread dédié
• Debouncing intelligent pour les événements
• Cache avec invalidation sélective
• Traitement par lots pour les insertions

• SQLite avec mode WAL (Write-Ahead Logging)
• Index sur les colonnes fréquentes
• Transactions par lots
• Optimisations PRAGMA
• Thread dédié pour I/O

1. INITIALISATION
   └─> QApplication.instance()
   └─> Internacionalizador.inicializar_sistema_traducao()
   └─> InterfaceMonitor.__init__()

2. SÉLECTION DE RÉPERTOIRE
   └─> GerenciadorBotoes.selecionar_diretorio()
   └─> QFileDialog.getExistingDirectory()

3. DÉMARRAGE DE LA SURVEILLANCE
   └─> Observador.iniciar()
   ├─> DiretorioScanner.scan_directory() [Thread]
   └─> Observador.monitorar() [Thread]

4. TRAITEMENT DES ÉVÉNEMENTS
   └─> Observador.processar_evento()
   ├─> EventoAdicionado.processar()
   ├─> EventoExcluido.processar()
   ├─> EventoModificado.processar()
   ├─> EventoRenomeado.processar()
   └─> EventoMovido.verificar_movimentacao()

5. MISE À JOUR DE L'INTERFACE
   └─> InterfaceMonitor.inserir_evento_streaming()
   └─> GerenciadorTabela.atualizar_linha_mais_recente()

6. GÉNÉRATION DE STATISTIQUES
   └─> GerenciadorEstatisticasUI.mostrar_estatisticas()
   └─> GeradorEstatisticas._gerar_todos_graficos()

7. EXPORTATION DE DONNÉES
   └─> GerenciadorBotoes.exportar_dados()
   ├─> Excel: pandas.to_excel()
   ├─> CSV: pandas.to_csv()
   ├─> JSON: json.dump()
   └─> XML: ElementTree

8. CHANGEMENT DE LANGUE
   └─> GerenciadorEventosUI.alterar_idioma()
   └─> LocalizadorQt.set_idioma()

PySide6>=6.5.0           # Framework Qt6
pandas>=2.0.0            # Analyse de données
matplotlib>=3.7.0        # Visualisation de graphiques
seaborn>=0.12.0          # Graphiques statistiques
plotly==5.22.0           # Graphiques interactifs
Pillow>=10.0.0           # Traitement d'images
tinytag>=1.10.0          # Métadonnées audio
pymediainfo>=6.0.0       # Métadonnées vidéo
PyPDF2>=3.0.0            # Métadonnées PDF
openpyxl>=3.1.0          # Lecture/écriture Excel
python-docx>=0.8.11      # Métadonnées DOCX
chardet>=5.1.0           # Détection d'encodage
squarify>=0.4.3          # Graphiques treemap
psutil>=5.9.0            # Surveillance système
pywin32>=305             # API Windows

• Système d'Exploitation: Windows 10/11 (64-bit)
• Python: 3.10+
• RAM: 4GB minimum (8GB recommandé)
• Disque: 100MB d'espace disponible

• ✓ Noms descriptifs et auto-explicatifs
• ✓ Fonctions petites et ciblées (< 50 lignes)
• ✓ Éviter les nombres magiques (utiliser des constantes)
• ✓ Documentation dans le code (docstrings)
• ✓ Formatage cohérent
• ✓ Éviter la duplication de code (DRY)

• ✓ Lazy loading des métadonnées
• ✓ Cache des résultats fréquents
• ✓ Traitement asynchrone
• ✓ Traitement par lots
• ✓ Index optimisés dans la base
• ✓ Utilisation efficace de la mémoire

• ✓ Modularisation extrême (200+ modules)
• ✓ Séparation des responsabilités
• ✓ Faible couplage
• ✓ Haute cohésion
• ✓ Modèles de nomenclature cohérents

• Nouveau type de graphique: Hériter de data/GeradorEstatisticas/gst_01_base_gerador.py
• Nouveau type d'événement: Hériter de services/ob_02_BaseEvento.py
• Nouvelle colonne: Ajouter un getter dans services/ob_09_GerenciadorColunas.py
• Nouvelle langue: Créer linceu_XX.ts dans source/locale/
• Nouveau filtre: Ajouter dans tools/GerenciamentoAdministradorFiltros/

futures==3.0.5
kaleido==0.2.1
plotly==5.22.0

• monitoramento.db - Base de données principale (SQLite)
• language_config.json - Préférence de langue
• colunas_coloridas.json - Configuration des couleurs
• cores_operacoes.json - Couleurs par type d'opération
• config.json - Paramètres généraux

Système de journalisation avec rotation automatique dans:

%APPDATA%/Linceu_Lighthouse/logs/

Auteurs: Fernando Nillsson Cidade
Version: v0.1.3.0
Licence: GNU Affero General Public License v3.0 (AGPL-3.0)

Pour plus d'informations, consultez la documentation spécifique de chaque module dans le code source.

Progetto: LINCEU LIGHTHOUSE
Versione: v0.1.3.0
Autori: Fernando Nillsson Cidade

Descrizione: Visibilità e Controllo sui Tuoi File

Linceu Lighthouse è uno strumento di monitoraggio che applica i principi del Monitoraggio dell'Integrità dei File (File Integrity Monitoring - FIM) per fornire un registro dettagliato e trasparente di tutte le attività nelle tue directory più importanti.

Invece di interpretare l'intenzione dietro un cambiamento, il suo obiettivo è registrare in modo fattuale ogni operazione—creazione, modifica, eliminazione e rinominazione—dandoti controllo e conoscenza totale di ciò che accade.

Principali Casi d'Uso

Linceu Lighthouse fornisce la visibilità necessaria per vari scenari pratici:

• Audit delle Attività nelle Cartelle: Ideale per ambienti in cui più utenti o processi accedono alle stesse directory. Scopri esattamente quando un file è stato modificato, chi lo ha rinominato o perché un documento è stato eliminato.
• Controllo di Versioni e Progetti: Monitora le cartelle dei progetti per comprendere il flusso di lavoro. Visualizza la cronologia delle modifiche nel codice sorgente, nei documenti di progettazione o in altri materiali, aiutando a prevenire perdite accidentali o modifiche non autorizzate.
• Organizzazione e Pulizia dei File: Identifica file temporanei, duplicati o che non sono stati modificati da molto tempo. Usa i report per prendere decisioni informate su cosa archiviare, spostare o eliminare, mantenendo le tue directory organizzate.
• Indagine su Eventi Specifici: Se un file importante scompare o un progetto smette di funzionare, Linceu Lighthouse fornisce la cronologia cronologica degli eventi per aiutarti a rintracciare la causa principale del problema.

Come Funziona Linceu Lighthouse?

Il processo è semplice e focalizzato sulla fornitura di dati chiari per la tua analisi:

1. Stabilimento della Linea di Base (Baseline): All'avvio del monitoraggio di una directory, Linceu Lighthouse esegue una scansione completa per creare un'"istantanea" iniziale dello stato di tutti i file e cartelle.
2. Monitoraggio Continuo: A partire dalla linea di base, lo strumento monitora in tempo reale e registra ogni evento di creazione, modifica, eliminazione, spostamento o rinominazione che si verifica nella directory.
3. Analisi e Report: Qualsiasi deviazione dalla linea di base viene immediatamente elencata nell'interfaccia grafica. Da lì, hai il pieno potere di analizzare cosa è successo, utilizzando gli strumenti che il software offre.

Strumenti di Analisi a Tua Disposizione

Per trasformare il grande volume di dati di monitoraggio in informazioni utili, Linceu Lighthouse offre:

• Filtri Avanzati: Non perderti tra migliaia di eventi. Isola rapidamente ciò che conta, filtrando per tipo di operazione (es: visualizzare solo i file eliminati), per data, per estensione (.docx, .jpg), o per utente.
• Visualizzazione delle Statistiche: Trasforma i dati grezzi in intuizioni visive. Con grafici intuitivi, puoi comprendere i modelli di attività, come gli orari di punta delle modifiche, i tipi di file più modificati e molto altro.
• Esportazione Flessibile dei Dati: Crea un registro permanente e verificabile. Esporta i log di monitoraggio in vari formati (Excel, CSV, JSON, XML), sia per l'archiviazione, per condividere con il tuo team, o per importare in altri sistemi.

MANUALE D'USO RAPIDO:

Come usare:

1. Esegui l'applicazione per avviare l'interfaccia grafica.
2. Seleziona una directory da monitorare.
3. Usa i pulsanti e i menu per avviare/fermare il monitoraggio, applicare filtri, esportare dati e visualizzare statistiche.

MANUALE D'USO DETTAGLIATO:

Requisiti di Sistema: - Sistema Operativo: Windows 10 o superiore.

Installazione: - Installa il file eseguibile del programma, segui le istruzioni dell'installatore ed esegui il programma.

Configurazione Iniziale: - L'interfaccia verrà visualizzata con la tabella di monitoraggio vuota. - La lingua predefinita verrà selezionata in base alle impostazioni del sistema. - Osserva la barra laterale sinistra per accedere alle funzioni principali.

Monitoraggio delle Directory: 1. Selezionare una Directory: - Fai clic sul pulsante "Seleziona Directory" o seleziona "File → Seleziona Directory" - Il percorso della directory selezionata verrà visualizzato sopra la tabella

2. Avviare/Fermare il Monitoraggio:
   - Fai clic sul pulsante "Avvia/Ferma" o seleziona "File → Avvia/Ferma"
   - Verrà eseguita una scansione iniziale della directory con barra di avanzamento
   - Per interrompere il monitoraggio, fai clic di nuovo sullo stesso pulsante

Interfaccia Principale: - Barra dei Menu: Accesso a tutte le funzioni del programma - Barra Laterale: Pulsanti di azioni rapide - Etichetta Directory: Visualizza la directory monitorata - Etichetta Risultato: Mostra lo stato attuale dell'operazione - Tabella Dati: Visualizza tutti gli eventi di monitoraggio - Barra di Avanzamento: Visibile durante operazioni di lunga durata

Campi predefiniti della tabella:
- Tipo di Operazione: Aggiunto, Eliminato, Modificato, Rinominato o Spostato
- Nome: Nome del file
- Directory Precedente: Posizione originale del file (se applicabile)
- Directory Attuale: Posizione attuale del file
- Data di Creazione: Data in cui il file è stato creato
- Data di Modifica: Data dell'ultima modifica
- Tipo: Tipo/estensione del file

Filtri e Ricerca: 1. Filtri Rapidi: - Nel menu "Impostazioni → Filtri" attiva/disattiva i tipi di operazioni (Spostato, Rinominato, Aggiunto, Eliminato, Modificato)

2. Filtri Avanzati:
   - Accedi a "Impostazioni → Filtri → Filtri Avanzati"
   - Filtro Operazione: Seleziona i tipi di operazioni da visualizzare
   - Ricerca: Cerca testo in nomi e directory
   - Filtro per Estensione: Filtra per tipi di file specifici
   - Filtro Data: Definisci il periodo per gli eventi
   - Usa il pulsante calendario per la selezione delle date
   - "Cancella Filtri" ripristina tutte le impostazioni

Visualizzazione delle Statistiche: - Accedi tramite il pulsante "Statistiche" o "File → Statistiche" - Grafici disponibili: * Distribuzione delle Operazioni: Proporzione di ogni tipo di operazione * Top 10 Tipi di File: Tipi di file più comuni * Linea Temporale delle Operazioni: Timeline degli eventi * Mappa ad Albero: Visualizzazione della dimensione per tipi * Distribuzione per Ora: Orari con più operazioni * Analisi di Pareto: Frequenza e percentuale cumulativa * Operazioni per Giorno: Operazioni raggruppate per data - Salvare grafici: Fai clic su "Salva Tutto" e seleziona la destinazione

Esportazione dei Dati: - Fai clic su "Salva Come" o "File → Salva Come" - Formati disponibili: * Excel (.xlsx) * CSV (.csv) * Testo (.txt) * JSON (.json) * XML (.xml) * Database (.db) - Per esportazioni future dello stesso set, usa "File → Salva"

Configurazione delle Colonne: - Accedi a "Impostazioni → Configura Colonne" - Attiva/disattiva le colonne desiderate nella tabella: (Tipo di Operazione, Nome, Directory Precedente, Directory Attuale, ecc.) - Le modifiche vengono applicate immediatamente - Ripristino predefinito: "Impostazioni → Configura Colonne → Ripristina Colonne"

Cambio Lingua: - Accedi a "Opzioni → Lingua" e seleziona la lingua desiderata - Il programma verrà riavviato con la nuova lingua dopo la conferma

Risoluzione dei Problemi: 1. Il monitoraggio non si avvia: - Verifica i permessi di accesso alla directory - Assicurati che non ci sia un altro programma che monitora la stessa directory - Riavvia l'applicazione

2. Gli eventi non appaiono:
    - Verifica se il monitoraggio è attivo
    - Controlla se i filtri non stanno nascondendo gli eventi
    - Prova modificando manualmente un file

3. Alto consumo di risorse:
    - Evita di monitorare directory di sistema o con migliaia di file
    - Monitora sottodirectory specifiche invece delle directory radice

4. Errori nelle statistiche:
    - Assicurati che ci siano abbastanza eventi per generare grafici
    - Verifica se tutte le librerie sono correttamente installate

Linceu Lighthouse è un'applicazione desktop sviluppata in Python/PySide6 per il monitoraggio in tempo reale delle operazioni sui file system (creazione, modifica, eliminazione, rinominazione, spostamento). Offre analisi statistiche avanzate, visualizzazione dei dati ed esportazione in molteplici formati.

• Framework GUI: PySide6 (Qt6)
• Analisi Dati: pandas, numpy
• Visualizzazione: matplotlib, seaborn, plotly
• Database: SQLite3 (con ottimizzazioni WAL)
• Multithreading: QThread, concurrent.futures
• Internazionalizzazione: Qt Linguist (6 lingue)

• [S] Single Responsibility: Ogni modulo ha una responsabilità unica
• [O] Open/Closed: Estensibile via ereditarietà (BaseGerador, BaseEvento)
• [L] Liskov Substitution: Tutti i generatori di grafici sono intercambiabili
• [I] Interface Segregation: Interfacce specifiche per tipo di evento
• [D] Dependency Inversion: Iniezione dipendenze (loc, interface, db_path)

• Observer Pattern: Monitoraggio file
• Factory Pattern: Creazione pulsanti e componenti
• Strategy Pattern: Diverse strategie esportazione
• Singleton Pattern: LogManager, DatabaseWriter
• Model-View-Controller: EventTableModel + QTableView
• Template Method: BaseGerador definisce scheletro
• Facade Pattern: GerenciadorEstatisticasUI semplifica accesso

• QThread per operazioni lunghe (scansione, grafici)
• ThreadPoolExecutor per elaborazione parallela
• DatabaseWriter con thread dedicato
• Debouncing intelligente per eventi
• Cache con invalidazione selettiva
• Batch processing per inserimenti

• SQLite con modalità WAL (Write-Ahead Logging)
• Indici su colonne frequenti
• Transazioni in batch
• Ottimizzazioni PRAGMA
• Thread dedicato per I/O

1. INIZIALIZZAZIONE
   └─> QApplication.instance()
   └─> Internacionalizador.inicializar_sistema_traducao()
   └─> InterfaceMonitor.__init__()

2. SELEZIONE DIRECTORY
   └─> GerenciadorBotoes.selecionar_diretorio()
   └─> QFileDialog.getExistingDirectory()

3. AVVIO MONITORAGGIO
   └─> Observador.iniciar()
   ├─> DiretorioScanner.scan_directory() [Thread]
   └─> Observador.monitorar() [Thread]

4. ELABORAZIONE EVENTI
   └─> Observador.processar_evento()
   ├─> EventoAdicionado.processar()
   ├─> EventoExcluido.processar()
   ├─> EventoModificado.processar()
   ├─> EventoRenomeado.processar()
   └─> EventoMovido.verificar_movimentacao()

5. AGGIORNAMENTO INTERFACCIA
   └─> InterfaceMonitor.inserir_evento_streaming()
   └─> GerenciadorTabela.atualizar_linha_mais_recente()

6. GENERAZIONE STATISTICHE
   └─> GerenciadorEstatisticasUI.mostrar_estatisticas()
   └─> GeradorEstatisticas._gerar_todos_graficos()

7. ESPORTAZIONE DATI
   └─> GerenciadorBotoes.exportar_dados()
   ├─> Excel: pandas.to_excel()
   ├─> CSV: pandas.to_csv()
   ├─> JSON: json.dump()
   └─> XML: ElementTree

8. CAMBIO LINGUA
   └─> GerenciadorEventosUI.alterar_idioma()
   └─> LocalizadorQt.set_idioma()

PySide6>=6.5.0           # Framework Qt6
pandas>=2.0.0            # Analisi dati
matplotlib>=3.7.0        # Visualizzazione grafici
seaborn>=0.12.0          # Grafici statistici
plotly==5.22.0           # Grafici interattivi
Pillow>=10.0.0           # Elaborazione immagini
tinytag>=1.10.0          # Metadati audio
pymediainfo>=6.0.0       # Metadati video
PyPDF2>=3.0.0            # Metadati PDF
openpyxl>=3.1.0          # Lettura/scrittura Excel
python-docx>=0.8.11      # Metadati DOCX
chardet>=5.1.0           # Rilevamento codifica
squarify>=0.4.3          # Grafici treemap
psutil>=5.9.0            # Monitoraggio sistema
pywin32>=305             # API Windows

• Sistema Operativo: Windows 10/11 (64-bit)
• Python: 3.10+
• RAM: 4GB minimo (8GB consigliato)
• Disco: 100MB spazio disponibile

• ✓ Nomi descrittivi e autoesplicativi
• ✓ Funzioni piccole e focalizzate (< 50 righe)
• ✓ Evitare numeri magici (usare costanti)
• ✓ Documentazione nel codice (docstring)
• ✓ Formattazione consistente
• ✓ Evitare duplicazione codice (DRY)

• ✓ Lazy loading metadati
• ✓ Cache risultati frequenti
• ✓ Elaborazione asincrona
• ✓ Batch processing
• ✓ Indici ottimizzati nel database
• ✓ Uso efficiente memoria

• ✓ Modularizzazione estrema (200+ moduli)
• ✓ Separazione responsabilità
• ✓ Basso accoppiamento
• ✓ Alta coesione
• ✓ Pattern nomenclatura consistenti

• Nuovo tipo grafico: Ereditare da data/GeradorEstatisticas/gst_01_base_gerador.py
• Nuovo tipo evento: Ereditare da services/ob_02_BaseEvento.py
• Nuova colonna: Aggiungere getter in services/ob_09_GerenciadorColunas.py
• Nuova lingua: Creare linceu_XX.ts in source/locale/
• Nuovo filtro: Aggiungere in tools/GerenciamentoAdministradorFiltros/

futures==3.0.5
kaleido==0.2.1
plotly==5.22.0

• monitoramento.db - Database principale (SQLite)
• language_config.json - Preferenza lingua
• colunas_coloridas.json - Configurazione colori
• cores_operacoes.json - Colori per tipo operazione
• config.json - Impostazioni generali

Sistema log con rotazione automatica in:

%APPDATA%/Linceu_Lighthouse/logs/

Autori: Fernando Nillsson Cidade
Versione: v0.1.3.0
Licenza: GNU Affero General Public License v3.0 (AGPL-3.0)

Per maggiori informazioni, consultare la documentazione specifica di ogni modulo nel codice sorgente.

Projekt: LINCEU LIGHTHOUSE
Version: v0.1.3.0
Autoren: Fernando Nillsson Cidade

Beschreibung: Sichtbarkeit und Kontrolle über Ihre Dateien

Linceu Lighthouse ist ein Überwachungstool, das die Prinzipien der Dateiintegritätsüberwachung (File Integrity Monitoring - FIM) anwendet, um ein detailliertes und transparentes Protokoll aller Aktivitäten in Ihren wichtigsten Verzeichnissen bereitzustellen.

Anstatt die Absicht hinter einer Änderung zu interpretieren, konzentriert es sich darauf, jede Operation faktisch zu erfassen—Erstellung, Änderung, Löschung und Umbenennung—und gibt Ihnen vollständige Kontrolle und Kenntnis darüber, was geschieht.

Hauptanwendungsfälle

Linceu Lighthouse bietet die notwendige Sichtbarkeit für verschiedene praktische Szenarien:

• Prüfung von Ordneraktivitäten: Ideal für Umgebungen, in denen mehrere Benutzer oder Prozesse auf dieselben Verzeichnisse zugreifen. Erfahren Sie genau, wann eine Datei geändert wurde, wer sie umbenannt hat oder warum ein Dokument gelöscht wurde.
• Versions- und Projektkontrolle: Überwachen Sie Projektordner, um den Arbeitsablauf zu verstehen. Sehen Sie die Historie der Änderungen im Quellcode, in Designdokumenten oder anderen Materialien und helfen Sie, versehentliche Verluste oder unbefugte Änderungen zu verhindern.
• Dateiorganisation und -bereinigung: Identifizieren Sie temporäre, doppelte oder lange nicht geänderte Dateien. Nutzen Sie die Berichte, um fundierte Entscheidungen darüber zu treffen, was archiviert, verschoben oder gelöscht werden soll, und halten Sie Ihre Verzeichnisse organisiert.
• Untersuchung spezifischer Ereignisse: Wenn eine wichtige Datei verschwindet oder ein Projekt nicht mehr funktioniert, bietet Linceu Lighthouse die chronologische Ereignisgeschichte, um Ihnen zu helfen, die Grundursache des Problems zu verfolgen.

Wie Funktioniert Linceu Lighthouse?

Der Prozess ist unkompliziert und konzentriert sich darauf, klare Daten für Ihre Analyse bereitzustellen:

1. Festlegung der Basislinie (Baseline): Beim Start der Überwachung eines Verzeichnisses führt Linceu Lighthouse einen vollständigen Scan durch, um eine anfängliche "Momentaufnahme" des Zustands aller Dateien und Ordner zu erstellen.
2. Kontinuierliche Überwachung: Von der Basislinie aus überwacht das Tool in Echtzeit und zeichnet jedes Ereignis der Erstellung, Änderung, Löschung, Verschiebung oder Umbenennung auf, das im Verzeichnis auftritt.
3. Analyse und Bericht: Jede Abweichung von der Basislinie wird sofort in der grafischen Oberfläche aufgelistet. Von dort aus haben Sie die volle Macht, zu analysieren, was passiert ist, und die vom Software angebotenen Tools zu nutzen.

Analysetools zu Ihrer Verfügung

Um das große Volumen an Überwachungsdaten in nützliche Informationen zu verwandeln, bietet Linceu Lighthouse:

• Erweiterte Filter: Verlieren Sie sich nicht in Tausenden von Ereignissen. Isolieren Sie schnell, was wichtig ist, indem Sie nach Operationstyp (z. B. nur gelöschte Dateien anzeigen), nach Datum, nach Erweiterung (.docx, .jpg) oder nach Benutzer filtern.
• Statistikvisualisierung: Verwandeln Sie Rohdaten in visuelle Einblicke. Mit intuitiven Diagrammen können Sie Aktivitätsmuster verstehen, wie z. B. Spitzenzeiten für Änderungen, die am häufigsten geänderten Dateitypen und vieles mehr.
• Flexibler Datenexport: Erstellen Sie eine dauerhafte und prüfbare Aufzeichnung. Exportieren Sie Überwachungsprotokolle in verschiedene Formate (Excel, CSV, JSON, XML), sei es zur Archivierung, zum Teilen mit Ihrem Team oder zum Importieren in andere Systeme.

SCHNELLSTARTANLEITUNG:

So verwenden Sie:

1. Führen Sie die Anwendung aus, um die grafische Oberfläche zu starten.
2. Wählen Sie ein zu überwachendes Verzeichnis aus.
3. Verwenden Sie die Schaltflächen und Menüs, um die Überwachung zu starten/stoppen, Filter anzuwenden, Daten zu exportieren und Statistiken anzuzeigen.

DETAILLIERTE BEDIENUNGSANLEITUNG:

Systemanforderungen: - Betriebssystem: Windows 10 oder höher.

Installation: - Installieren Sie die ausführbare Datei des Programms, folgen Sie den Anweisungen des Installationsprogramms und führen Sie das Programm aus.

Ersteinrichtung: - Die Oberfläche wird mit einer leeren Überwachungstabelle angezeigt. - Die Standardsprache wird entsprechend den Systemeinstellungen ausgewählt. - Beachten Sie die linke Seitenleiste, um auf die Hauptfunktionen zuzugreifen.

Verzeichnisüberwachung: 1. Verzeichnis Auswählen: - Klicken Sie auf die Schaltfläche "Verzeichnis Auswählen" oder wählen Sie "Datei → Verzeichnis Auswählen" - Der Pfad des ausgewählten Verzeichnisses wird über der Tabelle angezeigt

2. Überwachung Starten/Stoppen:
   - Klicken Sie auf die Schaltfläche "Starten/Stoppen" oder wählen Sie "Datei → Starten/Stoppen"
   - Ein anfänglicher Scan des Verzeichnisses wird mit Fortschrittsbalken durchgeführt
   - Um die Überwachung zu stoppen, klicken Sie erneut auf dieselbe Schaltfläche

Hauptoberfläche: - Menüleiste: Zugriff auf alle Programmfunktionen - Seitenleiste: Schaltflächen für schnelle Aktionen - Verzeichnisbezeichnung: Zeigt das überwachte Verzeichnis an - Ergebnisbezeichnung: Zeigt den aktuellen Status der Operation an - Datentabelle: Zeigt alle Überwachungsereignisse an - Fortschrittsbalken: Sichtbar während langwieriger Operationen

Standardfelder der Tabelle:
- Operationstyp: Hinzugefügt, Gelöscht, Geändert, Umbenannt oder Verschoben
- Name: Dateiname
- Vorheriges Verzeichnis: Ursprünglicher Speicherort der Datei (falls zutreffend)
- Aktuelles Verzeichnis: Aktueller Speicherort der Datei
- Erstellungsdatum: Datum, an dem die Datei erstellt wurde
- Änderungsdatum: Datum der letzten Änderung
- Typ: Dateityp/Erweiterung

Filter und Suche: 1. Schnellfilter: - Im Menü "Einstellungen → Filter" aktivieren/deaktivieren Sie Operationstypen (Verschoben, Umbenannt, Hinzugefügt, Gelöscht, Geändert)

2. Erweiterte Filter:
   - Zugriff über "Einstellungen → Filter → Erweiterte Filter"
   - Operationsfilter: Wählen Sie anzuzeigende Operationstypen aus
   - Suche: Suchen Sie nach Text in Namen und Verzeichnissen
   - Erweiterungsfilter: Filtern Sie nach bestimmten Dateitypen
   - Datumsfilter: Definieren Sie den Zeitraum für Ereignisse
   - Verwenden Sie die Kalenderschaltfläche zur Datumsauswahl
   - "Filter Löschen" setzt alle Einstellungen zurück

Statistikvisualisierung: - Zugriff über die Schaltfläche "Statistiken" oder "Datei → Statistiken" - Verfügbare Diagramme: * Operationsverteilung: Anteil jedes Operationstyps * Top 10 Dateitypen: Häufigste Dateitypen * Operations-Zeitleiste: Zeitleiste der Ereignisse * Baumkarte: Visualisierung der Größe nach Typen * Verteilung nach Stunde: Zeiten mit den meisten Operationen * Pareto-Analyse: Häufigkeit und kumulativer Prozentsatz * Operationen nach Tag: Nach Datum gruppierte Operationen - Diagramme speichern: Klicken Sie auf "Alle Speichern" und wählen Sie ein Ziel

Datenexport: - Klicken Sie auf "Speichern Unter" oder "Datei → Speichern Unter" - Verfügbare Formate: * Excel (.xlsx) * CSV (.csv) * Text (.txt) * JSON (.json) * XML (.xml) * Datenbank (.db) - Für zukünftige Exporte desselben Satzes verwenden Sie "Datei → Speichern"

Spaltenkonfiguration: - Zugriff über "Einstellungen → Spalten Konfigurieren" - Aktivieren/Deaktivieren Sie gewünschte Spalten in der Tabelle: (Operationstyp, Name, Vorheriges Verzeichnis, Aktuelles Verzeichnis, usw.) - Änderungen werden sofort angewendet - Standardwiederherstellung: "Einstellungen → Spalten Konfigurieren → Spalten Zurücksetzen"

Sprachwechsel: - Zugriff über "Optionen → Sprache" und wählen Sie die gewünschte Sprache - Das Programm wird nach Bestätigung mit der neuen Sprache neu gestartet

Fehlerbehebung: 1. Überwachung startet nicht: - Überprüfen Sie die Zugriffsberechtigungen für das Verzeichnis - Stellen Sie sicher, dass kein anderes Programm dasselbe Verzeichnis überwacht - Starten Sie die Anwendung neu

2. Ereignisse werden nicht angezeigt:
    - Überprüfen Sie, ob die Überwachung aktiv ist
    - Prüfen Sie, ob Filter keine Ereignisse verbergen
    - Testen Sie durch manuelles Ändern einer Datei

3. Hoher Ressourcenverbrauch:
    - Vermeiden Sie die Überwachung von Systemverzeichnissen oder solchen mit Tausenden von Dateien
    - Überwachen Sie spezifische Unterverzeichnisse anstelle von Stammverzeichnissen

4. Fehler in den Statistiken:
    - Stellen Sie sicher, dass genügend Ereignisse vorhanden sind, um Diagramme zu generieren
    - Überprüfen Sie, ob alle Bibliotheken korrekt installiert sind

Linceu Lighthouse ist eine Desktop-Anwendung, die in Python/PySide6 entwickelt wurde und Datei­system-Operationen in Echtzeit überwacht (Erstellung, Änderung, Löschung, Umbenennung, Verschiebung). Sie bietet erweiterte statistische Analysen, Datenvisualisierung und Export in mehreren Formaten.

• GUI-Framework: PySide6 (Qt6)
• Datenanalyse: pandas, numpy
• Visualisierung: matplotlib, seaborn, plotly
• Datenbank: SQLite3 (mit WAL-Optimierungen)
• Multithreading: QThread, concurrent.futures
• Internationalisierung: Qt Linguist (6 Sprachen)

• [S] Single Responsibility: Jedes Modul hat eine eindeutige Verantwortung
• [O] Open/Closed: Erweiterbar durch Vererbung (BaseGerador, BaseEvento)
• [L] Liskov Substitution: Alle Diagramm-Generatoren sind austauschbar
• [I] Interface Segregation: Spezifische Schnittstellen pro Eventtyp
• [D] Dependency Inversion: Dependency Injection (loc, interface, db_path)

• Observer Pattern: Dateiüberwachung
• Factory Pattern: Erstellung von Buttons und Komponenten
• Strategy Pattern: Unterschiedliche Exportstrategien
• Singleton Pattern: LogManager, DatabaseWriter
• Model-View-Controller: EventTableModel + QTableView
• Template Method: BaseGerador definiert das Gerüst
• Facade Pattern: GerenciadorEstatisticasUI vereinfacht den Zugriff

• QThread für langlaufende Operationen (Scan, Diagramme)
• ThreadPoolExecutor für parallele Verarbeitung
• DatabaseWriter mit dediziertem Thread
• Intelligentes Debouncing für Events
• Cache mit selektiver Invalidierung
• Batch-Verarbeitung für Einfügungen

• SQLite im WAL-Modus (Write-Ahead Logging)
• Indizes auf häufigen Spalten
• Batch-Transaktionen
• PRAGMA-Optimierungen
• Dedizierter Thread für I/O

1. INITIALISIERUNG
   └─> QApplication.instance()
   └─> Internacionalizador.inicializar_sistema_traducao()
   └─> InterfaceMonitor.__init__()

2. VERZEICHNISAUSWAHL
   └─> GerenciadorBotoes.selecionar_diretorio()
   └─> QFileDialog.getExistingDirectory()

3. START DER ÜBERWACHUNG
   └─> Observador.iniciar()
   ├─> DiretorioScanner.scan_directory() [Thread]
   └─> Observador.monitorar() [Thread]

4. EREIGNISVERARBEITUNG
   └─> Observador.processar_evento()
   ├─> EventoAdicionado.processar()
   ├─> EventoExcluido.processar()
   ├─> EventoModificado.processar()
   ├─> EventoRenomeado.processar()
   └─> EventoMovido.verificar_movimentacao()

5. OBERFLÄCHENAKTUALISIERUNG
   └─> InterfaceMonitor.inserir_evento_streaming()
   └─> GerenciadorTabela.atualizar_linha_mais_recente()

6. STATISTIKERZEUGUNG
   └─> GerenciadorEstatisticasUI.mostrar_estatisticas()
   └─> GeradorEstatisticas._gerar_todos_graficos()

7. DATENEXPORT
   └─> GerenciadorBotoes.exportar_dados()
   ├─> Excel: pandas.to_excel()
   ├─> CSV: pandas.to_csv()
   ├─> JSON: json.dump()
   └─> XML: ElementTree

8. SPRACHWECHSEL
   └─> GerenciadorEventosUI.alterar_idioma()
   └─> LocalizadorQt.set_idioma()

PySide6>=6.5.0           # Qt6-Framework
pandas>=2.0.0            # Datenanalyse
matplotlib>=3.7.0        # Diagrammvisualisierung
seaborn>=0.12.0          # Statistische Diagramme
plotly==5.22.0           # Interaktive Diagramme
Pillow>=10.0.0           # Bildverarbeitung
tinytag>=1.10.0          # Audio-Metadaten
pymediainfo>=6.0.0       # Video-Metadaten
PyPDF2>=3.0.0            # PDF-Metadaten
openpyxl>=3.1.0          # Excel Lesen/Schreiben
python-docx>=0.8.11      # DOCX-Metadaten
chardet>=5.1.0           # Encoding-Erkennung
squarify>=0.4.3          # Treemap-Diagramme
psutil>=5.9.0            # Systemüberwachung
pywin32>=305             # Windows-API

• Betriebssystem: Windows 10/11 (64-bit)
• Python: 3.10+
• RAM: 4 GB Minimum (8 GB empfohlen)
• Speicher: 100 MB freier Speicherplatz

• ✓ Deskriptive, selbsterklärende Namen
• ✓ Kleine, fokussierte Funktionen (< 50 Zeilen)
• ✓ Vermeiden von Magic Numbers (Konstanten verwenden)
• ✓ Code-Dokumentation (Docstrings)
• ✓ Konsistentes Format
• ✓ Vermeidung von Code-Duplizierung (DRY)

• ✓ Lazy Loading von Metadaten
• ✓ Caching häufiger Ergebnisse
• ✓ Asynchrone Verarbeitung
• ✓ Batch-Verarbeitung
• ✓ Optimierte Datenbankindizes
• ✓ Effiziente Speichernutzung

• ✓ Extreme Modularisierung (200+ Module)
• ✓ Trennung der Verantwortlichkeiten
• ✓ Geringe Kopplung
• ✓ Hohe Kohäsion
• ✓ Konsistente Benennungskonventionen

• Neuer Diagrammtyp: Von data/GeradorEstatisticas/gst_01_base_gerador.py erben
• Neuer Eventtyp: Von services/ob_02_BaseEvento.py erben
• Neue Spalte: Getter in services/ob_09_GerenciadorColunas.py hinzufügen
• Neue Sprache: linceu_XX.ts in source/locale/ erstellen
• Neuer Filter: In tools/GerenciamentoAdministradorFiltros/ hinzufügen

futures==3.0.5
kaleido==0.2.1
plotly==5.22.0

• monitoramento.db - Hauptdatenbank (SQLite)
• language_config.json - Sprachpräferenz
• colunas_coloridas.json - Farbkodierung
• cores_operacoes.json - Farben je Operationstyp
• config.json - Allgemeine Einstellungen

Protokollsystem mit automatischer Rotation unter:

%APPDATA%/Linceu_Lighthouse/logs/

Autoren: Fernando Nillsson Cidade
Version: v0.1.3.0
Lizenz: GNU Affero General Public License v3.0 (AGPL-3.0)

Für weitere Informationen siehe die spezifische Dokumentation jedes Moduls im Quellcode.