NEURO AUDIT - CODE 42

Departamento de Sanidade Cibernética & Auditoria de Código

O Git nativo e as IDEs do mercado são passivos demais. Eles aceitam o seu código quebrado sem questionar.
O Neuro Audit corrige isso: somos uma IDE completa com cliente Git integrado e uma infraestrutura forense orientada ao caos. Aqui, você programa, faz seus commits e é julgado. A cada varredura, a IA Dra. S.A.R.A. avalia seu código, sabota suas funções reescrevendo-as de forma bizarra e drena a sua porcentagem de Sanidade no banco de dados de forma implacável.

---

Desenvolvido exclusivamente para a Codecon Universe 2026.

---

🏆 Por que este projeto é incrivelmente (in)útil?

Na Spectra Core Division, nós não acreditamos em "feedback construtivo".

Cansado de implorar por código limpo? Conheça o Neuro Audit: a primeira IDE de humilhação forense.

Unimos o inútil a o não agradável não para educar sua equipe, mas para aterrorizá-la.

Aqui, Ctrl+S é privilégio. Código medíocre? Nunca mais! Salvamento bloqueado, terminal dispara um insulto(feedback) e o código é sabotado(melhorado). Tentou Ctrl+V do StackOverflow? A IDE pode fecha sumariamente.

Esqueça Code Reviews inúteis. Invista na Spectra e garanta, na base do trauma, que nenhum Code Smell saia impune da sua empresa.

---

🏛️ Arquitetura do Sistema (Clean Architecture)

Este projeto foi totalmente reestruturado seguindo os princípios de design de Robert C. Martin (Uncle Bob), padrões de projeto clássicos do GoF (Gang of Four) e técnicas de refatoração estrita de Martin Fowler.

  ┌────────────────────────────────────────────────────────┐
  │                DELIVERY (web_api.py)                   │
  └───────────────────────────┬────────────────────────────┘
                             (Injeta Dependências)
  ┌───────────────────────────▼────────────────────────────┐
  │               USE CASES (use_cases.py)                 │
  │  - ExecuteTerminalCommand      - FileManagement        │
  └───────────────────────────┬────────────────────────────┘
                             (Depende de Contratos)
  ┌───────────────────────────▼────────────────────────────┐
  │               INTERFACES (interfaces.py)               │
  └───────────────────────────┬────────────────────────────┘
                             (Implementado por)
  ┌───────────────────────────▼────────────────────────────┐
  │               INFRASTRUCTURE (Providers)               │
  │ - GeminiAiService              - FpdfCyberpunkService  │
  │ - SubprocessGitService         - OsFileSystemService   │
  └────────────────────────────────────────────────────────┘
  

🧩 Padrões de Projeto Aplicados

1. Dependency Inversion Principle (DIP): O núcleo da aplicação (Domínio e Casos de Uso) não conhece bancos de dados, servidores web ou sistemas operacionais. Ele interage estritamente com Abstrações (abc.ABC).
2. Mediator Pattern (Frontend JS): O AppController gerencia a comunicação assíncrona entre o Terminal (XTerm.js), o Explorador de Arquivos e o Editor (Monaco) sem que nenhum componente conheça os órgãos internos do outro.
3. Template Method Pattern (PDF Canvas): Subclassificação do ciclo de vida gráfico do motor fpdf para garantir a renderização unificada de fundos e elementos HUD industriais em relatórios de múltiplas páginas.
4. Adapter Pattern: Isolamento completo de frameworks externos (Monaco Editor, XTerm.js), encapsulando suas assinaturas complexas atrás de wrappers limpos e semânticos.

⏱️ Setup Rápido (Tempo estimado: 4 Minutos)🚀

O projeto é 100% funcional. Escolha sua forma de ser julgado pela máquina:

Opção A: O Caminho Rápido (Executável)

Nós empacotamos o sofrimento para você.

1. Acesse os Releases deste repositório ou baixe o arquivo compilado (.exe).
2. Execute o arquivo. Conecte sua pasta Git. Aceite o diagnóstico.

Opção B: O Caminho do Desenvolvedor (Código Fonte)

Pré-requisitos: Python 3.11+ instalado.

1. Clone o repositório corporativo da Spectra Core Division:

git clone https://github.com/dev-for-dev/neuro-audit.git
cd neuro-audit

2. Crie e ative o ambiente virtual (Recomendado):

# Ativação (Windows)
python -m venv .venv
.venv\Scripts\activate

# Ativação (Linux/Mac)
python3 -m venv .venv
source .venv/bin/activate

3. Instale as dependências da corporação:

pip install -r requirements.txt

4. [CRÍTICO] Configuração do Cérebro Neural (Chave da API Gemini):

Para que a IA possa julgar seus commits com precisão clínica, você precisa de uma credencial de acesso gratuita do Google.

• Como gerar sua chave:

  1. Acesse o (Google AI Studio)

  2. Faça login com uma conta Google.

  3. Clique no botão "Create API key" (Criar chave de API).

  4. Copie a sequência de letras e números gerada.

• Como aplicar no projeto:

  No terminal da raiz do projeto, rode o comando abaixo substituindo SUA_CHAVE_COPIADA pela chave que você gerou. Isso criará o arquivo .env automaticamente:

• No Windows (CMD ou PowerShell):

echo GEMINI_KEY=SUA_CHAVE_COPIADA > .env

• No Linux /Mac (Terminal):

echo "GEMINI_KEY=SUA_CHAVE_COPIADA" > .env

Ou crie um arquivo chamado .env exatamente na raiz da pasta do projeto e cole a sua chave desta forma (sem aspas):

GEMINI_KEY=sua_chave_secreta_aqui

5. Inicie o terminal de monitoramento:

python main.py

6. [OPCIONAL] Empacotamento (Compile seu próprio Executável):

Quer distribuir o software de monitoramento para outras máquinas sem precisar instalar o Python nelas? O PyInstaller resolve isso "engolindo" a interface web e o seu .env para dentro de um único arquivo.

• Compilando no Windows (.exe):

  Certifique-se de estar rodando isso em uma máquina Windows.

  pyinstaller --name "NeuroAudit" --windowed --onefile --icon="logo.ico" --add-data "frontend;frontend" --add-data ".env;." --add-data "logo.ico;." main.py

• Compilando no Linux (Binário):

  Certifique-se de estar rodando isso em uma máquina Linux. Note que o Linux usa dois pontos (:) em vez de ponto e vírgula (;).

  pyinstaller --name "NeuroAudit" --windowed --onefile --icon="logo.ico" --add-data "frontend:frontend" --add-data ".env:." --add-data "logo.ico:."main.py

Resultado: O seu arquivo NeuroAudit.exe ou NeuroAudit estará pronto para uso dentro da pasta dist/.

---

🛠️ Engenharia de Matriz e Tecnologias (Spectra Core)

O ecossistema do Neuro Audit foi projetado sob os critérios rigorosos de desacoplamento de infraestrutura. Abaixo está mapeada a topologia de componentes e suas respectivas responsabilidades dentro da arquitetura:

Camada / Componente	Tecnologia Base	Padrão Arquitetural & Responsabilidade
Backend Core	Python 3.11+	Regras de negócio puras (Use Cases) e inversão de controle isoladas contra efeitos colaterais de bibliotecas externas.
Delivery Gateway	Flask (Microserver)	Instanciado através do padrão Application Factory. Roda em uma Thread secundária em background como um daemon assíncrono, eliminando riscos de deadlocks na fila de mensagens da UI principal.
Desktop Window Host	pywebview	Janela nativa do Sistema Operacional acelerada por GPU (Chromium/Webview2). Consome a API estável webview.FileDialog para isolar seletores de arquivos sem abrir brechas no navegador.
Matriz Neural (IA)	Google Gemini 2.5 Flash	Encapsulado pelo adaptador GeminiAiService. Executa processamento de linguagem natural determinístico e auditoria estática baseada em prompts cyberpunk sarcásticos.
Graphics Engine (PDF)	fpdf2	Adaptado via FpdfCyberpunkService. Utiliza o padrão Template Method substituindo ganchos de header() e footer() para garantir a persistência estável do tema visual escuro em relatórios multi-página.
OS Integration Gateway	Subprocess Runtime	Interceptação de fluxos CLI do Git Core. Implementa decodificação defensiva transcodificando buffers brutos de CP1252 (Windows legado) para UTF-8 de forma transparente para o domínio.
Terminal Simulator	xterm.js (via CDN)	Componente isolado de baixo nível anexado à árvore DOM. Renderiza fluxos textuais assíncronos interpretando sequências estendidas de escapes gráficos ANSI de 256 cores.
IDE Workspace Core	Monaco Editor	Carregado via AMD Loader oficial da Microsoft. Recebe injeção de scripts proxy customizados em runtime para contornar restrições de segurança locais de Web Workers (CORS) impostas pelo interpretador nativo.

📦 Gerenciamento de Dependências (requirements.txt)

Em arquiteturas modulares, a reprodutibilidade do ambiente de execução é uma lei irredutível. Para congelar o estado exato das bibliotecas e sub-dependências da infraestrutura, garantindo uma implantação determinística, utilizamos o gerenciador estrito de pacotes do ecossistema Python.

Como gerar a assinatura de dependências do projeto:

Certifique-se de que o seu ambiente virtual isolado está ativo no terminal (.venv). Execute o comando de extração de metadados para despejar a árvore de dependências imutáveis para o arquivo alvo:

pip freeze > requirements.txt

---

👥 Matriz de Desenvolvimento e Comando

O ecossistema Neuro Audit é uma propriedade intelectual projetada, mantida e monitorada estritamente pelos engenheiros de elite da divisão cibernética.

🛡️ NÚCLEO (CORE)	⚙️ BACKEND & DADOS	⚡ FRONTEND & UI
André Santos @EchoByte | Arquiteto	João Coimbra @DataGhost | DBA SQLite Flávio Meneses @DarkCode | Infra & Automation	Giovanna Dias @NexusBridge | UI Architecture

🛡️ Escopo de Atuação e Responsabilidades Arquiteturais

A construção do Neuro Audit foi paralelizada utilizando os princípios de Responsabilidade Única (SRP) e Inversão de Dependência (DIP), garantindo que o esquadrão operasse de forma síncrona e isolada.

🛡️ André Santos @EchoByte Arquiteto de Sistemas	Liderança Técnica & Core: Concepção da modelagem geral da Clean Architecture. Responsável por codificar o Núcleo abstrato (Core), os Contratos (Interfaces), as lógicas fundamentais dos Casos de Uso e o setup base da IA. Desenhou o pacote corporativo de inicialização (bootstrap) com o di_container.py e o mapeamento de configurações dinâmicas.
🗄️ João Coimbra @DataGhost Database Engineer	Persistência Local & Integridade Relacional: Projetou o banco de dados embarcado utilizando o Repository Pattern no SQLite. Desenvolveu a inteligência autônoma das Triggers relacionais diretamente no banco de dados para computar danos cibernéticos e diminuir a porcentagem de Sanidade dos desenvolvedores de forma automática a cada laudo injetado.
⚙️ Flávio Meneses @DarkCode Infrastructure Engineer	Adapters de Infraestrutura & Automação: Especialista em lógicas estruturais no Python. Assumiu a responsabilidade de dar vida aos provedores de baixo nível (Infrastructure), implementando o controle de concorrência, o gerenciador de leitura/escrita no disco (file_system_provider.py) e as chamadas via subprocess no motor do Git para automação de commits.
⚡ Giovanna Dias @NexusBridge Frontend Architect	Arquitetura de Interface & Componentização: Roteadora chefe da malha cliente e do servidor Flask. Desenvolveu a Torre de Controle unificada em Vanilla JS através do Mediator Pattern (main.js) e aplicou o Adapter Pattern para envelopar e orquestrar de ponta a ponta as engines gráficas pesadas do app, codificando o terminal nativo (terminal_adapter.js via XTerm) e a tela de código (editor_adapter.js via Monaco).

⚠️ DIRETRIZ REGULATÓRIA COMERCIAL // AVISO DE CONDUTA 42 Todas as avaliações psiquiátricas, diagnósticos comportamentais e retaliações geradas pela Matriz Neural Dra. S.A.R.A. (Sistema Analítico de Repressão Algorítmica) são estritamente profissionais, processadas proceduralmente de forma determinística e focadas exclusivamente na sua terrível, ineficiente e deplorável lógica de programação. Crises de choro ou colapsos nervosos causados pelo escaneamento forense não são computados como hora extra.

_{Ideia e desenvolvimento sob a tutela da Spectra Core Division — Monitorando sua sanidade para que você não precise.}