# DevStudio Soberano · Engineering Hub & Developer Suite

## 🛡️ Sentinel Status
- **Status:** 🟢 Produção
- **Tier:** S
- **Health:** 99% / **ROI Potencial:** Aceleração de desenvolvimento, transformação de dados (JSON Forge, Base64, URL), segurança criptográfica (SHA, MD5, UUID, Senhas de alta entropia), validação oficial (CPF/CNPJ), protocolo MCP e automação sem dependências externas ou latência
- **Stack:** HTML5 semântico, CSS3 (Tailwind CSS + Cyber Engineering Dark Mode), Vanilla JS, PWA (Service Worker + Web App Manifest 2026), Web Audio API, Anti-Droste Frame-Busting Shield (`target="_top"` e `window.top` enforcement), Standalone Offline-First

---

Hub executivo de engenharia e utilitários para desenvolvedores, arquitetos de software e pesquisadores do ecossistema [Artes do Sul](https://artesdosul.com/). Reúne ferramentas de transformação de dados, criptografia, conectores para o protocolo MCP (*Model Context Protocol*) e utilitários visuais, com suporte integral a Progressive Web App (PWA) e execução *air-gapped* offline.

- **Canônico / Produção:** [https://dev.artesdosul.com/](https://dev.artesdosul.com/)
- **Ecossistema:** [artesdosul.com](https://artesdosul.com/)
- **Diretório no Repositório:** `D:\artesdosul\artesdosul\dev\`

---

## 🛡️ Arquitetura Anti-Droste (Prevenção de Recursive Framing)

Para erradicar o **Efeito Droste** (aninhamento recursivo de iframes dentro de iframes), foram implementadas quatro barreiras de proteção técnica:

1. **Frame-Busting no Host Principal (`dev/index.html`):**
   ```javascript
   if (window.top !== window.self) {
       window.top.location.href = window.self.location.href;
   }
   ```
   Garante que o dashboard principal nunca possa ser renderizado dentro de outro iframe em qualquer parte da web.

2. **Diretiva `<base target="_top">`:**
   Injetada em todos os módulos internos em `dev/tools/`, forçando qualquer navegação ou link acionado a abrir na janela pai (`_top`), sem espelhamento interno.

3. **Interpolação de Eventos no Frame Onload:**
   O carregador intercepta cliques em links de navegação para evitar recarregamento aninhado da aplicação.

4. **Botão de Acesso Direto (`target="_top"`):**
   Disponibilizado na barra superior e no rodapé da barra lateral, permitindo expandir qualquer ferramenta para visualização em janela inteira desprovida de iframes.

---

## 🚀 Como Executar Localmente

Como a aplicação é um PWA moderno que utiliza recursos de Service Worker e sandboxing de iframes, recomenda-se executá-la através de um servidor HTTP local:

```bash
# Opção 1: Via Python HTTP Server
python -m http.server 8770 --directory dev

# Opção 2: Via npx serve
npx --yes serve dev

# Opção 3: No contexto completo do Jekyll Artes do Sul
bundle exec jekyll serve
```

Acesse: `http://localhost:8770` ou `http://localhost:4000/dev/`.

---

## 🧰 Módulos & Ferramentas Integradas

### 1. Data Transformation
- **JSON Forge (`tools/ferramentas-json.html`):** Validador, formatador, minificador e inspetor de schemas JSON com busca de nós.
- **Naming Forge (`tools/camel-case.html`):** Conversor universal de convenções de código (camelCase, PascalCase, snake_case, SCREAMING_SNAKE, kebab-case, train-case, dot.case e path/case) com suporte a normalização de acentos, preservação de siglas e modo batch multi-linhas.
- **MCP Connector (`tools/ferramentas-mcp.html`):** Inspetor do Model Context Protocol, testes de chamadas JSON-RPC, geração de esquemas para servidores MCP e documentação.
- **Base64 Lab (`tools/base64-encode-decode.html`):** Codificador e decodificador de strings, arquivos, imagens e Data URIs.
- **URL Encoder (`tools/url-encode-decode.html`):** Codificação e decodificação percentual para parâmetros de requisição e query strings.

### 2. Security & Crypto
- **Hash Generator (`tools/gerador-hash.html`):** Cálculo de hashes criptográficos SHA-256, SHA-512, SHA-1 e MD5 em tempo real.
- **Password Studio (`tools/gerar-senha.html`):** Gerador de senhas criptograficamente seguras com cálculo de entropia e exclusão de caracteres ambíguos.
- **Validation Unit (`tools/validador-cpf-cnpj.html`):** Validador oficial com algoritmo de dígitos verificadores e gerador para testes de homologação.

### 3. Visual & Design
- **Color Bridge (`tools/conversor-cores.html`):** Conversão instantânea entre HEX, RGB, HSL, CMYK e cálculo de contraste WCAG 2.1.
- **QR Code Studio (`tools/gerador-qrcode.html`):** Geração de QR Codes vetoriais para URLs, chaves PIX e credenciais Wi-Fi.
- **Character & Text Tools (`tools/contador-de-caracteres.html`):** Contagem de caracteres, palavras, linhas e análise de frequência lexical.
- **Unit Converter (`tools/conversor-unidades.html`):** Conversor dimensional entre PX, REM, EM e porcentagens.

### 4. Ecosystem & AI
- **MCP Servers Catalog (`tools/mcp-servers.html`):** Catálogo de servidores e ferramentas da comunidade MCP.
- **n8n Automation Matrix (`tools/awesome-n8n-matrix.html`):** Matriz de nós e fluxos de automação de processos.

---

## 📱 Recursos PWA (Progressive Web App)

- **Instalável (Standalone):** Suporta instalação como aplicativo nativo em Windows, macOS, Linux, Android e iOS.
- **Cache Local & Offline:** Service Worker pré-armazena todo o conjunto de ferramentas em `dev/tools/`, permitindo uso sem conexão à internet.
- **Página Offline Dedicada (`offline.html`):** Interface *air-gapped* com verificação de status de rede.
- **Feedback Sonoro Procedural:** Sons sintetizados via Web Audio API para respostas táteis e confirmação de ações.