IXC França

About

IXC Franca v2.0 – Extensão Profissional para IXC Soft

Extensão avançada para Google Chrome desenvolvida para otimizar e potencializar o uso do portal IXC Soft no ambiente da Conect Telecom (Franca/SP).

Com arquitetura moderna, modular e orientada a eventos, a IXC Franca v2.0 oferece recursos inteligentes que aumentam a produtividade, automatizam tarefas repetitivas e melhoram a navegação dentro do sistema.

---

OBJETIVO

Facilitar o uso diário do IXC Soft através de:

* Identificação automática de tabelas
* Liberação inteligente de campos bloqueados
* Navegação direta por cliente e contrato via URL
* Interface de controle simples e intuitiva
* Arquitetura robusta e extensível

Tudo isso sem alterar o funcionamento original do sistema, apenas aprimorando a experiência do usuário.

---

FUNCIONALIDADES

DETECTOR DE TABELAS INTELIGENTE

A extensão intercepta requisições HTTP (XHR/Fetch) direcionadas a /aplicativo/ e identifica automaticamente a tabela sendo utilizada.

O que faz:

* Detecta o nome da tabela carregada
* Exibe o nome da tabela no título da página
* Atualiza automaticamente ao navegar
* Funciona em tempo real sem necessidade de recarregar a página

Ideal para quem trabalha com múltiplas tabelas e precisa identificar rapidamente o contexto atual.

---

HABILITADOR DE CAMPOS

Remove bloqueios visuais e técnicos de campos de formulário quando permitido pelo fluxo operacional.

Ações automáticas:

* Remove classes disab e disabled
* Remove atributo disabled
* Remove atributo readonly
* Monitora o DOM continuamente
* Reaplica a liberação quando novos campos são inseridos dinamicamente

Indicado para cenários onde campos ficam bloqueados pelo frontend, mas precisam ser ajustados durante processos administrativos.

---

NAVEGAÇÃO INTELIGENTE VIA HASH (IXCNavigator)

Permite navegar diretamente para cliente e contrato usando parâmetros na URL.

Exemplos:

[https://ixc.conecttelecom.com.br/adm.php#clienteId=1538](https://ixc.conecttelecom.com.br/adm.php#clienteId=1538)
[https://ixc.conecttelecom.com.br/adm.php#clienteId=1538#contratoId=280994](https://ixc.conecttelecom.com.br/adm.php#clienteId=1538#contratoId=280994)

Comportamento automático:

* Detecta parâmetros no hash da URL
* Navega para o cliente especificado
* Localiza o contrato correspondente
* Destaca visualmente o contrato encontrado
* Aplica efeito visual temporário (borda e sombra)
* Sistema inteligente de retry (até 10 tentativas)
* Funciona mesmo com carregamento tardio de iframes

Ideal para suporte, financeiro e atendimento que precisam acessar contratos rapidamente.

---

POPUP DE CONTROLE INTERATIVO

Ao clicar no ícone da extensão, um painel de controle é exibido.

Recursos disponíveis:

* Ativar ou desativar funcionalidades individualmente
* Visualizar status atual
* Ver tabela detectada
* Configurações salvas automaticamente
* Interface limpa e intuitiva

Controle total sobre cada módulo da extensão.

---

ARQUITETURA MODERNA (v2.0)

A IXC Franca v2.0 foi completamente refatorada para seguir padrões profissionais de desenvolvimento.

Estrutura modular:

Cada funcionalidade é isolada em seu próprio módulo, garantindo:

* Manutenção facilitada
* Código organizado
* Melhor performance
* Extensibilidade simples

Namespace global utilizado:

window.IXC

Estrutura principal:

window.IXC = {
EventBus,
Settings,
Modules: {
TableDetector,
FieldEnabler,
DOMUpdater,
IXCNavigator
}
}

---

COMUNICAÇÃO VIA EVENTBUS

Sistema central de eventos que desacopla completamente os módulos.

Exemplos de eventos:

* table:detected
* fields:enabled
* dom:updated
* navigator:navigating
* navigator:contract-found
* settings:changed
* module:started
* module:stopped

Essa abordagem permite que novos módulos sejam adicionados sem impactar os existentes.

---

GERENCIADOR DE CONFIGURAÇÕES (Settings)

* Persistência via Chrome Storage API
* Inicialização automática
* Controle individual por módulo
* Reset completo de configurações

---

BRIDGE (ISOLATED World)

A arquitetura respeita o modelo do Chrome Manifest V3:

* Um único script com acesso às APIs do Chrome
* Comunicação segura entre popup e página
* Uso de postMessage para integração com o contexto principal

---

BENEFÍCIOS

* Aumento de produtividade
* Redução de cliques e navegação manual
* Acesso rápido a contratos específicos
* Melhor identificação de tabelas
* Código organizado e profissional
* Fácil manutenção
* Fácil expansão futura
* Debug facilitado com logs organizados

---

TECNOLOGIAS UTILIZADAS

* Manifest V3
* Chrome Storage API
* MutationObserver
* Arquitetura orientada a eventos
* Namespace Pattern
* Module Pattern
* Comunicação ISOLATED ↔ MAIN World

---

DEBUG PROFISSIONAL

Logs organizados por módulo no console:

* [IXC]
* [EventBus]
* [Settings]
* [TableDetector]
* [FieldEnabler]
* [DOMUpdater]
* [IXCNavigator]
* [IXC Bridge]

Permite diagnóstico rápido e rastreamento de eventos internos.

---

IDEAL PARA

* Suporte técnico
* Atendimento ao cliente
* Financeiro
* Administrativo
* Operadores do IXC Soft
* Equipes que precisam navegar rapidamente entre contratos

---

VERSÃO

v2.0.x – Refatoração completa com arquitetura modular profissional.

Principais melhorias:

* Separação total de responsabilidades
* Sistema de eventos centralizado
* Módulo IXCNavigator
* Melhor gerenciamento de estado
* Popup aprimorado
* Estrutura escalável

---

USO INTERNO

Extensão desenvolvida para uso interno no ambiente IXC da Conect Telecom – Franca.

Se você trabalha diariamente no IXC Soft e precisa de agilidade, organização e navegação inteligente, a IXC Franca v2.0 é a ferramenta ideal para elevar sua produtividade a outro nível.