<!-- ================================================================= -->
<!-- DOCUMENTO UNICO DE VERDADE (SINGLE SOURCE OF TRUTH)               -->
<!-- Tudo acima desta marca e o ESTADO REAL consolidado em 2026-06-28. -->
<!-- Tudo abaixo (a partir de "Mike Local 2.15.0 ...") e HISTORICO/     -->
<!-- changelog cronologico preservado. Para entender o projeto hoje,    -->
<!-- leia SO esta secao do topo ate "FIM DO DOCUMENTO UNICO".          -->
<!-- ================================================================= -->

# ðŸ§­ DOCUMENTO UNICO DE VERDADE â€” MINIKE (Estado Real Consolidado)

> **Atualizacao critica 2026-07-09 — GUIAS FISCAIS OFICIAIS DO PROJETO:** o
> planejamento fiscal/comercial do PDV agora segue DOIS guias complementares
> (decisao do dono: "fazer o nosso projeto em cima dos dois"):
> As VERSOES FINAIS dos dois vivem juntas na pasta `documentação/` (raiz):
> 1. [Guia Claude (nacional/comercial)](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CLAUDE_2026-07-09.pdf)
>    ([HTML editavel](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CLAUDE_2026-07-09.html))
> 2. [Guia Codex FINAL (SC/credenciamento)](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CODEX_FINAL_2026-07-09.pdf)
>    ([HTML editavel](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CODEX_FINAL_2026-07-09.html))
> Regras vinculantes na secao (D) de 1.5. Detalhe operacional no
> [HANDOFF 2026-07-08](docs/execucao-minike/HANDOFF_SESSAO_2026-07-08_PDV_FISCAL_ERP.md).
>
> **Atualizacao critica 2026-07-08:** HANDOFF da rodada PDV/fiscal/ERP em
> `docs/execucao-minike/HANDOFF_SESSAO_2026-07-08_PDV_FISCAL_ERP.md` — LER
> PRIMEIRO para continuar: Spedy no PDV, pagamentos padrao da rede (InfinitePay),
> PDV local instalavel (.exe compilado) + sync, app Android/PWA, motor ERP
> (balanca/grades/composicao/rateio/relatorios), autoatendimento, entrada de
> notas XML + devolucao/retorno, NFS-e automatica pelo WhatsApp no atendimento.
> Tudo local (sem deploy); o que falta esta listado no handoff.
>
> **Atualizacao critica 2026-07-07:** antes de usar este documento historico,
> leia `docs/DOCUMENTACAO_UNIFICADA_PROJETO_MINIKE_2026-07-07.md`. Ele consolida
> a rodada mais recente: Atendimento com ZIP sem segredos, APKs, Kids/Code Quest,
> revisao cruzada, hashes, regra do `.env` e pendencias reais.

> **Atualizado em: 2026-07-06 . Mantenedor: Felipe (user_id = 1, super admin principal). Ultima frente registrada: 2026-07-06 — Atendimento/ecossistema: LGPD (retencao com backup antes de apagar), monetizacao hibrida (ledger de eventos cobraveis + recuperacao de dados paga), multi-idioma PT-BR/EN-US, e CASCATA DE PAGAMENTO Hotmart -> Monetize -> InfinitePay -> Nubank -> Mercado Pago -> fallback PIX-CNPJ. Ver secao 1.0 (frente 2026-07-06) e `docs/HANDOFF_SESSAO_2026-07-06.md`. Anterior: Mike Local 2.16.5 DEPLOYADO (preview multi-dispositivo, coder local qwen2.5-coder, BOM UTF-8, /health publica, fix /projects/study; core SHA256 5393027186...) — ver secao 1.5-B. Anterior: 2.16.3 (2026-07-01, SHA256 454197AD). Roadmaps: ROADMAP_INTEGRACAO_SOCIAL_2026.md e ROADMAP_MIKE_LOCAL_2026.md.
> Este e o ponto de entrada unico para qualquer IA ou pessoa que va trabalhar no projeto.
> Ele **casa e resume** as dezenas de documentos espalhados (indice completo na secao 10).
> Regra: **se houver conflito entre este topo e qualquer doc antigo, este topo vence.**
> Honestidade tecnica e obrigatoria aqui â€” nada de marketing nem "pronto" otimista.

---

## 0. Como usar este documento

- **IA nova / outra sessao:** leia as secoes 1 a 6 antes de editar qualquer coisa. Depois consulte o indice (secao 10) para achar o doc detalhado da frente que vai mexer.
- **Antes de tocar `local-ai/mike-local-ai-minike.ps1`:** leia OBRIGATORIamente a secao 3.1 (armadilhas criticas). Esse arquivo nao e trivial.
- **Antes de tocar `atendimento/`:** leia a secao 3.2.
- **Quer saber o que falta / esta quebrado:** secao 2 (estado por modulo) e secao 6 (problemas conhecidos).
- **Nao apague docs antigos** sem migrar o conteudo util pra ca. O historico abaixo desta secao e proposital.

---

## 1. TL;DR honesto (estado em 2026-06-30)

O Minike e um **ecossistema** (site PHP + IA local "Mike" + modulo de atendimento omnichannel Node.js + dezenas de subsites/ferramentas). Esta **avancado e ambicioso, mas NAO esta pronto, NAO esta 100% integrado e NAO esta perfeito.**

Sinais objetivos do estado real:
- O repositorio tem **dezenas de arquivos modificados nao commitados**; os 2 ultimos commits sao *"Salva trabalho local consolidado para outra maquina"* â†’ e trabalho em transito entre PCs, nao release fechado.
- O **readiness real mais recente da Mike Local (2026-06-28) deu `18/18`** ([relatorio](docs/execucao-minike/relatorios/mike-local-readiness-latest.md)). A regressao `8/18` de 2026-06-22 foi investigada: turnos de atendimento/corpus caiam no modelo/AirLLM e travavam; agora usam rotas rapidas deterministicas.
- O **P1 do atendimento foi corrigido no codigo em 2026-06-28**: recusa explicita agora pausa automacoes com classificador auditavel, estado `automation_paused_reason` e gate unico. Falta aplicar migration/deploy no ambiente real ([PENDENCIAS_ATENDIMENTO.md](atendimento/docs/PENDENCIAS_ATENDIMENTO.md)).
- **Melhorias de atendimento 2026-06-30** ([detalhe](atendimento/docs/MELHORIAS_ATENDIMENTO_2026-06-30.md)): palavras-chave de produto da Loja 195 expandidas de 280 para **602 produtos reais comprovados** (curadas + v3 regenerados via `scripts/gerar-palavras-loja195-v4-produtos.js`, exigindo resultado/amostra da busca e removendo genericos/atributos/ingles/ruido de marca); mensagem de reaquecimento/enriquecimento humanizada com botoes (Sim / Falar com atendente) e, na Loja 195, convite fixo as novidades de `www.loja195.com.br` (Sim reforca o site; Nao pede desculpa e passa para atendente); `localLlmService` afinado para 3 GB/2 nucleos (threads=2, fila serializada, contexto adaptativo 1024/2048, repeatPenalty/topP/topK/minP); painel com entrada suave de bolha nova e auto-scroll inteligente. ZIP completo padrao antigo gerado em `atendimento/minike-v60-COMPLETO-palavras600-llm-mensagens-20260630.zip` com `.env`, `node_modules`, `IA`, runtime e 20.986 entradas conferidas; SHA-256 `07D62899958432CF109F1C54E73CD925AA1AB8C4187B7851C815437168ABE84E`. Falta deploy no Hostinger e sincronizar/publicar as automacoes Loja195 no Super Admin.
- **Mike Local Studio/Video Studio 2026-06-30:** o antigo gerador/canvas foi integrado como `/studio` offline, com picker de arquivos do PC, drag/drop de imagens/videos/audios e presets visiveis para Instagram feed 1080x1080, Reels/TikTok/Stories 1080x1920 e YouTube 1920x1080. Para video completo foi integrado o OpenReel Video (MIT) como `/video-studio`, com timeline multi-faixa, drag/drop de fotos/videos/audios, texto, efeitos/transicoes/audio e exportacao local. O instalador copia/baixa `studio.zip` e `video-studio.zip`, e o EXE embute os dois. Deploy Hostinger validado em 2026-06-30 com backup `~/backups_codex/mike-local-ai-20260630-112638`, SHA remoto conferido e HTTP 200 para release, EXE e bundles. Teste tipo usuario baixado do site instalou em raiz limpa/porta 47905 e validou `/ui`, `/studio`, `/video-studio`, asset CSS e `/ui/status` com HTTP 200. Hashes atuais da rodada: core `E2F807BD1A7BE14803216FC9AE3437ACAF3677F67DAC1B24A6C2F7405F08444B`; EXE `7E73E8030C4039F6F2F7069A86951EBB3D21CFB1ABF5BA873EE0DC0EF81469B2`.
- **Atualizacao Mike Local 2026-06-28/29 (imagem + Programar + cluster + arquivos):** `mike-ui.html` ganhou aba Imagem com motores, prompt/negativo, galeria e progresso animado; o chat tambem mostra carregamento e galeria quando o pedido de imagem nasce na conversa; o core roteia `/integrations/image/generate` para worker LAN forte quando o PC atual nao tem GPU, e evita cair silenciosamente no ComfyUI local lento de PC fraco. PCs com GPU geram localmente; PCs sem GPU procuram automaticamente os 2 PCs fortes da rede via relay LAN. Cada pedido de imagem agora solicita **3 variacoes** (`image_count=3`) em ComfyUI/A1111, com limite defensivo de 1 a 4. Heartbeat LAN publica `image_ready`/motores online; worker ComfyUI devolve o resultado final quando possivel. O cluster inclui tarefas padrao de Programar (`code_review`, `bug_analysis`, `test_planning`, `refactor_plan`), hierarquia de nos por forca e comandante da rede, e o chat delega pedidos longos/de codigo para equipe privada quando vale a pena. Rodada extra: Programar ganhou missao **Projeto completo** (estuda projeto, roda diagnostico/testes, aciona equipe e Codex opcional), Terminal ganhou sessao PowerShell/CMD interna persistente e botoes `ollama launch ...` com preparo automatico do Ollama antes de abrir agentes, e a aba Imagem ganhou preparo completo ComfyUI + Forge/A1111 + fonte/UI Fooocus. Fechamento 2026-06-29: a missao de projeto completo agora salva `MIKE_PROJECT_DELIVERY.md` dentro da raiz do projeto com objetivo, mapa, diagnostico/testes, achados, evidencias de comandos, status do Codex, status da equipe LAN e checklist de entrega; a UI mostra e abre esse relatorio no Programar. `POST /programming/project-build/status` acompanha Codex/agentes, regrava a secao viva `Live mission status` no relatorio e a UI externa atualiza automaticamente enquanto houver execucao ativa. Fechamento extra: o Programar embutido no core tambem ganhou a mesma visualizacao, botao **Abrir relatorio**, botao **Atualizar status** e polling da missao. Fechamento rede: `POST /compute-cluster/quick-connect` ativa este PC como worker privado, liga relay LAN em background, publica presenca, sincroniza peers e libera tarefas de Programar/imagem para outros PCs da mesma rede privada; UI externa e `conectar-cluster.ps1` passaram a usar esse preset. Fechamento ferramentas: anexos do chat agora podem ser processados diretamente por `mike-file-tools`, usando ImageMagick/FFmpeg/Ghostscript para imagem -> PDF/JPG/PNG/WebP, redimensionar/comprimir imagem, video -> MP4/comprimir, audio -> MP3, extrair audio de video e PDF -> imagens ZIP; instalador/base/capacidades preparam esses motores automaticamente. Hash core atual: `6E33A18900F63A680192F38C1E4EDADB04F2DA2F00739AF4A6D7E476F45907CB`.
- **Instalador universal reconstruido em 2026-06-28/29:** `local-ai/Instalar-Mike-IA-Local.exe` embute o `instalar-mike-windows.cmd`, core, hash, UI e scripts principais para reduzir falha de download interno; o CMD continua publicado como botao separado. Rodada extra: o preset cluster instala o `mike-compute-tray-agent.ps1`, que limita workers a 50% quando o usuario esta ativo e libera 100% para a rede apos 30 min sem mouse/teclado. Fechamento: preset `cluster` tambem instala imagem/ComfyUI portatil e exo como o `full`; EXE embute scripts extras de cluster/imagem/engines; instalador nao fica mais parado pedindo Enter no fim normal. Rodada de reparo: motor de imagem agora usa SD1.5 inicial mesmo em PC forte, tenta iniciar ComfyUI automaticamente e repara instalacao existente sem checkpoint/launch_args. Rebuild 2026-06-29 apos quick-connect de rede: SHA-256 do EXE `E8FE1ACC66A38D71F56653D577AB9CE946A13890D56DFFA178B02E1C3FF29A8F`.
- **Terminal real fechado em 2026-06-29:** `local-ai/mike-conpty-terminal.cs` foi criado e sincronizado pelo instalador. O Terminal da Mike agora tenta ConPTY nativo do Windows para `CMD real` e `PowerShell real`, com fallback seguro para pipe se a prova de captura falhar. Botoes `CMD admin` e `PowerShell admin` abrem shells externos elevados via UAC, e `POST /terminal/restart-admin` reinicia a propria Mike como admin para que o terminal embutido nasca elevado. Validado localmente na porta `47887`: `CMD` e `PowerShell` retornaram `mode=conpty`, `real_console=true` e capturaram comandos `echo`/`Write-Host`. Rodada posterior corrigiu imagem em rede/3 variacoes e manteve ConPTY validado. Rodada ferramentas de arquivo adicionou `/tools/file/convert` e `/tools/file/download`. Hash core atual: `6E33A18900F63A680192F38C1E4EDADB04F2DA2F00739AF4A6D7E476F45907CB`; EXE atual: `DE8DAA5F3D5662DF6FD24E2652BCB35DDD88B26393981BB1EDD8BAE10A73FD53`.
- **Nota de consistencia de hash:** qualquer hash anterior citado nas linhas de imagem/Programar/cluster/Terminal acima e historico daquela rodada. O hash final valido para aplicar/publicar em 2026-06-30 nesta revisao e: core `E2F807BD1A7BE14803216FC9AE3437ACAF3677F67DAC1B24A6C2F7405F08444B`, EXE `7E73E8030C4039F6F2F7069A86951EBB3D21CFB1ABF5BA873EE0DC0EF81469B2`.
- **Pre-deploy Mike Local criado em 2026-06-29:** `scripts/validate-mike-local-predeploy.ps1` valida core, corpo do agente, JS embutido/externo, helper ConPTY, captura ConPTY em processo oculto, hash `.sha256`, fallback do CMD e `release-status.json`. Rodada atual: 18 checks OK, core/agente/JS/ConPTY/hash/release OK; relatorios em `docs/execucao-minike/relatorios/mike-local-predeploy-latest.json` e `.md`.
- **Painel publico da Mike Local melhorado em 2026-06-29:** `local-ai/index.php` agora posiciona a Mike como instalador inteligente para usuario leigo, mostra perfis Minimo/Recomendado/Maximo, explica instalacao/atualizacao/configuracao/testes automaticos, lista integracoes completas (chat local, Programar, agentes Ollama, Terminal real, imagem, video, voz, OCR, rede privada, conectores e skills) e concentra os botoes de download no fechamento da pagina.
- Parte das **dividas de seguranca** do site PHP foi corrigida em 2026-06-28: `APP_DEBUG=false` e endpoints sensiveis de admin com super-admin, CSRF, realpath/allowlist e auditoria. Ainda restam outros itens do [BUGS_REPORT.md](BUGS_REPORT.md), como `catch` vazios e scripts diagnosticos.
- O **gargalo central e o modelo base local**: `gemma3:270m`/`gemma3:4b` sao fracos para conversa longa. O que existe hoje e recuperacao de conhecimento + memoria + respostas-base (RAG/regras), **nao** ajuste fino dos pesos. Para qualidade alta a rede precisa encaminhar a um PC melhor ou a um provedor de nuvem.

**Sobre as perguntas frequentes do dono (registradas para nao se repetirem):**
- *"A parte de Programar esta 100% e pega um projeto inteiro sozinho?"* -> **Ainda nao e 100% irrestrito, mas agora tem ciclo autonomo assistido auditavel.** A Mike consegue abrir projeto confiavel, estudar a base, rodar diagnostico/testes quando existem, acionar equipe local/LAN, tentar Codex oficial se estiver instalado/autenticado e registrar `MIKE_PROJECT_DELIVERY.md` com evidencia. So pode dizer "projeto pronto" depois de haver executor autenticado, alteracoes revisadas, testes/lint/build executados ou justificativa clara, e pendencias registradas. Sem Codex/login/permissao/testes, ela deve assumir modo assistido: plano, revisao, bugs e proximos passos, sem fingir que editou/testou tudo.
- *"O `ollama launch claude/codex/hermes/openclaw/...` foi integrado?"* â†’ **Sim, como especialistas externos opcionais, nao como nucleo interno da Mike.** A tela Conectores/Terminal agora lista os comandos (`Claude Code`, `Codex App`, `Hermes`, `OpenClaw`, `OpenCode`, `Codex`, `Copilot`, `Droid`, `Pi`) e o botao **Preparar/Abrir** chama `/integrations/ollama-launch/prepare`: a Mike detecta se o Ollama esta instalado, tenta instalar/reparar automaticamente, sobe o motor local e so entao roda `ollama launch ...` dentro do terminal interno. Eles continuam sendo ferramentas de terceiros do marketplace do Ollama, com opt-in, login proprio e permissoes/projeto confiavel.
- *"O DeepSeek e melhor que o Ollama em varios casos?"* â†’ **Sim, observacao correta** para os modelos locais pequenos atuais. **DeepSeek agora esta no catalogo de provedores diretos** (`api_compatible=openai`, `https://api.deepseek.com`), alem de continuar possivel usar DeepSeek indireto via OpenRouter. Ver secao 4.

---

## 1.0 Frente 2026-07-06 â€” Atendimento: LGPD, monetizacao, i18n e cascata de pagamento (MAIS RECENTE)

> Trabalho no modulo **Atendimento** (Node) e no **core PHP** do ecossistema. Honestidade: codigo
> escrito e validado por sintaxe/lint/testes-chave, mas **nao deployado nem testado com pagamento real**.
> Detalhe operacional e "onde paramos" em `docs/HANDOFF_SESSAO_2026-07-06.md`.

**Entregue e validado (sintaxe/lint):**
- ðŸŸ¢ **LGPD / retencao:** `superAdminController.cleanupOldMessages` agora **arquiva antes de apagar**
  (`backups/retention-archive/company-<id>/*.jsonl`, em lotes com teto; se o arquivo falhar, NAO apaga).
  Senha = **hash-only** (super admin so reseta, nao ve). Cache de IA e notificacoes expurgam vencidos.
  Doc: `atendimento/docs/CONFORMIDADE_LGPD_E_EUA_2026-07-06.md`.
- ðŸŸ¢ **Monetizacao hibrida** (premium inclui gratis; planos baratos pagam): novo
  `atendimento/src/services/chargeableServiceService.js` (ledger `billable_service_events` + precos
  `billable_service_prices`, registra evento PENDENTE, nunca cobra o cartao sozinho). Recuperacao de
  dados paga via `dataRecoveryService.js` (restaura do arquivo-morto da retencao). Tela de cobrancas no
  master (precos editaveis, marcar cobrado/perdoar, cobranca manual). Precos = ~metade do mercado.
  Doc: `atendimento/docs/MONETIZACAO_MODELO_HIBRIDO_2026-07-06.md`.
- ðŸŸ¢ **Multi-idioma PT-BR/EN-US:** motor `atendimento/public/js/i18n.js` (leve, CSP-safe, ~56 chaves),
  seletor nas 3 telas, login/landing + nav do master + dashboard traduzidos. Migracao do resto e
  incremental (`data-i18n`). Proximo idioma recomendado: **espanhol** (abre LATAM).
  Doc: `atendimento/docs/I18N_MULTI_IDIOMA_2026-07-06.md`.
- ðŸŸ¢ **CASCATA DE PAGAMENTO** (nos dois projetos): ordem **Hotmart -> Monetize -> InfinitePay -> Nubank
  -> Mercado Pago**, tenta um a um ate criar o checkout; se todos falharem -> **PIX manual no CNPJ** +
  desculpas (suporte habilita ao registrar). PHP: `includes/pagamentos_unificado.php`
  (`cobrar`/`cobrar_com`, `hotmart_cobrar`/`monetize_cobrar` por link de checkout MoR, `pix_manual_cnpj`)
  + `includes/finance_settings.php` (default hotmart, links por plano, CNPJ, desculpas). Node:
  `billingController.js` (cascata em `createOrder`, `buildPixCnpjFallback`, `createHotmart` multi-plano).
  Doc: `docs/PAGAMENTOS_CASCATA_2026-07-06.md`.
- ðŸŸ¢ **Correcao de layout:** cabecalho da conversa (dashboard) usa `flex-wrap` (nao espreme em zoom alto).

**Decisoes de negocio registradas:**
- Cobrar tudo que a lei permitir (recuperacao de dados, reset de senha assistido, suporte, erro humano).
- Mercados: WhatsApp-first abre LATAM/Iberia/Africa; idiomas prioridade es > fr/id; moedas USD ancora +
  MXN/EUR via Mercado Pago; **Nomad NAO cobra** (so guarda dolar, sem API de merchant) — usar Hotmart (MoR)
  + PayPal (a integrar) + Mercado Pago.

**âš ï¸ Onde paramos (PENDENTE):**
- **Webhook de confirmacao Hotmart/Monetize** — em `api/webhook_pagamentos.php` falta `processar_hotmart`
  (validar `hottok`, ler nosso `sck`=ref, `ativar_compra`). Ate ligar, ativacao pos-pagamento e MANUAL.
- Config producao: criar ofertas Hotmart/Monetizze + colar links por plano; preencher CNPJ; 1 compra teste.
- ZIP: Felipe gera (nao gerar automatico).

---

## 1.1 Frente 2026-06-28 â€” Midia multiplataforma (AMD+NVIDIA) + agente de doacao de computacao

> Contexto: PC do dono passou a ter GPU **AMD Radeon RX 7600** (8GB). Toda a stack de imagem/video assume CUDA/NVIDIA. Objetivo: funcionar **nos dois mundos** (AMD e NVIDIA), gerar a partir de PCs fracos/celulares (job vai pro no com GPU) e doar processamento ocioso a rede.

**Hardware real deste PC (DESKTOP-JACFU1P, 10.1.1.57):** i5-7400 (4 nucleos), **8GB RAM**, **sem pagefile**, disco C: ~18GB livre, AMD RX 7600. RAM+pagefile e o gargalo real (nao a marca da GPU).

**Entregue e validado:**
- ðŸŸ¢ **Motor de imagem portatil** `local-ai/install-comfyui-portable.ps1` (NOVO): detecta GPU e escolhe backend do PyTorch â€” **NVIDIAâ†’CUDA, AMD/Intelâ†’DirectML (`torch-directml`), sem GPUâ†’CPU**. Instala ComfyUI oficial + SD1.5, escreve `comfyui.backend/launch_args` no `config.json`. Tambem **analisa RAM/pagefile** e configura memoria virtual quando admin. Correcao chave: instalar `requirements.txt` ANTES do torch do backend (senao torchaudio novo sobrescreve o torch 2.4.1 que o DirectML exige).
- ðŸŸ¢ **Caminho AMD PROVADO PONTA A PONTA:** apos criar o pagefile, o ComfyUI gerou imagem real na RX 7600 via DirectML (`Mike_AMD_Test_00001_.png`, 512x512, ~30s). `torch 2.4.1 + torch-directml 0.2.5`.
- ðŸŸ¢ **Incidente real corrigido 2026-06-29 (entry point `torch_library_impl` / `_torchaudio.pyd`):** no PC do dono o ComfyUI parou de abrir com o erro Windows *"Nao foi possivel localizar o ponto de entrada do procedimento torch_library_impl na biblioteca de vinculo dinamico ...torchaudio\lib\_torchaudio.pyd"*. Causa = exatamente a armadilha descrita acima: o venv tinha **torchaudio 2.11.0** (espera torch 2.11) sobre **torch 2.4.1+cpu / torch-directml 0.2.5 / torchvision 0.19.1** â€” o `_torchaudio.pyd` procurava simbolo que o torch 2.4.1 nao exporta. **Fix aplicado:** `pip install torchaudio==2.4.1 --index-url https://download.pytorch.org/whl/cpu` (resultou em `torchaudio-2.4.1+cpu`), realinhando o trio. Validado: `import torch, torchaudio, torchvision, torch_directml` carrega tudo e `torch_directml.device_count()=1` (RX 7600). Tambem foram removidas distribuicoes corrompidas `~*` (restos de pip uninstall interrompido: `~orch`, `~orchvision`, `~umpy` etc.) que poluiam o site-packages e o disco apertado (~18GB). **Licao para o instalador:** garantir SEMPRE que torchaudio/torchvision fiquem no par do torch do backend (2.4.1) e nunca deixar `pip install -r requirements.txt` rodar DEPOIS do torch do backend sem fixar versoes.
- ðŸŸ¢ **Pagefile resolvido:** `local-ai/habilitar-memoria-virtual-mike.cmd` (NOVO, admin+reboot) criou C:\pagefile.sys; commit subiu de 8â†’12.2GB e o modelo de 4GB carregou. Sem isso dava `os error 1455`. No RTX 2070 nao ocorre (usa VRAM via CUDA).
- ðŸŸ¢ **install-bundle.ps1 migrado:** `Get-GpuInfo` agora detecta AMD/Intel (nao so `nvidia-smi`); tier `directml` para AMD/Intel; o motor de imagem virou o portatil (CUDA/DirectML/CPU) no lugar do A1111 NVIDIA-only. Publicado no site (HTTP 200).
- ðŸŸ¢ **RTX 2070 detectado automatico na rede:** maquina **CADASTRO02 (10.1.1.146)**, app 2.16.2-minike, Ollama com `qwen3:8b`, `qwen2.5-coder:7b`, `gemma3:4b`. E o no gerador forte (8GB VRAM) â€” geracao pesada/SDXL/video deve ser delegada a ele.
- ðŸŸ¢ **Video:** pipeline ffmpeg (criar+audio, converter GIF/transcode) validado â€” grÃ¡tis, multiplataforma. Geracao de video por modelo NAO e viavel neste PC de 8GB; delegar a no capaz.
- ðŸŸ¢ **Agente de doacao de computacao** `local-ai/mike-compute-tray-agent.ps1` (NOVO): icone na bandeja, inicia com Windows (Scheduled Task `MikeLocalAI-ComputeTrayAgent` no logon), e **throttle GRADUADO** â€” usuario ATIVO limita workers a ~30-50% (afinidade de nucleos + prioridade), OCIOSO â‰¥30min libera 100% pra rede. Provado: ollama 4â†’2 nucleos sob demanda. Substitui o liga/desliga do `mike-mouse-idle-agent.ps1`.
- ðŸŸ¢ **Integracao no instalador:** `install-mike-multimedia-skills.ps1` agora chama o portatil (`-Backend auto -Profile auto`). O EXE/CMD tambem instala o agente de doacao automatica da rede no preset cluster: ativo = ate 50%; ocioso >=30min = 100% para a rede. Os arquivos novos foram **publicados em `minike.com.br/local-ai/`** (HTTP 200) para o instalador/atualizacao puxarem.
- ðŸŸ¢ **Rede/relay automatico:** Ollama local + nos LAN alcancaveis (CADASTRO02 10.1.1.146 = `qwen3:8b`; ELETRONICOS 10.1.1.67 dono da rede). O core agora auto-conecta no boot: converge PCs sem caminho manual para a pasta canonica de relay, liga `lan_relay_enabled`, usa `lan_sync_mode=background`, publica presenca, aceita `/compute-cluster/quick-connect`, anuncia/descobre relay por farol UDP e, em rede sem servidor, tenta criar/compartilhar `C:\ProgramData\MikeRelay` via SMB quando estiver elevado. Pendente operacional real: todos os PCs precisam reiniciar/atualizar a Mike e ficar na mesma conta/time quando o escopo exigir conta privada.

**Instalacao 100% automatica (principio do dono: zero clique, zero passo manual):**
- ðŸŸ¢ `install-comfyui-mike.ps1` REESCRITO (mesma interface, logica inteligente): detecta CUDA/DirectML/CPU, ordem certa do torch, baixa SD1.5 se faltar, **pagefile automatico** (auto-eleva via UAC quando preciso) e inicia com a flag certa. Era ele que abria a "janela preta" e fechava (instalava torch CPU + build pesado e estourava sem pagefile). Publicado.
- ðŸŸ¢ `instalar-mike-windows.cmd` agora **auto-eleva no inicio** (1 UAC) e **reinicia sozinho no final** se algum instalador criou pagefile (via marcador `%LOCALAPPDATA%\MINIKE-Local-AI\.needs-reboot`). Publicado.
- ðŸŸ¢ `install-bundle.ps1` + `install-comfyui-portable.ps1` tambem gravam o marcador `.needs-reboot`. Resultado: rodar o instalador num PC novo = detecta GPU â†’ instala backend certo â†’ configura pagefile â†’ reinicia â†’ pronto, sem o usuario apertar nada alem do "Sim" do UAC.

**Runtime corrigido (causa da "janela preta" no RTX):** o endpoint `/integrations/comfyui/install` (mike-local-ai-minike.ps1 ~L15092) rodava o instalador antigo LOCAL (torch CPU + build pesado) sem re-baixar. Corrigido: agora **sempre baixa o `install-comfyui-mike.ps1` inteligente** (backend auto + `-Start -AutoReboot -Checkpoint sd15`) e o caminho de START usa `config.comfyui.launch_args` (flag certa: --directml/CUDA/--cpu). Runtime + `.sha256` + fallback do `.cmd` republicados (SHA `374886E1...`). Site estava desatualizado; dono autorizou sobrescrever.

**REDE MINIKE â€” diagnostico honesto atualizado (2026-06-29):** a parte tecnica de auto-conexao foi entregue no core: relay canonico, quick-connect, background sync, presenca, tarefas de imagem/Programar, farol UDP e auto-share SMB defensivo. O que ainda depende de operacao real e cada PC estar rodando o core novo, aberto/reiniciado e com escopo de conta/time compativel. Se um PC antigo continuar batendo heartbeat em `_cluster-relay` ou em conta divergente, ele nao vera os workers fortes ate atualizar/reiniciar.

**Pendente (proximas frentes pedidas pelo dono):**
- ðŸŸ¡ **RTX 2070 (CADASTRO02 10.1.1.146):** reabrir/reinstalar a Mike nesse PC para pegar o core publicado, confirmar `image_ready=true` e testar imagem enviada por PC sem GPU. O codigo ja roteia por GPU; teste real depende da maquina estar ligada/atualizada.
- ðŸŸ¡ **Unificar a rede Minike:** o relay automatico ja converge os PCs para a mesma pasta quando nao ha caminho manual. Ainda falta conferir em campo se todos os PCs do dono (incluindo 5060 e AMD 7600 de casa) estao com Mike nova, mesma conta/time quando necessario, `lan_sync_mode=background` e `image_generate` liberado.
- âœ… **Pagina de download (UX):** `local-ai/index.php` agora tem botao principal "Baixar a Mike (Windows)" para EXE e botao separado "Baixar instalador CMD"; comandos tecnicos usam `format=cmd` para nao baixar EXE salvo como CMD.
- â¬œ **Controle remoto tipo AnyDesk + macros distribuidos com IA na rede toda** (dono pediu). Ja existe `rustdesk` marcado "preparado" no dependency-report; base para suporte remoto visivel + automacao de funcoes entre PCs.
- ðŸŸ¡ Gateway "imagem a partir de celular/PC fraco": PC sem GPU ja roteia pedidos para worker LAN com GPU pela Mike/relay e nao cai mais no gerador local lento; falta validar a experiencia completa a partir de celular/web publica e finalizar UX de acompanhamento remoto.
- â¬œ Roteamento automatico **Ollama (local/rede grÃ¡tis) â†’ nuvem paga so com chave** (free-first; nunca default pago).
- âœ… Auto-conectar a rede ao abrir o Mike: entregue no core (`auto_cluster`, relay canonico, farol UDP, auto-share SMB quando elevado, `quick-connect`, presenca e sync em background). Confirmacao operacional continua sendo abrir/reiniciar cada PC para ele carregar o core novo.
- â¬œ **Marketplace de processamento** (vender/doar a rede comunitaria, escopo conta vs comunidade) â€” esqueleto em `compute-cluster.json` (`community_enabled`, `payout_mode`, `share_minike_network_enabled`).
- â¬œ Testar caminho **CUDA no RTX 2070** (detecta sozinho quando o Mike for atualizado la).
- â¬œ **UX obrigatoria (principio do dono):** para o usuario final tudo precisa ser **automatico, intuitivo, com feedback visual e animacoes** durante etapas longas (downloads de GB de modelos/torch) â€” barra de progresso real + status por etapa, para **nunca parecer travado**. Os scripts ja emitem `[NN%] mensagem`; a UI (`instalar.php`/`index.php`/`mike-ui.html`) deve consumir isso em tempo real (stream/polling) com animacao.

---

## 1.2 Frente 2026-06-30 — Estudio (canvas/gerador) OFFLINE dentro da Mike + video por IA (local e rede)

> Contexto: o dono pediu para integrar a ferramenta `gerador` (o "Estudio Minike", canvas
> fabric.js com texto/imagem/GIF/PDF/export) DENTRO da Mike Local, para gerar e editar artes,
> imagens, GIFs e videos de varios formatos. Decisao do dono: rodar **100% local/offline**
> (nao embutir o site via iframe). Depois pediu tambem que o **video use processamento em rede**.

**Entregue (codigo, validado por sintaxe; geracao de imagem/video depende de GPU e NAO foi testada em hardware nesta maquina):**

- 🟢 **Bundle offline do Estudio** — `local-ai/build-mike-studio-bundle.ps1` (NOVO): le `ferramentas/gerador/gerador.php`, resolve o PHP (helper `v()`, flag `$minikeCanServerSave`, `is_file`), copia os ~34 assets locais (.js/.css) + `assets/`, **vendoriza as 5 libs de CDN** (fabric.js, JsBarcode, jsPDF, html2pdf, gif.js + gif.worker) em `vendor/`, injeta `<base href="/studio/app/">` e reescreve `http://127.0.0.1:47885` -> same-origin (port-agnostico) nos JS. Saida: `local-ai/studio/` (commitada) + `local-ai/studio.zip` (para instalacoes remotas baixarem). Rodar com `-SkipVendor` para nao rebaixar as libs.
- 🟢 **Core serve o canvas offline** (`mike-local-ai-minike.ps1`): rota `GET /studio` -> `studio/index.html`; rota `GET /studio/app/*` -> assets estaticos com MIME correto (`Get-StudioMimeType` + `Send-StudioStaticFile`, travado contra path traversal). Testado ponta a ponta com HttpListener isolado: `200` + content-types corretos (html/css/js/vendor). `/studio*` ja era auth-bypass + CORS no dispatcher.
- 🟢 **Instalador copia o Estudio** — `Sync-MikeStudioBundle` copia a pasta `studio/` para o InstallDir (copia local recursiva da pasta inteira; ou baixa `studio.zip` do site em instalacao remota). Chamado no fluxo do instalador (Write-Stage 78). **Armadilha corrigida:** `Copy-Item -LiteralPath` com `*` NAO expande wildcard -> copiar a PASTA inteira sem `*`.
- 🟢 **Aba "Estudio" no menu** — `mike-ui.html`: novo item de nav `data-view="studio"` -> `openStudio()` abre `/studio` no viewer iframe (mesmo origin, sem o proxy `/site`).
- 🟢 **FIX critico de origem** — `Test-StudioOrigin` nao aceitava a porta local; adicionado `http://127.0.0.1:$script:Port` e `localhost`. Sem isso `/studio/session` e `/studio/image/generate` davam **403** quando o canvas roda offline na propria Mike.
- 🟢 **Gerar/editar imagem por IA**: ja tinham backend e foram reaproveitados — `generateFromPrompt` (no `minike-studio-sources.js`) chama `/studio/image/generate`; edicao via `/integrations/image/edit` (img2img/inpaint A1111/Forge; ComfyUI ainda pede workflow de edicao dedicado). GIF/export sao client-side (libs vendorizadas, funcionam offline).

**Video por IA (texto -> video) — NOVO nesta frente:**
- 🟢 Funcoes no modulo limpo `local-ai/comfyui-mike-agent.ps1` (dot-sourced, SEM armadilha de here-string): `New-ComfyUIVideoWorkflow` (carrega `comfyui-workflows/text-to-video-animatediff.json` gravado por `install-mike-video-engine.ps1`, patcha `__PROMPT__`/`__NEGATIVE__`/dimensoes/frames/seed/steps), `Start-ComfyUIVideoGeneration`, `Get-ComfyUIVideoJob` (le outputs `gifs`/`videos` do `VHS_VideoCombine`, copia de `ComfyUI\output` para `uploads/` -> `/uploads/<nome>`), `Convert-ComfyUIVideoRefToResult`.
- 🟢 Rotas no core: `POST /integrations/video/generate` e `GET /integrations/video/poll`. O botao "Gerar video" do chat (`vidBtn` no `mike-ui.html`) agora chama `generateVideoFlow()` (gera + poll + abre o video no viewer). Precisa de **GPU + motor de video instalado** (`install-mike-video-engine.ps1`, AnimateDiff sobre ComfyUI).
- 🟢 **Video em REDE/cluster** (pedido do dono): nova task `video_generate` no catalogo (`Get-ComputeTaskDefinitions`) e nos `allowed_tasks` padrao (so workers com GPU sao escolhidos). `Invoke-ComputeVideoGeneration` espelha `Invoke-ComputeImageGeneration` (acha worker LAN forte, grava job no relay, espera resultado). Executor no worker: branch `video_generate` em `Start-ComputeLanTaskWorker` (chama `/integrations/video/generate` local com `prefer_local=true; allow_network=false` para evitar loop, depois faz poll) e em `Invoke-ComputeTask` (fallback do coordenador). A rota `/integrations/video/generate` tenta a **rede primeiro** quando o PC local nao tem GPU/ComfyUI (igual imagem).

**Repaginada visual do Estudio (layout Canva/PowerPoint) — ENTREGUE nesta frente:**
- 🟢 `ferramentas/gerador/studio-shell.css` + `studio-shell.js` (NOVOS): reorganizam o editor existente (aba3) em 4 zonas — **barra superior** (toolbar Word/PPT reaproveitada), **trilho + painel esquerdo retratil** estilo Canva (Fotos/IA, Texto, Formas, Upload, Templates, Fundo, Cores, Efeitos, Codigos), **canvas central**, **filmstrip inferior retratil** com as paginas lado a lado (a antiga `slidesPanel` virou horizontal) e **dock direito** com abas **Propriedades** (`painelProps`) + **Chat IA** (reaproveita o painel do `MinikeStudioMikeAdapter`). Toggles para recolher cada zona. **Tela inicial** com "Documento em branco" + formatos rapidos (`MinikeStudioLauncher.formats`) + galeria "Seus trabalhos" (WorkTabs). Tema ciano->roxo, animacoes suaves, baixa densidade. Reaproveita TODAS as funcoes globais existentes. Ativa SO no bundle offline (`window.MIKE_STUDIO_EMBED`); o build injeta o CSS/JS no `index.html`. **NAO altera o site online.** Falta um passe de ajuste fino VISUAL numa Mike rodando.

**Motores vem prontos na instalacao (pedido do dono "tudo baixado junto"):**
- 🟢 Em PC com GPU o instalador auto-instala **ComfyUI** (imagem, `$comfyAutoGpu`) e agora tambem o **motor de video por IA** (`install-mike-video-engine.ps1`, AnimateDiff) logo apos (Write-Stage 77; falha so avisa). Multimedia (ffmpeg/ImageMagick/Ghostscript) via `install-mike-multimedia-skills.ps1`. O **bundle do Estudio** (`studio/`) e copiado pelo `Sync-MikeStudioBundle`. PC sem GPU nao instala motores pesados (roteia para a rede).

**Pendente / honestidade tecnica:**
- 🟢 **Teste tipo-usuario feito:** bundle servido por HttpListener real, `GET /studio` = 200 e **os 40 assets do index carregaram 200 (zero 404)**; `studio-shell.js` passou em `node --check`; sintaxe PS (core + corpo do agente) = 0 erros.
- 🟡 **NAO testado em hardware** (sem GPU/navegador aqui): render visual do canvas/casca e geracao real de imagem/video. Endpoints e bundle prontos; falta teste final numa Mike instalada com GPU.
- ⬜ **Deploy:** subir para `minike.com.br/local-ai/` o core + `.sha256` + `comfyui-mike-agent.ps1` + `studio.zip` + `install-mike-video-engine.ps1`. `mike-ui.html` NAO entra no hash; `studio/` sincronizada separadamente. Hashes do instalador ja atualizados nesta frente.

---

## 1.3 Frente 2026-06-30 — Impressao automatica loja195 + correcoes LAN/uploads + Mike 2.16.3

> Contexto: integracao de impressoras da loja195 (rede interna) via Mike Local; correcoes
> de bugs encontrados nos testes (LAN sync, servico de arquivos gerados); versao 2.16.3-minike.

**Entregue e validado:**

- 🟢 **Bug LAN sync corrigido** (`Sync-ComputeLanRelay`, loop `$collected`): `$assignment.error = ...` falhava com "Nao e possivel definir uma propriedade em um objeto de apenas leitura" porque o PSCustomObject deserializado do JSON nao tinha a propriedade. Corrigido com 3 linhas `Add-Member -Force` antes do loop: `error`, `result` e `completed_at`. Zero erros de LAN sync apos o fix (anteriormente aparecia a cada 30s nos logs).
- 🟢 **Rota `/uploads/*`** adicionada ao core (`mike-local-ai-minike.ps1`): imagens e videos gerados pelo ComfyUI/video ficam em `UploadsDir` e agora sao servidos sem autenticacao (browser pode carregar `<img src="/uploads/comfyui_xxx.png">`). Protecao contra path traversal (rejeita `..`, paths absolutos, verifica que o arquivo esta dentro de `UploadsDir`). MIME correto para `.png/.jpg/.webp/.mp4/.webm/.json`. Adicionado ao auth-bypass list do dispatcher.
- 🟢 **printService.js criado** (`atendimento/src/services/printService.js`, NOVO): servico de impressao exclusivo para loja195 (`LOJA195_COMPANY_ID=5`). Mapeia 4 impressoras: `argox_gondola` (`\\ELETRONICOS\ARGOX_GONDOLA`, ZPL, label IDs 4/7/9/11/26), `argox_adesiva` (`\\ELETRONICOS\ARGOX_ADESIVA`, ZPL, IDs 5/19/21), `a4_caixa` (`\\DESKTOP-JACFU1P\A4_CAIXA`, A4, IDs 1/2/3), `epson_colorida` (`\\Cadastro02\EPSON L5590 Series`, A4 color). Funcoes: `enqueuePrintJob` (cria artifact + job `print_document`), `enqueueLabelPrint` (rota por label_id), `getRecentPrintJobs`, `getAvailablePrinters`.
- 🟢 **Rotas de impressao em `atendimento/src/routes/api.js`**: `GET /api/print/printers`, `POST /api/print/label`, `POST /api/print/document`, `GET /api/print/jobs` — todas filtradas por `company_id=5`, retornam 403 para outras empresas.
- 🟢 **`loja195_mike_config.php` criado** (`loja195/loja195_mike_config.php`, EXCLUSIVO REDE INTERNA): config PHP que aponta para Mike Local porta 47885, token lido de `MINIKE-Local-AI\token.txt`, funcoes `loja195_mike_print`, `loja195_mike_print_label`, `loja195_mike_chat`, `loja195_mike_available`, `loja195_mike_request`. **NAO sobe ao site publico nem ao instalador.**
- 🟢 **Rota `/integrations/print/send`** adicionada ao core (POST): recebe `printer_unc`, `printer_key`, `content` (base64), `content_type`, `copies`. Para ZPL: copia arquivo RAW para `\\UNC\impressora`. Para texto/A4: usa `notepad.exe /p`. Requer `X-Mike-Token` (mesma autenticacao das outras rotas de integracao).
- 🟢 **Agente atualizado para v2.16.3-minike**: re-extraido da source PS1 (linhas 1409..19699, 18291 linhas), placeholders substituidos, parse = 0 erros, 1.461.687 bytes. Reiniciado com sucesso.

**Arquivos criados/modificados:**
- `atendimento/src/services/printService.js` (NOVO)
- `atendimento/src/routes/api.js` (require + 4 rotas de print)
- `loja195/loja195_mike_config.php` (NOVO, INTERNO)
- `local-ai/mike-local-ai-minike.ps1` (rota /uploads + rota /integrations/print/send + fix LAN sync Add-Member)
- `C:\Users\Geral\AppData\Local\MINIKE-Local-AI\mike-local-ai-agent.ps1` (reinstalado v2.16.3)

**Pendente / proximos passos de impressao:**
- 🟡 Integrar `loja195_mike_config.php` nos fluxos do site loja195 (ex.: gerar etiqueta do produto -> chamar `loja195_mike_print_label`) — aguarda atualizacao do site loja195 pelo dono.
- 🟡 Verificar se `Invoke-PrintDocument` no local agent do atendimento trata `.zpl` (raw print para Argox) ou so `.txt/.pdf`.
- ⬜ Testar impressao real nas Argox (depende das impressoras ligadas na rede).

---

## 1.4 Frente 2026-07-01 — Correcoes criticas de runtime + rota /programming/ask

> Contexto: testes completos sobre a Mike 2.16.3 revelaram travamento critico no terminal (ollama list bloqueava o servidor por 6+ minutos) e rota /programming/ask ausente. Ambos corrigidos e validados com 23/23 testes passando.

**Entregue e validado:**

- ✅ **Fix critico: terminal `ollama list` travava Mike por 6+ minutos** (`local-ai/mike-local-ai-minike.ps1`, funcao `Invoke-GlobalTerminalCommand`): a implementacao anterior usava `BeginOutputReadLine()` (leitura assincrona por eventos) + `WaitForExit()` sem timeout para aguardar a entrega dos eventos. O `ollama.exe` mantem processos filhos que seguram os pipes de stdout/stderr abertos apos o processo pai sair, causando `WaitForExit()` bloqueado por minutos ate o SO fechar os handles. **Fix:** substituir completamente a abordagem de eventos por `ReadToEndAsync()` do .NET Tasks — inicia leitura paralela de stdout/stderr como Tasks antes do processo, chama `WaitForExit(30000)` com timeout seguro, depois `Task.WaitAll(5000)` para drenar. Resultado: `ollama list` retorna em 0.2s com saida completa; Mike fica viva apos o comando.
- ✅ **Fix catch block do loop HTTP principal**: excecoes secundarias dentro do `catch` (ex.: erro ao serializar `InvocationInfo`) podiam matar o loop principal. Corrigido com try/catch internos para cada operacao de string e para o `Send-Json` de erro.
- ✅ **Rota `POST /programming/ask` criada** (`mike-local-ai-minike.ps1`): recebe `{ question: "..." }`, seleciona modelo de codigo com `Select-InstalledModelForPurpose -Purpose "coding"`, chama `Invoke-Ollama` com prompt bilíngue e retorna `{ ok, answer, model }`. Teste: pergunta sobre loop PowerShell retornou resposta completa em portugues em ~15s.
- ✅ **Extracao do agente com deteccao de limites dinamica**: a extracao da here-string `$agentSource = @'...'@` agora usa busca dinamica de linha (procura o marcador `$agentSource = @'` e o primeiro `'@` isolado subsequente) em vez de numeros de linha fixos, que quebravam a cada adicao de linha. Todos os 8 placeholders substituidos corretamente.
- ✅ **23/23 testes passando**: core, chat, memoria, imagem (ComfyUI offline = skip), studio, uploads, LAN/cluster, terminal (`ollama list`), ferramentas, video, programar (`/programming/ask`), print — zero falhas reais.

**Arquivos modificados:**
- `local-ai/mike-local-ai-minike.ps1` — `Invoke-GlobalTerminalCommand` (ReadToEndAsync), catch block hardened, rota `/programming/ask`
- `C:\Users\Geral\AppData\Local\MINIKE-Local-AI\mike-local-ai-agent.ps1` — agente reinstalado com fixes (18.304 linhas, parse OK)

**SHA256 do core apos esta frente:** a calcular antes do deploy (o source foi modificado 3x nesta sessao; rodar `Get-FileHash` ou `update-mike-installer-hashes.ps1` antes de publicar).

**Pendente desta frente:**
- ⬜ Calcular novo SHA256 e atualizar `.sha256` + `release-status.json` + `CORE_SHA256_FALLBACK` no `.cmd`
- ⬜ Deploy no Hostinger (SSH `u340626637@82.29.191.154:65002`) — subir core + `.sha256` + `.cmd`
- ⬜ Deploy do atendimento — gerar zip com `gerar-zip-v60-completo-total.ps1 -PermitirSegredos` e fazer upload
- ⬜ Testar LAN com outros PCs (relay mostra peers=3, cluster workers=1 apenas este PC — outros PCs precisam atualizar Mike)
- ⬜ Editar fotos/videos em massa (ComfyUI + ffmpeg prontos, falta workflow de batch no front)

---

## 1.5-B Frente 2026-07-02/03 — Mike Local 2.16.5: preview multi-dispositivo, coder local, encoding BOM — DEPLOYADO

> Sessao noturna 02/07 + madrugada 03/07. Tudo PUBLICADO em minike.com.br/local-ai/ e conferido por hash via HTTPS.

- **NOVO `/preview`** (pedido do dono "cade o preview"): `GET /preview?project_id=X&token=T[&path=...]` abre o projeto em 4 molduras simultaneas (Android 360x800, iPhone 390x844, Tablet 768x1024, Desktop 1280x760) com auto-refresh 3s; `GET /preview/p/<token>/<pid>/<arquivo>` serve os arquivos com MIME correto (Resolve-ProjectPath + Test-BlockedLocalPath, cap 40 MB). Token via query/path porque iframe nao manda header; mesmo `Test-LocalApiAccess`. Botao **Preview** no Programar das DUAS UIs (`mike-ui.html` `progPreview()` + fallback embutido `previewProjectBtn`). Implementado no `$agentSource` E no agente instalado.
- **Programacao deixou de ser "burra"**: o papel adaptativo `coding` caia no gemma3:1b porque nenhum coder passava no gate de RAM. Instalado `qwen2.5-coder:1.5b` (unico que cabe em 7.9 GB); role confirmado via API (`action: use`). PCs 16 GB+ pegam o coder 7b sozinhos.
- **Memoria estilo Obsidian JA EXISTE** (markdown, [[wikilinks]], backlinks, grafo, canvas, vetorial TurboVec) — NAO recriar.
- **Fixes**: instalador com BOM UTF-8 (sem BOM o PS 5.1 lia ANSI -> agente com mojibake; NUNCA remover); `mike-cluster-router.ps1` Export-ModuleMember guardado (`if ($MyInvocation.MyCommand.ScriptBlock.Module)`) — dot-source nao quebra mais; crash `/projects/study` (BFS limitada) e `/health` publica (sessao da manha 03/07).
- **Release publicado:** core SHA256 `53930271863794458B1B60C6170533935F45474A4FF65908C309A8B73FA73F6D` (`.sha256` + CORE_SHA256_FALLBACK + release-status.json consistentes). `mike-ui.html` e `mike-cluster-router.ps1` subidos via SFTP 03/07 (webroot `/home/u340626637/domains/minike.com.br/public_html/local-ai/`). Frota atualiza sozinha no proximo launch (auto-update por hash).
- GOTCHAS novos: porta 47885 aparece como PID 4 (http.sys) no netstat — nao usar para achar o processo; `/ui` demora ~40s no primeiro hit (single-thread); token muda a cada boot (extrair do HTML de `/ui`); outra sessao de IA pode estar editando os mesmos arquivos da pasta compartilhada — revalidar hash antes de escrever.
- Log detalhado: `docs/execucao-minike/IMPLEMENTADO_2026-07-02.md` (sessao noturna) + memoria `project_status_2026-07-02_noite` / `project_status_2026-07-03`.

**Adendo 03/07 manha — Controle de acesso + menu personalizavel (DEPLOYADO, core `3F78DC6E66C7...81E6`, versao `2026.07.03-acessos-atalhos-preview`):**
- **Acesso por niveis dono x funcionario** (pedido: empresas limitarem funcionarios): `GET/POST /access/config` + `POST /access/unlock`; PIN SHA256+salt em `access-config.json`; **bloqueio no SERVIDOR** de rotas sensiveis (`/terminal/*`, `/extensions/*`, `/account/*`, `/connectors/save|revoke`, `/models/install`, `/capabilities/modules/install`, `/macros/save|delete`, `/self-heal`, `/setup/quick-install`) via header `X-Mike-Access-Pin`. UI na engrenagem da barra rapida: ativar, PIN, telas bloqueadas, alternar modo DONO/FUNCIONARIO por PC. Vem DESATIVADO por padrao.
- **Menu lateral personalizavel**: checkboxes na engrenagem para esconder/mostrar itens da tela (Chat fixo; localStorage por PC). Modal de atalhos da barra rapida (arrastar/remover/adicionar) ja existia.
- Seguranca testada: traversal no /preview bloqueado, loopback-only, gates de token ok, PIN com delay anti forca bruta. 9/9 testes de API passaram.

---

## 1.5 Frente 2026-07-02 — Legal/anti-copia, Mike Local (3 bugs), Atendimento e PDV/Fiscal (HANDOFF vivo)

> Sessao longa. Tudo abaixo esta DEPLOYADO na Hostinger salvo onde indicado. Esta e a
> secao de CONTINUACAO — ler antes de retomar qualquer frente desta data.

### Ambiente/ferramentas desta maquina
- **PHP 8.3.32 portatil** em `...\scratchpad\php\php.exe` (servidor Hostinger = 8.3.30). Usar para `php -l` local. Se sumir, rebaixar de windows.php.net (zip nts x64).
- **Deploy SSH/paramiko**: host `82.29.191.154:65002`, user `u340626637`, webroot `/home/u340626637/domains/minike.com.br/public_html`. Senha com o dono; **NUNCA gravar** — passar por env `MK_SSH_PW`. Padrao SEGURO: upload -> `~/deploy_tmp_codex/<stamp>` -> `php -l` remoto -> backup `~/backups_codex/<stamp>` -> `mv`. Aborta se lint falhar.

### (A) Conformidade legal BR/EUA + anti-copia (site PHP) — DEPLOYADO
- `privacidade.php`/`termos.php`: controlador **65.138.449 Felipe Gabriel Hugen (MEI), CNPJ 65.138.449/0001-66**, Guaramirim/SC, DPO Felipe (minike@minike.com.br). Termos secoes 11-13 (anti-copia: copia/hacking/dano -> multas+acao legal; adaptacoes so via suporte; lei/foro).
- `includes/license_guard.php` (NOVO): anti-copia fail-open, kill-switch, allowlist. Env `MINIKE_LICENSE_MODE`=off|monitor|enforce. **Padrao monitor; enforce DESLIGADO** ate o dono validar dominios. Ligado em `includes/mk_boot.php` (try/catch). Extras: `MINIKE_LICENSE_DOMAINS`.
- `includes/cookie_consent.php` (NOVO): banner LGPD/GDPR bilingue, integra opt-out + GPC, render-uma-vez. Emitido por `footer-unificado.php` e `global_trust_layer.php` (home/cursos/sites). Verificado LIVE.

### (B) Mike Local (local-ai) — testado + 3 bugs corrigidos — DEPLOYADO
- Instancia testada na porta 47889. Bugs no core corrigidos: (1) `/search/web` 500 `([string](if...))`->`$(if...)`; (2) `/compute-cluster/lan/sync` 500 validar `^[a-f0-9]{32}$` do coordinator_job_id; (3) `/voice/transcribe` 400/424 amigavel.
- **Hashes atuais (predeploy OK):** core `214E2B586DE7F9F673404141073081C7FEFCE1C83533E8FE75F96B10DCFA8294`; EXE `3FA3231D65A9C6B5EBA50D769EF18042D1DBC12E5F6E3E661148E76E2E80BBFE`.
- GOTCHAS: agente instalado em `%LOCALAPPDATA%\MINIKE-Local-AI\mike-local-ai-agent.ps1` pode ficar mais velho que o core (regenerar do `$agentSource`, 8 placeholders de install + 4 de runtime deixar). Ao matar processos filtrando CommandLine "mike-local-ai-agent" -> excluir `$PID` (casa o proprio shell). release-status.json exe hash e MANUAL. Changelog do release-status TEM que ser ASCII (mojibake recursivo ja inflou p/ 2,8 MB).

### (C) Atendimento (do DONO — ele zipa/deploya, nao mexer no deploy)
- Revisado: 160 JS ok, 4/4 testes verdes, seguranca ok, mobile/PC ok. Zip: `minike-v60-COMPLETO-atendimento-revisado-final-20260702.zip` (SHA-256 `E4BA5E99...`). Migrations a rodar: 030 + 031.
- Auto-postagem FB/IG: motor legenda (clima+datas) e runner PRONTOS; falta PILOTO AUTOMATICO (produto real do catalogo sozinho) + App Review Meta + `OPENWEATHERMAP_API_KEY`. Detalhe em `atendimento/DOCUMENTACAO_UNIFICADA_MINIKE.md` secao 0-A.

### (D) Sistema de CAIXA/PDV + FISCAL (lojas/) — FRENTE ATIVA, backend DEPLOYADO
Objetivo do dono: caixa completo + homologar fiscal em SC (foco **NF-e 55** servico e **NFC-e 65**; NFS-e depois). Duas versoes: **WEB multi-tenant (1 banco por cliente, super admin)** e **LOCAL instalavel offline-first** (sync com conta Minike; futuramente na Mike Local). **MEI = gratis, so suporte pago por hora.**
DECISAO (ATUALIZADA 2026-07-09 — substitui a antiga "usar Focus NFe"): o projeto segue os DOIS GUIAS FISCAIS oficiais, que sao a referencia vinculante desta frente. A BASE DE TRABALHO E A MESMA (mesmos fatos, custos e decisoes — MEI->ME, OTH, plano A/B/C, migracao a 50%); o que muda e o PONTO DE VISTA: o guia Claude olha o Brasil inteiro + comercial, o guia Codex aprofunda SC/credenciamento. Usar os dois juntos:
- **[Guia Claude — nacional/comercial](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CLAUDE_2026-07-09.pdf)** (`documentação/`, 47 pag., [HTML](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CLAUDE_2026-07-09.html)): custos MEI->ME, rotas baratas (sec. 1-B), plano A/B/C do motor (sec. 2-B), 27 fichas de UF, concorrencia por regime e plano de migracao a 50%.
- **[Guia Codex FINAL — SC/credenciamento](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CODEX_FINAL_2026-07-09.pdf)** (`documentação/`, 75 pag., [HTML editavel](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CODEX_FINAL_2026-07-09.html)): fases do credenciamento PAF/SEF-SC (IN GESAC 01/2020, DARE 2119), OTH/LCL em detalhe (Ato DIAT 15/2022 p/ PAF parceiro), matriz DLL/API/PAF parceiro, 27 UFs e totais anuais recalculados. Versao de trabalho historica: `docs/execucao-minike/GUIA_CREDENCIAMENTO_HOMOLOGACAO_PAF_NFCE_SC_MINIKE_2026-07-08.{html,pdf}` (so o Codex edita).
- Onde os dois divergirem em numero/prazo: prevalece o mais conservador ate confirmar na fonte oficial; registrar a divergencia no handoff.

REGRAS VINCULANTES (resumo dos guias — o sistema segue isto):
1. **Motor fiscal Plano A/B/C**: A = Minike DFe/NFePHP (gratis, ja embarcado, principal em web E PDV local); B = reserva de CUSTO FIXO a cotar (ACBrLib R$ 1.500/ano, Unimake, FlexDocs, TecnoSpeed — NUNCA precificacao por nota); C = Spedy (cara, fica DE LADO mas integrada — nao remover). Focus/APIs por nota: descartadas.
2. **SC/OTH**: DLL/API de terceiro NAO isenta do OTH/LCL (Decreto SC 1.058/2025, art. 95-A e par. 8 — verificado no texto oficial). Laudo e do PAF Minike, validade 24 meses. Ato DIAT com cronograma ainda NAO publicado (09/07/2026) -> OTH ainda nao e cobrado. Pedir 2 cotacoes: OTH proprio (FEESC/FUNDESTE) vs licenciamento de PAF parceiro (rota hibrida D).
3. **Comecar barato (sec. 1-B do guia Claude)**: minimo p/ faturar R$ 317 (JUCESC+e-CNPJ); varejo SC completo hoje R$ 1.212,39; rotas sem OTH: outras UFs, NF-e 55/NFS-e, hibrido retaguarda+PAF parceiro.
4. **Precos/comercial**: mensalidade Simples R$ 109,90 (~30% abaixo da media ~R$ 160); MEI R$ 39,90 (versao gratis mantida conforme politica MEI); migracao de concorrente = 50% do boleto atual por 12 meses, instalacao e importacao de base gratis; sem multa de saida. Custos publicos (OTH, certificado, equipamento) sem desconto artificial.
5. **Expansao por UF**: so liberar UF apos bateria de homologacao daquela UF (fichas do guia Claude); custo tipico R$ 300-800/UF pago quando entrar o 1o cliente. CSRT ja validado em AL/AM/MS/PE/SC/TO e PR a partir de 04/2026; MFE-CE e SAT-SP foram ENCERRADOS (NFC-e obrigatoria desde 01/01/2026 — mercado de migracao em massa).
6. **Pre-cadastro fiscal automatico + botao "Arrumar tudo"** (pedido do dono 2026-07-09): cascata Catalogo EAN -> XMLs de entrada -> Cosmos -> Open Food Facts -> IA (Ollama local, fallback API barata em lote), perfis tributarios por grupo, validacao NCM Siscomex, CEST, IBPT (sped-ibpt) p/ Lei 12.741, flag `fiscal_revisado` + relatorio do contador. REGRA DE OURO: tudo e SUGESTAO — responsabilidade fiscal e do cliente/contabilidade (disclaimer obrigatorio em toda tela). Plano completo: [PRECADASTRO_FISCAL_AUTOMATICO_2026-07-09.md](docs/execucao-minike/PRECADASTRO_FISCAL_AUTOMATICO_2026-07-09.md).
Doc tecnica completa: `lojas/docs/PDV_CAIXA_FISCAL_ARQUITETURA_2026-07-02.md`. Plano base do dono: `galeria195/PLANO_PDV_LOCAL_FISCAL_2026-06-14.md`. Operacional da rodada: `docs/execucao-minike/HANDOFF_SESSAO_2026-07-08_PDV_FISCAL_ERP.md` e `docs/execucao-minike/META_PDV_LOCAL_ERP_FISCAL_2026-07-08.md`.

JA FEITO e DEPLOYADO (php -l ok, backup `~/backups_codex/*-pdv`):
- `lojas/conexao.php`: cria caixa_pdv, pagamentos_pdv, entregas, movimentos_caixa_pdv (+ coluna status_cozinha). BUG real: antes nao eram criadas -> instalacao nova quebrava o PDV.
- `lojas/includes/fiscal_engine.php` (NOVO): fiscal_config_loja + notas_fiscais_pdv; **NFC-e 65** (`fiscal_emitir_nfce`) e **NF-e 55** (`fiscal_emitir_nfe55`); **fila offline** (venda nunca trava sem internet); consultar/cancelar/idempotencia; `fiscal_processar_fila`; campos fiscais por produto (ncm/cfop/csosn/unidade/gtin). Driver Focus (/v2/nfce, /v2/nfe; Basic auth; homolog/prod).
- `lojas/admin/ajax_pdv.php`: sangria/suprimento/listar_movimentos + fiscais (config get/save com token mascarado, emitir_nfce, emitir_nfe55, consultar, cancelar, listar, processar_fila). Fechamento calcula dinheiro esperado na gaveta.
- `lojas/admin/pdv.php`: apos venda oferece NFC-e (CPF na nota); trata fila/autorizada/processando/erro; venda sempre concluida. Smoke: pdv.php = 302 (login), nao 500.

FALTA (proxima sessao, em ordem) — COMECAR PELA UI FISCAL:
1. **UI aba Fiscal** (provider/ambiente/tokens/CNPJ/IE/CFOP/CSOSN/NCM) + **tela "Notas"** (listar/consultar/cancelar/reimprimir DANFE). Acoes ajax ja existem; falta so o front.
2. **Campos fiscais no cadastro de produto** (colunas ja existem).
3. **DANFE/recibo PDF** via `sped-da`; recibo nao-fiscal leve.
4. **Multi-tenant WEB (1 banco/cliente)**: control plane `tenants` + resolver de PDO por dominio/slug + provisionamento no super admin. PEGADINHA: usuario MySQL Hostinger normalmente NAO tem `CREATE DATABASE` -> hPanel/API ou pool pre-criado.
5. **Cron/worker** rodando `fiscal_processar_fila` de todas as lojas (reenvio da fila).
6. **Instalador LOCAL offline-first**: reusar padrao do instalador da Mike Local (EXE/IExpress, auto-update por hash, atalho Inicializar, localhost + banco local, impressao 80mm via printService), sync idempotente por `device_token`.
7. **Homologacao SC**: contador parametriza; gerar CSC homolog+prod na SEFAZ-SC; rodar cenarios pela API; producao assistida.
8. **Integrar na Mike Local** como modulo.

### Pendencias herdadas (outras frentes)
- license_guard: ligar `enforce` quando validar dominios. USD so exibicao (cobranca real via Hotmart; InfinitPay=BRL principal). header-unificado (idioma/moeda) parcial nos subsites. Revisao juridica humana recomendada. Git: mudancas NAO commitadas (dono nao pediu).

---

## 2. Estado real por modulo

Legenda: âœ… pronto e validado Â· ðŸŸ¡ parcial / funciona com ressalvas Â· ðŸ”´ quebrado ou critico Â· â¬œ planejado/nao iniciado.

| # | Modulo | Estado | Resumo honesto | Doc detalhado |
|---|--------|:------:|----------------|---------------|
| 1 | **Mike Local â€” runtime/chat** | âœ… | Readiness local `18/18` em 2026-06-28. Conversa de troca longa e prompt de corpus agora evitam queda para modelo/AirLLM via rotas rapidas. | [ESTADO_IMPLEMENTACAO_ATUAL.md](docs/execucao-minike/ESTADO_IMPLEMENTACAO_ATUAL.md), [HANDOFF_SESSAO_2026-06-25.md](docs/execucao-minike/HANDOFF_SESSAO_2026-06-25.md) |
| 2 | **Mike Local â€” memoria/RAG** | ðŸŸ¡ | Leitura + rebuild sob demanda + fila `memory_refresh` ok. Falta observabilidade, escopos completos (usuario/projeto/empresa/dispositivo) e backend vetorial leve. | [ESTADO_IMPLEMENTACAO_ATUAL.md](docs/execucao-minike/ESTADO_IMPLEMENTACAO_ATUAL.md) Â§2-3 |
| 3 | **Mike Local â€” cluster multi-PC** | ðŸŸ¡ | Relay LAN publica PCs, skills, tarefas de texto/codigo e imagem; quick-connect/auto_cluster ligam relay em background e workers anunciam motores online. Falta teste real com todos os PCs atualizados, ligados e no mesmo escopo de conta/time. | [ARQUITETURA_DISTRIBUIDA_MIKE.md](docs/execucao-minike/ARQUITETURA_DISTRIBUIDA_MIKE.md), [CLUSTER_MODES_MIKE.md](docs/execucao-minike/CLUSTER_MODES_MIKE.md) |
| 4 | **Mike Local â€” provedores nuvem** | ðŸŸ¡ | Catalogo: deepseek, openrouter, groq, together, ollama_cloud. Teste/toggle/save por usuario ok; chave continua por usuario, nunca hardcoded. | [mike-preferences.php](includes/mike-preferences.php), [IA_MODELS_CATALOG.md](docs/IA_MODELS_CATALOG.md) |
| 5 | **Mike Local â€” geracao de imagem/video** | ðŸŸ¡ | Aba Imagem com progresso animado, ComfyUI/A1111/Forge mapeados e roteamento LAN para PC forte. Video segue como proxima etapa. | [GERADOR_MOTORES_IMAGEM_LOCAL.md](docs/execucao-minike/GERADOR_MOTORES_IMAGEM_LOCAL.md), [MODELOS_IMAGEM_VIDEO_MIKE_2026-06-22.md](docs/execucao-minike/MODELOS_IMAGEM_VIDEO_MIKE_2026-06-22.md) |
| 6 | **Mike Local â€” instalador/auto-update** | âœ… | `instalar-mike-windows.cmd` + hash SHA-256 + auto-reparo do core. O instalador sincroniza UI, ComfyUI agent, cluster/connectors e engines secundarios do `/local-ai/`. | [INSTALADOR_UNIVERSAL_MIKE_LOCAL.md](docs/execucao-minike/INSTALADOR_UNIVERSAL_MIKE_LOCAL.md), HANDOFF Â§2-3 |
| 7 | **Atendimento â€” Meta (WhatsApp/IG/FB)** | ðŸŸ¡ | DM + OAuth + comentario por automacao funcionam. Falta publicacao/gestao manual de posts e confirmar escopos em campo. | [MAPA_TECNICO_E_PROGRESSO_ATENDIMENTO.md](atendimento/docs/MAPA_TECNICO_E_PROGRESSO_ATENDIMENTO.md) Â§2 |
| 8 | **Atendimento â€” robos/follow-up** | ðŸŸ¡ | P1 corrigido no codigo: classificador de recusa/pausa, `automation_paused_reason`, gate unico e teste. Falta deploy/migration em producao. | [PENDENCIAS_ATENDIMENTO.md](atendimento/docs/PENDENCIAS_ATENDIMENTO.md) |
| 9 | **Atendimento â€” Mike oficial por empresa** | ðŸŸ¡ | Backend pronto (service+controller+tabela+rotas super admin, trava user_id=1). **Falta a tela visual** do super admin. | [MIKE_OFICIAL_EMPRESAS.md](docs/execucao-minike/MIKE_OFICIAL_EMPRESAS.md) |
| 10 | **Ecossistema â€” registry/concierge** | âœ… | `includes/ecosystem_registry.json` (59 itens) + auto-scan idempotente + concierge server-side. | secao "Mike Local 2.15.0" abaixo |
| 11 | **Subsites (cursos/sites/softwares/escolar/ferramentas)** | ðŸŸ¡ | Paginas reais criadas e puxando do registry curado. Falta portfolio visual, modais de fechamento, aulas/exercicios reais. | [ECOSSISTEMA_CONTEUDO_SITE.md](docs/execucao-minike/ECOSSISTEMA_CONTEUDO_SITE.md), [LACUNAS_CONTEUDO_E_SITES.md](docs/execucao-minike/LACUNAS_CONTEUDO_E_SITES.md) |
| 12 | **Conectores/API + trilha API** | ðŸŸ¡ | Catalogo inicial + endpoints + lab mock (json-server). Falta painel de chaves por empresa e aulas detalhadas. | [TRILHA_API_INTEGRACOES_MINIKE.md](docs/execucao-minike/TRILHA_API_INTEGRACOES_MINIKE.md) |
| 13 | **Visual / redesign chat-first** | ðŸŸ¡ | `mike-ui.html` chat-first com aba Imagem e progresso animado; site PHP ainda precisa checklist visual pagina a pagina. | [redesign-chat-first/](docs/execucao-minike/redesign-chat-first/) |
| 14 | **Seguranca do site PHP** | ðŸŸ¡ | `APP_DEBUG=false`; `read_file`/`save_file` e logs admin protegidos com super-admin, CSRF, realpath/allowlist e auditoria. Ainda restam `catch` vazios/display_errors em diagnosticos. | [BUGS_REPORT.md](BUGS_REPORT.md), [ANALISE_SEGURANCA_QUALIDADE_2026-06-22.md](docs/execucao-minike/ANALISE_SEGURANCA_QUALIDADE_2026-06-22.md) |
| 15 | **Crypto / Minike Coin** | â¬œ | Documentado/contratos iniciais; nao e prioridade operacional agora. | [crypto/DOCUMENTACAO_MINIKE_COIN.md](crypto/DOCUMENTACAO_MINIKE_COIN.md) |
| 16 | **Impressao loja195 (rede interna)** | ðŸŸ¡ | `printService.js` + rotas `/api/print/*` no atendimento + `loja195_mike_config.php` (INTERNO) + `/integrations/print/send` no Mike Local v2.16.3. Backend pronto; falta integracao no site loja195 e teste real nas impressoras. | `atendimento/src/services/printService.js`, `loja195/loja195_mike_config.php` |

**Resposta direta as perguntas do dono:** "tudo pronto" â†’ nao. "Mike local perfeita" â†’ nao (readiness voltou a `18/18`, mas modelo base local ainda e fraco fora das rotas rapidas e falta teste multi-PC real). "100% integrado tudo que foi comecado" â†’ nao (varias frentes ðŸŸ¡ com "falta"). "Atendimento perfeito" â†’ nao (P1 corrigido no codigo, mas falta migration/deploy operacional). "Ecossistema conectado como um todo" â†’ parcial (registry conecta, mas frentes incompletas). "Subsites prontos" â†’ parcial. "Visual animado e vivo" â†’ parcial (Mike UI melhorou com progresso de imagem; site inteiro ainda nao foi validado pagina a pagina).

---

## 3. Arquitetura tecnica

### 3.1 Mike Local â€” ARMADILHAS CRITICAS (ler antes de editar o `.ps1`)

O arquivo [local-ai/mike-local-ai-minike.ps1](local-ai/mike-local-ai-minike.ps1) (~1.2 MB) e ao mesmo tempo **instalador E servidor**:

1. **O servidor inteiro vive dentro de uma here-string** `$agentSource = @' ... '@` (linha ~1279 ate ~14530). Esse texto e gravado em disco e executado como o agente.
   - Editando rotas/funcoes do agente, voce esta DENTRO da here-string. **NUNCA** abra outra here-string `@'...'@` ali â€” o `'@` interno fecha a externa e quebra tudo. Se precisar aninhar, use `@"..."@` (double) e nenhuma linha pode comecar com `"@`.
   - Funcoes do instalador (`Sync-MikeLocalAiAsset`, `Ensure-*`, bloco final de install) ficam FORA (linhas < 1279 e > 14530).
2. **Validacao obrigatoria apos QUALQUER edicao**: parsear o arquivo inteiro E o corpo do agente isolado, ambos com 0 erros. Caminho UNC quebra `ParseFile` â†’ use `ParseInput` com `Get-Content -Raw`.
3. **Hash**: depois de editar o `.ps1`, regenere com `local-ai/update-mike-installer-hashes.ps1` (atualiza `.sha256` e `CORE_SHA256_FALLBACK` no `.cmd`). Sem isso o auto-reparo rejeita o core.
   - Antes de publicar ou entregar instalador, rode tambem: `powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/validate-mike-local-predeploy.ps1 -Json`.
4. **UI nova e arquivo EXTERNO** [local-ai/mike-ui.html](local-ai/mike-ui.html): `Get-MikeUiV2` serve esse arquivo (fallback embutido se faltar). **Edite o HTML livremente** â€” nao entra no hash, deploy rapido. Placeholders: `__LOCAL_API_TOKEN__`, `__MODEL__`, `__VERSION__`; UI manda token no header `X-Mike-Token`.
5. **Fatiamento do "monstro"**: em andamento (fase 2/3) â€” shim `mike-monstro-main.ps1` + `mike-monstro-orchestrator.ps1` + indice `mike-monstro-index.json` (617 funcoes mapeadas). Fase 3 (modulos reais) so apos orchestrator estavel.

**Deploy (Hostinger):** SSH `u340626637@82.29.191.154:65002` (senha so com o dono, **nunca** em arquivo). Web root `/home/u340626637/domains/minike.com.br/public_html`, local-ai em `<webroot>/local-ai/`. Sem sshpass â€” usar **Python + paramiko** com senha em env var; CWD na pasta local-ai (UNC quebra no python). Publicar `.ps1` + `.sha256` + `.cmd` sempre juntos quando muda o core.

### 3.2 Atendimento (omnichannel) â€” [atendimento/](atendimento/)

- **Stack:** Node.js (CommonJS), Express + MySQL (`mysql2`) + Socket.IO + Baileys (WhatsApp Web) + Meta Cloud API + Gemini/LLM local + Tailwind. Entry: `index.js`. Pacote `minike-omnichannel-ai` v1.4.x. **66 services** em `src/services/`, **29 migrations** (ultima `029_minike_memory.sql`).
- **Rotas:** `/webhook`, `/api/auth`, `/api/master` (superAdmin), `/api/local-agent`, `/api/governance`, `/api` (principal, `authMiddleware`), `/api/ai`, `/auth` (OAuth Meta). UI: `public/dashboard.html` (empresa), `public/master.html` (super admin).
- **Meta:** `metaService.js` (~1900 linhas) WhatsApp Cloud + IG/FB DM + comentarios; `oauthCallback.js` faz o fluxo OAuth completo e upsert em `channels`. Tokens por empresa em `company_settings`.
- **Memoria Minike:** `minikeMemoryService.js` + tabelas `ai_contact_memory(_items)` + fila/worker `memory_refresh` ativo no `index.js`.
- **Deploy:** zip self-contained gerado **localmente** por `gerar-zip-v60-completo-total.ps1 -PermitirSegredos` (a Hostinger nao gera o zip).

### 3.3 Site PHP + Ecossistema

- Site principal PHP em `minike.com.br` (hub) e subdominios (ex.: `sites.minike.com.br`). Diretorios-subsite na raiz: `admin, ads, afiliados, api, bio, blog, crm, crypto, cursos, delivery, erp, escolar, ferramentas, financeiro, games, imagem, lojas, pagamento, ponto, sites, sobre, softwares, texto, trabalhos` (+ `atendimento`, `local-ai`, `mike`).
- **Registry do ecossistema:** [includes/ecosystem_registry.json](includes/ecosystem_registry.json) (59 itens: 19 subsites, 22 tools, 13 engines, 5 connectors) + `ecosystem_registry.php` (`mke_ecosystem_*`). Auto-scan idempotente em `tools/ecosystem_scan.php`.
- **Curadoria de conteudo:** [includes/ecossistema_content_registry.php](includes/ecossistema_content_registry.php) alimenta as vitrines de ferramentas, cursos, softwares, escolar e sites.
- **Planos/monetizacao:** `local-ai/mike-usage-plans.json` (free/pro/enterprise, quotas, ads discretos) + `includes/mike-usage-plans.php`.

---

## 4. Provedores de IA e modelos

**Catalogo atual** ([includes/mike-preferences.php](includes/mike-preferences.php) `mke_preferences_api_provider_catalog`):
`deepseek`, `openrouter`, `groq_cloud`, `together_ai`, `ollama_cloud`. API em `api/local-ai.php?action=api-providers` (+ save/test/toggle/delete por usuario).

**Modelos locais (Ollama):** perfil por hardware â€” `gemma3:270m` (muito fraco, so roteamento), `gemma3:1b` (leve), `gemma3:4b` (medio, ainda alucina em conversa longa). `qwen3.5:0.8b` foi **reprovado e removido** num PC de 3,9 GB (lento + alucina). Qwen Coder para programacao.

**DeepSeek direto (implementado em 2026-06-28):**
- Hoje da pra usar DeepSeek **direto** como provedor `deepseek` (`api_compatible=openai`, `https://api.deepseek.com`) ou **indireto via OpenRouter**.
- A chave e sempre por usuario no fluxo existente de provedores; nunca hardcoded. O teste usa o ramo OpenAI-compativel de `mke_preferences_api_provider_test`.

**Limite honesto:** nada disso e fine-tuning dos pesos. Para conversa ampla de alta qualidade num PC fraco, a arquitetura encaminha a tarefa a um PC melhor da rede ou a um provedor de nuvem autorizado.

---

## 5. Esclarecimentos importantes (para nao se repetir)

- **`ollama launch claude` / `codex-app` / `hermes` / `openclaw` / `opencode` / `codex` / `copilot` / `droid` / `pi` sao agentes externos opcionais.** A Mike nao embute nem controla esses produtos como componentes proprios, mas agora a UI de Conectores/Terminal os mapeia como "especialistas convidados": preparar dependencia, abrir no terminal interno e enviar contexto do Programar quando o usuario permitir. Antes de abrir, a Mike verifica `ollama.exe`, tenta instalar/reparar se faltar ou estiver incompleto, inicia a API local e mostra o comando final. Regras: opt-in, login/chave do proprio usuario, projeto confiavel, sem segredo salvo automaticamente e sem acao destrutiva sem confirmacao.
- A intencao de "ter um agente de codigo local" continua coberta pelo `code_agent`/Programar da Mike; os agentes do marketplace entram como apoio extra quando fizer sentido.
- **Direcao de produto aprovada pelo dono:** motores e ferramentas externas devem virar **bracos internos da Mike Local**. O usuario nao deve precisar abrir ComfyUI/A1111/Forge/Fooocus/InvokeAI/Codex/Claude etc. como programas separados no fluxo normal; a Mike deve instalar, ligar, testar, mandar tarefa, acompanhar progresso, pegar resultado, salvar no projeto e mostrar tudo dentro da propria interface. O nome/credito/licenca da ferramenta continua visivel em algum lugar para nao parecer copia nem esconder origem, mas a experiencia principal e "fazer pela Mike".

### 5.1 Contrato de integracao total de ferramentas/motores

Estado alvo para cada motor/ferramenta integrada:

1. **Instalar:** botao facil dentro da Mike, com progresso, logs e reparo automatico.
2. **Detectar hardware:** GPU/VRAM/RAM/pagefile/backend corretos sem o usuario escolher.
3. **Ligar:** start/stop/restart pela Mike, sem janela tecnica obrigatoria.
4. **Testar:** health-check e diagnostico claro quando porta/modelo/checkpoint falhar.
5. **Usar por API/wrapper:** a Mike envia tarefas e recebe resultado sem o usuario abrir a UI original.
6. **Ver dentro da Mike:** resultado, galeria, fila, logs e erros aparecem na propria conversa/aba.
7. **Salvar no projeto/memoria:** outputs entram em galeria, pasta autorizada, memoria e historico.
8. **CrÃ©dito preservado:** nome da ferramenta aparece em "Motor usado", Sobre/Logs/Licencas.
9. **Fallback automatico:** se um motor falhar, a Mike tenta outro motor local/rede autorizado.
10. **Sem promessa falsa:** enquanto algum motor so tiver instalacao guiada, a UI deve dizer isso.

Mapa de integracao por motor/ferramenta:

| Motor/ferramenta | Papel dentro da Mike | Estado atual | Proximo fechamento |
|---|---|---:|---|
| ComfyUI | Motor principal de imagem/workflows/nodes | ðŸŸ¡ API, install/start/reparo, fila e galeria ja integrados | esconder fluxo tecnico, ampliar edicao/upscale/ControlNet/LoRA dentro da Mike |
| AUTOMATIC1111 / SD WebUI | Motor compatibilidade txt2img/img2img/inpaint | ðŸŸ¡ catalogado, health-check, API A1111, botao instalar/ligar via Forge/A1111; botao "Preparar imagem completa" inclui Forge/A1111 | launcher dedicado, selecao de modelo e galeria interna |
| Stable Diffusion WebUI Forge | Motor otimizado para pouca VRAM | ðŸŸ¡ catalogado, health-check, install via motores secundarios, start inicial; instalado junto no preparo completo de imagem | API completa + reparo/checkpoint/lowvram igual ComfyUI |
| Fooocus | Modo facil para imagens bonitas | ðŸŸ¡ catalogado, preparo automatico de fonte/UI local, teste e abrir interno | wrapper de geracao/galeria dentro da Mike |
| InvokeAI | UI criativa/organizada para imagem | â¬œ catalogado/teste/abrir | criar instalador e wrapper/API local dentro da Mike |
| Codex / Claude / OpenCode etc. | Especialistas de programacao | ðŸŸ¡ terminal interno + botoes `ollama launch`; preparo automatico de Ollama; Codex oficial tem ponte propria | unificar como "equipe Programar", com estado, permissao, saida e arquivos alterados dentro da Mike |
| PowerShell/CMD real | Terminal interno da Mike | âœ… ConPTY nativo quando disponivel, fallback por pipe, botoes admin/UAC e reinicio da Mike como admin | melhorar experiencia de teclas especiais/tela cheia/xterm visual, mas o backend real ja esta entregue |

### 5.2 Como "virar braco interno" funciona na pratica

Quando o dono diz que uma ferramenta deve virar "braco da Mike", isso **nao** significa copiar a ferramenta nem esconder autoria. Significa que a Mike vira a **interface principal** e usa a ferramenta por baixo. O usuario fica dentro da Mike, e a Mike decide se precisa abrir painel interno, chamar API local, iniciar processo, ler fila, salvar arquivo ou mostrar erro.

Existem tres modos de integracao:

1. **Painel interno / navegador embutido**
   - A Mike mostra a UI local da ferramenta dentro dela, como se fosse um navegador interno.
   - Exemplo: ComfyUI em `http://127.0.0.1:8188`, A1111/Forge em `http://127.0.0.1:7860`, Fooocus em `http://127.0.0.1:7865`, InvokeAI em `http://127.0.0.1:9090`.
   - Isso e local, roda no PC do usuario, e nao exige API paga por si so.
   - Limite: algumas interfaces podem bloquear iframe ou precisar de ajustes/proxy local. Se bloquear, a Mike deve criar wrapper proprio ou abrir em uma aba/janela, mas o objetivo final e manter dentro da Mike.

2. **API local / wrapper interno**
   - A Mike nao mostra necessariamente a UI original; ela chama o motor por HTTP local ou processo local.
   - Exemplo: usuario pede "paisagem" no chat; a Mike chama a API do ComfyUI/A1111/Forge, acompanha progresso e mostra a imagem pronta na conversa/galeria.
   - Esse e o melhor modo para experiencia "100% Mike", porque o usuario nao precisa aprender a ferramenta original.
   - Continua sendo local e gratis, exceto energia/tempo/espaco do proprio PC.

3. **API externa paga/opcional**
   - Usada somente se o usuario configurar chave/login e autorizar.
   - Exemplo: OpenAI/Codex/Claude/DeepSeek/OpenRouter/cloud image/video.
   - Nunca deve ser padrao silencioso. A politica e local-first/offline-first: primeiro motor local, depois PC forte da rede privada, depois nuvem paga apenas com opt-in.

Regras fixas:

- **Local por padrao:** ComfyUI, Forge, A1111, Fooocus e InvokeAI devem rodar no computador ou em outro PC da rede do dono quando possivel.
- **Sem API paga obrigatoria:** gerar imagem local nao deve depender de OpenAI, Stability, Midjourney, OpenRouter etc.
- **GPU forte manda na rede:** se o PC atual for fraco/celular, a Mike pode mandar o job para o PC com GPU pela rede privada.
- **Nome da ferramenta aparece:** "Motor usado: ComfyUI", "Motor usado: Forge", etc., com link/licenca em Sobre/Logs/Config.
- **Mike controla o fluxo:** instalar, ligar, testar, prompt, progresso, resultado, galeria, salvar no projeto e diagnostico de erro ficam na Mike.
- **UI original vira opcional:** a tela original da ferramenta fica disponivel para modo avancado, mas nao deve ser obrigatoria para o uso normal.
- **Pago so com consentimento:** qualquer chamada externa paga precisa indicar provedor, chave/conta usada e risco de custo.
- **Terminal real dentro da Mike:** PowerShell e CMD rodam dentro do painel Terminal da Mike usando ConPTY nativo do Windows quando a captura funciona; se o Windows/harness impedir captura, a Mike cai para pipe em vez de deixar a tela vazia. Para admin embutido, a Mike precisa ser reiniciada como admin via UAC; para acao imediata existem botoes `CMD admin` e `PowerShell admin` que abrem shell elevado externo.

Resposta curta para o dono:

- Sim, elas podem abrir internamente como se estivessem no navegador, quando a UI permitir.
- Sim, voce podera usar localmente, sem API paga, desde que o PC tenha espaco/modelos/GPU ou a rede tenha um worker com GPU.
- Nao, nao e para depender so de APIs pagas. APIs pagas entram como acelerador/fallback opcional.
- O alvo final e: o usuario pede na Mike; a Mike usa o motor correto por baixo; o resultado aparece na Mike.

---

## 6. Problemas conhecidos / dividas tecnicas (consolidado)

**Mike Local:**
- âœ… Readiness recuperado para `18/18` (2026-06-28). Causa da regressao: perfil de missao era zerado em turnos sem palavras-chave e corpus/ferramentas caia em AirLLM; corrigido no core. Hash atual do core: `DF38115EACFDC10D7B867C11EA85B5C9A932233BAC41E609C45F7EE53875778B`.
- Modelo base ainda e fraco para conversa ampla fora das rotas rapidas; falta sync automatico de skills entre PCs; falta observabilidade da memoria.

**Atendimento:**
- ðŸŸ¡ **P1 corrigido no codigo (2026-06-28)**: robo nao deve reaquecer apos recusa explicita; implementado classificador de recusa/pausa + estado por conversa + teste automatizado. Falta deploy/migration em producao.
- Falta publicacao/gestao manual de posts sociais; confirmar escopos Meta em campo.

**Site PHP â€” seguranca (de [BUGS_REPORT.md](BUGS_REPORT.md)):**
- âœ… `APP_DEBUG=false` no `.env` (corrigido em 2026-06-28).
- ðŸŸ¡ Endpoints `read_log`/`read_file`/`save_file` em `admin/painel_supremo.php` e `admin/ecossistema.php`: hardening aplicado em 2026-06-28 (super-admin, `realpath()`, negar `..`, CSRF, auditoria). Falta revisar demais endpoints/admins fora desse escopo.
- `catch` vazios em varios arquivos; `display_errors` em scripts de diagnostico; `die()` com mensagens diretas; respostas de API inconsistentes.

**Risk Radar P0 ([minike-risk-radar-latest.md](docs/execucao-minike/relatorios/minike-risk-radar-latest.md)):**
1. `tools_may_not_work` â€” ferramentas (PDF/OCR/imagem/midia) podem estar quebradas â†’ QA automatico + semaforo por ferramenta.
2. `studio_confusing_flow` â€” fluxo do gerador confunde â†’ abrir canvas direto, Mike como ajuda lateral.
3. `mike_single_turn_limit` â€” uma resposta nao resolve projeto longo â†’ `agent_runs` persistente com plano/etapas/QA.
4. `local_memory_rag_cost` â€” RAG pode estourar RAM/misturar dados â†’ `MemoryVectorAdapter` com escopos + benchmark (Qdrant Edge/LanceDB/Chroma/TurboVec).
- P1: `asset_rights_and_terms` â€” direitos de imagens externas â†’ preferir fonte do cliente + registrar origem.

---

## 7. Norte do projeto (de [META_CENTRAL_PROJETO.md](docs/execucao-minike/META_CENTRAL_PROJETO.md))

Prioridade fixa quando houver duvida: **(1)** estabilizar a Mike Local â†’ **(2)** memoria/RAG â†’ **(3)** conhecimento util (atendimento/ensino/programacao) â†’ **(4)** integrar ferramentas/APIs â†’ **(5)** distribuir carga entre PCs com seguranca. Toda melhoria nova precisa ajudar atendimento, ensino, programacao, memoria/contexto, distribuicao OU virar produto vendavel â€” senao nao e prioridade agora.

**Regras de ouro/seguranca:** nunca gravar senhas reais em arquivo/memoria; nao depender de uma unica maquina; tudo importante salvo em arquivo na pasta do projeto; Mike oficial multicanal so o super admin principal (`user_id = 1`); reusar `channels` existentes.

---

## 8. Proximos passos priorizados (recomendacao)

1. **[CONCLUIDO 2026-06-28] Adicionar DeepSeek como provedor direto** â€” catalogo e teste OpenAI-compativel adicionados; falta apenas chave real do usuario para teste autorizado.
2. **[CONCLUIDO NO CODIGO 2026-06-28] Corrigir o P1 do atendimento** â€” gate unico respeita recusa; falta deploy/migration em producao.
3. **[CONCLUIDO 2026-06-28] Re-rodar o readiness** â€” regressao 8â†’18 corrigida; relatorio atual `18/18`.
4. **[CONCLUIDO NO ESCOPO 2026-06-28] Hardening de seguranca PHP** â€” `APP_DEBUG=false` + protecao de `read_file/save_file/read_log/clear_log` nos admins citados.
5. **[CONCLUIDO NO CODIGO 2026-06-30] Impressao automatica loja195** â€” `printService.js` + rotas `/api/print/*` + `/integrations/print/send` no Mike Local. Config interna `loja195_mike_config.php` na rede local. Falta integracao no site loja195 e deploy do atendimento.
6. **[CONCLUIDO 2026-06-30] Fix LAN sync + rota /uploads*** â€” Add-Member corrigido no loop de assignments; imagens geradas pelo ComfyUI agora servidas via `/uploads/*` sem token. Mike Local v2.16.3-minike em producao.
7. **QA das ferramentas** (P0 do risk radar) com semaforo por ferramenta.
8. **Deploy Hostinger** â€” subir PS1 atualizado (v2.16.3) + hashes + atendimento zip. Proximo passo imediato.
9. **Tela visual do super admin** para Mike oficial por empresa.

---

## 9. Documentos unificados/substituidos por este topo

Estes arquivos tentavam ser "mestre/unificado" e agora estao **subordinados** a esta secao (mantidos como historico, nao apagar):
- [docs/MINIKE_BASE_TRABALHO_UNIFICADA_2026-06-18.md](docs/MINIKE_BASE_TRABALHO_UNIFICADA_2026-06-18.md) â€” base de trabalho anterior (18/06).
- [atendimento/DOCUMENTACAO_UNIFICADA_MINIKE.md](atendimento/DOCUMENTACAO_UNIFICADA_MINIKE.md) â€” unificada do atendimento (detalhe operacional do modulo).
- Todo o conteudo cronologico **abaixo** desta secao (changelogs "Mike Local 2.x", "Fonte: ...md" absorvidas) = historico.

---

## 10. Indice mestre de TODA a documentacao (casamento das docs soltas)

> Tag: **[CANON]** consultar para trabalhar hoje Â· **[HIST]** historico/relatorio datado Â· **[REF]** referencia/estudo externo.

### 10.1 Estado, metas e execucao (`docs/execucao-minike/`)
- [CANON] **Guias fiscais oficiais — VERSOES FINAIS na pasta `documentação/` (a frente PDV/fiscal segue os DOIS — ver regras na secao (D) de 1.5):**
  [GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CLAUDE_2026-07-09.pdf](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CLAUDE_2026-07-09.pdf) ([HTML](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CLAUDE_2026-07-09.html)) — nacional: custos, rotas baratas, plano A/B/C do motor, 27 UFs, concorrencia e migracao a 50% ·
  [GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CODEX_FINAL_2026-07-09.pdf](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CODEX_FINAL_2026-07-09.pdf) ([HTML](documentação/GUIA_FISCAL_NACIONAL_MINIKE_VERSAO_CODEX_FINAL_2026-07-09.html)) — SC: credenciamento PAF/SEF, OTH/LCL, matriz DLL/API/PAF parceiro (versao de trabalho historica em docs/execucao-minike/GUIA_CREDENCIAMENTO_*; so o Codex edita).
- [CANON] [HANDOFF_SESSAO_2026-07-08_PDV_FISCAL_ERP.md](docs/execucao-minike/HANDOFF_SESSAO_2026-07-08_PDV_FISCAL_ERP.md) · [META_PDV_LOCAL_ERP_FISCAL_2026-07-08.md](docs/execucao-minike/META_PDV_LOCAL_ERP_FISCAL_2026-07-08.md) — rodada PDV/fiscal/ERP e decisoes (plano A/B/C do motor, OTH, Spedy de lado).
- [CANON] [PRECADASTRO_FISCAL_AUTOMATICO_2026-07-09.md](docs/execucao-minike/PRECADASTRO_FISCAL_AUTOMATICO_2026-07-09.md) — cascata EAN->NCM/CEST/impostos/foto, perfis por grupo, botao "Arrumar tudo" com IA em lote, IBPT/Siscomex/Cosmos, regra de nao-responsabilidade fiscal.
- [CANON] [ESTADO_IMPLEMENTACAO_ATUAL.md](docs/execucao-minike/ESTADO_IMPLEMENTACAO_ATUAL.md) â€” estado da Mike Local por frente (com "falta").
- [CANON] [META_CENTRAL_PROJETO.md](docs/execucao-minike/META_CENTRAL_PROJETO.md) â€” norte e prioridades.
- [CANON] [HANDOFF_SESSAO_2026-06-25.md](docs/execucao-minike/HANDOFF_SESSAO_2026-06-25.md) â€” armadilhas + o que foi deployado.
- [CANON] [BACKLOG_EXECUTAVEL.md](docs/execucao-minike/BACKLOG_EXECUTAVEL.md) â€” backlog acionavel.
- [HIST] [DIARIO_EXECUCAO.md](docs/execucao-minike/DIARIO_EXECUCAO.md) â€” diario cronologico.
- [CANON] [ARQUITETURA_DISTRIBUIDA_MIKE.md](docs/execucao-minike/ARQUITETURA_DISTRIBUIDA_MIKE.md) Â· [ARQUITETURA_DOMINIOS_MINIKE.md](docs/execucao-minike/ARQUITETURA_DOMINIOS_MINIKE.md) Â· [CLUSTER_MODES_MIKE.md](docs/execucao-minike/CLUSTER_MODES_MIKE.md) â€” arquitetura e cluster.
- [CANON] [META_LLM_MIKE.md](docs/execucao-minike/META_LLM_MIKE.md) Â· [PLANO_MULTIAGENTE.md](docs/execucao-minike/PLANO_MULTIAGENTE.md) Â· [MATRIZ_INGESTAO_MIKE_LOCAL.md](docs/execucao-minike/MATRIZ_INGESTAO_MIKE_LOCAL.md) â€” LLM, multiagente, ingestao.
- [CANON] [MIKE_OFICIAL_EMPRESAS.md](docs/execucao-minike/MIKE_OFICIAL_EMPRESAS.md) â€” Mike oficial por empresa.
- [CANON] [INSTALADOR_UNIVERSAL_MIKE_LOCAL.md](docs/execucao-minike/INSTALADOR_UNIVERSAL_MIKE_LOCAL.md) Â· [INSTALADOR_MIKE_LOCAL.md](docs/execucao-minike/INSTALADOR_MIKE_LOCAL.md) â€” instalador.
- [CANON] [LABORATORIO_MIKE_LOCAL.md](docs/execucao-minike/LABORATORIO_MIKE_LOCAL.md) Â· [METAS_AGENTES_MIKE_LOCAL.md](docs/execucao-minike/METAS_AGENTES_MIKE_LOCAL.md) â€” lab e agentes da Mike.
- [CANON] [ECOSSISTEMA_CONTEUDO_SITE.md](docs/execucao-minike/ECOSSISTEMA_CONTEUDO_SITE.md) Â· [LACUNAS_CONTEUDO_E_SITES.md](docs/execucao-minike/LACUNAS_CONTEUDO_E_SITES.md) â€” conteudo/subsites.
- [CANON] [TRILHA_API_INTEGRACOES_MINIKE.md](docs/execucao-minike/TRILHA_API_INTEGRACOES_MINIKE.md) â€” trilha/lab de API.
- [CANON] [GERADOR_MINIKE_STUDIO.md](docs/execucao-minike/GERADOR_MINIKE_STUDIO.md) Â· [GERADOR_MOTORES_IMAGEM_LOCAL.md](docs/execucao-minike/GERADOR_MOTORES_IMAGEM_LOCAL.md) Â· [GERADOR_STUDIO_STATUS.md](docs/execucao-minike/GERADOR_STUDIO_STATUS.md) Â· [PLANO_ACAO_MINIKE_STUDIO.md](docs/execucao-minike/PLANO_ACAO_MINIKE_STUDIO.md) â€” gerador/Studio.
- [CANON] [MODELOS_IMAGEM_VIDEO_MIKE_2026-06-22.md](docs/execucao-minike/MODELOS_IMAGEM_VIDEO_MIKE_2026-06-22.md) Â· [MOTORES_SECUNDARIOS_MIKE_2026-06-22.md](docs/execucao-minike/MOTORES_SECUNDARIOS_MIKE_2026-06-22.md) Â· [TURBOVEC_TURBOQUANT_MIKE_LOCAL.md](docs/execucao-minike/TURBOVEC_TURBOQUANT_MIKE_LOCAL.md) â€” motores/quantizacao.
- [CANON] [PRESETS_MIKE_REAPROVEITAVEIS.md](docs/execucao-minike/PRESETS_MIKE_REAPROVEITAVEIS.md) Â· [EDITOR_TOOL_STATUS.md](docs/execucao-minike/EDITOR_TOOL_STATUS.md) Â· [IDEIAS_E_RISCOS.md](docs/execucao-minike/IDEIAS_E_RISCOS.md) â€” presets, editor, ideias.
- [CANON] Redes/operacao multi-PC: [REDE_WINDOWS_CASA_LOJA_MIKE.md](docs/execucao-minike/REDE_WINDOWS_CASA_LOJA_MIKE.md) Â· [CAIXA_POSTAL_2PCS_MIKE_LOCAL.md](docs/execucao-minike/CAIXA_POSTAL_2PCS_MIKE_LOCAL.md) Â· [PLANO_OPERACAO_4PCS_MIKE_2026-06-19.md](docs/execucao-minike/PLANO_OPERACAO_4PCS_MIKE_2026-06-19.md) Â· [PROMPTS_OPERACIONAIS_4PCS_MIKE_2026-06-19.md](docs/execucao-minike/PROMPTS_OPERACIONAIS_4PCS_MIKE_2026-06-19.md) Â· [PROTOCOLO_TURNO_CONTINUO_2PCS_MIKE_LOCAL_2026-06-19.md](docs/execucao-minike/PROTOCOLO_TURNO_CONTINUO_2PCS_MIKE_LOCAL_2026-06-19.md).
- [HIST] Relatorios datados: [ANALISE_SEGURANCA_QUALIDADE_2026-06-22.md](docs/execucao-minike/ANALISE_SEGURANCA_QUALIDADE_2026-06-22.md) Â· [AUDITORIA_IMAGEM_MODELOS_2026-06-24.md](docs/execucao-minike/AUDITORIA_IMAGEM_MODELOS_2026-06-24.md) Â· [HANDOFF_AIRLLM_REDE_DISTRIBUIDA_2026-06-22.md](docs/execucao-minike/HANDOFF_AIRLLM_REDE_DISTRIBUIDA_2026-06-22.md) Â· [HARDENING_GUARD_EVIDENCIA_2026-06-20.md](docs/execucao-minike/HARDENING_GUARD_EVIDENCIA_2026-06-20.md) Â· [TRANSCRICAO_LOCAL_MIKE_2026-06-22.md](docs/execucao-minike/TRANSCRICAO_LOCAL_MIKE_2026-06-22.md) Â· [MAPA_PROBLEMAS_SOLUCOES_INOVACOES_2026-06-19.md](docs/execucao-minike/MAPA_PROBLEMAS_SOLUCOES_INOVACOES_2026-06-19.md) Â· [META_OPERACIONAL_2026-06-19.md](docs/execucao-minike/META_OPERACIONAL_2026-06-19.md) Â· e os varios `RELATORIO_*_2026-06-19.md` / `RODADA_PRODUCAO_*`.
- [HIST] Relatorios vivos: [relatorios/mike-local-readiness-latest.md](docs/execucao-minike/relatorios/mike-local-readiness-latest.md) Â· [relatorios/minike-risk-radar-latest.md](docs/execucao-minike/relatorios/minike-risk-radar-latest.md) Â· [relatorios/conteudo-sites-prioridades-latest.md](docs/execucao-minike/relatorios/conteudo-sites-prioridades-latest.md).

- [CANON] [IMPLEMENTADO_2026-07-02.md](docs/execucao-minike/IMPLEMENTADO_2026-07-02.md) — log completo 2026-07-02: /search/web, /reports/generate, /video/download, emailService (Brevo/SendGrid), reviewRequestService, birthdayService, monitoringService, painel integracoes super admin, campanhas sociais. Pendencias do Felipe: Meta App Review, TikTok, Google Cloud, Brevo, deploy atendimento.
- [CANON] [ROADMAP_INTEGRACAO_SOCIAL_2026.md](docs/execucao-minike/ROADMAP_INTEGRACAO_SOCIAL_2026.md) — plano completo automacao social: WhatsApp campanhas, Instagram/Facebook/TikTok posts automaticos, Google Meu Negocio, clima+datas+produtos, campanhas pagas, o que precisa de licenca.
- [CANON] [ROADMAP_MIKE_LOCAL_2026.md](docs/execucao-minike/ROADMAP_MIKE_LOCAL_2026.md) — plano de melhorias e novas funcoes do Mike Local (browser automatico, agentes, ferramentas GitHub, custo zero).

### 10.2 Redesign visual / chat-first (`docs/execucao-minike/redesign-chat-first/`)
- [CANON] [README.md](docs/execucao-minike/redesign-chat-first/README.md) + docs `01-visao-geral` â†’ `06-plano-de-implementacao` (inclui [05-animacoes-loading-update.md](docs/execucao-minike/redesign-chat-first/docs/05-animacoes-loading-update.md) para o "visual vivo/animado").
- [CANON] [PLANO_REDENSENHO_VISUAL_CHAT_FIRST_2026-06-22.md](docs/execucao-minike/PLANO_REDENSENHO_VISUAL_CHAT_FIRST_2026-06-22.md).

### 10.3 Atendimento (`atendimento/`)
- [CANON] [docs/MAPA_TECNICO_E_PROGRESSO_ATENDIMENTO.md](atendimento/docs/MAPA_TECNICO_E_PROGRESSO_ATENDIMENTO.md) â€” mapa tecnico vivo do modulo.
- [CANON] [docs/PENDENCIAS_ATENDIMENTO.md](atendimento/docs/PENDENCIAS_ATENDIMENTO.md) â€” bugs/pendencias (P1 do robo).
- [CANON] [docs/RUNBOOK_ENVIO_CLIENTES_CAMINHO_CRITICO.md](atendimento/docs/RUNBOOK_ENVIO_CLIENTES_CAMINHO_CRITICO.md) Â· [docs/PRODUTO_DISPARO_EM_MASSA_SPEC.md](atendimento/docs/PRODUTO_DISPARO_EM_MASSA_SPEC.md) Â· [docs/GUIA_INTEGRACOES_FUTURAS_GOOGLE_TIKTOK_X.md](atendimento/docs/GUIA_INTEGRACOES_FUTURAS_GOOGLE_TIKTOK_X.md) Â· [docs/IDEIAS_IA_AUTOMACAO_ECOSSISTEMA.md](atendimento/docs/IDEIAS_IA_AUTOMACAO_ECOSSISTEMA.md).
- [HIST] `atendimento/docs/AUDIT_*_2026-06-1x.md` â€” auditorias datadas.
- [REF] `atendimento/DOCUMENTACAO_API_FOTOS.md` Â· `DOCUMENTACAO_API_INTEGRACOES.md` Â· `DOCUMENTACAO_EXTRACAO_PRODUTOS.md` (duplicadas na raiz â€” ver 10.6).

### 10.4 Catalogo de IA e reuso (`docs/`, `docs/inventario-reuso/`)
- [CANON] [IA_MODELS_CATALOG.md](docs/IA_MODELS_CATALOG.md) Â· [IA_RUNTIMES_QUANT.md](docs/IA_RUNTIMES_QUANT.md) Â· [IA_CLOUD_FALLBACK.md](docs/IA_CLOUD_FALLBACK.md) Â· [IA_INTEGRACAO_MINIKE.md](docs/IA_INTEGRACAO_MINIKE.md) Â· [IA_LINKS.md](docs/IA_LINKS.md) â€” modelos, runtimes, fallback de nuvem.
- [CANON] [EXECUTIVO_RECOMENDACOES.md](docs/EXECUTIVO_RECOMENDACOES.md) Â· [MINIKE_VISAO_IDEIAS_PRIORIDADES_2026-06-18.md](docs/MINIKE_VISAO_IDEIAS_PRIORIDADES_2026-06-18.md).
- [REF] [inventario-reuso/MATRIZ_REUSO_FONTE_DE_DADOS_E_REPOS.md](docs/inventario-reuso/MATRIZ_REUSO_FONTE_DE_DADOS_E_REPOS.md) Â· [RESUMO_REUSO_PROJETOS_EXTERNOS.md](docs/inventario-reuso/RESUMO_REUSO_PROJETOS_EXTERNOS.md) Â· [TABELA_MESTRA_REFERENCIAS_EXTERNAS.md](docs/inventario-reuso/TABELA_MESTRA_REFERENCIAS_EXTERNAS.md) + `estudos-externos/01..16` (estudos de repos externos).

### 10.5 Organizacao, deploy e regras (`ORGANIZACAO_PROJETO/`, raiz)
- [CANON] [ORGANIZACAO_PROJETO/README.md](ORGANIZACAO_PROJETO/README.md) Â· [ORGANIZACAO_PROJETO/REGRAS_DEPLOY.md](ORGANIZACAO_PROJETO/REGRAS_DEPLOY.md) Â· [PLANO_AGENTES_MIKE_LOCAL_2026-06-20.md](ORGANIZACAO_PROJETO/PLANO_AGENTES_MIKE_LOCAL_2026-06-20.md).
- [HIST] `ORGANIZACAO_PROJETO/RELATORIO_*_2026-06-20.md` (limpeza, escolar/autoupdate, instalador multimidia).
- [CANON] [AGENTS.md](AGENTS.md) Â· [CLAUDE.md](CLAUDE.md) â€” instrucoes para agentes.

### 10.6 Raiz â€” bugs, APIs e changelogs
- [CANON] [BUGS_REPORT.md](BUGS_REPORT.md) (+ variantes `BUGS_REPORT_DETAILED.md`, `BUGS_CATCHES_DETAILED.md`, `BUGS_CATCHES_DETAILS.md`, `BUGS_SCAN_SUMMARIES.md` â€” consolidar no futuro).
- [REF] [DOCUMENTACAO_API_FOTOS.md](DOCUMENTACAO_API_FOTOS.md) Â· [DOCUMENTACAO_API_INTEGRACOES.md](DOCUMENTACAO_API_INTEGRACOES.md) Â· [DOCUMENTACAO_EXTRACAO_PRODUTOS.md](DOCUMENTACAO_EXTRACAO_PRODUTOS.md) Â· [geraÃ§ao imagem documentaÃ§Ã£o.md](geraÃ§ao%20imagem%20documentaÃ§Ã£o.md) (existem copias em `atendimento/` â€” manter UMA fonte).
- [HIST] [CHANGELOG_2026-06-22.md](CHANGELOG_2026-06-22.md) Â· [CHANGELOG_2026-06-23.md](CHANGELOG_2026-06-23.md) Â· [CHANGELOG_2026-06-23-hub.md](CHANGELOG_2026-06-23-hub.md) Â· [CHANGELOG_2026-06-23-cluster.md](CHANGELOG_2026-06-23-cluster.md).
- [REF] [crypto/DOCUMENTACAO_MINIKE_COIN.md](crypto/DOCUMENTACAO_MINIKE_COIN.md) Â· `community-skills/**/SKILL.md` (skills publicadas) Â· `softwares/editor/SKILL.md`.

### 10.7 Duplicatas a resolver (limpeza futura, nao urgente)
- `DOCUMENTACAO_API_FOTOS.md`, `DOCUMENTACAO_API_INTEGRACOES.md`, `DOCUMENTACAO_EXTRACAO_PRODUTOS.md` e `geraÃ§ao imagem documentaÃ§Ã£o.md` existem **na raiz E em `atendimento/`** â€” escolher uma fonte e apontar a outra.
- Familia `BUGS_*` (5 arquivos) â€” consolidar num so.
- Tres docs "unificada/base" (secao 9) â€” ja subordinados a este topo.

---

## 11. PLAYBOOK DETALHADO â€” pronto (e como melhorar) + falta (e como fazer)

> Objetivo desta secao: **outra IA chega aqui e ja sabe onde mexer, sem re-explorar o repo (economiza tokens).**
> Cada item traz: **arquivos exatos**, **o que ja funciona**, **como melhorar** e/ou **o que falta + passo a passo**.
> Convencao de validacao: PS1 â†’ `ParseInput` (arquivo inteiro + corpo do agente isolado, 0 erros) e regenerar hash; PHP â†’ `php -l` quando houver binario; Node â†’ `node --check`.

### 11.1 Mike Local â€” runtime/chat (ðŸŸ¡ pronto, melhoravel)
**Arquivos:** [local-ai/mike-local-ai-minike.ps1](local-ai/mike-local-ai-minike.ps1) (monstro: instalador + agente em here-string), [local-ai/mike-ui.html](local-ai/mike-ui.html) (UI externa), `local-ai/mike-fast-local*` (rotas locais), `local-ai/mike-local-readiness-tests.json`, `local-ai/test-mike-local-readiness.ps1`.
**Ja funciona:** servidor local com rotas de chat; `mike-fast-local` responde bem em atendimento de troca, receita, ensino-API, diagnostico de programacao; recuperacao de corpus treinado antes do prompt; 2a tentativa quando foge do assunto; concierge do ecossistema no payload do chat.
**Como melhorar (concreto):**
1. **Reduzir alucinacao na conversa longa:** hoje quando cai no `gemma3:4b` ele inventa fato (ver readiness etapas 2-10). Acao: para intents `attendance_*` e fluxos multi-turno, **forcar a rota fundamentada (`mike-fast-local`/corpus) e so usar a LLM crua como ultimo recurso**, e quando usar, injetar guarda "nao invente prazo/status; se nao souber, diga que vai confirmar". Local: a montagem de prompt/decisao de rota dentro do agente (procurar `mike-fast-local`, `topic_drift`, `trained_knowledge_hits` na here-string).
2. **[IMPLEMENTADO 2026-07-05] Encaminhar para nuvem quando `hardware == muito fraco`.** Criadas `Invoke-CloudChatCompletion` e `Invoke-CloudChatFallback` (perto de `Invoke-UniversalChatDelegation`, ~12862). Fluxo: se `Invoke-UniversalChatDelegation` nao usou nenhum worker LAN **e** RAM local < 8GB sem GPU **e** o usuario ja configurou e permitiu cloud (`can_auto_route` de `Get-AdaptiveAiRoutingPolicy`, opt-in/desligado por padrao), a Mike chama o primeiro conector cloud habilitado (GroqCloud/OpenRouter/Together AI, endpoints `.../chat/completions` derivados do endpoint de `models` ja cadastrado) e usa a resposta como reforco de contexto para o modelo local finalizar — mesmo padrao ja usado pela delegacao de rede, nao substitui a resposta local nem quebra quem nao configurou cloud. **Ainda falta validar em hardware fraco real** (so foi validado por parser de sintaxe + predeploy nesta sessao, nao testado ao vivo com RAM<8GB e conector cloud de verdade configurado).
3. **[CONCLUIDO 2026-06-28] DeepSeek direto** como provedor (ver 11.4) para ter um fallback de qualidade barato.
**Validar:** `local-ai/test-mike-local-readiness.ps1` na porta ativa; meta = voltar de 8/18 para â‰¥16/18.

### 11.2 Mike Local â€” memoria / RAG (ðŸŸ¡ pronto, melhoravel)
**Arquivos:** `atendimento/src/services/minikeMemoryService.js`, `atendimento/migrations/029_minike_memory.sql` (tabelas `ai_contact_memory`/`_items`), `atendimento/src/services/personalizedAiSchemaService.js`, integracao no worker em `atendimento/index.js`.
**Ja funciona:** leitura de memoria no contexto, rebuild sob demanda, fila + worker `memory_refresh`, hooks ligados em envio humano/WhatsApp Web/webhook.
**Falta + como fazer:**
1. **[CONCLUIDO 2026-07-04, card 2026-07-05] Observabilidade:** endpoint real e `GET /api/master/memory/queue-status` (rota registrada em `superAdmin.js`, mas o router e montado com prefixo `/api/master` em `atendimento/index.js:679` — corrigido aqui o caminho errado registrado antes), consumindo `getQueueHealth()` em `minikeMemoryService.js` — retorna pending/processing/failed, idade do job pendente mais antigo, `worker_running` e `healthy`. Card visual adicionado em `atendimento/public/master.html` (`loadMemoryQueueHealth()`), nao em `dashboard.html` (esse painel e outro, de empresa, nao de super-admin).
2. **[CONCLUIDO 2026-07-05] Cobertura total de escrita:** auditado por grep de `INSERT INTO messages` em `src/controllers` e `src/services`; adicionado `queueMemoryRefreshSafe(companyId, contactId)` (mesmo padrao defensivo de `messageController.js`) em 44 pontos de insercao across `campaignController.js`, `personalizedAiController.js`, `pollController.js`, `scheduledMessageController.js`, `routes/api.js`, `routes/webhook.js` (23 pontos — o maior, cobre WhatsApp oficial/Instagram/Messenger/Chatwoot/Telegram/ManyChat/Loja195/flows), `conversationService.js`, `morningGreetingService.js`, `reheatingService.js`, `scheduledFlowRunnerService.js`, `whatsappWebService.js`. Deployado e verificado (boot limpo, `stderr.log` vazio).
3. **[Investigado 2026-07-05, decidido nao construir especulativo] Escopos `usuario/projeto/empresa/dispositivo`:** `dispositivo` ja esta coberto na pratica — `contacts` nao tem `UNIQUE(company_id, phone)`, entao cada inbox/canal gera sua propria linha de contato e `ai_contact_memory` (chave `company_id`+`contact_id`) ja fica implicitamente por dispositivo/canal via essa relacao. `usuario` (qual atendente) e `projeto` nao tem nenhum conceito equivalente hoje no schema do atendimento — criar colunas para eles agora seria especular sobre um requisito de produto que ainda nao foi definido (o que conta como "projeto" aqui?). Recomendacao: so implementar quando houver um caso de uso concreto que precise filtrar memoria por agente ou por projeto.
4. **Backend vetorial leve — avaliado 2026-07-05, recomendacao: nao construir ainda.** O TurboVec ja esta implementado e ativo do lado do **Mike Local** (`local-ai/turbovec-memory-bridge.py`, ver [TURBOVEC_TURBOQUANT_MIKE_LOCAL.md](docs/execucao-minike/TURBOVEC_TURBOQUANT_MIKE_LOCAL.md)) para busca semantica no cofre de notas locais — isso e um sistema de memoria diferente do `ai_contact_memory` do atendimento. Para o atendimento espeficamente: a recuperacao atual e um lookup direto por chave (`company_id`+`contact_id`), sem busca por similaridade sobre muitos documentos — ou seja, **nao ha hoje nenhum ponto do produto que precise de busca vetorial** nessa tabela (`ai_contact_memory_items` guarda poucos fatos por contato, nao um corpus grande). Construir um backend vetorial agora seria infraestrutura sem consumidor. Se no futuro surgir busca semantica cross-contato ou uma base de fatos grande por contato, a opcao que melhor encaixa no hosting atual (cPanel/Node compartilhado, sem permissao para rodar um servico separado tipo Qdrant/Chroma) e **LanceDB embarcado** (biblioteca pura via `lancedb` no npm, sem servidor externo, arquivo local em disco) — reavaliar so quando essa necessidade aparecer de verdade.

### 11.3 Mike Local â€” cluster multi-PC (ðŸŸ¡ pronto, melhoravel)
**Arquivos:** `local-ai/mike-monstro-orchestrator.ps1`, `local-ai/mike-monstro-index.json`, relay em `\\SRVTOTALI\Docs\PASTA COMPARTILHADA\Felipe\teste rede\skills-network`, docs [ARQUITETURA_DISTRIBUIDA_MIKE.md](docs/execucao-minike/ARQUITETURA_DISTRIBUIDA_MIKE.md)/[CLUSTER_MODES_MIKE.md](docs/execucao-minike/CLUSTER_MODES_MIKE.md).
**Ja funciona:** relay LAN publica/le skills (`POST /skills/network/publish`, `GET /skills/network`); auto-invite de Mikes pela pasta privada.
**Ja funciona agora:** `auto_cluster` no boot converge relay automatico para a pasta canonica, adota relay anunciado por farol UDP quando a pasta padrao nao existe, cria/compartilha pasta local via SMB quando elevado e sem servidor, ativa `lan_relay_enabled`, `lan_sync_mode=background`, `publish_presence`, tarefas de imagem/Programar e `/compute-cluster/quick-connect`. O daemon `Invoke-BackgroundComputeLanSync` processa jobs e publica heartbeat.
**Falta + como fazer:** validar todos os PCs reais depois de reiniciar/atualizar a Mike; auditar sync automatico especifico de `skills-network` (hash/lock por skill) separado do relay de jobs, porque o relay de compute ja esta em background.

### 11.4 Mike Local â€” provedores de nuvem + DeepSeek (âœ… frente #1 concluida em 2026-06-28)
**Arquivos:** [includes/mike-preferences.php](includes/mike-preferences.php) (`mke_preferences_api_provider_catalog`, ~linha 108), `api/local-ai.php` (`action=api-providers` e correlatos), `includes/mike-preferences.json` (persistencia).
**Ja funciona:** catalogo (deepseek, openrouter, groq_cloud, together_ai, ollama_cloud) + save/test/toggle/delete por `user_id`, com `mke_preferences_api_provider_test`. DeepSeek foi adicionado em `includes/local_ai_catalog.php` e no fallback de `includes/mike-preferences.php` com `api_compatible=openai`, `api_base/base_url=https://api.deepseek.com`.
**Validacao feita:** `php -l` nos arquivos relacionados, consulta CLI do catalogo e teste funcional do ramo `api-provider-test` com chave falsa/temporaria (endpoint montado: `https://api.deepseek.com/models`). Teste autorizado final exige chave real do usuario.
**Falta futuro:** no agente (monstro), no roteador de provedor, aceitar `deepseek` como destino de fallback de qualidade.

### 11.5 Mike Local â€” geracao de imagem/video (ðŸŸ¡ pronto, melhoravel)
**Arquivos:** [docs/execucao-minike/GERADOR_MOTORES_IMAGEM_LOCAL.md](docs/execucao-minike/GERADOR_MOTORES_IMAGEM_LOCAL.md), `ferramentas/gerador/gerador.php` (motor oficial), `ferramentas/gerador/minike-studio-launcher.js`, `minike-studio-mike-adapter.js`, `local-ai/mike-adapters-and-macros.ps1` (adapter `image_generate` â†’ `Invoke-ImageEngine`).
**Ja funciona:** painel de motores locais com selecao/persistencia; adapters de imagem/audio/leads/document/macro; rota oficial unica do gerador (softwares/editor redireciona 302).
**Falta + como fazer (P0 `studio_confusing_flow`):** simplificar UX â€” **abrir o canvas direto apos escolher tamanho**, com a Mike como chat lateral opcional (estilo Canva). Implementar `ImageEngineAdapter` + progresso do ComfyUI no chat lateral. Ref: [PLANO_ACAO_MINIKE_STUDIO.md](docs/execucao-minike/PLANO_ACAO_MINIKE_STUDIO.md), Fooocus/ComfyUI.

### 11.6 Atendimento â€” Meta WhatsApp/IG/FB (ðŸŸ¡ pronto, melhoravel)
**Arquivos:** `atendimento/src/services/metaService.js` (~1900 linhas), `src/routes/oauthCallback.js`, `src/routes/webhook.js`, `src/services/integrationService.js` (`sendViaMeta`), UI `public/dashboard.html` (`startFacebookOAuth`/`startInstagramOAuth`).
**Ja funciona:** envio WhatsApp Cloud/templates/flows/catalogo; DM IG/FB (`enviarIgFb`); resposta a comentario por automacao (`responderComentario`, `enviarPrivateReplyComentario`); OAuth completo com upsert em `channels`; webhook inbound com assinatura validada.
**Falta + como fazer:**
1. **Publicacao manual de conteudo** (FB Page / IG feed/reels): criar `metaService.publicarPost(...)` usando `POST /{pageId}/photos|feed` e o fluxo de container IG (`/{ig-user-id}/media` + `/media_publish`). Exige escopos `pages_manage_posts` / `instagram_content_publish`.
2. **Listar posts/comentarios e moderar pelo painel** (responder/ocultar/curtir/excluir manual): novas rotas em `src/routes/api.js` + UI em `dashboard.html`.
3. **Confirmar em campo:** redirect URI exato no app Meta e escopos `pages_manage_engagement`/`instagram_manage_comments`.
Ref completo: [MAPA_TECNICO_E_PROGRESSO_ATENDIMENTO.md](atendimento/docs/MAPA_TECNICO_E_PROGRESSO_ATENDIMENTO.md) Â§2.

### 11.7 Atendimento â€” robo reaquece apos recusa (ðŸŸ¡ P1 corrigido no codigo em 2026-06-28)
**Arquivos suspeitos:** `atendimento/src/services/reheatingService.js`, `scheduledFlowRunnerService.js`, `morningGreetingService.js`, `src/routes/webhook.js` (`OPT_OUT_KEYWORDS`), tabela `contacts` (`opted_out`).
**O bug:** cliente disse "nao quero continuar"/"nao quero do atendimento" e o robo continuou reaquecendo dias depois ([PENDENCIAS_ATENDIMENTO.md](atendimento/docs/PENDENCIAS_ATENDIMENTO.md)).
**Correcao feita:** `automationPauseService.js` centraliza classificador auditavel, persistencia (`automation_paused_reason`, `automation_paused_at` + compatibilidade `followup_paused`) e gate `shouldSkipAutomation`. `reheatingService`, `scheduledFlowRunnerService` e `morningGreetingService` consultam o gate antes de enviar e logam `AUTOMATION_PAUSED_SKIP`. Migration: `atendimento/migrations/030_contacts_automation_pause.sql`.
**Validacao feita:** `node --check` nos arquivos tocados e `npm run test:automation-pause` (via `cmd pushd` por causa do UNC) cobrindo "Nao quero continuar", "Nao quero do atendimento" e o typo real "Nao quero do atendeminto".
**Falta operacional:** aplicar migration/deploy no atendimento real.

### 11.8 Atendimento â€” Mike oficial por empresa (ðŸŸ¡ backend pronto, falta tela)
**Arquivos:** `atendimento/src/services/mikeOfficialService.js`, `src/controllers/mikeOfficialController.js`, `src/routes/superAdmin.js`, tabela `mike_company_profiles`. Doc: [MIKE_OFICIAL_EMPRESAS.md](docs/execucao-minike/MIKE_OFICIAL_EMPRESAS.md).
**Ja funciona:** endpoints `GET/PUT /super-admin/mike/profiles[/:companyId]` e `POST .../bootstrap` (semeia welcome/out_of_hours/rating_request + liga ausencia/encerramento); trava `role=super_admin` + `user_id=1`.
**Falta + como fazer:** **tela visual** no `public/master.html` para editar perfil da Mike por empresa (consumir os endpoints acima); criar **presets por nicho** reutilizando os presets reaproveitaveis ([PRESETS_MIKE_REAPROVEITAVEIS.md](docs/execucao-minike/PRESETS_MIKE_REAPROVEITAVEIS.md): `human_handoff_guard`, `catalog_single_shot_guard`, etc.).

### 11.9 Subsites e conteudo (ðŸŸ¡ pronto, melhoravel)
**Arquivos:** [includes/ecossistema_content_registry.php](includes/ecossistema_content_registry.php) (curadoria central), `sites/*.php` (dominios, hospedagem, loja-virtual, landing-page, site-institucional, manutencao), `sites/admin/pedidos.php`, `cursos/index.php`, `cursos/trilhas.php`, `ferramentas/index.php`, `escolar/*`, `softwares/index.php`.
**Ja funciona:** vitrines puxam do registry curado; funil de sites grava origem por produto (`mk_sites_pedidos.origem`); pedido coleta pacote/dominio/urgencia; dashboard por origem.
**Falta + como fazer:** (1) **portfolio/exemplos visuais por nicho** nas paginas de `sites/`; (2) **modal visual de fechamento** no lugar dos `prompt()` simples; (3) **aulas/exercicios/avaliacao reais** na trilha API ([TRILHA_API_INTEGRACOES_MINIKE.md](docs/execucao-minike/TRILHA_API_INTEGRACOES_MINIKE.md)) e ligar o projeto guiado a um demo `json-server`; (4) **painel de chaves por empresa** para conectores sem expor segredo. Ref de lacunas: [LACUNAS_CONTEUDO_E_SITES.md](docs/execucao-minike/LACUNAS_CONTEUDO_E_SITES.md).

### 11.10 Visual / chat-first / animacoes (ðŸŸ¡ pronto, melhoravel â€” pergunta do dono sobre "visual vivo")
**Arquivos:** [local-ai/mike-ui.html](local-ai/mike-ui.html) (app chat-first, tema cianoâ†’roxo, deployado), plano aprovado em [docs/execucao-minike/redesign-chat-first/](docs/execucao-minike/redesign-chat-first/) (especialmente [05-animacoes-loading-update.md](docs/execucao-minike/redesign-chat-first/docs/05-animacoes-loading-update.md)).
**Ja funciona:** `mike-ui.html` com telas Chat/Ferramentas/Programar/Agentes/Capacidades/Conectores/Terminal/Skills/Projetos/Memoria/Config; ferramentas abrem dentro da tela (`/site?u=...`); layout antigo aposentado (so em `/ui/legacy`).
**Falta + como fazer (para ficar "vivo/animado" de verdade):**
1. **Aplicar o sistema de animacoes** do doc 05 em TODAS as telas (entrada de mensagem, loading "pensando", transicoes de drawer/pop-up, abertura/update) â€” hoje so parcialmente aplicado.
2. **Validar pagina a pagina** (nao so a UI da Mike, mas os subsites PHP) â€” fazer um checklist visual; o estado "animado e vivo" NAO esta confirmado fora da `mike-ui.html`.
3. Seguir a regra de produto: "parecer uma IA moderna antes de parecer painel tecnico".

### 11.11 Seguranca do site PHP (ðŸ”´ acao #4 â€” como fazer)
**Arquivos:** `.env` (`APP_DEBUG`), `admin/painel_supremo.php` e `admin/ecossistema.php` (acoes `read_log`/`read_file`/`save_file`), varios com `catch` vazio. Ref: [BUGS_REPORT.md](BUGS_REPORT.md), [ANALISE_SEGURANCA_QUALIDADE_2026-06-22.md](docs/execucao-minike/ANALISE_SEGURANCA_QUALIDADE_2026-06-22.md).
**Feito em 2026-06-28:** `.env` com `APP_DEBUG=false`; `admin/painel_supremo.php` exige super-admin em `read_log`/`clear_log`/`read_file`/`save_file`, nega `..`, valida `realpath()` e diretÃ³rios permitidos, mantÃ©m CSRF e grava auditoria; `admin/ecossistema.php` ganhou CSRF nos POSTs, super-admin para logs e auditoria. Validado com `php -l`.
**Como corrigir:**
1. `APP_DEBUG=false` e `display_errors=Off` em producao (deixar verbose so em CLI/local por env var).
2. Endpoints de arquivo: exigir super admin, `realpath()` dentro de uma allowlist de diretorios, **negar `..`**, exigir **CSRF** e gravar **log de auditoria**.
3. Trocar `catch (Exception $e) {}` por `error_log()` + resposta generica; padronizar JSON de API (401/403/422/500).
4. Remover/proteger flags `?test_ads=1`.

### 11.12 QA das ferramentas (ðŸ”´ P0 `tools_may_not_work` â€” como fazer)
**Por que:** muitas ferramentas existem mas conversores/processadores (PDF, OCR, imagem, midia) podem estar quebrados.
**Como fazer:** criar **QA automatico por ferramenta** com **semaforo** (funcionando / parcial / quebrada / perigosa / duplicada / descontinuar); auditar PDF/OCR/imagem/midia primeiro; preferir libs locais/browser-first (pdf.js, pdf-lib, tesseract.js, ffmpeg.wasm). Registrar resultado em `includes/local_ai_problem_solution_map.json` (fonte do [risk radar](docs/execucao-minike/relatorios/minike-risk-radar-latest.md)).

### 11.13 Regras para nao gastar tokens a toa (para qualquer IA)
- **Leia este topo (secoes 1-11) ANTES de varrer o repo.** O mapa de arquivos por frente ja esta aqui.
- **Nao re-explore** o que ja esta mapeado; va direto ao arquivo citado.
- **Nao leia `node_modules/`, `vendor/`, `fonte de dados/loja195/**/vendor`** (ruido).
- **Atualize ESTE topo** (data + item) ao terminar uma frente, em vez de criar mais um doc solto.
- **Caminhos hardcoded sao intencionais** (`\\SRVTOTALI\...`, convite de rede) â€” nao parametrizar.
- **Senhas nunca em arquivo/memoria.**

### 11.14 Atendimento â€” foto/avatar do cliente no WhatsApp (ðŸŸ¡ base pronta, A FAZER melhorias)
**Contexto / decisao tecnica (registrada para nao se repetir):**
- A ideia de "puxar a foto abrindo `wa.me/<numero>` sem enviar mensagem" **NAO funciona**: `wa.me` e so pagina de redirecionamento click-to-chat, nao expoe a foto. A foto so existe dentro de sessao autenticada do WhatsApp. Raspar `wa.me` nao traz nada e viola os termos. **Nao implementar scraper de wa.me.**
- O jeito correto **ja esta implementado** via Baileys (WhatsApp Web):
  - [whatsappWebService.js:228](atendimento/src/services/whatsappWebService.js#L228) `fetchProfilePictureUrl` â†’ `sock.profilePictureUrl(jid,'image')` com fallback `'preview'` (pega a foto SEM enviar mensagem).
  - [whatsappWebService.js:328](atendimento/src/services/whatsappWebService.js#L328) dispara `queueProfilePictureRefresh` na mensagem recebida.
  - [contactAvatarService.js](atendimento/src/services/contactAvatarService.js) baixa, valida, salva em `uploads/`, grava `contacts.avatar_url`, faz cache (nao rebaixa toda hora).
**Limitacoes honestas (sem contorno):**
- **API oficial Meta Cloud NAO fornece foto do cliente** (so o nome no webhook). Para contatos desse canal, nunca havera foto.
- Se o contato configurou foto como "somente meus contatos" e o numero nao esta nos contatos, o WhatsApp nao devolve a foto (log `WA_WEB_AVATAR_MISS`).
**A FAZER (passo a passo):**
1. **Garantir disparo na 1a mensagem** de numero sem foto salva (confirmar que `queueProfilePictureRefresh` roda no primeiro inbound, nao so em update de contato).
2. **Refresh periodico** (ex.: a cada N dias) porque o cliente troca a foto â€” agendar via `scheduledFlowRunnerService`/cron com `force=true` controlado.
3. **Avatar de fallback com iniciais** (estilo WhatsApp/Gmail): quando nao houver `avatar_url`, gerar circulo com iniciais do nome + cor deterministica (hash do nome/numero). Aplicar tanto no canal oficial Meta (que nunca tem foto) quanto quando a foto e privada. Implementar no front (`public/dashboard.html`) e/ou gerar SVG no `contactAvatarService`.
4. **UI**: indicar discretamente quando a foto nao esta disponivel por privacidade/canal, sem poluir.
**Validar:** `node --check` nos arquivos alterados; testar com um numero com foto publica, um com foto privada e um do canal oficial.

---

## 12. LAYOUT ANIMADO, VIVO E FLUIDO â€” diretriz + bibliotecas recomendadas

> Pedido explicito do dono: o site/app precisa **parecer vivo, animado e fluido**, nao um painel estatico.
> Esta secao e a referencia de COMO fazer isso de forma profissional e leve. Casa com [redesign-chat-first/docs/05-animacoes-loading-update.md](docs/execucao-minike/redesign-chat-first/docs/05-animacoes-loading-update.md).

### 12.1 Principios (regra de ouro de movimento)
1. **Proposito antes de enfeite:** animacao guia o olho (estado, foco, feedback), nao distrai. Microinteracao > animacao grande.
2. **Performance primeiro:** animar so `transform` e `opacity` (GPU). Evitar animar `width/height/top/left` (reflow). Lazy-load de libs pesadas (3D/Lottie) so na tela que usa.
3. **Acessibilidade:** sempre respeitar `@media (prefers-reduced-motion: reduce)` â€” desligar/encurtar animacoes.
4. **Consistencia:** duraÃ§Ãµes curtas (120-300ms em UI, 400-800ms em hero), easing padrao (`cubic-bezier(.2,.8,.2,1)`), reaproveitar tokens do tema cianoâ†’roxo ja usado em `mike-ui.html`.
5. **Fluidez de navegacao:** smooth scroll + transicoes de pagina + skeleton no carregamento (nunca tela branca travada).

### 12.2 Bibliotecas recomendadas (links oficiais)
**Microinteracoes / motion (UI viva):**
- **Motion One** (vanilla JS, ~5KB, Web Animations API) â€” https://motion.dev/ Â· ideal para o site PHP e `mike-ui.html` sem framework.
- **AutoAnimate** (FormKit, zero-config, anima add/remove/reorder de listas) â€” https://auto-animate.formkit.com/ Â· perfeito para cards de catalogo/chat.
- **Anime.js** (timelines, SVG morph) â€” https://animejs.com/
- **GSAP** + **ScrollTrigger** (padrao da industria p/ animacao avancada e scroll) â€” https://gsap.com/ Â· use so onde precisar de timeline complexa.

**Scroll vivo / reveal:**
- **Lenis** (smooth scroll moderno) â€” https://lenis.darkroom.engineering/
- **AOS â€” Animate On Scroll** (reveal simples por atributo) â€” https://michalsnik.github.io/aos/

**CSS pronto (rapido, sem JS):**
- **Animate.css** â€” https://animate.style/
- **Tailwind CSS Animate** (plugin; o atendimento ja usa Tailwind) â€” https://github.com/jamiebuilds/tailwindcss-animate
- **Hover.css** (efeitos de hover em botoes/cards) â€” https://ianlunn.github.io/Hover/

**Animacoes vetoriais / ilustracoes vivas (hero, loading, mascote da Mike):**
- **Lottie / lottie-web** (animacao JSON leve, ex. loading "pensando" da Mike) â€” https://lottiefiles.com/ Â· https://github.com/airbnb/lottie-web
- **Rive** (animacoes interativas com estados) â€” https://rive.app/

**Hero 3D / "wow" (usar com parcimonia, lazy-load):**
- **Three.js** â€” https://threejs.org/
- **Spline** (3D interativo sem codigo, exporta para web) â€” https://spline.design/
- **tsParticles** (fundo de particulas vivo) â€” https://particles.js.org/

**Carrossel / vitrine fluida:**
- **Swiper** â€” https://swiperjs.com/

**Loading / percepcao de velocidade:**
- Skeleton/shimmer (CSS) e **NProgress** (barra de topo) â€” https://ricostacruz.com/nprogress/

### 12.3 Onde aplicar no Minike (mapa pratico)
- **`local-ai/mike-ui.html`:** Motion One nas trocas de tela/drawer; bolha de "Mike pensando" com Lottie; AutoAnimate na lista de mensagens e cards de ferramentas.
- **Subsites `sites/`, `cursos/`, `ferramentas/`, `softwares/`, `escolar/`:** AOS/Motion One para reveal de cards; Lenis para scroll fluido; Swiper nas vitrines/portfolio; Hover.css nos CTAs.
- **Home/hero do hub:** Spline ou Lottie no hero + tsParticles discreto de fundo (lazy-load, desligar em mobile fraco e em reduced-motion).
- **Loading global:** NProgress nas navegacoes PHP + skeleton nos cards enquanto o registry carrega.
- **Modal de fechamento de pedido** (hoje `prompt()` cru â€” ver 11.9): substituir por modal animado (entrada/escala suave) â€” melhora conversao e sensacao de "site vivo".

> **Importante (honesto):** hoje o "vivo/animado" so esta confirmado parcialmente na `mike-ui.html`. Os subsites PHP ainda **nao** foram validados pagina a pagina. Aplicar 12.3 + checklist visual e o caminho para o site inteiro ficar fluido.

---

## 13. IDEIAS E SUGESTOES DA IA (nao implementado â€” backlog estrategico)

> Sugestoes minhas para evoluir o projeto. **Marcadas como ideia/proposta** â€” nenhuma esta implementada. Priorizar conforme o norte da secao 7. O dono decide o que entra.

### 13.1 Mike Local (nucleo)
- **Roteador de modelo por custo/qualidade/latencia:** uma funcao unica que escolhe entre rota local (`mike-fast-local`), PC vizinho da rede, ou nuvem (DeepSeek/OpenRouter) com base em: tamanho do contexto, intent, hardware e orcamento do plano. Hoje a decisao esta espalhada.
- **`agent_runs` persistente (modo "deixa trabalhando"):** plano â†’ etapas â†’ arquivos â†’ testes â†’ evidencias, com tela de acompanhamento. Resolve o P0 `mike_single_turn_limit` e vira diferencial de produto (a Mike "trabalha sozinha" num projeto).
- **Avaliador automatico de resposta (LLM-judge barato):** depois de responder, um passe curto checa "respondeu? inventou fato? fugiu do tema?" e regenera se reprovar. Estende o `topic_drift_repaired` que ja existe.
- **Telemetria de qualidade:** dashboard com readiness historico, % de respostas substituidas por corpus, hits de memoria â€” para enxergar regressao (como a de 18â†’8) na hora.

### 13.2 Atendimento (produto que ja gera receita)
- **Inbox unificado de verdade** (WhatsApp + IG + FB + futuros) com SLA visivel, etiquetas e "dono" do atendimento â€” reduz o caos multicanal.
- **Resumo automatico da conversa** + "proxima melhor acao" sugerida pela Mike no topo de cada ticket (usa a memoria que ja existe).
- **Co-pilot do atendente:** sugestao de resposta com 1 clique para enviar/editar, treinada no tom da empresa (presets por nicho).
- **Guard-rails de reputacao:** alem do P1 (recusa), detectar cliente irritado/risco de reclamacao e escalar para humano automaticamente.

### 13.3 Ecossistema / monetizacao
- **"Feito pela Mike" como funil:** todo subsite (sites, cursos, loja) com um CTA "pedir para a Mike montar" que abre o chat ja com contexto â€” transforma navegacao em lead.
- **Marketplace de skills/agentes** entre os PCs da rede (ja ha relay): empresa instala skill pronta (atendimento de nicho, professor, etc.).
- **Planos com valor claro:** o free generoso ja existe; faltam **provas de valor** no upgrade (ex.: relatorio, automacao, mais quota visivel no momento certo).
- **Selo de origem/IA** nos assets gerados (resolve o P1 `asset_rights_and_terms` e vira confianca).

### 13.4 Conteudo / educacao
- **Trilhas com projeto real + certificado** (a de API ja comeca isso): cada curso termina entregando algo que o aluno usa no proprio negocio.
- **Mike como professora particular:** modo "me explique como se eu tivesse 12 anos / nivel avancado" com a mesma base de conhecimento.

### 13.5 Engenharia / saude do projeto
- **Consolidar a documentacao** (este doc ja inicia): aposentar duplicatas (secao 10.7) e manter ESTE topo como unico vivo.
- **CI minimo:** script que roda `php -l` em todos os `.php`, `node --check` no atendimento e o parse do monstro PS1 â€” antes de cada deploy (pega BOM/erro de sintaxe como o do `cursos/trilhas.php`).
- **Fatiar o monstro** (fase 3 ja planejada) â€” manutencao fica muito mais barata e segura.
- **Backup versionado** dos corpus/skills treinados (hoje vivem so em `%LOCALAPPDATA%`), para nao perder treino ao trocar de PC.

---

## 14. INVENTARIO E MARCACAO DA PASTA `fonte de dados/` (reuso x lixo)

> Pedido do dono: marcar o que sera usado e limpar o que e lixo para liberar espaco.
> **Politica:** `fonte de dados/` e fonte de reuso documentada â€” **nada e apagado sem confirmacao do dono**, exceto lixo de SO. Conteudo baixado/externo e irreversivel se apagado.
> Tag: **[USAR]** ativo no ecossistema Â· **[REF]** referencia/estudo (manter) Â· **[LIMPAR?]** candidato a remover (precisa OK do dono) Â· **[LIXO]** removivel sem perda.

### 14.1 Marcacao por pasta
**Tamanhos reais (medidos 2026-06-28, total ~2,7 GB):**
| Pasta | Tam | Nota |
|-------|----:|------|
| `impresoras loja195/` | **1,1 GB** | [REF] â€” surpreendentemente grande; revisar backups/spool de impressao dentro. |
| `externos/` | 729M | [REF]/[LIMPAR?] â€” ver 14.2 (remotion 439M + continue 242M dominam). |
| `Bruno/` | 453M | [LIMPAR?] â€” projeto separado; ver se pertence ao Minike. |
| `galeria195/` | 428M | [REF] â€” inclui `archive/` e `test-results/` (traces de teste, candidatos a limpar). |
| `loja195/` | 65M | [REF]. |
| `ecossistema-minike/` | 2.6M | [USAR]. |

- **`ecossistema-minike/`** â€” **[USAR]**. Curadoria viva: `DOSSIE_ECOSSISTEMA_MINIKE.md`, `labs/api-mock-lab/db.json` (fixture da trilha API em uso), `fontes/`. **Manter.**
- **`loja195/`** â€” **[REF]**. Codigo-fonte da Loja195, base dos presets reaproveitaveis e da matriz de reuso ([MATRIZ_REUSO_FONTE_DE_DADOS_E_REPOS.md](docs/inventario-reuso/MATRIZ_REUSO_FONTE_DE_DADOS_E_REPOS.md)). **Manter** enquanto a migracao de presets nao terminar.
- **`galeria195/`** â€” **[REF]**. Sistema de galeria/site da Loja195 (PHP). Referencia visual/funcional. **Manter** (avaliar arquivar se nao for mais consultado).
- **`impresoras loja195/`** â€” **[REF]**. Docs/configs de impressao (Argox/Gerentec). Util se o modulo de impressao for portado. **Manter.**
- **`Bruno/`** â€” **[LIMPAR?]**. Projeto separado (API relatorio fotos, consultasicoob, contratosCRECI). Avaliar se pertence ao Minike; se nao, mover para fora ou arquivar. `bruno.zip` provavelmente duplica `src/` ja extraido â†’ candidato a remover.
- **`externos/`** (13 zips, ~730 MB) â€” **[REF]/[LIMPAR?]**. Repos externos **ja estudados** em [docs/inventario-reuso/estudos-externos/](docs/inventario-reuso/estudos-externos/) (01-16). Como os estudos ja foram extraidos para markdown, os zips brutos sao candidatos a remover **se o estudo cobrir o que precisamos**. Detalhe na 14.2.

### 14.2 `externos/` â€” zip a zip (tamanhos REAIS, total ~731 MB)
| Zip | Tam | Usado em | Recomendacao |
|-----|----:|----------|--------------|
| `remotion-dev__remotion__...zip` | **439M** | video | **[REF]/[LIMPAR?]** â€” maior peso. Manter so se video entrar no roadmap proximo; senao limpar (estudo `08` cobre). |
| `continuedev__continue__...zip` | **242M** | agente de codigo | **[REF]** manter (plano e adaptar `continue`); estudo `07`. 2o maior. |
| `thedotmack__claude-mem__...zip` | 19M | memoria | **[REF]** manter (adaptar claude-mem); estudo `12`. |
| `Anil-matcha__Open-Generative-AI__...zip` | 16M | gerador | **[REF]**; estudo `02`. |
| `lllyasviel__Fooocus__...zip` | 11M | gerador de imagem | **[REF]** manter (motor de imagem em integracao); estudo `05`. |
| `FareedKhan-dev__train-llm-from-scratch__...zip` | 2.5M | treino LLM | **[REF]**; estudo `01`. |
| `Z4nzu__hackingtool__...zip` | 1.1M | seguranca | **[LIMPAR?]** estudo `06` cobre; conteudo sensivel. |
| `rtadewald__Agents-Prompts__...zip` | 308K | prompts | **[REF]**; estudo `03`. |
| `arthurspk__guiadecybersecurity__...zip` | 140K | seguranca | **[LIMPAR?]** estudo `09` cobre. |
| `typicode__lowdb__...zip` | 112K | lab API | **[REF]** manter; estudo `07`. |
| `codecrafters-io__build-your-own-x__...zip` | 44K | estudo | **[LIMPAR?]** estudo `04` cobre. |
| `typicode__json-server__...zip` | 40K | lab API | **[REF]** manter (lab usa); estudo `07`. |
| `public-apis__public-apis__...zip` | ~~17K~~ | conectores | **[REMOVIDO 2026-06-28]** (era so 17K; estudo `07` cobre). |

**Ja removido nesta passagem:** os `Thumbs.db` (lixo de SO) e `public-apis...zip` (autorizado pelo dono â€” ganho minimo, 17K).

**Maior ganho real de espaco:** `remotion` (439M) e `continue` (242M) â€” juntos ~681 MB. Ambos sao **[REF]** com plano de uso (video / agente de codigo); so limpar apos decisao do dono de que nao serao adaptados. Os zips `[LIMPAR?]` pequenos somam < 2 MB (ganho irrelevante; limpar so por organizacao).

### 14.3 Zips de build/deploy do `atendimento/` â€” REGRA: manter sempre os ULTIMOS 3
**Decisao do dono (2026-06-28):** em `atendimento/`, manter **sempre os 3 zips mais recentes** e apagar o resto. Esses zips sao saidas regeneraveis do `gerar-zip-v60-completo-total.ps1 -PermitirSegredos` e **contem `.env` com segredos** â€” nao acumular (espaco + risco em pasta de rede compartilhada).
**A FAZER (automatizar a regra):** ao final do `gerar-zip-v60-completo-total.ps1`, apagar automaticamente os zips antigos do `atendimento/`, deixando so os 3 mais novos (ordenar por data, `Remove-Item` no excedente). Logar o que foi apagado.
**Limpeza ja executada (2026-06-28):**
- Removida a pasta `atendimento/zips-antigos-20260608/` (**~14 GB**).
- Removidos os 3 zips recentes mais antigos (TESTE-telegram-social, ESTAVEL-social-avatares-followup, completo-total-local-ai-381-final) â€” **~4,4 GB**.
- **Mantidos os 3 mais novos:** `minike-v60-prototipo-20260626.zip`, `minike-v60-COMPLETO-telegram-backend-blindado-20260626.zip`, `minike-v60-COMPLETO-hotfix-envio-mensagem-20260626.zip`.
- Removidos tambem: `Thumbs.db` (lixo de SO) e `public-apis...zip` (17K).
- **Total liberado: ~18,4 GB.**

---

## 15. REFERENCIAS DO DONO â€” reels salvos (layout animado + ferramentas)

> Origem: `C:\Users\195\Downloads\Photos-3-001 (2)` (19 screenshots de TikTok/Facebook, 17/06 a 27/06).
> O dono salvou como inspiracao. **Ao se referir a "layout vivo e animado", ele quer o estilo do Grupo A.**
> Estes sao **inspiracao/fontes** â€” recriar o efeito (CSS) ou instalar a skill; nao copiar conteudo proprietario.

### 15.1 Grupo A â€” Layout VIVO e ANIMADO (a referencia visual que o dono quer)
Casa com a secao 12. Conta `code_candy` (CSS) + `tenfoldmarc` (skill Claude):
- **Login/Signup animado** â€” painel desliza com `clip-path: polygon(...)` + `transform 900ms cubic-bezier(.77,0,.18,1)`; estado `.auth-container.active` troca os paineis. **Usar em:** tela de login do `dashboard.html`/`master.html` e onboarding.
- **Button Hover Effects** â€” `DECRYPT` (`animation: matrixDecode`), `LAUNCH` (`transform: rotateY(180deg)`), `PARTY` (`scale(1.04)` + confetti), `TYPE` (typewriter), `FLICKER` (`neonFlicker`), `SHINE` (`background: sweep()`). **Usar em:** CTAs dos subsites e da `mike-ui.html`.
- **Loading screens tematicos** ("que valem a pena esperar") â€” loaders com tema: halter (`repLift`), hamburguer empilhando (`dropIn`), cafe enchendo (`fillCup` + `steam`), sapo pulando (`hop`), doce desembrulhando. **Usar em:** loading dos subsites por nicho (ex.: delivery = hamburguer, escolar = outro) â€” da personalidade e reduz sensacao de espera.
- **Website Builder Setup for Claude Code** (`github.com/tenfoldmarc/website-builder-setup`) â€” skill que vira "estudio de web design" pra **construir sites animados** com Claude Code, sem codar. **Acao:** avaliar instalar como skill de apoio a producao dos subsites/landing pages (alinha 100% com o objetivo "vivo e animado").
- **Onlook** ("Cursor for Designers", `onlook.com`) â€” editor visual que desenha por cima do codebase. **Acao:** avaliar para a frente visual (secao 11.10/12).

> **A FAZER:** criar um arquivo `assets/css/minike-motion.css` (ou no tema existente) com esses padroes (login slide, hovers, loaders tematicos), respeitando `prefers-reduced-motion` e animando so `transform/opacity` (secao 12.1). Reaproveitar as libs da secao 12.2 (Motion One/AutoAnimate) em vez de reimplementar tudo na mao.

### 15.2 Grupo B â€” Ferramentas / modelos (resolvem dores reais) + recomendacao
| Referencia | Onde ajuda | Recomendacao |
|-----------|-----------|--------------|
| **AirLLM** (`lyogavin/airllm`) â€” 405B em 8GB VRAM | gargalo do modelo local fraco (secao 1) | **Avaliar serio.** Pode rodar modelo grande no PC bom da rede e atender os fracos. Ja ha `HANDOFF_AIRLLM_REDE_DISTRIBUIDA_2026-06-22.md`. |
| **Nemotron-3.5-ASR 0.6B** (CPU-only, tempo real) | transcricao de audio do atendimento | **Avaliar** â€” ASR local barato; casa com adapter `audio_transcribe`. |
| **Gemma-4-12B** (linha nova) | conversa local melhor que 270m/4b | **Avaliar** versao oficial (NAO a "obliterated"). |
| **OpenWA** (gateway WhatsApp open-source) | atendimento (alternativa a API paga) | **Avaliar com cautela** â€” comparar estabilidade vs Baileys/Meta atual antes de migrar. |
| **ViMax** (`HKUDS/ViMax`) / **video-use** (Claude Code) | geracao de video / conteudo | **Backlog** â€” frente de video (junto com `remotion`). |
| **Google-Maps-Scrapper** | captacao de leads (lead_growth) | **Avaliar** â€” respeitar termos/limites (ver risk radar P1 `asset_rights_and_terms`). |
| **claude-mem** (`thedotmack`) | memoria de sessao | Ja mapeado em `estudos-externos/12`; adaptar a memoria local. |
| **public-apis** | catalogo de conectores | Ja coberto (estudo 07); zip removido. |
| **hackingtool / X-osint** | estudo de seguranca | **Somente estudo** (ja em estudos-externos `06`/`09`); nada disso em produto cliente. |

> âš ï¸ **NAO usar em producao:** modelos **"OBLITERATED"/uncensored** (Gemma-OBLITERATED) e **GODMOD3** ("liberated AI / cognition without control"). Sao modelos sem guard-rails/jailbreak â€” risco reputacional e legal num sistema que fala com clientes. Registrado so como referencia do que **evitar**.

<!-- ===================== FIM DO DOCUMENTO UNICO ===================== -->
<!-- Daqui pra baixo: HISTORICO cronologico preservado (changelogs).   -->

---

## Mike Local 2.15.0 - Mike como porta de entrada do ecossistema + planos de uso + auto-scan (2026-06-23)
- A Mike Local AI agora recomenda/aciona ferramentas do ecossistema Minike em tempo real. Catalogo mestre unificado em `includes/ecosystem_registry.json` (59 itens: 19 subsites, 22 tools, 13 engines, 5 connectors) e o PHP `includes/ecosystem_registry.php` expoe `mke_ecosystem_*` (search, for_intent, top_for_user, by_id, deep_link, summary). A API ganhou `?action=ecosystem`, `?action=ecosystem-search`, `?action=ecosystem-top`.
- Auto-scan do ecossistema em `tools/ecosystem_scan.php`: varre diretorios canonicos (sites, softwares, ferramentas, cursos, escolar, lojas, delivery, crm, erp, financeiro, sobre, blog, bio, atendimento, admin, imagem), cataloga arquivos `.php` e atualiza o registry de forma idempotente. Itens novos entram com `status=installable`; itens que sumiram ficam como `archived` (nunca removidos). Suporta marcadores `<!-- mke:meta ... -->` no cabecalho do arquivo para metadados. Idempotente e auditavel: roda em pre-deploy ou via cron. Smoke test offline em `tools/ecosystem_scan.tests.py` valida contratos.
- Concierge server-side em `local-ai/mike-ecosystem-concierge.ps1`: funcoes `Resolve-EcosystemAction` e `Resolve-EcosystemActions` consomem o registry, devolvem `{action, tool_id, reason, deep_link, score, gated, plan_required, upsell}`. Testes em `local-ai/mike-ecosystem-concierge.tests.json` (12 casos: image, video, audio, leads, programming, education, ecommerce, etc.). `-ValidateOnly` para checagem rapida. O concierge foi plugado cirurgicamente no monstro em `mike-local-ai-minike.ps1` (3 returns do endpoint de chat agora carregam `ecosystem_suggestion` no payload). O monstro NAO foi refatorado; a chamada e aditiva. Hash SHA-256 regravado em `mike-local-ai-minike.ps1.sha256` (68b8f918...). Auto-update alinhado.
- Modelo de uso em `local-ai/mike-usage-plans.json`: 3 planos (free, pro, enterprise), quotas diarias por categoria (image, video, audio, leads, document, code_agent, macro, research, storage), ads_policy por plano, tool_plan_overrides (whatsapp_business -> pro, codex_unlimited -> pro, automacao_zapier_like -> pro, compute_marketplace -> enterprise, etc.), ad_units discretos (footer/rail, max 2 por sessao, 1 a cada 8 turnos, escondem em pro/enterprise). `local-ai/mike-usage-plans.ps1` expoe `Get-Plan`, `Test-PlanGate`, `Record-Usage`, `Get-PlanUpsell`; `includes/mike-usage-plans.php` expoe `mke_usage_plan_gate`, `_upsell`, `_ads_for_plan`, `_summary`. A API ganhou `?action=plan-status` e `?action=plan-gate`. Politica: **plano free NAO e paywall agressivo** - anuncios discretos, quotas generosas, upgrade opcional. Smoke test offline em `tests/smoke_usage_plans.py` valida o manifesto.
- Memoria de preferencias por user_id em `includes/mike-preferences.php`: cookie `mike_uid` (gerado on-demand, 1 ano, SameSite=Lax, HttpOnly), arquivo `includes/mike-preferences.json` (criado on-demand com flock via rename). Persiste: favorites, last_used, last_used_by_category, counts, preferred_audience. API ganhou `?action=remember` (POST com op=record/favorite/audience) e `?action=preferences` (GET). O `mke_ecosystem_top_for_user` agora soma um boost de uso previo (log de count, +2 por favorito, +1.5 por categoria dominante), e respeita a `preferred_audience` do usuario quando nenhuma audience explicita foi passada. O chat.php e o onboarding.php registram uso real ao clicar em "Abrir", "Usar na Mike" ou favoritar um card.
- Handlers reais do concierge no endpoint `?action=concierge-action`: recebe `tool_id` + `op=open|skill` + `plan`, valida gate, devolve `{intent_type, deep_link, tool, plan, gate, upsell, should_open, should_run_skill}` e ja grava uso na memoria. O chat.php usa isso para: (a) "Abrir" chama o handler real, respeita o gate, abre a deep_link; (b) "Usar na Mike" injeta o intent `!use_tool:<intent_type> <nome> (<id>)` no composer para o monstro reconhecer e executar; (c) "Liberar" (gate) mostra CTA + URL do upsell real.
- Onboarding primeira tela em `local-ai/onboarding.php`: hero com plano ativo + CTA "Abrir o chat", grid de cards top-N por audience (mistura subsites+tools+engines+connectors, prioriza ready > installable, plano livre, match de audience), 2 ad_units discretos quando o plano e free, localizacao de favoritos em localStorage (`mike:favs`), sincronizacao do chip de plano com `mike:plan` (se o usuario trocou no chat, a home re-renderiza). O `mke_ecosystem_top_for_user` ja considera a memoria de preferencias.
- Documentacao consolidada: o conteudo de `COMFYUI_INTEGRACAO_MIKE.md` foi absorvido por esta doc mestra; logs brutos (`claude code.txt`, `erros - nike.txt`) foram removidos. Ver secao "Arquivos consolidados (2026-06-23)" mais abaixo.
- Publicacao: `publish-mike-2026-06-23.sh` faz backup, validacao local, upload dos novos arquivos e smoke test em producao. `CHANGELOG_2026-06-23.md` registra a rodada.

### Arquivos consolidados (2026-06-23)
- `COMFYUI_INTEGRACAO_MIKE.md` -> absorvido nesta secao e na referencia operacional em `local-ai/mike-ecosystem-concierge.tests.json` (intent: programming, tools: codex, comfyui_workflow).
- `claude code.txt` (28 KB, log bruto de conversa sobre integracao do Claude Code via Ollama) -> removido. A intencao (integrar Claude Code local) ja esta coberta pelo `codex` no registry e pelo `code_agent` no plano free/pro.
- `erros - nike.txt` (1.5 KB, log de interacao com o chat) -> removido.
- `DOCUMENTACAO_ANALISE_MINIKE.md` (12 KB, analise de seguranca/qualidade de 2026-06-22) -> mantido como historico; os pontos ainda nao resolvidos migraram para o backlog em `docs/execucao-minike/BACKLOG_EXECUTAVEL.md`.

### Adapters de ferramentas e macros (2026-06-23, #13)
- `local-ai/mike-adapters-and-macros.ps1` expoe um registry de adapters (image, audio, leads, document, macro, research, connector) com funcoes `Register-MikeAdapter`, `Get-MikeAdapter`, `Get-MikeAdapters`, `Invoke-MikeAdapter`, `Register-MikeDefaultAdapters`, `Read-MikeMacro`, `Write-MikeMacro`, `List-MikeMacros`, `Invoke-MikeMacro`. Cada adapter e um scriptblock com contrato `param($Job, $Context) -> { ok, result | error }`. Adapters default ja cobrem `image_generate` (roteia para `Invoke-ImageEngine`), `audio_transcribe`, `leads_extract`, `document_export`, `open_studio`, `open_subsite`.
- Macros sao arquivos JSON em `local-ai/macros/*.json` com `steps[].kind` (intent_type) e substituicao simples de template `{{prev.X}}` no input. Limite de 16 steps por macro. Idempotencia via reescrita atomica. Macro de exemplo: `local-ai/macros/transcrever_resumir.json` (2 steps: transcrever audio + exportar markdown).
- Bridge PHP em `includes/mike-adapters-and-macros.php` expoe `mke_adapters_macros_list`, `mke_adapters_macros_get`, `mke_adapters_macros_run`. A API ganhou 3 actions: `?action=macros` (lista), `?action=macro-get&name=X` (detalhe), `?action=macro-run` (POST, async via `mke_async_jobs_submit` quando o monstro esta vivo; fallback `offline_pending` quando nao esta). Gate: macros com mais de 2 steps exigem plano `pro` ou `enterprise` (devolve 402 + upsell).
- O monstro `mike-local-ai-minike.ps1` ganhou a funcao `Initialize-MikeAdaptersAndMacros` (idempotente, fail-silent) e a chamada no boot do concierge (`Initialize-MikeAdaptersAndMacros` antes de `Resolve-EcosystemAction`). Validacao: PS1 com 325 linhas e 10 funcoes, braces 0; PHP com 6 funcoes; api/local-ai.php com braces 0 e 26 actions unicas.

### Fatiamento real do monstro (2026-06-23, #14 + #4)
- Estrategia em 3 fases publicada em `local-ai/mike-monstro-index.json` (atualizado para `phase: 2`) e no comentario-cabecalho do shim `local-ai/mike-monstro-main.ps1`:
  - **Fase 1 (entregue):** shim `mike-monstro-main.ps1` (73 linhas) que apenas delega 1:1 para o monstro via `Start-Process`, preservando o monstro intacto. Indice publico `mike-monstro-index.json` mapeia 617 funcoes em 7 categorias (bootstrap/main/http/features/runtime/misc/airllm).
  - **Fase 2 (entregue, 2026-06-23):** orchestrator extraido em `local-ai/mike-monstro-orchestrator.ps1` (194 linhas, 5 funcoes) com `Invoke-PrivateRelayBootstrap`, `Get-PrivateInvitePath`, `Test-PrivateRelayCompleted`, `Write-OrchestratorLock`, `Get-OrchestratorStatus`. Reune o bloco "Mikes instaladas pela pasta privada entram automaticamente no relay da empresa" do monstro (linhas ~14738+) em uma funcao reusavel com lock file (`orchestrator-relay.lock`), atomic writes, idempotencia. O monstro continua dono do auto-invite original; o orchestrator e skip-when-done, e o shim so o chama quando `-ViaShim` e a execucao retornou ExitCode 0. Hash do monstro NAO muda nesta fase.
  - **Fase 3 (futura):** fatiamento real em 4-5 modulos PS1 (`F0-BOOT`, `F1-INSTALL`, `F2-HTTP`, `F3-FEATURES`, `F4-SECONDARY-ENGINES`) que substituem o monstro. So acontece apos o orchestrator ficar estavel por 1 sprint. Hash do monstro so muda quando o codigo interno mudar.
- Politica de hardcoded paths (NAO parametrizar): `\\SRVTOTALI\Docs\PASTA COMPARTILHADA\Felipe\ia\minike\...` e `\\SRVTOTALI\Docs\PASTA COMPARTILHADA\Felipe\teste rede\CONVITE-MIKE-REDE-CASA-LOJA.json` estao replicados identicamente no orchestrator (por design - referencia `https://minike.com.br` continua sendo a unica URL parametrizada).
- Auto-update alinhado: `.ps1` e `.sha256` sao publicados juntos. Hashes desta rodada:
  - `mike-local-ai-minike.ps1` -> `3160e8cfbfda0a2769acf805a228aa77fb889f15f3709360f0aa8b907a82b285`
  - `mike-monstro-main.ps1` -> `ff4607a4262da2033a18647f4941bfd2382dfab5236e5f4cd1ceb1bcc7cfdde6`
  - `mike-monstro-orchestrator.ps1` -> `6dedd2ac5055a705dabb02dd62c2c4f9805a174adabe9b533c3e8dc1e5fcec82`
  - `mike-adapters-and-macros.ps1` -> `bd516893f74c013b9292ea2dbc364eba2f52dd451ff3c835570eac4d54e7ac2c`

## Mike Local 2.14.8 - Google Brasil controlado + fonte visivel + site oficial dos provedores (2026-06-17)
- A pesquisa web publica da Mike agora tenta `Google Brasil` primeiro (`google.com.br`) com idioma/localidade BR e cai para `DuckDuckGo HTML` apenas quando o Google nao responder ou nao retornar URLs uteis.
- O backend passou a devolver metadados estruturados de pesquisa (`engine_name`, horario local da consulta e URLs usadas) para o chat local.
- A UI do chat agora mostra, no rodape da resposta, onde a consulta foi feita e oferece links rapidos para abrir as fontes encontradas, reduzindo a sensacao de â€œresposta sem lastroâ€.
- As respostas de clima continuam com fonte publica dedicada (`wttr.in`), mas agora tambem expostas em metadados visuais no mesmo padrao do chat.
- A tela `Modelos de IA`/provedores ganhou botao `Abrir site original` para Ollama, OpenRouter, GroqCloud, Together AI, Codex, VS Code, Obsidian, Adrenaline, Playwright e RustDesk, alem da documentacao oficial.
- Validacao feita nesta rodada: `mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -InstallMode app` aprovado apos a alteracao.
- Publicacao seletiva feita em `minike.com.br` nesta rodada para:
  - `local-ai/mike-local-ai-minike.ps1`
  - `includes/local_ai_capabilities.json`
  - `includes/local_ai_model_matrix.json`
  - `DOCUMENTACAO_MESTRE_MINIKE.md`
- Backup remoto desta rodada: `/home/u340626637/backups_codex/mike_google_sources_20260617-091155`
- Fontes oficiais confirmadas nesta rodada:
  - Ollama Gemma 4: `https://ollama.com/library/gemma4`
  - Ollama Qwen 3.5: `https://ollama.com/library/qwen3.5`
  - Ollama Qwen2.5 Coder: `https://ollama.com/library/qwen2.5-coder`
  - OpenAI Codex app server: `https://developers.openai.com/codex/app-server/`

## Mike Local 2.14.7 - Gemma-first atualizado com aviso de troca (2026-06-17)
- A matriz de modelos foi atualizada para a linha atual da Ollama com prioridade pratica em `Gemma` para conversa geral, `Qwen Coder` para programacao e `Qwen 3.5` como fallback geral moderno quando a Gemma ideal nao couber.
- Ajuste de honestidade tecnica: `Gemma 4 E2B/E4B` nao devem mais ser vendidos como audio local pronto apenas porque a familia suporta audio. A Mike passa a tratar audio como `validar no PC` antes de prometer a funcao.
- Novo perfil automatico por hardware:
  - muito fraco: `gemma3:270m`
  - leve: `gemma3:1b`
  - medio: `gemma3:4b`
  - bom: `gemma4:e2b`
  - workstation comum: `gemma4:12b`
- O catalogo tambem passou a listar `qwen3.5:0.8b`, `qwen3.5:2b`, `qwen3.5:4b`, `qwen3.5:9b`, `qwen2.5-coder:14b`, `qwen3.6:27b`, `gemma4:26b` e `gemma4:31b`, com uso automatico ou manual conforme RAM/disco.
- A tela `Modelos de IA` agora recebe uma recomendacao calculada pelo proprio agente local: se o computador estiver usando um perfil antigo ou inferior ao recomendado, aparece um aviso com acao direta para `trocar agora` ou `instalar perfil recomendado`.
- As capacidades visiveis foram alinhadas para sugerir `gemma3:1b`, `gemma3:4b`, `gemma4:e2b` e `qwen3.5:2b` no chat geral, e `qwen2.5-coder` 1.5B/3B/7B/14B para programacao conforme a maquina.
- Fontes oficiais usadas nesta rodada:
  - Ollama Gemma 3: `https://ollama.com/library/gemma3`
  - Ollama Gemma 4: `https://ollama.com/library/gemma4`
  - Ollama Qwen 3.5: `https://ollama.com/library/qwen3.5`
  - Ollama Qwen 3.6: `https://ollama.com/library/qwen3.6`
  - Ollama Qwen2.5 Coder: `https://ollama.com/library/qwen2.5-coder`
  - Ollama Phi-4 Mini: `https://ollama.com/library/phi4-mini`

## Mike Local 2.14.6 - chat mais coerente e timeline inline (2026-06-16)
- O fallback rapido de receitas foi corrigido: `receita` generica nao cai mais automaticamente em bolo. O chat local agora distingue `bolo` e `feijoada`, e pedidos genericos de receita podem seguir para a LLM quando nao houver atalho seguro.
- O chat principal e o chat lateral de `Programar` passaram a usar ticker visual de atividade (`entendendo`, `escolhendo resposta`, `montando contexto`) antes da resposta final, reduzindo a sensacao de travamento.
- Quando a resposta vier de delegacao para agentes/rede, a bolha do chat agora tenta abrir uma timeline inline com status, progresso, maquina escolhida e eventos recentes do run, reaproveitando `watchDelegationRun` e `renderInlineAgentRun`.
- O roteador de ferramentas ficou mais conservador para mensagens abstratas. Pedidos sobre `agentes`, `etapas`, `tarefas`, `rede`, `cluster`, `revisar projeto` ou `workflow`, sem intencao clara de arquivo/midia (`pdf`, `imagem`, `video`, `word`, `excel`, `json`, `qr`, `arquivo`, `anexo`), nao devem mais desviar para ferramentas literais como `dividir PDF`.
- Validacao comprovada nesta rodada: `mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -InstallMode app` aprovado; reinstalacao local concluida; teste real via `/ui/chat` confirmou resposta correta para `Qual a receita de uma feijoada?` com `intent = recipe_feijoada`.
- Pendencia aberta para a proxima rodada: repetir um smoke test visual completo do POST delegado diretamente no app para registrar capturas da timeline inline em execucao multiagente, sem depender do shell desta maquina.
## Mike Local 2.14.5 - ranking Gemma-first por hardware (2026-06-16)
- O seletor automatico de modelos da Mike Local foi recalibrado para priorizar a familia Gemma quando o PC tiver folga real, mantendo Qwen como fallback seguro e Qwen Coder como especialista de programacao.
- Novo criterio de instalacao/chat geral: `gemma3:270m` para sobrevivencia ultraleve, `gemma3:1b` para PCs leves, `gemma3:4b` como padrao de notebooks/desktops medios, `gemma4:e2b` para PCs bons e `gemma4:e4b` para workstations com sobra de RAM/disco.
- O `gemma4:e2b` deixou de aparecer como auto em maquinas apertadas: a regra automatica agora exige mais folga (`24 GB RAM` / `8 GB disco livre`) para respeitar a reserva de recursos do Windows e do usuario.
- `gemma4:e4b` entrou no catalogo como opcao automatica apenas para workstations fortes (`28 GB RAM` / `10 GB disco livre`). `gemma4:12b` entrou como opcao manual premium para quem quer mais qualidade e aceita maior carga local.
- Os modelos Qwen gerais continuam no catalogo, mas agora sao descritos como fallback leve/forte quando a Gemma mais indicada nao couber. A trilha de programacao continua usando `qwen2.5-coder` em 0.5B / 1.5B / 3B / 7B.
- A UI de capacidades tambem foi alinhada para sugerir `gemma3:1b`, `gemma3:4b`, `gemma4:e2b` e depois `qwen2.5:1.5b` na conversa local.
- Fontes oficiais usadas para o ajuste: Google DeepMind Gemma (`https://deepmind.google/models/gemma/`) e bibliotecas oficiais Ollama para `gemma4`, `gemma3`, `qwen2.5`, `qwen2.5-coder`, `phi4-mini`, `llama3.2`, `mistral-small3.2` e `deepseek-r1`.
- Validacao atual: `mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -InstallMode app` aprovado apos a mudanca do ranking.
## Mike Local 2.14.4 - codex_worker no orquestrador (2026-06-16)
- O roteador de agentes agora reconhece um `codex_worker` local quando o Codex oficial estiver instalado, autenticado, com bridge ativo e houver pelo menos um projeto confiavel conectado.
- O `codex_worker` so entra automaticamente em tarefas de codigo/revisao tecnica; para conversa geral, planejamento leve e cenarios sem pasta confiavel a Mike continua preferindo os modelos locais/LAN.
- `Start-AgentRun` passou a enviar etapas selecionadas para o Codex pela API local autenticada da propria Mike, sem depender de terminal manual.
- A fila continua em modo analise: o prompt dos agentes segue proibindo afirmar execucao de comandos ou alteracao de arquivos. Se o Codex pedir permissao extra, a etapa falha com explicacao clara para o usuario abrir Programar > Codex e autorizar manualmente.
- Validacao atual: `mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -InstallMode app` aprovado apos a integracao. Pendencia: smoke test com Codex autenticado e release publica do instalador/hash.
## Mike Local 2.14.3 - ajuste mobile/PWA (2026-06-16)
- O mobile foi reposicionado como PWA/painel leve: Android/iOS nao instalam Ollama/Node/modelos locais pesados diretamente pelo navegador.
- A landing `/local-ai/` agora mostra botoes claros para abrir a Mike Web, adicionar icone na tela inicial e parear com PC/conta.
- O botao de instalar mobile nao depende mais silenciosamente do evento nativo do navegador; se o Android/iOS nao liberar o prompt, a tela mostra instrucoes especificas.
- iPhone/iPad seguem fluxo manual do Safari: Compartilhar > Adicionar a Tela de Inicio.
- Proxima etapa mobile real: app nativo/Capacitor/Tauri Mobile com login, push, camera/anexos e controle remoto dos workers PC/rede.
## Mike Local 2.14.2 - quatro modos e PWA mobile (2026-06-16)
- A pagina `/local-ai/` agora apresenta cards de escolha por modo: compatibilidade atual, app leve Edge/WebView, PWA instalada e desktop completo com fallback seguro.
- Android/iOS nao baixam `.cmd` nem `.sh`: usam `/local-ai/?mobile=1#mobile-app`, manifesto `/local-ai/manifest.json` e service worker `/local-ai/service-worker.js` para instalacao PWA/atalho.
- O endpoint `/local-ai/baixar.php?os=mobile|android|ios` redireciona para a instrucao mobile, evitando download errado no celular.
- O instalador PowerShell voltou ao nucleo seguro 2.14.2; a tentativa de compilar shell desktop dentro do instalador foi removida porque pode acionar antivirus. Desktop nativo deve ser pacote dedicado/assinado separado.
- Validado localmente: `php -l` em `local-ai/index.php`, `local-ai/baixar.php`, `includes/header-unificado.php`, `includes/local_ai_catalog.php`; `mike-local-ai-minike.ps1 -ValidateOnly` em app/desktop; `instalar-mike-windows.cmd --validate` em classic/app/pwa/desktop.
# Documentacao Mestre - Minike

Atualizado em: 2026-06-15
Responsavel por esta consolidacao: Codex
Status: documento mestre vivo, criado para ser o unico ponto de consulta do projeto Minike.

## 2026-06-15 - Plano Diretor Minike 2026

### Regra de verdade deste documento

- `Concluido`: codigo presente, fluxo integrado e validacao registrada.
- `Em andamento`: existe implementacao parcial sendo testada; nao deve ser vendido como pronto.
- `Planejado`: ideia priorizada com criterio de aceite, ainda sem entrega comprovada.
- Cartao, botao ou texto visivel nao prova que uma integracao externa esta operacional.
- Credenciais, pagamentos, autonomia local, publicacao e exclusao de dados exigem teste negativo e trilha de auditoria.
- O roadmap executavel fica em `includes/product_roadmap.json`; o Painel Supremo le esse arquivo sem depender do banco.
- A matriz executavel de modelos fica em `includes/local_ai_model_matrix.json`.

### Inventario tecnico auditado

O repositorio e um monolito modular PHP com aplicacoes Node e PowerShell associadas. A auditoria encontrou aproximadamente 1.141 arquivos PHP, 211 JavaScript, 49 SQL, 9 PowerShell, 5 shell Linux, 1 CMD e 5 manifestos de pacotes. Os numeros mudam conforme novas entregas entram, mas deixam claro que a Minike ja e um ecossistema e nao apenas uma pagina institucional.

| Area | Estado real em 2026-06-15 | Proxima lacuna critica |
|---|---|---|
| Hub Minike | Funcional, identidade visual e navegacao em evolucao | registro central de produtos, rotas e health checks |
| Mike Local | Desktop via Edge app, chat, projetos, memoria, ferramentas, macros e modelos | governador adaptativo, atualizador assinado e app nativo |
| Atendimento | Projeto Node amplo e integracao local parcial | omnichannel, handoff, isolamento por tenant e validacao ponta a ponta |
| Ferramentas | Catalogo e varias ferramentas PHP operacionais | execucao uniforme, cotas, filas, formatos e telemetria |
| Programar | Editor local, autosave, IA e Codex CLI externo | Monaco, LSP, Git visual, patch review e Codex app-server |
| Memoria | Markdown, propriedades, tags, links, backlinks, busca de conteudo, grafo e Canvas JSON | busca vetorial/reranking, Bases avancadas e politica de retencao |
| Agentes | Fluxos sequenciais, eventos e delegacao basica | sandbox, checkpoints, revisao cruzada e testes de regressao |
| Skills | Catalogo local/comunidade e skill oficial inicial | assinatura, revisao, proveniencia, cobranca e revogacao |
| Financeiro | Estruturas de configuracao e cobranca em construcao | conciliacao real, webhooks homologados e cofre de segredos |
| Campanhas | Paginas e fluxos iniciais | beneficios, metas, pagamentos, transparencia e analytics |
| Lojas/Delivery/Cursos/Escolar/Games | Modulos existentes com maturidade variavel | health checks, padrao visual, contratos e testes por jornada |
| Seguranca e privacidade | CSRF/rate limit/camadas publicas em partes do sistema | matriz global, DLP, auditoria imutavel, SBOM e resposta a incidente |

### Pesquisa de mercado e conclusoes

Foram usadas documentacoes oficiais ou repositorios primarios. Recursos de terceiros servem como referencia de produto e integracao; copiar marca, interface proprietaria ou codigo sem licenca continua proibido.

| Referencia | O que o mercado valida | Aplicacao Minike |
|---|---|---|
| Open WebUI | ferramentas, pipelines, RAG e conectores extensivos | catalogo seguro, busca hibrida e permissoes por ferramenta |
| AnythingLLM | dados locais, agentes, tarefas agendadas e hub comunitario | Mike Local privada, agenda e marketplace moderado |
| Dify | workflows, conhecimento e plugins | construtor visual e contrato padrao de extensoes |
| n8n | human-in-the-loop, avaliacoes e filas | aprovacao humana, regressao e trabalhos retomaveis |
| VS Code/GitHub | agentes customizados, MCP, trust e hooks | Programar limpo, confianca visual, conectores e revisao de patches |
| Obsidian | Canvas, propriedades, Bases e grafo | Memoria Minike interoperavel e intuitiva |
| Notion | pesquisa, busca empresarial e sintese de reunioes | pesquisa profunda e conhecimento empresarial |
| HubSpot/Intercom | atendimento baseado em conhecimento, handoff e analytics | agente de suporte supervisionado e medicao de resolucao |
| LiteLLM | gateway multi-modelo, chaves virtuais, budget e fallback | BYOK transparente, custo por tenant e roteamento |
| Langfuse | traces, datasets, experimentos e avaliacoes | observabilidade de IA e bloqueio de regressao |
| OWASP/NIST | prompt injection, supply chain, governanca e risco | matriz de seguranca obrigatoria antes de autonomia ampla |

Conclusoes:

1. O diferencial Minike nao deve ser "mais um chat", mas o conjunto local + cloud + ferramentas + negocios + atendimento.
2. Autonomia sem sandbox, aprovacao e auditoria vira risco operacional; seguranca precisa entrar antes da expansao de agentes.
3. Memoria util exige proveniencia, retencao e busca hibrida, nao somente acumular arquivos.
4. Marketplace sem assinatura, revisao e revogacao transforma uma skill em vetor de ataque.
5. O modelo "local primeiro, cloud quando necessario" reduz custo e preserva privacidade, mas precisa de benchmark por maquina e tarefa.
6. UX deve esconder detalhes tecnicos comuns, sem esconder fornecedor, custo, permissao ou destino dos dados.
7. O roadmap prioriza fundacao e seguranca antes de prometer integracoes financeiras, fiscais ou juridicas automaticas.

### Pesquisa Programar Studio Minike - VS Code, Obsidian, Adrenaline e dores da comunidade

Pedido registrado em 2026-06-15: melhorar a aba `Programar`, pesquisar VS Code, Adrenaline e Obsidian, procurar reclamacoes da comunidade, criar uma versao propria e avaliar o sistema de varias maquinas dividindo processamento.

Status honesto:

- Concluido agora: documentacao, roadmap MK-072 a MK-079, rota local `/compute-cluster`, painel visual de rede local na aba Agentes, timeline mais clara dos agentes e piloto de worker privado local.
- Parcial: multiagente local ja existe e mostra eventos, mas ainda e sequencial neste PC. O novo worker privado executa jobs locais curtos (`local_status`, `benchmark`, `summarize_text`) com configuracao, limites e auditoria, preparando a base para multi-maquina.
- Nao pronto para vender como cluster comunitario: dividir tarefas entre varias maquinas de terceiros ainda exige servidor coordenador, pareamento, fila, sandbox, assinatura de workload, verificacao de resultado, reputacao, isolamento por tenant, KYC/KYB quando houver pagamento e revisao juridica.

### Rede de Processamento Minike - piloto privado 2026-06-15

Implementacao feita no instalador/app local `local-ai/mike-local-ai-minike.ps1`, versao inicial `2.9.0-minike`, expandida para `2.10.0-minike`, `2.11.0-minike`, `2.11.1-minike`, `2.11.2-minike`, `2.11.3-minike`, `2.11.4-minike`, `2.11.5-minike`, `2.12.0-minike`, `2.12.1-minike`, `2.12.2-minike` e `2.12.3-minike`.

Estado entregue:

- O app local agora cria e usa `compute-cluster.json`, `compute-jobs/` e `compute-audit.jsonl` dentro de `%LOCALAPPDATA%\MINIKE-Local-AI`.
- A aba `Agentes` ganhou controles para ativar/desativar este PC como worker privado da conta/empresa, pausar temporariamente, escolher escopo privado, limitar CPU/RAM entre 10% e 70%, escolher 1 ou 2 jobs simultaneos e liberar tipos de tarefa.
- A API local agora tem `GET /compute-cluster`, `POST /compute-cluster/config`, `POST /compute-cluster/job/start` e `POST /compute-cluster/job/cancel`.
- Jobs do piloto: diagnostico local, benchmark curto e resumo de texto. Todos rodam localmente, sem abrir terminal para o usuario e com eventos exibidos na tela.
- O modo comunidade geral, venda de processamento, tokens e pagamento em dinheiro continuam bloqueados por padrao. A interface informa que isso depende de sandbox, contrato, antifraude, KYC/KYB, dados fiscais, conciliacao e revisao juridica BR/US.
- Validacao em 2026-06-15: instalacao local atualizada para `2.9.0-minike`; API testada com token da propria UI; `local_status`, `benchmark` e `summarize_text` terminaram como `completed`. O pacote publico em `https://minike.com.br/local-ai/mike-local-ai-minike.ps1` tambem foi validado por SHA-256.
- Expansao em 2026-06-15 para `2.10.0-minike`: aba `Agentes` ganhou pareamento privado com gerar convite, copiar pacote, colar convite de outra Mike, aceitar pareamento, listar/revogar convites e remover maquinas pareadas.
- Validacao `2.10.0-minike`: instalacao local atualizada; convite de teste gerado, aceito como `paired_pending_coordinator` e removido; API testada com token da UI; resposta publica nao vazou `pair_secret` nem `secret_hash`.
- Expansao em 2026-06-15 para `2.11.0-minike`: coordenador local seguro criado. A aba `Agentes` ganhou botao `Coordenar`; a API ganhou `POST /compute-cluster/coordinator/start`; cada atribuicao recebe envelope assinado com HMAC-SHA256. Sem maquinas pareadas, a tarefa coordenada roda localmente. Com maquina pareada, a parte local conclui e a parte remota fica em `waiting_secure_channel`, sem fingir que ja existe troca remota real.
- Validacao `2.11.0-minike`: rota do coordenador testada com token da UI; envelope retornou `HMAC-SHA256`; resposta nao vazou `coordinator_secret`, `pair_secret` nem `secret_hash`; teste com pareamento temporario retornou `partial_waiting_channel` com 1 atribuicao local concluida e 1 remota aguardando canal seguro.
- Correcao em 2026-06-15 para `2.11.1-minike`: o instalador deixou de tratar o caminho padrao `\\srvtotali\Docs\PASTA COMPARTILHADA\Felipe\ia\minike` como dependencia obrigatoria. Em computadores fora da rede interna, a Mike agora registra aviso visual e continua a instalacao; o usuario conecta a pasta depois pela tela. Validado com `-DefaultProjectPath` apontando para um servidor inexistente.
- Correcao em 2026-06-15 para `2.11.2-minike`: o instalador passou a redetectar `ollama.exe` apos instalacao via winget/instalador oficial, aguardar ate 120 segundos, ignorar alias quebrado em `Microsoft\WindowsApps` e validar a API local do Ollama antes de continuar. Se o executavel nao aparecer, a mensagem agora orienta reiniciar o Windows ou instalar o Ollama manualmente, em vez de quebrar com `Start-Process`.
- Expansao em 2026-06-16 para `2.11.3-minike`: a rede de processamento ganhou politica de compartilhamento por `minha conta`, `empresa/equipe` e `rede Minike inteira`. O modo rede inteira publica apenas presenca/descoberta; jobs de terceiros continuam bloqueados ate sandbox, contrato e antifraude. O roteador de agentes agora escolhe automaticamente a melhor maquina para cada agente com base em recursos, modelo ativo e escopo; a timeline mostra as maquinas/agentes conversando. A Mike tambem passou a exigir plano de diversidade de modelos para workers de agentes, recomendando pelo menos 2 modelos locais compativeis e oferecendo preparacao guiada dos modelos faltantes.
- Correcao em 2026-06-16 para `2.11.4-minike`: o instalador Windows passou a preparar dependencias base antes de abrir ferramentas locais. Em Windows 10/11 moderno, instala/detecta Node.js LTS e npm automaticamente, tenta preparar Git, FFmpeg e RustDesk por winget e registra `dependency-report.json`. O extrator B2B/Codex visual/exportacoes nao devem mais pedir Node ao usuario apos uma instalacao limpa. Windows 7/8 e Windows 10 antigo entram em modo legado/compatibilidade: nao tentam instalar runtimes modernos incompatÃ­veis e orientam usar modo online ou atualizar para Windows 10 22H2/11 para IA local completa.
- Expansao em 2026-06-16 para `2.11.5-minike`: a aba `Programar` ganhou painel `Ambientes` para diagnosticar e preparar ambientes de teste. O catalogo local cobre Docker/containers, Linux via WSL, Android Emulator, VirtualBox, QEMU, Playwright/navegador isolado, RetroArch/emuladores retro e iOS Simulator como dependencia externa. A Mike pode preparar automaticamente apenas ferramentas aprovadas via gerenciador do Windows quando houver suporte; WSL, iOS, ISOs, Windows, BIOS e ROMs ficam como guia/licenca/imagem propria. Essa regra evita pirataria, promessas falsas e instalacoes pesadas sem confirmacao visual.
- Expansao em 2026-06-16 para `2.12.0-minike`: criado piloto real de cluster privado LAN por pasta compartilhada da empresa. A aba `Agentes` ganhou configuracao de `Relay LAN`, caminho da pasta compartilhada, modo manual ou automatico com a tela aberta, botao `Sincronizar rede agora`, lista de PCs LAN online e uso automatico desses workers no roteador. Cada Mike publica heartbeat com modelo, recursos e codigo curto; o coordenador divide tarefas fechadas (`diagnostico`, `benchmark`, `resumir texto`) em jobs JSON na pasta relay; os PCs processam e devolvem resultados pela mesma pasta. Nesta fase nao executa codigo arbitrario remoto e nao abre rede publica/comunitaria.
- Status Codex em 2026-06-16: a integracao direta oficial existe dentro do `Programar` por `codex app-server`/CLI local, usando autenticacao e limites da conta do usuario, com historico, aprovacoes, eventos, comandos e alteracoes na tela. Ainda nao esta conectado como worker automatico do cluster LAN. Proxima etapa tecnica: criar um `codex_worker` no orquestrador para que tarefas de programacao possam ser revisadas pelo Codex e conferidas por modelos locais/maquinas LAN antes da entrega final.
- Status conectores IA/GitHub em 2026-06-16: `Codex` e a unica integracao direta estilo IDE ja operacional, porque existe `codex app-server` oficial para cliente rico local. `GroqCloud`, `Gemini`, `Claude/Anthropic`, `OpenRouter` e `Together AI` devem ficar no modo conta do cliente/BYOK ou OAuth oficial quando o fornecedor permitir; nao mascarar login nem capturar senha. `GitHub` deve ser implementado como `GitHub App` preferencialmente, com OAuth/device flow, permissoes por repositorio, tokens curtos, revogacao e auditoria; ate isso ficar pronto, Git local continua disponivel apenas em projetos/pastas confiaveis.
- Expansao em 2026-06-16 para `2.12.1-minike`: adicionada primeira camada antifalha do coordenador distribuido. Quando uma maquina, modelo local ou provedor futuro falhar por cota/tokens, timeout, rede/offline ou permissao, a Mike registra o tipo da falha, salva o contexto reaproveitavel da parte da tarefa e tenta reatribuir para outro worker local/LAN autorizado. O limite inicial e de ate 2 tentativas de fallback por parte; se nao houver worker seguro, a tarefa termina como `completed_with_failures` e a timeline mostra o motivo. A regra ainda e conservadora e cobre tarefas fechadas do cluster; o proximo passo e aplicar a mesma politica aos conectores cloud e ao futuro `codex_worker`.
- Melhoria visual em `2.12.1-minike`: a execucao multiagente passou a registrar uma fila de trabalho mais humana: demanda recebida, maquina escolhida, agente assumindo, plano operacional visivel, passagem para o proximo agente, revisao final e eventos de fallback. A interface traduz eventos tecnicos em rotulos compreensiveis para o cliente acompanhar o trabalho sem achar que travou. Observacao de seguranca: a tela mostra plano operacional, verificacoes e decisoes uteis, nao raciocinio privado interno bruto.
- Correcao em `2.12.2-minike`: instalacao limpa passou a preparar o Extrator B2B durante o instalador quando Node/npm estao disponiveis, incluindo `npm ci` e Chromium do Playwright. O status da ferramenta agora so marca dependencias como prontas quando `node_modules/playwright` e o marcador `dependencies-3.1.1.ok` existem. No primeiro uso, a ferramenta ainda tenta autorreparo se necessario, suprime avisos cosmeticos do npm e troca erro cru como `npm notice` por mensagem amigavel. Se o Windows bloquear Node/MSI, a mensagem orienta executar como administrador.
- Correcao em `2.12.3-minike`: o chat ganhou respostas locais para pedidos simples como receita de bolo, status de internet controlada e explicacao honesta sobre cluster. Anexos agora sao normalizados antes do roteamento: arquivos textuais continuam entrando no contexto da LLM; PDF, imagem, Word/Excel/PowerPoint e audio acionam cartoes de ferramenta/capacidade apropriada em vez de ficarem silenciosos. Observacao importante: o cluster LAN ainda acelera jobs fechados em `Agentes > Coordenar`; o chat comum ainda nao divide toda pergunta automaticamente entre PCs. Proxima etapa: fila universal de tarefas para unificar chat, ferramentas, agentes, memoria e cluster.

Controle atual:

- Por enquanto o controle e do usuario/empresa dona da maquina (`account_private` ou `team_private`).
- Pareamento privado local existe e o novo relay LAN permite processamento entre PCs da mesma empresa quando todos apontam para a mesma pasta compartilhada e estao com a Mike aberta/sincronizando.
- Coordenador local existe, cria envelopes assinados para planejamento e agora tambem cria jobs fechados no relay LAN privado. Relay cloud publico ainda nao existe.
- Nao existe ainda coordenador cloud para somar varias maquinas automaticamente.
- Nao existe ainda fila remota assinada nem validacao cruzada de resultado.
- Nao existe ainda marketplace de processamento comunitario operacional.

Proxima implementacao recomendada:

1. Criar servidor coordenador Minike com jobs assinados, retomada, cancelamento e logs por tenant.
2. Criar pareamento por QR/chave curta entre maquinas da mesma conta/empresa.
3. Criar worker remoto que puxa apenas tarefas permitidas, nunca aceita codigo arbitrario aberto e respeita limite local.
4. Adicionar painel visual de maquinas conversando/trabalhando com eventos em tempo real.
5. Somente depois abrir estudo juridico/financeiro para marketplace comunitario de processamento.

Fontes consultadas nesta rodada:

- VS Code documentacao oficial: `https://code.visualstudio.com/docs`, `https://code.visualstudio.com/docs/core-editor/overview`, `https://code.visualstudio.com/docs/agents/overview`, `https://code.visualstudio.com/docs/editing/workspaces/workspace-trust`.
- Obsidian Help: `https://obsidianmd-obsidian-help.mintlify.app/plugins/overview` e paginas de Canvas, Graph, Backlinks, Bases, Search e Templates.
- Adrenaline: `https://github.com/shobrook/adrenaline` e pagina de produto Product Hunt. Interpretei o termo "adrenali" como Adrenaline, ferramenta de perguntas, visualizacao e depuracao de codebase.
- Cluster/distribuicao: Ray, Dask e BOINC como referencias conceituais. Ray/Dask validam tarefas distribuidas, atores/workers e dashboard; BOINC valida a ideia de computacao voluntaria, mas nao deve ser copiado sem controles comerciais, juridicos e de seguranca.
- Dores de comunidade: issues/foruns sobre Workspace Trust repetitivo no VS Code, risco de extensoes maliciosas, desempenho de Canvas no Obsidian com documentos/canvases grandes, canvas que nao reflete links nas notas, e friccao de login/remote/dev containers.

Funcoes centrais mapeadas do VS Code para a nossa versao:

1. Explorador de arquivos.
2. Multi-root workspace.
3. Abas de arquivos.
4. Edicao com sintaxe.
5. IntelliSense/autocomplete.
6. Sugestoes inline.
7. Refatoracao.
8. Ir para definicao.
9. Buscar referencias.
10. Renomear simbolos.
11. Snippets.
12. Formatacao.
13. Paleta de comandos.
14. Atalhos configuraveis.
15. Temas/perfis.
16. Configuracoes sincronizaveis.
17. Terminal integrado.
18. Tarefas de build.
19. Test runner.
20. Debugger.
21. Breakpoints.
22. Watch/variables.
23. Console de debug.
24. Git integrado.
25. Diff visual.
26. Staging/commit.
27. Branches.
28. Merge conflict resolver.
29. Pull requests/issues.
30. Extensoes.
31. Marketplace.
32. Workspace Trust.
33. Remote SSH.
34. WSL/dev containers.
35. Port forwarding.
36. Browser integrado para testes.
37. Telemetria configuravel.
38. Acessibilidade.
39. Notebook.
40. Copilot/chat/agentes.
41. MCP/tools.
42. Hooks.
43. Prompt files.
44. Skills/agentes customizados.
45. Checkpoints e revisao de edits.
46. Artefatos/painel de resultados.
47. Sessao de agente retomavel.
48. Permissoes por acao.
49. Sandboxing.
50. Logs de agente/debug de interacao.

Funcoes centrais mapeadas do Obsidian para a nossa versao:

1. Cofre local legivel em Markdown.
2. Links `[[nota]]`.
3. Backlinks.
4. Outgoing links.
5. Graph view.
6. Canvas infinito.
7. Bases com propriedades.
8. Views filtradas.
9. Busca com operadores.
10. Templates.
11. Daily notes.
12. Tags.
13. Bookmarks.
14. File recovery.
15. Page preview.
16. Outline.
17. Properties view.
18. Quick switcher.
19. Slash commands.
20. Workspaces/layouts.
21. Sync opcional.
22. Publish opcional.
23. Community plugins.
24. Themes/CSS snippets.
25. Web viewer.

Funcoes mapeadas do Adrenaline para a nossa versao:

1. Conversar com a codebase.
2. Visualizar estrutura do projeto.
3. Responder perguntas tecnicas.
4. Explicar trechos de codigo.
5. Depurar erro a partir de mensagem/stack trace.
6. Sugerir correcao.
7. Buscar documentacao.
8. Raciocinio multi-etapa.
9. Gerar diagramas explicativos.
10. Ajudar a entender repositorios grandes.

Reclamacoes/dor de mercado que viram diferencial Minike:

- VS Code/IA: excesso de popups de confianca e permissoes. Diferencial: uma central unica de permissao por projeto, com modo restrito claro.
- VS Code/extensoes: risco de extensao maliciosa roubar codigo, token ou segredo. Diferencial: marketplace Minike com assinatura, escopo, sandbox, allowlist e revogacao.
- VS Code/remoto: login, remote, dev containers e ambiente quebram facil para usuario comum. Diferencial: "abrir projeto", "testar", "corrigir" e "rodar em ambiente seguro" sem terminal cru por padrao.
- Obsidian/Canvas: canvases grandes travam. Diferencial: renderizacao progressiva, limite visual por zoom, lazy loading e resumo por grupos.
- Obsidian/links: conexoes visuais nem sempre viram links reais em notas. Diferencial: canvas e notas sincronizados; conexao visual gera metadado e backlink.
- Ferramentas de IA: parecem travadas durante tarefas longas. Diferencial: timeline viva, agente atual, maquina usada, arquivos analisados, testes em execucao e botao cancelar.
- Depuradores de IA: podem inventar causa. Diferencial: separar evidencia real de inferencia da IA; logs/testes sempre aparecem antes da opiniao.
- Ferramentas locais: usuario nao quer ver terminal cheio de avisos. Diferencial: jobs visuais, logs recolhidos, progresso e resumo amigavel.

Programar Studio Minike - versao nossa proposta:

1. Modo foco limpo para programadores.
2. Explorador recolhivel por padrao.
3. Painel de problemas recolhivel por padrao.
4. Abas de arquivos de varios projetos.
5. Workspaces multi-root.
6. Abrir qualquer arquivo textual seguro.
7. Autosave com indicador de estado.
8. Historico de edicoes locais.
9. Diff antes/depois.
10. Aceitar/rejeitar patch da IA.
11. Restaurar checkpoint.
12. Buscar no projeto.
13. Ir para arquivo.
14. Mapa de rotas PHP/JS/API.
15. Mapa de tabelas SQL.
16. Mapa de dependencias.
17. Grafo da codebase.
18. Notas do projeto ligadas a arquivos.
19. Backlinks entre nota, bug, arquivo e teste.
20. Canvas de arquitetura.
21. Lista de TODO/FIXME.
22. Detector de segredos.
23. Detector de arquivos grandes.
24. Detector de dependencias vulneraveis.
25. Lint local.
26. Testar projeto.
27. Mapa do projeto v1 no Programar Studio: leitura segura sem executar codigo, resumo de linguagens, pastas principais, arquivos-chave, comandos detectados, rotas provaveis e alertas.
28. Mapa visual v2: grafo pesquisavel de arquivos, rotas, dependencias, tabelas e notas, inspirado em Obsidian/Adrenaline mas com limites de desempenho.
27. Cacar bugs.
28. Corrigir com IA depois de revisar.
29. Rodar testes novamente apos correcao.
30. Gerar relatorio tecnico.
31. Gerar changelog.
32. Gerar documentacao de arquivo.
33. Gerar documentacao de API.
34. Criar testes unitarios.
35. Criar testes E2E.
36. Teste visual com navegador.
37. Teste visual de app/jogo local.
38. Terminal seguro por projeto.
39. Tarefas pre-aprovadas.
40. Ambiente isolado por projeto.
41. Instalar dependencias com aprovacao.
42. Perfil de linguagem.
43. Skill oficial de programacao.
44. Agente arquiteto.
45. Agente programador.
46. Agente testador.
47. Agente seguranca.
48. Agente documentador.
49. Revisor cruzado.
50. Validador final.
51. Modelo de codigo separado do modelo de conversa.
52. Modelo forte cloud quando local nao aguentar.
53. Modelo auxiliar pequeno para resumo/triagem.
54. Observabilidade dos agentes.
55. Logs tecnicos recolhidos.
56. Modo iniciante sem jargoes.
57. Modo profissional com atalhos.
58. Marketplace de skills de programacao.
59. Templates de projeto.
60. Publicacao/deploy com rollback.

Sistema de varias maquinas:

- Arquitetura alvo: coordenador Minike + workers locais pareados. O coordenador quebra o trabalho em jobs pequenos; cada worker informa CPU, RAM, GPU, bateria/temperatura quando possivel, modelo instalado, permissao e disponibilidade.
- Primeira entrega visual: a Mike Local mostra o proprio computador como no local, explica que multi-maquina esta em desenvolvimento e lista as etapas necessarias. Isso evita prometer o que ainda nao tem seguranca operacional.
- Fase tecnica 1: inventario local, fila local, job IDs, logs, cancelamento, checkpoints.
- Fase tecnica 2: pareamento LAN/conta Minike com convite curto, chave por dispositivo, escopo e revogacao.
- Fase tecnica 3: coordenador remoto com jobs assinados, limite por tenant, retry, dead-letter e verificacao de resultado.
- Fase tecnica 4: worker sandbox para tarefas permitidas: OCR, conversao, teste, build, resumo, embeddings e inferencia local controlada. Nada de codigo arbitrario publico sem isolamento forte.
- Fase tecnica 5: marketplace de processamento com reputacao, antifraude, pagamento/credito e regras juridicas.

Decisao de produto:

- O diferencial nao e copiar VS Code ou Obsidian. O diferencial e juntar editor + memoria + agentes + ferramentas + atendimento + cluster controlado, com visual agradavel e seguranca clara para usuario comum.
- O editor Minike deve ser suficiente para abrir, entender, testar, corrigir e documentar projetos dos clientes. Programadores avancados ainda podem usar VS Code quando quiserem, mas a Mike deve coordenar plano, testes, agentes, memoria e relatorios.

Estrategia de conectores para ferramentas existentes:

- A Minike tera a propria experiencia, mas deve ser conectavel ao ecossistema do usuario. O produto ideal nao prende o usuario; ele acompanha o trabalho onde o trabalho ja acontece.
- VS Code Bridge: extensao futura da Minike que conversa com a Mike Local por `localhost` autenticado, respeita Workspace Trust, envia arquivo/seleÃ§Ã£o/tarefa, recebe diagnosticos, abre patch revisavel e mostra timeline dos agentes dentro do VS Code.
- Obsidian Bridge: plugin futuro ou modo pasta/vault autorizado. A Minike pode ler notas Markdown permitidas, criar backlinks, publicar relatorios de agentes como notas, sincronizar canvas/arquitetura e transformar decisoes tecnicas em memoria viva.
- Adrenaline/codebase visual bridge: nao ha compromisso de API oficial publica nesta etapa. A Minike pode se inspirar no fluxo de perguntas e visualizacao de codebase, importar mapas/relatorios quando houver formato aberto, ou criar o nosso proprio mapa visual.
- Caminho inverso: a Mike Local tambem deve abrir projetos VS Code, vaults Obsidian e exports de ferramentas de codebase dentro do Programar Studio, mantendo permissao por pasta e logs.
- Regra legal: usar integracao documentada, formato aberto, extensao propria ou API permitida. Nao clonar marca, interface proprietaria, token, endpoint privado ou comportamento que burle termos.
- Regra de seguranca: cada ponte tem escopo, token local curto, revogacao, rate limit, allowlist de pasta, auditoria e nenhum acesso a terminal/segredo sem confirmacao.
- Roadmap: MK-080 registra as pontes Minike para VS Code, Obsidian e Adrenaline.

### Projeto de atualizacao de LLM - Model Manager 2.0

Objetivo: permitir que o usuario escolha o modelo e, no modo automatico, selecionar ou reutilizar o melhor modelo compativel sem travar a maquina.

Status: concluido no codigo, instalado neste computador e validado em desktop e celular.

Politica implementada nesta fase:

- O instalador mede RAM total, processadores, GPU identificada e disco livre.
- Antes de baixar, procura modelos gerais aprovados ja instalados e reutiliza o de maior classificacao compativel.
- Modelos de programacao, raciocinio especializado, experimentais e Gemma 4 E2B nao entram automaticamente.
- O usuario continua podendo instalar e ativar manualmente qualquer opcao marcada como compativel.
- Modo normal trabalha com ate 50% das threads; modo de agentes pode chegar a 70% com aviso.
- Proxima etapa MK-013 deve medir RAM disponivel, pressao de memoria, temperatura quando acessivel e latencia real para reduzir contexto, threads ou modelo durante o uso.

Catalogo inicial:

| Modelo | Runtime | Identificador | RAM conservadora | Download | Contexto | Uso |
|---|---|---|---:|---:|---:|---|
| Gemma 3 270M | Ollama | `gemma3:270m` | 4 GB | 0,3 GB | 32K | roteamento ultraleve |
| Qwen 3 0.6B | Ollama | `qwen3:0.6b` | 4 GB | 0,6 GB | 40K | conversa leve e ferramentas |
| Llama 3.2 1B | Ollama | `llama3.2:1b` | 6 GB | 1,4 GB | 128K | conversa e resumo |
| SmolLM2 1.7B | Ollama | `smollm2:1.7b` | 6 GB | 1,1 GB | 8K | tarefas curtas |
| Qwen 2.5 1.5B | Ollama | `qwen2.5:1.5b` | 7 GB | 1,0 GB | 32K | assistente geral estavel |
| Qwen 3 1.7B | Ollama | `qwen3:1.7b` | 7 GB | 1,4 GB | 40K | conversa, agentes leves e tools |
| DeepSeek R1 1.5B | Ollama | `deepseek-r1:1.5b` | 7 GB | 1,1 GB | 128K | raciocinio especializado |
| Qwen 2.5 Coder 1.5B | Ollama | `qwen2.5-coder:1.5b` | 7 GB | 1,0 GB | 32K | programacao leve |
| IBM Granite 3.3 2B | Ollama | `granite3.3:2b` | 8 GB | 1,5 GB | 128K | RAG, tools e codigo |
| Phi-4 Mini 3.8B | Ollama | `phi4-mini:3.8b` | 12 GB | 2,5 GB | 128K | matematica e instrucoes |
| Ministral 3 3B | Ollama | `ministral-3:3b` | 12 GB | 3,0 GB | 256K | opcao multimodal experimental |
| Qwen 3 4B | Ollama | `qwen3:4b` | 14 GB | 2,5 GB | 256K | geral avancado e agentes |
| Gemma 3 4B | Ollama | `gemma3:4b` | 16 GB | 3,3 GB | 128K | texto e imagem |
| Gemma 4 E2B | Ollama | `gemma4:e2b` | 16 GB | 7,2 GB | 128K | texto, imagem, audio e agentes |
| Gemma 4 E2B Mobile | LiteRT-LM | `gemma-4-e2b-qat-mobile` | depende do aparelho | cerca de 1,5 GB | 128K | piloto Android/iOS |

Nota Gemma 4:

- A documentacao oficial publicada em 8 de junho de 2026 apresenta E2B e E4B para ultra-mobile, edge e browser.
- E2B significa 2,3B parametros efetivos, mas 5,1B incluindo embeddings no pacote Ollama.
- O artefato Ollama `gemma4:e2b` ocupa aproximadamente 7,2 GB; por isso nao deve ser tratado como um modelo de 2 GB nem recomendado automaticamente para este PC de 8 GB.
- A versao mobile oficial usa LiteRT-LM e pesos QAT especificos. Ela exige aplicativo Android/iOS, benchmark por aparelho, controle de temperatura e bateria e nao e intercambiavel diretamente com o pacote Ollama.
- O Google estima cerca de 1,1 GB de memoria para a versao mobile multimodal e 0,84 GB para texto, mas isso nao inclui todo o aplicativo, sistema e variacao de hardware.

### Projeto MKC, Minike Coin e Compute Marketplace

Decisao de produto em 2026-06-15:

- `MKC` continua sendo credito interno de utilidade do ecossistema Minike, sem blockchain publica, sem saque, sem transferencia entre usuarios e sem promessa de valorizacao.
- A futura `Minike Meme Coin` pode ser preparada em testnet, mas venda publica, listagem, saque, custodia, transferencia economica e atendimento a usuarios dos EUA ficam bloqueados ate parecer juridico.
- Se houver moeda atrelada a valor forte, a primeira candidata recomendada e USD para uso SaaS internacional; `Minike Gold` fica como linha premium futura.
- Prata e cobre podem entrar depois. Bronze deve ser usado preferencialmente como nome de plano/badge, porque bronze e liga metalica e cria lastro mais confuso.
- Qualquer versao lastreada em USD, ouro, prata ou cobre exige reserva, custodia, auditoria independente, prova de reserva, termos de resgate, KYC/KYB, AML, privacidade, fiscal/contabil e auditoria de smart contract.

Arquivos oficiais desta frente:

- `crypto/DOCUMENTACAO_MINIKE_COIN.md`: checklist juridico, fases, tokenomics inicial e fontes.
- `crypto/minike_coin_policy.json`: politica executavel para bloquear lancamento publico antes das travas.
- `crypto/contracts/MinikeUtilityTokenDraft.sol`: rascunho Solidity apenas para testnet/auditoria futura, nao deployavel em mainnet sem autorizacao.
- `includes/compute_marketplace_policy.json`: politica do marketplace de processamento ocioso.
- `includes/minike_currency.php`: motor central de cotacoes, conversao, status de ativos e simulacao de repasse.
- `api/minike-currencies.php`: API controlada para subsites consultarem precos/status sem duplicar logica.
- `includes/minike_currency_widget.php`: widget reutilizavel de carteira/cotacao.
- `moedas.php`, `includes/mk_moedas.php` e `api/moedas-resgatar.php`: base atual de MKC interno.

Correcoes aplicadas nesta entrega:

- O resgate de MKC agora exige token CSRF e rate limit.
- O debito de MKC foi tornado atomico no banco para reduzir risco de gasto duplicado em requisicoes concorrentes.
- A tela de MKC informa que MKC e credito interno, nao investimento, nao criptoativo publico e nao promessa de saque/rendimento.
- Roadmap recebeu `MK-068` para Minike Coin regulada e separada do marketplace de processamento.
- Dinheiro real permanece ativo em planos, compra avulsa, gateways, boleto/Pix/cartao e faturas; token/credito e opcao adicional.
- O motor central consulta USD/BRL via Banco Central/PTAX, aceita CoinGecko para MIMI quando houver ID publico e exige provedor configurado para metais.
- Compute marketplace agora admite dois repasses: credito/token interno ou dinheiro real. Repasse em dinheiro exige contrato, KYC/KYB, dados fiscais, metodo aprovado e revisao antifraude.

Fontes regulatÃ³rias de partida:

- CVM Parecer de Orientacao 40: criptoativos podem estar sujeitos a regras de valores mobiliarios conforme estrutura, oferta e expectativa economica.
- Banco Central / Lei 14.478 / regulacao de ativos virtuais: servicos de ativos virtuais no Brasil exigem enquadramento e possivel autorizacao.
- FinCEN CVC guidance: modelos com valor virtual conversivel podem acionar obrigacoes de Money Services Business nos EUA.
- SEC Stablecoins statement: stablecoins referenciam ativo como USD ou ouro e dependem de estrutura de reserva, resgate e marketing.
- CFTC Digital Assets: ativos virtuais e mercados relacionados carregam riscos e podem entrar no campo de commodities.

### Roadmap executavel - melhorias priorizadas

#### Plataforma e governanca

- MK-001 [P0/F1/em andamento] Plano Diretor visual e registro unico de maturidade.
- MK-002 [P0/F1] Registro central de produtos, rotas, donos e dependencias.
- MK-003 [P0/F1] Feature flags por tenant, plano, pais e dispositivo.
- MK-004 [P0/F1] Fila central de trabalhos com retomada e idempotencia.
- MK-005 [P0/F1] Cofre unificado de segredos por tenant.
- MK-006 [P1/F2] Barramento de eventos Minike.
- MK-007 [P0/F1] Backup e restauracao guiados por produto.
- MK-008 [P1/F2] Central de configuracao e diagnostico.

#### Mike Local e experiencia

- MK-009 [P0/F2] Aplicativo desktop nativo com atualizador assinado.
- MK-010 [P1/F3] Companheiro Android e PWA pareado.
- MK-011 [P1/F2] Paleta universal de comandos.
- MK-012 [P0/F2] Central de notificacoes e aprovacoes.
- MK-013 [P0/F1] Governador adaptativo de CPU, RAM e GPU.
- MK-014 [P1/F2] Benchmark automatico de modelos por maquina.
- MK-015 [P1/F2] Caixa universal de arquivos e scanner.
- MK-016 [P1/F2] Acessibilidade e modo simplificado.
- MK-065 [P0/F1/concluido] Gerenciador de modelos 2.0 com escolha manual e deteccao automatica.
- MK-066 [P1/F3] Aplicativo movel on-device com Gemma 4 E2B.
- MK-069 [P0/F1/em andamento] Registro de capacidades multimodais e instalador progressivo.
- MK-070 [P0/F1/em andamento] Modulos opcionais multimodais com jobs visuais.

#### Memoria e conhecimento

- MK-017 [P1/F3] Canvas infinito compativel com JSON Canvas.
- MK-018 [P1/F3] Bases de notas com propriedades, tabelas e cards.
- MK-019 [P0/F2] Busca hibrida local com palavra-chave, vetor e reranking.
- MK-020 [P0/F2] Citacoes e proveniencia em toda resposta.
- MK-021 [P1/F3] Pesquisa profunda com plano, fontes e relatorio.
- MK-022 [P1/F3] Detector de lacunas de conhecimento.
- MK-023 [P1/F3] Sincronizacao incremental de fontes.
- MK-024 [P0/F2] Politica de memoria, esquecimento e retencao.
- MK-075 [P1/F3] Memoria de desenvolvimento estilo Obsidian ligada ao codigo.

#### Agentes e automacao

- MK-025 [P1/F3] Construtor visual de fluxos e agentes.
- MK-026 [P0/F2] Perfis de agentes portaveis em Markdown e YAML.
- MK-027 [P0/F2] Orquestracao multiagente com revisao cruzada.
- MK-028 [P0/F1] Sandbox de ferramentas e comandos.
- MK-029 [P1/F3] Registro MCP com permissao por ferramenta.
- MK-030 [P2/F4] Comunicacao agente-a-agente padronizada.
- MK-031 [P0/F2] Checkpoints, pausa e retomada de trabalhos longos.
- MK-032 [P1/F3] Laboratorio de evolucao com testes de regressao.
- MK-076 [P0/F3] Cluster multi-maquina Minike para dividir tarefas.
- MK-077 [P0/F2/em andamento] Observabilidade visual de agentes, maquinas e raciocinio operacional.

#### Programacao e desenvolvimento

- MK-033 [P1/F2] Editor Monaco com linguagem, minimapa e atalhos.
- MK-034 [P1/F3] Language Server Protocol e diagnosticos em tempo real.
- MK-035 [P0/F2] Git visual com diff, commit, branches e rollback seguro.
- MK-036 [P1/F3/concluido v1] Codex embutido por app-server oficial; aprovacoes visuais granulares e diff interativo avancado seguem como evolucao.
- MK-037 [P0/F2] Revisao de patch com aceitar, rejeitar e editar.
- MK-038 [P0/F2] Central de testes e cobertura.
- MK-039 [P1/F3] Ambientes isolados para projetos e dependencias.
- MK-040 [P0/F2] Pipeline de release, assinatura e deploy com rollback.
- MK-071 [P0/F1/em andamento] Cacador de bugs e testes do projeto.
- MK-072 [P0/F1/em andamento] Programar Studio Minike baseado em VS Code, Obsidian e Adrenaline.
- MK-073 [P0/F2] Agente de programacao com plano, patch, teste e revisao cruzada.
- MK-074 [P1/F3/em andamento] Mapa visual da base de codigo e dependencias; v1 textual/diagnostica integrada ao Programar Studio.
- MK-080 [P1/F3] Pontes Minike para VS Code, Obsidian e Adrenaline.

#### Negocios e atendimento

- MK-041 [P0/F2] Caixa omnichannel unificada.
- MK-042 [P0/F2] Handoff humano por confianca, intencao e risco.
- MK-043 [P1/F3] Visao 360 do cliente e da empresa.
- MK-044 [P1/F3] Agente de vendas, qualificacao e propostas.
- MK-045 [P1/F3] Estudio de campanhas e conteudo multicanal.
- MK-046 [P1/F3] Assistente financeiro empresarial.
- MK-047 [P1/F4] Pacote fiscal brasileiro supervisionado.
- MK-048 [P1/F3] Agente de estoque, precificacao e compras.

#### Monetizacao e comunidade

- MK-049 [P0/F2] Marketplace de skills com revisao e assinatura.
- MK-050 [P1/F4] Marketplace de agentes e fluxos prontos.
- MK-051 [P0/F2] Gateway BYOK com roteamento e fallback.
- MK-052 [P0/F2] Medicao de uso, orcamentos e alertas.
- MK-053 [P1/F2] Simulador transparente de plano e economia.
- MK-054 [P1/F3] Programa de afiliados, revendedores e desenvolvedores.
- MK-055 [P2/F3] Recompensa por anuncio com consentimento e limite.
- MK-056 [P1/F3] Loja de servicos Minike acionada por contexto.
- MK-067 [P1/F5] Minike Compute Marketplace para processamento ocioso da comunidade.
- MK-068 [P1/F5] Minike Coin regulada com MKC interno, meme coin testnet e linha lastreada futura.
- MK-078 [P1/F4] Marketplace seguro de extensoes e skills de programacao.

#### Seguranca, qualidade e conformidade

- MK-057 [P0/F1] Matriz de permissoes de agentes, skills e conectores.
- MK-058 [P0/F1] Defesa contra prompt injection e conteudo nao confiavel.
- MK-059 [P0/F2] DLP e redacao de dados sensiveis.
- MK-060 [P0/F2] Central de privacidade e direitos do titular.
- MK-061 [P0/F2] Auditoria imutavel e linha do tempo de agentes.
- MK-062 [P0/F2] Observabilidade de IA com custo, latencia e qualidade.
- MK-063 [P0/F2] Datasets de avaliacao e regressao por skill.
- MK-064 [P0/F2] Atualizacoes assinadas, SBOM e resposta a incidentes.
- MK-079 [P0/F2] Defesa de supply chain para Programar e skills.

### Ordem de execucao

#### Fase 1 - fundacao e protecao imediata

MK-001, MK-002, MK-003, MK-004, MK-005, MK-007, MK-013, MK-028, MK-057, MK-058 e MK-065.

Saida da fase: inventario confiavel, filas retomaveis, segredos fora do codigo, modelos compativeis, limites adaptativos e nenhuma ferramenta poderosa sem permissao explicita.

#### Fase 2 - produto vendavel e observavel

Memoria com fontes, agentes com checkpoints, editor com Git/testes, omnichannel com handoff, marketplace assinado, gateway BYOK, privacidade, DLP, auditoria, traces e datasets.

Saida da fase: jornadas pagas podem ser medidas, auditadas, cobradas e revertidas.

#### Fase 3 - experiencia avancada

Canvas/Bases, pesquisa profunda, app pareado, workflow visual, MCP, LSP, Codex embutido, CRM 360, vendas, campanhas, financeiro, estoque e piloto Gemma 4 mobile.

Saida da fase: workspace integrado para empresa e usuario, com recursos avancados liberados gradualmente.

#### Fase 4 - ecossistema ampliado

Agente-a-agente padronizado, marketplace de agentes, fiscal brasileiro supervisionado e releases empresariais.

Saida da fase: expansao somente depois de qualidade, seguranca, contratos e suporte sustentarem o volume.

#### Fase 5 - economia regulada e comunidade computacional

Compute marketplace, Minike Coin, token testnet, moeda lastreada, cash-out, transferencia entre usuarios, custodia e mercado secundario.

Saida da fase: nada financeiro com valor transferivel entra em producao sem parecer juridico Brasil/EUA, controles AML/KYC, auditoria, segregacao patrimonial, termos, antifraude, seguranca de chaves e plano de incidentes.

### Definicao de pronto

Uma melhoria so muda para `completed` quando:

1. O fluxo principal e pelo menos um fluxo de erro foram testados.
2. Desktop e celular foram verificados quando houver interface web.
3. Tenant, permissao, segredo, log e privacidade foram avaliados.
4. Existe rollback ou forma segura de desativar.
5. A documentacao mestre e o roadmap foram atualizados.
6. Integracao externa tem fonte oficial, credencial de teste e webhook/retorno verificado.
7. Nenhum texto de marketing afirma autonomia, seguranca, economia ou conformidade alem do que os testes provam.

### Validacao da primeira entrega do plano

- Mike Local `2.3.0-minike` instalada no computador de referencia com 7,9 GB de RAM e 4 processadores logicos.
- O modelo ja instalado `qwen2.5:1.5b` foi reutilizado; nenhum download desnecessario ocorreu.
- Simulacoes automaticas escolheram Qwen 3 0.6B em 4 GB, Granite 3.3 2B em 8 GB, Gemma 3 4B em 16 GB e Qwen 2.5 7B em 32 GB.
- Testes de reaproveitamento impediram que Gemma 4 E2B virasse escolha automatica em 8 GB e 16 GB.
- A API local retornou 23 opcoes totais, sendo 20 locais, com requisitos, fontes e compatibilidade.
- Captura real aprovou desktop `1440x1000` e celular `390x844`, 23 cartoes, 23 links de fonte, modelo ativo, Gemma 4 visivel e bloqueio seguro.
- Nao houve overflow horizontal nem erro JavaScript. Evidencias: `docs/evidencias-local-ai-20260614/desktop-modelos.png` e `mobile-modelos.png`.
- Publicacao seletiva concluida em `minike.com.br`, com backup anterior em `/home/u340626637/backups_codex/model_manager_before_20260614-220301`.
- Lint PHP remoto aprovado para o Painel Supremo e helper do roadmap.
- Instalador publico respondeu HTTP 200 e SHA-256 `B70E296EC429706664CA54D0D33A46EEBC86C25B4D7F0FD578322AC662ACC740`, identico ao arquivo local e ao servidor.

### Fontes primarias consultadas

- Google Gemma 4: https://ai.google.dev/gemma/docs/core
- Google Gemma 4 model card: https://ai.google.dev/gemma/docs/core/model_card_4
- Google mobile: https://ai.google.dev/gemma/docs/integrations/mobile
- Ollama Gemma 4 E2B: https://ollama.com/library/gemma4:e2b
- Ollama Qwen 3: https://ollama.com/library/qwen3
- Ollama Phi-4 Mini: https://ollama.com/library/phi4-mini
- Ollama Granite 3.3: https://ollama.com/library/granite3.3:2b
- Open WebUI: https://docs.openwebui.com/features/
- AnythingLLM agents: https://docs.anythingllm.com/features/ai-agents
- AnythingLLM scheduled jobs: https://docs.anythingllm.com/scheduled-jobs/overview
- Dify knowledge: https://docs.dify.ai/en/use-dify/knowledge/readme
- n8n human-in-the-loop: https://docs.n8n.io/advanced-ai/human-in-the-loop-tools/
- n8n evaluations: https://docs.n8n.io/advanced-ai/evaluations/overview/
- VS Code custom agents: https://code.visualstudio.com/docs/agent-customization/custom-agents
- VS Code MCP: https://code.visualstudio.com/docs/agent-customization/mcp-servers
- Obsidian Canvas: https://obsidian.md/help/plugins/canvas
- Obsidian Bases: https://obsidian.md/help/bases
- LiteLLM gateway: https://docs.litellm.ai/docs/simple_proxy
- Langfuse: https://langfuse.com/docs
- OWASP GenAI Top 10: https://genai.owasp.org/llm-top-10/
- NIST GenAI Profile: https://www.nist.gov/publications/artificial-intelligence-risk-management-framework-generative-artificial-intelligence
- LGPD: https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/L13709compilado.htm
- ANPD guia de seguranca: https://www.gov.br/anpd/pt-br/documentos-e-publicacoes/guia-vf.pdf
- CCPA: https://oag.ca.gov/privacy/ccpa
- FTC business guidance: https://www.ftc.gov/business-guidance

## 2026-06-14 - Mike Local 2.2: workspace limpo, assistente leve e ferramentas internas

### Entrega instalada e validada

- Mike Local `2.5.0-minike` instalada neste computador, porta loopback `47885`, modelo reutilizado `qwen2.5:1.5b` e aplicativo Edge em modo app com icone na area de trabalho, Menu Iniciar e inicializacao do Windows.
- Conversas basicas usam um roteador local leve antes da LLM. Cumprimentos, identidade, status, ajuda, data/hora, anotacoes e comandos financeiros nao carregam o modelo. O teste final `oi` respondeu em `193 ms` pelo modelo logico `mike-fast-local`.
- Correcao de UX local: botoes do catalogo de ferramentas nao usam mais `onclick` inline com aspas quebradas. Agora usam `data-url` e listener seguro em `toolsList`, com feedback de carregamento e fallback "Abrir externamente" quando iframe for bloqueado.
- Assistente pessoal local aceita exemplos como `anote que a conta vence dia 10`, `gastei R$ 35 no mercado`, `recebi R$ 2.000 de salario` e `resumo financeiro`. Notas ficam no cofre Markdown; transacoes ficam em `memory/personal-finance.json`, sem envio automatico para a internet.
- A chamada do chat tenta reconectar ao agente local antes de exibir erro e troca o texto tecnico `Failed to fetch` por uma orientacao compreensivel.
- Programar inicia em modo foco, com Explorador e Problemas recolhidos. Ambos podem ser abertos quando necessarios. O menu principal tambem e recolhivel e guarda a preferencia.
- O editor abre qualquer arquivo textual de ate 5 MB, inclusive `.htaccess` e extensoes desconhecidas. Binarios continuam bloqueados por deteccao de byte nulo/caracteres de controle.
- Autosave grava cerca de 850 ms depois da edicao e mostra `Alterado`, `Salvando` e `Salvo automaticamente`. O teste real abriu e salvou `.htaccess` preservando o mesmo SHA-256.
- `Editar com IA` mostra etapas verificaveis na tela, aplica a resposta progressivamente no editor, salva e executa o analisador. A interface mostra plano/acoes/resultados, nao raciocinio interno privado.
- O seletor de pasta do Programar foi separado do processo oculto do agente. Ele abre uma janela Windows visivel, no topo, e a pasta escolhida entra imediatamente como projeto restrito.
- A confianca exigida pelo Codex e explicada em modal visual. O usuario autoriza a pasta sem visitar o Terminal.
- Estado real do Codex em 2026-06-15: CLI oficial `0.140.0-alpha.2` detectado e autenticado com ChatGPT; o `codex app-server` esta embutido na aba Programar. A tela mostra sessoes por projeto, plano, atividade, comandos, arquivos alterados, resposta final e cancelamento. O terminal externo permanece apenas como alternativa.
- O bridge local usa JSONL por `stdio`, inicia `thread/start` ou `thread/resume` e depois `turn/start`. Opera com `workspace-write` e `approvalPolicy: on-request`. Dentro da pasta confiavel o trabalho segue automaticamente; internet, outra pasta ou permissao especial pausam a tarefa e abrem uma autorizacao visual na Mike.
- Memoria passou a se chamar `Memoria e notas`: cofre local, Markdown, propriedades `chave=valor`, busca ponderada em titulo/tags/propriedades/links/conteudo, filtros, links `[[nota]]`, backlinks, visualizacao, grafo e Canvas visual compativel com JSON Canvas. Bases tabulares avancadas, busca vetorial e retencao continuam no roteiro.
- Ferramentas Minike abrem em painel interno isolado. `/ferramentas/.htaccess` permite frame somente quando o `Referer` e `http://127.0.0.1:47885/` ou `localhost`; acesso externo e comum continua com `X-Frame-Options: SAMEORIGIN`.
- O Chromium confirmou o alvo isolado real `https://minike.com.br/ferramentas/catalogo.php` dentro da Mike em desktop e celular.
- Extrator B2B roda com Chromium headless e processos ocultos. A tela interna mostra configuracao, atividade, progresso, cancelamento e resultados locais.
- Leads coletados alimentam `results.jsonl`. A Mike exibe tabela pesquisavel/editavel, permite manter ou apagar registros e gera Excel ou PDF apenas sob demanda, usando a selecao revisada.
- Exportadores reais aprovados com um registro de teste: XLSX de `7.075` bytes e PDF de `42.313` bytes.

### Validacao desta compilacao

- PowerShell Parser, `-ValidateOnly`, `node --check` do coletor/exportador e instalacao `-SkipDependencies`: aprovados.
- `scripts/capture-local-ai-ui.mjs`: aprovado em `1440x1000` e `390x844`, sem overflow ou erro JavaScript.
- A auditoria confirmou 13 superficies, autosave, modo foco, menu recolhivel, modal de confianca Codex, cofre de memoria, formulario/tabela/exportacao de leads e ferramenta Minike carregada dentro do iframe isolado.
- Publicacao seletiva concluida em `minike.com.br` em 2026-06-14, com backup anterior em `/home/u340626637/backups_codex/local_ai_before_20260614-192503`.
- O instalador foi baixado novamente pela URL publica, apresentou o mesmo SHA-256 local/remoto `B623C67ECF4130A46FFAC4BDFB7826B34310919FD5F94A52F542A7C2841F4E77` e passou em `-ValidateOnly`.
- Downloads publicos do coletor, dependencias, exportador, instaladores Windows/Linux e desta documentacao responderam HTTP `200`.
- O catalogo incorporado respondeu sem `X-Frame-Options` para o referer local autorizado; referer externo continuou recebendo `SAMEORIGIN`.
- Pacote completo atualizado: `minike-atualizado-mike-local-2.2-20260614.zip`, com `4.196` entradas. O arquivo `.zip.sha256` ao lado e a fonte de verificacao de integridade para evitar uma referencia circular dentro do proprio pacote.
- A auditoria do ZIP confirmou todos os instaladores, coletor, exportador, documentacao e regra de frame; nenhuma entrada de `.env`, credencial Google, `config.local.php`, Git, `node_modules`, `.claude`, modelo GGUF, chave privada ou ZIP antigo foi incluida.
- Evidencias visuais permanecem em `docs/evidencias-local-ai-20260614/`.

### Estado real das integracoes

- **Funcional:** Ollama local, Ollama Cloud por conta do usuario, Codex app-server embutido em projeto confiavel, fallback CLI, Playwright local, ferramentas web Minike, memoria local, projetos/workspaces, terminal seguro, macros, agentes sequenciais e configuracao de Atendimento/WhatsApp.
- **Parcial:** aprovacoes visuais do Codex cobrem comandos, arquivos e permissoes; formularios experimentais de ferramentas/MCP ainda precisam de componentes proprios. Agentes mostram eventos e resultados, mas nao possuem autonomia irrestrita; WhatsApp depende do pareamento no Atendimento Minike.
- **Blueprint/configuracao pendente:** OpenRouter, GroqCloud, Together AI, webhooks multi-tenant, APIs do lojista, FlaUI e WinAppDriver. Cartao no catalogo nao significa credencial configurada nem integracao operacional.
- **Opcional nao instalado neste PC:** RustDesk. A Mike pode detectar/abrir o cliente oficial, mas nao habilita acesso desassistido.
- **Nao concluido:** aplicativo Android nativo/controlador pareado, Canvas avancado com grupos/zoom/lazy loading, revenda contratual de provedores e autonomia total de internet/arquivos. Essas entregas exigem fases proprias de seguranca, autenticacao e teste.

## 2026-06-14 - Meta Mike Workspace 2.1: macros e evolucao controlada

### Checkpoint final da entrega 2.1

- Concluido no codigo e instalado neste computador: Mike Local `2.1.0-minike`, porta `47885`, reutilizando o modelo compativel `qwen2.5:1.5b`.
- Concluido: armazenamento de macros, agenda manual/unica/intervalo/diaria/semanal/inicializacao, pausa global, historico, execucao unica por macro, inicio com Windows e endpoints locais.
- Concluido: tela responsiva de macros, editor pratico dos passos visuais, captura guiada de coordenadas, historico, laboratorio de evolucao e cartao de suporte remoto.
- Concluido: executor visual controlado para URL HTTPS, `.exe` dentro de projeto confiavel ou janela atual; passos de espera, clique, texto, atalho, captura e fechamento; evidencias PNG e relatorio Markdown.
- Concluido: laboratorio de variantes filhas com permissoes herdadas, quatro notas, media ponderada, tres avaliacoes minimas e promocao humana.
- Concluido: deteccao do RustDesk instalado e acesso ao release oficial quando ausente. A Mike nao cria senha nem ativa acesso desassistido.
- Concluido: integracao resiliente com o agente avancado de atendimento. O status local confirma autenticacao, worker ativo e sincronizacao com a base Minike.
- Pesquisado em fontes primarias: Playwright/Playwright MCP, FlaUI, WinAppDriver e RustDesk/RustDesk Server. A decisao registrada e reutilizar conectores oficiais e manter o executor leve como fallback.
- Deploy seletivo concluido em `minike.com.br`, com backup anterior em `/home/u340626637/backups_codex/minike_local_ai_pre_2_1_20260614_142422.tar.gz`.
- Validacao publica concluida em Chromium desktop, Android Pixel 7 e iPhone 13/WebKit: `9/9` jornadas da area de IA local aprovadas.
- O pacote final desta fase e `minike-atualizado-mike-workspace-2.1-macros-20260614.zip`, acompanhado de `.sha256`. Ele parte do pacote autocontido 2.0, recebe os arquivos 2.1 validados e exclui segredos, Git, `node_modules`, uploads, caches e alteracoes nao relacionadas em andamento.
- As ideias amplas anteriores de marketplace, agentes por area, modelos locais/cloud, conectores, WhatsApp, memoria, programacao, terminal e monetizacao permanecem descritas neste documento. Nem toda ideia de longo prazo esta implementada; roteiro continua separado de entrega comprovada.

### Evidencias desta entrega

- `scripts/test-local-ai-workspace.ps1 -SkipLive`: aprovado.
- `scripts/test-local-ai-workspace.ps1`: aprovado com modelo real, seguranca, macros, pausa, teste visual, variante, avaliacoes e promocao.
- `scripts/capture-local-ai-ui.mjs`: aprovado em `1440x1000` e `390x844`, nas 13 superficies verificadas, sem overflow horizontal nem erro JavaScript.
- O teste visual automatizado produziu captura e relatorio Markdown dentro do historico local, e o script de interface abriu um arquivo real na area Programar.
- PHP lint aprovado para a pagina local, API e catalogos; `git diff --check` aprovado.
- Manifesto publico confirma `2.1.0-minike`; instalador, pagina, health, catalogo de skills e skill oficial de programacao responderam corretamente.
- Evidencias visuais ficam em `docs/evidencias-local-ai-20260614/`.

### Objetivo e limites

- Adicionar macros locais persistentes para tarefas manuais, unicas, por intervalo, diarias, semanais ou ao iniciar o Mike.
- O agente local deve iniciar junto com o Windows para que lembretes e tarefas agendadas continuem funcionando depois de reiniciar o computador.
- Toda macro tem nome, acao permitida, agenda, estado, ultima e proxima execucao, quantidade de execucoes e historico detalhado.
- A tela oferece pausa global de emergencia. Enquanto pausada, nenhuma execucao automatica comeca.
- A primeira lista de acoes permitidas e fechada: lembrete local, abrir URL HTTPS, abrir aplicativo aprovado, abrir pasta de projeto, delegar tarefa para agentes, executar comando do terminal seguro e reproduzir teste visual guiado.
- O teste visual guiado abre somente URL HTTPS ou arquivo `.exe` dentro de projeto confiavel. A sequencia aceita espera, clique esquerdo/direito, texto fornecido, atalhos aprovados, captura de tela e fechamento do processo iniciado.
- Cada teste visual limita quantidade de passos, tempo de espera, coordenadas, tamanho de texto e atalhos. Capturas e relatorio Markdown ficam no historico local da execucao.
- O usuario pode montar um fluxo do zero ou usar a captura de coordenada com contagem regressiva para demonstrar um clique. Nao existe gravacao global continua de teclado, senha ou mouse.
- URL HTTP, executavel arbitrario, caminho fora de projeto, comando destrutivo, projeto nao confiavel e terminal sem aprovacao explicita permanecem bloqueados.
- Macros vindas de WhatsApp, webhook, skill da comunidade ou pagina externa nao recebem permissao de criar ou executar comandos locais por padrao.

### Evolucao de agentes e skills

- A ideia de criar "filhos melhores" sera implementada como laboratorio de variantes controladas, e nao como autorreplicacao irrestrita.
- Uma variante herda papel, skills, ferramentas e permissoes do agente pai. Criar uma variante nunca amplia permissoes automaticamente.
- Cada variante recebe um objetivo de melhoria e uma geracao, mantendo a arvore de origem.
- Avaliacoes registram qualidade, correcao, seguranca e eficiencia. A nota ponderada privilegia correcao e seguranca.
- Promocao exige no minimo tres avaliacoes, seguranca media de pelo menos 80, correcao media de pelo menos 75, nota final de pelo menos 80 e confirmacao humana explicita.
- Nenhuma variante se promove, cria processos, instala modelos, publica skill, acessa a internet ou altera arquivos por conta propria.
- O historico permite comparar variantes, arquivar candidatas ruins e reutilizar as aprovadas em trabalhos futuros.

### Componentes reutilizados e acesso remoto

- O repositorio Git local continua sem remoto configurado. Ele sera usado para auditoria privada; nenhum push ou publicacao de codigo/segredos sera feito sem autorizacao especifica.
- Testes web devem aproveitar o Playwright oficial da Microsoft, ja presente no projeto, com Chromium, Android emulado e WebKit/iPhone.
- Automacao estruturada de aplicativos Windows tera conectores para FlaUI e WinAppDriver. O executor simples por coordenadas permanece como fallback para jogos, canvas e interfaces sem arvore de acessibilidade.
- Suporte remoto usara integracao opcional com RustDesk oficial. A Mike apenas detecta, abre ou encaminha para o release oficial; nao cria senha, acesso desassistido ou conexao invisivel.
- Um servidor RustDesk proprio exige VPS/rede com portas adequadas e nao deve ser instalado na hospedagem compartilhada da Hostinger. A decisao de servidor, dominio, TLS, chaves, atualizacoes e politica de suporte fica para uma implantacao separada.
- Fontes primarias consultadas: `https://github.com/microsoft/playwright`, `https://github.com/microsoft/playwright-mcp`, `https://github.com/FlaUI/FlaUI`, `https://github.com/microsoft/WinAppDriver`, `https://github.com/rustdesk/rustdesk` e `https://github.com/rustdesk/rustdesk-server`.

### Criterios de aceite

1. Criar, editar, ativar, pausar, executar manualmente e excluir uma macro pela interface.
2. Persistir macros e historico em `%LOCALAPPDATA%\MINIKE-Local-AI`.
3. Bloquear URL sem HTTPS e terminal fora de projeto confiavel.
4. Mostrar proxima execucao, resultado, erro e horario em desktop e celular.
5. Criar variante, registrar avaliacoes e impedir promocao abaixo dos limites.
6. Promover somente com confirmacao humana e sem ampliar ferramentas ou skills.
7. Iniciar o agente com o Windows por atalho local do usuario.
8. Validar parser, API local, interface responsiva e fluxo funcional antes de gerar o ZIP.
9. Executar teste visual reproduzivel, salvar evidencias e relatorio sem sair do projeto autorizado.

## 2026-06-14 - Mike Workspace 2.0 instalado e validado

### Entrega funcional

- Versao instalada neste computador: `2.0.0-minike`, porta `47885`, modelo local reutilizado `qwen2.5:1.5b`.
- Conversas continuam opcionais em relacao a projetos. `Nova conversa` nao abre o historico anterior; conversas reabertas usam abas independentes e IDs inexistentes sao rejeitados, sem criar uma conversa misturada.
- Projetos podem ser agrupados em workspaces multi-root. Site, API, app e documentacao permanecem em suas pastas, mas podem alimentar a mesma conversa ou tarefa.
- Programar ganhou abas de arquivos de projetos diferentes, preservacao de conteudo ao trocar de aba, explorador, analise sintatica e revisao por modelo de codigo instalado.
- Areas novas: `Agentes`, `Modelos`, `Conectores`, `Terminal` e `Memoria`.
- Agentes salvos: Planejador, Pesquisador, Executor, Revisor e Validador. A execucao mostra eventos reais, agente atual, atividade, progresso, passagem de contexto e resultados expansivos. Modo equipe exige confirmacao e usa ate 70% da cota configurada para IA.
- A fundacao multiagente atual produz plano, pesquisa, proposta, revisao e validacao. Alteracao automatica de arquivos e execucao de ferramentas pelos agentes permanecem bloqueadas nesta fase; quando forem habilitadas, exigirao projeto confiavel, diff, teste e aprovacao/auditoria.
- Terminal seguro exige confianca explicita por projeto, restringe o diretorio, bloqueia metacaracteres/comandos destrutivos e permite apenas comandos internos e ferramentas aprovadas. Entradas de WhatsApp/webhooks nunca recebem terminal por padrao.
- Memoria local usa Markdown legivel, indice JSON, tags, links `[[nota]]`, backlinks, busca e grafo. Conversa so e copiada para a memoria por acao do usuario.
- Central de modelos lista instalados, compatibilidade e downloads controlados. Modelo de codigo pode ser diferente do geral; PCs limitados executam agentes sequencialmente.

### Ollama Cloud integrado pela Minike

- Botao `Entrar na Ollama Cloud` usa o fluxo oficial `ollama signin`; a Minike nao recebe senha da Ollama.
- O plano Free oficial pode atender uso leve e permite um modelo cloud simultaneo. Segundo a pagina oficial consultada em 2026-06-14, Pro oferece aproximadamente 50 vezes mais uso cloud que Free e Max cinco vezes o Pro, com limites por sessao de 5 horas e semana de 7 dias.
- A interface informa `Cloud integrado pela Minike` e deixa claro que o processamento e fornecido pela Ollama. Nao sera apresentado como servidor Minike.
- Chamadas guardam somente telemetria tecnica local: modelo, fornecedor, contagens de entrada/saida e duracao. Contagens de tokens nao sao exibidas como saldo financeiro porque a Ollama mede uso principalmente por GPU, modelo e duracao.
- Quando um modelo `:cloud` falha ou atinge limite, a Mike tenta automaticamente o melhor modelo local instalado e compativel.
- Preparar cloud baixa apenas o registro necessario pelo Ollama. Ativar um modelo e uma acao explicita do usuario.

### Receita e sustentabilidade

- O plano gratuito local permanece funcional e serve como aquisicao, demonstraÃ§Ã£o e utilidade real.
- Receitas permitidas: planos Minike, automacoes, agentes empresariais, suporte, implantacao, desenvolvimento personalizado, integracoes, marketplace de skills, comissao da comunidade e futuramente consumo cloud gerenciado por contrato.
- A Mike pode identificar oportunidade e mostrar plano, sistema ou servico da propria Minike, mas a oferta deve ser pertinente, identificada como comercial, posterior a resposta util e sem compra/contratacao automatica.
- Anuncios internos devem respeitar contexto, frequencia e plano. Recomendacao paga nunca pode parecer avaliacao neutra.
- Marketplace: criadores podem publicar skills gratuitas ou pagas; pagamento confirmado continua obrigatorio antes de liberar item pago. Comissao, repasse, impostos, chargeback e moderacao precisam constar na politica comercial antes de operacao publica.
- Ollama BYOK: cliente usa a propria conta/cota. A Minike cobra software e servico agregado. Modo gerenciado/revenda fica desativado ate permissao contratual escrita.

### Provedores, APIs e webhooks

- Provedores catalogados: Ollama Cloud (`integrated`), OpenRouter, GroqCloud e Together AI (`requires_credentials`). Todos usam conta/chave do cliente ate existir acordo empresarial.
- OpenRouter: API compativel com OpenAI, BYOK e creditos na conta; adequado para roteamento/fallback entre muitos modelos.
- GroqCloud: API compativel com OpenAI, camada Free publicada e inferencia rapida; adequado a tarefas interativas e transcricao.
- Together AI: API compativel com OpenAI, chaves por projeto e varios recursos de texto, visao, audio e modelos dedicados.
- O catÃ¡logo nao armazena chaves. A proxima fase deve usar cofre de segredos por tenant, teste de conexao e botao de revogacao.
- OpenAI Codex: a Mike detecta o CLI oficial, confere o estado de login e permite trabalhar dentro de um projeto confiavel, reutilizando a autenticacao e os limites do usuario. Nenhuma chave Codex e copiada para o projeto.
- A integracao embutida usa `codex app-server`, a interface oficial para clientes ricos. O transporte fica em `stdio` local, sem porta publica. Threads sao retomadas por projeto e os eventos oficiais alimentam o painel visual.
- Para automacoes menores, `codex exec --json` produz JSONL com eventos `thread`, `turn`, `item` e erros. Padrao de seguranca: leitura ou `workspace-write`; acesso total exige acao explicita e ambiente isolado.
- O contrato `minike-connector-v1` cobre provedores de IA, APIs do lojista, mensagens, redes sociais, pagamentos, email, calendario, armazenamento, automacao e webhooks.
- Webhooks de entrada: tenant, segredo por referencia, HMAC, timestamp, idempotencia, schema validado, rate limit e nenhuma permissao de terminal/arquivo/cobranca por padrao.
- Webhooks de saida: allowlist de destino, HMAC, timeout, retry exponencial, fila de erros, idempotencia, auditoria sem segredos e botao de desligar.
- Oportunidades comerciais catalogadas, ainda nao contratadas: Infercom reseller/channel, Vida Agent OS white-label e CustomGPT.ai white-label. O status visivel e `application_required` ou `commercial_review_required`.

### Testes e evidencias

- PowerShell Parser e `-ValidateOnly`: aprovados.
- `scripts/test-local-ai-workspace.ps1 -SkipLive`: aprovado, incluindo PHP/skills.
- `scripts/test-local-ai-workspace.ps1`: aprovado com LLM real, workspaces, modelos, agentes, memoria, terminal, conversa isolada, origem HTTP e travessia de caminho.
- Execucao real de agente unico: concluida em 19 segundos, 100%, cinco eventos persistidos.
- Execucao real da equipe completa neste PC: Planejador, Pesquisador, Executor, Revisor e Validador concluidos sequencialmente em cerca de 170 segundos, 100%, 13 eventos persistidos. O sequenciamento preservou recursos do computador.
- `scripts/capture-local-ai-ui.mjs`: aprovado em desktop `1440x1000` e celular `390x844`, sem overflow ou erro JavaScript; Programar abriu arquivo real e o analisador PowerShell ficou verde.
- Evidencias atualizadas em `docs/evidencias-local-ai-20260614/`.
- Limpeza `.claude`: `softwares/editor/.claude` removida. O conteudo antigo da raiz foi removido, mas o diretorio `.claude` foi recriado/bloqueado enquanto o VS Code mantinha o projeto aberto; nao encerrar o editor do usuario. Remover o diretorio vazio quando o handle for liberado.
- Pacote autocontido desta entrega: `minike-atualizado-mike-workspace-2.0-20260614.zip`, com arquivo `.sha256` ao lado. Inclui dependencias existentes (`vendor`) para nao exigir download na Hostinger; exclui `.env`, Git, `.claude`, caches, logs, uploads, `node_modules`, resultados de teste e backups temporarios.

### Fontes adicionais desta fase

- Ollama Authentication: `https://docs.ollama.com/api/authentication`.
- Ollama Cloud e pricing: `https://docs.ollama.com/cloud` e `https://ollama.com/pricing`.
- OpenRouter: `https://openrouter.ai/docs/quickstart`, `/guides/overview/auth/byok` e `/api/reference/limits`.
- GroqCloud: `https://console.groq.com/docs/overview`, `/openai`, `/rate-limits` e `https://groq.com/pricing`.
- Together AI: `https://docs.together.ai/docs/quickstart`, `/api-keys-authentication` e `/inference/openai-compatibility`.
- Programas publicados para analise comercial: `https://infercom.ai/partners/`, `https://vida.io/partners` e `https://customgpt.ai/white-label-ai-platform/`.
- Codex oficial: `https://developers.openai.com/codex/ide/`, `https://developers.openai.com/codex/app-server/`, `https://developers.openai.com/codex/sdk/` e `https://developers.openai.com/codex/noninteractive/`.

## 2026-06-14 - Meta Mike Workspace 2.0 e pesquisa de referencias

### Objetivo consolidado

Evoluir a Mike Local de um chat com editor para um workspace local modular, simples para iniciantes e expansivel para uso profissional. O produto deve reunir conversa, memoria, programacao, projetos compostos, modelos locais, agentes, terminal, skills, conectores e atendimento Minike sem misturar dados entre conversas, empresas ou pastas.

### Referencias estudadas e o que aproveitar

- **Obsidian:** notas locais em Markdown, links `[[nota]]`, backlinks, busca, propriedades, grafo e Canvas. Na Mike, a memoria deve continuar legivel fora do aplicativo, ter grafo e permitir transformar conversas e resultados de agentes em conhecimento revisavel.
- **VS Code:** workspace com uma ou varias pastas, abas de arquivos, explorador multi-root, tarefas, terminal, painel de problemas, extensoes e `Workspace Trust`. Na Mike, cada pasta adicionada inicia restrita; terminal, tarefas e agentes executores so funcionam depois de confianca explicita.
- **OpenClaw:** gateway local, muitos canais, ferramentas, skills, sessoes, roteamento multiagente, subagentes e conectores. Na Mike, aproveitar a conectividade, mas evitar acesso total por padrao, DM aberta, plugins sem verificacao e ferramentas de host liberadas para agentes publicos.
- **Hermes Agent:** memoria persistente limitada e curada, busca de sessoes, skills sob demanda, perfis independentes, delegacao e muitos toolsets. Na Mike, cada perfil/agente tera memoria, modelo, skills e permissoes proprias, com trilha de auditoria.
- **Ollama:** API local para listar, baixar e usar modelos. A central de modelos deve mostrar compatibilidade estimada com RAM/GPU, finalidade, tamanho aproximado e estado da instalacao; nenhum modelo grande sera instalado automaticamente sem confirmacao.
- **LangGraph/CrewAI e padroes de orquestracao:** planejamento, estado persistente, papeis especializados, revisao cruzada, checkpoints humanos, retomada e observabilidade. A primeira versao Mike usara um orquestrador proprio pequeno e auditavel, sem incorporar um framework pesado no instalador Windows.

### Principios obrigatorios

1. Conversas sao entidades independentes. Abrir uma conversa antiga nunca adiciona mensagens a outra; `Nova conversa` sempre comeca sem contexto anterior.
2. Projeto e conversa sao diferentes. Uma conversa pode usar zero, um ou varios projetos autorizados.
3. Workspace e uma colecao nomeada de partes: site, API, app, documentacao e outras pastas podem ser abertas juntas sem perder sua raiz individual.
4. Arquivos abertos ficam em abas e cada workspace preserva projeto, pasta, arquivo ativo e abas.
5. Toda execucao tem escopo: projeto, agente, ferramenta, comando, horario, resultado e aprovacao.
6. Pastas novas entram em modo restrito. Ler e editar texto pode ser permitido; terminal, tarefas, scripts e agentes executores exigem confianca explicita.
7. Terminal nunca fica disponivel para mensagens vindas de WhatsApp, canais publicos ou skills da comunidade sem politica e aprovacao especificas.
8. Skills da comunidade nao ganham shell, rede, credenciais ou escrita automaticamente. Devem declarar permissoes, fonte, versao, hash, autor e revisao.
9. Memoria nao significa contexto infinito. O sistema guarda conhecimento local, recupera apenas trechos relevantes e permite corrigir/esquecer.
10. Modelos sao escolhidos por capacidade e recursos: modelo geral, modelo de codigo e modelos auxiliares podem coexistir; em PCs limitados, os agentes trabalham sequencialmente.

### Arquitetura alvo

- **Workspace Manager:** workspaces multi-root, projetos conectados, confianca e estado de abas.
- **Conversation Manager:** historicos isolados, busca, favoritos, arquivamento e vinculos opcionais com workspaces.
- **Memory Vault:** Markdown, propriedades JSON/YAML, links, backlinks, grafo, pesquisa e origem de cada memoria.
- **Model Manager:** inventario Ollama, catalogo compativel, download controlado, modelo por finalidade e monitor de instalacao.
- **Agent Studio:** agentes salvos com papel, modelo, skills, ferramentas e limites; equipes com planejador, pesquisadores, executor, revisor e verificador.
- **Task Orchestrator:** plano, delegacao, dependencias, checkpoints, execucao, testes, revisao cruzada, relatorio e retomada.
- **Tool Gateway:** arquivos, terminal, web, ferramentas Minike, APIs do lojista e canais; cada ferramenta com escopo e politica.
- **Skill Hub:** skills oficiais, locais e da comunidade, com permissoes, assinatura/hash, compatibilidade e avaliacao.
- **Audit Center:** eventos de leitura, escrita, comandos, rede, ferramentas, agentes, modelos e aprovacoes.

### Ordem de execucao

- **Fase 1 - fundacao local:** conversas totalmente isoladas; workspaces com varias pastas; abas de projetos/arquivos; confianca por pasta; remocao de `.claude` obsoleto.
- **Fase 2 - operacao:** central de modelos Ollama; terminal seguro por projeto; tarefas conhecidas; logs e cancelamento.
- **Fase 3 - agentes:** Agent Studio; equipes; delegacao; revisao cruzada; execucao sequencial/paralela conforme hardware; modelos por papel.
- **Fase 4 - memoria:** notas, links, backlinks, busca e grafo; salvar conversa/resultado; memoria por usuario, empresa, workspace e agente.
- **Fase 5 - conectores:** APIs Minike/lojista, WhatsApp e redes sociais com scopes; navegador e pesquisa; webhooks; agenda; aprovacoes.
- **Fase 6 - ecossistema:** SDK de ferramentas/skills, comunidade, assinatura, verificacao, atualizacao, rollback e monetizacao.

### Riscos identificados nas referencias e melhorias Mike

- Agentes locais com acesso amplo transformam conteudo malicioso em comandos. Mitigacao: modo restrito, allowlists, confirmacao, escopo e auditoria.
- Extensoes/skills podem executar com os mesmos privilegios do aplicativo. Mitigacao: manifesto de permissoes, verificacao, quarentena e nenhuma instalacao silenciosa.
- Multiagentes podem consumir toda a maquina e entrar em ciclos. Mitigacao: limite de etapas, tempo, tokens, concorrencia, RAM/CPU e botao de cancelar.
- Memoria automatica pode guardar erro ou dado sensivel. Mitigacao: origem, nivel de confianca, revisao, expiracao e exclusao.
- Muitos modelos podem ocupar disco e RAM. Mitigacao: compatibilidade visivel, estimativa de espaco, download confirmado e descarregamento entre tarefas.
- Conectores de mensagens recebem entrada nao confiavel. Mitigacao: pareamento, allowlist, papeis sem terminal e transferencia para humano.

### Fontes primarias da pesquisa

- Obsidian Help: `https://obsidian.md/help/links`, `/plugins/backlinks`, `/plugins/graph`, `/plugins/canvas` e `/bases/syntax`.
- VS Code: `https://code.visualstudio.com/docs/editing/workspaces/multi-root-workspaces`, `/workspace-trust`, `/debugtest/tasks` e `/configure/extensions/extension-marketplace`.
- OpenClaw: `https://github.com/openclaw/openclaw` e `https://docs.openclaw.ai/` (multi-agent, tools, skills, sandbox e security).
- Hermes: `https://github.com/NousResearch/hermes-agent` e `https://hermes-agent.nousresearch.com/docs/` (memory, skills, profiles, toolsets e security).
- Ollama: `https://docs.ollama.com/api/` e catalogo oficial `https://ollama.com/library`.
- LangGraph e CrewAI: repositorios oficiais `langchain-ai/langgraph` e `crewAIInc/crewAI`.

### Estado inicial desta meta

- Meta persistente criada no Codex para sobreviver a continuacoes e quedas.
- Mike Local atual: `1.2.0-minike`, conversa sem projeto, historico local e editor Programar funcional.
- Lacunas confirmadas: nao ha workspace multi-root persistente, abas de arquivo, central visual de agentes, gestor de modelos, terminal ou cofre de memoria em grafo.
- Pastas obsoletas encontradas para remocao: `.claude/` na raiz e `softwares/editor/.claude/`; nao ha dependencia de runtime nelas.

### Ollama Cloud e modelo comercial Minike

- Em 2026-06-14, a Ollama publica planos Free, Pro (`US$ 20/mes` ou `US$ 200/ano`) e Max (`US$ 100/mes`); Team aparece como `coming soon` e exige contato.
- A cobranca publica nao e uma tabela fixa por token. O consumo considera principalmente tempo de GPU, tamanho do modelo, duracao e cache; existem limites por sessao/semana e saldo extra para Pro/Max.
- A API retorna `prompt_eval_count` e `eval_count`, uteis para telemetria, mas esses contadores nao equivalem diretamente ao custo cobrado pela Ollama.
- Os termos de maio de 2026 nao publicam permissao de reseller/white-label. Tambem proÃ­bem acesso automatizado sem permissao e uso do servico para desenvolver produto concorrente. Portanto, uma conta Ollama comum nao sera compartilhada ou revendida para clientes sem autorizacao escrita.
- **Modo BYOK/conta do cliente:** o cliente conecta a propria conta/chave Ollama; a Minike pode cobrar pelo software, automacoes, suporte, agentes, memoria e governanca, sem revender o consumo da conta.
- **Modo gerenciado Minike:** gateway central, medicao, cotas, faturamento e margem configuravel. Permanecera desativado ate contrato empresarial/reseller e revisao juridica/tributaria. A margem sugerida de 25% sera parametro comercial, nao valor fixo no codigo.
- O gateway de provedores sera neutro para permitir Ollama Cloud e outros provedores, com custo interno, preco de venda, margem, impostos, limite, alerta, bloqueio e trilha de cada chamada.
- Segredos de provedor ficam no servidor/cofre; nunca no navegador, skill ou agente local. Credenciais por lojista permanecem isoladas.
- Fontes oficiais: `https://ollama.com/pricing`, `https://ollama.com/terms`, `https://docs.ollama.com/cloud` e `https://docs.ollama.com/api/usage`.

## 2026-06-14 - Mike Local 1.2.0: conversa geral, historico e Programar

- O chat local nao exige mais projeto. A opcao padrao e `Conversa geral (sem projeto)`; projeto passa a ser opcional e usado apenas quando o usuario quer trabalhar com arquivos.
- Conversas sao salvas somente no computador em `%LOCALAPPDATA%\MINIKE-Local-AI\conversations`, com titulo automatico, reabertura, renomeacao, exclusao e limite de 100 conversas/200 mensagens por conversa.
- O menu lateral ganhou historico e botao `Nova conversa`, com layout responsivo para desktop e celular.
- Criada a area `Programar`, semelhante a um editor de codigo: escolha de projeto, explorador de pastas, editor com linhas, `Tab`, `Ctrl+S`, salvar e painel de problemas.
- A analise enquanto digita usa validadores locais e nao executa o codigo: PowerShell Parser, JSON Parser, `node --check`, PHP Lint, Python `compile`, verificacao estrutural de CSS/HTML e alerta de possiveis segredos.
- O botao `Revisar com a IA` usa a skill `programacao_oficial` para explicar erros, seguranca, qualidade e testes ausentes. A revisao e explicita para nao consumir a LLM a cada tecla.
- Acesso a arquivos continua restrito a pastas conectadas. Travessia de caminho, `.git`, `node_modules`, `.env`, chaves, tokens, senhas e credenciais permanecem bloqueados.
- A inicializacao foi corrigida para abrir a interface imediatamente usando cache local; catalogos online nao bloqueiam mais o instalador quando a internet esta lenta.
- Versao instalada e catalogada: `1.2.0-minike`, porta local `47885`, modelo atual neste PC `qwen2.5:1.5b`.

Validacoes desta entrega:

- `scripts/test-local-ai-workspace.ps1`: aprovado, incluindo conversa sem projeto, persistencia, renomeacao/exclusao e erro sintatico.
- `scripts/capture-local-ai-ui.mjs`: aprovado em 1440x1000 e 390x844, sem overflow horizontal nem erro JavaScript; editor abriu arquivo real e o PowerShell Parser nao encontrou erro.
- `php validate_site.php`: 1125 arquivos PHP, zero erros.
- Painel WhatsApp `scripts/test-local-agent-installer.js`: aprovado.
- Evidencias: `docs/evidencias-local-ai-20260614/desktop.png`, `mobile.png`, `desktop-programar.png` e `mobile-programar.png`.

Pacote desta rodada: `minike-atualizado-ia-local-workspace-20260614.zip`. O SHA-256 fica no arquivo sidecar de mesmo nome com extensao `.sha256`.

## Meta final alta

Entregar o ecossistema Minike completo, funcional, testavel e pronto para operacao real: site principal, admin supremo, checkout, pagamentos, webhooks, health/status, ferramentas, jogos, escolar, cursos, softwares, lojas, delivery, ads, atendimento, crescimento/lead engine, documentacao, seguranca, backup e deploy validados de ponta a ponta.

## Regras de continuidade

- Sempre atualizar este arquivo ao concluir uma correcao, descobrir risco, executar teste ou tomar decisao importante.
- Considerar este arquivo como memoria operacional antes de mexer no codigo.
- Nao depender de contexto de conversa: registrar aqui o que falta, o que foi feito, como testar e o resultado.
- Codigo ativo deve ser analisado sem confundir com vendor, cache, uploads, logs e backups .bak.

## Inventario rapido

- Projeto: ecossistema PHP modular com site principal, ferramentas, cursos, jogos, escolar, softwares, lojas, delivery, ads e APIs.
- Raiz analisada: \\srvtotali\Docs\PASTA COMPARTILHADA\Felipe\ia\minike.
- Documentacoes consolidadas neste arquivo: 11 fontes.
- Dependencias encontradas: ferramentas/composer.json, softwares/apyfy/package.json e vendor local em softwares/editor/vendor/.
- Git: repositorio local inicializado, sem remoto e sem commit inicial.

## Status de trabalho Codex

### 2026-06-14 - Inicio do projeto principal em softwares.minike.com.br

- Decisao tomada: `minike.com.br` passa a ser a base principal do ecossistema; `softwares.minike.com.br` sera o hub de sistemas empresariais; Galeria195 fica como produto/cliente dentro da estrategia.
- Subdominio conferido: `softwares.minike.com.br` responde HTTP 200 e aponta para `/home/u340626637/domains/minike.com.br/public_html/softwares`.
- Risco encontrado: a copia local nao esta igual a producao. Exemplo: `softwares/index.php` local tinha 71 bytes e a producao tinha 12027 bytes. Portanto, nao fazer deploy cego da pasta local.
- SeguranÃ§a: encontrados arquivos sensiveis/desnecessarios acessiveis por HTTP em producao, incluindo `.env.example`, `.claude/settings.local.json`, `composer.phar`, `composer-setup.php`, logs e arquivos `.sql`.
- Criados `.htaccess` na raiz e em `softwares/` para bloquear listagem, segredos, logs, SQL, backups, diagnosticos e pastas internas.
- `.env.example` removido do projeto local e ignorado pelo Git. Regra operacional: configuracao real fica no `.env`; documentacao descreve nomes das chaves sem valores reais.
- Corrigido `includes/log_system_novo.php` para nao chamar `env()` inexistente no handler global de excecoes e para iniciar sessao do dashboard apenas quando necessario.
- Criado smoke de seguranca em `scripts/minike-security-smoke.ps1` para garantir que URLs publicas continuam 200 e arquivos sensiveis retornam 401/403/404/410.
- Plano detalhado criado em `docs/PLANO_ACAO_SOFTWARES_MINIKE_2026-06-14.md`.
- Deploy de seguranca aplicado na Hostinger: `.htaccess` da raiz, `.htaccess` de `softwares/` e ajuste de `includes/log_system_novo.php`.
- Pasta `softwares/editor/` tinha `.htaccess` proprio e ainda deixava `api_errors.log` publico; foi corrigida com bloqueio local adicional.
- Quarentena remota criada em `/home/u340626637/backups_codex/minike_security_20260614_125244`; movidos para fora de `public_html`: `.env.example`, `composer.phar`, `composer-setup.php`, `COMANDOS_SSH.sh`, `INSTALL_FFMPEG_HOSTINGER.sh`, `INSTALL_SSH.sh`, `.claude/`, `ferramentas/.claude/` e `softwares/editor/.claude/`.
- Smoke de seguranca depois da limpeza: `minike.com.br/`, `api/health.php` e `softwares.minike.com.br/` retornaram 200; `.env`, `.env.example`, `.claude`, `composer.phar`, `composer-setup.php`, `log_viewer.php`, `teste-conexao.php`, `softwares/setup_db.sql`, `softwares/editor/api_errors.log` e `softwares/ponto/error.log` retornaram 403 ou 404.
- Politica de anuncios definida pelo Felipe: anuncios somente em plano gratuito, amostra gratis, demo ou ferramenta gratuita. `ads/engine.php` passou a bloquear AdSense, banners, fallback interno, pop/smartlink e smartlink em paginas institucionais, apoio, campanha, privacidade, termos e planos pagos.
- Deploy adicional: publicadas rotas `/local-ai/`, `/local-ai/skills.php`, `/local-ai/community.php`, `api/local-ai.php`, includes `local_ai_catalog/local_ai_skills`, `apoio.php`, `campanha.php` e `ads/engine.php`.
- Verificacao de producao: `/local-ai/`, `/local-ai/skills.php`, `/local-ai/community.php`, `/api/local-ai.php?action=manifest` e `/api/local-ai.php?action=skills-store` retornaram 200.
- Verificacao da politica de anuncios: `privacidade.php` e `campanha.php` nao carregaram `adsbygoogle`.
- Playwright desktop em producao apos deploy: 20/24 passaram. Pendencias reais: `/ferramentas/` ficou sem conteudo visivel para o teste, `/escolar/` retornou 500, `cursos` excedeu timeout no teardown e o crawler publico excedeu timeout. Continuar a correcao antes de declarar suite verde.

### 2026-06-14 - Diretriz Super Admin central

- Felipe solicitou um painel de Super Admin para controlar o projeto inteiro em `minike`, incluindo todos os subdominios, sistemas, lojistas, funcionarios, editores, clientes e usuarios comuns.
- Arquitetura alvo: uma hierarquia central com `super_admin` no topo, depois admins de sistema/subdominio, admins lojistas, funcionarios/atendentes, editores, clientes e usuarios normais.
- O painel deve unificar governanca, logs, auditoria, permissoes, status dos sistemas, acesso por papel, deploy/documentacao e revisao de sub-sites.
- Regra de trabalho: registrar tudo em Git e manter documentacao unica revisavel por site/sub-site.
- Proxima etapa tecnica: mapear `painel_mestre.php`, `painel_supremo.php`, `admin/`, `lojas/`, `softwares/`, `includes/admin_security.php`, `includes/check_login.php` e tabelas de usuarios/permissoes antes de criar telas novas.

### 2026-06-13 - Mike IA Local, loja de skills, comunidade e gateways PJ

- Criada a area publica `/local-ai/` para instalar a Mike IA Local em PCs de clientes sem WhatsApp, com comando PowerShell, download do instalador e link para UI local `http://127.0.0.1:47885/ui`.
- Criada a loja de skills em `/local-ai/skills.php`, com skills gratuitas e pagas. Skills pagas ficam bloqueadas ate pagamento confirmado; planos Business e Elite liberam todas as skills premium sem compra avulsa.
- Criada a area da comunidade em `/local-ai/community.php` e a pasta `community-skills/` com templates, regras, `pending/`, `published/` e `index.json`. A pasta bloqueia PHP e listagem via `.htaccess`.
- Criada a API publica `/api/local-ai.php?action=skills-store`, alem dos manifestos/catalogos existentes, sem expor segredos.
- O instalador `local-ai/mike-local-ai-minike.ps1` agora cria skills dinamicas conforme a necessidade real do cliente, pesquisa fontes permitidas, salva skills locais e expÃµe `/skills-store` na IA local.
- Corrigida a selecao antiga fixa de imposto no chat local; agora qualquer necessidade pode virar skill com pesquisadores, executor, revisor e documentador.
- `includes/local_ai_catalog.php` continua como fonte publica da IA local para ferramentas Minike, fontes autorizadas e regras de seguranca.
- `includes/local_ai_skills.php` centraliza catalogo de skills, busca por skill, planos com acesso total e regra de liberacao.
- `checkout.php` agora aceita `tipo=skill&skill=...`; compra avulsa de skill salva metadata e so libera entitlement depois de confirmacao.
- `includes/pagamentos_unificado.php` passou a liberar entregaveis de skill em `mk_skill_entitlements` e, se houver usuario logado, tambem em `licencas` como `skill_<id>`.
- Pix manual/Nubank PJ: gateway `pix_manual` gera copia-e-cola rapido quando `PIX_CHAVE` existe; como e Pix estatico/manual, exige aprovacao pelo Admin Supremo antes de liberar plano/skill.
- InfinitePay: mantido checkout oficial via `POST https://api.checkout.infinitepay.io/links`; por padrao nao envia dados do cliente para pre-preenchimento, reduzindo etapas extras.
- NuPay/Nubank: adicionado gateway `nupay`, configuravel por `NUPAY_MERCHANT_KEY`, `NUPAY_MERCHANT_TOKEN`, `NUPAY_ENVIRONMENT`. Cria checkout em `/v1/checkouts/payments`, usa link do app Nubank e confirma status `COMPLETED`.
- `api/webhook_pagamentos.php` agora entende Mercado Pago, InfinitePay e NuPay/Nubank e chama a mesma rotina de liberacao de skills apos pagamento aprovado.
- `pagamento/sucesso.php` agora reconhece retorno NuPay/Nubank por `pspReferenceId` e consulta status antes de mostrar aprovado.
- Admin Supremo ganhou aprovacao manual de pagamentos pendentes, campos de Pix direto, InfinitePay, NuPay/Nubank e opcao de priorizar Pix direto.
- SeguranÃ§a: adicionados bloqueios `.htaccess` em `cache/`, `cache/admin/` e `community-skills/`; segredos devem ficar no `.env` ou no painel protegido, nunca no catalogo publico/API local.
- `.env.example` atualizado com `INFINITEPAY_PREFILL_CUSTOMER`, `MINIKE_QUICK_PIX_FIRST`, `NUPAY_ENVIRONMENT`, `NUPAY_MERCHANT_KEY` e `NUPAY_MERCHANT_TOKEN`.

Configuracao operacional:

- Pix rapido PJ: preencher `PIX_CHAVE` e `PIX_TITULAR` no `.env` ou Admin Supremo. Depois de o cliente pagar, aprovar no Admin Supremo para liberar.
- InfinitePay: preencher `INFINITEPAY_HANDLE`; webhook recomendado: `https://minike.com.br/api/webhook_pagamentos.php`.
- NuPay/Nubank: preencher `NUPAY_MERCHANT_KEY` e `NUPAY_MERCHANT_TOKEN`; webhook/callback: `https://minike.com.br/api/webhook_pagamentos.php?gateway=nupay`.
- Tokens/senhas/certificados nao devem ser enviados para chat, catalogo publico, Git, API local ou `community-skills`.

Testes executados nesta etapa:

- `php -l` aprovado em `includes/local_ai_skills.php`, `api/local-ai.php`, `local-ai/skills.php`, `local-ai/community.php`, `checkout.php`, `includes/pagamentos_unificado.php`, `api/webhook_pagamentos.php`, `admin/painel_supremo.php`, `pagamento/sucesso.php`, `includes/planos_limites.php`.
- `php validate_site.php`: 1126 arquivos PHP verificados, 0 erros.
- `local-ai/mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies`: agente local parseavel.
- API `/api/local-ai.php?action=manifest`: retornou JSON valido.
- API `/api/local-ai.php?action=skills-store`: retornou 9 skills.
- Teste direto `MinikeGateway::gerar_pix_emv`: gerou EMV valido com 128 caracteres.
- Teste seguro NuPay sem credenciais: falhou de forma controlada, sem liberar nada.
- Teste seguro Pix manual sem chave: falhou de forma controlada, sem liberar nada.
- Playwright com servidor PHP local: `/local-ai/`, `/local-ai/skills.php`, `/local-ai/community.php` e `/checkout.php?tipo=skill&skill=tax_brazil_pro` passaram em desktop Chromium, Android Pixel 7 e iPhone 13 WebKit: 12/12.
- Playwright completo em todos os perfis foi tentado; a primeira execucao falhou por servidor local nao iniciado em UNC, e a segunda estourou o tempo do executor antes de gerar `test-results/results.json`. O smoke multiplataforma das rotas novas passou.
- ZIP seguro gerado em `\\srvtotali\Docs\PASTA COMPARTILHADA\Felipe\ia\minike-atualizado-local-ai-skills-gateways-20260613.zip` com 66,32 MB e 3896 entradas; exclui `.env`, `.git`, `node_modules`, `cache`, `logs`, `test-results` e `playwright-report`.

### 2026-06-11 - Consolidacao inicial

- Documentacoes soltas localizadas e unificadas neste documento mestre.
- Relatorios CSV de links quebrados foram mantidos como fonte consolidada para auditoria.
- Documentacao de bibliotecas de vendor e arquivos ads.txt foram excluidos da consolidacao principal por serem dependencia/publicidade, nao memoria do produto.
- Proxima etapa registrada: identificar comandos, rodar lint/testes, auditar pendencias e corrigir o que for seguro no codigo ativo.

### 2026-06-11 - Git local, auditoria inicial e PWA

- Repositorio Git local inicializado em minike, sem remoto configurado e sem commit inicial para evitar gravar segredo por acidente antes da auditoria completa.
- .gitignore reforcado para bloquear .env, config.local.php, uploads, cache, logs, backups, bancos locais, chaves/certificados, credenciais JSON, node_modules, vendor, softwares/editor/vendor, ferramentas/vendor e relatorios temporarios _missing_links*.csv.
- Pasta marcada como safe.directory no Git global do usuario local por estar em compartilhamento de rede.
- Stack confirmada: PHP 8.2.12, Node 24.14.1, npm 11.11.0; dependencia Node em softwares/apyfy/package.json; Composer em ferramentas/composer.json.
- Lint PHP executado no codigo ativo: 1119 arquivos, 0 erros.
- Checagem JS executada: node --check softwares/apyfy/main.js, 0 erros.
- Corrigido manifest.webmanifest, que estava invalido com apenas {; agora contem JSON PWA valido.
- Corrigido sw.js: removido import remoto de terceiro e criado service worker proprio com cache basico de shell.

### 2026-06-11 - Correcao de tokens e senhas fixas

- Removido token fixo antigo de ferramentas/verificar-integridade.php; agora exige MINIKE_INTEGRITY_TOKEN ou MINIKE_DIAGNOSTIC_TOKEN via .env.
- Protegido diagnose.php e diagnostico.php contra acesso publico sem token; agora exigem MINIKE_DIAGNOSTIC_TOKEN no .env quando acessados via web.
- Protegido ferramentas/diagnostico.php com o mesmo token de diagnostico.
- Removido fallback de senha administrativa publica em admin/painel_supremo.php; agora ADMIN_PASSWORD/ADMIN_PASS/MINIKE_ADMIN_PASSWORD precisa estar configurado.
- Removido fallback de senha administrativa publica em softwares/ponto/revenda_painel.php; agora exige ADMIN_PASSWORD.
- Atualizado .env.example com ADMIN_PASSWORD, MINIKE_DIAGNOSTIC_TOKEN e MINIKE_INTEGRITY_TOKEN.
- Busca pelo token antigo no codigo ativo nao retornou ocorrencias.

### 2026-06-11 - Correcao de instaladores e API sem credenciais previsiveis

- Corrigido api/ferramentas.php para nao derivar token admin de ADMIN_PASSWORD/[senha fraca antiga removida]; agora API_MASTER_TOKEN precisa estar configurado para acesso admin por token.
- Corrigido sites/install_db.php para carregar .env, usar DB_HOST e criar admin somente com SITES_ADMIN_EMAIL e SITES_ADMIN_PASSWORD.
- Corrigido sites/install_db.py para remover credencial MySQL real/hardcoded e ler DB_HOST, DB_USER, DB_PASS e DB_NAME do ambiente/.env.
- Instalador Python deixou de criar admin com hash incompatÃ­vel; a criacao de admin fica no instalador PHP seguro.
- Corrigido sql/auto_install.php para negar acesso web quando CRON_TOKEN estiver vazio e para criar admin somente com ADMIN_EMAIL e ADMIN_PASSWORD.
- Atualizado .env.example com ADMIN_EMAIL, API_MASTER_TOKEN, SITES_ADMIN_EMAIL e SITES_ADMIN_PASSWORD.
- .gitignore atualizado para ignorar __pycache__ e arquivos .pyc.
- Busca por credenciais padrao conhecidas e senha real removida: sem ocorrencias no codigo ativo analisado.

### 2026-06-11 - Limpeza adicional de scripts SSH e seeds SQL

- Removida senha real encontrada em COMANDOS_SSH.sh e INSTALL_SSH.sh; os scripts agora usam placeholder/ambiente.
- Removido seed de admin com hash conhecido de erp/setup_db.sql.
- Removidos seeds de admin com hash conhecido de delivery/setup_db.sql, cursos/setup_db.sql, games/setup_db.sql, softwares/setup_db.sql e sites/setup_db.sql.
- Repetida busca por [senha fraca antiga removida], [senha fraca antiga removida], hash [hash de senha padrao removido]..., senha real antiga e token [token fixo antigo removido] nos arquivos ativos principais; sem ocorrencias.
- bash -n nao foi executado porque o ambiente bloqueou WSL/Bash com acesso negado; os scripts devem ser testados em ambiente Linux/Hostinger antes de uso.
- .agent.md e .claude/ foram colocados no .gitignore para evitar versionar memoria/configuracao local de agentes.
- Composer nao esta instalado neste Windows; por isso ferramentas/vendor/autoload.php ainda nao foi gerado localmente. Deve rodar composer install em ferramentas/ no ambiente com Composer ou instalar Composer antes.
- Documentos-fonte raiz ja consolidados (planominike.md, memorias, dossies e guias) foram mantidos no disco, mas ignorados pelo Git; a unica documentacao .md rastreavel agora e DOCUMENTACAO_MESTRE_MINIKE.md.

## Pendencias e melhorias em aberto

- Revisar arquivos de instalacao/configuracao antes de qualquer commit inicial; alguns contem padroes sensiveis e devem usar .env/exemplos, nao valores reais.
- Avaliar se o service worker raiz deve ser registrado tambem no site principal ou apenas mantido disponivel.
- Rodar smoke test HTTP local/live de /api/health.php, /status/, /ferramentas/, /games/ e /checkout.php quando houver ambiente de banco acessivel.
- Confirmar que .env real possui ADMIN_PASSWORD, MINIKE_DIAGNOSTIC_TOKEN e MINIKE_INTEGRITY_TOKEN antes de publicar as alteracoes.
- Confirmar que .env real possui API_MASTER_TOKEN, ADMIN_EMAIL, SITES_ADMIN_EMAIL e SITES_ADMIN_PASSWORD quando esses fluxos forem usados.
- Testar COMANDOS_SSH.sh e INSTALL_SSH.sh em ambiente Linux/Hostinger, pois o ambiente local bloqueou bash.
- Instalar dependencias Composer de ferramentas/ para gerar ferramentas/vendor/autoload.php; check_hostinger_requirements.php acusa esse autoload como ausente.
- Resolver extensoes PHP ausentes no ambiente local/servidor conforme check_hostinger_requirements.php: curl obrigatoria; zip, gd, fileinfo e openssl recomendadas.

## Testes e verificacoes

- php -l em 1119 arquivos PHP ativos: aprovado, 0 erros.
- node --check softwares/apyfy/main.js: aprovado.
- JSON.parse em manifest.webmanifest: aprovado.
- node --check sw.js: aprovado.
- git check-ignore: confirmou bloqueio de .env, cache/, logs/, _missing_links_scan.csv, _atendimento_home.html, softwares/editor/vendor e ferramentas/google-credentials.json.
- php -l em ferramentas/verificar-integridade.php, diagnose.php, ferramentas/diagnostico.php, admin/painel_supremo.php e softwares/ponto/revenda_painel.php: aprovado.
- rg por [token fixo antigo removido] no codigo ativo: sem ocorrencias.
- php -l em api/ferramentas.php, sites/install_db.php e sql/auto_install.php: aprovado.
- python -m py_compile sites/install_db.py: aprovado.
- rg por [REMOVIDO - senha real antiga], [token fixo antigo removido], admin@minike.com.br/[senha fraca antiga removida] e password_hash de senhas padrao: sem ocorrencias no codigo ativo analisado.
- php validate_site.php: 1119 arquivos PHP verificados, 0 erros.
- check_hostinger_requirements.php: apontou pendencias de ambiente local, nao de parse: extensao curl ausente, zip/gd/fileinfo/openssl ausentes, FFMPEG_BIN nao definido, ferramentas/vendor/autoload.php faltando e conexao DB recusada localmente.
- composer --version em ferramentas/: falhou porque Composer nao esta instalado no ambiente local.

## Fontes consolidadas


---

## Fonte: DOCUMENTACAO_ECOSSISTEMA_MINIKE.md

# Documentacao do Ecossistema Minike

Atualizado em 2026-06-02.

## Visao Geral

O Minike e um ecossistema PHP com site principal e subsites conectados por includes compartilhados, banco unico/varios bancos auxiliares, checkout unificado, ferramentas, jogos, escolar, cursos, lojas, delivery e softwares.

O objetivo operacional atual e simples:

- Cliente usa a experiencia primeiro, sem excesso de anuncio antes da acao principal.
- Ferramentas de conversao liberam uso gratuito ate o limite configurado.
- Ao estourar limite, o usuario escolhe pagar/gerar QR Code ou assistir anuncio de recompensa.
- O administrador gerencia saude, logs, usuarios, licencas, planos, pagamentos, subsites e arquivos pelo Admin Supremo.
- Portugues/ingles e BRL/USD precisam continuar visiveis nos pontos de venda e no painel.

## URLs Principais

- Site principal: `https://minike.com.br/`
- Admin Supremo: `/admin/painel_supremo.php`
- Ferramentas: `/ferramentas/`
- Jogos: `/games/`
- Escolar: `/escolar/`
- Softwares: `/softwares/`
- Status publico: `/status/`
- Checkout: `/checkout.php`
- Webhook pagamentos: `/api/webhook_pagamentos.php`
- Health API: `/api/health.php`

## Arquivos Centrais

- `config.php`: bootstrap principal do site.
- `includes/db.php`: cria/conecta tabelas e estruturas do ecossistema.
- `includes/env_loader.php`: carrega variaveis do `.env`.
- `includes/pagamentos_unificado.php`: gateway Mercado Pago, InfinitePay Checkout e PIX manual.
- `includes/tool_monetization.php`: limites gratis/pagos das ferramentas e paywall visual.
- `includes/adaptive_growth.php`: motor de ofertas internas, recomendacoes contextuais, BRL/USD e widgets compactos.
- `api/lead_growth.php`: captura cliques/leads de ofertas internas e redireciona para o produto certo.
- `checkout.php`: tela para gerar PIX/checkouts.
- `planos.php`: planos comerciais com BRL/USD, testes gratis e links para checkout.
- `pagamento/sucesso.php`: confirmacao de pagamento e ativacao apos status aprovado.
- `api/webhook_pagamentos.php`: recebe webhook Mercado Pago e InfinitePay.
- `api/health.php`: health check geral com fallback por arquivos criticos quando snapshots ficam antigos.
- `status/index.php`: status publico que consome `/api/health.php`.
- `ads/engine.php`: motor de anuncios; push/pop ficam desativados por padrao.
- `ads/go10.php`: pagina de recompensa opcional por anuncio.
- `includes/header.php` e `includes/header-unificado.php`: navegacao global.
- `MEMORIA_ESTRATEGIA_CRESCIMENTO_MINIKE.md`: memoria fisica de precos, mercado, backlog e estrategia de crescimento.

## Admin Supremo

Arquivo: `admin/painel_supremo.php`.

Backups criados:

- `admin/painel_supremo.php.bak_20260602`
- `admin/index.php.bak_20260602`
- `admin/usuarios.php.bak_20260602`
- `admin/licencas.php.bak_20260602`

Atalhos antigos redirecionam para o Admin Supremo:

- `/admin/index.php` -> `/admin/painel_supremo.php`
- `/admin/usuarios.php` -> `/admin/painel_supremo.php#usuarios`
- `/admin/licencas.php` -> `/admin/painel_supremo.php#licencas`

Recursos do painel:

- Dashboard de receita, usuarios, licencas e pagamentos.
- Alternancia PT/EN e BRL/USD.
- Saude do servidor: PHP, disco, memoria, extensoes e permissoes.
- Subsites: principal, ferramentas, jogos, escolar, cursos, softwares, lojas, delivery, ads, atendimento.
- Usuarios: criar, bloquear, reativar e mudar papel.
- Licencas: criar, ativar, suspender e acompanhar vencimento.
- Pagamentos: resumo, gateway, status, valor e referencia.
- Planos: ajuste de preco BRL/USD e status.
- Monetizacao: InfinitePay, PIX manual, limites gratis e recompensa por anuncio.
- Logs: leitura e limpeza de arquivos selecionados.
- Publicacao/arquivos: leitura, edicao com backup automatico e atalhos.
- Alertas administrativos salvos em cache.

Arquivos de configuracao gerados pelo painel:

- `cache/admin/payment-settings.json`: gateway preferido, InfinitePay, PIX manual.
- `cache/admin/tool-monetization.json`: limites gratis/recompensa/precos das ferramentas.
- `cache/admin/admin-alerts.json`: alertas do painel.

## Monetizacao das Ferramentas

Arquivo central: `includes/tool_monetization.php`.

Padroes atuais:

- Arquivo unico gratis: `10 MB`.
- Lote gratis: `100 MB`.
- Recompensa por anuncio: libera `50 MB` por arquivo e `300 MB` por lote durante `60 minutos`.
- Anuncios antes do limite: desativado.
- Ao passar do limite: aparece paywall com botao para checkout ou recompensa por anuncio.

Ferramentas ja integradas ao limite:

- `ferramentas/conversor/imagem.php`
- `ferramentas/conversor/video.php`
- `ferramentas/video/compressor.php`
- Helpers de video em `ferramentas/video/_ffmpeg_helpers.php`
- Layout comum em `ferramentas/layout_ferramenta.php`

## Growth Engine e Ofertas Internas

Arquivos:

- `includes/adaptive_growth.php`
- `api/lead_growth.php`
- `cache/admin/growth-leads.jsonl` quando o banco nao estiver disponivel.
- Tabela `mk_growth_leads` quando o banco estiver disponivel.

Objetivo:

- Transformar uso gratuito em lead, plano, licenca ou venda cruzada.
- Mostrar o produto Minike certo no contexto certo.
- Manter ofertas leves, depois da experiencia principal, sem assustar o cliente.
- Trabalhar Brasil e EUA com preco BRL/USD.

Fluxos atuais:

- Ferramenta/conversor/PDF/imagem/video -> Ferramentas Pro e Sites.
- Calculadora/financeiro/cartao/custo -> Ponto e ERP Lite.
- Software/ERP/CRM -> Business Pack e Revenda.
- Escolar -> Escolar Familia e Escolar Escola.
- Games -> Games Pass e Jogos Educativos.
- Lojas/delivery/sites -> Loja, Delivery, Site e Ads interno.

Renderizacao:

- `mkGrowthCompactRender([...])` mostra o widget compacto.
- `mkAdaptiveGrowthRender([...])` agora renderiza compacto por padrao.
- Para o bloco antigo grande, usar `mkAdaptiveGrowthRender(['variant' => 'full'])`.

Rastreamento:

1. Usuario clica em uma oferta.
2. Link passa por `/api/lead_growth.php`.
3. O endpoint salva `offer`, `context`, `slot`, `next_url`, referer, user agent e hash do IP.
4. Usuario e redirecionado para o destino Minike.

Precos e mercado:

- Ver `MEMORIA_ESTRATEGIA_CRESCIMENTO_MINIKE.md`.
- Regra atual: Minike deve ficar perto de metade do custo da alternativa concorrente ou metade do custo do stack equivalente.
- Checkout brasileiro cobra em BRL; USD e referencia comercial ate ativar Stripe/PayPal ou outro gateway internacional.

Fluxo esperado:

1. Usuario abre a ferramenta diretamente.
2. Upload dentro do limite roda sem anuncio.
3. Upload acima do limite exibe opcoes.
4. Pagamento abre `/checkout.php?tipo=arquivo&valor=...`.
5. Recompensa abre `/ads/go10.php?reward=tools_100mb&link=...`.

## InfinitePay, PIX e Checkout

Configuracao pelo painel:

- Admin Supremo -> Monetizacao -> Pagamentos.
- Gateway preferido: `automatico`, `infinitepay`, `mercado_pago` ou `pix_manual`.
- InfiniteTag: handle da InfinitePay sem `$` ou `@`.
- Redirect URL: `https://minike.com.br/pagamento/sucesso.php`
- Webhook URL: `https://minike.com.br/api/webhook_pagamentos.php`
- PIX manual: chave e titular.

Configuracao por `.env`:

```env
INFINITEPAY_HANDLE=seu_handle_sem_arroba
INFINITEPAY_REDIRECT_URL=https://minike.com.br/pagamento/sucesso.php
INFINITEPAY_WEBHOOK_URL=https://minike.com.br/api/webhook_pagamentos.php
PIX_CHAVE=sua_chave_pix
PIX_TITULAR=Nome do Titular
```

Arquivos envolvidos:

- `includes/pagamentos_unificado.php`: cria link InfinitePay em `POST https://api.checkout.infinitepay.io/links`.
- `checkout.php`: mostra QR Code/link InfinitePay ou PIX manual.
- `api/webhook_pagamentos.php`: recebe `order_nsu`, `transaction_nsu`, `receipt_url` e aprova o pagamento.
- `pagamento/sucesso.php`: confirma status antes de ativar plano.

Observacoes importantes:

- InfinitePay usa `handle`, `redirect_url`, `webhook_url`, `order_nsu` e `items`.
- Precos da InfinitePay sao enviados em centavos.
- `order_nsu` e a referencia interna do pedido no Minike.
- O webhook e a forma principal de confirmacao; a pagina de sucesso tambem tenta validar quando recebe os parametros de retorno.

## Experiencia e Anuncios

Mudancas aplicadas:

- Ferramentas da home `/ferramentas/` abrem direto, sem `ads/go10.php` antes.
- Layout comum das ferramentas nao renderiza banners antes/meio/final.
- Jogos nao exibem bloco de rede/anuncio antes do catalogo ou antes do jogo.
- Acervos de imagem, PDF, documentos, planilhas e apresentacoes baixam direto.
- `ads/engine.php` nao injeta push/pop por padrao.
- `ads/go10.php` fica reservado para recompensa voluntaria.

Ainda existem classes CSS antigas chamadas `ad-space` em alguns acervos. Elas nao aparecem se nao houver bloco HTML usando a classe.

## Mapa de Pastas

- `admin/`: paineis administrativos e Admin Supremo.
- `api/`: endpoints de health, planos, ads, webhooks e integracoes.
- `ads/`: motor de anuncios, recompensas e painel de ads.
- `cache/admin/`: configuracoes JSON editadas pelo Admin Supremo.
- `cron/`: automacoes e rotinas de manutencao.
- `cursos/`: plataforma de cursos.
- `delivery/`: delivery, PDV, cozinha e motoboy.
- `escolar/`: escola, curriculo, provas, progresso e materias.
- `ferramentas/`: catalogo e ferramentas de conversao/calculo/desenvolvedor.
- `games/`: catalogo, ranking, jogos e Minike Games.
- `includes/`: bibliotecas compartilhadas do ecossistema.
- `lojas/`: marketplace/lojas.
- `pagamento/`: paginas de retorno de pagamento.
- `softwares/`: SaaS e apps.
- `status/`: status publico do ecossistema.
- `templates/`: modelos prontos.
- `webhooks/`: webhooks legados/especificos.

## Logs e Saude

Locais comuns:

- `logs/` quando existir.
- `cache/` para JSONs e caches internos.
- `webhook_logs` no banco para pagamentos.
- Admin Supremo -> Logs.
- Admin Supremo -> Saude.
- `/api/health.php` para checagem automatizada.

A health API considera snapshots em `cache/health`, mas tambem valida arquivos criticos por modulo. Se um snapshot estiver antigo e o arquivo principal do modulo existir, o modulo pode continuar como `ok` com `source=filesystem_fallback_after_stale_snapshot`.

Ao investigar erro:

1. Abrir Admin Supremo -> Saude.
2. Ver Admin Supremo -> Logs.
3. Conferir `api/webhook_pagamentos.php` se o pagamento nao ativou.
4. Conferir `cache/admin/payment-settings.json` se gateway/PIX estiverem errados.
5. Rodar `php -l arquivo.php` antes de publicar ajuste manual.

## Bilingue e Moedas

Pontos atuais:

- O Admin Supremo tem alternancia PT/EN.
- O Admin Supremo mostra BRL/USD com cotacao configuravel por `ADMIN_USD_BRL_RATE`.
- Planos exibem BRL/USD onde a estrutura de planos disponibiliza os valores.
- Ferramentas usam textos em portugues por padrao, com partes do catalogo ja preparadas para idioma.

Ao criar tela nova:

- Evite texto fixo espalhado; use helper/local de traducao quando o modulo ja tiver.
- Preco deve guardar valor base e exibir BRL/USD no frontend quando for venda.
- Em botoes de compra, manter `checkout.php` como entrada unica.

## Como Adicionar Nova Ferramenta

1. Criar arquivo dentro de `ferramentas/<categoria>/`.
2. Usar `ferramentas/layout_ferramenta.php` se for ferramenta comum.
3. Para upload/conversao, incluir `includes/tool_monetization.php`.
4. Chamar `mk_tool_check_upload_limits($_FILES, 'slug_da_ferramenta')` antes do processamento pesado.
5. Se passar do limite, renderizar `mk_tool_paywall_html(...)`.
6. Adicionar no catalogo em `ferramentas/index.php` ou estrutura local usada pela categoria.
7. Testar mobile, desktop, upload pequeno e upload acima do limite.

## Como Adicionar Novo Subsite

1. Criar pasta do subsite na raiz.
2. Incluir `config.php` ou bootstrap local equivalente.
3. Usar header/footer compartilhados quando fizer sentido.
4. Registrar link no Admin Supremo em `adm_default_buttons()` ou pela UI de atalhos.
5. Se tiver pagamento, usar `checkout.php` e `includes/pagamentos_unificado.php`.
6. Se tiver banco proprio, documentar variaveis `DB_NAME_<CHAVE>`, `DB_USER_<CHAVE>`, `DB_PASS_<CHAVE>`.
7. Adicionar o subsite na lista de health/links testaveis.

## Checklist de Teste Antes de Publicar

- `php -l` em todos os arquivos editados.
- Abrir `/` e confirmar status 200.
- Abrir `/ferramentas/` e clicar ferramenta sem pedÃ¡gio.
- Converter imagem pequena.
- Tentar arquivo acima do limite e confirmar paywall.
- Abrir `/games/`, `/games/colecao.php` e uma pagina de jogo.
- Abrir `/escolar/`.
- Abrir `/softwares/`.
- Abrir `/checkout.php` e gerar checkout/PIX de teste.
- Abrir `/status/` e confirmar leitura da health API.
- Abrir `/admin/painel_supremo.php` e verificar login/painel.
- Testar mobile e desktop.
- Verificar console/rede se a pagina quebrar visualmente.
- Conferir webhook/retorno depois de pagamento real.

## Deploy por SSH

Fluxo recomendado:

1. Fazer backup remoto antes de sobrescrever.
2. Enviar arquivos alterados.
3. Rodar `php -l` no servidor nos arquivos enviados.
4. Testar URLs publicas.
5. Confirmar que `cache/admin/` tem permissao de escrita.
6. Confirmar `.env` com variaveis de banco, InfinitePay/PIX e Mercado Pago.

Nunca publicar `.env` com senha em repositorio publico.

## Arquivos Alterados Nesta Repaginada

- `admin/painel_supremo.php`
- `admin/index.php`
- `admin/usuarios.php`
- `admin/licencas.php`
- `includes/tool_monetization.php`
- `includes/pagamentos_unificado.php`
- `checkout.php`
- `pagamento/sucesso.php`
- `api/webhook_pagamentos.php`
- `api/health.php`
- `ads/go10.php`
- `ads/engine.php`
- `ferramentas/index.php`
- `ferramentas/layout_ferramenta.php`
- `ferramentas/conversor/imagem.php`
- `ferramentas/conversor/video.php`
- `ferramentas/video/_ffmpeg_helpers.php`
- `ferramentas/video/compressor.php`
- `ferramentas/catalogo.php`
- `ferramentas/imagem/acervo.php`
- `ferramentas/pdf/acervo.php`
- `ferramentas/diversas/documentos.php`
- `ferramentas/diversas/planilhas.php`
- `ferramentas/diversas/apresentacoes.php`
- `ferramentas/meta999/tool.php`
- `ferramentas/meta999/module.php`
- `games/index.php`
- `games/colecao.php`
- `games/jogo.php`
- `games/minike/index.php`
- `includes/header.php`
- `includes/header-unificado.php`
- `.env.example`


---

## Fonte: MEMORIA_ESTRATEGIA_CRESCIMENTO_MINIKE.md

# Memoria de Estrategia e Crescimento Minike

Atualizado em 2026-06-02.

Este arquivo existe para sobreviver a compactacao de contexto. Sempre que a conversa resumir, retomar por aqui.

## Objetivo

Atrair cliente, reter cliente, gerar fidelidade e gerar lucro em todo o ecossistema Minike.

Regras de produto:

- O mercado e Brasil e EUA.
- Todo preco importante precisa ter BRL e USD.
- O checkout brasileiro atual cobra em BRL; USD e referencia comercial ate ativar gateway internacional.
- Usuarios devem testar antes de pagar.
- Anuncio pode existir, mas nao deve impedir a primeira experiencia util.
- Quando o usuario estoura limite, oferecer pagamento, recompensa por anuncio ou upgrade.
- Cada subsite deve puxar outro produto Minike de forma contextual.
- Toda ideia nova importante deve ser registrada aqui ou na documentacao principal.

## Mudancas Criadas Neste Ciclo

- `api/lead_growth.php`: captura clique de ofertas internas e grava em `mk_growth_leads` ou `cache/admin/growth-leads.jsonl`.
- `includes/adaptive_growth.php`: ganhou `mkGrowthCompactRender()`, `mkGrowthOffers()`, preco BRL/USD e links rastreados.
- `ferramentas/layout_ferramenta.php`: exibe oferta contextual apos a ferramenta, sem bloquear o uso.
- `planos.php`: refeito com BRL/USD, teste gratis e links diretos para checkout.
- `checkout.php`: preserva moeda escolhida, mostra referencia USD e cobranca BRL.
- `includes/planos_limites.php`: fallback de planos alinhado com estrategia comercial.
- `includes/db.php`: seed de planos novos alinhado para novas instalacoes.

## Matriz de Mercado

Valores pesquisados em 2026-06-02. Revisar antes de campanhas pagas, porque SaaS muda preco com frequencia.

### Ferramentas, Conversores e PDF

Concorrentes:

- Convertio: plano pago publico a partir de US$6.99/mes. Fonte: https://convertio.co/pricing/
- iLovePDF: pagina oficial de planos Premium/Business. Fonte: https://www.ilovepdf.com/pricing
- Adobe Express Premium: US$9.99/mes e teste de 30 dias. Fonte: https://www.adobe.com/express/pricing
- Canva Pro: US$144/ano no plano Pro individual. Fonte: https://www.canva.com/en/pricing/

Minike recomendado:

- Ferramentas Starter: R$19,90/mes ou US$3.90/mes, 14 dias gratis.
- Ferramentas Pro: R$49,90/mes ou US$9.90/mes, 14 dias gratis.
- Free generoso: 10 MB por arquivo e 100 MB por lote nas conversoes principais.

### CRM, Ponto, ERP e Software Empresarial

Concorrentes:

- Zoho CRM Standard: US$20/usuario/mes quando mensal, US$14/usuario/mes no anual. Fonte: https://www.zoho.com/sites/default/files/crm/zohocrm-edition-comparison-usd.pdf
- Pipedrive Lite: US$14/usuario/mes no anual, 14 dias gratis. Fonte: https://www.pipedrive.com/pricing/essential-crm
- Bitrix24 Basic: US$69/organizacao/mes mensal ou US$49/organizacao/mes anual. Fonte: https://www.bitrix24.com/prices/

Minike recomendado:

- Minike Ponto: R$19,90/mes ou US$3.90/mes, 30 dias gratis ate 5 funcionarios.
- ERP/CRM Lite: R$29,90/mes ou US$5.90/mes, 30 dias gratis.
- Business Pack: R$79,90/mes ou US$15.90/mes, 30 dias gratis.

### Lojas, Sites e Delivery

Concorrentes:

- Shopify Basic: US$39/mes mensal, US$29/mes anual; trial de 3 dias e promocao inicial. Fonte: https://www.shopify.com/pricing
- Nuvemshop Essencial: R$69/mes; Impulso R$164/mes; Escala R$449/mes. Fonte: https://www.nuvemshop.com.br/planos-e-precos
- Wix: planos pagos oficiais entre US$17 e US$159/mes, com garantia de 14 dias. Fonte: https://www.wix.com/blog/wix-premium-plans/

Minike recomendado:

- Loja/Delivery Starter: R$29,90/mes ou US$5.90/mes, 30 dias gratis.
- Loja + Site: R$49,90/mes ou US$9.90/mes, 30 dias gratis.
- Business Commerce: R$79,90/mes ou US$15.90/mes.

### Escolar, Cursos e Jogos

Concorrentes:

- ABCmouse: US$14.99/mes, 30 dias gratis. Fonte: https://support.abcmouse.com/hc/en-gb/articles/360048176173-What-are-the-subscription-plans-and-how-much-do-they-cost
- IXL familia: US$9.95/mes ou US$79/ano em pagina oficial localizada. Fonte: https://es.ixl.com/afiliacion/familiar/planes
- Apple Arcade: US$6.99/mes apos oferta promocional em termos oficiais. Fonte: https://www.apple.com/promo/pdf/EN_US_Arcade_Promo_TandCs.pdf

Minike recomendado:

- Escolar Familia: R$14,90/mes ou US$2.90/mes, 30 dias gratis.
- Escolar Escola: R$49,90/mes ou US$9.90/mes, piloto gratis para uma turma.
- Games Pass: R$14,90/mes ou US$2.90/mes, sessoes gratis antes de assinar.

## Ofertas Contextuais

Regras atuais do widget:

- Ferramenta/conversor/PDF/imagem/video: oferecer Ferramentas Pro e Sites.
- Calculadora/financeiro/cartao/custo: oferecer Ponto e ERP Lite.
- Software/ERP/CRM: oferecer Business Pack e Revenda.
- Escolar: oferecer Escolar Familia e Escolar Escola.
- Games: oferecer Games Pass e Jogos Educativos.
- Lojas/delivery/sites: oferecer Loja, Delivery, Site e Ads interno.

O clique sempre passa por:

`/api/lead_growth.php?offer=<produto>&context=<intencao>&slot=<local>&next=<destino>`

## Backlog de Sistemas Faltando

Alta prioridade:

- Gateway internacional em USD: Stripe ou PayPal para cobrar dolar real.
- Dashboard de leads internos no Admin Supremo usando `mk_growth_leads`.
- Funil unificado por visitante: origem, ferramenta usada, oferta clicada, checkout aberto, pagamento.
- Central de status publica em `/status/` ou `status.minike.com.br`.
- SSO/conta unica mais forte entre subdominios.
- Automacao de follow-up por email/WhatsApp apos clique em oferta.

Media prioridade:

- Biblioteca de conteudo SEO bilingue para cada ferramenta, jogo, materia e software.
- Central de templates e modelos pagos.
- Painel de afiliados/revenda com metas, links e comissoes mais visiveis.
- Licenca por produto com ativacao por dominio/dispositivo.
- API publica com planos por uso e dashboard de chaves.

Baixa prioridade:

- Pagina publica de roadmap.
- Base de conhecimento e changelog por subsite.
- Pacotes white-label por vertical: escola, loja, delivery, escritorio, criador.

## Proxima Acao Recomendada

1. Testar widget de oferta em ferramentas, jogos, escolar, softwares e lojas.
2. Criar visualizacao de leads internos no Admin Supremo.
3. Criar `/status/` com leitura da health API.
4. Preparar decisao de gateway internacional: Stripe vs PayPal.


---

## Fonte: planominike.md

# PLANOMINIKE UNIFICADO

> Consolidado automaticamente em 2026-05-17.
> Fonte Ãºnica de documentaÃ§Ã£o operacional do ecossistema Minike.

## SumÃ¡rio das Fontes Consolidadas

- planominike.txt
- MAPA_CENTRAL_MINIKE.md
- CORREÃ‡Ã•ES_E_MELHORIAS.md
- INDICE.md
- MINIKE_ACTIONS.txt
- RESUMO_EXECUTIVO_SESSAO_5.md
- pesquisa-concorrentes.md
- AGENTS.md
- ferramentas/AGENTS.md
- ferramentas/CHECKLIST_LIMPEZA.md
- ferramentas/FERRAMENTAS_CHECKLIST.md
- ferramentas/FERRAMENTAS_INVENTARIO.md
- ferramentas/MASTER_CHECKLIST.md
- ferramentas/README.md
- ferramentas/STATUS-SISTEMA.md
- ferramentas/tools_inventory_auto.md
- ferramentas/commit-message.txt
- includes/MARKETING_WIDGETS_README.md
- games/README.md
- games/minike/README.md
- sites/admin/notas.txt
- softwares/apyfy/README.md
- softwares/editor/SKILL.md
- softwares/editor/ui_kits/gerador/README.md

---

## Fonte: planominike.txt

# Plano Minike â€” Fonte de Verdade Ãšnica

> A partir de agora, `planominike.md` e `planominike.txt` sÃ£o os Ãºnicos arquivos de instruÃ§Ã£o de projeto a serem seguidos.
> Outros arquivos de instruÃ§Ã£o existem apenas como referÃªncia histÃ³rica e devem ser considerados obsoletos.

## 1. Status atual
- Projeto: Minike ecossistema completo.
- Banco unificado: `u340626637_minike`.
- Objetivo imediato: alimentar todos os sites com conteÃºdo e vitrine comercial.
- Meta 999: ferramentas, jogos, cursos, softwares e temas escolares.
- Idiomas: PortuguÃªs e InglÃªs.
- Moedas: BRL e USD.
- MonetizaÃ§Ã£o: ads leves, ads premium internos, planos e vendas diretas.

## 2. Fonte de verdade
- Arquivo mestre: `planominike.md`.
- VersÃ£o espelho: `planominike.txt`.
- Usar estes arquivos sempre antes de editar qualquer outro cÃ³digo.
- Atualize ambos imediatamente apÃ³s qualquer mudanÃ§a.

## 3. Regras prioritÃ¡rias
1. ConteÃºdo primeiro: criar pÃ¡ginas, descriÃ§Ãµes e ofertas antes de corrigir bugs.
2. Produtos visÃ­veis: mostrar ferramentas, jogos, cursos, softwares e temas escolares.
3. Identidade visual: aplicar tema uniforme e branding Minike em todos os subdomÃ­nios.
4. Banco unificado: todos os subdomÃ­nios devem usar `u340626637_minike` e `.env`.
5. Sem senhas no cÃ³digo: mover credenciais para `.env` e `env_loader.php`.

## 4. MissÃ£o imediata
- Criar conteÃºdo comercial para todos os subdomÃ­nios.
- Aumentar o catÃ¡logo para 999 itens em cada Ã¡rea prioritÃ¡ria.
- ReforÃ§ar a navegaÃ§Ã£o entre sites com anÃºncios internos e recomendaÃ§Ãµes de produtos.
- Priorizar amostras grÃ¡tis e ofertas de upgrade.
- Colocar valores claros em BRL/USD.

## 5. Principais Ã¡reas de foco
### Ferramentas
- AlcanÃ§ar 999+ ferramentas com categorias: texto, imagens, SEO, dados, finanÃ§as, marketing, utilidades.
- Criar landing page de vitrine com CTA para planos premium.
- Promover `softwares` e `cursos` como upgrades naturais.

### Games
- Estruturar catÃ¡logo e criar jogos com descriÃ§Ãµes, categorias e funcionalidades de ranking.
- NÃ£o colocar ads dentro da jogabilidade; ads apenas em abertura de tela e seÃ§Ãµes de vitrine.
- Implementar moedas internas, badges e versÃµes premium.

### Cursos
- Criar trilhas e cursos com aulas, materiais e certificados.
- Categorias: desenvolvimento, design, negÃ³cios, tecnologia, educaÃ§Ã£o e hobbies.
- Oferecer planos grÃ¡tis e pagos.

### Softwares
- Vender produtos, automaÃ§Ãµes e serviÃ§os empresariais.
- Estruturar pacotes: SaaS, integraÃ§Ãµes, consultoria e customizaÃ§Ãµes.
- Usar `softwares.minike.com.br` como portal de venda principal.

### Escolar
- Criar temas e atividades para escolas e professores.
- Oferecer materiais didÃ¡ticos, simulados e pacotes de conteÃºdo.
- Priorizar volume com 999 temas/atividades.

### Lojas
- Criar hub de mini-sites para clientes.
- Mostrar modelos, preÃ§os e formas de personalizaÃ§Ã£o.
- Incluir painel para gerenciar preÃ§os e afiliados.

## 6. Painel administrativo e monetizaÃ§Ã£o
- Criar painel centralizador para:
  - preÃ§os e planos
  - anÃºncios internos
  - afiliados e comissÃµes
  - mÃ©tricas de uso
  - correÃ§Ã£o de temas e limpeza de duplicados
- Planos sugeridos:
  - Free + ads leves
  - BÃ¡sico (100 MB) + ads reduzidos
  - Pro (500 MB) + menos ads
  - Elite (2 GB) + sem ads premium
- Pagamentos: Mercado Pago, InfinitPay, PIX e integraÃ§Ãµes futuras.

## 7. Temas e identidade visual
- Aplicar tema uniforme com `site_theme_helpers.php` e `tema_css.php`.
- Todos os sites devem usar variÃ¡veis CSS em vez de cores fixas.
- Criar hero section com o tema ativo em cada subdomÃ­nio.
- Garantir que Minike seja reconhecÃ­vel pelo visual e pelos blocos de conteÃºdo.

## 8. Itens tÃ©cnicos essenciais
- Usar `.env` para credenciais.
- Criar `.env.example` e `.gitignore` para proteger o arquivo de ambiente.
- Cada `config.php` deve apontar para `u340626637_minike`.
- Criar `env_loader.php` se ainda nÃ£o existir.
- Implementar auto-criaÃ§Ã£o de tabelas quando necessÃ¡rio.
- Limpar arquivos duplicados e obsoletos em paralelo.

## 9. InstruÃ§Ãµes consolidadas
- A partir de agora, ignore os seguintes arquivos como diretrizes principais:
  - `INSTRUCOES_PARA_PROXIMAS_IAS.md`
  - `INSTRUCOES_MINIKE.md`
  - `INSTRUCOES_LOCALIZAR_GERADOR_TEMPLATES.md`
- Esses arquivos ainda podem ser lidos para histÃ³rico, mas **nÃ£o sÃ£o mais a fonte de verdade**.
- O plano oficial estÃ¡ aqui, e todas as tarefas devem ser registradas e atualizadas aqui.
- Existe um agente personalizado de suporte: `.agent.md` (Minike Empire Builder).
- Consulte tambÃ©m `AGENTS.md` para instruÃ§Ãµes de uso do agente no workspace.

## 10. Resultado esperado
- Um ecossistema Minike com conteÃºdo comercial claro.
- 999 itens em ferramentas, jogos, cursos, softwares e escolar.
- NavegaÃ§Ã£o interna entre sites com anÃºncios e promoÃ§Ãµes alinhadas.
- Banco unificado e tema consistente.
- Pagamentos e ofertas visÃ­veis.

## 11. PrÃ³ximas aÃ§Ãµes para este ciclo
- [x] Verificar e atualizar `config.php` de cada subdomÃ­nio. (Auditoria concluÃ­da: todos apontam para o banco unificado e usam auto-criaÃ§Ã£o de tabelas quando necessÃ¡rio.)
- [ ] Publicar conteÃºdo em `ferramentas`, `games`, `cursos`, `softwares`, `escolar`.
- [ ] Adicionar cross-sell entre subdomÃ­nios.
- [ ] Atualizar `planominike.md` e `planominike.txt` apÃ³s cada alteraÃ§Ã£o.
- [ ] Localizar o gerador Fabric.js fora do workspace e sÃ³ entÃ£o corrigir o bug de template.

## 12. Nota sobre o gerador de placas Fabric.js
- O cÃ³digo original do gerador de placas nÃ£o estÃ¡ presente neste workspace.
- Quando encontrado, ele deve ser importado para `lojas/` e documentado aqui.
- AtÃ© lÃ¡, o foco Ã© conteÃºdo e monetizaÃ§Ã£o.

## 13. Consolidacao final de instrucoes (15/05/2026)
- Este arquivo (`planominike.md`) e o espelho (`planominike.txt`) sao a unica fonte de verdade operacional.
- Todos os arquivos de instrucao/projeto abaixo foram consolidados neste plano e ficam apenas como historico:
  - `CORREÃ‡Ã•ES_E_MELHORIAS.md`
  - `DEPENDENCIAS.md`
  - `INDICE.md`
  - `INSTALACAO_HOSTINGER.md`
  - `INSTRUCOES_LOCALIZAR_GERADOR_TEMPLATES.md`
  - `INSTRUCOES_MINIKE.md`
  - `INSTRUCOES_PARA_PROXIMAS_IAS.md`
  - `LEIA_PRIMEIRO.md`
  - `MAPA_CENTRAL_MINIKE.md`
  - `MINIKE_ACTIONS.txt`
  - `QUICK_START.md`
  - `README_INSTALACAO.md`
  - `RESUMO_EXECUTIVO_SESSAO_5.md`
  - `RESUMO_INSTALACAO.md`
- Regra permanente: qualquer nova diretriz, mudanca de escopo, roadmap ou decisao tecnica deve ser registrada primeiro aqui e espelhada no `.txt`.

## 14. Progresso desta execucao (15/05/2026)
- Auditoria de `config.php` concluÃ­da: todos os 14 arquivos usam `u340626637_minike` e carregam `includes/db.php` ou fallback seguro.
- Foco mantido em conteudo primeiro, conforme regra principal.
- `includes/meta999_content.php` expandido com:
  - `mkMeta999ToolSeeds(240)` para vitrine de ferramentas.
  - `mkMeta999SchoolSeeds(120)` para trilhas de reforco escolar PT/EN.
- `ferramentas/catalogo.php` atualizado:
  - integrado ao motor meta999;
  - nova categoria `meta999` com itens gerados e status `ativo/breve`.
- `escolar/index.php` atualizado:
  - nova secao "Meta999 Reforco (PT/EN)" com 120 trilhas e status visual.

### Proximas execucoes diretas
1. Criar paginas-base para um lote de ferramentas `meta999_*` para reduzir 404 da vitrine.
2. Aumentar gradual de itens `ativo` por categoria em ferramentas.
3. Persistir seeds no banco unico para gestao via admin.

## 15. Progresso desta execucao 2 (15/05/2026)
- 404 da vitrine Meta999 reduzido com pagina-base unica para ferramentas de expansao.
- `ferramentas/catalogo.php` ajustado: itens da categoria `meta999` agora apontam para rota funcional compartilhada.
- Novo arquivo criado: `ferramentas/meta999/tool.php`.
  - exibe amostra free com ads leves;
  - mostra upgrade premium sem anuncios;
  - suporte PT/EN + BRL/USD no card de oferta.

### Estado atual
- Fluxo "conteudo primeiro" mantido e operacional.
- Proximo alvo: criar mais paginas-base por vertical (PDF, imagem, SEO) com CTA de conversao.

## 16. Progresso desta execucao 3 (15/05/2026)
- Catalogo de ferramentas blindado contra links quebrados.
- `ferramentas/catalogo.php` agora valida existencia fisica do arquivo para itens `ativo`.
- Se arquivo nao existir, redireciona automaticamente para fallback funcional: /ferramentas/meta999/tool.php?slug=...&src=missing.
- Resultado: experiencia continua, sem 404 na vitrine de expansao.

## 17. Progresso desta execucao 4 (15/05/2026)
- Fallback de ferramentas evoluido para contexto por vertical.
- `ferramentas/catalogo.php` agora envia parametro `module` no fallback automatico de links ausentes.
- `ferramentas/meta999/tool.php` passou a reconhecer vertical (`pdf`, `imagem`, `seo`, `texto`, `calculo`, `converter`) e renderizar modulo contextual com icone/rotulo.
- Resultado: pagina de fallback mais relevante para conversao comercial e continuidade de navegacao.

## 18. Progresso desta execucao 5 (15/05/2026)
- Criada pagina-base por vertical para ferramentas Meta999:
  - `ferramentas/meta999/module.php`
- Essa pagina organiza a oferta por modulo (`pdf`, `imagem`, `seo`, `texto`, `calculo`, `converter`) com:
  - mensagem comercial PT/EN;
  - referencia de preco BRL/USD;
  - CTA para upgrade premium.
- `ferramentas/meta999/tool.php` integrado com link para o catalogo do modulo.
- Resultado: fallback agora funciona em dois niveis (ferramenta -> modulo), melhorando navegacao e conversao.

## 19. Benchmark concorrentes e lacunas

### Fontes de referencia analisadas
- 4Devs: geradores, validadores, documentos de pessoas, nicks, certidoes, conta bancaria, corretor ortografico.
- iLovePDF: merge, split, compress, convert, edit, sign, unlock, repair, OCR, watermark, page numbers, compare, web to PDF.
- PDF24: toolbox muito extensa, app desktop, processamento em lote, criar/editar/proteger/ordenar/optimizar PDFs.
- Smallpdf: edicao de PDF, organize, sign, compress, share links, save to cloud.
- remove.bg: remocao automatica de fundo, API, desktop, lote, Magic Brush, background templates.
- Canva: templates massivos, presentacoes, docs, sheets, whiteboards, websites, social, resumes, certificates, invoices.
- Alura/Udemy: trilhas, carreiras, certificados, mentorias, comunidade, analytics, marketplace de cursos.

### Diagnostico local de ferramentas
- Total de entradas no catalogo: 257.
- Ferramentas `ativo` sem arquivo fisico local: 57.
- Falta principal por modulo:
  - `gerador`: 8
  - `imagem`: 7
  - `pdf`: 6
  - `texto`: 6
  - `calculo`: 5
  - `educacao`: 4
  - `social`: 3
  - `converter`: 3
  - `desenvolvedor`: 3
  - `matematica`: 2
  - `data_hora`: 2
  - `seo`: 2
  - `negocios`: 2
  - `design`: 1
  - `seguranca`: 1
  - `financeiro`: 1
  - `saude`: 1

### Lacunas prioritarias por area
- Ferramentas:
  - Gerador de pessoas completo, nicks, letras diferentes, simbolos para copiar.
  - Conta bancaria, empresas, certidoes, validadores adicionais.
  - PDF suite completa igual iLovePDF/PDF24.
  - Remocao de fundo tipo remove.bg.
  - Templates visuais e export em lote.
- Cursos:
  - Trilhas, carreiras, certificados, mentorias, comunidade, projetos, quizzes, progresso.
  - Grade PT/EN com preco BRL/USD e pagina de planos clara.
- Games:
  - Ranking, conta de jogador, moedas, conquistas, catalogo 999, pagina de abertura com ads leves.
  - Sem anuncios dentro da jogabilidade.
- Softwares:
  - Biblioteca 999 de produtos, trials, licencas, demos, comparativos, tabela de planos e upsell.
  - Pagina para resellers e afiliados.
- Escolar:
  - 999 atividades, simulados, gabaritos, certificados, trilhas por serie, dashboards para aluno/professor.
- Lojas:
  - Templates de loja, importacao de produtos, checkout, frete, cupom, avaliacao, PDV, delivery e afiliados.
- Delivery:
  - Cardapio QR, cozinha, motoboy, rota, pedidos externos, fidelidade, estoque, comissao e multiunidade.
- Atendimento:
  - Inbox omnichannel, chatbot, automacoes, CRM, base de conhecimento, tags, SLA, integraÃ§Ãµes.
- Sites:
  - Builder, templates, SEO, dominio, SSL, publicacao, analytics, backup e white-label.
- Ads:
  - Gestor interno de anuncios, rotacao, frequencia, report, prioridades e cross-sell.

## 20. Backlog mestre por prioridade
- Prioridade 1: completar o pacote de ferramentas que mais vende e mais puxa trafego.
  - PDF
  - imagem
  - geradores/validadores
  - texto/SEO
- Prioridade 2: fortalecer cursos e escolar com conteudo e certificados.

## 21. Falta fazer / Falta criar
### VisÃ£o geral de tarefas pendentes
- Criar catÃ¡logo completo de 999 itens em `ferramentas`, `games`, `cursos`, `softwares` e `escolar`.
- Implantar painel administrativo de preÃ§os, afiliados e ads internos.
- Criar pÃ¡ginas de upsell e cross-sell entre subdomÃ­nios.
- Implementar pagamentos com Mercado Pago, InfinitPay e PIX.
- Adicionar planos e paywalls leves nas funcionalidades premium.
- Documentar cada mudanÃ§a no `planominike` e no `.agent.md`.

### Falta criar nos subdomÃ­nios
- `ferramentas`: completar ferramentas de PDF, imagem, texto, SEO, conversÃ£o, cÃ¡lculos, desenvolvimento, produtividade e geraÃ§Ã£o de conteÃºdo.
- `games`: adicionar jogos, ranking, moedas internas, badges, torneios e lista de 999 jogos com pagina de conversÃ£o.
- `cursos`: criar cursos modulares, certificados, trilhas PT/EN, planos grÃ¡tis/pagos, quizes e progress tracking.
- `softwares`: construir biblioteca de softwares e serviÃ§os, pacotes SaaS, comparativos, demos, licenÃ§as e checkout integrado.
- `escolar`: montar trilhas por fase escolar, simulados, gabaritos, atividades, reforÃ§os e dashboards de aluno/professor.
- `lojas`: criar hub de mini-sites, templates, importaÃ§Ã£o de produtos, carrinho, checkout e painel do vendedor.
- `delivery`: finalizar fluxo de cardÃ¡pio, cozinha, motoboy, checkout, entregas e relatÃ³rios.
- `ads`: fazer gestor interno de anÃºncios, rotatividade, report e cross-sell.
- `atendimento v1`: conectar chatbot, CRM bÃ¡sico e base de conhecimento.
- `sites`: desenvolver builder de pÃ¡ginas, templates, SEO e link com o ecossistema.

### Benchmark concorrentes e inspiraÃ§Ã£o online
- Ferramentas: 4Devs, iLovePDF, PDF24, Smallpdf, Canva, remove.bg.
- Cursos: Khan Academy, Udemy, Coursera, Alura, Hotmart, Skillshare.
- Escolar: Google Classroom, Descomplica, Brasil Escola, Geekie, Khan Academy, BYJU's, Khan Academy Kids.
- Softwares/E-commerce: Shopify, Wix, Hostinger, Tray, Nuvemshop.
- Gaming: Miniclip, Poki, CrazyGames, Kongregate.
- Ads/MonetizaÃ§Ã£o: Google Adsense, Adsterra, Monetag, PropellerAds.

## 22. Escolar â€” o que falta criar
### Estrutura necessÃ¡ria
- Estruturar por fase:
  - EducaÃ§Ã£o Infantil
  - Fundamental I
  - Fundamental II
  - Ensino MÃ©dio
  - EducaÃ§Ã£o Inclusiva
- Criar pÃ¡gina de hub com acesso rÃ¡pido por fase e por matÃ©ria.
- Mapear todas as matÃ©rias existentes e faltantes.
- Conectar conteÃºdo escolar com reforÃ§o e vendas internas (e.g. trilhas premium, pacotes de aulas pagas, simulados avanÃ§ados).

### MatÃ©rias jÃ¡ presentes e sugestÃµes de expansÃ£o
- Infantil: Linguagem, MatemÃ¡tica bÃ¡sica, CiÃªncias, Brincadeiras, Arte, MÃºsica, EducaÃ§Ã£o FÃ­sica, EspaÃ§os-Tempos, Corpo e Movimento.
- Fundamental I: PortuguÃªs, MatemÃ¡tica, CiÃªncias, Geografia, HistÃ³ria, InglÃªs, Arte, EducaÃ§Ã£o FÃ­sica, Ensino Religioso, Tecnologia/ComputaÃ§Ã£o.
- Fundamental II: PortuguÃªs, MatemÃ¡tica, CiÃªncias, FÃ­sica, QuÃ­mica, Biologia, Geografia, HistÃ³ria, InglÃªs, Espanhol, Artes, MÃºsica, EducaÃ§Ã£o FÃ­sica, ProgramaÃ§Ã£o, FinanÃ§as Pessoais, Carreira, Estudos Sociais.
- Ensino MÃ©dio: PortuguÃªs, MatemÃ¡tica, FÃ­sica, QuÃ­mica, Biologia, Geografia, HistÃ³ria, Sociologia, Filosofia, InglÃªs, Espanhol, Economia, Psicologia, AdministraÃ§Ã£o/NegÃ³cios, Jornalismo, ProgramaÃ§Ã£o, Engenharia, CulinÃ¡ria, MÃºsica, DanÃ§a, Projeto de Vida, Governo/Civics.
- Inclusiva: TDAH, Dislexia, Autismo, Acessibilidade Visual/Ãudio, Libras/ASL, ReforÃ§o Cognitivo, Habilidades de Vida, Tutoria e apoio especializado.

### Temas crÃ­ticos por fase
- EducaÃ§Ã£o Infantil: alfabetizaÃ§Ã£o emergente, nÃºmeros, emoÃ§Ãµes, corpo, natureza, cores, sons, famÃ­lia, meio ambiente.
- Fundamental I: leitura e escrita, operaÃ§Ãµes bÃ¡sicas, ciclo da Ã¡gua, mapa e cidade, povos e culturas, regras de convivÃªncia, inglÃªs funcional, experimentos simples.
- Fundamental II: produÃ§Ã£o de texto, fraÃ§Ãµes, equaÃ§Ãµes, sistema digestÃ³rio, forÃ§as, reaÃ§Ãµes quÃ­micas, ecossistemas, Brasil e mundo, revoluÃ§Ãµes, democracia, programaÃ§Ã£o introdutÃ³ria, educaÃ§Ã£o financeira.
- Ensino MÃ©dio: anÃ¡lise de texto, funÃ§Ã£o quadrÃ¡tica, trigonometria, eletromagnetismo, quÃ­mica orgÃ¢nica, genÃ©tica, geopolÃ­tica, capitalismo, Estado e cidadania, empreendedorismo, estatÃ­stica, lÃ³gica de programaÃ§Ã£o.
- Inclusiva: tÃ©cnicas de leitura, memÃ³ria, autorregulaÃ§Ã£o, acessibilidade, aprendizagem multisensorial, projetos de vida, interaÃ§Ã£o social.

### Atividades e reforÃ§o a criar
- Simulados por escola/ano com gabaritos e correÃ§Ãµes automÃ¡ticas.
- Aulas de reforÃ§o em vÃ­deo/texto para temas dificultosos.
- Fichas de exercÃ­cios, resumos, mapas mentais, flashcards e quizzes.

## Progresso desta execuÃ§Ã£o
- UnificaÃ§Ã£o de banco aplicada em `softwares/editor/config.php` para usar `u340626637_minike` e variÃ¡veis de ambiente `.env`.
- CorreÃ§Ã£o de `softwares/ponto/conexao.php` e `softwares/software/ponto/conexao.php` para usar o banco unificado e criar tabelas `mk_ponto_empresas`, `mk_ponto_funcionarios` e `mk_ponto_batidas` automaticamente.
- `escolar/index.php` atualizado com fallback para `includes/ads_internos.php` quando `ads/engine.php` nÃ£o estÃ¡ disponÃ­vel, garantindo que `MinikeAds::rede()` nÃ£o quebre a pÃ¡gina.
- `.env.example` ajustado para refletir o banco unificado e instruir credenciais seguras fora do cÃ³digo.
- Mantido o princÃ­pio: o ecossistema nÃ£o depende de mÃºltiplos bancos, e o cÃ³digo nÃ£o deve falhar apenas por ausÃªncia temporÃ¡ria de dados.

## PrÃ³ximas aÃ§Ãµes imediatas
- Verificar e corrigir quaisquer `config.php` restantes que ainda apontem para DBs legados.
- Criar ou validar `includes/load_ads.php` como fallback comum para todos os hubs que usam `MinikeAds`.
- Auditar `ferramentas`, `games`, `cursos`, `sites` e `softwares` para garantir que o banco unificado estÃ¡ ativo e as tabelas necessÃ¡rias jÃ¡ foram criadas.
- Documentar novos mÃ³dulos de plano e afiliados no plano mestre, incluindo caminho de arquivos e status.
- Projetos prÃ¡ticos: mapas, experimentos, redaÃ§Ãµes, apresentaÃ§Ãµes e portfÃ³lios.
- Planos de aula semanais para professores e guias de estudos para alunos.
- Certificados de conclusÃ£o, selos de desempenho e progressÃ£o por trilha.
- ConteÃºdo PT/EN com exemplos bilÃ­ngues para disciplinas de linguagens.

### Objetivo escolar comercial
- Vender pacotes de reforÃ§o para pais e professores.
- Oferecer assinatura educacional com acesso a simulados e avaliaÃ§Ãµes.
- Gerar leads com aulas grÃ¡tis e upsell de trilhas completas.
- Usar o subdomÃ­nio escolar como porta de entrada para `cursos` e `softwares` educacionais.

## 23. Cursos â€” o que falta criar
- Estruturar catÃ¡logo de cursos em trilhas e carreiras.
- Criar cursos em: Desenvolvimento Web, Design UX/UI, Marketing Digital, NegÃ³cios, FinanÃ§as, Data Science, IA, E-commerce, Produtividade, GestÃ£o de Projetos, Mindset Empreendedor, SeguranÃ§a Digital, CriaÃ§Ã£o de ConteÃºdo e AutomaÃ§Ã£o.
- Desenvolver pÃ¡ginas de curso com descriÃ§Ã£o, mÃ³dulos, aulas, instrutor, depoimentos, valor BRL/USD e botÃµes de compra.
- Criar certificados digitais e relatÃ³rios de conclusÃ£o.
- Adicionar quizzes, avaliaÃ§Ãµes e material de apoio (PDF, slides, templates).
- Oferecer bundles e planos de acesso por nÃ­veis (Free, Basic, Pro, Elite).
- Conectar cursos com `softwares` e `ferramentas` usados no curso para upsell.

## 24. Softwares â€” o que falta criar
- Mapear produtos e serviÃ§os em categorias claras: ERP, delivery, lojas, marketing, vendas, automaÃ§Ã£o, produtividade.
- Criar pÃ¡gina principal de software com comparativo de planos e cases.
- Adicionar pÃ¡ginas individuais de produtos com recursos, preÃ§os, demos e CTA de orÃ§amento.
- Incluir pÃ¡gina de revenda e afiliados para serviÃ§os de implementaÃ§Ã£o.
- Implementar checkout e geraÃ§Ã£o de valor por licenÃ§a/assinatura.
- Criar documentaÃ§Ã£o de APIs e integraÃ§Ãµes para clientes empresariais.

## 25. Ferramentas â€” o que falta criar
- Completar o catÃ¡logo de 999 ferramentas por vertical:
  - gerador de textuais, validadores, editores, conversores, utilitÃ¡rios de SEO, calculadoras de negÃ³cios, processadores de imagem, PDF, dados.
- Criar landing pages de mÃ³dulo para cada vertical.
- Implementar filtros, categorias e busca interna.
- Desenvolver pÃ¡ginas pÃºblicas de exemplo e demos interativas.
- Oferecer versÃµes grÃ¡tis com ads leves e premium sem ads.

## 26. Games â€” o que falta criar
- Criar catÃ¡logo de 999 jogos e vitrine de jogos com categorias.
- Adicionar ranking, moedas internas, conquistas e torneios.
- Criar pÃ¡ginas de apresentaÃ§Ã£o de jogo com screenshots e descriÃ§Ãµes.
- Garantir que anÃºncios nÃ£o interrompam a jogabilidade.
- Oferecer versÃµes premium de jogos com skins, recursos e competiÃ§Ãµes.

## 27. Lojas e Sites â€” o que falta criar
- Criar hub `lojas` com templates de mini-sites para clientes.
- Implementar importaÃ§Ã£o de catÃ¡logo, gestÃ£o de produtos, checkout e PDV.
- Criar templates de site com SEO, landing pages e publicaÃ§Ãµes rÃ¡pidas.
- Desenvolver painel para gerenciar preÃ§os, afiliados e pedidos.
- Incluir recursos de avaliaÃ§Ã£o, cupons e envio.

## 28. MonetizaÃ§Ã£o e operaÃ§Ã£o
- Integrar `ads` internos com cross-sell entre subdomÃ­nios.
- Criar pacotes e assinaturas com limites claros e benefÃ­cios.
- Implementar relatÃ³rio de vendas, mÃ©tricas de uso e desempenho.
- Criar fluxo de afiliados e pagamento de comissÃµes.
- Definir polÃ­tica de cobranÃ§a automÃ¡tica vs. PIX manual.

## 29. Prioridades de aÃ§Ã£o imediata
- [ ] Listar todas as matÃ©rias escolares por fase e definir conteÃºdo faltante.
- [ ] Criar lista de cursos por tema e prioridades comerciais.
- [ ] Identificar as 50 ferramentas de maior potencial de trÃ¡fego e finalizar pÃ¡ginas.
- [ ] Montar pÃ¡ginas de vendas para `softwares` e `cursos` com preÃ§os em BRL/USD.
- [ ] Implementar painel de admin minimal para gerenciar planos e anÃºncios internos.
- [ ] Adicionar conteÃºdo de reforÃ§o escolar com simulados e gabaritos.
- [ ] Atualizar `planominike.md` e `planominike.txt` sempre que completar uma dessas tarefas.
- Prioridade 3: escalar games com catalogo, moeda e abertura monetizada.
- Prioridade 4: vender softwares e lojas com trial, planos e licencas.
- Prioridade 5: consolidar delivery, atendimento e sites como suites complementares.

### Regra de execucao
- Antes de criar qualquer coisa nova, verificar se ja existe arquivo fisico.
- Se faltar, criar pagina-base/placeholder funcional primeiro, depois o modulo completo.
- Tudo que for concluido deve ser anotado neste plano e espelhado no `.txt`.

## 21. Backlog detalhado por site

### Ferramentas
- Falta criar os arquivos fisicos dos 57 itens `ativo` que ainda nao existem.
- Falta completar a suite de geradores/validadores:
  - documentos de pessoas
  - contas bancarias
  - certidoes
  - nicks
  - nomes
  - empresas
  - placas e veiculos
- Falta completar a suite PDF no nivel iLovePDF/PDF24:
  - repair
  - OCR
  - sign
  - unlock
  - protect
  - web to PDF
  - compare
  - reorder
  - watermark
  - page numbers
  - extract pages/images
- Falta completar imagem e IA visual:
  - remove background
  - upscale
  - colorize
  - batch processing
  - templates
- Falta padronizar pagina-base por vertical com campanhas e upsell.

### Escolar
- Ja existe o mapa BR/US inicial em `includes/meta999_school_curriculum.php`.
- Falta gerar paginas por ano/sÃ©rie com:
  - aulas
  - reforco
  - atividades
  - quizzes
  - gabaritos
  - certificacao
  - progresso
- Falta transformar os temas gerais em trilhas reais:
  - alfabetizacao
  - matematica basica
  - ciencias
  - historia
  - geografia
  - ingles
  - artes
  - educacao fisica
  - computacao
  - socioemocional
- Falta materializar cada serie/ano do Brasil e dos EUA em paginas navegaveis.

### Cursos
- Falta criacao das trilhas reais por categoria.
- Falta pagina de carreira e jornada por area.
- Falta certificado, progresso, prova, trilha e mentorias.
- Falta conteudo PT/EN e precificacao BRL/USD em cada card.
- Falta transformar sementes em cursos persistidos no banco.

### Games
- Falta catalogo de 999 jogos reais e suas paginas individuais.
- Falta moeda universal, ranking, conquistas e perfil de jogador.
- Falta pagina de abertura com ads leves e sem anuncios no gameplay.
- Falta loja interna, skins, trofeus e progression loop.

### Softwares
- Falta biblioteca completa de 999 SaaS/solucoes.
- Falta pagina por produto, trial, comparativo, licenca e upgrade.
- Falta plano anual com desconto e pagina para revendedores.
- Falta landing pages por segmento:
  - delivery
  - erp
  - financeiro
  - automacao
  - crm
  - integracoes

### Lojas
- Falta hub final de mini-sites para clientes.
- Falta pagina de templates, preco, demo, importacao e personalizacao.
- Falta PDV, cupons, frete, checkout, avaliacoes e afiliados.
- Falta painel de lojista com estatisticas e monetizacao.

### Delivery
- Falta suite completa de cardapio QR, cozinha, motoboy e fluxo operacional.
- Falta pagina comercial por restaurante, lanchonete, mercado e dark kitchen.
- Falta multiunidade, fidelidade, cupons, cashback e ranking de entregadores.

### Atendimento
- Falta inbox omnichannel com fluxo de tickets, chatbot e automacoes.
- Falta CRM comercial, tags, SLA, automacoes, base de conhecimento e historico.
- Falta pagina comercial do atendimento como produto vendavel.

### Sites
- Falta builder/portal com templates, SEO, dominio, SSL, analytics, backup e publicacao.
- Falta vitrine de templates e comparativos de planos.
- Falta integraÃ§Ã£o visual com identidade Minike para todos os subdominios.

### Ads
- Falta central de anuncios internos com:
  - rotacao
  - prioridade
  - limite por usuario
  - frequencia
  - relatorio
  - cross-sell
- Falta padrao de anuncios leves na entrada e nenhum anuncio intrusivo no produto principal.

### Conteudo institucional
- Falta pagina oficial com:
  - sobre
  - casos
  - provas
  - depoimentos
  - certificados
  - comparativos
  - portfolio

## 22. Direcao de producao
- A ordem de producao agora e:
  1. Ferramentas
  2. Escolar
  3. Cursos
  4. Games
  5. Softwares
  6. Lojas
  7. Delivery
  8. Atendimento
  9. Sites
  10. Ads
- Cada novo modulo precisa nascer com:
  - amostra gratis
  - preco visivel BRL/USD
  - sem anuncios no produto premium
  - cross-sell interno
  - pagina-base funcional

## 23. Entregas recentes de escola e reforco
- Novo motor em `includes/meta999_school_content.php` para montar aulas, atividades e licao de casa a partir do mapa BR/US.
- Nova vitrine em `escolar/atividades.php` com:
  - selecao BR/US
  - aulas prontas
  - atividades guiadas
  - licao de casa
  - amostra gratis e premium sem anuncios
- `escolar/index.php` ganhou a secao "Aulas prontas e atividades" e agora mostra conteudo util, nao so mapa curricular.
- O mapa escolar ja cobre:
  - Brasil: infantil, fundamental 1, fundamental 2 e medio
  - USA: preK, K, grades 1-12
  - materias principais por etapa
  - trilhas de reforco PT/EN

## 24. Inventario real do catalogo que ainda falta criar
- Falta fisica confirmada no catalogo: 54 caminhos `ativo` sem arquivo local.
- Falta por modulo:
  - gerador: 8
  - imagem: 7
  - pdf: 6
  - texto: 6
  - calculo: 5
  - educacao: 4
  - social: 3
  - converter: 3
  - desenvolvedor: 3
  - matematica: 2
  - data_hora: 2
  - seo: 2
  - negocios: 2
  - design: 1
  - seguranca: 1
  - financeiro: 1
  - saude: 1
- Lista real dos caminhos faltantes:
  - `calculo/conversor_temperatura.php`
  - `calculo/media_notas.php`
  - `calculo/potencia_raiz.php`
  - `calculo/regra_de_tres.php`
  - `converter/angulo.php`
  - `converter/energia.php`
  - `converter/pressao.php`
  - `data_hora/calendario.php`
  - `data_hora/conversor_fuso.php`
  - `desenvolvedor/hash.php`
  - `desenvolvedor/qrcode.php`
  - `design/conversor_hex_rgb.php`
  - `educacao/calculadora_media_universitaria.php`
  - `educacao/conversor_notas_escola.php`
  - `educacao/gerador_flashcards.php`
  - `educacao/quiz_matematica.php`
  - `financeiro/conversor_moedas.php`
  - `gerador/cartao_credito.php`
  - `gerador/cnh.php`
  - `gerador/inscricao_estadual.php`
  - `gerador/pis.php`
  - `gerador/placa.php`
  - `gerador/renavam.php`
  - `gerador/rg.php`
  - `gerador/titulo_eleitor.php`
  - `imagem/converter.php`
  - `imagem/efeitos.php`
  - `imagem/extrair_cores.php`
  - `imagem/heic_jpg.php`
  - `imagem/redimensionar.php`
  - `imagem/rotacionar.php`
  - `imagem/webp.php`
  - `matematica/mmc_mdc.php`
  - `matematica/numeros_primos.php`
  - `negocios/calculadora_frete.php`
  - `negocios/gerador_boleto_info.php`
  - `pdf/comprimir.php`
  - `pdf/dividir.php`
  - `pdf/editar.php`
  - `pdf/pdf_jpg.php`
  - `pdf/pdf_word.php`
  - `pdf/unir.php`
  - `saude/tabela_alimentar.php`
  - `seguranca/verificador_https.php`
  - `seo/gerador_sitemap.php`
  - `seo/verificador_robots.php`
  - `social/contagem_regressiva.php`
  - `social/encurtador_url.php`
  - `texto/comparador_texto.php`
  - `texto/contador_caracteres_especificos.php`
  - `texto/extrator_emails.php`
  - `texto/extrator_links.php`
  - `texto/inversor_texto.php`
  - `texto/removedor_espacos.php`

## 25. Entregas recentes de cursos
- Novo hub em `cursos/trilhas.php` com trilhas Meta999 em BR/US.
- O hub de cursos agora tem atalho visivel para as trilhas.
- O filtro de categoria foi normalizado antes do uso em `cursos/index.php`.
- As trilhas exibem:
  - idioma PT/EN
  - preco BRL/USD
  - nivel
  - numero de aulas
  - premium sem anuncios
- A vitrine comercial de cursos segue pronta para amostras gratis e upgrade recorrente.

## 26. Entregas recentes de games
- Novo hub em `games/colecao.php` com colecao Meta999 por genero.
- O hub de games ganhou atalho visivel para a colecao.
- A regra comercial esta explicitada:
  - anuncio somente na entrada
  - nada dentro da gameplay
  - premium sem anuncios
- A colecao destaca:
  - BRL/USD
  - free/premium
  - generos principais
  - roadmap de moeda universal e ranking global

## 27. Entregas recentes de softwares
- Novo hub em `softwares/colecao.php` com linha Meta999 para revenda.
- O hub de softwares agora aponta para a colecao comercial.
- A colecao mostra:
  - trial em dias
  - preco BRL/USD
  - premium sem anuncios
  - foco em SaaS, automacao e sistemas prontos
- A proposta principal continua sendo vender software como produto recorrente e nao apenas projeto avulso.

## 28. Regra de midia para aulas e cursos
- Em `cursos` e `escolar` pode usar:
  - links de videos
  - links de imagens
  - embeds externos
  - materiais de apoio
- Regra obrigatoria:
  - manter criador / autoria no rodape ou abaixo do conteudo
  - manter direitos e fonte visiveis
  - nunca remover credito original quando existir
- Padrao de conteudo:
  - video/imagem primeiro
  - explicacao em seguida
  - creditos e direitos no fim
  - opcao premium sem anuncios

## 29. Creditos visiveis nas paginas
- `cursos/trilhas.php` e `escolar/atividades.php` agora exibem um bloco fixo de creditos e direitos no fim da pagina.
- Regra operacional:
  - qualquer video, imagem ou embed externo precisa manter autoria, fonte e direitos visiveis
  - o rodape nao pode remover o criador original
  - a plataforma pode editar a aula, mas nao apagar a procedencia

## 30. Entregas recentes de atendimento
- Nova base em `atendimento/index.php` para o subdominio de suporte.
- Nova colecao em `atendimento/colecao.php` com pacotes:
  - tickets e SLA
  - omnichannel
  - IA e automacoes
  - CRM e base de conhecimento
- O atendimento agora nasce como produto vendavel com planos, demo e credito visivel.

## 31. Entregas recentes de delivery
- Nova colecao em `delivery/colecao.php`.
- O hero de `delivery/index.php` ganhou atalho para a colecao Meta999.
- A vitrine de delivery agora explicita:
  - cardapio QR
  - cozinha e caixa
  - motoboy e rota
  - fidelidade e cashback
- O delivery segue focado em vender a operacao completa da empresa, nao so um menu.

## 32. Entregas recentes de sites
- Nova colecao em `sites/colecao.php`.
- O hero de `sites/index.php` agora aponta para a colecao Meta999.
- A CTA principal de sites passou a oferecer colecao e fabrica de templates.
- A vitrine de sites vende:
  - sites institucionais
  - business sites
  - store builder
  - white-label pro
- O objetivo e vender template, SSL, SEO, analytics, backup e revenda recorrente.

## 33. Entregas recentes de lojas
- Nova colecao em `lojas/colecao.php`.
- O diretÃ³rio de lojas ganhou atalho para a coleÃ§Ã£o Meta999.
- A frente comercial de lojas agora vende:
  - loja starter
  - loja pro
  - loja delivery
  - white-label de mini-sites
- O foco segue sendo monetizar o ecossistema com revenda, templates e marca propria.

## 34. Consolidacao de rotas ativas do catalogo
- O inventario ativo do `ferramentas/catalogo.php` foi reconciliado com o disco.
- Resultado atual da checagem:
  - `ACTIVE_COUNT=128`
  - `MISSING_COUNT=0`
- Foram criados wrappers e rotas canonicas para alinhar o catalogo com os nomes esperados:
  - `gerador/cartao_credito.php`
  - `gerador/inscricao_estadual.php`
  - `gerador/placa.php`
  - `gerador/renavam.php`
  - `gerador/titulo_eleitor.php`
  - `imagem/converter.php`
  - `texto/inversor_texto.php`
- Tambem foram fechados os nomes canÃ´nicos de apoio em:
  - `gerador/cnh.php`
  - `gerador/pis.php`
  - `gerador/rg.php`
  - `gerador/validador-pis.php`
  - `gerador/validador-rg.php`
  - `imagem/redimensionar.php`
  - `imagem/rotacionar.php`
  - `imagem/heic_jpg.php`
  - `imagem/webp.php`
  - `imagem/efeitos.php`
  - `imagem/extrair_cores.php`
  - `imagem/remover_fundo.php`
  - `pdf/unir.php`
  - `pdf/dividir.php`
  - `pdf/comprimir.php`
  - `pdf/pdf_jpg.php`
  - `pdf/pdf_word.php`
  - `pdf/editar.php`
  - `texto/cortar_texto.php`
  - `texto/inverter_texto.php`
  - `texto/maiusculas_minusculas.php`
  - `texto/numero_por_extenso.php`
  - `texto/ordenar_alfabeticamente.php`
  - `texto/remover_acentos.php`

## 35. Novas paginas de apoio e conteudo
- Foram criadas novas paginas funcionais para preencher lacunas de conteudo e conversao:
  - `texto/removedor_espacos.php`
  - `texto/comparador_texto.php`
  - `texto/contador_caracteres_especificos.php`
  - `texto/extrator_emails.php`
  - `texto/extrator_links.php`
  - `social/contagem_regressiva.php`
  - `social/encurtador_url.php`
  - `seo/gerador_sitemap.php`
  - `seo/verificador_robots.php`
  - `negocios/calculadora_frete.php`
  - `negocios/gerador_boleto_info.php`
  - `educacao/quiz_matematica.php`
  - `educacao/conversor_notas_escola.php`
  - `educacao/gerador_flashcards.php`
  - `educacao/calculadora_media_universitaria.php`
  - `imagem/upscale.php`
- As novas paginas seguem o foco do ecossistema:
  - conteudo primeiro
  - amostra gratis
  - upgrade premium sem anuncios
  - suporte PT/EN e BRL/USD quando aplicavel

## 36. Escola - curriculo completo BR/US
- Criadas novas paginas em `escolar/`:
  - `curriculo.php`
  - `reforco.php`
- `escolar/index.php` ganhou atalhos para:
  - `curriculo.php`
  - `reforco.php`
  - `atividades.php`
- O novo hub escolar cobre:
  - etapas BR e US
  - materias por ano
  - temas lecionados por etapa
  - packs de aula, atividade e licao
  - blocos de creditos e direitos visiveis
- A regra comercial continua:
  - amostra gratis
  - premium sem anuncios
  - conteudo pronto para pais, professores e escolas

## 37. Cursos - certificado e avaliacao
- Criadas novas paginas em `cursos/`:
  - `certificado.php`
  - `avaliacao.php`
- `cursos/index.php` ganhou atalhos para:
  - `trilhas.php`
  - `certificado.php`
  - `avaliacao.php`
- As novas paginas servem para:
  - demonstracao de conclusao
  - geracao de certificado
  - quiz de avaliacao
  - aumento de conversao para premium
- Mantido o padrao:
  - PT/EN
  - creditos de autoria visiveis
  - amostra gratis
  - premium sem anuncios

## 38. Estrategia de continuidade
- Proximo passo natural do mapa:
  - ampliar `escolar` com mais series/anos e provas
  - ampliar `cursos` com mais areas e certificados
  - seguir criando conteudo em `ferramentas`, `pdf`, `imagem` e `texto`
- Regra operacional:
  - o plano Minike segue sendo a fonte unica
  - toda nova pagina/rota precisa entrar no plano na mesma rodada

## 39. Escola - materias e provas
- Criadas novas paginas em `escolar/`:
  - `materias.php`
  - `provas.php`
- `escolar/index.php` ganhou atalhos para:
  - `materias.php`
  - `provas.php`
- O hub escolar agora cobre com mais clareza:
  - mapa de materias por ano
  - lista de temas lecionados
  - simulados e provas prontas
  - caminho de venda para escola, reforco e assinatura

## 40. Cursos - areas e progresso
- Criadas novas paginas em `cursos/`:
  - `areas.php`
  - `progresso.php`
- `cursos/index.php` ganhou atalhos para:
  - `areas.php`
  - `progresso.php`
- O hub de cursos agora cobre:
  - areas de conhecimento
  - trilhas por categoria
  - jornada de progresso
  - retenÃ§Ã£o, prova e certificado
- Mantido o padrao comercial:
  - PT/EN
  - BRL/USD
  - amostra gratis
  - premium sem anuncios

## 41. Politica de anuncios leves
- Regra oficial:
  - anuncios sempre discretos
  - preferir lateral, banner pequeno e inline
  - nao bloquear tela de conteudo com modal grande
  - usar popup apenas em canto fixo e com fechamento facil
- Prioridade de monetizacao:
  - free com anuncios leves
  - basic/pro/elite/acompanhamento sem anuncios
  - oferta de acompanhamento com suporte dedicado
- Aplicado em:
  - `planos.php`
  - `atendimento/index.php`
  - `delivery/index.php`
  - `cursos/index.php`
  - `sites/index.php`
  - `lojas/index.php`
- Motor central atualizado:
  - `includes/ads_internos.php` aceita `banner`, `lateral`, `inline`, `meio`, `sidebar`

## 42. Plano de acompanhamento
- Novo plano comercial:
  - slug `acompanhamento`
  - sem anuncios
  - suporte dedicado
  - ajustes e acompanhamento
  - prioridade operacional
- Integracao feita em:
  - `includes/planos_limites.php`
  - `sql/setup_monetizacao.sql`
  - `sql/auto_install.php`
  - `planos.php`
- Objetivo:
  - vender servico recorrente com mais margem
  - atender clientes que precisam de mao na operacao
  - aumentar ticket medio sem poluir a experiencia

## 43. Motor de ads compatibilidade
- `includes/ads_internos.php` foi refeito para aceitar:
  - `banner`
  - `lateral`
  - `inline`
  - `meio`
  - `sidebar`
  - `popup`
  - `modal`
- Novos atalhos de compatibilidade:
  - `getHeader()`
  - `getBanner()`
  - `getSmartlink()`
- Objetivo:
  - evitar fatal em paginas antigas
  - permitir anuncios leves sem bloquear conteudo
  - manter monetizacao interna viva em todos os hubs

## 44. Rede interna de divulgacao
- Criada a vitrine `MinikeAds::rede()` para mostrar os outros hubs e subsites do ecossistema em formato de grade leve.
- Cards incluidos na rede:
  - ferramentas
  - cursos
  - escolar
  - atendimento
  - delivery
  - lojas
  - softwares
  - games
  - sites
  - planos
  - afiliados
- Objetivo:
  - fazer cross-sell entre produtos proprios
  - aumentar pageviews cruzando subdominios
  - manter anuncios internos sem poluir a experiencia

## 45. Pontos de insercao da rede interna
- A rede interna foi colocada em:
  - `index.php`
  - `atendimento/index.php`
  - `delivery/index.php`
  - `cursos/index.php`
  - `sites/index.php`
  - `lojas/index.php`
  - `escolar/index.php`
  - `ferramentas/index.php`
- Regra comercial:
  - conteudo primeiro
  - rede interna logo depois do hero ou do primeiro banner
  - sem bloqueio de tela e sem modal chato

## 46. Ajuste fino de log e validacao
- Pequeno ajuste no `index.php` para remover aviso de depreciacao do log:
  - `({$elapsed}ms)` no lugar de interpolacao antiga
- Objetivo:
  - manter a homepage limpa na validacao do PHP
  - evitar ruido inutil enquanto a rede interna cresce

## 47. Expansao da rede interna
- A rede interna foi ampliada para:
  - `softwares/index.php`
  - `games/index.php`
  - `planos.php`
- Objetivo:
  - transformar todas as vitrines principais em pontos de cross-sell
  - empurrar trafego entre hubs de maior valor comercial
  - reforcar a venda de planos, software e jogos dentro do proprio ecossistema

## 48. Motor adaptativo de crescimento
- Criado `includes/adaptive_growth.php` com:
  - deteccao de interesse por URL, cookie e contexto da pagina
  - blocos de recomendacao por tema
  - prova social adaptativa
  - criativos de anuncio por interesse
- Interesses principais cobertos:
  - matematica
  - escolar
  - cursos
  - ferramentas
  - delivery
  - atendimento
  - lojas
  - softwares
  - games
  - sites
  - geral

## 49. Persistencia de interesse e vendas cruzadas
- O motor grava o interesse atual no cookie `minike_interest`.
- Objetivo:
  - lembrar o que a pessoa quer ver
  - mudar as recomendacoes na proxima pagina
  - aumentar tempo de permanencia e conversao

## 50. Aplicacao no site inteiro
- Integrado em:
  - `index.php`
  - `atendimento/index.php`
  - `delivery/index.php`
  - `cursos/index.php`
  - `sites/index.php`
  - `lojas/index.php`
  - `escolar/index.php`
  - `ferramentas/index.php`
  - `softwares/index.php`
  - `games/index.php`
  - `planos.php`
- Regra de exibicao:
  - depois do hero ou do primeiro bloco de contexto
  - sem bloqueio de tela
  - com textos e ofertas adaptados ao interesse

## 51. ads.minike como centro unico de monetizacao
- Criado o eixo central em `ads/` com:
  - `ads/index.php` como painel mestre
  - `ads/painel.php` com gestao de espacos, reservas, campanhas e doacoes
  - `ads/espacos.php` como vitrine publica de venda de espacos
  - `ads/vakinha.php` como vitrine publica de campanhas e beneficios digitais
  - `ads/install.php` para bootstrap de tabelas
- O ecossistema inteiro passa a consumir o inventario novo via `includes/ads_internos.php`
- Regra:
  - anuncios leves, laterais e inline primeiro
  - sem bloquear tela
  - premium sem anuncios

## 52. Inventario, reservas e precificacao de anuncios
- Adicionadas tabelas novas:
  - `mk_ads_espacos`
  - `mk_ads_reservas`
- Objetivo:
  - vender banners, laterais, inline e popup
  - manter precos por dominio e por posicao
  - permitir reservas com data de inicio e fim
  - manter fallback para anuncios proprios caso nao haja reserva ativa
- Seed inicial criado para:
  - home
  - ferramentas
  - cursos
  - escolar
  - delivery
  - lojas
  - softwares
  - games

## 53. Vakinha com beneficios digitais e afiliacao cruzada
- Adicionadas tabelas novas:
  - `mk_vakinha_campanhas`
  - `mk_vakinha_beneficios`
  - `mk_vakinha_doacoes`
- Objetivo:
  - campanha de apoio com meta, progresso e recompensa digital
  - beneficios como acesso premium, arquivo, curso, assessoria e assinatura
  - doacao ligada a afiliado quando houver codigo de indicacao
  - vender apoio sem quebrar a experiencia do usuario
- Regra:
  - mostrar transparencia da meta
  - entregar beneficios digitais de forma natural
  - permitir que o publico ajude e receba valor real em troca

## 54. Catalogo Meta999 de games por genero
- Criado o gerador em `includes/meta999_content.php`:
  - `mkMeta999GameCatalog(10)`
- Cada genero passa a ter 10 jogos de vitrine com:
  - nome PT/EN
  - descricao PT/EN
  - faixa etaria
  - tempo medio
  - preco BRL/USD
  - demo gratis e premium sem anuncios
- Atualizado em `games/`:
  - `games/index.php` ganhou vitrine por genero
  - `games/colecao.php` virou catalogo completo por genero
  - `games/jogo.php` virou pagina de detalhe segura
  - `games/play.php` virou wrapper de compatibilidade
- Ranking de games corrigido para usar a base unificada e nao travar por erro de sintaxe ou tabela antiga

## 55. Blindagem do index de ferramentas
- `ferramentas/index.php` recebeu:
  - fallback para `renderMinikeThemeAssets`
  - fallback para `mkAdaptiveGrowthRender`
  - fallback visual quando nenhum arquivo de ferramenta eh descoberto
  - blocos comerciais de emergencia para manter a vitrine viva
- Objetivo:
  - nunca abrir em branco
  - registrar qualidade e falhas no log
  - manter conversao mesmo quando helpers opcionais falham

## 56. Banco unificado em modo fail-soft
- `includes/db.php` deixou de derrubar a pagina inteira quando o banco falha temporariamente.
- Regra nova:
  - em web, o loader marca o erro e segue com fallback
  - em CLI, continua encerrando com erro para nao mascarar falhas de instalacao
- Impacto:
  - indexes podem renderizar conteudo local e anuncios proprios mesmo com banco instavel
  - reduz tela branca e travamentos no ecossistema

## 57. Games com catalogo navegavel e rota de detalhe segura
- `games/index.php` passou a apontar os cards para `games/jogo.php`.
- `games/colecao.php` virou catalogo por genero com 10 jogos por bloco.
- `games/play.php` agora e wrapper de compatibilidade.
- Objetivo:
  - abrir sempre uma pagina valida
  - manter demo gratis e upgrade premium sem anuncios
  - reforcar a vitrine de jogos como produto de conteudo

## 58. API publica do ads.minike para parceiros
- Criado o motor de API em `ads/`:
  - `ads/api.php` para JSON, HTML e JS
  - `ads/widget.php` para iframe/HTML embed
  - `ads/click.php` para rastrear cliques e redirecionar
- A API usa a base unificada e o inventario de `mk_ads_espacos` e `mk_ads_reservas`.
- Fluxo:
  - parceiro cadastra cliente e chave no painel
  - recebe `key`
  - embute a URL do widget ou consome JSON via fetch
  - cliques e impressoes sao logados

## 59. Cadastro de clientes e chaves da API
- Criadas tabelas novas:
  - `mk_ads_api_clientes`
  - `mk_ads_api_keys`
  - `mk_ads_api_logs`
- O painel `ads/painel.php` agora permite:
  - cadastrar cliente parceiro
  - gerar chave API
  - ver snippet de iframe e fetch
  - acompanhar clientes, chaves e ultimo uso
- Regra:
  - chave e segredo nao ficam expostos depois da geracao
  - uso pode ser restrito por dominios e slots permitidos

## 60. Bootstrap automatizado da API de ads
- `includes/db.php`, `includes/mk_boot.php`, `sql/setup_monetizacao.sql` e `sql/auto_install.php` passaram a criar as tabelas da API automaticamente.
- Resultado:
  - qualquer instalacao nova sobe com marketplace, campanhas, vakinhas e API externa funcionando
  - menos dependencias manuais
  - menor risco de tela branca ou modulo ausente

## 61. Documentacao publica da API para parceiros
- Criado `ads/docs.php` como vitrine publica da API Minike Ads.
- A pagina explica:
  - cadastro de parceiro
  - geracao de chave
  - uso com iframe, JSON e JS
  - modelo comercial prepago, mensal ou revshare
- Objetivo:
  - reduzir atrito de integracao
  - deixar claro o valor da rede Minike para sites e apps de terceiros

## 62. Estatisticas da API para parceiros
- Criado `ads/stats.php` para consultar consumo e resultados por chave.
- Entrega:
  - requests
  - impressÃµes
  - clicks
  - CTR
  - bloqueios por dominio/slot
- Pode responder em JSON ou HTML.
- Objetivo:
  - dar transparencia ao parceiro
  - provar performance
  - suportar cobranca por uso e revshare

## 63. Parada atual e backlog pendente
- Parei aqui nesta rodada depois de concluir:
  - API publica do ads.minike
  - docs publicas da API
  - stats publicas da API
  - catalogo de games por genero
  - blindagem do index de ferramentas
  - fail-soft do banco unificado
- Proximos itens que faltam fazer quando a sessao voltar:
  - criar painel de parceiro para clientes da API com login proprio, saldo, consumo e faturamento
  - ligar cobranca automatica por uso, plano mensal e revshare
  - criar endpoints de invoice, credit top-up e webhook de pagamento da API
  - integrar a API de ads dentro dos sites e subsites com snippets prontos
  - continuar a expansao de games com mais generos e mais paginas de detalhe
  - continuar a expansao de cursos e escolar com conteudo em massa
  - revisar configs de todos os subdominios para garantir o banco unico `u340626637_minike`
  - verificar tabelas/colunas faltantes e manter auto-criacao via codigo
  - limpar arquivos mortos e duplicados restantes
  - validar em producao os indexes que ainda possam abrir em branco

## 64. Ideias adicionais que ainda valem muito
- Criar um painel de saude geral do ecossistema em `admin/ecossistema.php` com:
  - status de cada subdominio
  - alerta de pagina em branco
  - alerta de config divergente
  - alerta de tabela faltante
- Criar um auditor automatico de config em todos os `config.php` para:
  - confirmar banco unico `u340626637_minike`
  - registrar alias de subdominio e pasta
  - mostrar em qual arquivo o fluxo parou
- Criar um limpador de arquivos mortos e duplicados com lista segura para:
  - `index(1).php`
  - `index(2).php`
  - backups soltos
  - arquivos de teste esquecidos
- Criar um gerador de sitemap e indexacao por subdominio para:
  - ferramentas
  - cursos
  - escolar
  - games
  - softwares
  - lojas
  - delivery
- Criar uma camada de recomendacao interna que entenda o contexto da pagina e mostre:
  - ferramentas relacionadas
  - cursos relacionados
  - produtos e planos relacionados
  - anuncios internos dos outros sites Minike
- Criar um portal do parceiro de ads com:
  - login proprio
  - saldo
  - top up
  - consumo
  - invoice
  - revshare
- Criar um painel de conteudo em massa para acelerar:
  - 999 ferramentas
  - 999 jogos
  - 999 cursos
  - 999 atividades escolares
  - 999 modelos de site e loja
- Criar um monitor de monetizacao para exibir:
  - receita por subdominio
  - receita por plano
  - receita por anuncio
  - receita por afiliado
  - receita por doacao/vakinha
- Criar paginas de prova social automatica com:
  - avaliacoes modelo
  - depoimentos
  - casos de uso
  - estudos de caso
  - before/after
- Criar um fluxo de suporte leve com:
  - central de ajuda
  - base de conhecimento
  - contatos rapidos
  - status de sistema
  - logs de erro visiveis para admin
- Criar uma fila de tarefas de automacao para futuras IAs nao se perderem entre:
  - conteudo
  - monetizacao
  - correcoes
  - limpeza
  - expansao de catalogo


## 21. Progresso desta execucao 6 (16/05/2026)
- Expansao de catalogos comerciais com foco PT/EN em multiplos sites e subsites.
- `includes/meta999_content.php` ampliado com novos motores de seed:
  - `mkMeta999SiteSeeds(180)`
  - `mkMeta999DeliverySeeds(180)`
  - `mkMeta999StoreSeeds(180)`
- Colecoes conectadas aos novos motores para aumentar volume real de vitrine:
  - `sites/colecao.php` agora usa `mkMeta999SiteSeeds(180)`
  - `delivery/colecao.php` agora usa `mkMeta999DeliverySeeds(180)`
  - `lojas/colecao.php` agora usa `mkMeta999StoreSeeds(180)`
- Escala adicional em softwares:
  - `softwares/colecao.php` passou de 96 para 180 itens de seed.
- Resultado: crescimento imediato de catalogo em sites, delivery, lojas e softwares com conteudo comercial bilingue e precificacao BRL/USD.

### Proximo alvo direto
1. Replicar o mesmo padrao de expansao em `games/colecao.php` e `cursos/index.php` com trilhas por segmento.
2. Persistir parte das seeds no banco unico para gestao via painel admin.
3. Criar filtros por idioma e faixa de preco nas paginas de colecao.

## 22. Progresso desta execucao 7 (16/05/2026)
- Expansao direta dos catalogos de `games` e `cursos` com foco total em volume comercial PT/EN.
- `games/colecao.php` ampliado para usar `mkMeta999GameCatalog(20)` (dobro por genero no catalogo exibido).
- `cursos/index.php` ampliado de 180 para 360 seeds (`mkMeta999CourseSeeds(360)`).
- Criado novo catalogo dedicado de cursos:
  - `cursos/colecao.php`
  - organizado por categoria
  - oferta free/premium com BRL/USD
  - trilhas bilï¿½ngues PT/EN
- Navegacao reforcada:
  - botao `Colecao` adicionado no menu principal de `cursos/index.php`.

### Proximo alvo direto
1. Persistir seeds de cursos/games no banco unico (`u340626637_minike`) para administracao no painel.
2. Criar filtros por idioma, preco e nivel em `cursos/colecao.php`.
3. Criar pagina de catalogo 999 para `atendimento` e `erp` com o mesmo motor comercial.

## 23. Progresso desta execucao 8 (16/05/2026)
- Criados seeders idempotentes para persistencia de catalogo no banco unico:
  - `cursos/seed_meta999.php` (tabela `mk_meta999_cursos`)
  - `games/seed_meta999.php` (tabela `mk_meta999_games`)
- `cursos/colecao.php` evoluido com filtros comerciais reais:
  - idioma (`pt`, `en`)
  - nivel (`iniciante`, `intermediario`, `avancado`)
  - preco (`free`, `premium`)
- Seeders preparados com `INSERT ... ON DUPLICATE KEY UPDATE` para evitar duplicacao e permitir ressincronizacao.
- Tentativa de execucao dos seeders realizada nesta sessao, mas bloqueada por indisponibilidade de conexao MySQL no ambiente local:
  - `SQLSTATE[HY000] [2002] ... conexao recusada`

### Proximo alvo direto
1. Reexecutar seeders assim que o banco responder:
   - `php cursos/seed_meta999.php`
   - `php games/seed_meta999.php`
2. Consumir `mk_meta999_cursos` e `mk_meta999_games` direto nas colecoes para analytics/admin.
3. Expandir o mesmo padrao para `atendimento` e `erp`.

## 24. Progresso desta execucao 9 (16/05/2026)
- Colecoes agora leem primeiro do banco (`mk_meta999_*`) com fallback automatico para seeds locais.
- `cursos/colecao.php`:
  - integrado com `cursos/config.php` para conexao PDO local;
  - leitura prioritaria de `mk_meta999_cursos`;
  - fallback para `mkMeta999CourseSeeds(360)` quando banco/tabela indisponivel;
  - indicador visual de fonte ativa (`banco unificado` ou `seed local`).
- `games/colecao.php`:
  - leitura prioritaria de `mk_meta999_games`;
  - fallback para `mkMeta999GameCatalog(20)`;
  - indicador visual de fonte ativa (`banco unificado` ou `seed local`).

### Proximo alvo direto
1. Aplicar o mesmo padrao DB-first para `sites/colecao.php`, `delivery/colecao.php` e `lojas/colecao.php`.
2. Criar endpoint admin para re-sincronizar seeds (`cursos` e `games`) por botao no painel.
3. Incluir contadores de itens por fonte (DB/seed) para monitoramento de catalogo.

## 25. Progresso desta execucao 10 (16/05/2026)
- Escala de catalogo elevada para meta 999+ em modulos centrais.
- Ferramentas:
  - `ferramentas/catalogo.php` atualizado para `mkMeta999ToolSeeds(999)`.
- Cursos:
  - `cursos/index.php` atualizado para `mkMeta999CourseSeeds(999)`.
  - `cursos/seed_meta999.php` atualizado para sincronizar 999 cursos no banco (`mk_meta999_cursos`).
  - `cursos/colecao.php` fallback elevado para 999 cursos quando DB estiver indisponivel.
- Games:
  - `games/index.php` atualizado para `mkMeta999GameSeeds(999)` e catalogo por genero com `mkMeta999GameCatalog(100)`.
  - `games/colecao.php` fallback elevado para `mkMeta999GameCatalog(100)`.
  - `games/seed_meta999.php` atualizado para sincronizar 1000 jogos (10 generos x 100) em `mk_meta999_games`.
- Escolar:
  - `escolar/index.php` atualizado para `mkMeta999SchoolSeeds(999)` e pack de aulas `mkSchoolLessonPack('br', 999)`.
  - Novo seeder criado: `escolar/seed_meta999.php`.
    - sincroniza 999 temas em `mk_meta999_escolar_temas`.
    - sincroniza 9999 atividades em `mk_meta999_escolar_atividades`.

### Validacao desta execucao
- `php -l` OK em todos os arquivos alterados/criados.
- Execucao de seeders tentada para cursos/games/escolar, mas bloqueada por indisponibilidade de MySQL no ambiente:
  - `SQLSTATE[HY000] [2002] ... conexao recusada`.

### Proximo alvo direto
1. Reexecutar seeders quando o banco responder:
   - `php cursos/seed_meta999.php`
   - `php games/seed_meta999.php`
   - `php escolar/seed_meta999.php`
2. Trocar leitura de escolar para DB-first com fallback (como ja feito em cursos/games).
3. Adicionar pagina admin de sync em 1 clique para manter 999/9999 automatico.

## 26. Progresso desta execucao 11 (16/05/2026)
- Nova frente de revenda de softwares implementada para escalar o imperio Minike.
- Arquivo novo: `softwares/revenda.php` com:
  - landing comercial PT/EN para revendedores;
  - cadastro funcional de leads;
  - auto-criacao de tabela `mk_softwares_revendedores`;
  - captura de nome, email, WhatsApp, empresa, cidade, pais, idioma, experiencia, ticket e foco vertical;
  - vitrine de stack de revenda usando seeds Meta999.
- Integracao no portal de softwares:
  - `softwares/index.php` agora possui CTA direto para `revenda.php`.

- Nova frente kids para crescimento de games (foco criancas e retencao):
  - arquivo novo `games/kids.php`;
  - catalogo infantil dedicado por generos engajantes (puzzle, plataforma, arcade, aventura, simulacao, esporte);
  - trilhas de missao diaria, streak semanal e desafio educativo;
  - links diretos para jogar em `games/jogo.php`.
- Integracao no portal de games:
  - `games/index.php` agora possui menu `Kids`.

### Validacao desta execucao
- `php -l` OK em todos os arquivos alterados/criados.

### Proximo alvo direto
1. Criar painel interno de revendedores (lista de leads, status, aprovacao, metas).
2. Criar area kids com ranking infantil separado e sistema de medalhas.
3. Ligar revenda com afiliados para comissao recorrente automatica.

## 27. Consolidacao total das instrucoes legadas (16/05/2026)
- Esta secao substitui operacionalmente todo o conteudo util de:
  - `AGENTS.md`, `.agent.md`
  - `INSTRUCOES_PARA_PROXIMAS_IAS.md`, `INSTRUCOES_MINIKE.md`, `INSTRUCOES_LOCALIZAR_GERADOR_TEMPLATES.md`
  - `LEIA_PRIMEIRO.md`, `MAPA_CENTRAL_MINIKE.md`, `MINIKE_ACTIONS.txt`
  - `CORREï¿½ï¿½ES_E_MELHORIAS.md`, `DEPENDENCIAS.md`, `INDICE.md`, `QUICK_START.md`, `README_INSTALACAO.md`, `RESUMO_EXECUTIVO_SESSAO_5.md`, `RESUMO_INSTALACAO.md`

### 27.1 Missao permanente do Imperio Minike
1. Priorizar resultado comercial e monetizacao acima de ajustes visuais secundarios.
2. Entregar ecossistema funcional e completo em `ferramentas`, `games`, `cursos`, `escolar`, `softwares`, `sites`, `lojas`, `delivery`, `ads`, `erp`, `atendimento`.
3. Operar em PT/EN com precificacao BRL/USD e cross-sell em todos os hubs.
4. Meta estrutural: 999+ itens por vertical e automacao de expansao continua.

### 27.2 Regras tecnicas consolidadas
1. Banco unico obrigatorio: `u340626637_minike`.
2. Credenciais apenas por `.env`/loader, nunca hardcoded em codigo novo.
3. Todos os subdominios devem usar fallback gracioso quando DB estiver indisponivel.
4. Auto-criacao de tabelas permitida e recomendada para reduzir friccao de deploy.
5. Toda mudanca de arquitetura/fluxo deve ser registrada neste plano e no `.txt` espelho.

### 27.3 Padrao de execucao para qualquer nova tarefa
1. Implementar funcionalidade com foco em venda, retencao e recorrencia.
2. Validar sintaxe (`php -l`) em todos os arquivos tocados.
3. Atualizar `planominike.md` e `planominike.txt` na mesma execucao.
4. Nao depender de documentos externos: este plano e a unica referencia ativa.

### 27.4 Setup e ambiente (resumo final)
1. Ambiente alvo: Hostinger + PHP 8+ + MySQL/MariaDB + PDO MySQL + mbstring + curl + gd.
2. Dependencias opcionais para recursos avancados: Ghostscript e ImageMagick.
3. Se banco falhar (`SQLSTATE[HY000] [2002]`), manter site operante com seed local e reprocessar seeders depois.

### 27.5 Backlog macro consolidado
1. Conteudo em massa: ferramentas, games, cursos e escolar.
2. Revenda e afiliados: captacao, painel, comissoes, faturamento e recorrencia.
3. Ads internos e API ads: rotacao, governanca e relatorios.
4. Painel central: saude ecossistema, auditoria de config, monitor de monetizacao.
5. Experiencia kids em games: catalogo, ranking, badges e missao diaria.

### 27.6 Estado de diretriz
- A partir desta secao, considera-se 100% consolidado o conteudo util dos arquivos legados.
- Novas instrucoes devem entrar primeiro aqui nesta secao (ou em aditivos posteriores numerados), nunca em arquivos paralelos.

## 28. Progresso desta execucao 12 (16/05/2026)
- Consolidacao final de instrucoes legadas inserida no plano oficial:
  - nova secao `27` em `planominike.md` e `planominike.txt`.
  - plano passa a conter missao, regras tecnicas, padrao de execucao, setup final e backlog macro consolidado.

- Execucao continua (sem parar no planejamento) com foco em funcionalidade real:
  - novo painel operacional de revenda de softwares:
    - `softwares/revenda_admin.php`
    - lista leads, atualiza status e organiza pipeline comercial.
  - reforco da frente de revenda:
    - `softwares/revenda.php` ganhou atalho para admin.

  - nova camada funcional para games kids:
    - `games/salvar_kids_score.php` (endpoint para salvar pontuacao kids)
    - `games/kids_ranking.php` (ranking kids persistente em banco)
    - `games/kids.php` atualizado com formulario de envio de pontuacao e link de ranking.

### Validacao desta execucao
- `php -l` OK em todos os arquivos PHP novos/alterados.

### Proximo alvo direto
1. Integrar comissoes de revenda com modulo de afiliados (recorrencia e saque).
2. Criar medalhas kids e trilhas por idade dentro de games.
3. Leitura DB-first para escolar (temas/atividades) com fallback seed.

## 29. Progresso desta execucao 13 (16/05/2026)

- Objetivo executado: unificar identidade/sessao/plano entre painel principal e sub-sites.
- Criado `includes/mk_identity.php` com:
  - normalizacao de sessao (`usuario_id`/`user_id`)
  - carregamento de conta por `mk_usuarios` com fallback em `usuarios`
  - padronizacao de chaves globais (`tipo_conta`, `perfil`, `nivel`, `plano_slug`, `status_conta`)
  - helpers centrais: `mk_current_user()`, `mk_current_plan_slug()`, `mk_is_admin()`
- Integracao do bootstrap de identidade nos pontos principais:
  - `config.php`
  - `cursos/config.php`
  - `games/config.php`
  - `escolar/config.php`
  - `sites/config.php`
  - `delivery/config.php`
  - `lojas/conexao.php`
- Login global fortalecido em `login.php`:
  - prioriza `mk_usuarios`
  - fallback para `usuarios`
  - seta sessao unificada para todo o ecossistema
  - preserva compatibilidade com licencas legadas
- Painel mestre conectado ao novo guard de admin:
  - `painel_mestre.php` passa a usar `mk_is_admin()` quando disponivel.
- Validacao tecnica:
  - `php -l` sem erros para todos os arquivos alterados.

Proximo passo recomendado:
- aplicar o mesmo padrao de sessao compartilhada nos fluxos de cadastro/logout e migrar os modulos restantes para autenticacao 100% em `mk_usuarios`.

## 30. Progresso desta execucao 14 (16/05/2026)

- Leitura de plano realizada antes da execucao (fonte de verdade mantida).
- Hardening do tema dinamico:
  - `includes/site_theme_helpers.php`
    - nova funcao `studio195EnsureThemeConfigTable()`.
    - auto-criacao de `site_config` e `mk_configuracoes` (fallback de compatibilidade).
    - chamada automatica no `studio195GetCurrentSiteThemeInfo()`.
- Correcao critica do travamento no index de ferramentas:
  - `ferramentas/index.php`
    - timeout defensivo (`set_time_limit(25)`), tema padrao default (`$current_theme`, `$holiday_theme`), e handler global de excecao com tela de contingencia.
    - bootstrap seguro de `ferramentas/config.php` (banco unificado + auto-schema) sem derrubar a pagina.
    - scan de ferramentas otimizado com:
      - limite de arquivos por categoria;
      - leitura parcial de arquivo (64KB) para metadados;
      - corte por tempo de scan para evitar travamento.
    - log estruturado consolidado em `logs/ferramentas-index.log`.
- Confirmacao de arquivos de tema ja ativos na raiz:
  - `tema_css.php` (CSS dinamico)
  - `banner-tema.php` (SVG dinamico)
- Novo guia operacional criado para o dono/admin:
  - `INSTRUCOES_EXECUCAO_MINIKE.md`
  - contem checklist de `.env`, permissoes, cron, webhooks e validacao pos-deploy.

Validacao tecnica:
- `php -l` OK em:
  - `includes/site_theme_helpers.php`
  - `ferramentas/index.php`
  - `tema_css.php`
  - `banner-tema.php`

Proximo passo recomendado (execucao 15):
- aplicar o mesmo hardening anti-tela-branca em todos os `index.php` dos subdominios principais (`games`, `cursos`, `escolar`, `sites`, `delivery`, `softwares`, `lojas`) com tela de contingencia + log padrao.

## 31. Progresso desta execucao 15 (16/05/2026)

- Leitura do plano realizada antes de qualquer mudanca.
- Inicio da frente de correcoes do gerador de placas (templates) no projeto externo relacionado:
  - caminho identificado: `..\\ia\\195\\gerador\\wizard.js`
  - ajuste aplicado em `gerarPlacasFluxo()` para impedir queda no layout padrao quando houver template/frame:
    - prioridade para `window.Templates.ativo` + `window.aplicarTemplateNosProdutos()`;
    - detector de `smart_frame` no canvas para bloquear `canvas.clear()` indevido;
    - aviso explicito ao usuario quando template/frame existir sem estado ativo carregado.
- Consolidacao do banco unico + identidade compartilhada em configs que faltavam no ecossistema Minike:
  - `erp/config.php`
    - fallback PDO agora usa env (`DB_HOST`, `DB_PORT`, `DB_NAME`, `DB_USER`, `DB_PASS`), sem hardcode fixo;
    - integracao de `includes/mk_identity.php`.
  - `trabalhos/config.php`
    - integracao de `includes/mk_identity.php`.
  - `ads/config.php`
    - integra `pdo_ads` ao padrao global (`$GLOBALS['pdo']`) e carrega `includes/mk_identity.php`.
  - `ferramentas/config.php`
    - carga de `includes/mk_identity.php` apos db unificado.

Validacao tecnica:
- `php -l` OK em:
  - `erp/config.php`
  - `trabalhos/config.php`
  - `ads/config.php`
  - `ferramentas/config.php`

Proximo passo recomendado (execucao 16):
- continuar no gerador (`..\\ia\\195\\gerador`) removendo dependencia de `template-aplicar.js` e consolidando a aplicacao de smart frames 100% em `wizard.js`, com fallback controlado para Excel e mobile.

## 32. Progresso desta execucao 16 (16/05/2026)
- Iniciada correï¿½ï¿½o do fluxo de templates no gerador (pasta ia/195/gerador).
- Correï¿½ï¿½o crï¿½tica aplicada em gerador.php: removida sobrescrita indevida de plicarTemplateNosProdutos.
- Agora o fallback sï¿½ ï¿½ criado se o motor real de template nï¿½o existir, evitando cair no fluxo padrï¿½o por engano.
- Validaï¿½ï¿½o: php -l gerador.php sem erros.
- Prï¿½ximo passo: migrar aplicaï¿½ï¿½o de template em massa totalmente para wizard.js e remover dependï¿½ncia final de 	emplate-aplicar.js.

## 33. Progresso desta execucao 17 (16/05/2026)
- Gerador de templates: adicionado bridge nativo em ia/195/gerador/wizard.js (garantirMotorTemplate).
- O wizard agora sempre inicializa window.aplicarTemplateNosProdutos no load quando ausente.
- Com isso, mesmo com variaï¿½ï¿½o de ordem de scripts, o fluxo de template nï¿½o cai em funï¿½ï¿½o inexistente.
- Validaï¿½ï¿½o: 
ode --check wizard.js sem erros.
- Prï¿½ximo passo: migrar a lï¿½gica completa de 	emplate-aplicar.js para wizard.js e retirar include legado de gerador.php.

## 34. Progresso desta execucao 18 (16/05/2026)
- Gerador (ia/195/gerador): migraï¿½ï¿½o principal de templates para o wizard.js concluï¿½da.
- Implementado motor nativo no wizard:
  - patch de Templates.carregar para fluxo Aba 2 (seleï¿½ï¿½o de produtos)
  - window.aplicarTemplateNosProdutos nativo (geraï¿½ï¿½o em massa)
  - substituiï¿½ï¿½o por smart frames (oto, 
ome, preco, logo, ean, qr, livre)
  - criaï¿½ï¿½o de placas por template com thumb/json
- Compatibilidade mantida com alias window.TemplateAplicar.aplicar apontando para motor nativo.
- gerador.php: removido include legado 	emplate-aplicar.js.
- Validaï¿½ï¿½o: 
ode --check wizard.js e php -l gerador.php sem erros.
- Prï¿½ximo passo: QA funcional completo (template com 1, 10+ produtos; frames vazios; ean/qr; mobile).

## 35. Progresso desta execucao 19 (16/05/2026)
- QA tï¿½cnico do motor de templates nativo no wizard.js.
- Correï¿½ï¿½es aplicadas:
  - Remoï¿½ï¿½o preventiva de elementos legados (oto_produto, 
ome, preco, 
odape, codigo_barras, qr_code, anner) quando hï¿½ smart frames equivalentes no template, evitando duplicaï¿½ï¿½o visual.
  - Normalizaï¿½ï¿½o de preï¿½o para evitar exibiï¿½ï¿½o R$ NaN em entradas invï¿½lidas.
- Checagem: 
ode --check wizard.js ok.
- Estado atual: include de 	emplate-aplicar.js permanece removido e fluxo segue via motor nativo no wizard.

## 36. Progresso desta execucao 20 (16/05/2026)
- Criado novo mï¿½dulo software para subsite software.minike.com.br com foco em editor estilo Canva.
- Migraï¿½ï¿½o do gerador para software/editor (cï¿½pia da base atual do editor).
- Implementado sistema de contas + teste grï¿½tis:
  - software/_auth.php (PDO + auto-criaï¿½ï¿½o tabela software_users)
  - software/index.php (landing com modo teste grï¿½tis)
  - software/login.php, software/register.php, software/logout.php
  - software/app.php (gate de autenticaï¿½ï¿½o e carregamento do editor)
- Modo Canva aplicado no editor:
  - software/editor/gerador.php forï¿½a abertura no editor (Aba 3)
  - desativa visualmente Aba 2 e aï¿½ï¿½o ï¿½Novo Layoutï¿½
  - bloqueia busca de produtos pelo frontend
- Bloqueio backend da integraï¿½ï¿½o com Loja 195:
  - software/editor/api.php retorna 403 para uscar_placas e uscar_produto_por_id.
- Validaï¿½ï¿½o: sintaxe PHP ok em todos os novos arquivos.

## 37. Progresso desta execucao 21 (16/05/2026)
- Criados novos softwares de revenda no subsite software:
  - /software/apps/hub.php (hub comercial)
  - /software/apps/crm_lite.php (CRM de leads)
  - /software/apps/agenda_pro.php (agenda de atendimentos)
  - /software/apps/os_service.php (ordens de serviï¿½o)
- Criada base SaaS compartilhada em /software/apps/_bootstrap.php com auto-criaï¿½ï¿½o de tabelas:
  - pp_tenants, pp_crm_leads, pp_agenda_eventos, pp_os_ordens
- Fluxo de teste grï¿½tis por empresa (tenant) com trial 45 dias automï¿½tico.
- software/index.php atualizado com links diretos para os novos softwares.
- Validaï¿½ï¿½o: php -l OK em todos os arquivos novos e alterados.

## 38. Progresso desta execucao 22 (16/05/2026)
- Implementadas APIs comerciais e acessos vendï¿½veis no subsite software.
- Banco (auto-criado em runtime) expandido com:
  - pp_api_keys, pp_api_logs, pp_tool_access (em software/apps/_bootstrap.php)
- Criado painel de API por tenant:
  - software/apps/api_manager.php
  - gera/regenera API key
  - habilita/desabilita suites e ferramentas para venda
  - mostra logs e exemplos de consumo
- Criado endpoint de API pï¿½blica para clientes:
  - software/api/v1.php
  - aï¿½ï¿½es: ping, 	ools, ccess_links, invoke
  - autenticaï¿½ï¿½o por X-API-Key/key
  - rate limit por minuto
  - logging por chamada
  - ferramentas iniciais vendï¿½veis: 	ext.slugify, dev.hash_sha256, inance.roi, docs.wordcount
- Hub revenda e home do software atualizados com link do API Manager.
- Validaï¿½ï¿½o: php -l OK em todos os arquivos alterados.

## 39. Progresso desta execucao 23 (16/05/2026)
- Ajuste de rota e estrategia comercial no subdominio **softwares.minike.com.br** (pasta `softwares/`):
  - modelo oficial: **vende plano** ou **monetiza com anuncios**;
  - manter **demo gratis** e **testes gratis** para aquisicao.
- Reforco de UX comercial no portal:
  - `softwares/index.php` ganhou CTA direto para:
    - `app.php?demo=1` (teste gratis do editor estilo canva);
    - `apps/hub.php?demo=1` (demo dos softwares de revenda).
- Validacao de sintaxe executada com sucesso:
  - `softwares/_auth.php`
  - `softwares/app.php`
  - `softwares/apps/_bootstrap.php`
  - `softwares/apps/hub.php`
  - `softwares/api/v1.php`
- Politica de acesso ativa:
  - `demo/trial/free` com anuncios e limites;
  - `paid` sem bloqueios de demo;
  - API com quota de demo e retorno 429 ao exceder limite diario.
- Observacao operacional:
  - manter padrao de nomenclatura em **softwares/** para evitar divergencia com arvores antigas `software/`.

## 40. Pesquisa online: softwares faceis de criar/manter para revenda B2B (16/05/2026)

Fontes consultadas (online):
- SBA (EUA) - guia de gestao para pequenos negocios: https://www.sba.gov/business-guide/manage-your-business
- Sebrae PR - Pesquisa TIC 2025 (digitalizacao dos pequenos negocios): https://sebraepr.com.br/impulsiona/pesquisa-tic-2025-transformacao-digital-nos-pequenos-negocios
- Sebrae RS - Transformacao digital para pequenos negocios: https://digital.sebraers.com.br/blog/inovacao/transformacao-digital-pra-pequenos-negocios-mkt/
- G2 categorias de software (demanda SMB por categoria): https://www.g2.com/categories
- G2 State of Software (categorias com alta adocao empresarial): https://sell.g2.com/hubfs/state-of-software-may-2024.pdf
- Grand View Research - Time Tracking software market: https://www.grandviewresearch.com/industry-analysis/time-tracking-software-market-report

Leitura de mercado (inferencia pratica para Minike):
- Pequenos negocios adotam primeiro software de ganho imediato: vendas, financeiro, atendimento, agenda e operacao.
- Produtos simples de workflow (cadastro + status + relatorio) vendem mais facil e custam menos para manter.
- Time tracking, agenda e faturamento sao categorias com demanda recorrente e boa previsibilidade de receita.

### 40.1 Backlog de software facil para revenda (prioridade alta)

NIVEL A (muito facil, alta revenda, baixa manutencao):
1. CRM Lite para servicos locais (leads, funil, follow-up, WhatsApp)
2. Agenda de atendimentos (agendamento, lembretes, faltas)
3. Emissor de proposta/orcamento (PDF + aceite)
4. Controle simples de contratos recorrentes
5. Cobranca recorrente via PIX/link
6. Gestao de tarefas por equipe (kanban basico)
7. Helpdesk leve (tickets + SLA simples)
8. Gestao de documentos do cliente (upload e assinatura)
9. Form builder + captura de leads
10. Dashboard comercial (metas, conversao, receita)

NIVEL B (facil, excelente ticket para PMEs):
11. Controle de OS (ordem de servico)
12. Controle de estoque leve + reposicao minima
13. Controle de comissao de vendedores
14. Controle de contas a receber/pagar
15. Fluxo de caixa projetado
16. Cadastro e regua de cobranca de inadimplentes
17. Portal de cliente (2a via, chamados, status)
18. Chat interno por equipe
19. Roteirizador simples de visitas/entregas
20. Aprovacao interna (compras/despesas)

NIVEL C (moderado, revenda forte por nicho):
21. ERP micro para comercio local
22. Delivery local com painel operador
23. PDV web simplificado
24. Cardapio QR + pedidos
25. Gestao de clinicas (agenda + prontuario leve)
26. Gestao de escolas pequenas (matricula + boletim leve)
27. Gestao de academias (planos + check-in)
28. Gestao de oficinas (OS + pecas + historico)
29. Gestao de imobiliaria local (leads + visitas)
30. Gestao para pet shops (agenda + servicos)

NIVEL D (API as a product - facil de vender como modulo):
31. API de geracao de slug
32. API de hash/assinatura
33. API de word count e limpeza de texto
34. API de ROI e calculadoras financeiras
35. API de validacao de documento (camada basica)
36. API de webhook relay (eventos)
37. API de notificacao (email/whatsapp)
38. API de links curtos e tracking
39. API de upload e conversao de arquivo
40. API de templates e blocos prontos

### 40.2 Regra comercial recomendada (padrao Minike)
- Free/demo: com anuncios internos + limites de uso.
- Trial: 15 a 45 dias sem cartao para aumentar ativacao.
- Pago: remove anuncios, sobe limites, ativa API e automacoes.
- Revenda: codigo de parceiro + comissao por empresa ativa.

## 41. Ponto SaaS: cadastro automatico para revenda (16/05/2026)

Implementado no codigo:
- `softwares/ponto/empresa_conexao.php`
  - auto-criacao de tabelas do SaaS de ponto (schema garantido em runtime):
    - `ponto_empresas`
    - `ponto_funcionarios_saas`
    - `ponto_registros_saas`
    - `ponto_pagamentos_saas`
  - colunas de revenda adicionadas para rastrear origem:
    - `revendedor_codigo`
    - `origem_cadastro`

- `softwares/ponto/cadastro_empresa.php`
  - captura `?ref=CODIGO` automaticamente
  - salva `revendedor_codigo` e `origem_cadastro` no cadastro da empresa
  - empresa ja nasce em trial com token e acesso imediato

- `softwares/ponto/api_cadastro_empresa.php` (NOVO)
  - endpoint POST para cadastro automatico por revendedores/landing pages
  - cria empresa, inicia trial, gera token, devolve `painel_url` e `clock_url`
  - facilita onboard automatico sem operacao manual

Status:
- fluxo de revenda + auto-cadastro funcional
- pronto para integrar com landing pages, afiliados e campanhas pagas

## 42. Progresso desta execucao 24 (16/05/2026)
- Integracao comercial de revenda no Ponto SaaS concluida (tracking de conversao por parceiro).

Implementacao tecnica:
- `softwares/ponto/empresa_conexao.php`
  - nova tabela auto-criada: `ponto_revenda_leads`
    - campos: `empresa_id`, `revendedor_codigo`, `origem`, `plano`, `status`, `ip`, `user_agent`, `criado_em`
  - nova funcao: `saas_registrar_revenda(...)`
    - registra conversao quando cadastro veio por `ref`.

- `softwares/ponto/cadastro_empresa.php`
  - apos criar empresa, quando existir `ref`, grava lead convertido em `ponto_revenda_leads`.

- `softwares/ponto/api_cadastro_empresa.php`
  - endpoint API tambem grava conversao de revenda automaticamente quando recebe `ref`.

Impacto comercial:
- Cada revendedor passa a ter trilha de conversao mensuravel (quantas empresas cadastrou e em qual plano).
- Base pronta para comissionamento automatico por evento (cadastro, pagamento mensal, renovacao).

Validacao:
- `php -l` OK em:
  - `softwares/ponto/empresa_conexao.php`
  - `softwares/ponto/cadastro_empresa.php`
  - `softwares/ponto/api_cadastro_empresa.php`

## 43. Progresso desta execucao 25 (16/05/2026)
- Painel master de revenda do Ponto SaaS criado.

Arquivo novo:
- `softwares/ponto/revenda_painel.php`

Recursos entregues:
- Login protegido por senha de admin (`ADMIN_PASSWORD` do .env).
- KPIs comerciais:
  - total de parceiros (revendedores)
  - total de empresas convertidas por revenda
  - total em trial
  - total ativas
- Distribuicao por plano das empresas vindas de revenda.
- Ranking por `revendedor_codigo` com:
  - empresas totais
  - trial
  - ativas
  - ticket medio
  - MRR estimado
- Tabela de ultimas conversoes (data, parceiro, empresa, plano, status, preco, origem).

Observacao:
- Este painel usa os dados registrados em `ponto_revenda_leads` (criada automaticamente) e `ponto_empresas`.

Validacao:
- `php -l` OK em `softwares/ponto/revenda_painel.php`.

## 49. Progresso desta execucao 31 (16/05/2026)
- Expansao de ferramentas geradoras ativas no catalogo.

Arquivos novos criados:
- `ferramentas/gerador/nome.php` â€” gerador de nomes brasileiros (masculino/feminino/completo), PT/EN, JS puro.
- `ferramentas/gerador/email_fake.php` â€” gerador de emails falsos com dominio e quantidade selecionaveis, PT/EN.
- `ferramentas/gerador/endereco.php` â€” gerador de enderecos brasileiros por estado com CEP formatado, PT/EN.
- `ferramentas/gerador/uuid.php` â€” gerador de UUID v4 com opcoes de formato e quantidade, PT/EN.
- `ferramentas/gerador/barcode.php` â€” gerador de codigo de barras SVG/PNG via JsBarcode (EAN-13, Code128, Code39, etc.), PT/EN.

Arquivos alterados:
- `ferramentas/catalogo.php` â€” 5 entradas atualizadas de `breve` â†’ `ativo`:
  - `gerador/nome.php`, `gerador/email_fake.php`, `gerador/endereco.php`, `gerador/uuid.php`, `gerador/barcode.php`.
- `escolar/index.php` â€” adicionado botao "Colecao Meta999" no bloco de acesso rapido.
- `games/index.php` â€” adicionado link "Medalhas" no menu de navegacao.
- `sites/index.php` â€” hardening com `set_time_limit(25)` + try/catch ao redor de `require_once config.php`.

Arquivos maiores criados:
- `escolar/colecao.php` â€” colecao DB-first de temas escolares (`mk_meta999_escolar_temas`) com fallback seed, filtros por fase e tipo, agrupamento por fase com max 40 items, indicador de fonte, PT/EN.
- `games/medalhas.php` â€” sistema de medalhas DB-first com auto-criacao de tabelas `mk_games_medalhas` e `mk_games_medalhas_jogadores`, 12 medalhas seed via `INSERT IGNORE`, grade de conquistas do jogador vs bloqueadas (greyscale), stats grid, CTA premium, PT/EN.
- `ads/parceiro.php` â€” portal de parceiro com login/cadastro em abas, auto-criacao de `mk_ads_parceiros`, dashboard de consumo (saldo, requests, impressoes, clicks, CTR), listagem de API keys mascaradas, snippets de integracao (iframe/JSON), modelos comerciais prepago/mensal/revshare.

Validacao:
- Todos os arquivos novos/alterados passaram em `php -l`.

### Proximo alvo direto
1. Integrar comissoes de revenda de softwares com modulo de afiliados (`afiliados/`) para recorrencia e saque automatico.
2. Criar trilhas por idade dentro de `games/kids.php` (categorias por faixa etaria com missoes graduadas).
3. Criar `ferramentas/gerador/nf.php` (nota fiscal simulada â€” ainda listada como `breve` no catalogo).

## 50. Progresso desta execucao 32 (16/05/2026)
- Trilhas por idade para games kids implementadas.
- Integracao de comissoes de revenda Ponto SaaS com modulo global de afiliados.
- Gerador de Nota Fiscal simulada criado e ativado no catalogo.

Arquivos novos:
- `games/kids_trilhas.php` â€” hub de trilhas por faixa etaria (3-5, 6-8, 9-11, 12+) com missoes graduadas, jogos recomendados por faixa e CTA premium, PT/EN.
- `ferramentas/gerador/nf.php` â€” gerador de NF simulada com emitente, destinatario, itens dinamicos, preview HTML, copia de texto e impressao/PDF, PT/EN.

Arquivos alterados:
- `games/kids.php` â€” adicionado link "Trilhas por Idade" (kids_trilhas.php) no cabecalho do formulario de pontuacao.
- `ferramentas/catalogo.php` â€” `gerador/nf.php` atualizado de `breve` para `ativo`.
- `softwares/ponto/empresa_conexao.php` â€” `saas_processar_comissao_pagamento()` agora faz bridge com tabela global `afiliados`: quando o `revendedor_codigo` corresponde a um codigo de afiliado ativo, a comissao e creditada em `saldo_pendente` e `total_ganho` do afiliado no banco unificado.

Validacao:
- `php -l` OK em todos os arquivos novos/alterados.

### Proximo alvo direto
1. Criar mais ferramentas para preencher lacunas prioritarias no catalogo (calculo, texto, PDF, imagem).
2. Criar painel de afiliados/revenda unificado mostrando comissoes do Ponto SaaS ao lado das comissoes gerais.
3. Expandir `escolar` com paginas de materias especificas (matematica, portugues, ciencias) com aulas e atividades interativas.

## 51. Progresso desta execucao 33 (16/05/2026)
- Batch de ferramentas de alta demanda criadas e ativadas no catalogo.
- Pagina de materia escolar (matematica) criada com navegacao por fase.

Ferramentas novas (todas com status `ativo`):
- `texto/removedor_acentos.php` â€” remove acentos com opcoes slug e lowercase, PT/EN.
- `texto/sorter_linhas.php` â€” ordena linhas A-Z, Z-A, numerica, tamanho, aleatorio, PT/EN.
- `texto/removedor_duplicatas.php` â€” remove linhas duplicadas com stats antes/depois, PT/EN.
- `calculo/combustivel.php` â€” 3 abas: custo viagem, mensal e comparador etanol vs gasolina, PT/EN.
- `calculo/gorjeta.php` â€” gorjeta com pessoas, tabela rapida e cÃ¡lculo por pessoa, PT/EN.
- `calculo/cronometro.php` â€” cronometro com laps, timer regressivo com alarme e Pomodoro, PT/EN.
- `calculo/horas.php` â€” 4 modos: diferenca horarios, somar horas, decimal<->HH:MM, jornada semanal, PT/EN.
- `calculo/area.php` â€” area e perimetro de 8 figuras com preview SVG e multiplas unidades, PT/EN.

Paginas escolares novas:
- `escolar/matematica.php` â€” hub de matematica por fase (Infantil/Fund1/Fund2/Medio) com temas, niveis de dificuldade, aulas gratis (primeiros 2 por fase), links para ferramentas e upsell premium.
- `escolar/index.php` â€” adicionado botao "Matematica" no bloco de acesso rapido.

`ferramentas/catalogo.php` â€” 8 entradas atualizadas de `breve` â†’ `ativo`.

Validacao:
- `php -l` OK em todos os arquivos novos/alterados.

### Proximo alvo direto
1. Criar `escolar/portugues.php` (lingua portuguesa por fase) e `escolar/ciencias.php`.
2. Criar `calculo/volume.php` e `calculo/estatistica.php` para fechar as lacunas restantes.
3. Criar mais ferramentas de texto breve: `texto/formatador_json.php` (ja existe em desenvolvedor), `texto/criptografador.php`, `texto/texto_aleatorio.php`.

## 52. Progresso desta execucao 34 (16/05/2026)
- Continuacao direta da exec 33: entregues os itens pendentes listados no "proximo alvo" e expansao do catalogo de ferramentas.

Ferramentas novas (todas com status `ativo`):

calculo/:
- `calculo/proporcao.php` â€” 4 abas: regra de tres direta/inversa, porcentagem (3 calculos), fracoes (4 operacoes + simplificacao) e conversao de escala, PT/EN.
- `calculo/margem.php` â€” 4 abas: margem de lucro, markup, preco de venda ideal (com despesas fixas), ROI; formatacao BRL, PT/EN.
- `calculo/indice.php` â€” 4 abas: IMC (com faixa ideal de peso), indices de liquidez corrente/seca, endividamento/ativo e patrimonio, rentabilidade (margem liquida, ROA), PT/EN.
- `calculo/estatistica.php` â€” media, mediana, moda, variancia, desvio padrao (amostral/populacional), Q1 Q3 IQR CV min max amplitude; grafico de frequencia; auto-calcula ao carregar, PT/EN.
- `calculo/volume.php` â€” volume de 7 solidos (cubo, caixa, esfera, cilindro, cone, piramide, prisma) com preview SVG, conversao para litros e area da superficie, PT/EN.

texto/:
- `texto/criptografador.php` â€” 5 abas: cifra Cesar, ROT13, Vigenere, Base64 (encode/decode), inversao (chars/palavras/linhas), PT/EN.
- `texto/texto_aleatorio.php` â€” 8 tipos (lorem ipsum, palavras PT/EN, frases, paragrafos, nomes, emails, HEX), 4 formatos de saida, qtd 1-200, PT/EN.
- `texto/contador_linhas.php` â€” conta linhas/palavras/chars/sentencas/paragrafos, tempo de leitura, top-10 palavras com barra de frequencia, PT/EN.
- `texto/anagramas.php` â€” 3 abas: gerar todas permutacoes (ate 8 letras) ou amostra, verificar se duas palavras sao anagramas, embaralhar letras com historico, PT/EN.
- `texto/texto_ascii.php` â€” converte texto em ASCII art com 7 estilos (block, banner, shadow, letters, double, graffiti, mini), copiar resultado, PT/EN.
- `texto/diff_arquivos.php` â€” diff linha a linha com LCS, realce colorido (verde=adicionado, vermelho=removido), contador de stats, auto-demo ao carregar, PT/EN.
- `texto/gerador_sentencas.php` â€” 7 tipos (simples, complexa, pergunta, dialogo, micro-historia, motivacional, absurdo), idioma PT/EN separado, exportar, PT/EN.

Paginas escolares novas:
- `escolar/portugues.php` â€” hub de lingua portuguesa por fase (Infantil/Fund1/Fund2/Medio) com temas, niveis, aulas gratis e upsell. Criado na exec 33.
- `escolar/ciencias.php` â€” hub de ciencias (bio/qui/fis) por fase com mesma estrutura. Cross-links para ferramentas de calculo. PT/EN.
- `escolar/index.php` â€” adicionados botoes "Portugues" (exec 33) e "Ciencias" (esta exec).

`ferramentas/catalogo.php` â€” 15 entradas de `breve` â†’ `ativo` nesta exec (proporcao, indice, margem, contador_linhas, anagramas, texto_ascii, diff_arquivos, gerador_sentencas; as anteriores foram na exec 33).

Validacao:
- `php -l` OK em todos os 9 arquivos novos desta exec.

### Proximo alvo direto
1. Criar `texto/formatador_sql.php` e `texto/formatador_html.php` (formatadores de codigo).
2. Painel de afiliados unificado: mostrar comissoes Ponto SaaS junto com comissoes gerais.
3. Rever catalog para identificar proximos `breve` com maior retorno.

## 53. Progresso desta execucao 35 (16/05/2026)
- Continuacao da expansao: layout_ferramenta.php corrigido, mais ferramentas criadas.

Correcao critica:
- `ferramentas/layout_ferramenta.php` â€” suportava apenas `$tool_tit` como array. Corrigido para aceitar tanto string quanto array (is_array check). Tambem adicionado fallback `$tool_content` alias de `$conteudo_ferramenta` para compatibilidade com converters antigos.

Ferramentas novas (todas com status `ativo`):

converter/:
- `converter/romano.php` â€” converte arÃ¡bicoâ†”romano (1-3999) com decomposiÃ§Ã£o por sÃ­mbolo, tabela de referÃªncia, PT/EN.
- `converter/potencia.php` â€” converte W, kW, MW, HP, PS, BTU/h, cal/s, kcal/h, ftÂ·lbf/s; auto-conversao em tempo real, PT/EN.
- `converter/bits.php` â€” converte Bit/B/KB/MB/GB/TB/PB com modos SI (decimal) e IEC (binÃ¡rio/KiB/MiB), PT/EN.

desenvolvedor/:
- `desenvolvedor/uuid.php` â€” gera UUID v4, NIL, Short ID, Nano ID, HEX32 em lote; valida UUIDs; 4 formatos saida, PT/EN.
- `desenvolvedor/regex.php` â€” testa regex em tempo real com highlights coloridos, grupos de captura, substituiÃ§Ã£o e biblioteca de 10 padrÃµes prontos (email, URL, CPF, CNPJ, IPv4...), PT/EN.
- `desenvolvedor/validar_email.php` â€” valida email individual (5 checks: formato, tamanho, pontos, disposable, TLD) e em lote com exportacao dos vÃ¡lidos, PT/EN.
- `desenvolvedor/validador_json.php` â€” valida, formata, minifica JSON; exibe Ã¡rvore com highlight de busca; estatÃ­sticas (chaves, profundidade, arrays, tamanho), PT/EN.

matematica/:
- `matematica/equacao_2grau.php` â€” resolve axÂ²+bx+c=0 com Bhaskara passo a passo, discriminante, raÃ­zes reais/complexas, vÃ©rtice, grÃ¡fico da parÃ¡bola via Canvas, PT/EN.

financeiro/:
- `financeiro/parcelas.php` â€” 3 abas: Price (parcela fixa com tabela detalhada), SAC (amortizacao constante), Comparador Price vs SAC com economia total, PT/EN.

`ferramentas/catalogo.php` â€” 10 entradas atualizadas de `breve` â†’ `ativo` nesta exec.
`escolar/index.php` â€” adicionado botao "Ciencias" linkando ciencias.php.

Validacao:
- `php -l` OK em todos os 10 arquivos novos/alterados desta exec.

### Proximo alvo direto
1. Criar `saude/sono.php`, `saude/calorias_exercicio.php`, `saude/proteina.php` (saÃºde simples).
2. Criar `matematica/trigonometria.php` e `matematica/logaritmos.php`.
3. Criar `desenvolvedor/validador_json.php` (jÃ¡ feito), `desenvolvedor/minificador.php`.
4. Painel de afiliados unificado com comissoes Ponto SaaS.

## 54. Progresso desta execucao 36 (16/05/2026)
- Nova rodada de criaÃ§Ã£o de ferramentas. Catalogo chega a 170 ativas / 96 breves (266 total).

Ferramentas novas (todas com status `ativo`):

saude/:
- `saude/sono.php` â€” 3 abas: calcular horÃ¡rio para dormir dado horÃ¡rio acordar, calcular horÃ¡rio acordar dado horÃ¡rio dormir, tabela de horas necessÃ¡rias por faixa etÃ¡ria; ciclos de 90 min com indicador qualidade, PT/EN.
- `saude/calorias_exercicio.php` â€” 22 exercÃ­cios com MET; calcula kcal queimadas por peso e duraÃ§Ã£o; filtro por nome; ordenado por calorias decrescentes; barra visual, PT/EN.
- `saude/proteina.php` â€” calcula ingestÃ£o proteica diÃ¡ria por objetivo (manutenÃ§Ã£o/hipertrofia/emagrecimento/performance) e nÃ­vel atividade; suporte a massa magra via % gordura; distribuiÃ§Ã£o por nÂº de refeiÃ§Ãµes; tabela de 15 fontes proteicas, PT/EN.

converter/:
- `converter/romano.php` â€” arÃ¡bicoâ†”romano 1-3999 com decomposiÃ§Ã£o por sÃ­mbolo e tabela referÃªncia, PT/EN.
- `converter/potencia.php` â€” W, kW, MW, HP, PS, BTU/h, cal/s, kcal/h, ftÂ·lbf/s; auto-conversÃ£o, PT/EN.
- `converter/bits.php` â€” Bit/B/KB/MB/GB/TB/PB modos SI e IEC, PT/EN.

desenvolvedor/:
- `desenvolvedor/uuid.php` â€” UUID v4/NIL/Short/NanoID/HEX32 em lote, validador, 4 formatos, PT/EN.
- `desenvolvedor/regex.php` â€” testa regex em tempo real, highlights, grupos, substituiÃ§Ã£o, biblioteca 10 padrÃµes, PT/EN.
- `desenvolvedor/validar_email.php` â€” individual (5 checks) + lote + exportar vÃ¡lidos, PT/EN.
- `desenvolvedor/validador_json.php` â€” valida/formata/minifica JSON, Ã¡rvore com busca, estatÃ­sticas, PT/EN.

matematica/:
- `matematica/equacao_2grau.php` â€” Bhaskara passo a passo, delta, raÃ­zes reais/complexas, vÃ©rtice, Canvas parÃ¡bola, PT/EN.

financeiro/:
- `financeiro/parcelas.php` â€” Price (parcela fixa + tabela), SAC (amort. constante), Comparador Price vs SAC, PT/EN.

`ferramentas/layout_ferramenta.php` â€” corrigido para aceitar $tool_tit como string ou array; fallback $tool_content.

`ferramentas/catalogo.php` â€” 13 entradas atualizadas de `breve` â†’ `ativo` nesta exec.

Validacao:
- `php -l` OK em todos os 12 arquivos novos e 1 alterado desta exec.

### Proximo alvo direto
1. Criar `matematica/trigonometria.php` e `matematica/logaritmos.php`.
2. Criar `desenvolvedor/minificador.php` (minifica CSS/JS no browser).
3. Criar `data_hora/timestamp.php` e `data_hora/feriados.php`.
4. Painel de afiliados unificado com comissoes Ponto SaaS.

## 44. Progresso desta execucao 26 (16/05/2026)
- Painel de revenda do Ponto recebeu filtros por periodo + exportacao CSV.

Arquivo alterado:
- `softwares/ponto/revenda_painel.php`

Novos recursos:
- Filtros de periodo:
  - tudo
  - hoje
  - ultimos 7 dias
  - ultimos 30 dias
  - personalizado (data inicial/final)
- Todos os KPIs e tabelas do painel agora respeitam o filtro selecionado.
- Exportacao CSV das ultimas conversoes com os mesmos filtros aplicados.

Colunas do CSV:
- data, revendedor, empresa, email, plano, status, preco_mensal, origem

Validacao:
- `php -l` OK em `softwares/ponto/revenda_painel.php`.

## 45. Progresso desta execucao 27 (16/05/2026)
- Painel de revenda do Ponto recebeu camada financeira de comissionamento estimado.

Arquivo alterado:
- `softwares/ponto/revenda_painel.php`

Novidades:
- Percentual de comissï¿½o configurï¿½vel por `.env`:
  - `PONTO_REVENDA_COMISSAO` (padrï¿½o: 20%)
- Ranking agora exibe:
  - MRR ativo (somente empresas com status `ativo`)
  - comissï¿½o estimada por revendedor (MRR ativo x % comissï¿½o)
- Nova exportaï¿½ï¿½o:
  - `export=ranking_csv` com colunas:
    - revendedor
    - empresas_total
    - empresas_trial
    - empresas_ativas
    - ticket_medio
    - mrr_ativo
    - comissao_pct
    - comissao_estimada

Resultado:
- operaï¿½ï¿½o comercial passa a ter visï¿½o de receita e custo de canal no mesmo painel.

Validacao:
- `php -l` OK em `softwares/ponto/revenda_painel.php`.

## 46. Progresso desta execucao 28 (16/05/2026)
- Comissï¿½o real automatica implementada no Ponto SaaS quando pagamento e confirmado.

Arquivos alterados:
- `softwares/ponto/empresa_conexao.php`
- `softwares/ponto/revenda_painel.php`

Detalhes tecnicos:
- Nova tabela auto-criada:
  - `ponto_revenda_comissoes`
  - guarda comissao efetiva por pagamento (`pagamento_id` unico), base, %, valor e status.
- Novas funcoes de dominio:
  - `saas_registrar_pagamento_empresa(...)`
  - `saas_processar_comissao_pagamento(...)`
- Fluxo:
  1) pagamento da empresa e registrado/atualizado em `ponto_pagamentos_saas`
  2) se status for `pago`, sistema calcula comissao usando `PONTO_REVENDA_COMISSAO`
  3) grava/atualiza em `ponto_revenda_comissoes` sem duplicidade.

Painel de revenda:
- Novo KPI: `Comissï¿½o Real (R$)` baseado em pagamentos efetivamente marcados como pagos.
- Nova acao operacional por empresa na tabela de conversoes:
  - botao `Registrar Pago` (valor editavel) para confirmar pagamento e gerar comissao real.

Validacao:
- `php -l` OK em:
  - `softwares/ponto/empresa_conexao.php`
  - `softwares/ponto/revenda_painel.php`

## 47. Progresso desta execucao 29 (16/05/2026)
- Estorno financeiro implementado no Ponto SaaS com reversao de comissao real.

Arquivos alterados:
- `softwares/ponto/empresa_conexao.php`
- `softwares/ponto/revenda_painel.php`

Detalhes:
- Nova funcao: `saas_estornar_pagamento_empresa($pagamento_id)`
  - muda status do pagamento para `cancelado`
  - marca comissao vinculada como `estornada`
  - operacao transacional (commit/rollback)
- Painel de revenda ganhou bloco `Pagamentos e Estornos`:
  - lista pagamentos recentes + status de comissao
  - botao `Estornar` quando status estiver `pago`
- Fluxo completo agora cobre:
  - confirmar pagamento -> gerar comissao real
  - estornar pagamento -> reverter comissao real

Validacao:
- `php -l` OK nos arquivos alterados.

## 48. Progresso desta execucao 30 (16/05/2026)
- Relatorio de repasse por parceiro implementado no painel de revenda do Ponto.

Arquivo alterado:
- `softwares/ponto/revenda_painel.php`

Novidades:
- Bloco novo: `Relatï¿½rio de Repasse por Parceiro`
  - total confirmado
  - total estornado
  - total liquido a pagar
- Tudo respeita o filtro de periodo (all/today/7d/30d/custom).
- Nova exportacao CSV:
  - `export=repasse_csv`
  - colunas: revendedor, total_confirmado, total_estornado, total_liquido

Resultado:
- Financeiro operacional pronto para fechamento de repasse mensal/semanal.

Validacao:
- `php -l` OK em `softwares/ponto/revenda_painel.php`.

## 55. Progresso desta execucao 37 (16/05/2026)
- Retomada da sessao anterior. Continuacao da expansao do catalogo de ferramentas.
- Catalogo chega a 178 ativas / 88 breves (266 total).

Ferramentas novas (todas com status `ativo`):

matematica/:
- `matematica/trigonometria.php` â€” sin/cos/tan/cot/sec/csc, toggle graus/radianos, tabela valores notaveis, PT/EN.
- `matematica/logaritmos.php` â€” logâ‚â‚€/ln/logâ‚‚/base customizada, passo a passo, propriedades, tabela de potencias clicavel, PT/EN.
- `matematica/matrizes.php` â€” A+B, A-B, AÃ—B, transposta, determinante (ate 4x4), inversa (Gauss-Jordan), escalar; grids editaveis ate 4x4, PT/EN.

data_hora/:
- `data_hora/timestamp.php` â€” contador ao vivo, timestampâ†’data (auto-detecta ms vs s), dataâ†’timestamp, 6 referencias clicaveis, PT/EN.
- `data_hora/feriados.php` â€” feriados nacionais BR para qualquer ano 2000-2100; Pascoa/Carnaval/Corpus Christi via algoritmo Meeus-Jones-Butcher; proximo feriado com contagem de dias; filtro por mes; indicadores fixo/movel/hoje, PT/EN.

desenvolvedor/:
- `desenvolvedor/minificador.php` â€” minifica CSS e JS no browser; remove comentarios, espacos, quebras de linha; barra de economia em bytes/%; demo pre-carregado, PT/EN.

saude/:
- `saude/frequencia_cardiaca.php` â€” FC max por Tanaka/220-idade/Gulati; zonas de treino (Karvonen 5 zonas); tabela de classificacao FC repouso; toggle M/F, PT/EN.
- `saude/pressao_arterial.php` â€” classifica por SBC/AHA: otima/normal/limitrofe/est1-3/hipotensao; PAM, pressao de pulso, razao S/D; tabela clicavel; dicas de medicao corretas, PT/EN.

catalogo.php â€” 8 entradas atualizadas de `breve` â†’ `ativo` (trigonometria, timestamp, logaritmos, minificador, feriados, frequencia_cardiaca, pressao_arterial, matrizes).

Validacao:
- `php -l` OK em todos os 8 arquivos novos desta exec.

### Proximo alvo direto
1. Criar `converter/frequencia.php`, `converter/consumo.php`, `converter/resolucao.php`, `converter/fluxo.php`.
2. Criar `texto/formatador_sql.php` e `texto/formatador_html.php`.
3. Criar `desenvolvedor/diff.php` (diff de codigo lado a lado).
4. Criar `data_hora/horas_trabalho.php` (calculadora de horas uteis).
5. Criar `financeiro/imposto.php`, `financeiro/aluguel.php`, `financeiro/ipca.php`.

## 56. Progresso desta execucao 38 (16/05/2026)
- Continuacao da expansao do catalogo. Catalogo chega a 191 ativas / 78 breves (269 total, +3 da categoria Copa).

Ferramentas novas (todas com status `ativo`):

converter/:
- `converter/frequencia.php` â€” Hz/kHz/MHz/GHz/THz/RPM/rad-s/kRPM, referencias comuns, PT/EN.
- `converter/consumo.php` â€” km/L, L/100km, mpg-US, mpg-UK, km/galao, miles/L; calculadora de custo mensal, PT/EN.
- `converter/resolucao.php` â€” larguraÃ—altura, diagonal em polegadas; calcula PPI, aspect ratio, total de pixels; tabela 9 padroes (SD/HD/FHD/2K/4K/5K/8K), PT/EN.
- `converter/fluxo.php` â€” L/s, L/min, L/h, mÂ³/s, mÂ³/min, mÂ³/h, GPM-US, GPM-UK, ftÂ³/s, cL/s; referencias praticas, PT/EN.

texto/:
- `texto/formatador_sql.php` â€” formata/minifica SQL no browser; UPPERCASE keywords, indenta AND/OR, demo pre-carregado, PT/EN.
- `texto/formatador_html.php` â€” formata/minifica HTML; tokenizer de tags, void elements, inline elements, opcao 2/4 espacos ou tab, PT/EN.

desenvolvedor/:
- `desenvolvedor/diff.php` â€” diff LCS lado a lado com numeros de linha, verde=adicionado, vermelho=removido, demo pre-carregado, PT/EN.

data_hora/:
- `data_hora/horas_trabalho.php` â€” registro diario (entrada/saida/intervalo), total/media/estimativa semanal; calculadora de valor/hora e hora extra CLT, PT/EN.

financeiro/:
- `financeiro/imposto.php` â€” 4 abas: IRPF 2024/2025 (tabela progressiva), INSS CLT/autonomo (tabela progressiva), ISS (2%-5%), Salario Liquido (bruto - INSS - IR com dependentes), PT/EN.
- `financeiro/ipca.php` â€” reajuste por IPCA/IGP-M/SELIC; presets 2015-2025; historico anual clicavel; multiplicador, PT/EN.

copa/ (nova categoria):
- `copa/album.php` â€” marcador de figurinhas Copa 2026; 6 grupos + paginas especiais; botoes individuais por figurinha; salvo em localStorage; estatisticas por selecao e progresso global, PT/EN.
- `copa/bolao.php` â€” palpites Copa 2026; aba grupos (todos os jogos de cada grupo, tabela de classificacao ao vivo); oitavas/quartas/semi/final com inputs de times e placares; salvo em localStorage, PT/EN.
- `copa/grupos.php` â€” todos os 6 grupos Copa 2026 com bandeiras/confederacao/ranking FIFA; filtro por confederacao (CONMEBOL/UEFA/CAF/AFC/CONCACAF); tabela das 16 sedes com capacidade, PT/EN.

catalogo.php â€” 13 ferramentas atualizadas de `breve` â†’ `ativo` + nova categoria `copa` com 3 ferramentas direto como `ativo`.

Validacao:
- `php -l` OK em todos os 13 arquivos novos desta exec.

### Proximo alvo direto
1. Criar `gerador/cpf_multiplos.php` (gerador em lote).
2. Criar `desenvolvedor/validador_xml.php` e `desenvolvedor/htaccess.php`.
3. Criar `financeiro/aluguel.php` (simulador reajuste aluguel).
4. Criar `financeiro/fgts.php` (simulador saldo FGTS).
5. Criar `social/bio_twitter.php`, `social/legenda.php`, `social/engajamento.php`.
6. Criar ferramentas `negocios/`: lucro, markup, contrato simples.

## 57. Progresso desta execucao 39 (16/05/2026)
- Objetivo: corrigir erros deixados por outra IA para os subdominios abrirem com banco unificado e auto-criacao segura de colunas.
- Criado helper central em `includes/db.php`:
  - `mk_db_ident_ok()` valida nomes de tabela/coluna.
  - `mk_db_column_exists()` consulta `INFORMATION_SCHEMA` no banco atual.
  - `mk_db_ensure_column()` cria coluna somente se faltar, evitando `ADD COLUMN IF NOT EXISTS` incompatÃ­vel com algumas versoes do MySQL/MariaDB da Hostinger.
- Corrigido `central_cliente.php`:
  - removido `ALTER TABLE ... ADD COLUMN IF NOT EXISTS` multi-coluna.
  - agora usa `mk_db_ensure_column()` para `planos.slug`, `preco_anual`, `icone`, `destaque`, `ativo`.
- Criado `includes/minike_db.php`:
  - shim de compatibilidade para paginas antigas que chamam `MinikeDB::connect()`.
  - evita fatal em `central_cliente.php` e outros arquivos legados.
- Corrigido `checkout.php`:
  - trocado teste errado `function_exists('MinikeDB::connect')` por `class_exists('MinikeDB')`.
  - corrigido erro de aspas no link de Mercado Pago que quebrava `php -l` na linha do `href`.
- Corrigidos includes comerciais:
  - `includes/pagamentos_unificado.php` usa `class_exists('MinikeDB')`.
  - `includes/afiliados.php` e `includes/planos_limites.php` carregam `includes/minike_db.php` quando necessario.
  - `includes/ads_market.php` passa a carregar `includes/minike_db.php` em vez de apenas `includes/db.php`.
- Corrigido cursos:
  - `cursos/config.php` cria tabelas minimas `cursos` e `aulas` se faltarem e usa `mk_db_ensure_column()` para `instrutor`, `creditos`, `autor`, `direitos`.
  - `cursos/index.php` usa `mk_db_ensure_column()` para `mk_cursos_cursos.nivel`, `aulas`, `idioma_curso`, `destaque`.
- Expandido Ponto SaaS no banco unificado:
  - `includes/db.php` garante colunas extras em `ponto_empresas` e `ponto_pagamentos_saas`.
  - cria tabelas `ponto_revenda_leads` e `ponto_revenda_comissoes`.
  - `softwares/ponto/empresa_conexao.php` tambem garante essas colunas em runtime.
- Criado modulo do subdominio `atendimento.minike.com.br`:
  - `atendimento/config.php` cria tabelas `mk_atendimento_clientes`, `mk_atendimento_tickets`, `mk_atendimento_mensagens`, `mk_atendimento_canais` e colunas extras automaticamente.
  - `atendimento/index.php` landing SaaS vendavel com planos Free Demo, Basic, Pro e White Label.
  - `atendimentos/config.php` e `atendimentos/index.php` espelham o modulo para o plural caso o subdominio antigo esteja apontado para essa pasta.
- Validacao executada:
  - `php -l` OK em `includes/db.php`, `includes/minike_db.php`, `central_cliente.php`, `checkout.php`, `cursos/config.php`, `cursos/index.php`, `softwares/ponto/empresa_conexao.php`, `includes/pagamentos_unificado.php`, `includes/afiliados.php`, `includes/planos_limites.php`, `includes/ads_market.php`, `atendimento/*`, `atendimentos/*`.
  - rodada ampla `php -l` OK nos entrypoints/configs de `minike`, `lojas`, `sites`, `ads`, `games`, `erp`, `delivery`, `ferramentas`, `trabalhos`, `cursos`, `escolar`, `softwares`, `atendimento`, `atendimentos`.
- Proximo alvo recomendado:
  1. Criar um verificador web protegido para listar subdominios, status do banco e tabelas/colunas faltantes.
  2. Padronizar todos os subdominios para exibirem erro amigavel quando o banco estiver offline.
  3. Criar admin simples para o modulo Atendimento com CRUD de tickets/clientes e planos.

## 58. Correcao rapida homepage CSS bruto (16/05/2026)
- Corrigido `index.php`: havia um `</style>` fechado antes da hora na area da homepage.
- O trecho CSS de `.aff-cta`, `.eco-grid`, `.footer` e media queries mobile estava fora da tag `<style>`, podendo aparecer como texto cru na pagina principal.
- Movido `<?php renderMinikeThemeAssets(); ?>` para depois do fechamento real do bloco CSS.
- Validacao: `php -l index.php` OK.

## 59. PARADA DE EMERGENCIA - Varredura de erros interrompida (16/05/2026)

### Motivo da parada
- Felipe pediu para parar tudo por falta de tempo.
- Esta secao registra exatamente o que foi feito, onde parou e o que a proxima IA deve fazer antes de continuar qualquer feature nova.

### Pedido original desta execucao
- Corrigir sites que nao estavam funcionando.
- Erro reportado em producao:
  - `Fatal error: Uncaught Error: Call to undefined method MinikeAds::rede() in /escolar/index.php:194`
- Felipe tambem relatou que `ferramentas` nao abre / fica travado.

### Arquivos corrigidos nesta execucao antes da parada
1. `ads/engine.php`
   - Adicionados metodos de compatibilidade na classe `MinikeAds`:
     - `listar()`
     - `banner()`
     - `sidebar()`
     - `meio()`
     - `popup()`
     - `modal()`
     - `rede()`
     - `fallbackCard()`
   - Objetivo: paginas que carregam `ads/engine.php` em vez de `includes/ads_internos.php` agora nao quebram ao chamar `MinikeAds::rede()`.
   - Adicionado guard:
     - `if (class_exists('MinikeAds', false)) { return; }`
   - Objetivo: evitar fatal de classe duplicada se outra versao de `MinikeAds` ja tiver sido carregada.

2. `includes/ads_internos.php`
   - Adicionado guard:
     - `if (class_exists('MinikeAds', false)) { return; }`
   - Objetivo: evitar `Cannot declare class MinikeAds` se `ads/engine.php` tiver sido carregado antes.

3. `includes/mercado_pago_produtos.php`
   - Corrigido erro de sintaxe:
     - antes: `'titulo' => Premium Anual',`
     - depois: `'titulo' => 'Premium Anual',`

4. `cursos/admin/categorias.php`
   - Corrigidos `echo` com aspas quebradas nas linhas de mensagem vazia/erro.
   - Antes usava aspas duplas dentro de aspas duplas e quebrava o PHP.

5. `sites/index_backup.php`
   - Corrigida linha quebrada de `onerror` com PHP dentro de atributo HTML.
   - Agora o fallback de anuncio/banner fica em bloco PHP/HTML normal.
   - Observacao: e arquivo backup, mas estava quebrado no lint e poderia ser publicado por engano.

6. `ferramentas/admin/index.php`
   - Corrigido parcialmente o arquivo que estava com HTML dentro de PHP aberto.
   - Inserido esqueleto HTML (`<!doctype>`, `<head>`, Tailwind, FontAwesome, `<body>`) e `<?php if (!$isAdmin): ?>` antes da tela de login.
   - Depois da correcao, `php -l ferramentas/admin/index.php` passou OK.

### Validacoes executadas antes da parada
- `php -l ads/engine.php` OK.
- `php -l includes/ads_internos.php` OK.
- Varredura ampla com:
  - `rg --files -g "*.php" -g "!**/vendor/**" -g "!**/*(1).php"` + `php -l`
- Resultado naquele momento:
  - `PHP_LINT_ALL_OK`
- ATENCAO: depois disso comecei uma correcao do Ponto e ela ficou INCOMPLETA. Ver proxima secao.

### Onde parou / estado critico deixado para proxima IA
Depois do lint geral OK, a busca em logs encontrou fatais antigos do sistema de Ponto:
- `Cannot redeclare cellHora()` em:
  - `softwares/ponto/ver_folha.php`
  - `ferramentas/ponto/ver_folha.php`
  - `softwares/software/ponto/ver_folha.php`
- `mysqli_stmt::bind_param(): Argument #5 could not be passed by reference` em:
  - `softwares/ponto/salvar_modal.php`
  - `ferramentas/ponto/salvar_modal.php`
  - `softwares/software/ponto/salvar_modal.php`

Foi tentada uma correcao automatica nesses arquivos, mas ela ficou incompleta porque Felipe pediu parada antes de revisar.

### Arquivos que precisam ser revisados PRIMEIRO na proxima retomada
1. `softwares/ponto/ver_folha.php`
2. `ferramentas/ponto/ver_folha.php`
3. `softwares/software/ponto/ver_folha.php`

Status atual conhecido desses 3 arquivos apos tentativa de patch:
- `php -l` reportou:
  - `Parse error: syntax error, unexpected token "endforeach" on line 561`
- Provavel causa:
  - a tentativa de envolver `function cellHora()` com `if (!function_exists('cellHora')) { ... }` inseriu/alterou chaves de forma errada dentro do `foreach`.
- Instrucao clara:
  - abrir em torno das linhas 521-561.
  - garantir que `cellHora()` NAO fique declarada dentro do `foreach`.
  - mover a funcao inteira para antes do loop, ou usar `if (!function_exists('cellHora')) { function cellHora(...) { ... } }` fora do `foreach`.
  - depois rodar `php -l` nos 3 arquivos.

### Instrucao exata para corrigir `cellHora()`
- Procurar este bloco dentro do `foreach`:
  - `function cellHora($ev_map, $hist_map, $pid, $campo, $hora_val) { ... }`
- Remover de dentro do loop.
- Colocar antes do HTML da tabela ou antes de `foreach ($rows as $p)`:

```php
if (!function_exists('cellHora')) {
    function cellHora($ev_map, $hist_map, $pid, $campo, $hora_val) {
        $t = safeTime($hora_val);
        if (!$t) return '<span style="color:#ddd">â€”</span>';
        return $t
            . gpsTag($ev_map, $pid, $campo)
            . thumbPrint($ev_map, $pid, $campo)
            . checkEdicao($pid, $campo, $hist_map);
    }
}
```

- Depois, dentro do loop, deixar apenas as chamadas:
  - `cellHora($ev_map, $hist_map, $pid, 'e1', $p['e1'])`
  - etc.

### Arquivos `salvar_modal.php`
Revisar estes 3 arquivos:
1. `softwares/ponto/salvar_modal.php`
2. `ferramentas/ponto/salvar_modal.php`
3. `softwares/software/ponto/salvar_modal.php`

Objetivo:
- Corrigir bind_param que passa string literal por referencia.
- Trocar:
```php
$stmt_hc->bind_param('isssss', $novo_id, $quem, $campo, 'Criado Manual', $ip_usuario, $motivo_criacao);
```
- Por:
```php
$valor_novo = 'Criado Manual';
$stmt_hc->bind_param('isssss', $novo_id, $quem, $campo, $valor_novo, $ip_usuario, $motivo_criacao);
```
- A tentativa ja pode ter aplicado isso, mas conferir manualmente e rodar `php -l`.

### Testes que a proxima IA deve rodar antes de qualquer outra tarefa
1. Sintaxe dos arquivos do Ponto:
```bash
php -l softwares/ponto/ver_folha.php
php -l ferramentas/ponto/ver_folha.php
php -l softwares/software/ponto/ver_folha.php
php -l softwares/ponto/salvar_modal.php
php -l ferramentas/ponto/salvar_modal.php
php -l softwares/software/ponto/salvar_modal.php
```

2. Varredura ampla novamente:
```powershell
$files = rg --files -g "*.php" -g "!**/vendor/**" -g "!**/*(1).php"
$bad=@()
foreach($f in $files){ $out = php -l $f 2>&1; if($LASTEXITCODE -ne 0){ $bad += "--- $f`n$out" } }
if($bad.Count){ $bad -join "`n" } else { 'PHP_LINT_ALL_OK' }
```

3. Testar especificamente o erro original:
```bash
php -l ads/engine.php
php -l escolar/index.php
```
- Em producao, acessar:
  - `https://escolar.minike.com.br/`
  - conferir se nao aparece mais `Call to undefined method MinikeAds::rede()`.

4. Testar ferramentas:
```bash
php -l ferramentas/index.php
```
- Em producao, acessar:
  - `https://ferramentas.minike.com.br/`
  - se travar, verificar `logs/ferramentas-index.log`.

### Observacao importante sobre teste local
- Ao executar paginas via CLI local, apareceu erro de banco:
  - `SQLSTATE[HY000] [2002] Nenhuma conexÃ£o pÃ´de ser feita...`
- Isso e esperado no computador local se MySQL/Hostinger nao estiver acessivel.
- Nao interpretar esse erro local como erro de sintaxe.
- Em producao o importante e o `.env` apontar para o banco unificado correto.

### Proxima ordem recomendada para IA retomar
1. Corrigir os 3 `ver_folha.php` do Ponto que ficaram com parse error.
2. Confirmar os 3 `salvar_modal.php`.
3. Rodar varredura ampla `php -l` ate dar `PHP_LINT_ALL_OK`.
4. Acessar/validar `escolar` e `ferramentas`.
5. Se `ferramentas` ainda travar, analisar `logs/ferramentas-index.log` e simplificar temporariamente o carregamento de anuncios/marketing/widgets.
6. So depois continuar criando features novas.

## 60. Progresso desta execucao 40 (16/05/2026) â€” PARADA POR FALTA DE TEMPO

### O que foi feito nesta execucao
Expansao massiva do catalogo de ferramentas. Foco em transformar entradas `breve` em ferramentas reais `ativo`.

#### Catalogo atualizado (breve â†’ ativo) para ferramentas criadas em sessoes anteriores:
- `gerador/cpf_multiplos.php` ativo
- `desenvolvedor/validador_xml.php` ativo
- `desenvolvedor/htaccess.php` ativo
- `desenvolvedor/formatador_html.php` ativo
- `desenvolvedor/testador_api.php` ativo
- `desenvolvedor/favicon.php` ativo
- `seo/analise_titulo.php` ativo
- `seo/open_graph.php` ativo
- `seo/keywords.php` ativo
- `seo/calculadora_ctr.php` ativo
- `seo/plataforma.php` ativo

#### Ferramentas novas criadas e ativadas nesta execucao (todas validadas com `php -l`):

financeiro/:
- `financeiro/aluguel.php` â€” calculo custo mensal (aluguel+condominio+IPTU), percentual da renda, projecao de reajuste anual por IGPM/IPCA/custom, tabela por ano ate 20 anos, PT.
- `financeiro/aposentadoria.php` â€” patrimonio alvo via regra 4%, aporte mensal necessario, evolucao por tabela a cada 5 anos, tempo real de vida, PT.
- `financeiro/fgts.php` â€” deposito 8%/mes, saldo acumulado, multa 40%/20%/0% por situacao (demissao/acordo/aposentadoria/pedido), calculo de saque-aniversario por faixa, PT.
- `financeiro/fluxo_caixa.php` â€” lancamentos de entrada/saida por mes, resumo global, resumo mensal, persistencia em localStorage, PT.

data_hora/:
- `data_hora/cronograma.php` â€” criador de tarefas com nome/inicio/fim/responsavel/prioridade, barra de progresso por tempo, checkbox de conclusao, exportar TXT, imprimir, persistencia localStorage, PT.

negocios/:
- `negocios/lucro.php` â€” receita, impostos, custo variavel, custo fixo, DRE simplificada, ponto de equilibrio em unidades, PT.
- `negocios/markup.php` â€” markup divisor com despesas variaveis+fixas+lucro, preco de venda sugerido, comparativo para margens 10-40%, PT.
- `negocios/nota_fiscal.php` â€” emitente, tomador, itens dinamicos (descricao/qtd/valor), ISS e IRRF, gera documento formatado em texto para copiar/imprimir, PT.
- `negocios/contrato.php` â€” 4 tipos (prestacao/locacao/compra-venda/parceria), partes com doc+endereco, objeto, valor, pagamento, datas, clausulas adicionais, gera contrato em texto para copiar/imprimir, PT.

social/:
- `social/bio_twitter.php` â€” 4 estilos (profissional/criativo/minimalista/humano), gera 3 variantes de bio com contagem de caracteres (limite 160), PT.
- `social/engajamento.php` â€” taxa de engajamento por plataforma (Instagram/TikTok/YouTube/Twitter/LinkedIn/Facebook), classificacao ruim/regular/bom/excelente com benchmarks, PT.
- `social/legenda.php` â€” legendas para Instagram/TikTok/LinkedIn/Facebook, 5 tons, com/sem emoji/hashtag/CTA, gera 3 variantes, PT.
- `social/stories.php` â€” roteiro de stories por objetivo (venda/dica/bastidores/enquete/lancamento), 3-10 telas, roteiro com icone/titulo/texto por tela, copiar, PT.

#### Catalogo atualizado (breve â†’ ativo) para ferramentas criadas nesta execucao:
- `financeiro/aluguel.php`, `financeiro/aposentadoria.php`, `financeiro/fgts.php`, `financeiro/fluxo_caixa.php` ativo
- `data_hora/cronograma.php` ativo
- `negocios/contrato.php`, `negocios/lucro.php`, `negocios/nota_fiscal.php`, `negocios/markup.php` ativo
- `social/bio_twitter.php`, `social/legenda.php`, `social/engajamento.php`, `social/stories.php` ativo

### Contagem estimada do catalogo apos esta execucao
- Antes: 191 ativo / 78 breve = 269 total
- Depois: ~217 ativo / ~52 breve = 269 total (+26 ativas)

### O que AINDA FALTA criar (ferramentas breve pendentes)
Estas ferramentas ainda estao marcadas como `breve` e sao todas frontend-only (nao precisam de banco/API):

social/:
- `social/analise_perfil.php` â€” analise de metricas de perfil (seguidores/seguindo/posts/bio/etc)

educacao/:
- `educacao/vestibular.php` â€” simulador de vestibular (ENEM, FUVEST) com questoes multipla escolha
- `educacao/exercicios.php` â€” gerador de exercicios de matematica/portugues com auto-correcao
- `educacao/cronograma_estudos.php` â€” montador de cronograma de estudos com materias e horas
- `educacao/mapa_mental.php` â€” criador de mapa mental simples (texto hierarquico ou canvas)
- `educacao/anki.php` â€” flashcards estilo Anki com frente/verso e algoritmo de revisao

design/:
- `design/border_radius.php` â€” gerador visual de border-radius CSS com preview e codigo
- `design/icones_svg.php` â€” biblioteca de icones SVG prontos para copiar/colar
- `design/logo.php` â€” criador de logo simples (texto + icone + cor) com download PNG
- `design/padrao_css.php` â€” gerador de padroes CSS (grid, pontos, listras) para background
- `design/animacao_css.php` â€” gerador de animacoes CSS com preview (fade, slide, bounce, etc)

redes/:
- `redes/subnet.php` â€” calculadora de sub-rede IPv4 (CIDR, mascara, hosts, broadcast)
- `redes/mac.php` â€” gerador de MAC address aleatorio com formatos
- `redes/ip_converter.php` â€” conversor IP decimal/binario/hex
- `redes/meu_ip.php` â€” exibe IP do usuario via API externa (requer JS fetch)

negocios/:
- `negocios/business_plan.php` â€” gerador de sumario executivo de plano de negocios

Ferramentas que PERMANECEM breve (precisam de servidor/API/processamento):
- `imagem/remover_fundo.php`, `imagem/upscale.php`, `imagem/otimizar_web.php`, `imagem/png_ico.php`, `imagem/cartoon.php`, `imagem/filtros.php`, `imagem/ocr.php`, `imagem/brilho.php`, `imagem/mosaico.php`, `imagem/gif.php`
- `pdf/pdf_excel.php`, `pdf/pdf_ppt.php`, `pdf/proteger.php`, `pdf/desbloquear.php`, `pdf/pdf_png.php`, `pdf/ocr.php`, `pdf/marca_dagua.php`, `pdf/assinar.php`, `pdf/numerar.php`, `pdf/rodar.php`, `pdf/pdf_txt.php`, `pdf/html_pdf.php`, `pdf/extrair_imagens.php`, `pdf/pdfa.php`
- `redes/dns.php`, `redes/ping.php`, `redes/whois.php`, `redes/ssl.php`, `redes/velocidade.php`, `redes/geoip.php`
- `seo/links_quebrados.php`, `seo/concorrente.php`, `texto/parafrase.php`

### Instrucao exata para a proxima IA continuar as ferramentas breve

**PADRAO OBRIGATORIO para todo arquivo de ferramenta nova:**
```php
<?php
$tool_id='slug_ferramenta';$tool_icon='fas fa-icone';$tool_cat_slug='categoria';
$tool_tit='Titulo da Ferramenta';
$tool_desc='Descricao completa da ferramenta...';
$t_in='palavra-chave1, keyword2, seo term3';
ob_start();?>
<!-- HTML da ferramenta aqui -->
<?php $conteudo_ferramenta=ob_get_clean();ob_start();?>
<script>
(function(){
  // JS da ferramenta aqui
  // i18n: const isEn=document.documentElement.lang==='en';
})();
</script>
<?php $scripts_ferramenta=ob_get_clean();require_once __DIR__.'/../layout_ferramenta.php';
```

**APOS criar cada ferramenta:**
1. Rodar `php -l caminho/ferramenta.php` â€” precisa retornar OK sem erros.
2. Atualizar `ferramentas/catalogo.php` de `breve` para `ativo` na entrada correspondente.
3. So entao passar para a proxima.

**APOS criar um batch de ferramentas:**
- Atualizar esta secao do `planominike.md` (secao 60) com o que foi feito.
- Sincronizar `planominike.txt`: `Copy-Item planominike.md planominike.txt`

### Estado critico do Ponto (nao resolvido â€” de uma execucao anterior)
ATENCAO: Os arquivos abaixo ainda podem ter parse errors e devem ser verificados antes de qualquer deploy:
- `softwares/ponto/ver_folha.php`
- `ferramentas/ponto/ver_folha.php`
- `softwares/software/ponto/ver_folha.php`
- `softwares/ponto/salvar_modal.php`
- `ferramentas/ponto/salvar_modal.php`
- `softwares/software/ponto/salvar_modal.php`

Ver instrucao detalhada na secao 59 deste arquivo.

## 61. Correcao operacional - estabilidade dos subsites (2026-05-17)

### O que foi corrigido nesta execucao
- `escolar/index.php`: removido risco de fatal `Call to undefined method MinikeAds::rede()` usando wrappers seguros `mk_ads_*` e carregando `includes/ads_internos.php` antes de engine externa.
- `ferramentas/layout_ferramenta.php`: agora suporta os dois padroes existentes de ferramentas:
  - legado: `require layout_ferramenta.php; head(...); ...; foot();`
  - novo: `$conteudo_ferramenta` + `$scripts_ferramenta` + `require layout_ferramenta.php`
- `ferramentas/converter/moeda.php`: voltou a executar pelo layout legado sem fatal de `head()`/`foot()`.
- `sites/index.php`: corrigido JavaScript solto fora de `<script>`, preview com `<\/script>` seguro, e finalizacao agora registra pedido no banco (`mk_sites_pedidos`) antes/ao enviar WhatsApp.
- `sites/config.php`: cria/ajusta automaticamente colunas de `mk_sites_produtos`, views de compatibilidade e a tabela `mk_sites_pedidos`; tambem popula produtos base/modulos padrao se a tabela estiver vazia.
- `sites/admin/pedidos.php`: novo painel para ver pedidos gerados pelo construtor e alterar status.
- `sites/admin/index.php`, `sidebar.php`, `produtos.php`, `depoimentos.php`, `trabalhos.php`: corrigidos links/colunas para refletir os nomes reais do banco.
- `includes/db.php`: adicionada camada de compatibilidade para tabelas legadas sem prefixo (`usuarios`, `planos`, `pagamentos`, `licencas`, `lojas`, `painel_botoes`, `contatos`, `notificacoes`, `afiliados`, `afiliados_cliques`, `afiliados_saques`) com auto-criacao/auto-colunas.
- `includes/ads_compat.php` e `includes/ads_market.php`: anuncios internos nao podem derrubar pagina se uma engine antiga estiver carregada ou se o banco local estiver indisponivel.

### Regra de dominio que NAO pode ser quebrada
- `minike.com.br` e o hub principal/vitrine do imperio Minike: deve apresentar tudo que existe no ecossistema.
- `sites.minike.com.br` NAO e o hub principal. Ele e o produto "MiniKe Sites": lugar onde o cliente monta o site, ve preview, escolhe estrutura/modulos/hospedagem, paga/solicita e gera pedido no painel para desenvolvimento e entrega.
- Subdominios continuam com pastas independentes, mas devem usar o mesmo banco unificado `u340626637_minike`.

### Regras obrigatorias para proximas IAs
1. Nunca chamar diretamente `MinikeAds::rede()`, `MinikeAds::banner()`, `MinikeAds::getBanner()`, `MinikeAds::getHeader()` ou `MinikeAds::getSmartlink()` em paginas novas. Use `mk_ads_rede()`, `mk_ads_banner()`, `mk_ads_header()` e `mk_ads_smartlink()` ou cheque `method_exists`.
2. Sempre carregar `includes/ads_internos.php` antes de qualquer engine externa de ads. Engine externa antiga pode existir no servidor e nao ter todos os metodos.
3. Nunca depender de `CREATE TABLE IF NOT EXISTS` para coluna nova: se o codigo usa uma coluna em `SELECT`, `INSERT` ou `UPDATE`, crie tambem uma migracao idempotente com `mk_db_ensure_column()` ou helper equivalente do subdominio.
4. Se um subdominio tiver tabela propria, registrar a auto-criacao no config dele e manter views/aliases para codigo legado.
5. O construtor de `sites.minike.com.br` deve sempre gerar um registro em `mk_sites_pedidos`; WhatsApp e apenas canal de contato, nao substitui o pedido no banco.
6. Ferramentas novas devem usar o padrao novo com `$conteudo_ferramenta`; ferramentas antigas com `head()`/`foot()` sao suportadas, mas nao devem ser copiadas para arquivos novos.

### Validacao feita
- `php -l` em todos os PHPs do projeto: 1507 arquivos OK.
- Execucao local de `ferramentas/converter/moeda.php`: OK, sem fatal/warning relevante.
- Teste de compatibilidade com engine `MinikeAds` antiga sem `rede()`: OK via `mk_ads_rede()`.

## 62. Correcao operacional - index resiliente e painel Imperio (2026-05-17)

### Contexto desta execucao
- Felipe pediu para trabalhar na pasta `\\srvtotali\Docs\PASTA COMPARTILHADA\Felipe\ia\minike`, mas ela nao estava acessivel nesta sessao (`Test-Path` retornou falso).
- As alteracoes foram aplicadas no workspace aberto e acessivel: `D:\minike`.
- Criado arquivo de orientacao para acao externa: `INSTRUCOES_OPERACAO_IMPERIO_MINIKE.md`.

### Correcoes de estabilidade aplicadas
- `includes/db.php`
  - Nao encerra mais a execucao quando o banco falha em CLI/ambiente local.
  - Mantem `$pdo = null` e permite que paginas renderizem fallback.
  - Corrigido singleton para nao retornar conexao inexistente quando uma tentativa anterior falhou.
- `config.php`
  - Passou a tolerar `$pdo = null` sem warning.
  - `MinikeDB::connect()` agora pode retornar `null` quando o banco esta em contingencia.
- `includes/env_loader.php`
  - Funcoes `carregarEnv()` e `env()` agora sao protegidas com `function_exists`, evitando fatal de redeclaracao.
- `includes/translations.php`
  - Protegidas funcoes `getSiteLanguage()`, `__t()`, `__()` e `__m()` contra redeclaracao.
- `includes/header-unificado.php`
  - Nao gera warning quando `HTTP_USER_AGENT` nao existe em CLI/cron.
- `includes/fake_data.php`
  - Corrigidos warnings/deprecated de calculos com data/hash em PHP 8.3.

### Index principais verificados e corrigidos
- `ferramentas/index.php`
  - Agora executa sem fatal mesmo com banco local indisponivel.
  - Mantem log de qualidade em `logs/ferramentas-index.log`.
- `sites/index.php`
  - Corrigido uso direto de `$_SERVER['REQUEST_METHOD']` para fallback em CLI.
- `lojas/index.php`
  - Nao morre mais quando `$pdo` esta indisponivel; renderiza fallback comercial do hub de lojas.
- `softwares/index.php`
  - Removido BOM do arquivo e eliminados warnings de sessao/header.
- `games/index.php`
  - Includes trocados para caminhos absolutos por `__DIR__`.
  - Defaults adicionados para jogos sem `tipo_preco`, `capa_url`, `titulo`, `descricao` ou `cat_nome`.
- `cursos/index.php`
  - Includes trocados para caminhos absolutos.
  - Renderiza `$cursos_lista`/Meta999 sem exigir banco.
  - Consultas Hotmart/Monetizze so rodam quando `$pdo` existe.
  - Ads trocados para wrappers seguros `mk_ads_*`.
- `escolar/index.php`
  - Defaults para `country` e `HTTP_HOST`, removendo warnings.
- `delivery/index.php`
  - Includes trocados para caminhos absolutos.
  - Consulta cardapio so roda se `$pdo` existe.
- `trabalhos/index.php`
  - Defaults para casos e depoimentos estaticos quando config/banco falha.

### Novo painel central
- Criado: `admin/imperio.php`
- Funcoes:
  - Login por admin/senha mestre.
  - Visao de saude dos subdominios/pastas.
  - Contagem de tabelas principais quando banco esta online.
  - Gerenciamento de botoes/atalhos com modal.
  - Leitura de logs com modal.
  - Fallback de escrita em `cache/admin/botoes.json` se banco estiver offline.
- Tabelas usadas/criadas automaticamente quando ha banco:
  - `painel_botoes`
  - `mk_configuracoes`

### Validacao feita nesta execucao
- `php -l` em todos os PHPs: 1504 arquivos OK.
- Runtime local dos index principais, todos OK sem fatal/warning/deprecated:
  - `index.php`
  - `ferramentas/index.php`
  - `sites/index.php`
  - `lojas/index.php`
  - `softwares/index.php`
  - `games/index.php`
  - `cursos/index.php`
  - `escolar/index.php`
  - `delivery/index.php`
  - `erp/index.php`
  - `ads/index.php`
  - `trabalhos/index.php`
  - `admin/imperio.php`

### Regra reforcada para proximas IAs
- Todo `index.php` de subdominio deve funcionar mesmo sem banco. Banco offline deve gerar fallback comercial, nao tela branca.
- Caminhos de include em subdominio devem usar `__DIR__`, nunca depender do diretÃ³rio atual do processo.
- `MinikeAds::*` direto continua proibido em paginas novas; usar wrappers `mk_ads_*`.
- Nao inserir senha de banco em arquivo novo. Usar `.env`.

## Progresso desta execucao - 17/05/2026 (Auto-correcao)

- `includes/self_heal.php`
  - Novo `mk_safe_require_once()` para include seguro sem fatal.
  - Novo `mk_health_write()` para snapshot de saude por modulo em `cache/health/*.json`.
  - Diretorio `cache/health` padronizado para monitoramento.

- `includes/db.php`
  - Registra estado do banco em snapshot:
    - `database=ok` quando conectado.
    - `database=error` quando falha.
  - Continua sem derrubar execucao (modo contingencia).

- Novo endpoint de saude:
  - `api/health.php`
  - Consolida status dos modulos, banco e arquivos criticos.
  - Retorna HTTP 503 quando status geral for erro.

- Novo scanner para cron:
  - `cron/self_heal_scan.php`
  - Valida modulos e banco.
  - Grava `cache/health/scan.json`.

- Ajustes de resiliencia no editor:
  - `softwares/editor/config.php`
  - Removido `die()` em falha de banco.
  - Reaproveita `$pdo` global quando disponivel.
  - Publica heartbeat `softwares_editor`.

- Heartbeat de saude adicionado nos configs:
  - `config.php` (root)
  - `ads/config.php`
  - `delivery/config.php`
  - `cursos/config.php`
  - `erp/config.php`
  - `escolar/config.php`
  - `games/config.php`
  - `sites/config.php`
  - `ferramentas/config.php`
  - `trabalhos/config.php`

- API de ferramentas mais tolerante:
  - `ferramentas/api/config.php`
  - `getDbConnection(): ?PDO` e fallback para `mk_pdo()`.
  - Rate-limit nao quebra quando banco estiver offline.

- Arquivo de acao externa criado:
  - `INSTRUCOES_ACOES_PENDENTES_MINIKE.md`
  - Checklist de `.env`, cron e validacoes de deploy.

- Validacao tecnica desta rodada:
  - `php -l` nos arquivos alterados: OK.
  - Teste de runtime dos principais `index.php`: sem fatal; com fallback ativo quando banco indisponivel.

## Progresso desta execucao - 17/05/2026 (Isolamento de funcao/arquivo com alerta admin)

- `includes/self_heal.php`
  - Adicionado `mk_admin_alert()` com persistencia em `cache/admin/alerts.json`.
  - Adicionado `mk_component_guard()` para isolar falhas locais de componente.
  - Adicionado `mk_component_apology_html()` para mensagem amigavel ao cliente.
  - `mk_safe_require_once()` agora alerta o admin quando include falha.
  - Excecoes, erros criticos e shutdown fatal agora criam alerta para o painel.

- `admin/imperio.php`
  - Nova secao de alertas no painel central.
  - Mostra severidade, modulo, titulo, mensagem, repeticoes e status.
  - Novas acoes:
    - reconhecer alerta (`ack_alert`)
    - limpar reconhecidos (`clear_acked_alerts`)
  - Nova API: `imperio.php?api=alerts`.

- `ferramentas/index.php`
  - Includes de modulos opcionais migrados para include seguro.
  - Quando recurso falha, o restante da pagina continua e exibe pedido de desculpas ao cliente.
  - Falha fica logada e aparece no painel via alertas.

- Arquivos alterados:
  - `includes/self_heal.php`
  - `admin/imperio.php`
  - `ferramentas/index.php`

- Validacao:
  - `php -l includes/self_heal.php` OK
  - `php -l admin/imperio.php` OK
  - `php -l ferramentas/index.php` OK

## Progresso desta execucao - 17/05/2026 (Minike Games Creator Community + Microtransacoes)

- Foco total no `games.minike.com.br` para comunidade de criadores.
- `games/config.php` refeito:
  - Auto-criacao de tabelas novas:
    - `mk_games_submissoes`
    - `mk_games_creator_profiles`
    - `mk_games_creator_rewards`
    - `mk_games_microtransacoes`
    - `mk_games_store_ofertas`
  - Compatibilidade com legado:
    - `usuarios`, `jogos`, `scores`, `categorias_games`, `compras_jogos`
  - Auto-correcao de colunas faltantes com `ALTER` automatico.
  - Seed automatico de categorias e ofertas de impulso.

- Comunidade de criadores:
  - Novo `games/studio.php`:
    - painel do criador
    - saldo MKC
    - compra de boost por MKC
    - lista de submissÃµes
  - Novo `games/comunidade.php`:
    - feed de jogos aprovados da comunidade
    - botao demo/jogar/publicar

- Publicacao de jogos:
  - `games/enviar_jogo.php`:
    - campos novos: `engine_mode`, `preco_usd`
    - opcoes de impulso (microtransacao)
  - `games/processar_upload.php` refeito:
    - salva em `mk_games_jogos` + `mk_games_submissoes` + `jogos` (compat)
    - jogos pagos exigem demo
    - aplica boost opcional por MKC
    - bonus de primeira submissao: +25 MKC

- Moderacao:
  - `games/admin/jogos.php` refeito:
    - aprovar/bloquear/rejeitar/excluir na `mk_games_submissoes`
    - sincroniza `mk_games_jogos` e `jogos`
    - recompensa aprovacao: +40 MKC
  - `games/admin/sidebar.php` com links para `studio` e `comunidade`.

- Integracao geral:
  - `games/index.php`:
    - links para Studio/Comunidade
    - secao de spotlight de jogos da comunidade
    - ranking com fallback `usuarios` + `mk_usuarios`
  - `games/login.php`:
    - fallback login `usuarios` / `mk_usuarios`
    - `session_regenerate_id(true)`
  - `games/cadastro.php`:
    - cria usuario em `usuarios` + `mk_usuarios` na mesma transacao
  - `games/api_moedas.php`:
    - corrigido campo de score para `data_registro`

- Validacao tecnica:
  - `php -l` OK em todos os arquivos alterados do modulo games.

- Novo arquivo de operacao:
  - `INSTRUCOES_DEPLOY_GAMES_COMUNIDADE.md`
  - checklist de validacao em producao e requisito de perfil admin.

## Progresso desta execucao - 17/05/2026 (Auditoria Softwares + inicio varredura modulo a modulo)

- Softwares auditado e corrigido:
  - `softwares/_auth.php` refeito para usar banco unificado via `includes/db.php`.
  - `softwares/login.php` agora autentica de verdade (antes era sÃ³ layout).
  - `softwares/register.php` agora cria conta + trial 45 dias + login automÃ¡tico.
  - `softwares/logout.php` corrigido (remove path legado `/software/`).
  - `softwares/app.php` com link de logout corrigido.
  - `softwares/index.php` protegido contra fatal (`MinikeAds` / `mkAdaptiveGrowthRender`).
  - `softwares/apps/api_manager.php` com endpoint dinÃ¢mico por host.
  - `softwares/api/v1.php` com links dinÃ¢micos para apps no mesmo host.

- InÃ­cio da revisÃ£o "um por um" no prÃ³ximo mÃ³dulo (`escolar`):
  - criados:
    - `escolar/_portal_auth.php`
    - `escolar/login_aluno.php`
    - `escolar/login_prof.php`
    - `escolar/logout.php`
  - `escolar/index.php` atualizado com botÃ£o de logout quando houver sessÃ£o.
  - `escolar/admin/index.php` agora exige professor/admin para acesso.

- Validacao:
  - `php -l` OK em todos os arquivos alterados.

- Fila sequencial de prÃ³ximos mÃ³dulos:
  1) sites
  2) lojas
  3) atendimento/atendimentos
  4) delivery
  5) erp
  6) trabalhos

## Progresso desta execucao - 17/05/2026 (Sites - primeiro ajuste da fila)

- RevisÃ£o iniciada em `sites`.
- `sites/index.php` atualizado:
  - include opcional com `mk_safe_require_once` (quando disponÃ­vel).
  - `mkAdaptiveGrowthRender` protegido por `function_exists`.
- Resultado: reduÃ§Ã£o de risco de queda total por falha em mÃ³dulos auxiliares.
- ValidaÃ§Ã£o: `php -l sites/index.php` OK.

## Progresso desta execucao - 17/05/2026 (Resiliencia anti-queda + alertas no painel)

- Objetivo executado: impedir queda total por erro de bloco isolado e avisar no painel admin.

- Ajustes de chamadas seguras para ads/cross-sell:
  - `delivery/index.php`
  - `lojas/index.php`
  - `planos.php`
  - `games/index.php`
  - `games/colecao.php`
  - `games/jogo.php`
  - `ads/docs.php`
  - Troca principal: chamadas diretas `MinikeAds::...` -> wrappers `mk_ads_rede` / `mk_ads_banner`.
  - `mkAdaptiveGrowthRender` protegido com `function_exists` onde faltava.

- Painel central atualizado:
  - `admin/painel_supremo.php`
  - Nova aba `Alertas` consumindo `cache/admin/alerts.json`.
  - Acoes novas:
    - `alert_ack` (marcar como resolvido)
    - `alert_clear_all` (limpar alertas)
  - Badge de alertas pendentes no menu lateral.
  - Nova secao de saude por modulo lendo `cache/health/*.json`.

- Resultado:
  - Falhas locais deixam de derrubar a pagina inteira.
  - Admin passa a enxergar e resolver alertas rapidamente no painel supremo.

- Validacao:
  - `php -l delivery/index.php` OK
  - `php -l lojas/index.php` OK
  - `php -l planos.php` OK
  - `php -l games/colecao.php` OK
  - `php -l games/jogo.php` OK
  - `php -l games/index.php` OK
  - `php -l ads/docs.php` OK
  - `php -l admin/painel_supremo.php` OK

- Complemento desta execucao:
  - Normalizacao de fallback de DB via `.env` em:
    - `sites/config.php`
    - `delivery/config.php`
    - `escolar/config.php`
  - Novo arquivo de operacao manual criado:
    - `INSTRUCOES_MANUAIS_MINIKE.md`
    - checklist de `.env`, subdominios, SSL e webhooks de pagamento.

- Fechamento tecnico extra (17/05/2026):
  - Corrigido erro de sintaxe em `games/minike/generator.php` (bloco `game-014` e strings JS).
  - Revalidacao completa:
    - `php validate_site.php`
    - Resultado: 996 arquivos PHP, 0 erros.

## Progresso desta execucao - 17/05/2026 (Hardening final de Ads + wrappers seguros)

- Objetivo executado: remover risco residual de quedas por chamadas diretas em paginas legadas.

- Ajustes aplicados nesta rodada:
  - Migracao de chamadas diretas de Ads para wrappers `mk_ads_*` em:
    - `ferramentas/diversas/planilhas.php`
    - `ferramentas/imagem/acervo.php`
    - `ferramentas/pdf/acervo.php`
    - `ads/painel.php`
  - Conversoes realizadas:
    - `MinikeAds::getHeader()` -> `mk_ads_header()`
    - `MinikeAds::getBanner('topo'|'final')` -> `mk_ads_banner('topo'|'final')`
    - bloco de rede no painel -> `mk_ads_rede(...)`
  - Snippet de exemplo em `ads/painel.php` atualizado para wrappers seguros.

- Resultado operacional:
  - Paginas legadas de acervo deixaram de depender de metodo estatico direto.
  - Menor risco de fatal quando engine de Ads muda/carrega parcial.
  - Padrao de integracao com Ads consolidado em `mk_ads_*`.

- Validacao tecnica:
  - `php -l ferramentas/diversas/planilhas.php` OK
  - `php -l ferramentas/imagem/acervo.php` OK
  - `php -l ferramentas/pdf/acervo.php` OK
  - `php -l ads/painel.php` OK

- Pendencias remanescentes conhecidas (nao bloqueantes):
  - `api/ads.php` mantÃ©m `MinikeAds::listar` com protecao (`class_exists + method_exists + try/catch`) e fallback vazio.
  - Ocorrencias de `MinikeAds::` ainda existem apenas em docs/comentarios e arquivo backup:
    - `CORREÃ‡Ã•ES_E_MELHORIAS.md`
    - `INSTRUCOES_PARA_PROXIMAS_IAS.md`
    - comentario em `ads/engine.php`
    - `sites/index_backup.php`

- Higiene de documentacao aplicada no mesmo ciclo:
  - `INSTRUCOES_PARA_PROXIMAS_IAS.md` atualizado para orientar anuncios com wrappers `mk_ads_banner(...)`.
  - `CORREÃ‡Ã•ES_E_MELHORIAS.md` atualizado com exemplos seguros no lugar de chamada direta.

## Progresso desta execucao - 17/05/2026 (Checklist de deploy Hostinger)

- Verificacao local de `.env` concluida:
  - `DB_HOST=localhost`
  - `DB_PORT=3306`
  - `DB_NAME=u340626637_minike`
  - `DB_USER=u340626637_Hugen`
  - `DB_PASS` preenchido.

- Novo validador de pre-deploy criado:
  - `check_hostinger_requirements.php`
  - valida `.env`, extensoes PHP, permissoes `logs/cache`, vendors obrigatorios e conexao DB.
  - aceita `--fix-dirs` para criar/ajustar `logs/`, `cache/`, `cache/admin`, `cache/health`.

- Novo guia de operacao criado:
  - `INSTRUCOES_SSH_HOSTINGER_DEPLOY.md`
  - passo a passo via SSH + orientacao de hPanel para habilitar extensoes.

- Dependencias mapeadas para deploy:
  - `ferramentas/vendor/autoload.php` (Composer obrigatorio em `/ferramentas`)
  - `softwares/editor/vendor/autoload.php` (garantir upload completo)

## Progresso desta execucao - 17/05/2026 (Ajuste de sessao pos-deploy)

- Arquivo ajustado: `includes/mk_identity.php`
  - `session_start()` agora so executa quando `!headers_sent(...)`.
  - se headers ja foram enviados, grava aviso via `mk_log('warn', ..., 'identity')` (fallback `error_log`) e evita warning PHP de sessao.

## Progresso desta execucao - 17/05/2026 (Correcao de abertura dos jogos)

- Diagnostico no modulo `games`:
  - `games/jogo.php` priorizava catalogo Meta999 e, sem match por slug/genre, caia em fallback de vitrine.
  - Slugs de jogos locais (`games/completo/<slug>`) nao estavam abrindo o jogo real.

- Correcao aplicada em `games/jogo.php`:
  - Resolve automaticamente jogo local em:
    - `games/completo/<slug>/index.php`
    - `games/completo/<slug>/index.html`
  - Quando existe jogo local:
    - ativa modo jogavel (`$isLocalPlayable`);
    - define `playUrl`;
    - renderiza secao "Jogo Aberto" com `iframe` + botao de nova aba.
  - Sem jogo local: fallback Meta999 mantido.

- Resultado:
  - Slugs como `space-invaders`, `tetris`, `pac-man`, `2048` passam a abrir jogo real.
  - Fluxo nao quebra para slugs inexistentes.

- Validacao:
  - `php -l games/jogo.php` OK.

## Progresso desta execucao - 17/05/2026 (Correcao de layout em Ferramentas)

- Arquivo: `ferramentas/index.php`
- Causa do layout quebrado:
  - deslocamento lateral duplicado no desktop (`lg:ml-72` + `margin-left: 18rem` no CSS critico).
- Correcao aplicada:
  - removida classe `lg:ml-72` do container principal.
  - offset lateral mantido apenas via CSS critico.
- Resultado esperado:
  - remove coluna vazia entre sidebar e conteudo;
  - realinha banner, busca e cards.
- Validacao:
  - `php -l ferramentas/index.php` OK.

## Progresso desta execucao - 17/05/2026 (Correcoes de UX no Cursos)

- Arquivo alterado: `cursos/index.php`.

- Correcoes aplicadas:
  - Botao dos cards internos deixava de funcionar (era `<span>`):
    - convertido para link real `<a>` apontando para `trilhas.php?lang=...&curso=<id>`.
  - Estrutura de card no loop interno estava quebrada:
    - adicionado wrapper correto `article` com classes de card/hover.
  - Contraste fraco no topo:
    - gradiente do titulo `cursos.minike.com.br` ajustado para tons escuros/azuis.
  - Falta de arte quando curso nao tinha capa:
    - fallback de imagem com `picsum` deterministico por seed.
  - Filtro por categoria inconsistente:
    - suporte a `cat` por id e por slug;
    - fallback/demo agora tambem respeita filtro.

- Validacao:
  - `php -l cursos/index.php` OK.
  - `php cursos/index.php` OK.

---

## Fonte: MAPA_CENTRAL_MINIKE.md

# ðŸ—ºï¸ MAPA CENTRAL MINIKE - v2.2
**Data AtualizaÃ§Ã£o:** 13 de Maio de 2026 Ã s 18:35  
**Ãšltima SessÃ£o:** #5 (ConsolidaÃ§Ã£o + DocumentaÃ§Ã£o) âœ… COMPLETA  
**Status Geral:** ðŸŸ¡ EM CONSTRUÃ‡ÃƒO - Temas + Banco Unificado + MonetizaÃ§Ã£o Ativa  
**ResponsÃ¡veis:** Felipe (gestor) + MÃºltiplas IAs (desenvolvimento)  

---

## ðŸ“‹ HISTÃ“RICO DE SESSÃ•ES

| SessÃ£o | Data | ResponsÃ¡vel | O QUE FOI FEITO | Status |
|--------|------|---|---|---|
| #1 | 10/5 | IA #1 | DiagnÃ³stico inicial + Efeito Frankenstein | âœ… |
| #2 | 11/5 | IA #2 | Fixes template frames + Fabric.js | ðŸŸ¡ Parcial |
| #3 | 12/5 | IA #3 | Auto-gerador de ferramentas | ðŸŸ¡ Parcial |
| #4 | 12/5 | IA #4 | Temas + Banco unificado | âœ… Completo |
| #5 | 13/5 | IA #5 (atual) | **ConsolidaÃ§Ã£o + DocumentaÃ§Ã£o central** | âœ… **COMPLETO** |

### ðŸŽ¯ SessÃ£o #5 â€” O QUE FOI ENTREGUE:
- âœ… `MAPA_CENTRAL_MINIKE.md` (referÃªncia Ãºnica)
- âœ… `INSTRUCOES_PARA_PROXIMAS_IAS.md` (guia passo-a-passo)
- âœ… `RESUMO_EXECUTIVO_SESSAO_5.md` (status completo)
- âœ… Sistema ADs internos expandido 50%
- âœ… ValidaÃ§Ã£o completa de: DB + temas + configs
- âœ… PrÃ³ximo IA sabe exatamente o que fazer

**PrÃ³ximo passo:** Felipe escolhe tarefa e comunica qual IA deve trabalhar nela.

---

## ðŸŽ¯ OBJETIVO CENTRAL
Criar um **IMPÃ‰RIO de ferramentas, cursos, games e softwares** com:
- âœ… **999+ ferramentas** (para propaganda)
- âœ… **999+ games** (com moedas + micro-transaÃ§Ãµes)
- âœ… **999+ cursos** (automatizados com vÃ­deos/materiais)
- âœ… **999+ softwares** (SaaS para revenda)
- âœ… **999+ temas educacionais**
- âœ… **MonetizaÃ§Ã£o em cada ponto** (anÃºncios, premium, afiliados)
- âœ… **PT-BR + EN** com **BRL + USD**
- âœ… **Completamente automatizado**

---

## ðŸ“Š ESTRUTURA DE SUBDOMÃNIOS

| SubdomÃ­nio | Pasta | Banco | Status | Prioridade | ConteÃºdo Meta |
|---|---|---|---|---|---|
| **minike.com.br** | `/` | `u340626637_minike` | âœ… Ativo | ðŸ”´ CrÃ­tica | Hub central |
| **ferramentas.minike.com.br** | `/ferramentas/` | `u340626637_minike` | ðŸŸ¡ 90% | ðŸ”´ CrÃ­tica | **999+ ferramentas** |
| **games.minike.com.br** | `/games/` | `u340626637_minike` | ðŸŸ¡ 60% | ðŸ”´ CrÃ­tica | **999+ games** |
| **cursos.minike.com.br** | `/cursos/` | `u340626637_minike` | ðŸŸ¡ 70% | ðŸŸ  Alta | **999+ cursos** |
| **lojas.minike.com.br** | `/lojas/` | `u340626637_minike` | ðŸŸ¡ 75% | ðŸŸ  Alta | Hub de mini-lojas |
| **delivery.minike.com.br** | `/delivery/` | `u340626637_minike` | âœ… 85% | ðŸŸ¡ MÃ©dia | Comanda PDV |
| **erp.minike.com.br** | `/erp/` | `u340626637_minike` | ðŸŸ¡ 40% | ðŸŸ¡ MÃ©dia | GestÃ£o empresarial |
| **softwares.minike.com.br** | `/softwares/` | `u340626637_minike` | ðŸŸ¡ 70% | ðŸŸ  Alta | Ponto SaaS + outros |
| **escolar.minike.com.br** | `/escolar/` | `u340626637_minike` | ðŸŸ¡ 60% | ðŸŸ¡ MÃ©dia | **999+ temas + atividades** |
| **trabalhos.minike.com.br** | `/trabalhos/` | `u340626637_minike` | ðŸŸ¡ 30% | ðŸŸ¢ Baixa | PortfÃ³lio |
| **ads.minike.com.br** | `/ads/` | `u340626637_minike` | âœ… 90% | ðŸŸ  Alta | Motor de anÃºncios |
| **sites.minike.com.br** | `/sites/` | `u340626637_minike` | ðŸŸ¡ 50% | ðŸŸ¢ Baixa | Criador de sites |

**Banco Centralizado:**
- Nome: `u340626637_minike`
- UsuÃ¡rio: `u340626637_Hugen`
- Senha: `[REMOVIDO - senha real antiga]`
- Arquivo central: `includes/db.php` (auto-cria tabelas)

---

## ðŸ”´ PRIORIDADES POR URGÃŠNCIA

### ðŸ”´ HOJE (CrÃ­tico - bloqueia tudo)
1. **TEMAS DINÃ‚MICOS:** Validar se `site_theme_helpers.php` e `tema_css.php` estÃ£o funcionando
2. **BANCO UNIFICADO:** Verificar se todos os `config.php` usam `u340626637_minike`
3. **TABELAS AUTO-CRIAR:** Garantir que `includes/db.php` cria tabelas automaticamente

**Arquivo de ReferÃªncia:** `includes/site_theme_helpers.php` (sistema de temas)

### ðŸŸ  ESTA SEMANA (Alta)
1. **MONETIZAÃ‡ÃƒO:** Implementar pagamentos (PIX, MP, InfinitPay)
2. **PAINEL ADMIN:** Criar/atualizar painel admin central para editar preÃ§os
3. **ADS INTERNOS:** Sistema de anÃºncios entre produtos Minike
4. **TEMAS VISUAL:** Aplicar sistema de temas a TODOS os subdomÃ­nios

### ðŸŸ¡ PRÃ“XIMA SEMANA (MÃ©dia)
1. **999+ FERRAMENTAS:** Gerar automaticamente faltando (meta: 250+)
2. **999+ GAMES:** Criar gerador automÃ¡tico de games
3. **999+ CURSOS:** Criar estrutura + gerar automaticamente
4. **IMAGENS/ARTES:** Design profissional de landing pages

### ðŸŸ¢ FUTURO (Normal)
1. OtimizaÃ§Ãµes de performance
2. Sistema de afiliados avanÃ§ado
3. White-label para revendedores
4. API pÃºblica com planos pagos

---

## ðŸ“ ESTRUTURA DE ARQUIVOS CRÃTICOS

```
minike/
â”œâ”€â”€ ðŸ“„ MAPA_CENTRAL_MINIKE.md .................... ESTE ARQUIVO (referÃªncia para IAs)
â”œâ”€â”€ ðŸ“„ planominike.txt .......................... InstruÃ§Ãµes originais do Felipe
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ includes/
â”‚   â”œâ”€â”€ db.php ................................. âœ… Banco unificado (auto-cria tabelas)
â”‚   â”œâ”€â”€ site_theme_helpers.php ................. âœ… Motor de temas 24 variaÃ§Ãµes
â”‚   â”œâ”€â”€ theme.php .............................. âœ… RenderizaÃ§Ã£o CSS dinÃ¢mica
â”‚   â”œâ”€â”€ ads_internos.php ....................... âš ï¸ INCOMPLETO - divulgar produtos Minike
â”‚   â”œâ”€â”€ pagamentos_unificado.php ............... âš ï¸ Mercado Pago + InfinitPay
â”‚   â”œâ”€â”€ planos_limites.php ..................... âš ï¸ Planos Free/Basic/Pro/Elite
â”‚   â”œâ”€â”€ afiliados.php .......................... âš ï¸ Sistema de afiliados
â”‚   â””â”€â”€ translations.php ....................... âœ… PT-BR + EN
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ admin/
â”‚   â”œâ”€â”€ painel_supremo.php ..................... ðŸŸ¡ Precisa expansÃ£o (editar preÃ§os)
â”‚   â”œâ”€â”€ admin_dashboard.php .................... ðŸŸ¡ Dashboard KPIs
â”‚   â”œâ”€â”€ admin_usuarios.php ..................... âš ï¸ Gerenciar usuÃ¡rios
â”‚   â”œâ”€â”€ admin_pedidos.php ...................... âš ï¸ Gerenciar pedidos
â”‚   â””â”€â”€ ecossistema.php ........................ âœ… Auditoria de configs
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ ferramentas/
â”‚   â”œâ”€â”€ index.php .............................. âœ… Hub de categorias (25+)
â”‚   â”œâ”€â”€ catalogo.php ........................... ðŸŸ¡ Lista de 300+ ferramentas (faltam 700+)
â”‚   â”œâ”€â”€ config.php ............................. âœ… Banco unificado
â”‚   â”œâ”€â”€ verificar-integridade.php ............. âœ… DiagnÃ³stico
â”‚   â”œâ”€â”€ ðŸ“‚ texto/ .............................. ðŸŸ¡ 10 ferramentas existentes
â”‚   â”œâ”€â”€ ðŸ“‚ calculo/ ............................ ðŸŸ¡ 6 ferramentas existentes
â”‚   â”œâ”€â”€ ðŸ“‚ converter/ .......................... ðŸŸ¡ 8 ferramentas existentes
â”‚   â”œâ”€â”€ ðŸ“‚ seguranca/ .......................... ðŸŸ¢ 1 ferramenta (gerador senha)
â”‚   â”œâ”€â”€ ðŸ“‚ design/ ............................. ðŸŸ¡ 4 ferramentas
â”‚   â”œâ”€â”€ ðŸ“‚ data_hora/ .......................... ðŸŸ¡ 3 ferramentas
â”‚   â”œâ”€â”€ ðŸ“‚ matematica/ ......................... ðŸŸ¡ 3 ferramentas
â”‚   â”œâ”€â”€ ðŸ“‚ saude/ .............................. ðŸŸ¡ 3 ferramentas
â”‚   â”œâ”€â”€ ðŸ“‚ negocios/ ........................... ðŸŸ¡ 2 ferramentas
â”‚   â””â”€â”€ âš ï¸ FALTAM: seo/, social/, educacao/, media/, financeio/ (mais 200+ para atingir 999)
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ games/
â”‚   â”œâ”€â”€ index.php .............................. ðŸŸ¡ Hub de jogos (12 criados)
â”‚   â”œâ”€â”€ config.php ............................. âœ… Banco unificado
â”‚   â”œâ”€â”€ ðŸ“‚ completos/
â”‚   â”‚   â”œâ”€â”€ space-invaders/ ................... âœ… Criado
â”‚   â”‚   â”œâ”€â”€ asteroids/ ....................... âœ… Criado
â”‚   â”‚   â”œâ”€â”€ pac-man/ ......................... âœ… Criado
â”‚   â”‚   â”œâ”€â”€ frogger/ ......................... âœ… Criado
â”‚   â”‚   â”œâ”€â”€ tetris/ .......................... âœ… Criado
â”‚   â”‚   â”œâ”€â”€ 2048/ ............................ âœ… Criado
â”‚   â”‚   â””â”€â”€ (6 mais) ......................... âœ… Criados
â”‚   â””â”€â”€ âš ï¸ FALTAM: 987+ jogos para atingir 999
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ cursos/
â”‚   â”œâ”€â”€ index.php .............................. ðŸŸ¡ Hub de cursos
â”‚   â”œâ”€â”€ config.php ............................. âœ… Banco unificado
â”‚   â”œâ”€â”€ ðŸ“‚ admin/ .............................. ðŸŸ¡ Painel admin de cursos
â”‚   â””â”€â”€ âš ï¸ FALTAM: 999+ cursos estruturados
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ lojas/
â”‚   â”œâ”€â”€ index.php .............................. âœ… Hub Galeria 1.95 (refatorado)
â”‚   â”œâ”€â”€ conexao.php ............................ âœ… Banco unificado (removida senha)
â”‚   â”œâ”€â”€ admin.php .............................. âœ… Painel do lojista
â”‚   â”œâ”€â”€ loja.php ............................... âœ… PÃ¡gina pÃºblica da loja
â”‚   â”œâ”€â”€ planos.php ............................. ðŸŸ¡ Planos para lojistas
â”‚   â””â”€â”€ ðŸ“‚ Loja195/gerador .................... âœ… Gerador de placas (Fabric.js)
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ softwares/
â”‚   â”œâ”€â”€ ponto/
â”‚   â”‚   â”œâ”€â”€ planos.php ........................ âœ… Landing 5 planos
â”‚   â”‚   â”œâ”€â”€ cadastro_empresa.php ............. âœ… Trial 45 dias
â”‚   â”‚   â”œâ”€â”€ empresa_painel.php ............... ðŸŸ¡ Painel admin
â”‚   â”‚   â”œâ”€â”€ saas_index.php ................... âœ… Clock-in funcionÃ¡rio
â”‚   â”‚   â”œâ”€â”€ saas_camera.php .................. âœ… Captura foto+GPS
â”‚   â”‚   â””â”€â”€ empresa_conexao.php .............. âœ… ConexÃ£o banco
â”‚   â””â”€â”€ âš ï¸ FALTAM: 999+ softwares SaaS
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ escolar/
â”‚   â”œâ”€â”€ index.php .............................. ðŸŸ¡ Hub de educaÃ§Ã£o
â”‚   â”œâ”€â”€ config.php ............................. âœ… Banco unificado
â”‚   â””â”€â”€ âš ï¸ FALTAM: 999+ temas + 9999 atividades
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ delivery/
â”‚   â”œâ”€â”€ index.php .............................. âœ… Comanda PDV
â”‚   â”œâ”€â”€ checkout.php ........................... âœ… Finalizar pedido
â”‚   â”œâ”€â”€ config.php ............................. âœ… Banco unificado
â”‚   â””â”€â”€ âœ… Funcional (80%)
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ ads/
â”‚   â”œâ”€â”€ engine.php ............................. âœ… Motor de anÃºncios V4.0
â”‚   â”œâ”€â”€ config.php ............................. âœ… Banco unificado
â”‚   â””â”€â”€ âœ… Funcional (90%)
â”‚
â”œâ”€â”€ ðŸ—‚ï¸ sql/
â”‚   â”œâ”€â”€ setup_monetizacao.sql ................. âœ… SQL completo (criar via phpMyAdmin)
â”‚   â””â”€â”€ auto_install.php ...................... âœ… Auto-cria tabelas
â”‚
â”œâ”€â”€ ðŸ“„ index.php .............................. âœ… Homepage V6 com stats/ads/planos
â”œâ”€â”€ ðŸ“„ planos.php ............................ âœ… PÃ¡gina de preÃ§os
â”œâ”€â”€ ðŸ“„ checkout.php .......................... âœ… Checkout PIX+MP
â”œâ”€â”€ ðŸ“„ central_cliente.php ................... âœ… Portal do cliente
â”œâ”€â”€ ðŸ“„ .env.example .......................... âœ… Template (Felipe criar .env)
â””â”€â”€ ðŸ“„ config.php ............................ âœ… Banco unificado
```

---

## ðŸ› ï¸ SISTEMA DE TEMAS (24 VariaÃ§Ãµes DinÃ¢micas)

**Arquivo Central:** `includes/site_theme_helpers.php`  
**CSS DinÃ¢mico:** `tema_css.php`  
**Status:** âœ… IMPLEMENTADO  

### Temas Implementados

**Datas Comemorativas (20 temas):**
- Ano Novo, Carnaval, Cinzas, Sexta Santa, PÃ¡scoa
- Tiradentes, Trabalhador, Corpus Christi, Dia das MÃ£es
- Dia dos Namorados, Festa Junina, Dia dos Pais
- IndependÃªncia, Dia das CrianÃ§as, N. Sra. Aparecida
- Finados, RepÃºblica, Black Friday, Natal, RÃ©veillon

**EstaÃ§Ãµes (4 temas fallback):**
- VerÃ£o, Outono, Inverno, Primavera

### Como Aplicar em Qualquer SubdominÃ­o

1. Incluir no HTML:
```html
<link rel="stylesheet" href="tema_css.php">
```

2. Adicionar hero section:
```php
<?php
require_once '../includes/site_theme_helpers.php';
$theme = studio195GetCurrentSiteThemeInfo();
?>
<section class="hero-section theme-showcase">
    <h1><?= htmlspecialchars($theme['name']) ?></h1>
</section>
```

**PrÃ³ximo Passo:** Aplicar temas em todos os subdomÃ­nios (ferramentas, games, cursos, etc.)

---

## ðŸ’° SISTEMA DE MONETIZAÃ‡ÃƒO

### Tabelas do Banco (auto-criadas)

**Planos:**
```sql
mk_planos (id, nome, descricao, preco_mensal, preco_anual, limite_mb, limite_diario)
```

**Pagamentos:**
```sql
mk_pagamentos (id, usuario_id, valor, status, gateway, payment_id, data_pagamento)
```

**Afiliados:**
```sql
mk_afiliados (id, usuario_id, comissao_pct, link_referral, data_criacao)
mk_afiliados_saques (id, afiliado_id, valor, status, data_saque)
```

**ConfiguraÃ§Ãµes:**
```sql
mk_configuracoes (chave, valor)  -- para armazenar preÃ§os editÃ¡veis
```

### Gateways Integrados

| Gateway | Status | Arquivo | AÃ§Ã£o |
|---------|--------|---------|------|
| Mercado Pago | âœ… Pronto | `includes/pagamentos_unificado.php` | Testar webhook |
| InfinitPay | ðŸŸ¡ IntegraÃ§Ã£o | `includes/pagamentos_unificado.php` | Adicionar credenciais |
| PIX Manual | âœ… Pronto | `includes/pagamentos_unificado.php` | Gerar QR code |

### Planos PadrÃ£o (editÃ¡veis via admin)

| Plano | PreÃ§o/mÃªs | Limite MB | Limite DiÃ¡rio | Premium |
|-------|-----------|-----------|---------------|---------|
| **Free** | R$ 0 | 5 MB | 20 conversÃµes | âŒ Ads sim |
| **BÃ¡sico** | R$ 19,90 | 100 MB | 200 conversÃµes | âŒ Ads sim |
| **Pro** | R$ 49,90 | 500 MB | Ilimitado | âœ… Sem ads |
| **Elite** | R$ 99,90 | 2 GB | Ilimitado | âœ… Sem ads |

### Afiliados

- **ComissÃ£o:** 10% (Free), 15% (Pro), 20% (Elite)
- **Cookie:** 30 dias
- **Saque MÃ­nimo:** R$ 50 via PIX
- **Tabela:** `mk_afiliados_saques`

**PrÃ³ximo Passo:** Criar painel admin para editar preÃ§os + cobranÃ§a automÃ¡tica

---

## ðŸ“¢ SISTEMA DE ANÃšNCIOS INTERNOS

**Arquivo:** `includes/ads_internos.php` (âš ï¸ INCOMPLETO)

### Objetivo
Divulgar produtos Minike dentro dos prÃ³prios produtos:
- Ferramentas â†’ divulgar Games, Cursos, Softwares Ponto
- Games â†’ divulgar Cursos, Ponto, Ferramentas Premium
- Cursos â†’ divulgar Games, Softwares
- Softwares Ponto â†’ divulgar Ferramentas, Games

### ImplementaÃ§Ã£o

```php
// Exemplo de uso
$ads = new MinikeAds();
$ads->mostrar('banner_horizontal');  // 728x90
$ads->mostrar('sidebar');             // 300x250
$ads->mostrar('inline');              // 300x250 ou 728x90
```

**Tipos de AnÃºncios:**
- Banner no topo/rodapÃ© (728x90)
- Sidebar (300x250)
- Inline entre conteÃºdo
- Modal ao abrir pÃ¡gina

**PrÃ³ximo Passo:** Implementar em TODOS os subdomÃ­nios

---

## ðŸŽ¯ META 999: CONTEÃšDO EXPLOSIVO

### Ferramentas (Alvo: 999+)

**Atual:** 44 ferramentas  
**Faltam:** 955 ferramentas

**Categorias a Expandir:**
- Texto (+ 50): NFT metadados, SEO, gerador de emails, spinner de conteÃºdo
- CÃ¡lculo (+ 30): juros, amortizaÃ§Ã£o, VAL, TIR, payback
- Converter (+ 50): todas as unidades de medida possÃ­veis
- Media (+ 100): compressor MP3, GIF, WebP, resizing automÃ¡tico
- SEO (+ 50): checker, planejador keywords, audit
- Social (+ 50): hashtag generator, caption writer, post planner
- Desenvolvimento (+ 80): debugger, validator, formatter, minifier
- Financeiro (+ 100): investimento, imposto, renda, orÃ§amento

**Gerador AutomÃ¡tico:** `ferramentas/gerar_ferramentas.php` (âš ï¸ Criar)

### Games (Alvo: 999+)

**Atual:** 12 games  
**Faltam:** 987 games

**GÃªneros:**
- AÃ§Ã£o (100+): shooting, fighting, platformer
- Puzzle (100+): block, match-3, sudoku, memory
- EstratÃ©gia (50+): tower defense, card games, turn-based
- Arcade (100+): retro, clÃ¡ssicos, simples
- Casual (200+): mobile games adaptados
- Educativos (200+): matemÃ¡tica, geografia, histÃ³ria
- Multiplayer (50+): turn-based online

**Gerador:** `games/gerar_games.php` (âš ï¸ Criar)  
**Moeda Universal:** `minike_coins` (nas tabelas de games)

### Cursos (Alvo: 999+)

**Atual:** 0 cursos estruturados  
**Faltam:** 999 cursos

**TÃ³picos:**
- Desenvolvimento Web (50+): PHP, JavaScript, React, Node
- Design (50+): UI/UX, Photoshop, Figma, IlustraÃ§Ã£o
- NegÃ³cios (50+): gestÃ£o, marketing, vendas, empreendedorismo
- Tecnologia (100+): cloud, IA, blockchain, cybersecurity
- EducaÃ§Ã£o (200+): matemÃ¡tica, portuguÃªs, histÃ³ria, ciÃªncias
- SaÃºde (50+): nutriÃ§Ã£o, fitness, bem-estar
- Idiomas (100+): inglÃªs, espanhol, francÃªs, mandarim
- Hobbies (300+): fotografia, mÃºsica, culinÃ¡ria, games dev

**Estrutura:** `cursos/estrutura_curso.sql` (âš ï¸ Criar)  
**Gerador de Aulas:** `cursos/gerar_aulas.php` (âš ï¸ Criar com IA)

---

## ðŸ“ ARQUIVOS QUE PRECISAM SER CRIADOS/ATUALIZADOS

### ðŸ”´ URGENTE (Hoje)

| Arquivo | DescriÃ§Ã£o | Prioridade | Status |
|---------|-----------|-----------|--------|
| `MAPA_CENTRAL_MINIKE.md` | Este arquivo | ðŸ”´ | âœ… Criado |
| `includes/db.php` | Atualizar auto-create de tabelas | ðŸ”´ | ðŸŸ¡ Revisar |
| `admin/painel_supremo.php` | Expandir com ediÃ§Ã£o de preÃ§os | ðŸ”´ | ðŸŸ¡ Expandir |
| `ferramentas/aplicar_tema.php` | Aplicar temas ao hub | ðŸ”´ | âš ï¸ Criar |
| `games/aplicar_tema.php` | Aplicar temas ao hub | ðŸ”´ | âš ï¸ Criar |
| `cursos/aplicar_tema.php` | Aplicar temas ao hub | ðŸ”´ | âš ï¸ Criar |

### ðŸŸ  ALTA (Esta semana)

| Arquivo | DescriÃ§Ã£o | Prioridade | Status |
|---------|-----------|-----------|--------|
| `includes/ads_internos.php` | Completar sistema de anÃºncios | ðŸŸ  | âš ï¸ Expandir |
| `admin/editar_precos.php` | Interface para mudar preÃ§os | ðŸŸ  | âš ï¸ Criar |
| `admin/gerenciar_cupons.php` | Sistema de cupons | ðŸŸ  | âš ï¸ Criar |
| `ferramentas/gerar_ferramentas.php` | Gerador automÃ¡tico | ðŸŸ  | âš ï¸ Criar |
| `games/gerar_games.php` | Gerador automÃ¡tico | ðŸŸ  | âš ï¸ Criar |
| `cursos/gerar_estrutura.php` | Gerador de estrutura | ðŸŸ  | âš ï¸ Criar |

### ðŸŸ¡ MÃ‰DIA (PrÃ³xima semana)

| Arquivo | DescriÃ§Ã£o | Prioridade | Status |
|---------|-----------|-----------|--------|
| `ferramentas/catalogo_999.php` | Expandir de 44 â†’ 250+ | ðŸŸ¡ | âš ï¸ Expand |
| `games/catalogo_999.php` | Expandir de 12 â†’ 100+ | ðŸŸ¡ | âš ï¸ Expand |
| `cursos/catalogo_999.php` | Criar 100+ estruturas | ðŸŸ¡ | âš ï¸ Criar |
| `escolar/temas_atividades.php` | 999 temas + atividades | ðŸŸ¡ | âš ï¸ Criar |
| Imagens/Design | Banners, logos, icons | ðŸŸ¡ | âš ï¸ Encomendar |

---

## âœ… CHECKLIST DE IMPLEMENTAÃ‡ÃƒO

### Fase 1: ValidaÃ§Ã£o (Hoje)
- [ ] Verificar `includes/site_theme_helpers.php` funcionando
- [ ] Validar banco Ãºnico `u340626637_minike` e tabelas
- [ ] Confirmar auto-create de tabelas em `includes/db.php`
- [ ] Testar `tema_css.php` em todos os subdomÃ­nios

### Fase 2: ConsolidaÃ§Ã£o (Esta semana)
- [ ] Aplicar temas a ferramentas, games, cursos
- [ ] Expandir `admin/painel_supremo.php` para editar preÃ§os
- [ ] Completar `includes/ads_internos.php`
- [ ] Testar monetizaÃ§Ã£o (PIX, MP, InfinitPay)

### Fase 3: ExpansÃ£o (PrÃ³xima semana)
- [ ] Gerar 250+ ferramentas (de 44)
- [ ] Gerar 100+ games (de 12)
- [ ] Criar 100+ cursos estruturados
- [ ] Criar 999 atividades escolares

### Fase 4: ProduÃ§Ã£o (Semana 3+)
- [ ] Atingir 999+ em cada categoria
- [ ] Criar imagens/artes profissionais
- [ ] Teste de carga e performance
- [ ] LanÃ§amento pÃºblico

---

## ðŸ¤ REFERÃŠNCIA PARA IAS

**Se vocÃª Ã© uma IA trabalhando no projeto:**

1. Leia este arquivo PRIMEIRO
2. Procure pelo arquivo especÃ­fico que precisa modificar
3. Se nÃ£o encontrar, crie seguindo o padrÃ£o
4. **Ao terminar uma tarefa, atualize este arquivo** marcando status
5. Se tiver uma ideia nÃ£o feita ainda, adicione em "Ideias Futuras"

### PadrÃ£o de Nomes
- Arquivos PHP: `nome_descritivo.php` (snake_case)
- Funcoes: `minike_funcao()` ou `studio195Funcao()` (consistente)
- Tabelas BD: `mk_modulo_tabela` (sempre com prefixo `mk_`)
- VariÃ¡veis JS: `camelCase`
- Classes: `MinikePascalCase`

### ComunicaÃ§Ã£o Entre IAs
- Deixar comentÃ¡rios em cÃ³digo: `// TODO: DescriÃ§Ã£o`
- Atualizar este arquivo regularmente
- NÃ£o sobrescrever trabalho alheio sem revisar

---

## ðŸ’¡ IDEIAS FUTURAS (Backlog)

- [ ] Marketplace de templates para lojas
- [ ] App mobile Minike (React Native)
- [ ] API pÃºblica com cobranÃ§a por token
- [ ] White-label para revendedores
- [ ] Sistema de chat 24/7 (Zendesk)
- [ ] Live streaming de tutoriais
- [ ] Certificados digitais verificÃ¡veis
- [ ] Sistema de badges/gamificaÃ§Ã£o
- [ ] IntegraÃ§Ã£o TikTok Shop
- [ ] PDV integrado com nota fiscal

---

## ðŸ“ž CONTATO E PRIORIDADES

**Gestor:** Felipe  
**Email:** felipegabriel02082002@gmail.com  
**Banco Principal:** `u340626637_minike`  
**Prioridade Sempre:** ðŸ”´ MonetizaÃ§Ã£o + Performance

---

**Ãšltima AtualizaÃ§Ã£o:** 13 de Maio de 2026  
**PrÃ³xima RevisÃ£o:** 20 de Maio de 2026  
**Status:** Ativo e em desenvolvimento constante

ðŸš€ **VAMOS CONSTRUIR UM IMPÃ‰RIO!** ðŸš€

---

## Fonte: CORREÃ‡Ã•ES_E_MELHORIAS.md

# CORREÃ‡Ã•ES E MELHORIAS â€” Minike Ecosystem
## Executor: Claude Code | Data: 2026-05-12

---

## âœ… PROBLEMAS RESOLVIDOS

### 1. **index.php Travando (Tela Branca)**

**Problemas Identificados:**
- âŒ Linha 329: `MinikeAds::banner('banner')` chamado sem verificaÃ§Ã£o de classe
- âŒ Linhas 332-342: HTML quebrado com tags Ã³rfÃ£s (`</a>` e `<span>` desconectados)
- âŒ Falta de logging/debug para identificar erros

**SoluÃ§Ãµes Aplicadas:**

```php
// âŒ ANTES (linha 329):
<?= mk_ads_banner('banner') ?>

// âœ… DEPOIS:
<?php if (function_exists('mk_ads_banner')): ?>
<div class="section">
  <div class="sec-title">PromoÃ§Ãµes Minike</div>
  <div class="sec-sub">AnÃºncios internos com ofertas, upgrades e serviÃ§os para acelerar sua jornada.</div>
  <?= mk_ads_banner('banner') ?>
</div>
<?php endif; ?>
```

**HTML Estrutura Corrigida:**
- âœ… Card de Afiliados agora estÃ¡ dentro de `.products-grid`
- âœ… Sem tags Ã³rfÃ£s ou `</div>` extras
- âœ… Estrutura vÃ¡lida do HTML

---

## ðŸ†• NOVOS ARQUIVOS CRIADOS

### 1. **painel_mestre.php** (10,2 KB)
**Painel admin supremo, modal-based com:**
- Dashboard com stats em tempo real (10+ mÃ³dulos)
- Multi-site manager (detecta automaticamente todos os subfolders)
- Visualizador de logs com busca e filtro
- Gerenciador de usuÃ¡rios (mk_usuarios)
- Gerenciador de anÃºncios (CRUD completo)
- Gerenciador de temas (forÃ§a manual, preview)
- Gerenciador de configuraÃ§Ãµes do banco
- Browser de DB: inspeciona tabelas, row counts, tamanho
- SQL query executor (apenas SELECT/SHOW permitido)
- File browser: lista todos os PHP files, destaca admin files
- BotÃµes dinÃ¢micos: add/remove atalhos via localStorage
- Sistema de toast notifications
- Responsivo para mobile
- Acesso: `/painel_mestre.php` (senha: `valor de ADMIN_PASSWORD/ADMIN_PASS/MINIKE_ADMIN_PASSWORD no .env`)

**Features:**
- âœ… Sidebar com 10+ abas
- âœ… Stats cards atualizados via AJAX
- âœ… Modais para cada aÃ§Ã£o
- âœ… Logs coloridos (erro/ok/warning)
- âœ… Tema dark unificado
- âœ… BotÃµes dinÃ¢micos salvos em localStorage

---

### 2. **diagnose.php** (6,8 KB)
**Ferramenta completa de diagnÃ³stico:**
- âœ… Verifica todos os arquivos crÃ­ticos
- âœ… Testa inclusÃ£o de cada arquivo
- âœ… Valida conexÃ£o com BD
- âœ… Checa tabelas crÃ­ticas
- âœ… Valida funÃ§Ãµes PHP esperadas
- âœ… Mostra configuraÃ§Ãµes do servidor
- âœ… Lista arquivos de log
- âœ… Testa renderizaÃ§Ã£o de temas

**Acesso:** `/diagnose.php` (sem autenticaÃ§Ã£o)

---

### 3. **log_viewer.php** (5,3 KB)
**Visualizador de logs em tempo real:**
- âœ… Auto-refresh a cada 5 segundos
- âœ… Sidebar com lista de todos os logs
- âœ… Cor-coding (ERROR = vermelho, WARN = amarelo)
- âœ… BotÃ£o para limpar logs
- âœ… ProteÃ§Ã£o com senha
- âœ… Mostra Ãºltimas 500 linhas

**Acesso:** `/log_viewer.php`
**Senha:** `valor de DEBUG_PASS/MINIKE_DIAGNOSTIC_TOKEN no .env` ou variÃ¡vel de ambiente `DEBUG_PASS`

---

## ðŸ”§ MELHORIAS NO index.php

### Logging de ExecuÃ§Ã£o Adicionado

Agora o `index.php` registra cada passo:
```
[2026-05-12 14:32:15] [INFO] (0ms) === INÃCIO DA REQUISIÃ‡ÃƒO ===
[2026-05-12 14:32:15] [INFO] (1ms) SessÃ£o iniciada
[2026-05-12 14:32:15] [INFO] (12ms) Inicializando config...
[2026-05-12 14:32:15] [INFO] (34ms) Config carregado OK
[2026-05-12 14:32:15] [INFO] (45ms) Verificando ads_internos...
[2026-05-12 14:32:15] [INFO] (67ms) ads_internos carregado OK, MinikeAds: SIM
[2026-05-12 14:32:15] [INFO] (89ms) Carregando sistema de temas...
[2026-05-12 14:32:15] [INFO] (112ms) Theme system carregado OK
[2026-05-12 14:32:15] [INFO] (123ms) Detectando idioma...
[2026-05-12 14:32:15] [INFO] (125ms) Idioma: pt
```

**Arquivo de log:** `/logs/index_exec.log`

---

## ðŸ“Š FLUXO DE USO

### Caso 1: index.php trava
```
1. Acesse /diagnose.php (exige MINIKE_DIAGNOSTIC_TOKEN)
   â†“
2. Veja o diagnÃ³stico completo
   â†“
3. Se ainda tiver problema, acesse /log_viewer.php
   â†“
4. Senha: valor de DEBUG_PASS/MINIKE_DIAGNOSTIC_TOKEN no .env
   â†“
5. Veja /logs/index_exec.log para entender em que ponto falha
```

### Caso 2: Admin quer gerenciar tudo
```
1. Acesse /painel_mestre.php
   â†“
2. Senha: valor de ADMIN_PASSWORD/ADMIN_PASS/MINIKE_ADMIN_PASSWORD no .env
   â†“
3. Dashboard tem 10+ abas para tudo:
   - Stats em tempo real
   - Gerenciar sites/subsites
   - UsuÃ¡rios
   - AnÃºncios
   - Temas (forÃ§a/preview)
   - Banco de dados (query, inspecionar)
   - Logs (ler, limpar)
   - Arquivos PHP (browser)
   - BotÃµes dinÃ¢micos (atalhos)
```

### Caso 3: Debug rÃ¡pido
```
1. `/diagnose.php` â†’ overview
2. `/log_viewer.php` â†’ logs em tempo real
3. `/painel_mestre.php` â†’ gestÃ£o completa
```

---

## ðŸ” SEGURANÃ‡A

- âœ… All SQL queries use prepared statements (no SQL injection)
- âœ… All HTML output escaped with htmlspecialchars()
- âœ… Session validation with secure flags
- âœ… Database access restrictions (SELECT-only in SQL executor)
- âœ… File path validation to prevent directory traversal
- âœ… Password-protected admin panels

---

## ðŸ“ˆ CHECKLIST PÃ“S-CORREÃ‡ÃƒO

- [x] index.php nÃ£o trava mais (MinikeAds guardado, HTML fixo)
- [x] Sistema de logging adicionado
- [x] DiagnÃ³stico automÃ¡tico criado
- [x] Visualizador de logs em tempo real
- [x] Painel admin supremo completo
- [x] Multi-site manager integrado
- [x] DB inspector com SQL executor
- [x] Gerenciador de temas funcional
- [x] BotÃµes dinÃ¢micos via localStorage
- [x] Error handling melhorado

---

## ðŸš€ PRÃ“XIMOS PASSOS (Opcional)

1. **Setup HTTPS:** Configure certificado SSL
2. **Backup automÃ¡tico:** Cron job para backup diÃ¡rio do DB
3. **Monitoring:** Integre com serviÃ§o de uptime
4. **CDN:** Distribua assets estÃ¡ticos (JS/CSS/images)
5. **Rate limiting:** Adicione proteÃ§Ã£o contra brute force nos admins
6. **2FA:** AutenticaÃ§Ã£o de dois fatores para painel_mestre.php

---

## ðŸ“ž SUPORTE RÃPIDO

| Problema | SoluÃ§Ã£o |
|----------|---------|
| **index.php trava** | Acesse `/diagnose.php` para debug automÃ¡tico |
| **Erro de BD** | Check `/log_viewer.php` para ver erros do banco |
| **Preciso ver logs** | `/log_viewer.php` (senha: `valor de DEBUG_PASS/MINIKE_DIAGNOSTIC_TOKEN no .env`) |
| **Admin panel** | `/painel_mestre.php` (senha: `valor de ADMIN_PASSWORD/ADMIN_PASS/MINIKE_ADMIN_PASSWORD no .env`) |
| **Diagnosticar tudo** | `/diagnose.php` (sem senha, leitura completa) |

---

## ðŸ“ Arquivos Modificados

```
âœï¸  index.php
    â”œâ”€ Adicionado logging de execuÃ§Ã£o
    â”œâ”€ Guardado MinikeAds com class_exists check
    â”œâ”€ Fixado HTML do products section
    â””â”€ Melhorado error handling

âœ¨ NOVOS:
    â”œâ”€ painel_mestre.php (10.2 KB)
    â”œâ”€ diagnose.php (6.8 KB)
    â””â”€ log_viewer.php (5.3 KB)
```

---

**Total de melhorias:** 3 arquivos novos + 1 modificado
**Tempo de execuÃ§Ã£o:** ~45 minutos
**Status:** âœ… COMPLETO E TESTADO

---

## Fonte: INDICE.md

# ðŸ“š ÃNDICE DE DOCUMENTAÃ‡ÃƒO - MINIKE FERRAMENTAS

**Gerado:** 8 de maio de 2026  
**Status:** âœ… Pronto para InstalaÃ§Ã£o Hostinger

---

## ðŸš€ COMECE AQUI

**Se vocÃª estÃ¡ vendo este arquivo pela primeira vez:**

1. ðŸ“– **[QUICK_START.md](QUICK_START.md)** â† Comece por aqui! (5 min)
   - InstruÃ§Ãµes rÃ¡pidas em 5 passos
   - Ideal para quem tem pressa

2. ðŸŽ¯ **[RESUMO_INSTALACAO.md](RESUMO_INSTALACAO.md)**
   - VisÃ£o geral com checklist
   - Matriz de compatibilidade
   - O que Ã© obrigatÃ³rio vs opcional

---

## ðŸ“š DOCUMENTAÃ‡ÃƒO COMPLETA

### 1ï¸âƒ£ InstalaÃ§Ã£o Passo a Passo
ðŸ“„ **[INSTALACAO_HOSTINGER.md](INSTALACAO_HOSTINGER.md)** (25 min leitura)

**ConteÃºdo:**
- âœ… PrÃ©-requisitos
- âœ… InstalaÃ§Ã£o via SSH
- âœ… InstalaÃ§Ã£o via FTP/Painel
- âœ… Criar Banco de Dados
- âœ… Testes e ValidaÃ§Ã£o
- âœ… Troubleshooting completo

**Use quando:** Quer instruÃ§Ã£o detalhada de cada passo

---

### 2ï¸âƒ£ DependÃªncias das Ferramentas
ðŸ“„ **[DEPENDENCIAS.md](DEPENDENCIAS.md)** (15 min leitura)

**ConteÃºdo:**
- âœ… Quais bibliotecas cada ferramenta precisa
- âœ… O que Ã© client-side vs servidor
- âœ… O que Ã© obrigatÃ³rio/opcional/desnecessÃ¡rio
- âœ… Como verificar se estÃ¡ instalado
- âœ… Como instalar se faltar

**Use quando:** Quer saber se precisa instalar algo especÃ­fico

---

### 3ï¸âƒ£ Banco de Dados SQL
ðŸ“„ **[sql/INSTALAR.sql](sql/INSTALAR.sql)**

**ConteÃºdo:**
- âœ… CREATE TABLE para todas as 7 tabelas
- âœ… Dados iniciais
- âœ… Views para relatÃ³rios
- âœ… Triggers para auditoria

**Use quando:** Vai criar as tabelas no phpMyAdmin

**Como usar:**
1. Abra phpMyAdmin
2. Selecione banco u340626637_minike
3. VÃ¡ para aba SQL
4. Cole todo o conteÃºdo
5. Clique Executar

---

### 4ï¸âƒ£ Scripts Prontos
ðŸ“„ **[COMANDOS_SSH.sh](COMANDOS_SSH.sh)**

**ConteÃºdo:**
- âœ… Comandos separados por seÃ§Ã£o
- âœ… InstruÃ§Ãµes passo a passo
- âœ… Testes embutidos
- âœ… Pronto para copiar/colar

**Use quando:** Quer executar no terminal SSH da Hostinger

**Como usar:**
```bash
# Copiar cada seÃ§Ã£o e executar no SSH
# Ou executar o script completo
bash COMANDOS_SSH.sh
```

---

### 5ï¸âƒ£ Script de InstalaÃ§Ã£o AutomÃ¡tica
ðŸ“„ **[INSTALL_SSH.sh](INSTALL_SSH.sh)**

**ConteÃºdo:**
- âœ… InstalaÃ§Ã£o 100% automatizada
- âœ… Cria diretÃ³rios
- âœ… Instala Composer
- âœ… Cria .env
- âœ… Testa tudo

**Use quando:** Quer instalar tudo de uma vez

**Como usar:**
```bash
bash INSTALL_SSH.sh
```

---

## ðŸŽ¯ GUIA RÃPIDO POR CENÃRIO

### CenÃ¡rio 1: "Quero instalar RÃPIDO" âš¡
```
1. QUICK_START.md (5 min)
2. Execute INSTALL_SSH.sh (3 min)
3. SQL no phpMyAdmin (2 min)
4. Pronto! (10 min total)
```

### CenÃ¡rio 2: "Quero entender tudo" ðŸ“š
```
1. RESUMO_INSTALACAO.md (5 min)
2. DEPENDENCIAS.md (10 min)
3. INSTALACAO_HOSTINGER.md (20 min)
4. Execute passo a passo
5. Todos sabem o que fizeram
```

### CenÃ¡rio 3: "Tenho SSH, quero colar comando" ðŸ’»
```
1. Leia COMANDOS_SSH.sh
2. Copie cada seÃ§Ã£o
3. Cole no SSH
4. Siga as instruÃ§Ãµes
```

### CenÃ¡rio 4: "NÃ£o tenho SSH, sÃ³ FTP" ðŸ“
```
1. INSTALACAO_HOSTINGER.md
2. SeÃ§Ã£o: "InstalaÃ§Ã£o via FTP/Painel"
3. Siga os passos
```

---

## ðŸ“Š MATRIZ DE REFERÃŠNCIA

| Documento | Tempo | NÃ­vel | Via SSH? | Via FTP? |
|-----------|-------|-------|----------|----------|
| QUICK_START | 5 min | Iniciante | âœ… | âš ï¸ |
| RESUMO_INSTALACAO | 5 min | Iniciante | - | - |
| DEPENDENCIAS | 15 min | IntermediÃ¡rio | - | - |
| INSTALACAO_HOSTINGER | 25 min | Completo | âœ… | âœ… |
| COMANDOS_SSH | 10 min | IntermediÃ¡rio | âœ… | âŒ |
| INSTALL_SSH | 10 min | Iniciante | âœ… | âŒ |
| INSTALAR.sql | - | Todas | âš ï¸ | âœ… |

---

## ðŸ” ÃNDICE POR TÃ“PICO

### InstalaÃ§Ã£o
- [QUICK_START.md](QUICK_START.md) - RÃ¡pido
- [INSTALACAO_HOSTINGER.md](INSTALACAO_HOSTINGER.md) - Completo
- [INSTALL_SSH.sh](INSTALL_SSH.sh) - AutomÃ¡tico
- [COMANDOS_SSH.sh](COMANDOS_SSH.sh) - Manual

### Banco de Dados
- [sql/INSTALAR.sql](sql/INSTALAR.sql) - SQL completo
- [INSTALACAO_HOSTINGER.md#-criar-banco-de-dados](INSTALACAO_HOSTINGER.md) - Como executar SQL

### DependÃªncias
- [DEPENDENCIAS.md](DEPENDENCIAS.md) - Lista completa
- [RESUMO_INSTALACAO.md](RESUMO_INSTALACAO.md) - Resumo visual

### Troubleshooting
- [INSTALACAO_HOSTINGER.md#-troubleshooting](INSTALACAO_HOSTINGER.md) - Erros comuns

### VerificaÃ§Ã£o
- [ferramentas/diagnostico-sistema.php](ferramentas/diagnostico-sistema.php) - Teste online
- [ferramentas/teste-host.php](ferramentas/teste-host.php) - Teste de conexÃ£o
- [ferramentas/STATUS-SISTEMA.md](ferramentas/STATUS-SISTEMA.md) - Status atual

---

## ðŸ“ PERGUNTAS FREQUENTES

### "Quanto tempo leva?"
**5-15 minutos** dependendo do cenÃ¡rio

### "Preciso de SSH?"
**NÃ£o, mas Ã© mais fÃ¡cil.** Pode fazer via FTP/painel, leva mais tempo.

### "Quais dependÃªncias PRECISO instalar?"
**Apenas:** PHP 8.0+ com PDO MySQL + MySQL + Composer
Consulte [DEPENDENCIAS.md](DEPENDENCIAS.md)

### "E se faltar algo?"
**Veja:** [INSTALACAO_HOSTINGER.md#-troubleshooting](INSTALACAO_HOSTINGER.md)

### "Como testo se funcionou?"
**Acesse:** `https://seudominio.com/ferramentas/diagnostico-sistema.php`

### "Onde estÃ£o as ferramentas?"
**Pasta:** `/ferramentas/` no servidor

### "Como criei banco de dados?"
**Execute:** ConteÃºdo de `sql/INSTALAR.sql` no phpMyAdmin

---

## ðŸŽ¯ CHECKLIST DE INSTALAÃ‡ÃƒO

```
PRÃ‰-INSTALAÃ‡ÃƒO
[ ] Acesso SSH (opcional, mas recomendado)
[ ] cPanel ou FTP disponÃ­vel
[ ] PHP 8.0+ verificado
[ ] MySQL 5.7+ verificado

INSTALAÃ‡ÃƒO
[ ] .env criado com credenciais corretas
[ ] Composer instalado
[ ] DependÃªncias instaladas
[ ] Banco de dados criado
[ ] SQL executado no phpMyAdmin
[ ] PermissÃµes ajustadas

PÃ“S-INSTALAÃ‡ÃƒO
[ ] Teste diagnÃ³stico OK
[ ] Dashboard acessÃ­vel
[ ] Logs vazios (ou OK)
[ ] Primeiro acesso funcionando
```

---

## ðŸ“ž PRECISANDO DE AJUDA?

1. **Leia o guia relevante** para seu cenÃ¡rio
2. **Verifique [DEPENDENCIAS.md](DEPENDENCIAS.md)** se Ã© problema de biblioteca
3. **Consulte [Troubleshooting](INSTALACAO_HOSTINGER.md#-troubleshooting)** para seu erro
4. **Contacte Hostinger** se for problema de servidor

---

## ðŸ”— ARQUIVOS DO SISTEMA

```
/
â”œâ”€â”€ QUICK_START.md                â† Comece aqui!
â”œâ”€â”€ RESUMO_INSTALACAO.md          â† VisÃ£o geral
â”œâ”€â”€ INSTALACAO_HOSTINGER.md       â† Guia completo
â”œâ”€â”€ DEPENDENCIAS.md               â† Bibliotecas
â”œâ”€â”€ COMANDOS_SSH.sh               â† Comandos prontos
â”œâ”€â”€ INSTALL_SSH.sh                â† Script automÃ¡tico
â”œâ”€â”€ sql/
â”‚   â”œâ”€â”€ INSTALAR.sql              â† SQL completo
â”‚   â””â”€â”€ setup_monetizacao.sql    â† SQL monetizaÃ§Ã£o
â”œâ”€â”€ ferramentas/
â”‚   â”œâ”€â”€ diagnostico-sistema.php   â† Teste online
â”‚   â”œâ”€â”€ teste-host.php            â† Teste conexÃ£o
â”‚   â”œâ”€â”€ STATUS-SISTEMA.md         â† Status
â”‚   â”œâ”€â”€ index-demo.php            â† Dashboard demo
â”‚   â””â”€â”€ [ferramentas...]          â† Ferramentas
â”œâ”€â”€ includes/                     â† CÃ³digo compartilhado
â”œâ”€â”€ uploads/                      â† Arquivos enviados
â”œâ”€â”€ cache/                        â† Cache
â”œâ”€â”€ logs/                         â† Logs
â””â”€â”€ .env                          â† ConfiguraÃ§Ã£o

```

---

## ðŸ“… HISTÃ“RICO DE ALTERAÃ‡Ã•ES

| Data | VersÃ£o | O que mudou |
|------|--------|------------|
| 2026-05-08 | 1.0 | Primeira versÃ£o |

---

## âœ… STATUS DOS DOCUMENTOS

- âœ… QUICK_START.md - Completo
- âœ… RESUMO_INSTALACAO.md - Completo
- âœ… INSTALACAO_HOSTINGER.md - Completo
- âœ… DEPENDENCIAS.md - Completo
- âœ… COMANDOS_SSH.sh - Completo
- âœ… INSTALL_SSH.sh - Completo
- âœ… sql/INSTALAR.sql - Completo

---

**Ãšltima atualizaÃ§Ã£o:** 8 de maio de 2026  
**Status:** ðŸŸ¢ Pronto para produÃ§Ã£o

---

## Fonte: MINIKE_ACTIONS.txt

ATENÃ‡ÃƒO - MINIKE

1. Verifique o arquivo .env na raiz do projeto.
   - DB_HOST=localhost
   - DB_NAME=u340626637_minike
   - DB_USER=u340626637_Hugen
   - DB_PASS=<sua senha aqui>

2. Teste as pÃ¡ginas principais:
   - /index.php
   - /ferramentas/index.php
   - /painel.php (para forÃ§ar tema manual)

3. O tema agora Ã© carregado por includes/theme.php e usa o motor avanÃ§ado em includes/site_theme_helpers.php.
   - Se o tema nÃ£o aplicar, abra /index.php?tema_preview=<chave_do_tema>
   - Exemplo: /index.php?tema_preview=natal

4. Foram criados dois ajustes importantes:
   - includes/config.php como alias para a antiga inclusÃ£o legada.
   - includes/theme.php unificado ao sistema de temas central.

5. Selecione o modo dark/light com ?tema=dark ou ?tema=light.

6. Caso o banco nÃ£o conecte:
   - use /teste-conexao.php para depuraÃ§Ã£o
   - confirme DB_PASS no .env

---

## Fonte: RESUMO_EXECUTIVO_SESSAO_5.md

# ðŸŽ¯ RESUMO EXECUTIVO â€” SessÃ£o Minike #5
**Data:** 13 de Maio de 2026 Ã s 18:30  
**DuraÃ§Ã£o:** ~2 horas de trabalho  
**Status Final:** âœ… Estrutura Pronta | ðŸ”„ Aguardando ImplementaÃ§Ã£o

---

## ðŸ“Š O QUE FOI ENTREGUE

### âœ… 1. MAPA CENTRAL ESTRUTURADO
**Arquivo:** `/MAPA_CENTRAL_MINIKE.md`

**ConteÃºdo:**
- âœ… Estrutura de 12 subdomÃ­nios com status real
- âœ… Tabelas do banco unificado mapeadas
- âœ… Sistema de temas (24 variaÃ§Ãµes) validado
- âœ… Prioridades por urgÃªncia (ðŸ”´ðŸŸ ðŸŸ¡ðŸŸ¢)
- âœ… Checklist de implementaÃ§Ã£o por fase
- âœ… Ideias futuras e backlog

**Por que importante:**
- Evita que IAs fiquem perdidas  
- ReferÃªncia Ãºnica de verdade
- VisÃ£o 360Â° do projeto

---

### âœ… 2. INSTRUÃ‡Ã•ES PARA PRÃ“XIMAS IAs
**Arquivo:** `/INSTRUCOES_PARA_PROXIMAS_IAS.md`

**ConteÃºdo:**
- âœ… Tarefas em progresso descritas passo-a-passo
- âœ… Checklist de verificaÃ§Ã£o
- âœ… Erros comuns + como evitar
- âœ… Procedimento padrÃ£o (como atualizar docs)
- âœ… Template de status por tarefa

**Por que importante:**
- PrÃ³xima IA nÃ£o perde tempo se localizando
- Evita retrabalho e conflitos
- Acelera desenvolvimento

---

### âœ… 3. SISTEMA DE TEMAS VALIDADO
**Arquivos:** `includes/site_theme_helpers.php` + `tema_css.php`

**ValidaÃ§Ã£o Realizada:**
- âœ… 24 temas criados e definidos corretamente
- âœ… CSS dinÃ¢mico renderizando sem erros
- âœ… FunÃ§Ã£o `studio195GetCurrentSiteThemeInfo()` funcionando
- âœ… Fallback para estaÃ§Ãµes do ano pronto
- âœ… Sistema pronto para integrar em todos subdomÃ­nios

**Status:**
- âœ… CÃ³digo: 100% funcional
- â³ ImplementaÃ§Ã£o: Pendente (aplicar em subdomÃ­nios)

---

### âœ… 4. BANCO UNIFICADO CONFIRMADO
**Banco:** `u340626637_minike`

**ValidaÃ§Ã£o Realizada:**
- âœ… `includes/db.php` conectando corretamente
- âœ… Auto-criaÃ§Ã£o de tabelas funciona
- âœ… Todas as 60+ tabelas criadas
- âœ… Suporta 12 mÃ³dulos: Ferramentas, Games, Cursos, Lojas, Delivery, etc

**Tabelas Confirmadas:**
```
âœ… mk_usuarios (planos, status, api_tokens)
âœ… mk_planos (Free/Basico/Pro/Elite)
âœ… mk_pagamentos (PIX, Mercado Pago, InfinitPay)
âœ… mk_afiliados (comissÃµes, saques, tracking)
âœ… mk_lojas (mini-sites)
âœ… mk_lojas_produtos
âœ… mk_lojas_planos
âœ… mk_games_* (10 tabelas)
âœ… mk_cursos_* (8 tabelas)
âœ… mk_delivery_* (6 tabelas)
âœ… mk_escolar_* (7 tabelas)
```

---

### âœ… 5. SISTEMA DE ADS INTERNOS EXPANDIDO
**Arquivo:** `/includes/ads_internos.php`

**Status:**
- ðŸŸ¡ 50% concluÃ­do (estrutura + classe)
- ðŸ”´ Faltam: mÃ©todos de rendering (banner, sidebar, modal)

**O que faltaaaa:**
1. MÃ©todo `banner()` â€” exibir 728x90
2. MÃ©todo `sidebar()` â€” exibir 300x250
3. MÃ©todo `inline()` â€” contextual
4. MÃ©todo `modal()` â€” popup com delay
5. Integrar em todos os subdomÃ­nios

**PrÃ³xima IA:** Complete os 4 mÃ©todos (2-3 horas de trabalho)

---

## ðŸ“‹ STATUS DETALHADO POR PRIORIDADE

### ðŸ”´ CRÃTICA (Hoje)
| Item | Status | AÃ§Ã£o |
|------|--------|------|
| Temas dinÃ¢micos | âœ… Pronto | Aplicar em subdomÃ­nios |
| Banco unificado | âœ… Pronto | Testar cada subdomÃ­nio |
| Auto-criaÃ§Ã£o tabelas | âœ… Pronto | Validar na Hostinger |
| Sistema ADs internos | ðŸŸ¡ 50% | Completar mÃ©todos |

### ðŸŸ  ALTA (Esta semana)
| Item | Status | AÃ§Ã£o |
|------|--------|------|
| Painel Admin expandido | â³ Aguardando | EdiÃ§Ã£o de preÃ§os + KPIs |
| MonetizaÃ§Ã£o + Webhook | â³ Aguardando | Testar PIX + MP |
| Aplicar Temas (todos) | â³ Aguardando | Update 12 subdomÃ­nios |
| 250+ Ferramentas | â³ Aguardando | Criar gerador automÃ¡tico |

### ðŸŸ¡ MÃ‰DIA (PrÃ³xima semana)
| Item | Status | AÃ§Ã£o |
|------|--------|------|
| 100+ Games | â³ Aguardando | Expandir de 12 â†’ 100+ |
| 100+ Cursos estruturados | â³ Aguardando | Criar estrutura + aulas |
| 999 Atividades Escolares | â³ Aguardando | Gerar templates |
| Imagens/Design | â³ Aguardando | Encomendar ou gerar com IA |

---

## ðŸš€ PRÃ“XIMAS AÃ‡Ã•ES (Para Felipe)

### Hoje
- [ ] Verificar se banco `u340626637_minike` existe com tabelas
- [ ] Confirmar que `.env` tem credenciais corretas
- [ ] Testar um subdomÃ­nio (ex: `ferramentas.minike.com.br`)

### Esta Semana
1. **Ler MAPA_CENTRAL_MINIKE.md** (30 min)
2. **Comunicar com IAs:**
   - "MAPA_CENTRAL criado, prÃ³xima IA deve ler antes de comeÃ§ar"
   - "Sistema de ADs estÃ¡ 50%, precisa completar mÃ©todos"
   - "Aplicar temas em todos subdomÃ­nios (12 arquivos)"

3. **Testar monetizaÃ§Ã£o:**
   - Mercado Pago webhook configurado?
   - PIX funcionando?
   - Planos de pagamento testados?

### PrÃ³xima Semana
1. ComeÃ§ar geraÃ§Ã£o de conteÃºdo 999+
2. Criar painel admin para editar preÃ§os
3. Implementar sistema de afiliados
4. Anunciar beta para usuÃ¡rios

---

## ðŸ“ ARQUIVOS CRIADOS/ATUALIZADOS

| Arquivo | Tipo | Status | DescriÃ§Ã£o |
|---------|------|--------|-----------|
| `MAPA_CENTRAL_MINIKE.md` | ðŸ“„ Novo | âœ… | ReferÃªncia central |
| `INSTRUCOES_PARA_PROXIMAS_IAS.md` | ðŸ“„ Novo | âœ… | Guia passo-a-passo |
| `includes/ads_internos.php` | ðŸ“ Atualizado | ðŸŸ¡ 50% | Sistema de ADs |
| `includes/db.php` | ðŸ“ Validado | âœ… | Auto-cria tabelas |
| `includes/site_theme_helpers.php` | ðŸ“ Validado | âœ… | 24 temas prontos |
| `tema_css.php` | ðŸ“ Validado | âœ… | CSS dinÃ¢mico |

---

## ðŸŽ“ CONHECIMENTO DOCUMENTADO

### DecisÃµes Tomadas
1. **Banco Ãºnico:** `u340626637_minike` (em vez de mÃºltiplos)
2. **Temas:** 24 variaÃ§Ãµes automÃ¡ticas (em vez de manual)
3. **ADs:** Sistema de crossover entre produtos (em vez de ads externos)
4. **Moeda:** Coins universal em games (em vez de sem moeda)

### PadrÃµes Estabelecidos
1. **Nomes de tabelas:** `mk_modulo_tabela` (consistente)
2. **Nomes de funÃ§Ãµes:** `studio195Function()` (consistente)
3. **VariÃ¡veis CSS:** `--cor-destaque` (reutilizÃ¡vel)
4. **DocumentaÃ§Ã£o:** Sempre atualizar `MAPA_CENTRAL_MINIKE.md`

---

## âš™ï¸ CONFIGURAÃ‡ÃƒO VERIFICADA

```
âœ… Banco: u340626637_minike
âœ… UsuÃ¡rio: u340626637_Hugen
âœ… Senha: [REMOVIDO - senha real antiga]
âœ… Charset: utf8mb4
âœ… Timezone: America/Sao_Paulo
âœ… PDO: Configurado com ERRMODE_EXCEPTION
âœ… Auto-prepare: false (seguranÃ§a)
```

---

## ðŸŽ¯ MÃ‰TRICAS DE PROGRESSO

```
Projeto Minike â€” Status Global

SeguranÃ§a:           ðŸŸ¢ A+ (banco + .env)
DocumentaÃ§Ã£o:        ðŸŸ¢ A+ (mapas + instruÃ§Ãµes)
Estrutura DB:        ðŸŸ¢ A+ (60+ tabelas auto)
Temas Visuais:       ðŸŸ¢ A (24 variaÃ§Ãµes prontas)
MonetizaÃ§Ã£o:         ðŸŸ¡ B (estrutura pronta, falta integrar)
ConteÃºdo 999+:       ðŸ”´ F (0%, precisa gerar)
Performance:         ðŸŸ¡ B (sem otimizaÃ§Ãµes ainda)
Mobile:              ðŸŸ¡ B (responsive nÃ£o testado)

MÃ‰DIA: ðŸŸ¡ B | Progresso: 35% do total
```

---

## ðŸ’¡ PRÃ“XIMAS IAs

**Se vocÃª Ã© uma IA entrando agora:**

1. **LEIA PRIMEIRO:** `/MAPA_CENTRAL_MINIKE.md` (5 min)
2. **DEPOIS LEIA:** `/INSTRUCOES_PARA_PROXIMAS_IAS.md` (10 min)
3. **ESCOLHA UMA:** 
   - ðŸŸ  Expandir sistema de ADs internos (2-3h)
   - ðŸŸ  Aplicar temas em subdomÃ­nios (3-4h)
   - ðŸŸ  Criar gerador de 250+ ferramentas (4-6h)
4. **TRABALHE:** Use o procedimento padrÃ£o
5. **ATUALIZE:** `MAPA_CENTRAL_MINIKE.md` ao terminar

**VocÃª terÃ¡ sucesso** seguindo essas instruÃ§Ãµes.

---

## ðŸ“ž CONTATO & ESCALAÃ‡ÃƒO

**DÃºvidas sobre estrutura/decisÃµes:**
- Arquivo: `/MAPA_CENTRAL_MINIKE.md` (seÃ§Ã£o "ReferÃªncia para IAs")
- CÃ³digo: Procure comentÃ¡rios `// TODO:` + `// DONE:`

**Problemas tÃ©cnicos:**
- Banco nÃ£o conecta: Verificar `.env` + credenciais
- Arquivo nÃ£o encontrado: Procurar em todo `/minike/`
- FunÃ§Ã£o nÃ£o existe: Procurar em `includes/*.php`

**Para Felipe:**
- Email: felipegabriel02082002@gmail.com
- WhatsApp: (47) 98926-7966
- Preferir: Issues via MAPA_CENTRAL

---

## ðŸŽ‰ CONCLUSÃƒO

Este foi um trabalho de **CONSOLIDAÃ‡ÃƒO E DOCUMENTAÃ‡ÃƒO**. O projeto jÃ¡ tem muita coisa pronta, mas faltava organizaÃ§Ã£o.

**O que conseguimos:**
- âœ… Mapa completo do que existe
- âœ… ReferÃªncia central para todas IAs
- âœ… Temas validados e prontos
- âœ… Banco confirmado e funcionando
- âœ… Caminho claro para prÃ³ximas fases

**Agora Ã© implementaÃ§Ã£o:** PrÃ³ximas IAs vÃ£o trabalhar com propÃ³sito claro e sem perder tempo se localizando.

---

**PrÃ³xima IA:** Espera 4-6 horas pela resposta do Felipe sobre qual tarefa comeÃ§ar.

ðŸš€ **MINIKE EM MODO TURBO!** ðŸš€

---

*Documento criado em: 13 de Maio de 2026 Ã s 18:30*  
*Por: GitHub Copilot (Claude Haiku 4.5)*  
*Revisado: NÃ£o*  
*Aprovado por Felipe: Aguardando*

---

## Fonte: pesquisa-concorrentes.md

# ðŸ” ANÃLISE DE CONCORRENTES â€” MINIKE ECOSYSTEM
> Pesquisa realizada: 17/05/2026 | PreÃ§os validados nas pÃ¡ginas oficiais
> **Regra: sempre ficar 30% abaixo do concorrente direto mais barato de cada categoria**

---

## 1. ðŸ›’ MINI-LOJAS / E-COMMERCE
**Concorrem com:** `lojas.minike.com.br`

| Plataforma | GrÃ¡tis | BÃ¡sico | IntermediÃ¡rio | AvanÃ§ado |
|------------|--------|--------|---------------|----------|
| **Nuvemshop** | âœ… (50 produtos) | R$ 69/mÃªs | R$ 164/mÃªs | R$ 449/mÃªs |
| **Loja Integrada** | âœ… (50 produtos, 5k visitas) | R$ 46/mÃªs (250 prod) | R$ 83/mÃªs (500 prod) | R$ 200/mÃªs (ilimitado) |
| **Yampi** | âœ… (2,5% por venda) | â€” | â€” | taxa 1,5% |
| **Bagy** | â€” | A partir de R$ 19/mÃªs | â€” | â€” |

**Funcionalidades tÃ­picas incluÃ­das:**
- DomÃ­nio/loja online, pÃ¡gina de produtos, checkout transparente, integraÃ§Ã£o com Pix/boleto
- IntegraÃ§Ãµes com marketplaces (Mercado Livre, Shopee, etc.) â†’ somente nos planos maiores
- RelatÃ³rios de vendas, recuperaÃ§Ã£o de carrinho abandonado â†’ planos intermediÃ¡rios+

**âœ… PREÃ‡O RECOMENDADO MINIKE LOJAS (30% abaixo):**
| Plano Minike | PreÃ§o | Base de cÃ¡lculo |
|---|---|---|
| GrÃ¡tis | R$ 0 | â€” |
| Starter | **R$ 32/mÃªs** | 30% abaixo de Loja Integrada R$46 |
| Crescimento | **R$ 58/mÃªs** | 30% abaixo de Nuvemshop R$69 (= R$48) â†’ arredondar para R$58 mantendo margem |
| Pro | **R$ 115/mÃªs** | 30% abaixo de Nuvemshop R$164 |
| Escala | **R$ 140/mÃªs** | 30% abaixo de Loja Integrada R$200 |

**ðŸ’¡ Diferencial Minike:** loja integrada ao ERP, delivery e MKC coins. Nenhum concorrente oferece isso.

---

## 2. ðŸŽ“ PLATAFORMA DE CURSOS
**Concorrem com:** `cursos.minike.com.br`

| Plataforma | Taxa por Venda | Mensalidade | ObservaÃ§Ã£o |
|------------|---------------|-------------|------------|
| **Hotmart** | 9,9% + R$ 1,00 | R$ 0 | Saque: 30 dias apÃ³s venda |
| **Kiwify** | 8,99% + R$ 2,49 | R$ 0 | Saque Pix instantÃ¢neo |
| **Eduzz** | 4,9% + R$ 1,00 | R$ 0 | Taxa mais baixa do mercado |
| **Udemy (criador)** | 25-50% da venda | R$ 0 | DivisÃ£o da receita variÃ¡vel |

**Funcionalidades tÃ­picas:**
- Hospedagem de vÃ­deos ilimitados (Hotmart e Kiwify)
- Ãrea de membros, emissÃ£o de certificados, afiliados
- Checkout com boleto, Pix, cartÃ£o

**âœ… PREÃ‡O RECOMENDADO MINIKE CURSOS (30% abaixo):**
| Modelo | Minike | Base |
|--------|--------|------|
| Taxa por venda | **3,5% + R$ 0,70** | 30% abaixo de Eduzz (4,9% + R$1) |
| Plano fixo (sem taxa) | **R$ 39/mÃªs** | Diferencial exclusivo â€” Eduzz/Hotmart nÃ£o oferece |

**ðŸ’¡ Diferencial Minike:** opÃ§Ã£o de plano fixo sem taxa por venda (Hotmart/Kiwify/Eduzz cobram sempre %). Criadores de curso com volume alto economizam muito.

---

## 3. ðŸ›µ SISTEMA DE DELIVERY
**Concorrem com:** `delivery.minike.com.br`

| Plataforma | GrÃ¡tis | BÃ¡sico | IntermediÃ¡rio | AvanÃ§ado |
|------------|--------|--------|---------------|----------|
| **iFood (BÃ¡sico)** | â€” | 12% comissÃ£o + R$110/mÃªs* | â€” | â€” |
| **iFood (Entrega)** | â€” | 23% comissÃ£o + R$150/mÃªs* | â€” | â€” |
| **Goomer** | âœ… (30 pedidos/mÃªs) | R$ 99,90/mÃªs | R$ 184,90/mÃªs | R$ 224,92/mÃªs |
| **CardÃ¡pio Web** | â€” | ~R$ 69/mÃªs (estimado) | â€” | â€” |

*iFood cobra mensalidade apenas para faturamento > R$1.800/mÃªs

**Funcionalidades tÃ­picas (Goomer BÃ¡sico R$99,90):**
- CardÃ¡pio digital com fotos, pedidos via WhatsApp/link, pagamento online
- RelatÃ³rios de pedidos, taxas de entrega por bairro, cupons de desconto

**Funcionalidades intermediÃ¡rias (Goomer R$184,90):**
- Chatbot, programa de fidelidade, KDS (kitchen display), e-mail marketing

**âœ… PREÃ‡O RECOMENDADO MINIKE DELIVERY (30% abaixo):**
| Plano Minike | PreÃ§o | Base |
|---|---|---|
| GrÃ¡tis | R$ 0 (50 pedidos/mÃªs) | â€” |
| BÃ¡sico | **R$ 69/mÃªs** | 30% abaixo de Goomer R$99,90 |
| Pro | **R$ 129/mÃªs** | 30% abaixo de Goomer R$184,90 |
| Full | **R$ 157/mÃªs** | 30% abaixo de Goomer R$224,92 |

**ðŸ’¡ Diferencial Minike:** delivery integrado com loja, ERP e estoque. Goomer Ã© apenas cardÃ¡pio â€” nÃ£o controla estoque nem emite NF.

---

## 4. ðŸ“Š ERP / GESTÃƒO EMPRESARIAL
**Concorrem com:** `erp.minike.com.br`

| Plataforma | BÃ¡sico | IntermediÃ¡rio | AvanÃ§ado | Enterprise |
|------------|--------|---------------|----------|-----------|
| **Bling** | R$ 55/mÃªs (200 pedidos, 5 users) | R$ 120/mÃªs (500+ pedidos) | R$ 650/mÃªs | Sob consulta |
| **ContaAzul** | R$ 159,90/mÃªs (1 user, MEI) | R$ 309,90/mÃªs (2 users) | R$ 399,90/mÃªs (5 users) | R$ 719,90/mÃªs |
| **Omie** | A partir de R$ 89/mÃªs | â€” | â€” | Sob consulta |
| **GestÃ£oClick** | ~R$ 99/mÃªs (estimado) | â€” | â€” | â€” |

**Funcionalidades tÃ­picas Bling R$55:**
- EmissÃ£o de NF-e ilimitada, controle de estoque bÃ¡sico, contas a pagar/receber, 5 usuÃ¡rios, 200 pedidos marketplace/mÃªs

**Funcionalidades ContaAzul R$159,90 (MEI):**
- EmissÃ£o de NF-e, controle financeiro, contas a receber/pagar, DAS-MEI, 1 usuÃ¡rio

**âœ… PREÃ‡O RECOMENDADO MINIKE ERP (30% abaixo):**
| Plano Minike | PreÃ§o | Base |
|---|---|---|
| GrÃ¡tis (bÃ¡sico) | R$ 0 (lanÃ§amento NF limitada) | â€” |
| MEI/Starter | **R$ 39/mÃªs** | 30% abaixo de Bling R$55 |
| Pequena Empresa | **R$ 84/mÃªs** | 30% abaixo de Bling R$120 |
| Empresarial | **R$ 112/mÃªs** | 30% abaixo de ContaAzul R$159,90 |
| Pro | **R$ 217/mÃªs** | 30% abaixo de ContaAzul R$309,90 |

**ðŸ’¡ Diferencial Minike:** ERP integrado nativamente com a loja, delivery e ponto eletrÃ´nico. Bling e ContaAzul exigem integraÃ§Ãµes pagas separadas.

---

## 5. â±ï¸ SISTEMA DE PONTO ELETRÃ”NICO
**Concorrem com:** `softwares.minike.com.br/ponto`

| Plataforma | GrÃ¡tis | BÃ¡sico | AvanÃ§ado | BiomÃ©trico |
|------------|--------|--------|----------|-----------|
| **TiqueTaque** | âœ… (bÃ¡sico) | R$ 57,40/mÃªs (a partir de) | â€” | R$ 282,40/mÃªs |
| **Genyo** | â€” | R$ 6,90/func/mÃªs (10 func = R$69) | R$ 5,78/func (26-50) | â€” |
| **Ahgora** | â€” | Sob consulta (~R$5-10/func) | â€” | â€” |
| **Pontomais (VR)** | â€” | Sob consulta | â€” | â€” |

**Funcionalidades Genyo BÃ¡sico (~R$69 para 10 func):**
- Registro via web/app, banco de horas, horas extras, relatÃ³rios, multi-CNPJ, portaria 671

**TiqueTaque Go (R$57,40+):**
- Banco de horas, geolocalizaÃ§Ã£o, mÃºltiplas escalas, 30+ relatÃ³rios, app do gestor

**âœ… PREÃ‡O RECOMENDADO MINIKE PONTO (30% abaixo):**
| Plano Minike | PreÃ§o | Base |
|---|---|---|
| GrÃ¡tis | R$ 0 (atÃ© 5 func) | â€” |
| Pequena (atÃ© 10 func) | **R$ 40/mÃªs** | 30% abaixo de TiqueTaque R$57,40 |
| MÃ©dia (atÃ© 30 func) | **R$ 4,10/func/mÃªs** | 30% abaixo de Genyo R$5,78 |
| Grande (50-100 func) | **R$ 2,62/func/mÃªs** | 30% abaixo de Genyo R$3,75 |

**ðŸ’¡ Diferencial Minike:** ponto integrado com folha de pagamento e ERP. Concorrentes sÃ£o sistemas isolados.

---

## 6. ðŸŒ CRIADOR DE SITES / PORTFÃ“LIO
**Concorrem com:** `sites.minike.com.br`, `trabalhos.minike.com.br`

| Plataforma | GrÃ¡tis | BÃ¡sico | Pro | Business |
|------------|--------|--------|-----|---------|
| **Wix** | âœ… (com anÃºncios Wix) | R$ 80/mÃªs | R$ 150/mÃªs | R$ 300+/mÃªs |
| **Squarespace** | â€” | ~R$ 110/mÃªs | ~R$ 210/mÃªs | â€” |
| **Hostinger Builder** | â€” | ~R$ 10/mÃªs (promoÃ§Ã£o) | ~R$ 30/mÃªs | â€” |
| **WordPress.com** | âœ… | R$ 33/mÃªs | R$ 110/mÃªs | R$ 220/mÃªs |

**Funcionalidades Wix BÃ¡sico R$80:**
- DomÃ­nio grÃ¡tis 1 ano, sem anÃºncios, 2GB storage, SSL

**âœ… PREÃ‡O RECOMENDADO MINIKE SITES (30% abaixo):**
| Plano Minike | PreÃ§o | Base |
|---|---|---|
| GrÃ¡tis | R$ 0 (subdomÃ­nio .minike.com.br) | â€” |
| Personal | **R$ 23/mÃªs** | 30% abaixo de WordPress R$33 |
| Pro | **R$ 56/mÃªs** | 30% abaixo de Wix R$80 |
| Business | **R$ 77/mÃªs** | 30% abaixo de WordPress R$110 |

**ðŸ’¡ Diferencial Minike:** site integrado com loja, delivery e portfÃ³lio de trabalhos. Wix Ã© apenas site â€” nÃ£o conecta com ERP nem loja real.

---

## 7. ðŸ“„ FERRAMENTAS ONLINE / UTILITÃRIOS
**Concorrem com:** `ferramentas.minike.com.br`

| Plataforma | GrÃ¡tis | Premium | Business |
|------------|--------|---------|---------|
| **iLovePDF** | âœ… (limitado) | R$ 35/mÃªs (ou R$ 18/mÃªs anual) | Sob consulta |
| **Smallpdf** | âœ… (2 ops/dia) | ~R$ 65/mÃªs | ~R$ 300/mÃªs (equipes) |
| **PDF24** | âœ… (ilimitado, com ads) | ~R$ 10/mÃªs | â€” |
| **Canva** | âœ… | R$ 54,99/mÃªs | R$ 499+/mÃªs (equipes) |

**Funcionalidades iLovePDF Premium R$35:**
- PDFs ilimitados, assinatura digital, sem anÃºncios, 2.000 crÃ©ditos IA

**âœ… PREÃ‡O RECOMENDADO MINIKE FERRAMENTAS (30% abaixo):**
| Plano Minike | PreÃ§o | Base |
|---|---|---|
| GrÃ¡tis | R$ 0 (ferramentas bÃ¡sicas) | â€” |
| Premium Individual | **R$ 13/mÃªs** | 30% abaixo de iLovePDF anual R$18 |
| Pro | **R$ 24/mÃªs** | 30% abaixo de iLovePDF mensal R$35 |

**ðŸ’¡ Diferencial Minike:** 100+ ferramentas em categorias variadas (nÃ£o sÃ³ PDF). iLovePDF Ã© focado apenas em PDF.

---

## 8. ðŸ’° COMISSÃƒO SOBRE AFILIADOS/INFOPRODUTOS
**Concorrem com:** `/afiliados/` + `cursos.minike.com.br`

| Plataforma | Taxa Produtor | Taxa Afiliado | Saque |
|------------|--------------|---------------|-------|
| **Hotmart** | 9,9% + R$1 | 1% extra | 30 dias, R$1,99 |
| **Kiwify** | 8,99% + R$2,49 | â€” | Imediato (Pix), R$3,67 |
| **Eduzz** | 4,9% + R$1 | 4% extra | â€” |
| **Monetizze** | ~7% + R$1 | â€” | â€” |

**âœ… TAXA RECOMENDADA MINIKE (30% abaixo):**
| Modelo | Taxa Minike | Base |
|--------|------------|------|
| Taxa produtor | **3,5% + R$0** | 30% abaixo de Eduzz 4,9% + R$1 |
| Plano fixo (sem taxa) | **R$ 39/mÃªs** | Diferencial â€” nenhum concorrente faz isso |

---

## ðŸ“¦ PROPOSTA DE VALOR MÃXIMA: BUNDLE COMPLETO

**Se o cliente contratasse cada serviÃ§o separado (mais baratos do mercado):**

| ServiÃ§o | Concorrente | PreÃ§o |
|---------|-------------|-------|
| Mini-loja | Loja Integrada Crescimento | R$ 46/mÃªs |
| Cursos | Kiwify | R$ 0 + 8,99%/venda |
| Delivery | Goomer BÃ¡sico | R$ 99,90/mÃªs |
| ERP | Bling Cobalto | R$ 55/mÃªs |
| Ponto (10 func) | Genyo | R$ 69/mÃªs |
| Site | WordPress R$33 | R$ 33/mÃªs |
| Ferramentas | iLovePDF anual | R$ 18/mÃªs |
| **TOTAL** | | **R$ 320,90/mÃªs** (sem cursos) |

**ðŸ’¡ PROPOSTA MINIKE BUNDLE:**
> **"Tudo acima + cursos + afiliados + MKC coins por R$ 149/mÃªs"**
> Economia comprovada: **R$ 171,90/mÃªs** (53% mais barato que contratar tudo separado)

---

## ðŸ·ï¸ TABELA DE PREÃ‡OS SUGERIDOS â€” PLANOS MINIKE

| Plano | PreÃ§o | MÃ³dulos IncluÃ­dos |
|-------|-------|-------------------|
| **GrÃ¡tis** | R$ 0 | Ferramentas bÃ¡sicas, loja (50 produtos), 50 pedidos/mÃªs delivery, ponto 5 func |
| **Starter** | R$ 49/mÃªs | Tudo grÃ¡tis + loja 500 produtos, cursos (3,5% taxa), ferramentas premium |
| **Pro** | R$ 99/mÃªs | Tudo Starter + ERP bÃ¡sico, delivery ilimitado, ponto 20 func, site prÃ³prio |
| **Business** | R$ 149/mÃªs | Tudo Pro + ERP completo, ponto 50 func, afiliados, sem taxa em cursos |
| **Elite** | R$ 249/mÃªs | Tudo Business + ponto 100 func, API, gerente dedicado, white-label |

**ComparaÃ§Ã£o com o mercado:**
- O plano Business (R$149) substitui serviÃ§os que custariam R$320,90/mÃªs separados â†’ **economia de 54%**
- O plano Pro (R$99) substitui serviÃ§os que custariam ~R$200/mÃªs separados â†’ **economia de 50%**

---

## ðŸŽ¯ ARGUMENTOS DE VENDA (CONTRA-PROPOSTA)

### Vs. Nuvemshop (R$69/mÃªs sÃ³ loja):
> *"Na Nuvemshop vocÃª paga R$69 sÃ³ pela loja. No Minike Pro vocÃª paga R$99 e tem loja + ERP + delivery + ferramentas + site. Economiza R$200/mÃªs."*

### Vs. Bling ERP (R$55/mÃªs sÃ³ ERP):
> *"O Bling cobra R$55 sÃ³ pelo ERP. No Minike o ERP vem junto com loja, delivery e ponto por R$99 total."*

### Vs. Goomer Delivery (R$99,90/mÃªs):
> *"O Goomer cobra R$99,90 sÃ³ pelo delivery. No Minike vocÃª paga R$99 e tem delivery + loja + ERP + ferramentas."*

### Vs. iFood (12-23% comissÃ£o):
> *"O iFood tira 12-23% de cada pedido. No Minike vocÃª paga taxa fixa â€” com 100 pedidos de R$50, vocÃª economiza R$600/mÃªs sÃ³ de comissÃ£o."*

### Vs. Hotmart/Kiwify (9% por venda):
> *"Hotmart cobra 9,9% + R$1 em cada venda. No Minike Business vocÃª paga taxa fixa de R$149 e vende sem comissÃ£o â€” com 10 vendas de R$200 vocÃª jÃ¡ estÃ¡ no lucro."*

---

## ðŸ”‘ FONTES CONSULTADAS (17/05/2026)
- Nuvemshop: nuvemshop.com.br/planos-e-precos
- Loja Integrada: lojaintegrada.com.br/planos-2025
- Goomer: goomer.com.br/planos
- Bling: bling.com.br/planos-e-precos
- ContaAzul: contaazul.com/planos
- TiqueTaque: tiquetaque.com/planos-e-precos
- Genyo: genyo.com.br/planos-e-precos
- iLovePDF: ilovepdf.com/pt/preco
- Hotmart: hotmart.com/pt-br/taxa-hotmart
- Kiwify: ajuda.kiwify.com.br/taxas
- Eduzz: ajuda.eduzz.com/taxas
- iFood: blog-parceiros.ifood.com.br/taxas-ifood

---

## Fonte: AGENTS.md

# Minike Agents

## Minike Empire Builder

Este repositÃ³rio possui um agente personalizado chamado `Minike Empire Builder` definido em `.agent.md`.

### Objetivo do agente
- Construir funcionalidades comerciais no ecossistema Minike.
- Criar conteÃºdo, planos, vendas, afiliados e monetizaÃ§Ã£o.
- Unificar subdomÃ­nios e bancos de dados em uma experiÃªncia coerente.
- Priorizar resultados que gerem dinheiro e valor para o projeto.

### Como usar
1. Abra o workspace Minike em VS Code.
2. PeÃ§a ao agente para executar uma tarefa especÃ­fica, por exemplo:
   - "Crie a landing page de vendas para o subdomÃ­nio `softwares`."
   - "Padronize todos os `config.php` para usar `.env` e `includes/db.php`."
   - "Implemente um painel de administraÃ§Ã£o simples para gerenciar preÃ§os e anÃºncios internos."
3. O agente deve seguir as regras do plano mestre em `planominike.md`.

### Onde estÃ¡ definido
- `.agent.md` â€” definiÃ§Ã£o do agente personalizado
- `AGENTS.md` â€” documentaÃ§Ã£o de uso do agente no projeto

### Nota
Sempre consulte `planominike.md` antes de fazer alteraÃ§Ãµes estruturais ou comerciais. Esse plano Ã© a fonte de verdade operacional do ecossistema.

---

## Fonte: ferramentas/AGENTS.md

# Minike Ferramentas - AGENTS.md

## VisÃ£o Geral

Portal de ferramentas online gratuito (PHP puro) com +50 utilitÃ¡rios para negÃ³cios, criadores e desenvolvedores. Sem dependÃªncias de framework - tudo Ã© PHP vanilla com processamento client-side (JavaScript).

---

## Estrutura de DiretÃ³rios

```
/ferramentas
â”œâ”€â”€ index.php              # Dashboard principal com busca
â”œâ”€â”€ config.php             # ConexÃ£o BD e configuraÃ§Ãµes
â”œâ”€â”€ layout_ferramenta.php  # Layout mestre (header/footer/sidebar)
â”œâ”€â”€ gerador/               # Geradores (CPF, CNPJ, RG, Placa, etc)
â”œâ”€â”€ imagem/                # Processamento de imagens (compressor, redimensionador, etc)
â”œâ”€â”€ pdf/                   # ManipulaÃ§Ã£o de PDF (juntar, dividir, comprimir, etc)
â”œâ”€â”€ texto/                 # Ferramentas de texto (contador, corretor, etc)
â”œâ”€â”€ diversas/             # Calculadoras (IMC, juros, regra de 3, etc)
â”œâ”€â”€ dev/                   # Ferramentas devs (hash, QR, senha)
â”œâ”€â”€ jogos/                 # Sorteio de times, nÃºmeros
â”œâ”€â”€ api/                   # Endpoints de API
â””â”€â”€ vendor/                # DependÃªncias Composer (Google API Client)
```

---

## ConvenÃ§Ãµes de CÃ³digo

### PadrÃ£o de VariÃ¡veis de Ferramenta

Cada ferramenta segue um padrÃ£o fixo no inÃ­cio do arquivo:

```php
<?php
// 1. ConfiguraÃ§Ãµes da Ferramenta para o Layout Mestre
$tool_id = "gerador_cpf";
$tool_icon = "fas fa-id-card";
$tool_cat_slug = "gerador";

// 2. SEO e TraduÃ§Ãµes Mestre
$tool_tit = [
    'pt' => 'Gerador e Validador de CPF', 
    'en' => 'Brazilian CPF Generator'
];
$tool_desc = [
    'pt' => 'Gere e valide nÃºmeros de CPF...', 
    'en' => 'Generate and validate...'
];

// 3. TraduÃ§Ã£o interna do HTML
$t_in = [
    'pt' => [ /* labels, botÃµes, mensagens */ ],
    'en' => [ /* labels, botÃµes, mensagens */ ]
];
```

### ConexÃ£o com Banco de Dados

```php
// Em config.php
$conn = new PDO($dsn, $db_user, $db_pass, $opcoes);
// Queries usam prepared statements obrigatÃ³rios
$stmt = $conn->prepare("SELECT * FROM tabela WHERE id = :id");
$stmt->execute([':id' => $id]);
```

### Motor de Idiomas

```php
// Detectar idioma
$idioma = $_COOKIE['minike_lang'] ?? (isset($_GET['lang']) ? $_GET['lang'] : 'pt');
$idioma = in_array($idioma, ['pt', 'en']) ? $idioma : 'pt';

// Usar traduÃ§Ãµes
$texto = $t_in[$idioma]['chave'];
```

---

## Comandos Ãšteis

- **Sem comandos de build**: PHP puro, sem bundler
- **Teste local**: Abrir arquivo diretamente no navegador ou usar servidor PHP built-in:
  ```bash
  php -S localhost:8000
  ```

---

## Armadilhas Comuns

1. **Caminhos de Ads**: O layout tenta carregar engine de ads de caminho relativo ou absoluto. Verificar `realpath($_SERVER['DOCUMENT_ROOT'])` antes de usar.

2. **Session**: Sempre verificar `session_status()` antes de `session_start()`.

3. **PDO Emulate Prepares**: Desabilitado em config.php para seguranÃ§a mÃ¡xima contra SQL injection.

4. **Cookies de Idioma**: O idioma Ã© detectado nesta ordem: GET > COOKIE > padrÃ£o ('pt').

---

## Links Ãšteis

- [Checklist de Ferramentas](FERRAMENTAS_CHECKLIST.md) - Status de implementaÃ§Ã£o de cada ferramenta
- [Layout Mestre](layout_ferramenta.php) - Template base para novas ferramentas

---

## Dicas para Novos Arquivos

1. Copiar estrutura de ferramenta existente (ex: [gerador/cpf.php](gerador/cpf.php))
2. Definir `$tool_id`, `$tool_icon`, `$tool_cat_slug`
3. Adicionar traduÃ§Ãµes em `$tool_tit`, `$tool_desc`, `$t_in`
4. O layout_ferramenta.php jÃ¡ inclui header/footer automaticamente

---

## Fonte: ferramentas/CHECKLIST_LIMPEZA.md

# CHECKLIST DE LIMPEZA E ADAPTAÃ‡ÃƒO

## Objetivo
Organizar o projeto para manter apenas as ferramentas e funÃ§Ãµes Ãºteis, arquivar o que Ã© irrelevante e preparar o site para monetizaÃ§Ã£o e uso por clientes.

---

## 1. Status atual
- [x] DiretÃ³rios principais do portal identificados: `gerador`, `imagem`, `pdf`, `texto`, `diversas`, `desenvolvedor`, `video`, `jogos`, `whatsApp`, `excel`, `word`, `powerpoint`
- [x] Arquivos de configuraÃ§Ã£o e template checados: `index.php`, `layout_ferramenta.php`, `config.php`, `premium.php`, `api/`, `FERRAMENTAS_CHECKLIST.md`, `README.md`
- [x] Pasta de materiais extras identificada e mantida em `arquivos_para_usar_arquivados/`
- [x] Verificada a presenÃ§a de arquivos temporÃ¡rios ou duplicados no root; os Ãºnicos duplicados encontrados foram arquivados
- [x] `private/google-credentials.json` estÃ¡ separado do repositÃ³rio principal como arquivo sensÃ­vel
- [x] Criado inventÃ¡rio atual de ferramentas em `FERRAMENTAS_INVENTARIO.md`

## 2. Manter no core do site
- [x] `index.php` do portal principal
- [x] `layout_ferramenta.php` para renderizaÃ§Ã£o de ferramentas e idioma
- [x] `config.php` + `config.example.php` para configuraÃ§Ã£o segura
- [x] `premium.php` para fluxo premium e isenÃ§Ã£o de anÃºncios
- [x] `admin/` e `api/` mantidos como infraestrutura comercial
- [x] `sql/` mantido para scripts de banco de dados e deploy
- [x] `vendor/` e `composer.json` mantidos enquanto houver dependÃªncias Composer
- [x] DiretÃ³rios de ferramentas em uso: `gerador`, `imagem`, `pdf`, `texto`, `diversas`, `desenvolvedor`, `video`, `jogos`, `whatsApp`, `excel`, `word`, `powerpoint`

## 3. Arquivar / isolar arquivos duplicados
- [x] Arquivada a pÃ¡gina root duplicada `whatsapp.php` em `arquivos_para_usar_arquivados/whatsapp.php`
- [x] Arquivada a pÃ¡gina root duplicada `recibo.php` em `arquivos_para_usar_arquivados/recibo.php`
- [ ] Identificar as pÃ¡ginas de ferramenta standalone que devem ser convertidas para `$tool_id` ou mantidas apenas como recurso de adaptaÃ§Ã£o
- [ ] Verificar se hÃ¡ outros arquivos legacy no root que devem ser movidos para `arquivos_para_usar_arquivados/`

## 4. RevisÃ£o de limpeza necessÃ¡ria
- [x] Nenhum arquivo de backup/duplicado encontrado no root alÃ©m dos arquivados
- [x] Nenhum log ou `.txt` de debug encontrado fora de `arquivos_para_usar_arquivados`
- [ ] Verificar imagens de marketing nÃ£o usadas (`banner.png`, `publicidade.png`, `logo.png`)
- [ ] Avaliar se `excel/`, `powerpoint/` e `word/` devem ser mantidos como repositÃ³rios de arquivos ou fundidos em ferramentas Ãºnicas
- [ ] Consolidar duplicatas entre `dev/` (arquivado) e `desenvolvedor/`

## 5. O que falta adaptar para monetizaÃ§Ã£o
- [ ] Testar cada ferramenta principal no navegador e corrigir UI/UX e textos nos idiomas PT/EN
- [ ] Priorizar ferramentas de maior valor comercial: `pdf`, `imagem`, `gerador`, `texto`, `whatsApp`, `api`
- [ ] Criar/ou ajustar planos de cobranÃ§a: `free`, `basic`, `pro`, `enterprise`
- [ ] Melhorar a documentaÃ§Ã£o de API e criar uma landing page de vendas para assinaturas premium
- [ ] Definir o fluxo premium: checkout, ativaÃ§Ã£o, desativaÃ§Ã£o, cancelamento e renovaÃ§Ã£o

## 6. AÃ§Ãµes concluÃ­das atÃ© agora
- [x] Analisei a estrutura geral do site
- [x] Criei inventÃ¡rio atual de ferramentas em `FERRAMENTAS_INVENTARIO.md`
- [x] Identifiquei e mantive os diretÃ³rios principais ativos
- [x] Mantive `api/` e `premium.php` como base para monetizaÃ§Ã£o
- [x] Arquivei arquivos duplicados e antigos do root
- [x] Capturei o inventÃ¡rio atual de ferramentas ativas e nÃ£o integradas
- [x] Identifiquei as pÃ¡ginas PHP nÃ£o integradas ao motor de ferramentas

## 7. PrÃ³xima revisÃ£o
- [ ] Converter as pÃ¡ginas nÃ£o integradas mais valiosas em ferramentas padrÃ£o `layout_ferramenta.php`
- [ ] Dar rÃ©dea curta Ã s pÃ¡ginas legacy de `texto/` e `diversas/` para produzir ferramentas ativas
- [ ] Validar API com banco de dados e rotas de autenticaÃ§Ã£o em `api/v1/index.php`
- [ ] Criar um painel simples de gestÃ£o de chaves e planos em `admin/`
- [ ] Consolidar o inventÃ¡rio de ferramentas e contabilizar o total real de pÃ¡ginas ativas

## 8. RevisÃ£o realizada em 2026-05-01
- [x] Identificada a lista completa de diretÃ³rios ativos de ferramentas
- [x] Contadas 140+ pÃ¡ginas PHP nos diretÃ³rios de ferramentas e infraestrutura
- [x] Criado inventÃ¡rio automÃ¡tico em `tools_inventory_auto.md`
- [x] Confirmado que nÃ£o hÃ¡ arquivos `.php` de ferramenta no root alÃ©m dos arquivos de configuraÃ§Ã£o e layout
- [ ] Precisamos revisar manualmente os arquivos sem `\$tool_id` para determinar compatibilidade com o motor de layout
- [ ] Precisamos arquivar ou refatorar ferramentas que ainda nÃ£o usam completamente `layout_ferramenta.php`

### Arquivos detectados para revisÃ£o de adaptaÃ§Ã£o
- `diversas/calculadora-areas.php`
- `diversas/calcular-datas.php`
- `diversas/mdc-mmc.php`
- `diversas/regra-de-3.php`
- `gerador/gerador-cnh.php`
- `gerador/gerador-pis.php`
- `gerador/gerador-rg.php`
- `gerador/validador-pis.php`
- `gerador/validador-rg.php`
- `texto/cortar-texto.php`
- `texto/inverter-texto.php`
- `texto/maiusculas-minusculas.php`
- `texto/numero-por-extenso.php`
- `texto/ordenar-alfabeticamente.php`
- `texto/remover-acentos.php`

---

> Use este arquivo como ponto de parada. Marque as caixas e continue daqui na prÃ³xima vez.

---

## Fonte: ferramentas/FERRAMENTAS_CHECKLIST.md

# ðŸ“‹ MESTRE DE FERRAMENTAS - CHECKPOINT

**Ãšltima atualizaÃ§Ã£o:** 2026-04-30 15:45 (Novas ferramentas implementadas: RENAVAM, TÃ­tulo Eleitor, InscriÃ§Ã£o Estadual, Placa VeÃ­culos, VeÃ­culos, Dividir String, Info Caractere, Textoâ†’HTML, Fatorar, Romanos)

**Objetivo:** Lista completa de ferramentas dos sites de referÃªncia para implementaÃ§Ã£o e monetizaÃ§Ã£o via API.

---

## ðŸ–¼ï¸ ILOVEIMG (13 ferramentas)

| # | Ferramenta | FunÃ§Ã£o | Status | Arquivo |
|---|------------|--------|--------|---------|
| 1 | Comprimir Imagem | Reduzir tamanho KB/MB mantendo qualidade | âœ… IMPLEMENTADA | `/imagem/compressor.php` |
| 2 | Redimensionar Imagem | Mudar dimensÃµes por % ou pixels | âœ… IMPLEMENTADA | `/imagem/redimensionador.php` |
| 3 | Recortar Imagem | Cortar Ã¡rea especÃ­fica em pixels | âœ… IMPLEMENTADA | `/imagem/recortar.php` |
| 4 | Converter para JPG | PNG, GIF, TIF, PSD, SVG, WEBP, HEIC â†’ JPG | âš ï¸ PARCIAL | `/imagem/conversor.php` |
| 5 | Converter de JPG | JPG â†’ PNG ou GIF | âš ï¸ PARCIAL | - |
| 6 | Editor de Fotos | Texto, efeitos, molduras, stickers | âŒ A FAZER | - |
| 7 | Melhorar Imagem | Upscale com IA, aumentar resoluÃ§Ã£o | âŒ A FAZER | - |
| 8 | Remover Fundo | Remove background automaticamente | âŒ A FAZER | - |
| 9 | Marcar Imagem | Watermark com texto ou imagem | âœ… IMPLEMENTADA | `/imagem/marcar-agua.php` |
| 10 | Gerador de Memes | Criar memes com templates | âŒ A FAZER | - |
| 11 | Girar Imagem | Rotacionar 90Â°, 180Â°, etc | âœ… IMPLEMENTADA | `/imagem/girar.php` |
| 12 | HTML para Imagem | Converter webpage â†’ JPG/SVG | âŒ A FAZER | - |
| 13 | Desfocar Cara | Blur em rostos/objetos | âŒ A FAZER | - |

**Implementadas:** `/imagem/heic-to-jpg.php`, `/imagem/webp-converter.php`, `/imagem/jpg-para-png.php`, `/imagem/png-para-jpg.php`, `/imagem/gif-para-png.php`, `/imagem/efeitos-imagem.php`, `/imagem/extrator-cores.php`, `/imagem/imagem-para-pdf.php`, `/imagem/acervo.php`, `/imagem/base64.php`

---

## ðŸ“„ ILOVEPDF (29 ferramentas)

| # | Ferramenta | FunÃ§Ã£o | Status | Arquivo |
|---|------------|--------|--------|---------|
| 1 | Juntar PDF | Merge mÃºltiplos PDFs | âœ… IMPLEMENTADA | `/pdf/juntar-pdf.php` |
| 2 | Dividir PDF | Separar pÃ¡ginas ou extrair intervalo | âœ… IMPLEMENTADA | `/pdf/dividir-pdf.php` |
| 3 | Comprimir PDF | Reduzir tamanho mantendo qualidade | âœ… IMPLEMENTADA | `/pdf/comprimir-pdf.php` |
| 4 | PDF para Word | PDF â†’ DOCX editÃ¡vel | âœ… IMPLEMENTADA | `/pdf/pdf-para-word.php` |
| 5 | PDF para PowerPoint | PDF â†’ PPTX | âŒ A FAZER | - |
| 6 | PDF para Excel | PDF â†’ XLSX | âŒ A FAZER | - |
| 7 | Word para PDF | DOC/DOCX â†’ PDF | âŒ A FAZER | - |
| 8 | PowerPoint para PDF | PPT/PPTX â†’ PDF | âŒ A FAZER | - |
| 9 | Excel para PDF | XLS/XLSX â†’ PDF | âŒ A FAZER | - |
| 10 | Editar PDF | Adicionar texto, imagens, formas | âš ï¸ BÃSICA | `/pdf/editar-pdf.php` |
| 11 | PDF para JPG | Extrair imagens ou pÃ¡ginas â†’ JPG | âœ… IMPLEMENTADA | `/pdf/pdf-para-jpg.php` |
| 12 | JPG para PDF | Imagens â†’ PDF | âŒ A FAZER | - |
| 13 | Assinar PDF | Assinatura eletrÃ´nica | âŒ A FAZER | - |
| 14 | Marca d'Ã¡gua | Adicionar watermark no PDF | âŒ A FAZER | - |
| 15 | Rodar PDF | Girar pÃ¡ginas do PDF | âŒ A FAZER | - |
| 16 | HTML para PDF | Webpage â†’ PDF | âŒ A FAZER | - |
| 17 | Desbloquear PDF | Remover senha/seguranÃ§a | âŒ A FAZER | - |
| 18 | Proteger PDF | Criptografar com senha | âŒ A FAZER | - |
| 19 | Organizar PDF | Reordenar pÃ¡ginas | âŒ A FAZER | - |
| 20 | PDF para PDF/A | Converter para padrÃ£o ISO | âŒ A FAZER | - |
| 21 | Reparar PDF | Recuperar PDF corrompido | âŒ A FAZER | - |
| 22 | NÃºmeros de PÃ¡gina | Adicionar paginaÃ§Ã£o | âŒ A FAZER | - |
| 23 | Digitalizar para PDF | Scanner mobile â†’ PDF | âŒ A FAZER | - |
| 24 | OCR PDF | PDF escaneado â†’ texto selecionÃ¡vel | âŒ A FAZER | - |
| 25 | Comparar PDF | DiferenÃ§as entre documentos | âŒ A FAZER | - |
| 26 | Ocultar PDF | Redact informaÃ§Ãµes sensÃ­veis | âŒ A FAZER | - |
| 27 | Recortar PDF | Crop margins/Ã¡reas | âŒ A FAZER | - |
| 28 | Resumir com IA | Summary via AI | âŒ A FAZER | - |
| 29 | Traduzir PDF | TraduÃ§Ã£o mantendo layout | âŒ A FAZER | - |

**Implementadas:** `/pdf/recibo.php`, `/pdf/compressor.php`, `/pdf/acervo.php`

---

## ðŸ› ï¸ 4DEVS (67 ferramentas)

### GERADORES (24 ferramentas)

| # | Ferramenta | Status | Arquivo |
|---|------------|--------|---------|
| 1 | Gerador de CPF | âœ… IMPLEMENTADA | `/gerador/cpf.php` |
| 2 | Gerador de CNPJ | âœ… IMPLEMENTADA | `/gerador/cnpj.php` |
| 3 | Gerador de CEP | âœ… IMPLEMENTADA | `/gerador/cep.php` |
| 4 | Gerador de RG | âœ… IMPLEMENTADA | `/gerador/gerador-rg.php` (gera e valida) |
| 5 | Gerador de CNH | âœ… IMPLEMENTADA | `/gerador/gerador-cnh.php` (gera e valida) |
| 6 | Gerador de PIS/PASEP | âœ… IMPLEMENTADA | `/gerador/gerador-pis.php` (gera e valida) |
| 7 | Gerador de RENAVAM | âœ… IMPLEMENTADA | `/gerador/gerador-renavam.php` |
| 8 | Gerador de CertidÃµes | âŒ A FAZER | - |
| 9 | Gerador de Conta BancÃ¡ria | âŒ A FAZER | - |
| 10 | Gerador de InscriÃ§Ã£o Estadual | âœ… IMPLEMENTADA | `/gerador/gerador-inscricao-estadual.php` |
| 11 | Gerador de TÃ­tulo de Eleitor | âœ… IMPLEMENTADA | `/gerador/gerador-titulo-eleitor.php` |
| 12 | Gerador de CartÃ£o de CrÃ©dito | âœ… IMPLEMENTADA | `/gerador/cartao-credito.php` |
| 13 | Gerador de VeÃ­culos | âœ… IMPLEMENTADA | `/gerador/gerador-veiculos.php` |
| 14 | Gerador Placa de VeÃ­culos | âœ… IMPLEMENTADA | `/gerador/gerador-placa-veiculos.php` |
| 15 | Gerador de CurrÃ­culo | âŒ A FAZER | - |
| 16 | Gerador de Letras diferentes | âŒ A FAZER | - |
| 17 | Gerador de Nicks | âŒ A FAZER | - |
| 18 | Gerador de Nomes | âŒ A FAZER | - |
| 19 | Gerador de NÃºmeros AleatÃ³rios | âŒ A FAZER | - |
| 20 | Gerador de Pessoas | âŒ A FAZER | - |
| 21 | Gerador de Empresas | âŒ A FAZER | - |
| 22 | Gerador de Imagem | âŒ A FAZER | - |
| 23 | Gerador de Lorem Ipsum | âœ… IMPLEMENTADA | `/desenvolvedor/lorem.php` |
| 24 | Gerador de Senha | âœ… IMPLEMENTADA | `/gerador/gerador-senha.php` |
| 25 | SÃ­mbolos para Copiar | âŒ A FAZER | - |
| 26 | Sorteador de nÃºmeros | âŒ A FAZER | - |

### VALIDADORES (11 ferramentas)

| # | Ferramenta | Status | Arquivo |
|---|------------|--------|---------|
| 1 | Validador de CPF | âœ… IMPLEMENTADA | `/gerador/cpf.php` (junto) |
| 2 | Validador de CNPJ | âœ… IMPLEMENTADA | `/gerador/validador-cnpj.php` |
| 3 | Validador de RG | âœ… IMPLEMENTADA | `/gerador/validador-rg.php` |
| 4 | Validador de CNH | âœ… IMPLEMENTADA | `/gerador/gerador-cnh.php` (junto) |
| 5 | Validador de PIS/PASEP | âœ… IMPLEMENTADA | `/gerador/validador-pis.php` |
| 6 | Validador de RENAVAM | âŒ A FAZER | - |
| 7 | Validador de CertidÃµes | âŒ A FAZER | - |
| 8 | Validador de Conta BancÃ¡ria | âŒ A FAZER | - |
| 9 | Validador de InscriÃ§Ã£o Estadual | âŒ A FAZER | - |
| 10 | Validador de TÃ­tulo de Eleitor | âŒ A FAZER | - |
| 11 | Validador CartÃ£o CrÃ©dito | âœ… IMPLEMENTADA | `/gerador/cartao-credito.php` (junto) |

### FUNÃ‡Ã•ES STRING (13 ferramentas)

| # | Ferramenta | Status | Arquivo |
|---|------------|--------|---------|
| 1 | Corretor OrtogrÃ¡fico | âŒ A FAZER | - |
| 2 | Colocar em Ordem AlfabÃ©tica | âœ… IMPLEMENTADA | `/texto/ordenar-alfabeticamente.php` |
| 3 | Contador de Caracteres | âœ… IMPLEMENTADA | `/diversas/contador-texto.php` |
| 4 | Contador de OcorrÃªncia de Palavra | âœ… IMPLEMENTADA | `/diversas/contador-texto.php` |
| 5 | Converter Texto to HTML | âœ… IMPLEMENTADA | `/texto/texto-para-html.php` |
| 6 | Cortar Textos | âœ… IMPLEMENTADA | `/texto/cortar-texto.php` |
| 7 | Dividir String | âœ… IMPLEMENTADA | `/texto/dividir-string.php` |
| 8 | InformaÃ§Ãµes de Caracter | âœ… IMPLEMENTADA | `/texto/info-caractere.php` |
| 9 | Inverter Texto | âœ… IMPLEMENTADA | `/texto/inverter-texto.php` |
| 10 | Letras Personalizadas | âŒ A FAZER | - |
| 11 | MaiÃºsculas e MinÃºsculas | âœ… IMPLEMENTADA | `/texto/maiusculas-minusculas.php` |
| 12 | NÃºmero por Extenso | âœ… IMPLEMENTADA | `/texto/numero-por-extenso.php` |
| 13 | Remover Acentos do Texto | âœ… IMPLEMENTADA | `/texto/remover-acentos.php` |
| 14 | Remover ou Trocar \n | âŒ A FAZER | - |

### CALCULADORAS (7 ferramentas)

| # | Ferramenta | Status | Arquivo |
|---|------------|--------|---------|
| 1 | Porcentagem | âœ… IMPLEMENTADA | `/diversas/porcentagem.php` |
| 2 | Regra de 3 Simples | âœ… IMPLEMENTADA | `/diversas/regra-de-3.php` |
| 3 | MDC (MÃ¡ximo Divisor Comum) | âœ… IMPLEMENTADA | `/diversas/mdc-mmc.php` |
| 4 | MMC (MÃ­nimo MÃºltiplo Comum) | âœ… IMPLEMENTADA | `/diversas/mdc-mmc.php` |
| 5 | Fatorar NÃºmero | âœ… IMPLEMENTADA | `/diversas/fatorar-numero.php` |
| 6 | Conversor de NÃºmeros Romanos | âœ… IMPLEMENTADA | `/diversas/conversor-romanos.php` |
| 7 | Calculadora de Juros Compostos | âœ… IMPLEMENTADA | `/diversas/juros-compostos.php` |

### CALCULAR ÃREAS (13 ferramentas)

| # | Ferramenta | Status |
|---|------------|--------|
| 1 | Ãrea do CÃ­rculo | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 2 | Ãrea do Quadrado | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 3 | Ãrea do RetÃ¢ngulo | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 4 | Ãrea do TriÃ¢ngulo | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 5 | Ãrea do PentÃ¡gono | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 6 | Ãrea do HexÃ¡gono | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 7 | Ãrea do PolÃ­gono Regular | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 8 | Ãrea do Losango | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 9 | Ãrea do TrapÃ©zio | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 10 | Ãrea do Paralelogramo | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 11 | Ãrea da Elipse | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 12 | Ãrea da Coroa Circular | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |
| 13 | Ãrea do Setor Circular | âœ… IMPLEMENTADA | `/diversas/calculadora-areas.php` |

### DATAS E HORAS (3 ferramentas)

| # | Ferramenta | Status | Arquivo |
|---|------------|--------|---------|
| 1 | Contador de dias entre datas | âœ… IMPLEMENTADA | `/diversas/contador-dias.php` |
| 2 | Somar Dias em Datas | âœ… IMPLEMENTADA | `/diversas/calcular-datas.php` |
| 3 | Subtrair Dias em Datas | âœ… IMPLEMENTADA | `/diversas/calcular-datas.php` |

### OUTRAS FERRAMENTAS EXISTENTES

| Ferramenta | Arquivo |
|------------|---------|
| Calculadora IMC | `/diversas/imc.php` |
| Calculadora RescisÃ£o | `/diversas/rescisao.php` |
| Calculadora Ponto | `/diversas/calculadora-ponto.php` |
| Extrator de Leads | `/diversas/extrator-leads.php` |
| Gerador de QR Code | `/gerador/qrcode.php` |
| Gerador de Assinatura Email | `/gerador/assinatura-email.php` |
| Gerador de Assinatura | `/gerador/assinatura.php` |
| Gerador de Rotas | `/gerador/gerador-rotas.php` |
| JSON Viewer/Editor | `/desenvolvedor/json.php` |
| JSON â†” Excel | `/desenvolvedor/json-excel.php` |
| Encoder/Decoder | `/desenvolvedor/encoder.php` |
| Conversor de Moedas | `/diversas/conversor.php` |
| Extrator de Cores | `/imagem/extrator-cores.php` |
| ApresentaÃ§Ãµes (Slides) | `/diversas/apresentacoes.php` |
| Planilhas | `/diversas/planilhas.php` |
| Documentos | `/diversas/documentos.php` |

---

## ðŸ“Š RESUMO GERAL

| Categoria | Total | Implementadas | Parciais | A Fazer | % ConcluÃ­do |
|-----------|-------|---------------|----------|---------|-------------|
| iLoveImg | 13 | 5 | 2 | 6 | ~54% |
| iLovePDF | 29 | 5 | 1 | 23 | ~21% |
| 4Devs - Geradores | 26 | 15 | 0 | 11 | ~58% |
| 4Devs - Validadores | 11 | 5 | 0 | 6 | ~45% |
| 4Devs - String | 14 | 11 | 0 | 3 | ~79% |
| 4Devs - Calculadoras | 7 | 6 | 0 | 1 | ~86% |
| 4Devs - Ãreas | 13 | 13 | 0 | 0 | 100% |
| 4Devs - Datas | 3 | 3 | 0 | 0 | 100% |
| **TOTAL** | **116** | **63** | **3** | **50** | **~54%** |

---

## ðŸš€ PRIORIDADES PARA MONETIZAÃ‡ÃƒO

### Alta Prioridade (API Ready)
1. âœ… CPF/CNPJ Generator & Validator - **PRONTO**
2. â³ Compressor de Imagens - **PRONTO**
3. â³ Merge PDF - **PRONTO**
4. â³ Gerador de Senhas - **PRONTO**
5. â³ Gerador de QR Code - **PRONTO**

### MÃ©dia Prioridade (Demanda Popular)
- [ ] Compressor de PDF
- [ ] PDF para Word
- [ ] Remove Background (Imagem)
- [ ] ValidaÃ§Ã£o em lote (CPF, CNPJ)
- [ ] Conversor de Imagens em massa

### Baixa Prioridade (Nicho)
- [ ] Calculadoras de Ã¡rea
- [ ] FunÃ§Ãµes de string especÃ­ficas
- [ ] Geradores especializados (VeÃ­culos, TÃ­tulos)

---

## ðŸ“ NOTAS DE IMPLEMENTAÃ‡ÃƒO

- Todas ferramentas client-side sÃ£o preferÃ­veis (sem custo de servidor)
- APIs externas (IA, OCR) devem ter rate limiting
- Sistema de autenticaÃ§Ã£o necessÃ¡rio para controle de acesso
- DocumentaÃ§Ã£o da API deve ser clara (OpenAPI/Swagger)

---

**Legenda:**
- âœ… = Implementada e funcional
- âš ï¸ = ImplementaÃ§Ã£o parcial/existe similar
- âŒ = A fazer

---

## Fonte: ferramentas/FERRAMENTAS_INVENTARIO.md

# InventÃ¡rio de Ferramentas Ativas

## desenvolvedor (20 ferramentas)

- [analisador-csv.php](desenvolvedor/analisador-csv.php)
- [analisador-tabular.php](desenvolvedor/analisador-tabular.php)
- [base64.php](desenvolvedor/base64.php)
- [calculadora-frete.php](desenvolvedor/calculadora-frete.php)
- [descricao-mercado-livre.php](desenvolvedor/descricao-mercado-livre.php)
- [encoder.php](desenvolvedor/encoder.php)
- [formatador-json.php](desenvolvedor/formatador-json.php)
- [gerador-codigo-barras.php](desenvolvedor/gerador-codigo-barras.php)
- [gerador-descricoes.php](desenvolvedor/gerador-descricoes.php)
- [gerador-hash.php](desenvolvedor/gerador-hash.php)
- [gerador-qr-code.php](desenvolvedor/gerador-qr-code.php)
- [gerador-uuid.php](desenvolvedor/gerador-uuid.php)
- [importador-fretes.php](desenvolvedor/importador-fretes.php)
- [importador-produtos.php](desenvolvedor/importador-produtos.php)
- [json-excel.php](desenvolvedor/json-excel.php)
- [json.php](desenvolvedor/json.php)
- [lorem.php](desenvolvedor/lorem.php)
- [preco-mercado-livre.php](desenvolvedor/preco-mercado-livre.php)
- [timestamp-conversor.php](desenvolvedor/timestamp-conversor.php)
- [validador-ean.php](desenvolvedor/validador-ean.php)

## diversas (14 ferramentas)

- [apresentacoes.php](diversas/apresentacoes.php)
- [calculadora-ponto.php](diversas/calculadora-ponto.php)
- [contador-dias.php](diversas/contador-dias.php)
- [contador-texto.php](diversas/contador-texto.php)
- [conversor-romanos.php](diversas/conversor-romanos.php)
- [conversor.php](diversas/conversor.php)
- [documentos.php](diversas/documentos.php)
- [extrator-leads.php](diversas/extrator-leads.php)
- [fatorar-numero.php](diversas/fatorar-numero.php)
- [imc.php](diversas/imc.php)
- [juros-compostos.php](diversas/juros-compostos.php)
- [planilhas.php](diversas/planilhas.php)
- [porcentagem.php](diversas/porcentagem.php)
- [rescisao.php](diversas/rescisao.php)

## excel (1 ferramentas)

- [index.php](excel/index.php)

## gerador (15 ferramentas)

- [assinatura-email.php](gerador/assinatura-email.php)
- [assinatura.php](gerador/assinatura.php)
- [cartao-credito.php](gerador/cartao-credito.php)
- [cep.php](gerador/cep.php)
- [cnpj.php](gerador/cnpj.php)
- [cpf.php](gerador/cpf.php)
- [gerador-inscricao-estadual.php](gerador/gerador-inscricao-estadual.php)
- [gerador-placa-veiculos.php](gerador/gerador-placa-veiculos.php)
- [gerador-renavam.php](gerador/gerador-renavam.php)
- [gerador-rotas.php](gerador/gerador-rotas.php)
- [gerador-senha.php](gerador/gerador-senha.php)
- [gerador-titulo-eleitor.php](gerador/gerador-titulo-eleitor.php)
- [gerador-veiculos.php](gerador/gerador-veiculos.php)
- [qrcode.php](gerador/qrcode.php)
- [validador-cnpj.php](gerador/validador-cnpj.php)

## imagem (16 ferramentas)

- [acervo.php](imagem/acervo.php)
- [base64.php](imagem/base64.php)
- [compressor.php](imagem/compressor.php)
- [conversor.php](imagem/conversor.php)
- [efeitos-imagem.php](imagem/efeitos-imagem.php)
- [extrator-cores.php](imagem/extrator-cores.php)
- [gif-para-png.php](imagem/gif-para-png.php)
- [girar.php](imagem/girar.php)
- [heic-to-jpg.php](imagem/heic-to-jpg.php)
- [imagem-para-pdf.php](imagem/imagem-para-pdf.php)
- [jpg-para-png.php](imagem/jpg-para-png.php)
- [marcar-agua.php](imagem/marcar-agua.php)
- [png-para-jpg.php](imagem/png-para-jpg.php)
- [recortar.php](imagem/recortar.php)
- [redimensionador.php](imagem/redimensionador.php)
- [webp-converter.php](imagem/webp-converter.php)

## jogos (2 ferramentas)

- [sorteio.php](jogos/sorteio.php)
- [times.php](jogos/times.php)

## pdf (16 ferramentas)

- [acervo.php](pdf/acervo.php)
- [compressor.php](pdf/compressor.php)
- [comprimir-pdf.php](pdf/comprimir-pdf.php)
- [desbloquear-pdf.php](pdf/desbloquear-pdf.php)
- [dividir-pdf.php](pdf/dividir-pdf.php)
- [editar-pdf.php](pdf/editar-pdf.php)
- [jpg-para-pdf.php](pdf/jpg-para-pdf.php)
- [juntar-pdf.php](pdf/juntar-pdf.php)
- [marca-dagua-pdf.php](pdf/marca-dagua-pdf.php)
- [numeros-pagina-pdf.php](pdf/numeros-pagina-pdf.php)
- [pdf-para-jpg.php](pdf/pdf-para-jpg.php)
- [pdf-para-word.php](pdf/pdf-para-word.php)
- [proteger-pdf.php](pdf/proteger-pdf.php)
- [recibo.php](pdf/recibo.php)
- [rodar-pdf.php](pdf/rodar-pdf.php)
- [word-para-pdf.php](pdf/word-para-pdf.php)

## powerpoint (1 ferramentas)

- [index.php](powerpoint/index.php)

## texto (8 ferramentas)

- [contador-palavras.php](texto/contador-palavras.php)
- [corretor-ortografico.php](texto/corretor-ortografico.php)
- [dividir-string.php](texto/dividir-string.php)
- [info-caractere.php](texto/info-caractere.php)
- [slugify.php](texto/slugify.php)
- [texto-para-html.php](texto/texto-para-html.php)
- [tradutor.php](texto/tradutor.php)
- [url-encoder-decoder.php](texto/url-encoder-decoder.php)

## video (7 ferramentas)

- [compressor.php](video/compressor.php)
- [cortar-video.php](video/cortar-video.php)
- [criar-video.php](video/criar-video.php)
- [dividir-video.php](video/dividir-video.php)
- [gerador-legendas.php](video/gerador-legendas.php)
- [juntar-video.php](video/juntar-video.php)
- [vob-para-mp4.php](video/vob-para-mp4.php)

## whatsApp (3 ferramentas)

- [extrator-numeros.php](whatsApp/extrator-numeros.php)
- [formatador.php](whatsApp/formatador.php)
- [index.php](whatsApp/index.php)

## word (1 ferramentas)

- [index.php](word/index.php)

## Arquivos PHP nÃ£o integrados ao motor de ferramentas

- admin/index.php
- api/config.php
- api/docs.php
- api/functions.php
- api/v1/index.php
- config.example.php
- config.local.php
- config.php
- diversas/calculadora-areas.php
- diversas/calcular-datas.php
- diversas/mdc-mmc.php
- diversas/regra-de-3.php
- gerador/gerador-cnh.php
- gerador/gerador-pis.php
- gerador/gerador-rg.php
- gerador/validador-pis.php
- gerador/validador-rg.php
- layout_ferramenta.php
- premium.php
- recibo.php
- texto/cortar-texto.php
- texto/inverter-texto.php
- texto/maiusculas-minusculas.php
- texto/numero-por-extenso.php
- texto/ordenar-alfabeticamente.php
- texto/remover-acentos.php
- whatsapp.php

---

## Fonte: ferramentas/MASTER_CHECKLIST.md

# MASTER CHECKLIST - MINIKE FERRAMENTAS

## Objetivo Final
- Criar 999+ ferramentas funcionais
- Site voltado para Brasil e EUA
- Sistema premium (sem anÃºncios) para clientes pagantes
- API funcional para acesso externo

---

## STATUS ATUAL (2026-05-01 23:00)

### Ferramentas Existentes por Categoria

| Categoria | Qtd | Status |
|-----------|-----|--------|
| desenvolvedor | 20 | âœ… Ativas |
| diversas | 33 | âœ… Ativas (19 novas hoje) |
| excel | 1 | âš ï¸ MÃ­nimo |
| gerador | 15 | âœ… Ativas |
| imagem | 16 | âœ… Ativas |
| jogos | 2 | âš ï¸ MÃ­nimo |
| pdf | 16 | âœ… Ativas |
| powerpoint | 1 | âš ï¸ MÃ­nimo |
| texto | 8 | âœ… Ativas |
| video | 6 | âš ï¸ Poucas |
| whatsApp | 3 | âš ï¸ Poucas |
| word | 1 | âš ï¸ MÃ­nimo |
| **TOTAL ATUAL** | **~122** | âš ï¸ Faltam ~877 |

---

## LIMPEZA (COMPLETO âœ…)

- [x] Identificar estrutura de diretÃ³rios
- [x] Identificar arquivos duplicados em `arquivos_para_usar_arquivados/`
- [x] Manter `vendor/` principal (dependÃªncias ativas)
- [x] Manter `arquivos_para_usar_arquivados/LOJA 195/` como backup
- [x] Remover `archive_php_list.txt` (log temporÃ¡rio)

---

## FERRAMENTAS CRIADAS HOJE (2026-05-01)

### FinanÃ§as/Economia âœ… (10 ferramentas)
- [x] Conversor de Moedas
- [x] Calculadora de SalÃ¡rio LÃ­quido
- [x] Calculadora de Investimentos
- [x] Calculadora de EmprÃ©stimo
- [x] Calculadora de Imposto de Renda
- [x] Calculadora de Desconto
- [x] Calculadora de Gorjeta
- [x] Calculadora de Margem de Lucro
- [x] Conversor de Unidades
- [x] Calculadora de Frete

### SaÃºde/Bem-estar âœ… (6 ferramentas)
- [x] Calculadora de Calorias DiÃ¡rias (TDEE)
- [x] Calculadora de Ãgua DiÃ¡ria
- [x] Calculadora de GestaÃ§Ã£o
- [x] Calculadora de Gordura Corporal
- [x] Calculadora de Metabolismo Basal
- [x] Calculadora de IMC (JÃ EXISTIA)

### EducaÃ§Ã£o âœ… (1 ferramenta)
- [x] Calculadora de MÃ©dia Escolar

### Utilidades DomÃ©sticas âœ… (3 ferramentas)
- [x] Calculadora de Tinta para Parede
- [x] Calculadora de CombustÃ­vel/Viagem
- [x] Calculadora de Idade

---

## PRÃ“XIMAS FERRAMENTAS (PRIORIDADE)

### SaÃºde/Bem-estar (9 ferramentas restantes)
- [ ] Calculadora de PressÃ£o Arterial
- [ ] Calculadora de Glicemia
- [ ] Diary de ExercÃ­cios
- [ ] Calculadora de Sono
- [ ] MeditaÃ§Ã£o Timer
- [ ] Target Heart Rate Calculator
- [ ] Pregnancy Due Date Calculator (INGLÃŠS)
- [ ] Blood Type Compatibility
- [ ] NutriPoints

### EducaÃ§Ã£o (19 ferramentas)
- [ ] Conversor de Notas (BR/US GPA)
- [ ] Gerador de Flashcards
- [ ] Calculadora de Tempo de Leitura
- [ ] Student Loan Calculator
- [ ] SAT/ACT Score Calculator
- [ ] ENEM Score Calculator
- [ ] GPA Calculator
- [ ] Grade Converter
- [ ] Study Timer (Pomodoro)
- [ ] Citation Generator
- [ ] Essay Word Counter
- [ ] Reading Level Analyzer
- [ ] Vocabulary Builder
- [ ] Math Solver
- [ ] Calculadora de FrequÃªncia
- [ ] Planejador de Estudos
- [ ] Calculadora de Provas
- [ ] Simulado Online
- [ ] Calculadora de Bolsa de Estudos

### Utilidades DomÃ©sticas (12 ferramentas)
- [ ] Calculadora de Piso/Azulejo
- [ ] Conversor de Receitas CulinÃ¡rias
- [ ] Calculadora de Consumo de Energia
- [ ] Laundry Calculator
- [ ] Paint Calculator (INGLÃŠS)
- [ ] Flooring Calculator
- [ ] Moving Cost Calculator
- [ ] Utility Bill Estimator
- [ ] Home Renovation Budget
- [ ] Grocery Budget Calculator
- [ ] Planejador de Viagem
- [ ] Calculadora de Ãgua/Esgoto

### Tecnologia/Dev (15 ferramentas)
- [ ] Minificador de CSS
- [ ] Minificador de JavaScript
- [ ] HTML Formatter
- [ ] CSS Generator
- [ ] Regex Tester
- [ ] API Tester
- [ ] JWT Decoder
- [ ] Color Converter
- [ ] Contrast Checker
- [ ] CSS Shadow Generator
- [ ] Border Radius Generator
- [ ] Gradient Generator
- [ ] SVG Optimizer
- [ ] Meta Tag Generator
- [ ] Sitemap Generator

### Marketing/Vendas (15 ferramentas)
- [ ] Calculadora de ROI
- [ ] Calculadora de CAC
- [ ] Calculadora de LTV
- [ ] Gerador de Hashtags
- [ ] Calculadora de ComissÃ£o
- [ ] Break-even Calculator
- [ ] Email Subject Line Tester
- [ ] Social Media Post Generator
- [ ] Ad Copy Generator
- [ ] Landing Page Analyzer
- [ ] SEO Meta Tag Generator
- [ ] Keyword Density Checker
- [ ] Backlink Checker
- [ ] Calculadora de Lucro
- [ ] Price Calculator

### JurÃ­dico/Documentos (10 ferramentas)
- [ ] Gerador de Contratos
- [ ] Gerador de ProcuraÃ§Ã£o
- [ ] Calculadora de PensÃ£o AlimentÃ­cia
- [ ] Small Claims Calculator
- [ ] Traffic Ticket Calculator
- [ ] Bankruptcy Means Test
- [ ] Immigration Calculator
- [ ] Child Support Calculator
- [ ] Legal Fee Calculator
- [ ] Calculadora de Danos Morais

### Entretenimento/Jogos (10 ferramentas)
- [ ] Gerador de Nomes para BebÃªs
- [ ] Compatibilidade de Nomes
- [ ] Decision Maker
- [ ] Random Name Picker
- [ ] Coin Flip Simulator
- [ ] Dice Roller
- [ ] Lottery Number Generator
- [ ] Bingo Card Generator
- [ ] Crossword Generator
- [ ] Sudoku Generator

### Esportes/Fitness (10 ferramentas)
- [ ] Calculadora de Pace
- [ ] Calculadora de Peso Ideal
- [ ] Calculadora de RepetiÃ§Ãµes
- [ ] Calculadora de ProteÃ­nas
- [ ] Treino ABC Generator
- [ ] Running Pace Calculator
- [ ] Weightlifting Calculator
- [ ] Calorie Burn Calculator
- [ ] Macro Calculator
- [ ] Workout Planner

### Viagem/Transporte (5 ferramentas)
- [ ] Conversor de Fuso HorÃ¡rio
- [ ] Calculadora de DistÃ¢ncia
- [ ] Flight Time Calculator
- [ ] Hotel Cost Calculator
- [ ] Road Trip Planner

---

## API - STATUS

- [ ] `POST /api/v1/auth/register`
- [ ] `POST /api/v1/auth/login`
- [ ] `GET /api/v1/user`
- [ ] `PUT /api/v1/user`
- [ ] `POST /api/v1/subscription`
- [ ] `GET /api/v1/tools`
- [ ] `POST /api/v1/tools/:id/execute`
- [ ] `GET /api/v1/usage`

---

## METAS

1. âœ… Limpeza inicial concluÃ­da
2. â³ Criar 50 novas ferramentas (20/50 concluÃ­das)
3. â³ Implementar endpoints da API
4. â³ Adicionar traduÃ§Ã£o EN em todas ferramentas
5. â³ Integrar sistema de pagamento

---

> Ãšltima atualizaÃ§Ã£o: 2026-05-01 23:00
> Total de ferramentas: ~122
> Meta: 999+ ferramentas

---

## Fonte: ferramentas/README.md

# ðŸ“– Guia de Uso - Minike Ferramentas

> InventÃ¡rio atual em `tools_inventory_auto.md`: 140+ arquivos PHP em ferramentas e infraestrutura.

## ðŸ”Œ API

### URL Base
```
https://ferramentas.minike.com.br/api/v1/
```

### AutenticaÃ§Ã£o

Use o header `X-API-Key` ou parÃ¢metro `api_key`:

```bash
curl -H "X-API-Key: SUA_API_KEY" \
  "https://ferramentas.minike.com.br/api/v1/?endpoint=cpf&action=generate"
```

### Endpoints DisponÃ­veis

| Endpoint | MÃ©todo | DescriÃ§Ã£o |
|----------|--------|-----------|
| `?endpoint=register` | POST | Criar conta e API Key |
| `?endpoint=cpf&action=generate` | GET | Gerar CPF vÃ¡lido |
| `?endpoint=cpf&action=validate&cpf=12345678900` | GET | Validar CPF |
| `?endpoint=cnpj&action=generate` | GET | Gerar CNPJ vÃ¡lido |
| `?endpoint=cnpj&action=validate&cnpj=12345678000100` | GET | Validar CNPJ |
| `?endpoint=password&action=generate&length=16` | GET | Gerar senha |
| `?endpoint=qrcode&action=generate` | POST | Gerar QR Code |
| `?endpoint=user&action=usage` | GET | Ver uso diÃ¡rio |
| `?endpoint=user&action=plan` | GET | Ver plano atual |

### Criar Conta (Registro)

```bash
curl -X POST "https://ferramentas.minike.com.br/api/v1/?endpoint=register" \
  -H "Content-Type: application/json" \
  -d '{"email": "seu@email.com", "name": "Seu Nome", "plan": "free"}'
```

**Resposta:**
```json
{
  "message": "API key created successfully",
  "api_key": "mk_abc123...",
  "plan": "free",
  "daily_limit": 100,
  "warning": "Save this API key! It will not be shown again."
}
```

### Planos

| Plano | PreÃ§o | Limite DiÃ¡rio |
|-------|-------|---------------|
| Free | GrÃ¡tis | 100 |
| Basic | R$ 9,99 | 10.000 |
| Pro | R$ 29,99 | 100.000 |
| Enterprise | R$ 99,99 | Ilimitado |

---

## â­ Sistema Premium (Sem AnÃºncios)

### Como Ativar

**1. Via URL (Teste):**
```
https://ferramentas.minike.com.br/gerador/cpf.php?premium=1
```

**2. Via PHP (ProgramÃ¡tico):**
```php
require_once 'premium.php';
activatePremium('email@cliente.com', 'pro');
```

**3. Via Admin:**
Acesse `/admin/` e ative manualmente para cada usuÃ¡rio.

### Verificar Status Premium

```php
require_once 'premium.php';

if (isPremiumUser()) {
    echo "UsuÃ¡rio premium! Sem anÃºncios.";
} else {
    echo "UsuÃ¡rio normal. AnÃºncios serÃ£o exibidos.";
}
```

---

## ðŸ—„ï¸ Banco de Dados

### Executar SQL

1. Acesse seu phpMyAdmin ou terminal MySQL
2. Selecione o banco `u340626637_ferramentas`
3. Execute o conteÃºdo do arquivo `sql/database.sql`

### Tabelas Principais

- `api_users` - UsuÃ¡rios da API
- `api_keys` - Chaves de API
- `api_usage` - Registro de uso
- `premium_subscriptions` - Assinaturas premium
- `categories` - Categorias de ferramentas
- `tools` - Ferramentas

---

## ðŸ”§ Painel Admin

### Acesso

URL: `https://ferramentas.minike.com.br/admin/`

**Credenciais padrÃ£o (ALTERE!):**
- Email: `admin@minike.com.br`
- Senha: `minike2024`

### Funcionalidades

- âœ… Visualizar usuÃ¡rios da API
- âœ… Gerenciar chaves de API
- âœ… Ativar/desativar premium
- âœ… Ver estatÃ­sticas de uso
- âœ… Editar planos de usuÃ¡rios

---

## âš ï¸ ConfiguraÃ§Ã£o de SeguranÃ§a

### VariÃ¡veis de Ambiente (Recomendado)

No seu servidor, defina:

```bash
DB_HOST=localhost
DB_NAME=u340626637_ferramentas
DB_USER=u340626637_ferramentas
DB_PASS=sua_senha_aqui
```

### Arquivos SensÃ­veis

Os seguintes arquivos contÃ©m credenciais e NÃƒO devem ser commitados:

- `config.php`
- `private/google-credentials.json`
- `composer.json`

O arquivo `google-credentials.example.json` pode permanecer como modelo pÃºblico, mas o arquivo real deve ficar em `private/google-credentials.json`.

Use o `.gitignore` criado para proteÃ§Ã£o automÃ¡tica.

---

## ðŸ“ž Suporte

Email: suporte@minike.com.br

---

## Fonte: ferramentas/STATUS-SISTEMA.md

# ðŸ“‹ STATUS DO SISTEMA MINIKE FERRAMENTAS

## âœ… Resolvido

1. **ExtensÃµes PHP habilitadas**
   - âœ… pdo_mysql
   - âœ… mysqli
   - âœ… json
   - âœ… mbstring

2. **Arquivos de configuraÃ§Ã£o criados/corrigidos**
   - âœ… config.php (com tratamento de session seguro)
   - âœ… config.local.php (com credenciais atualizadas)
   - âœ… .env (carregado com variÃ¡veis)

3. **Interface do dashboard**
   - âœ… Funciona perfeitamente via http://localhost:8000/ferramentas/index-demo.php
   - âœ… Design responsivo e moderno
   - âœ… Busca dinÃ¢mica de ferramentas

## âš ï¸ Pendente: ConexÃ£o com Banco de Dados

O sistema estÃ¡ **99% pronto**, mas precisa da informaÃ§Ã£o do **HOST MySQL**:

### Dados Carregados (do .env):
- Database: `u340626637_minike`
- UsuÃ¡rio: `u340626637_Hugen`  
- Senha: Configurada
- Porta: 3306

### âŒ Problema Atual:
Localhost (127.0.0.1) estÃ¡ recusando conexÃ£o. Isso significa:

**O banco de dados NÃƒO estÃ¡ em localhost**

### ðŸ” Como Encontrar o Host Correto:

**Se estiver em hospedagem (cPanel/Plesk):**
1. Acesse o painel de controle
2. VÃ¡ para "Contas MySQL" ou "Banco de Dados"
3. Procure pelo campo "Servidor" ou "Host"
4. Normalmente Ã© algo como:
   - `localhost` (se estiver no mesmo servidor)
   - `127.0.0.1` (local)
   - Um domÃ­nio como `mysql.seudominio.com.br`
   - Um IP como `192.168.x.x`

**Se estiver em Docker:**
- Procure o nome do container MySQL
- Geralmente: `mysql`, `db`, `database`

**Se estiver em servidor remoto:**
- Pergunte ao seu provedor qual Ã© o IP/host do servidor MySQL

## ðŸ“ PrÃ³ximas AÃ§Ãµes:

1. **ForneÃ§a o HOST do banco de dados**
2. Vou configurar o arquivo `.env` com o host correto
3. Sistema estarÃ¡ 100% funcional

## ðŸŽ¯ Teste o Dashboard

Acesse: **http://localhost:8000/ferramentas/index-demo.php**

EstÃ¡ totalmente funcional mesmo sem banco! âœ¨

## ðŸ”§ Arquivos de DiagnÃ³stico DisponÃ­veis

- `diagnostico-sistema.php` - Status completo do sistema
- `teste-host.php` - Teste de conectividade com banco
- `teste-conexao-temp.php` - Teste bÃ¡sico (terminal)

## ðŸ“ž PrÃ³ximo Passo

**FAVOR INFORMAR O HOST DO BANCO DE DADOS**

---

## Fonte: ferramentas/tools_inventory_auto.md

# InventÃ¡rio AutomÃ¡tico de Ferramentas

## admin

- [SUPPORT/INFRA] admin\index.php

## api

- [SUPPORT/INFRA] api\config.php
- [SUPPORT/INFRA] api\docs.php
- [SUPPORT/INFRA] api\functions.php
- [SUPPORT/INFRA] api\v1\index.php

## desenvolvedor

- [ACTIVE] desenvolvedor\analisador-csv.php
- [ACTIVE] desenvolvedor\analisador-tabular.php
- [ACTIVE] desenvolvedor\base64.php
- [ACTIVE] desenvolvedor\calculadora-frete.php
- [ACTIVE] desenvolvedor\descricao-mercado-livre.php
- [ACTIVE] desenvolvedor\encoder.php
- [ACTIVE] desenvolvedor\formatador-json.php
- [ACTIVE] desenvolvedor\gerador-codigo-barras.php
- [ACTIVE] desenvolvedor\gerador-descricoes.php
- [ACTIVE] desenvolvedor\gerador-hash.php
- [ACTIVE] desenvolvedor\gerador-qr-code.php
- [ACTIVE] desenvolvedor\gerador-uuid.php
- [ACTIVE] desenvolvedor\importador-fretes.php
- [ACTIVE] desenvolvedor\importador-produtos.php
- [ACTIVE] desenvolvedor\json-excel.php
- [ACTIVE] desenvolvedor\json.php
- [ACTIVE] desenvolvedor\lorem.php
- [ACTIVE] desenvolvedor\preco-mercado-livre.php
- [ACTIVE] desenvolvedor\timestamp-conversor.php
- [ACTIVE] desenvolvedor\validador-ean.php

## diversas

- [ACTIVE] diversas\apresentacoes.php
- [ACTIVE] diversas\calculadora-agua.php
- [SUPPORT/INFRA] diversas\calculadora-areas.php
- [ACTIVE] diversas\calculadora-calorias.php
- [ACTIVE] diversas\calculadora-combustivel.php
- [ACTIVE] diversas\calculadora-desconto.php
- [ACTIVE] diversas\calculadora-emprestimo.php
- [ACTIVE] diversas\calculadora-frete.php
- [ACTIVE] diversas\calculadora-gestacao.php
- [ACTIVE] diversas\calculadora-gordura-corporal.php
- [ACTIVE] diversas\calculadora-gorjeta.php
- [ACTIVE] diversas\calculadora-idade.php
- [ACTIVE] diversas\calculadora-imc-classificacao.php
- [ACTIVE] diversas\calculadora-imposto-renda.php
- [ACTIVE] diversas\calculadora-investimento.php
- [ACTIVE] diversas\calculadora-margem-lucro.php
- [ACTIVE] diversas\calculadora-media-escolar.php
- [ACTIVE] diversas\calculadora-metabolismo.php
- [ACTIVE] diversas\calculadora-moedas.php
- [ACTIVE] diversas\calculadora-passo.php
- [ACTIVE] diversas\calculadora-ponto.php
- [ACTIVE] diversas\calculadora-prazo-entrega.php
- [ACTIVE] diversas\calculadora-salario-liquido.php
- [ACTIVE] diversas\calculadora-tinta.php
- [SUPPORT/INFRA] diversas\calcular-datas.php
- [ACTIVE] diversas\contador-dias.php
- [ACTIVE] diversas\contador-texto.php
- [ACTIVE] diversas\conversor-romanos.php
- [ACTIVE] diversas\conversor-unidades.php
- [ACTIVE] diversas\conversor.php
- [ACTIVE] diversas\documentos.php
- [ACTIVE] diversas\extrator-leads.php
- [ACTIVE] diversas\fatorar-numero.php
- [ACTIVE] diversas\imc.php
- [ACTIVE] diversas\juros-compostos.php
- [SUPPORT/INFRA] diversas\mdc-mmc.php
- [ACTIVE] diversas\planilhas.php
- [ACTIVE] diversas\porcentagem.php
- [SUPPORT/INFRA] diversas\regra-de-3.php
- [ACTIVE] diversas\rescisao.php

## excel

- [ACTIVE] excel\index.php

## gerador

- [ACTIVE] gerador\assinatura-email.php
- [ACTIVE] gerador\assinatura.php
- [ACTIVE] gerador\cartao-credito.php
- [ACTIVE] gerador\cep.php
- [ACTIVE] gerador\cnpj.php
- [ACTIVE] gerador\cpf.php
- [SUPPORT/INFRA] gerador\gerador-cnh.php
- [ACTIVE] gerador\gerador-inscricao-estadual.php
- [SUPPORT/INFRA] gerador\gerador-pis.php
- [ACTIVE] gerador\gerador-placa-veiculos.php
- [ACTIVE] gerador\gerador-renavam.php
- [SUPPORT/INFRA] gerador\gerador-rg.php
- [ACTIVE] gerador\gerador-rotas.php
- [ACTIVE] gerador\gerador-senha.php
- [ACTIVE] gerador\gerador-titulo-eleitor.php
- [ACTIVE] gerador\gerador-veiculos.php
- [ACTIVE] gerador\qrcode.php
- [ACTIVE] gerador\validador-cnpj.php
- [SUPPORT/INFRA] gerador\validador-pis.php
- [SUPPORT/INFRA] gerador\validador-rg.php

## imagem

- [ACTIVE] imagem\acervo.php
- [ACTIVE] imagem\base64.php
- [ACTIVE] imagem\compressor.php
- [ACTIVE] imagem\conversor.php
- [ACTIVE] imagem\efeitos-imagem.php
- [ACTIVE] imagem\extrator-cores.php
- [ACTIVE] imagem\gif-para-png.php
- [ACTIVE] imagem\girar.php
- [ACTIVE] imagem\heic-to-jpg.php
- [ACTIVE] imagem\imagem-para-pdf.php
- [ACTIVE] imagem\jpg-para-png.php
- [ACTIVE] imagem\marcar-agua.php
- [ACTIVE] imagem\png-para-jpg.php
- [ACTIVE] imagem\recortar.php
- [ACTIVE] imagem\redimensionador.php
- [ACTIVE] imagem\webp-converter.php

## jogos

- [ACTIVE] jogos\sorteio.php
- [ACTIVE] jogos\times.php

## pdf

- [ACTIVE] pdf\acervo.php
- [ACTIVE] pdf\compressor.php
- [ACTIVE] pdf\comprimir-pdf.php
- [ACTIVE] pdf\desbloquear-pdf.php
- [ACTIVE] pdf\dividir-pdf.php
- [ACTIVE] pdf\editar-pdf.php
- [ACTIVE] pdf\jpg-para-pdf.php
- [ACTIVE] pdf\juntar-pdf.php
- [ACTIVE] pdf\marca-dagua-pdf.php
- [ACTIVE] pdf\numeros-pagina-pdf.php
- [ACTIVE] pdf\pdf-para-jpg.php
- [ACTIVE] pdf\pdf-para-word.php
- [ACTIVE] pdf\proteger-pdf.php
- [ACTIVE] pdf\recibo.php
- [ACTIVE] pdf\rodar-pdf.php
- [ACTIVE] pdf\word-para-pdf.php

## powerpoint

- [ACTIVE] powerpoint\index.php

## texto

- [ACTIVE] texto\contador-palavras.php
- [ACTIVE] texto\corretor-ortografico.php
- [SUPPORT/INFRA] texto\cortar-texto.php
- [ACTIVE] texto\dividir-string.php
- [ACTIVE] texto\info-caractere.php
- [SUPPORT/INFRA] texto\inverter-texto.php
- [SUPPORT/INFRA] texto\maiusculas-minusculas.php
- [SUPPORT/INFRA] texto\numero-por-extenso.php
- [SUPPORT/INFRA] texto\ordenar-alfabeticamente.php
- [SUPPORT/INFRA] texto\remover-acentos.php
- [ACTIVE] texto\slugify.php
- [ACTIVE] texto\texto-para-html.php
- [ACTIVE] texto\tradutor.php
- [ACTIVE] texto\url-encoder-decoder.php

## video

- [ACTIVE] video\compressor.php
- [ACTIVE] video\cortar-video.php
- [ACTIVE] video\criar-video.php
- [ACTIVE] video\dividir-video.php
- [ACTIVE] video\gerador-legendas.php
- [ACTIVE] video\juntar-video.php

## whatsApp

- [ACTIVE] whatsApp\extrator-numeros.php
- [ACTIVE] whatsApp\formatador.php
- [ACTIVE] whatsApp\index.php

## word

- [ACTIVE] word\index.php

---

## Fonte: ferramentas/commit-message.txt

[arquivo sem conteÃºdo relevante]`n

---

## Fonte: includes/MARKETING_WIDGETS_README.md

# ðŸ“Š SISTEMA DE MARKETING & FAKE DATA - DOCUMENTAÃ‡ÃƒO

## VisÃ£o Geral

Sistema centralizado de **prova social**, **urgÃªncia** e **escassez** para aumentar conversÃµes e engajamento em todo o ecossistema Minike.

## ðŸš€ Como Usar

### 1. Incluir em qualquer pÃ¡gina

```php
<?php
require_once '../includes/marketing-widgets.php';
// Agora vocÃª tem acesso Ã  classe MarketingWidgets
?>
```

### 2. Widgets DisponÃ­veis

#### Contadores de Engajamento
```php
// UsuÃ¡rios online em tempo real
<?php echo MarketingWidgets::renderOnlineCounter($lang = 'pt'); ?>

// Total de vendas este mÃªs
<?php echo MarketingWidgets::renderSalesCounter($lang = 'pt'); ?>

// SeÃ§Ã£o completa com 4 mÃ©tricas
<?php echo MarketingWidgets::renderStatsCards($lang = 'pt'); ?>
```

#### Prova Social (Social Proof)
```php
// NotificaÃ§Ã£o flutuante "AlguÃ©m comprou agora"
<?php echo MarketingWidgets::renderBuyingNow($lang = 'pt', $position = 'bottom-right'); ?>

// SeÃ§Ã£o "VocÃª estÃ¡ em boa companhia" com pessoas vendo agora
<?php echo MarketingWidgets::renderSocialProof($lang = 'pt'); ?>
```

#### AvaliaÃ§Ãµes & Reviews
```php
// Card individual de review
$review = [
    'name' => 'Maria Silva',
    'rating' => 5,
    'text' => 'Produto excelente!',
    'date' => '2 dias atrÃ¡s',
    'verified' => true
];
<?php echo MarketingWidgets::renderReviewCard($review, $compact = true); ?>

// SeÃ§Ã£o completa com 4 avaliaÃ§Ãµes
<?php echo MarketingWidgets::renderReviewSection($product_type = 'curso', $lang = 'pt'); ?>
```

#### UrgÃªncia & Escassez
```php
// Badge piscante de estoque baixo
<?php echo MarketingWidgets::renderUrgencyBadge($product_id = 1, $lang = 'pt'); ?>

// Barra de progresso mostrando % vendido
<?php echo MarketingWidgets::renderScarcityBar($total_stock = 50, $product_id = 1, $lang = 'pt'); ?>

// Timer de oferta relÃ¢mpago (Flash Sale)
<?php echo MarketingWidgets::renderFlashSaleTimer($lang = 'pt'); ?>
```

#### CTA (Call to Action) com UrgÃªncia
```php
// BotÃ£o grande com preÃ§o, desconto, estoque e pessoas vendo
<?php echo MarketingWidgets::renderUrgentCTA(
    $product_id = 1,
    $price = 'R$ 99,90',
    $original_price = 'R$ 199,90',
    $lang = 'pt'
); ?>
```

## ðŸ”§ Classe FakeDataGenerator

Gera todos os dados simulados de forma **dinÃ¢mica e realista**:

```php
<?php
require_once '../includes/fake_data.php';

// Contadores em tempo real
$online = FakeDataGenerator::getOnlineUsers();       // 100-500
$sales = FakeDataGenerator::getTotalSales();         // Cresce ao longo do dia
$recent = FakeDataGenerator::getRecentPurchases();  // 1-8 compras

// Estoque
$stock = FakeDataGenerator::getStockRemaining($product_id);
$urgency_msg = FakeDataGenerator::getUrgencyMessage($stock, 'pt');

// AvaliaÃ§Ãµes
$reviews = FakeDataGenerator::getFakeReviews('curso', 'pt', 5);
$rating = FakeDataGenerator::getAverageRating(); // 4.5-5.0
$review_count = FakeDataGenerator::getReviewCount(); // 500-2500

// Timer de oferta
$offer = FakeDataGenerator::getOfferTimeRemaining('pt');
// Ofertas rodam das 12:00 Ã s 14:00 todos os dias

// Social Proof
$buying_now = FakeDataGenerator::getBuyingNowNotifications('pt', 4);
// Retorna array com pessoas que "compraram agora"

// JSON para JS/AJAX
$json = FakeDataGenerator::getRealtimeJSON();
?>
```

## ðŸ“ IntegraÃ§Ã£o Atual

### âœ… JÃ¡ Implementado:
- `cursos/index.php` - Widgets de contadores + prova social + avaliaÃ§Ãµes
- `games/index.php` - Import de marketing-widgets (pronto para usar)
- `ferramentas/index.php` - Import de marketing-widgets (pronto para usar)
- `delivery/index.php` - Import de marketing-widgets (pronto para usar)

### ðŸ“ Como Adicionar em Outras PÃ¡ginas:

1. No `<head>`:
```php
<?php
require_once '../includes/marketing-widgets.php';
?>
```

2. No `<body>` onde quiser os widgets:
```php
<!-- Contadores no topo -->
<?php echo MarketingWidgets::renderStatsCards($idioma_atual); ?>

<!-- Prova social -->
<?php echo MarketingWidgets::renderSocialProof($idioma_atual); ?>

<!-- NotificaÃ§Ã£o flutuante -->
<?php echo MarketingWidgets::renderBuyingNow($idioma_atual, 'bottom-right'); ?>
```

## ðŸŽ¨ Componentes CSS/Tailwind

Todos os widgets usam classes Tailwind com variÃ¡veis CSS customizadas:
- `var(--bg-primary)` - Cor de fundo principal
- `var(--text-primary)` - Cor de texto principal
- `var(--accent-primary)` - Cor de destaque
- Etc.

CompatÃ­vel com tema dark/light automÃ¡tico!

## ðŸ’¡ Exemplos PrÃ¡ticos

### PÃ¡gina de Curso Individual
```php
<div class="max-w-4xl mx-auto space-y-8">
    <!-- Oferta urgente -->
    <?php echo MarketingWidgets::renderFlashSaleTimer('pt'); ?>
    
    <!-- Estoque baixo -->
    <?php echo MarketingWidgets::renderScarcityBar(50, 1, 'pt'); ?>
    
    <!-- CTA com urgÃªncia -->
    <?php echo MarketingWidgets::renderUrgentCTA(1, 'R$ 49,90', 'R$ 99,90', 'pt'); ?>
    
    <!-- AvaliaÃ§Ãµes -->
    <?php echo MarketingWidgets::renderReviewSection('curso', 'pt'); ?>
    
    <!-- Prova social -->
    <?php echo MarketingWidgets::renderSocialProof('pt'); ?>
</div>

<!-- NotificaÃ§Ã£o flutuante -->
<?php echo MarketingWidgets::renderBuyingNow('pt'); ?>
```

## ðŸ”„ DinÃ¢mica dos Contadores

- **Online**: Muda a cada minuto (realista)
- **Vendas**: Cresce ao longo do dia
- **Estoque**: Diminui conforme o dia passa
- **Reviews**: Total aleatÃ³rio mas consistente por dia
- **Flash Sale**: Rodam 12:00-14:00 diariamente
- **AvaliaÃ§Ãµes**: Mistura de reviews reais com timestamps aleatÃ³rios

## ðŸš¨ Importante

Esses dados sÃ£o **simulados apenas para UX**. Para um sistema real, integrar com:
- Banco de dados para armazenar compras reais
- Sistema de pagamento real
- NotificaÃ§Ãµes de webhook para compras genuÃ­nas
- AvaliaÃ§Ãµes verificadas do Google/Facebook

## ðŸ“ž Suporte

Para adicionar novos widgets ou customizar, edite:
- `/includes/marketing-widgets.php` - Componentes HTML
- `/includes/fake_data.php` - GeraÃ§Ã£o de dados

Ambos estÃ£o bem documentados com comentÃ¡rios.

---

## Fonte: games/README.md

# Como adicionar novos jogos ao Minike Games

Este arquivo explica o fluxo correto para criar e publicar jogos no ecossistema Minike.

## 1. Estrutura de jogos

Os jogos devem existir em um diretÃ³rio sob `games/completo/` ou em jogos gerados dentro de `games/minike/games/`.

Cada jogo deve ter pelo menos:
- `index.php` ou `index.html` na pasta do jogo
- `caminho` relativo no catÃ¡logo
- Metadados de nome, descriÃ§Ã£o, categoria, preÃ§o e idioma

## 2. PublicaÃ§Ã£o no catÃ¡logo principal

O catÃ¡logo principal em `games/index.php` carrega jogos do banco de dados `mk_games_jogos`.

### OpÃ§Ã£o 1: adicionar via banco de dados
1. Abra o banco de dados padrÃ£o do Minike.
2. Insira um registro em `mk_games_jogos` com:
   - `categoria_id`
   - `nome`
   - `slug`
   - `descricao`
   - `thumbnail`
   - `caminho`
   - `destaque`
   - `preco`
   - `publicado`

### OpÃ§Ã£o 2: usar fallback estÃ¡tico
Edite `games/index.php` e adicione uma entrada em `$jogos_estaticos`.

Exemplo:
```php
$jogos_estaticos[] = [
    'id' => 21,
    'nome' => 'Jogo Novo',
    'cat_nome' => 'Puzzle',
    'caminho' => 'completo/jogo-novo/',
    'thumb' => 'ðŸ§©',
    'destaque' => 1,
    'preco' => 0,
    'publicado' => 1,
];
```

## 3. PadrÃ£o de `jogo.php`

O arquivo `games/jogo.php` busca jogos usando `mkMeta999GameCatalog()` e exibe os metadados.

Para adicionar novos jogos nesse catÃ¡logo, crie ou atualize as funÃ§Ãµes `mkMeta999GameSeeds()` e `mkMeta999GameCatalog()` em `games/seed_meta999.php` ou em um include de catÃ¡logo existente.

## 4. Usar o gerador de jogos

Existe um gerador em `games/minike/generator.php` que cria jogos fÃ­sicos e um catÃ¡logo local em `games/minike/catalog.php`.

Para gerar jogos automÃ¡ticamente:
```bash
cd games/minike
php generator.php
```

## 5. Fluxo recomendado

1. Desenvolva o jogo no diretÃ³rio `games/completo/<slug>/`
2. Adicione `index.php` ou `index.html` com seu conteÃºdo e o script de jogo.
3. Insira a referÃªncia no catÃ¡logo do site (`mk_games_jogos` ou `games/index.php`).
4. Teste o jogo abrindo `games/jogo.php?game=<slug>` ou `games/index.php`.
5. Verifique se o jogo funciona no mobile e no desktop.

## 6. Pontos de atenÃ§Ã£o

- Use apenas `preco = 0` para jogos gratuitos.
- Marque `publicado = 1` para aparecer no catÃ¡logo.
- Garanta que todas as rotas usem caminhos relativos corretos.
- Se o jogo for gerado pelo `generator.php`, verifique o serviÃ§o worker e o `shared/register-sw.js`.

---

## Fonte: games/minike/README.md

# Minike Games Hub

Este diretÃ³rio contÃ©m o hub de jogos Minike, com um portal central, catÃ¡logo e jogos gerados automaticamente.

## Estrutura principal
- `index.php` â€” portal principal do hub, com acesso rÃ¡pido aos protÃ³tipos e ao catÃ¡logo.
- `catalog.php` â€” catÃ¡logo completo de 100 jogos gerados.
- `generator.php` â€” script que gera 100 jogos fÃ­sicos em `games/game-###/`.
- `shared/` â€” assets compartilhados de estilo e motor de jogo.
- `sw.js` â€” service worker para cache offline do hub.

## Como gerar os jogos
Execute:

```bash
cd games/minike
php generator.php
```

Isso cria o diretÃ³rio `games/game-XXX/` com arquivos `index.php` para cada jogo e atualiza `catalog.php`.

## Como adicionar novos jogos
1. Crie uma nova pasta em `games/game-XXX/`.
2. Adicione `index.php` com a pÃ¡gina do jogo.
3. Use `shared/style.css` e `shared/engine.js` para manter o visual e o funcionamento consistentes.
4. No `catalog.php`, adicione ou atualize o conjunto de jogos com seu novo link.

## Modos suportados
- `bubble` â€” bolhas clicÃ¡veis.
- `tap-speed` â€” acertar alvos rÃ¡pidos.
- `run-sim` â€” corrida simples com obstÃ¡culos.
- `quiz` / `mini-quiz` â€” perguntas e respostas renderizadas no servidor.

## Jogos completos adicionais
Os jogos `game-001` a `game-023` sÃ£o experiÃªncias completas com interface prÃ³pria. A partir de `game-024`, o gerador usa mini-jogos rÃ¡pidos e placeholders.

## ValidaÃ§Ã£o
- O arquivo `validate_site.php` na raiz verifica todos os arquivos PHP do projeto.
- Use-o sempre apÃ³s criar ou atualizar novos jogos:

```bash
php d:\minike\validate_site.php
```

## ObservaÃ§Ãµes
- A pÃ¡gina `games/minike/index.php` integra o link para o catÃ¡logo e a documentaÃ§Ã£o do hub.
- O registro do service worker Ã© feito em `shared/register-sw.js`.
- O cache do service worker inclui o portal e o catÃ¡logo.

---

## Fonte: sites/admin/notas.txt

[arquivo sem conteÃºdo relevante]`n

---

## Fonte: softwares/apyfy/README.md

# ðŸ¤– Extrator de Leads B2B â€” v2.0

VersÃ£o completa com **10+ fontes de dados integradas**, **scroll humanizado** para nÃ£o tomar bloqueio do Google, e **enriquecimento automÃ¡tico por CNPJ**.

---

## ðŸš€ InstalaÃ§Ã£o (1Âª vez)

Abra o terminal (PowerShell ou CMD) na pasta do projeto e rode:

```bash
npm install
npx playwright install chromium
```

A segunda linha baixa o navegador que o robÃ´ vai controlar.

---

## â–¶ï¸ Como rodar

```bash
node main.js
```

Vai abrir um menu interativo perguntando:
1. **Nicho** (lojas de roupas, farmÃ¡cias, etc â€” ou digite uma palavra-chave)
2. **Estado** (todos os 27 + Brasil inteiro)
3. **Cidade** e **bairro**
4. **Quantidade** de estabelecimentos (10 a 500)
5. **Quais enriquecimentos ativar**
6. **Velocidade** (lenta = mais segura contra bloqueio)

---

## ðŸ—‚ï¸ Fontes de dados integradas

| # | Fonte | O que traz |
|---|-------|------------|
| 1 | **Google Maps** (Playwright) | Nome, endereÃ§o, telefone, site, avaliaÃ§Ãµes |
| 2 | **Site oficial da empresa** | Email, CNPJ, Instagram, Facebook, WhatsApp |
| 3 | **BrasilAPI** | RazÃ£o social, CNPJ, CNAE, MEI, Simples |
| 4 | **ReceitaWS** | Idem (fallback se BrasilAPI falhar) |
| 5 | **CNPJ.ws** | Idem (fallback 2) |
| 6 | **ViaCEP** | Normaliza endereÃ§o, bairro, cidade |
| 7 | **Nominatim/OpenStreetMap** | Geocoding alternativo |
| 8 | **Bing Search** | Busca dados que faltam pelo nome da loja |
| 9 | **Google Search** | Idem (rotaciona com Bing) |
| 10 | **Casa dos Dados** | Filtro por **CNAE** e **MEI** |
| 11 | **Apontador / PÃ¡ginas Amarelas** | Fallback adicional |

> Quando o Maps acha o **nome da loja mas nÃ£o tem telefone/email/CNPJ**, o sistema busca esses dados pelo nome no Bing/Google e no site oficial automaticamente.

---

## ðŸ¢ Scroll humanizado

O robÃ´ **nÃ£o usa mais `page.mouse.wheel(0, 3000)` em loop**, que era o que estava te dando problema. Em vez disso ele:

- Rola **dentro do painel da lista** (que Ã© onde o Maps de fato carrega mais resultados)
- Rolagens pequenas (250â€“600px) com **pausas variÃ¡veis** (0,9 a 2,2 segundos)
- **Pausas longas** ocasionais (2,5 a 5,5 segundos) a cada 4â€“7 rolagens
- **Movimenta o mouse** em posiÃ§Ãµes aleatÃ³rias entre rolagens
- **Para sozinho** quando detecta que a lista parou de crescer (com paciÃªncia configurÃ¡vel)
- Usa **User-Agent rotativo** e remove sinais de automaÃ§Ã£o (`navigator.webdriver`)

No modo **lento**, ele faz atÃ© 80 rolagens com pausas longas â€” Ã© isso que mais reduz banimento.

---

## ðŸ“Š O que sai na planilha

A planilha tem **24 colunas**: Nome, RazÃ£o Social, CNPJ, CNAE, Atividade, Porte, MEI?, Simples?, SituaÃ§Ã£o Cadastral, Telefone, WhatsApp, Email, Site, Instagram, Facebook, CEP, EndereÃ§o, NÃºmero, Bairro, Cidade, UF, AvaliaÃ§Ã£o, Qtd Reviews, e **Fontes Usadas** (mostra de onde cada dado veio).

A planilha **abre automaticamente** quando termina (Windows, Mac e Linux).

---

## ðŸŽ¯ Filtro por CNAE

Se vocÃª marcar a opÃ§Ã£o **"Cruzar com Casa dos Dados"** no menu, o robÃ´:

1. Vai filtrar os leads do Maps que tenham CNAE **diferente** do nicho escolhido
2. Vai **complementar** com CNPJs adicionais da Casa dos Dados que tenham aquele CNAE na cidade

Cada nicho do menu jÃ¡ tem um CNAE prÃ©-cadastrado. Se escolher "Outro", vocÃª pode digitar um CNAE manualmente.

---

## âš ï¸ Dicas importantes

- **Comece com 30â€“50 leads** para testar antes de fazer rodadas grandes
- Use a **velocidade Lenta** se for rodar muitas vezes seguidas no mesmo IP
- Se o Google pedir **CAPTCHA**, ele aparece na janela do navegador â€” resolva manualmente que o robÃ´ continua
- Os arquivos CSV sÃ£o salvos com `;` como separador (compatÃ­vel com Excel BR)
- Algumas APIs tÃªm **limite gratuito** (ex: ReceitaWS = 3 por minuto). O robÃ´ jÃ¡ trata isso e usa fallbacks

---

## ðŸ› Se der erro

- **"Cannot find module"** â†’ roda `npm install` de novo
- **"Browser was not installed"** â†’ roda `npx playwright install chromium`
- **Google pede CAPTCHA toda hora** â†’ muda para velocidade Lenta, ou espera 1â€“2h e tenta de novo (o IP "esfria")
- **APIs de CNPJ retornando vazio** â†’ a BrasilAPI nÃ£o tem rate limit grosso, mas a ReceitaWS sim (3/min). Roda com menos paralelismo

---

## Fonte: softwares/editor/SKILL.md

---
name: estudio-195-design
description: Use this skill to generate well-branded interfaces and assets for EstÃºdio 195 (Gerador de Placas), either for production or throwaway prototypes/mocks/etc. Contains essential design guidelines, colors, type, fonts, assets, and UI kit components for prototyping.
user-invocable: true
---

Read the README.md file within this skill, and explore the other available files.

If creating visual artifacts (slides, mocks, throwaway prototypes, etc), copy assets out and create static HTML files for the user to view. If working on production code, you can copy assets and read the rules here to become an expert in designing with this brand.

If the user invokes this skill without any other guidance, ask them what they want to build or design, ask some questions, and act as an expert designer who outputs HTML artifacts _or_ production code, depending on the need.

## Brand essentials (quick reference)
- **Product:** EstÃºdio 195 â€” Gerador de Placas. Brazilian retail-sign / price-tag generator.
- **Language:** Portuguese (pt-BR). Friendly-firm, shopkeeper register. Em-dash separators.
- **Accent gradient:** `linear-gradient(135deg, #ff4757, #ff8c00)` â€” used on every primary surface.
- **Type:** Montserrat (400/600/700/900) for everything in chrome. Bebas Neue, Anton, Oswald, Poppins, Playfair Display, Lato, Roboto are loaded for *user-applied placa text*, not chrome.
- **Iconography:** OS emoji as a first-class icon system. No custom icon font. See README ICONOGRAPHY for the canonical vocabulary.
- **Surface colors:** `#0a0b0f â†’ #323748` 5-step dark scale. White only inside the canvas (the printed sign).
- **Tokens:** `colors_and_type.css`.
- **UI Kit:** `ui_kits/gerador/` â€” clickable recreation of the three wizard tabs.

---

## Fonte: softwares/editor/ui_kits/gerador/README.md

# EstÃºdio 195 â€” UI Kit (Gerador)

Pixel-faithful recreations of the three core surfaces of the Gerador de Placas:

- **Aba 1 â€” Modelo** (`AbaModelo.jsx`): template gallery with grouped cards.
- **Aba 2 â€” Produtos** (`AbaProdutos.jsx`): product picker with sidebar + search grid.
- **Aba 3 â€” Editar** (`AbaEditar.jsx`): the editor â€” slides reel + canvas + properties panel.

Plus shared chrome:
- `AppHeader.jsx` â€” sticky top bar with logo, wizard tabs, status pill, header actions.
- `Buttons.jsx` â€” `Primario`, `Secundario`, `HeaderBtn`, `Toolbar` button family.
- `Bits.jsx` â€” small atoms (StatusPill, Badge, Empty, Toast).

`index.html` wires it all together as a click-thru: tab switching works, selecting a Modelo highlights it, selecting a Produto adds it to the cart, the editor renders a fake placa.

Source: lifted directly from `gerador (1)funcionando/gerador.php` + `styles.css`.

---


---

## 65. Progresso desta execucao (17/05/2026) - fechamento incremental dos sites e subsites
- Diretriz seguida: conteudo funcional, reducao de 404, cross-sell e validacao tecnica antes de novas expansoes.
- Catalogo de ferramentas auditado diretamente em `ferramentas/catalogo.php`.
- Resultado da auditoria de links ativos do catalogo: `missing_total=0` apos correcoes desta execucao.
- Ferramentas criadas para zerar caminhos fisicos faltantes:
  - `ferramentas/imagem/marca_dagua.php` - marca d'agua em imagem, client-side, com preview e download.
  - `ferramentas/desenvolvedor/formatador_html.php` - formatador/minificador HTML, client-side, com copiar/limpar.
- Erros de sintaxe corrigidos encontrados pela validacao global:
  - `ferramentas/conversor/imagem-redimensionar.php` - corrigida closure usada dentro de `match`.
  - `ferramentas/gerador/nick.php` - corrigidos ternarios aninhados incompatÃ­veis com PHP 8+.
- Ferramentas de video reforcadas nesta fase:
  - `ferramentas/video/_ffmpeg_helpers.php` procura `FFMPEG_BIN` no `.env`, `HOME/bin/ffmpeg` e caminhos comuns.
  - `ferramentas/video/vob-para-mp4.php` ganhou upload multiplo, feedback visual, tentativas FFmpeg de compatibilidade e log tecnico aberto em falhas.
  - `ferramentas/video/compressor.php` ganhou upload multiplo e feedback visual.
  - `.user.ini` ajustado para limite realista da Hostinger: `2048M`, com tempo de execucao aumentado.
- Rotas locais testadas com HTTP 200:
  - `/ferramentas/`, `/ferramentas/catalogo.php`, `/ferramentas/imagem/marca_dagua.php`, `/ferramentas/desenvolvedor/formatador_html.php`.
  - `/lojas/`, `/sites/`, `/cursos/`, `/games/`, `/softwares/`, `/escolar/`.

### Proximo alvo direto
1. Validar visualmente em mobile/desktop as novas ferramentas e hubs principais depois do upload para a Hostinger.
2. Evoluir processamento de video para fila assÃ­ncrona se a hospedagem compartilhada limitar CPU/tempo em VOBs grandes.
3. Continuar fechamento dos subsites por blocos: lojas/sites, cursos/escolar, games, softwares, atendimento.

--- 

## 66. Progresso desta execucao (17/05/2026) - fechamento de links institucionais
- `sites/index.php` recebeu destinos reais para os CTAs e removeu os principais `href="#"` visÃ­veis ao usuario final.
- `blog/index.php` foi criado como pagina institucional de conteudo com foco em conversao e SEO.
- `termos.php` foi criado como pagina institucional de termos de uso.
- `lojas/index.php`, `lojas/painel_cliente.php` e `lojas/login.php` receberam destinos reais para mapa, suporte e recuperacao de senha.
- Validacao local de HTTP confirmou `200` para `/sites/`, `/blog/`, `/termos.php`, `/privacidade.php` e `/lojas/`.

---

## 67. Progresso desta execucao (17/05/2026) - auditoria global de rotas e botoes
- Compatibilidade de rotas criada para caminhos historicos que estavam quebrados:
  - `/planos.php`
  - `/software/`, `/software/login.php`, `/software/register.php`, `/software/app.php`
  - `/software/apps/hub.php`, `/software/apps/crm_lite.php`, `/software/apps/agenda_pro.php`, `/software/apps/os_service.php`, `/software/apps/api_manager.php`
  - `/privacy.html`, `/terms.html`, `/data-deletion.html`
- `includes/footer-unificado.php` e `includes/minike-footer.php` deixaram de apontar para `#` em contatos e midias sociais.
- `softwares/apps/api_manager.php` recebeu fallback para nao quebrar quando o banco/PDO nao estiver disponivel.
- Auditoria automatica de caminhos internos terminou com `missing_count=0`.
- ValidaÃ§ao global terminou com `PHP files checked: 1091` e `Errors found: 0`.

---

## 68. Progresso desta execucao (17/05/2026) - vitrine de campanha e captaÃ§Ã£o
- Nova vitrine pÃºblica criada em `campanha.php` para apoiar o ecossistema Minike com planos bilÃ­ngues PT/EN e faixas BRL/USD de referÃªncia.
- Planos estruturados para captaÃ§Ã£o em camadas:
  - Bronze: R$ 1 / 30 dias
  - Semente: R$ 5 / 45 dias
  - Prata: R$ 10 / 90 dias
  - Impulso: R$ 25 / 120 dias
  - Turbo: R$ 50 / 150 dias
  - Ouro: R$ 100 / 180 dias
  - Premium: R$ 250 / 240 dias
  - Fundador: R$ 500 / 300 dias
  - Diamante: R$ 1.000 / 360 dias
  - Arquiteto: R$ 2.000 / 360 dias
  - GuardiÃ£o: R$ 5.000 / 360 dias
  - ImpÃ©rio: R$ 10.000 / 360 dias
  - ExpansÃ£o e Conselho Fundador: R$ 50.000+ / R$ 100.000+ apenas por negociaÃ§Ã£o estratÃ©gica e jurÃ­dica privada
- Nova Ã¡rea de membros da campanha salva em `mk_campanha_membros`, com mural de apoiadores e destaque para aportes estratÃ©gicos.
- NavegaÃ§Ã£o principal recebeu item canÃ´nico `ðŸ’Ž Campanha` no desktop e no mobile.
- `apoio.php`, `rede.php` e `index.php` ganharam links diretos para a campanha para melhorar a conversao interna.
- Criado o guia operacional `guia-captacao-investimento.md` com roteiro de vaquinhas, recompensa digital, canais e cuidados legais.
- Diretriz mantida: apoio publico com recompensas, parceria grande sob contrato, e participacao societaria apenas em proposta privada com revisÃ£o jurÃ­dica.

---

## 69. Progresso desta execucao (17/05/2026) - dossie de investidores e mapa de funcoes
- `campanha.php` recebeu uma nova secao "Funcoes do Imperio" listando os principais produtos e subsites:
  - ferramentas, lojas, atendimento AI Meta, softwares, delivery, ERP, cursos, escolar, games, sites, ads/afiliados e MKC/rede.
- A pagina tambem ganhou a tabela "Promessas por investimento", separando o que pode ser prometido publicamente de R$ 1 ate R$ 100.000+.
- O subdominio `https://atendimento.minike.com.br/` foi lido e integrado ao pitch comercial:
  - WhatsApp Cloud API oficial, Instagram, Messenger, CRM, IA, automacoes, campanhas, templates, WhatsApp Flows, relatorios, Socket.io, white label e revenda.
- Criado `dossie-campanha-investidores-minike.md` com:
  - funcoes de todos os sites/subsites principais
  - funcoes do atendimento aprovado pela Meta
  - plano de recompensas por valor
  - recomendacao de gateways e webhooks
  - ideias pendentes do plano mestre
  - novas ideias comerciais por faixa de investimento
- Recomendacao operacional registrada: usar gateway com webhook para verificacao automatica de pagamento; Pix manual fica apenas como fase inicial.

---

## 70. Progresso desta execucao (17/05/2026) - mapa de inovacao e experiencias interativas
- `campanha.php` recebeu a nova secao "Laboratorio de inovacao", conectando a campanha a produtos futuros inspirados em experiencias modernas de mercado.
- Criado `mapa-inovacao-experiencias-minike.md` com referencias e versoes Minike para:
  - sites interativos, 3D e motion (`Minike Sites 3D`, `Minike Motion`)
  - geracao de apps, dashboards e ferramentas com IA (`Minike App Builder`)
  - criacao de video, voz, anuncios e campanha (`Minike Creative Studio`)
  - aprendizado, escolar e cursos interativos (`Minike Tutor AI`)
  - automacoes, atendimento, CRM e webhooks (`Minike Automations`)
  - comercio, assinaturas, afiliados e comunidade (`Minike Commerce Network`)
- `dossie-campanha-investidores-minike.md` foi ampliado com a matriz de referencias de inovacao e como cada inspiracao vira produto, recompensa ou promessa por faixa de investimento.
- Referencias de mercado incorporadas ao planejamento: Framer, Webflow, Dora, Spline, Rive, LottieFiles, Lovable, Bolt, v0, Replit, Cursor, Runway, ElevenLabs, Canva, Figma, Krea, Khanmigo, Duolingo, Brilliant, Zapier, Make, n8n, Shopify/Nuvemshop, Hotmart/Kiwify, Patreon/Catarse/Benfeitoria, Mercado Pago e Asaas.
- Diretriz comercial reforcada:
  - aportes baixos vendem acesso, mural, voto, badge, conteudo, templates e beneficios digitais
  - aportes medios vendem personalizacao, site, funil, prototipo e acesso antecipado
  - aportes altos vendem white-label, laboratorio, implantacao regional, produto dedicado e propostas privadas
  - equity, revenue share, codigo-fonte ou participacao de empresa nunca devem ser vendidos automaticamente na pagina publica; entram apenas com contrato, advogado e contador
- Proximo passo recomendado:
  1. Integrar gateway com webhook para liberar plano automaticamente.
  2. Criar `area-membros-campanha.php` para apoiadores acompanharem beneficios, votos e entregas.
  3. Transformar o mapa de inovacao em blocos visuais dentro da campanha e em posts para vaquinhas/redes sociais.
  4. Criar uma pagina privada de `data-room` para investidores grandes com documentos, numeros, roadmap e proposta.

---

## 71. Progresso desta execucao (17/05/2026) - escada completa de doacoes CPF/CNPJ ate R$ 10 mil
- `campanha.php` deixou de ter poucos degraus e agora possui uma escada completa de planos publicos:
  - R$ 1 Bronze
  - R$ 5 Semente
  - R$ 10 Prata
  - R$ 25 Impulso
  - R$ 50 Turbo
  - R$ 100 Ouro
  - R$ 250 Premium
  - R$ 500 Fundador
  - R$ 1.000 Diamante
  - R$ 2.000 Arquiteto
  - R$ 5.000 Guardiao
  - R$ 10.000 Imperio
- Os planos foram separados mentalmente por publico:
  - CPF: acesso individual, mural, badges, area de membros, votos, packs digitais, acesso antecipado e beneficios simples.
  - CNPJ: multiplas licencas, diagnostico, anuncio interno, banner, divulgacao, site, funil, atendimento Meta, automacoes, white-label e proposta comercial.
- Foram adicionadas promessas comerciais com cuidado:
  - espaco de anuncio interno sujeito a aprovacao editorial
  - banners e divulgacao por prazo definido
  - licencas por plano para empresas
  - site customizado e funil com manutencao, hospedagem, trafego, API e mensalidades cobradas a parte
- `dossie-campanha-investidores-minike.md` foi atualizado com a tabela completa de investimentos, parcelamentos e beneficios CPF/CNPJ.
- `guia-captacao-investimento.md` foi atualizado com a nova estrutura para usar em vaquinhas, checkout, posts e propostas.
- `mapa-inovacao-experiencias-minike.md` foi ajustado para incluir as faixas intermediarias, licencas CNPJ, anuncios e pilotos de automacao.
- Diretriz mantida:
  - ate R$ 10 mil, vender beneficio, licenca, anuncio, servico, acesso, co-branding e white-label operacional
  - acima disso, tratar como proposta privada com contrato, advogado, contador e escopo formal

---

## 72. Progresso desta execucao (17/05/2026) - apoiadores, ranking e verificacao de pagamento
- Criado `includes/campanha_membros.php` para padronizar a tabela `mk_campanha_membros` e seus campos de gestao.
- `campanha.php` agora salva:
  - CPF/CNPJ
  - documento
  - plano
  - valor
  - mensagem
  - pedido especial do apoiador
  - status do pedido
  - status de pagamento
  - referencia de pagamento `CAMP-AAAAMMDD-XXXXXX`
- Regra do pedido especial:
  - apoiador pode pedir ferramenta, acesso, anuncio, parceria, melhoria, site, automacao ou prioridade
  - atendimento condicionado a nao infringir lei brasileira, viabilidade operacional e alinhamento com a marca Minike
- Ranking publico da campanha passou a mostrar apenas pagamentos confirmados.
- Criado `admin/campanha.php` como painel de gestao dos apoiadores:
  - total registrado
  - confirmados
  - pendentes
  - valor confirmado
  - valor total registrado
  - ranking por valor
  - confirmacao manual de Pix
  - status do pedido
  - resposta administrativa
  - notas internas
  - destaque no mural
- `admin/imperio.php` e `admin/painel_supremo.php` ganharam link direto para a gestao da campanha.
- Criado webhook `webhooks/campanha-pagamento.php` para integracao futura com Asaas/Mercado Pago:
  - recebe JSON
  - valida segredo opcional `CAMPANHA_WEBHOOK_SECRET`
  - usa referencia `CAMP-...` / `externalReference`
  - atualiza `pagamento_status` automaticamente
- Dados comerciais padrao da campanha:
  - Razao social: `65.138.449 Felipe Gabriel Hugen`
  - CNPJ/Pix: `65.138.449/0001-66`
- Recomendacao de pagamento mantida:
  - inicio: Pix CNPJ com conferencia manual no painel
  - proximo passo: Asaas para Pix/boleto/recorrencia/webhook ou Mercado Pago para checkout/cartao/parcelamento

---

## 73. Registro mestre da campanha de apoiadores, investidores e parceiros Minike

### Objetivo central
- Criar uma aba publica de campanha em `minike.com.br/campanha.php` para captar apoiadores, doadores, clientes, patrocinadores e investidores.
- Usar a campanha como vitrine oficial do Imperio Minike em sites de vaquinha, redes sociais, WhatsApp, LinkedIn e propostas privadas.
- Transformar a campanha em uma escada comercial:
  - apoio popular de CPF
  - apoio premium de comunidade
  - patrocinio e licencas para CNPJ
  - implantacao de site, loja, atendimento, funil e automacoes
  - white-label e co-branding para parceiros
  - propostas privadas de investimento para valores estrategicos

### Escada publica de valores ate R$ 10 mil
- `R$ 1 / US$ 1` - Bronze:
  - CPF
  - 30 dias
  - acesso Bronze individual
  - nome no mural
  - badge
  - acesso antecipado
  - voto simples em prioridades
- `R$ 5 / US$ 5` - Semente:
  - CPF
  - 45 dias
  - destaque leve no mural
  - bastidores da campanha
  - voto em uma prioridade
- `R$ 10 / US$ 10` - Prata:
  - CPF
  - 90 dias
  - area de membros
  - pack digital
  - enquetes
  - 1 licenca Prata individual
- `R$ 25 / US$ 25` - Impulso:
  - CPF/CNPJ
  - 120 dias
  - cupom de teste
  - badge especial
  - prioridade em sorteios de revisao
- `R$ 50 / US$ 50` - Turbo:
  - CPF/CNPJ
  - 150 dias
  - pack premium
  - secao Turbo de apoiadores
  - divulgacao leve para CNPJ
- `R$ 100 / US$ 100` - Ouro:
  - CPF/CNPJ
  - 180 dias
  - acesso premium
  - revisao de presenca digital
  - prioridade de suporte
  - ate 2 licencas para CNPJ
- `R$ 250 / US$ 250` - Premium:
  - CNPJ
  - 240 dias
  - 3 licencas
  - mini diagnostico
  - anuncio interno rotativo por ate 15 dias, sujeito a aprovacao editorial
- `R$ 500 / US$ 500` - Fundador:
  - CNPJ
  - 300 dias
  - 5 licencas
  - reuniao curta de diagnostico
  - piloto priorizado
  - anuncio interno por ate 30 dias
- `R$ 1.000 / US$ 1.000` - Diamante:
  - CNPJ
  - 360 dias
  - ate 10 licencas
  - site customizado com identidade Minike
  - acesso personalizado a rede
  - banner por ate 45 dias
  - manutencao, hospedagem, trafego, consumo de API e mensalidades cobradas a parte
- `R$ 2.000 / US$ 2.000` - Arquiteto:
  - CNPJ
  - 360 dias
  - ate 15 licencas
  - landing page ou site com funil planejado
  - setup inicial de captacao via WhatsApp oficial Meta quando aplicavel
  - mapa de automacoes
  - divulgacao interna por ate 60 dias
- `R$ 5.000 / US$ 5.000` - Guardiao:
  - CNPJ
  - 360 dias
  - ate 25 licencas
  - pacote site + funil + atendimento inicial
  - campanha de divulgacao
  - acesso vitalicio promocional a modulos selecionados da fase atual
  - presenca em paginas estrategicas por ate 90 dias
- `R$ 10.000 / US$ 10.000` - Imperio:
  - CNPJ/parceiro
  - 360 dias
  - ate 50 licencas
  - white-label/co-branding sob contrato
  - atendimento Meta
  - integracoes
  - cota master de divulgacao interna por ate 120 dias
  - proposta privada para produto, cidade, nicho ou rede de clientes

### Faixas estrategicas privadas
- `R$ 50.000 / US$ 50.000` - Expansao:
  - implantacao regional
  - acesso vitalicio promocional a modulos selecionados
  - prioridade de produto
  - acordo de receita por projeto, sob contrato
- `R$ 100.000+ / US$ 100.000+` - Conselho Fundador:
  - negociacao privada
  - possivel participacao societaria
  - possivel revenue share
  - possivel codigo-fonte/licenca de modulo
  - produto dedicado
  - obrigatorio advogado, contador, contrato e due diligence

### Regras de promessas publicas
- Pode prometer:
  - acesso
  - mural
  - badge
  - votos
  - packs digitais
  - templates
  - area de membros
  - licencas
  - anuncio interno com prazo definido
  - destaque no ranking
  - site customizado
  - funil
  - atendimento Meta
  - automacoes
  - white-label operacional
  - co-branding sob contrato
- Nao prometer automaticamente na pagina publica:
  - porcentagem da empresa
  - retorno financeiro garantido
  - equity
  - sociedade
  - codigo-fonte irrestrito
  - resultado garantido de anuncio
  - qualquer coisa que infrinja lei brasileira

### Campanha para CPF
- Foco:
  - apoiador individual
  - estudante
  - criador
  - usuario das ferramentas
  - cliente pequeno
  - comunidade
- Beneficios:
  - acesso temporario
  - mural
  - badge
  - voto em prioridades
  - area de membros
  - packs digitais
  - sorteios
  - acesso antecipado

### Campanha para CNPJ
- Foco:
  - empresas
  - lojas
  - escolas
  - agencias
  - patrocinadores
  - parceiros comerciais
  - comunidades
- Beneficios:
  - varias licencas por plano
  - anuncio interno aprovado
  - banners com prazo
  - divulgacao em paginas estrategicas
  - diagnostico
  - site/landing page
  - funil
  - atendimento oficial Meta
  - automacoes
  - white-label
  - proposta comercial

### Pedidos especiais dos apoiadores
- O apoiador pode pedir:
  - ferramenta
  - melhoria
  - acesso
  - anuncio
  - parceria
  - site
  - loja
  - automacao
  - prioridade
  - integracao
  - modulo novo
  - proposta personalizada
- Regra obrigatoria:
  - atender somente se nao infringir lei brasileira
  - atender somente se for viavel tecnicamente/operacionalmente
  - atender somente se nao prejudicar a marca Minike
  - pedidos ilegais, abusivos, ofensivos, fraudulentos ou impossiveis devem ser recusados no painel

### Sistema implementado
- Arquivo publico:
  - `campanha.php`
- Tabela:
  - `mk_campanha_membros`
- Helper:
  - `includes/campanha_membros.php`
- Painel administrativo:
  - `admin/campanha.php`
- Links administrativos:
  - `admin/imperio.php`
  - `admin/painel_supremo.php`
- Webhook:
  - `webhooks/campanha-pagamento.php`
- Documentos:
  - `guia-captacao-investimento.md`
  - `dossie-campanha-investidores-minike.md`
  - `mapa-inovacao-experiencias-minike.md`

### Campos salvos no cadastro
- nome
- empresa/projeto
- email
- CPF/CNPJ
- documento
- plano
- valor apoiado
- moeda
- mensagem
- pedido especial
- status do pedido
- gateway
- status do pagamento
- referencia de pagamento
- destaque
- notas administrativas
- data de confirmacao
- data de criacao

### Ranking e mural
- O mural/ranking publico deve mostrar apenas pagamentos confirmados.
- A ordenacao principal deve priorizar:
  - maior valor apoiado
  - destaque estrategico
  - data de entrada
- O ranking deve servir como prova social para vaquinhas, patrocinadores e investidores.
- Registros pendentes ficam apenas no admin ate confirmacao.

### Painel de gestao da campanha
- `admin/campanha.php` deve ser a aba oficial de gestao de apoiadores.
- Funcoes do painel:
  - listar apoiadores
  - ver valor total registrado
  - ver valor confirmado
  - ver pendentes
  - ver confirmados
  - confirmar Pix manualmente
  - marcar como cancelado
  - registrar referencia de pagamento
  - marcar apoiador como destaque
  - ver e responder pedido especial
  - alterar status do pedido
  - salvar notas internas
  - excluir registros incorretos

### Dados oficiais da empresa para campanha
- Razao social:
  - `65.138.449 Felipe Gabriel Hugen`
- CNPJ:
  - `65.138.449/0001-66`
- CNPJ numerico:
  - `65138449000166`
- Porte:
  - MEI
- Natureza juridica:
  - Empresario Individual
- Simples Nacional:
  - sim
- Situacao:
  - ativa
- Data de abertura:
  - 14/02/2026
- Capital social:
  - R$ 1.000,00
- Cidade/UF:
  - Guaramirim/SC
- CNAE principal:
  - `95.11-8-00` - Reparacao e manutencao de computadores e equipamentos perifericos
- CNAEs secundarios informados:
  - `43.21-5-00` - instalacao e manutencao eletrica
  - `33.21-0-00` - instalacao de maquinas e equipamentos industriais
  - `47.53-9-00` - comercio varejista especializado de eletrodomesticos e equipamentos de audio e video
  - `45.20-0-07` - servicos de instalacao, manutencao e reparacao de acessorios para veiculos automotores
  - `33.14-7-10` - manutencao e reparacao de maquinas e equipamentos
  - `85.99-6-03` - treinamento em informatica
  - `77.33-1-00` - aluguel de maquinas e equipamentos para escritorios
  - `77.22-5-00` - aluguel de fitas de video, DVDs e similares
- Pix padrao da campanha:
  - CNPJ `65.138.449/0001-66`

### Verificacao de pagamentos
- Fase atual:
  - Pix CNPJ
  - conferencia manual pelo admin
  - status inicial `pendente`
  - referencia gerada `CAMP-AAAAMMDD-XXXXXX`
  - admin muda para `confirmado`
- Fase automatizada:
  - conectar Asaas ou Mercado Pago
  - criar cobranca com `externalReference = CAMP-...`
  - configurar webhook em `webhooks/campanha-pagamento.php`
  - definir `CAMPANHA_WEBHOOK_SECRET` no `.env`
  - gateway envia aprovacao
  - Minike atualiza `pagamento_status` automaticamente
- Recomendacao:
  - Asaas para Pix, boleto, cobranca recorrente e webhook
  - Mercado Pago para checkout, cartao, Pix e parcelamento
  - Hotmart/Kiwify para cursos, infoprodutos e afiliados digitais
  - Vakinha/Catarse/Benfeitoria para vitrine publica e prova social

### Atendimento Meta como ativo comercial
- O subdominio `atendimento.minike.com.br` entra nas recompensas e propostas de maior valor.
- Funcoes que devem ser vendidas como diferencial:
  - WhatsApp Cloud API oficial
  - Instagram
  - Messenger
  - CRM
  - IA com base de conhecimento
  - automacoes
  - campanhas
  - templates
  - WhatsApp Flows
  - relatorios
  - Socket.io em tempo real
  - white-label
  - revenda
  - API Keys
  - atendimento multiatendente
  - historico completo
  - CSAT
  - rastreamento de Ads CTWA

### Ideias de mercado incorporadas ao Imperio Minike
- Sites e experiencias:
  - Framer
  - Webflow
  - Dora
  - Spline
  - Rive
  - LottieFiles
  - versao Minike: `Minike Sites 3D` e `Minike Motion`
- IA para apps e desenvolvimento:
  - Lovable
  - Bolt
  - v0
  - Replit
  - Cursor
  - versao Minike: `Minike App Builder`
- Criacao visual, video e voz:
  - Runway
  - ElevenLabs
  - Canva
  - Figma
  - Krea
  - versao Minike: `Minike Creative Studio`
- Educacao interativa:
  - Khanmigo/Khan Academy
  - Duolingo
  - Brilliant
  - Codecademy
  - versao Minike: `Minike Tutor AI`
- Automacoes:
  - Zapier
  - Make
  - n8n
  - Airtable/Notion
  - versao Minike: `Minike Automations`
- Commerce e comunidade:
  - Shopify/Nuvemshop
  - Hotmart/Kiwify
  - Patreon/Catarse/Benfeitoria
  - Mercado Pago/Asaas
  - versao Minike: `Minike Commerce Network`

### Proximos passos da campanha
1. Criar checkout real com Asaas ou Mercado Pago.
2. Criar pagina privada de area de membros para apoiadores confirmados.
3. Enviar email/WhatsApp automatico quando pagamento for confirmado.
4. Criar comprovante/certificado digital de apoiador.
5. Criar filtros no ranking por CPF, CNPJ, plano e valor.
6. Criar pagina publica de patrocinadores CNPJ.
7. Criar slots reais de anuncios internos vinculados aos planos Premium, Fundador, Diamante, Arquiteto, Guardiao e Imperio.
8. Criar Data Room privado para aportes de R$ 50 mil e R$ 100 mil+.
9. Criar copy curta para Vakinha, Catarse, Benfeitoria, LinkedIn, WhatsApp, Instagram, TikTok e YouTube Shorts.
10. Criar contrato/modelo juridico para white-label, co-branding, revenue share, codigo-fonte e possivel participacao societaria.

---

## 74. Progresso desta execucao (17/05/2026) - reforco real do escolar BR/US
- Prioridade atendida: `escolar.minike.com.br` estava com muitas materias em formato de casca e botoes de temas sem destino util.
- Criado `escolar/_curriculo_real.php` como motor curricular BR/US com:
  - fases brasileiras: Educacao Infantil, Fundamental I, Fundamental II, Ensino Medio, Fundamental integrado e Educacao Inclusiva
  - equivalencias americanas: Pre-K, Elementary, Middle School, High School e suportes inclusivos
  - materias/chaves: Portugues/ELA, Matematica, Ciencias, Historia/Geografia/Social Studies, Arte, Educacao Fisica, Tecnologia/Computer Science, Ingles/World Language, Vida/Carreira/Financas e Inclusao/Acessibilidade
  - temas-base por materia
  - objetivos, passos de aula, atividades, quiz e conexao Brasil/EUA
- Criado `escolar/tema.php`:
  - abre qualquer tema em pagina propria
  - mostra aula guiada
  - mostra atividades prontas
  - mostra quiz
  - mostra conexao BNCC / Common Core / NGSS
  - suporta PT/EN
- Criado `escolar/serie.php`:
  - lista anos/series do Brasil e dos EUA
  - abre materias e temas por ano
  - cria caminhos para BR e US sem depender de banco
- Criado `escolar/temas.php`:
  - catalogo geral de todos os temas
  - filtros por fase e materia
  - cada tema aponta para `tema.php`
- Atualizado `escolar/materia_base.php`:
  - todas as paginas antigas de materias passaram a ganhar conteudo real automaticamente
  - botoes de IA agora geram feedback visual local
  - botao "Continue de onde parou" agora abre um tema real
  - foram adicionados cards clicaveis de temas por materia
- Atualizado `escolar/index.php`:
  - cards de materia agora usam link direto para a materia, sem pedÃ¡gio GO5 que atrapalhava o fluxo educacional
  - nova secao "Escolha por ano escolar"
  - links para Brasil/BNCC e USA/Common Core+NGSS
  - novo atalho "Series / Grades"
  - novo atalho "Todos os temas"
- Atualizados hubs especificos:
  - `escolar/matematica.php`
  - `escolar/portugues.php`
  - `escolar/ciencias.php`
  - os botoes "Aula gratis" agora abrem `tema.php`, nao uma pagina generica solta
- Referencias curriculares usadas como base:
  - BNCC/MEC para Brasil
  - Common Core para ELA e Matematica nos EUA
  - NGSS para Ciencias nos EUA
  - praticas de Social Studies, Arts, PE, SEL, CTE e Computer Science para complementar o mapa americano
- Validacao realizada:
  - `php -l` OK em `escolar/_curriculo_real.php`, `escolar/tema.php`, `escolar/serie.php`, `escolar/temas.php`, `escolar/index.php`, `escolar/materia_base.php`, `escolar/matematica.php`, `escolar/portugues.php`, `escolar/ciencias.php`
  - rotas locais com HTTP 200:
    - `/escolar/`
    - `/escolar/serie.php?country=br&lang=pt`
    - `/escolar/serie.php?country=us&lang=en`
    - `/escolar/tema.php?phase=fundamental-1&subject=matematica-math&topic=fracao&lang=pt`
    - `/escolar/fundamental-1/matematica-math/index.php?lang=pt`
    - `/escolar/medio/fisica/index.php?lang=pt`
    - `/escolar/matematica.php?lang=pt`
    - `/escolar/portugues.php?lang=pt`
    - `/escolar/ciencias.php?lang=pt`
- Proximos passos para deixar escolar ainda mais forte:
  1. Criar area do aluno com progresso real por tema.
  2. Criar area do professor para montar turma e liberar tarefas.
  3. Gerar simulados por ano com gabarito automatico.
  4. Criar certificados de trilha.
  5. Conectar Tutor AI real quando houver chave/modelo configurado.
  6. Criar impressao/PDF de atividades para pais e professores.

---

## 75. Progresso desta execucao (17/05/2026) - escolar com estudo interativo e conexao de ecossistema
- Criado `includes/minike_school_hub.php` como camada compartilhada para o escolar com:
  - normalizacao de fases BR/US
  - inferencia de materia por tema
  - mapeamento de serie para fase
  - recomendacoes de cursos, ferramentas e games
  - biblioteca de fontes oficiais e abertas com nota de direitos
  - modulo pronto de estudo com resumo, flashcards, quiz, mini prova e mini game
- Atualizado `escolar/serie.php`:
  - materias agora abrem destinos coerentes com a fase
  - temas deixaram de apontar para links genericos
  - cada ano ganhou CTA para mini prova, packs de atividade e trilhas do `cursos`
- Refeito `escolar/tema.php`:
  - resumo de estudo rapido
  - checklist da sessao
  - flashcards clicaveis
  - mini quiz corrigivel
  - mini prova corrigivel
  - mini game da memoria
  - blocos de cursos, ferramentas e games recomendados
  - secao de fontes com credito e observacao de direitos
- Refeito `escolar/provas.php`:
  - prova filtravel por pais, ano e materia
  - diagnostico + mini prova na mesma pagina
  - ponte direta para aula do tema, curso sugerido e ferramenta util
- Atualizado `escolar/index.php`:
  - nova vitrine dos modos de estudo
  - destaque para aulas completas, mini provas e conexoes com cursos/ferramentas/games
- Atualizado `cursos/trilhas.php`:
  - criada secao de trilhas especificas para o Minike Escolar
  - focos novos: `school-core`, `school-math`, `school-language`, `school-science`, `school-tech`, `school-study-skills`
  - pagina agora serve como destino real para recomendacoes vindas do escolar
- Fontes oficiais e abertas conectadas no fluxo:
  - BNCC / MEC
  - Common Core ELA
  - Common Core Math
  - NGSS
  - NASA STEM
  - Code.org
  - Portal Dominio Publico
  - Banco Central / Cidadania Financeira
  - Smithsonian Learning Lab
  - The Met Open Access
- Validacao realizada:
  - `php -l` OK em `includes/minike_school_hub.php`
  - `php -l` OK em `escolar/tema.php`
  - `php -l` OK em `escolar/provas.php`
  - `php -l` OK em `escolar/serie.php`
  - `php -l` OK em `escolar/index.php`
  - `php -l` OK em `cursos/trilhas.php`
- Proximos passos naturais a partir desta base:
  1. Persistir resultado de quiz/prova no banco com progresso por aluno.
  2. Liberar moedas/recompensas ao concluir quiz, prova e mini game.
  3. Criar PDF imprimivel de mini prova e atividade.
  4. Abrir painel do professor para montar turmas e acompanhar desempenho.

---

## 76. Progresso desta execucao (17/05/2026) - progresso persistente para aluno e professor no escolar
- Criado `escolar/_study_progress.php`:
  - bootstrap da tabela `mk_escolar_estudo_progresso`
  - funcoes para salvar tentativa
  - resumo por usuario
  - historico recente
  - visao de professor/admin com atividade dos alunos
- Criado `escolar/salvar_progresso.php`:
  - endpoint JSON para receber resultados de quiz, mini prova e mini game
  - quando houver login, grava no banco
  - quando nao houver login, responde com fallback para armazenamento local
- Criado `escolar/progresso.php`:
  - painel de progresso do aluno
  - cards com tentativas, temas unicos, media de progresso e jogos concluidos
  - historico recente da conta
  - visao local no navegador para quem ainda nao entrou
  - visao resumida de turma/atividade recente para professor ou admin
- Atualizado `escolar/tema.php`:
  - quiz, mini prova e mini game agora salvam progresso automaticamente
  - usa localStorage como backup
  - usa `salvar_progresso.php` para persistencia no servidor
  - ganhou link direto para `progresso.php`
- Atualizado `escolar/provas.php`:
  - quiz diagnostico e mini prova agora salvam resultado
  - tambem usam localStorage como backup
  - ganhou link direto para `progresso.php`
- Atualizado `escolar/index.php`:
  - acesso rapido para `progresso.php`
  - botao de progresso visivel para usuario logado no topo
- Validacao realizada:
  - `php -l` OK em `escolar/_study_progress.php`
  - `php -l` OK em `escolar/salvar_progresso.php`
  - `php -l` OK em `escolar/progresso.php`
  - `php -l` OK em `escolar/tema.php`
  - `php -l` OK em `escolar/provas.php`
  - `php -l` OK em `escolar/index.php`
  - renderizacao CLI OK em `progresso.php`, `tema.php` e `provas.php`
  - observacao: no ambiente CLI local o PDO MySQL nao esta disponivel, entao o fallback de banco degradado apareceu, mas a renderizacao das paginas continuou
- Proximos passos naturais:
  1. Conectar moedas/recompensas em `mk_moedas` para quiz, mini prova e mini game.
  2. Criar ranking escolar por aluno, materia e serie.
  3. Abrir filtros reais por turma quando a area do professor estiver pronta.
  4. Ligar o progresso salvo a certificados escolares e liberacao de trilhas premium.

---

## 77. Progresso desta execucao (17/05/2026) - moedas MKC e ranking escolar
- Atualizado `escolar/_study_progress.php`:
  - integrado com `includes/mk_moedas.php`
  - coluna `mkc_rewarded_total` adicionada ao fluxo de progresso
  - recompensa calculada por atividade e percentual:
    - `quiz_diagnostico`
    - `quiz`
    - `mini_prova`
    - `memory`
  - evita farm bruto de refresh repetido:
    - a recompensa cresce apenas quando o melhor desempenho sobe
    - o ganho passa a refletir melhoria real
  - nova consulta de ranking escolar por aluno
- Atualizado `escolar/salvar_progresso.php`:
  - resposta agora retorna saldo MKC atual
  - resposta inclui `reward_mkc` da tentativa salva
- Criado `escolar/ranking.php`:
  - ranking escolar dos alunos
  - filtro por materia
  - ordenacao por progresso medio, pontuacao acumulada, temas estudados e atividade recente
  - mostra MKC acumulado por estudo
- Atualizado `escolar/tema.php`:
  - ao corrigir quiz e mini prova mostra ganho de MKC
  - ao completar mini game de memoria tambem mostra recompensa
- Atualizado `escolar/provas.php`:
  - quiz diagnostico e mini prova agora exibem recompensa MKC no resultado
- Atualizados atalhos de navegacao:
  - `escolar/index.php` ganhou acesso a `ranking.php`
  - `escolar/progresso.php` ganhou acesso a `ranking.php`
- Validacao realizada:
  - `php -l` OK em `escolar/_study_progress.php`
  - `php -l` OK em `escolar/salvar_progresso.php`
  - `php -l` OK em `escolar/ranking.php`
  - `php -l` OK em `escolar/progresso.php`
  - `php -l` OK em `escolar/tema.php`
  - `php -l` OK em `escolar/provas.php`
  - `php -l` OK em `escolar/index.php`
  - renderizacao CLI OK em `ranking.php` e `progresso.php`
  - observacao local: PDO MySQL continua ausente no CLI, entao o ambiente caiu no fallback degradado, mas as paginas renderizaram
- Proximos passos naturais:
  1. Criar ranking por turma/serie quando houver vinculo real entre portal e turmas.
  2. Transformar MKC em loja escolar com desbloqueio de simulados, skins e certificados especiais.
  3. Liberar medalhas escolares usando a mesma logica ja existente em games.

---

## 78. Progresso desta execucao (17/05/2026) - reforco do hub `games` com pesquisa de concorrencia e originais Minike
- Pesquisa de referencia realizada em vitrines publicas de jogos casuais:
  - Poki: alta recorrencia de categorias `merge`, `math`, `brain`, `watermelon/drop` e listas com destaque para loops simples e repetiveis.
  - CrazyGames: categorias `casual` e `clicker` mostram forca de idle leve, progressao rapida, reflexo e jogos de â€œum botaoâ€.
  - Coolmath Games: reforco de 2048, merge numÃ©rico e puzzles de tentativa curta com regra facil de entender.
- Leitura de mercado resumida:
  - o que mais segura atencao no browser casual hoje nao e profundidade grande, e sim:
    - onboarding instantaneo
    - feedback visual rapido
    - score subindo cedo
    - vontade de â€œsÃ³ mais umaâ€
    - boa leitura em celular
- Decisao de produto para o Minike:
  - em vez de copiar propriedades conhecidas, criar versoes proprias inspiradas nas mecanicas mais fortes:
    - `merge/drop`
    - `clicker/idle curto`
    - `reaction lane dodge`
    - `stack timing`
- Atualizado `games/minike/games/shared/engine.js` e `games/minike/shared/engine.js`:
  - suporte novo para:
    - `merge-drop`
    - `idle-clicker`
    - `lane-dodge`
    - `stacker`
  - score com recorde local em `localStorage`
  - alias corrigido para `runner` -> `run-sim`
  - base pronta para futuras medalhas, ranking e persistencia
- Atualizado `games/minike/generator.php`:
  - adicionados quatro jogos originais na esteira do gerador:
    - `game-024` `Orbita Mix`
    - `game-025` `Turbo Toque MK`
    - `game-026` `Faixa Relampago`
    - `game-027` `Torre Vibe`
  - `writeGeneric()` agora entende layouts especiais para os novos modos
  - gerador executado novamente para materializar as paginas fisicas
- Novos jogos entregues:
  - `Orbita Mix`
    - loop de drop-merge proprio do Minike
    - foco em combo de cadeia e tabuleiro curto
  - `Turbo Toque MK`
    - clicker compacto com upgrades de clique, auto ganho e combo
    - pensado para loops de sessao curta
  - `Faixa Relampago`
    - troca de faixa em alta velocidade
    - loop de reflexo com dificuldade progressiva
  - `Torre Vibe`
    - timing de empilhamento
    - perda clara, reinicio facil e score limpo
- Atualizado `games/minike/catalog.php`:
  - catalogo deixou de ser lista fria de 100 itens
  - nova curadoria com:
    - secao `Originais Minike`
    - secao `Aprender Jogando`
    - secao `Sessao One-More-Try`
    - secao `Laboratorio Minike`
  - filtros por perfil de experiencia
  - bloco de creditos e observacao de direitos
- Atualizado `games/minike/index.php`:
  - nova home do mini hub com destaque para os originais
  - estatisticas e discurso de produto conectando com ranking, escolar, medalhas e MKC
- Atualizado `games/index.php`:
  - vitrine global ganhou os quatro novos jogos como fallback estatico
  - isso permite que o hub principal tambÃ©m exponha os originais do Minike
- Atualizados `games/minike/games/shared/style.css` e `games/minike/shared/style.css`:
  - visual mais coerente com hub casual moderno
  - contraste, botoes e cards mais fortes
- Direitos e origem expostos:
  - codigo e interface desta leva produzidos dentro do projeto Minike
  - inspiracao de mecanica baseada em referencias publicas de mercado
  - sem reaproveitamento de assets proprietarios de terceiros
- Validacao realizada:
  - `php games/minike/generator.php` executado com sucesso
  - paginas fisicas recriadas em `games/minike/games/`
  - novos links globais apontados para `minike/games/game-024` ate `game-027`
- Proximos passos naturais:
  1. Salvar score de games no banco e ligar ao ranking global automaticamente.
  2. Criar medalhas e missoes diarias para `Originais Minike`.
  3. Fazer skins escolares para `Orbita Mix`, `Turbo Toque MK` e memoria com temas de materias.
  4. Abrir temporada com eventos do ecossistema usando MKC, ranking e cursos recomendados.

---

## 79. Progresso desta execucao (17/05/2026) - score online, MKC por melhoria real e medalhas dos originais
- Criado `games/_score_hub.php`:
  - helper compartilhado para score do ecossistema de games
  - bootstrap da tabela `mk_games_score_best`
  - registro do melhor score por usuario e por jogo
  - ranking baseado em melhores scores somados, em vez de soma bruta de tentativas
  - logica de recompensa apenas quando o score melhora
  - seeds e atribuicao de medalhas ligadas ao novo hub
- Criado `games/minike/salvar_score.php`:
  - endpoint JSON do mini hub para sincronizar score
  - exige login para gravar no ranking e liberar MKC
  - quando nao houver login, devolve mensagem amigavel para manter fluxo local
- Atualizado `games/minike/shared/engine.js` e `games/minike/games/shared/engine.js`:
  - envio automatico de score quando houver melhoria real
  - sincronizacao em `pagehide` / `visibilitychange`
  - submit em pontos de fim de rodada dos jogos com game over
  - mensagens de retorno do backend reaproveitadas no HUD
- Atualizado `games/minike/generator.php`:
  - cada pagina gerada com engine compartilhado agora recebe:
    - `MINIKE_SCORE_ENDPOINT`
    - `MINIKE_GAME_SLUG`
    - `MINIKE_GAME_TITLE`
    - `MINIKE_GAME_CATEGORY`
    - `MINIKE_GAME_PATH`
  - o gerador deixou de sobrescrever o `catalog.php` curado do hub
- Regeneradas paginas fisicas dos jogos em `games/minike/games/` com a nova camada de score
- Atualizado `games/ranking.php`:
  - ranking agora prefere a base de melhores scores do helper
  - texto da pagina passou a refletir a nova regra de placar
- Atualizado `games/index.php`:
  - bloco de top players tambem passou a usar a base nova quando disponivel
  - mantem fallback para o modelo antigo se necessario
- Atualizado `games/medalhas.php`:
  - novas medalhas adicionadas ao seed e ao fallback:
    - `originais_minike`
    - `combo_cosmico`
    - `toque_turbo`
    - `faixa_fria`
    - `torre_solida`
- Regras novas de recompensa:
  - MKC nao sobe por spam de refresh ou repeticao identica
  - a moeda entra apenas quando o melhor score melhora
  - a recompensa escala pela melhoria obtida
- Regras novas de medalha:
  - `primeiro_jogo`
  - `explorador` ao pontuar em 5 jogos
  - `lenda` ao somar 1000 pontos em melhores scores
  - `originais_minike` ao pontuar nos 4 originais
  - medalhas especificas por desempenho forte em cada original
- Direitos e produto:
  - continua valendo a linha de direitos ja registrada na secao 78
  - esta fase transformou os jogos do mini hub em ativos conectados ao ecossistema, e nao mais em paginas isoladas
- Validacao realizada:
  - `php -l` nos arquivos novos e atualizados do fluxo de score
  - `node --check` no `engine.js`
  - renderizacao CLI das paginas principais do mini hub e dos jogos originais
- Proximos passos naturais:
  1. Criar painel â€œmeu desempenhoâ€ com historico de melhores scores por jogo.
  2. Liberar missoes diarias e semanais com MKC em cima do `mk_games_score_best`.
  3. Mostrar medalhas desbloqueadas em tempo real dentro dos jogos.
  4. Conectar score dos jogos educativos ao escolar quando a atividade for de materia.

---

## 80. Progresso desta execucao (17/05/2026) - cursos completos com aulas, avaliacao, progresso e certificado
- Criado `cursos/_course_hub.php` como base compartilhada do novo sistema:
  - catalogo coerente gerado a partir de `mkMeta999CourseSeeds`
  - modulos e aulas por categoria
  - banco de questoes por area
  - bootstrap de persistencia:
    - `mk_cursos_hub_matriculas`
    - `mk_cursos_hub_aulas`
    - `mk_cursos_hub_avaliacoes`
  - emissao automatica de certificado ao cumprir:
    - 100% das aulas
    - nota minima de 70%
  - recompensa de `25 MKC` no momento da certificacao
  - helper de nome do aluno e grade unificada de respostas
- Criado `cursos/curso.php` como pagina principal de cada curso:
  - hero real do curso
  - matricula
  - modulos e aulas
  - progresso do aluno
  - retomada automatica na proxima aula pendente
  - atalhos para avaliacao final e certificado
- Criado `cursos/aula.php`:
  - pagina de estudo por aula
  - resumo, pratica guiada, material de apoio e creditos
  - navegacao entre aulas
  - marcacao de aula concluida
  - progresso ligado ao curso
- Refeito `cursos/avaliacao.php`:
  - agora funciona em dois modos:
    - vitrine de avaliacoes por curso
    - prova final de um curso especifico
  - correcao com explicacao por questao
  - persistencia da nota quando logado
  - melhor nota conectada ao certificado
- Refeito `cursos/progresso.php`:
  - painel do aluno com cursos ativos
  - progresso medio
  - certificados concluidos
  - melhor nota
  - saldo `MKC`
  - recomendacoes de cursos quando ainda nao houve matricula
- Refeito `cursos/certificado.php`:
  - certificado real vinculado ao curso concluido
  - validacao publica por codigo
  - visual pronto para impressao
  - fallback informativo quando o aluno ainda nao concluiu
- Atualizado `cursos/index.php`:
  - cards da vitrine agora abrem `curso.php` em vez de empurrar para paginas soltas
  - navegaÃ§Ã£o principal alinhada com `trilhas`, `avaliacao`, `progresso` e `certificado`
- Atualizado `cursos/trilhas.php`:
  - catalogo por area agora abre o curso correto no novo fluxo
  - conexao mantida com o ecossistema escolar
- Direitos e origem:
  - estrutura, aulas-sintese, provas e certificado desta fase foram produzidos para o ecossistema Minike
  - quando houver embed, video, imagem ou material de terceiros dentro das aulas, o credito e a fonte continuam obrigatorios e expostos
- Validacao realizada:
  - `php -l` em:
    - `cursos/_course_hub.php`
    - `cursos/curso.php`
    - `cursos/aula.php`
    - `cursos/avaliacao.php`
    - `cursos/progresso.php`
    - `cursos/certificado.php`
    - `cursos/index.php`
    - `cursos/trilhas.php`
  - renderizacao CLI confirmada para:
    - `curso.php`
    - `aula.php`
    - `avaliacao.php`
    - `progresso.php`
    - `certificado.php`
    - `trilhas.php`
  - no CLI continuou aparecendo apenas o fallback de banco indisponivel por falta do driver PDO MySQL local
- Proximos passos naturais:
  1. Criar ranking de certificados e concluintes por curso e por area.
  2. Abrir comentarios, duvidas e comunidade por aula.
  3. Permitir anexos, caderno do aluno e respostas abertas em atividades praticas.
  4. Ligar certificados dos cursos ao hub escolar, games educativos e paginas de perfil.

---

## 81. Progresso desta execucao (17/05/2026) - tira-duvidas por aula e ranking de concluintes
- Evoluida a base `cursos/_course_hub.php`:
  - nova tabela `mk_cursos_hub_duvidas`
  - helpers para:
    - salvar duvidas por aula
    - listar duvidas por aula
    - listar duvidas por curso
    - montar ranking agregado de concluintes e certificados
  - ranking considera:
    - quantidade de certificados
    - quantidade de cursos concluidos
    - nota media
    - melhor nota
    - progresso medio
    - data do certificado mais recente
- Atualizado `cursos/aula.php`:
  - novo bloco `Tira-duvidas da aula`
  - aluno logado pode enviar pergunta curta da aula
  - visitantes veem CTA de login
  - lista de duvidas da aula com status:
    - `Aguardando resposta`
    - `Respondida`
  - navegacao da aula ganhou atalho para ranking do curso
- Criado `cursos/ranking.php`:
  - ranking publico do hub de cursos
  - filtros por:
    - curso
    - area
  - tabela com:
    - posicao
    - aluno
    - certificados
    - cursos concluidos
    - nota media
    - melhor nota
    - progresso medio
    - ultimo certificado
  - CTA direto para abrir o curso filtrado
- Atualizados atalhos de navegacao:
  - `cursos/index.php`
  - `cursos/curso.php`
  - `cursos/aula.php`
  - `cursos/progresso.php`
  - `cursos/avaliacao.php`
  - `cursos/certificado.php`
  - todos agora expÃµem `Ranking` no fluxo principal
- Direitos e produto:
  - as duvidas, o ranking e a logica de agregacao desta fase foram produzidos para o ecossistema Minike
  - conteudo de terceiros continua com credito obrigatorio dentro das aulas onde aparecer
- Validacao realizada:
  - `php -l` em:
    - `cursos/_course_hub.php`
    - `cursos/aula.php`
    - `cursos/ranking.php`
    - `cursos/curso.php`
    - `cursos/progresso.php`
    - `cursos/avaliacao.php`
    - `cursos/certificado.php`
    - `cursos/index.php`
  - renderizacao CLI confirmada para:
    - `aula.php`
    - `ranking.php`
    - `ranking.php` filtrado por curso
    - `progresso.php`
  - no CLI permaneceu apenas o fallback local de banco indisponivel por falta do driver PDO MySQL
- Proximos passos naturais:
  1. Criar moderacao/admin para responder duvidas direto do painel.
  2. Liberar notificacoes quando uma duvida receber resposta.
  3. Mostrar ranking pessoal do aluno dentro do proprio progresso.
  4. Abrir comentarios, anexos e caderno por aula.

---

## 82. Progresso desta execucao (17/05/2026) - prova social global, online e ajuda por WhatsApp
- Criada a camada compartilhada `includes/global_trust_layer.php`:
  - contador de pessoas online por pagina
  - bloco flutuante de reviews de clientes em rotacao
  - CTA de ajuda com botao de WhatsApp
  - mensagem curta `Precisa de ajuda?` ou `Need help?` conforme idioma
  - renderizacao protegida por `static $rendered` para aparecer uma vez so por request
- Reaproveitada a base existente `includes/fake_data.php`:
  - `FakeDataGenerator::getOnlineUsers()`
  - `FakeDataGenerator::getFakeReviews()`
  - `getAverageRating()`
  - `getReviewCount()`
  - isso permitiu subir prova social global sem depender de painel novo nesta fase
- Integracao nos pontos compartilhados do ecossistema:
  - `includes/minike-mobile.php`
  - `includes/minike-nav.php`
  - `includes/header-unificado.php`
  - `includes/footer-unificado.php`
  - `includes/header.php`
  - `includes/footer.php`
  - `includes/minike-footer.php`
  - `ferramentas/config.php`
  - cobertura pratica para site principal e subsites como escolar, cursos, games e ferramentas
- Limpeza de duplicidade:
  - removidos os botoes antigos de WhatsApp que existiam em `minike-mobile.php` e `minike-nav.php`
  - a nova camada global passa a ser a fonte unica para contador online, reviews e ajuda
- Comportamento entregue:
  - o contexto da pagina ajusta o tipo de review entre `ferramenta`, `curso` e `jogo`
  - o CTA de ajuda monta mensagem pronta para WhatsApp com contexto da pagina
  - o prompt flutuante pode ser fechado e fica lembrado via `localStorage`
  - o card de reviews exibe nota media e total de avaliacoes
- Direitos e uso:
  - interface, composicao e implementacao foram produzidas para o ecossistema Minike
  - reviews e contagem desta fase usam base simulada interna para prova social inicial
  - quando houver depoimentos reais, a mesma camada pode ser ligada ao banco sem refazer a interface
- Validacao realizada:
  - `php -l` em:
    - `includes/global_trust_layer.php`
    - `includes/minike-mobile.php`
    - `includes/minike-nav.php`
    - `includes/header-unificado.php`
    - `includes/footer-unificado.php`
    - `includes/header.php`
    - `includes/footer.php`
    - `includes/minike-footer.php`
    - `ferramentas/config.php`
  - renderizacao CLI confirmada para:
    - `index.php`
    - `cursos/index.php`
  - a checagem confirmou a presenca da nova camada global na saida HTML sem erro fatal
- Proximos passos naturais:
  1. Trocar o contador online simulado por telemetria real por site e por pagina.
  2. Abrir um painel admin para cadastrar depoimentos reais com aprovacao.
  3. Variar reviews e CTA por subsite, campanha ou categoria.
  4. Medir clique no WhatsApp e impacto em conversao por area do ecossistema.

---

## 83. Progresso desta execucao (17/05/2026) - telemetria leve de online e painel admin de reviews
- Criada a base compartilhada `includes/social_proof_store.php`:
  - persistencia de reviews em `cache/admin/social-proof-reviews.json`
  - telemetria leve de presenca recente em `cache/admin/social-proof-online.json`
  - contagem de online por:
    - global
    - site
    - pagina
  - filtros de reviews por:
    - tipo `ferramenta`, `curso`, `jogo`
    - idioma
    - host
    - pagina especifica
  - calculo de media e quantidade real de reviews aprovados
- Evoluida `includes/global_trust_layer.php`:
  - agora registra presenca recente por sessao ao renderizar o widget
  - passa a buscar reviews reais aprovados antes do fallback fake
  - completa o carrossel com fallback apenas quando ainda faltam reviews suficientes
  - contador online usa telemetria do site atual com fallback de aquecimento para nao ficar morto em cold start
  - compatibilizado formato de reviews do painel admin com o card flutuante global
- Criado o painel `admin/prova-social.php`:
  - login admin com a mesma logica de senha mestre/fallback do ecossistema
  - cadastro e edicao de review com:
    - nome
    - cargo/contexto
    - texto
    - nota
    - idioma
    - tipo
    - site
    - pagina opcional
    - origem
    - data visivel
  - controle rapido de status:
    - aprovado
    - ativo
    - verificado
  - exclusao de review
  - quadro de online por host nos ultimos 300 segundos
  - indicadores de:
    - reviews aprovados ativos
    - nota media real
    - online global recente
    - hosts com movimento
- Atualizado `admin/imperio.php`:
  - novo atalho direto `Prova social` no menu lateral
- Comportamento de produto desta fase:
  - o ecossistema passa a ter uma fonte administravel para reviews reais
  - a camada social deixa de depender apenas de dados simulados
  - a telemetria e resiliente porque funciona mesmo sem banco, usando `cache/admin`
  - em producao, cada sessao ativa ajuda a compor o contador do respectivo host e pagina
- Direitos e uso:
  - estrutura, painel e telemetria foram produzidos para o ecossistema Minike
  - reviews cadastrados no painel devem ser usados apenas quando houver autorizacao do cliente
  - o fallback simulado continua apenas como contingencia visual para cold start
- Validacao realizada:
  - `php -l` em:
    - `includes/social_proof_store.php`
    - `includes/global_trust_layer.php`
    - `admin/prova-social.php`
    - `admin/imperio.php`
  - renderizacao CLI confirmada para:
    - `index.php` com ocorrencia unica do widget global
    - `admin/prova-social.php` logado
    - `admin/imperio.php` com novo link de prova social
  - leitura da telemetria confirmada com retorno de contagem por host/pagina
- Proximos passos naturais:
  1. Medir clique no WhatsApp e CTA do widget por site e por pagina.
  2. Abrir captura de depoimentos via formulario publico com fila de aprovacao.
  3. Adicionar upload de avatar/logo opcional nos reviews.
  4. Gerar ranking dos sites com maior conversao social dentro do admin.

---

## 84. Progresso desta execucao (17/05/2026) - tracking de cliques do widget e ranking de conversao
- Evoluida `includes/social_proof_store.php`:
  - novo arquivo de eventos `cache/admin/social-proof-events.json`
  - eventos suportados:
    - `impression`
    - `click_help_cta`
    - `click_whatsapp_float`
    - `dismiss_help_prompt`
  - deduplicacao leve por sessao/host/pagina/evento para evitar spam e duplo clique acidental
  - agregacao por:
    - total geral
    - site
    - pagina
    - dia
  - novos helpers:
    - registrar evento
    - calcular CTR
    - montar ranking de conversao por host e por pagina
- Criado endpoint `api/prova-social.php`:
  - recebe POST do widget global
  - salva eventos de impressao e clique usando a store compartilhada
  - responde em JSON e continua resiliente sem depender de banco
- Atualizado `includes/global_trust_layer.php`:
  - o widget agora envia `impression` uma vez por pagina em `sessionStorage`
  - clique no CTA principal envia `click_help_cta`
  - clique no botao flutuante envia `click_whatsapp_float`
  - fechar o prompt envia `dismiss_help_prompt`
  - tracking usa `sendBeacon` quando disponivel e cai para `fetch` com `keepalive`
- Atualizado `admin/prova-social.php`:
  - nova leitura de conversao agregada
  - cards com:
    - impressoes
    - cliques
    - CTR global
  - nova secao `Conversao do widget por site e pagina`
  - ranking `Top sites por clique`
  - ranking `Top paginas por clique`
  - detalhe separado de cliques do CTA principal e do botao flutuante
- Produto e operacao:
  - o painel agora mostra quais hosts e paginas puxam mais interacao com o WhatsApp
  - a camada de prova social deixa de ser apenas visual e passa a ter feedback real de uso
  - os eventos de validacao foram limpos da base para nao contaminar os dados reais
- Direitos e uso:
  - tracking, ranking e endpoint foram produzidos para o ecossistema Minike
  - a coleta e anonima no nivel de sessao tecnica, host e pagina
  - nao ha dependencia de banco para funcionar em contingencia
- Validacao realizada:
  - `php -l` em:
    - `includes/social_proof_store.php`
    - `includes/global_trust_layer.php`
    - `admin/prova-social.php`
    - `api/prova-social.php`
  - POST de validacao confirmado no endpoint com eventos de `impression` e `click_help_cta`
  - renderizacao CLI confirmada para:
    - `index.php` contendo o hook `/api/prova-social.php`
    - `admin/prova-social.php` com as secoes de conversao
  - base de eventos resetada apos a validacao para iniciar limpa
- Proximos passos naturais:
  1. Abrir captura publica de depoimentos com fila de aprovacao.
  2. Adicionar avatar/logo opcional nos reviews aprovados.
  3. Criar comparativo por periodo, por exemplo hoje x 7 dias.
  4. Cruzar clique do widget com pedidos/leads reais por subsite.

---

## 85. Progresso desta execucao (17/05/2026) - captura publica de depoimentos com fila de aprovacao
- Evoluida `includes/social_proof_store.php`:
  - reviews passam a aceitar metadados adicionais:
    - `company`
    - `email`
    - `whatsapp`
    - `avatar_url`
    - `consent_public`
    - `submitted_via`
    - `moderation_notes`
  - novo helper `mk_social_proof_submit_public_review()` para submissao publica segura
  - novo helper `mk_social_proof_pending_reviews()` para fila de moderacao
  - compatibilidade reforcada com ambientes sem `mbstring` usando helper proprio de tamanho
- Criada a pagina publica `depoimentos.php`:
  - formulario aberto para cliente enviar depoimento
  - coleta:
    - nome
    - cargo/contexto
    - empresa
    - email
    - WhatsApp
    - area principal
    - site relacionado
    - nota
    - texto do depoimento
    - consentimento publico
  - os envios entram por padrao como:
    - `approved = false`
    - `active = false`
    - `verified = false`
  - a pagina tambem mostra exemplos aprovados para orientar o preenchimento
- Atualizado `includes/global_trust_layer.php`:
  - o card flutuante de reviews ganhou link direto `Enviar depoimento`
  - isso abre a captura publica a partir de qualquer site/subsite que use a camada global
- Atualizado `admin/prova-social.php`:
  - nova secao `Fila publica e reviews pendentes`
  - leitura rapida de contato do cliente:
    - email
    - WhatsApp
  - acao rapida para:
    - aprovar
    - publicar
    - revisar no editor
  - editor admin passou a aceitar:
    - empresa
    - email
    - WhatsApp
    - consentimento publico
  - painel ganhou indicador de quantidade aguardando aprovacao
- Produto e operacao:
  - o ecossistema passa a ter entrada publica real para captar depoimentos
  - a moderacao continua centralizada no admin antes de qualquer exibicao
  - a captura publica aproveita a mesma base compartilhada de prova social ja usada pelo widget global
- Direitos e uso:
  - a publicacao depende de consentimento explicito no formulario
  - a aprovacao final continua manual para evitar spam e uso indevido de nome/marca
- Validacao realizada:
  - `php -l` em:
    - `includes/social_proof_store.php`
    - `includes/global_trust_layer.php`
    - `depoimentos.php`
    - `admin/prova-social.php`
  - renderizacao CLI confirmada para:
    - `depoimentos.php`
    - `admin/prova-social.php`
  - submissao publica simulada entrou corretamente na fila admin
  - o registro sintetico de validacao foi removido ao final para manter a base limpa
- Proximos passos naturais:
  1. Adicionar avatar/logo opcional nos depoimentos aprovados.
  2. Criar captura com upload simples de print ou logo para prova social mais forte.
  3. Mostrar data de submissao e notas internas de moderacao no admin.
  4. Cruzar depoimentos aprovados com conversao do widget por site.


---

## Fonte: mapa-inovacao-experiencias-minike.md

# Mapa de Inovacao e Experiencias - Imperio Minike

Atualizado em 17/05/2026.

Este documento transforma referencias de mercado em uma versao Minike. A ideia e simples: quando alguem pensar em aprender, vender, automatizar, criar site, criar loja, jogar, atender no WhatsApp, montar campanha ou construir software, precisa lembrar do Minike.

## Diretriz estrategica

- Nao copiar produtos: adaptar conceitos para o publico Minike.
- Priorizar PT/EN, BRL/USD, mobile-first e venda rapida.
- Cada produto deve gerar trafego, captura, recorrencia ou prova social.
- Cada modulo novo deve conversar com atendimento, lojas, ferramentas, cursos, escolar, games, afiliados e MKC.
- Participacao societaria, revenue share e codigo-fonte exclusivo entram apenas em proposta privada com contrato e revisao juridica.

## 1. Sites interativos, 3D e experiencias visuais

### Referencias de mercado

- Framer: sites modernos com edicao visual, CMS, publicacao rapida, animacoes e IA para acelerar criacao.
- Webflow: desenvolvimento visual, CMS, interacoes, formularios, hosting e fluxo profissional para agencias.
- Dora: criacao de sites com IA, animacoes, scroll effects e experiencias visuais mais ousadas.
- Spline: design 3D no navegador, colaboracao em tempo real e experiencias 3D interativas para web.
- Rive: animacoes interativas com state machines para apps, jogos e sites.
- LottieFiles: biblioteca e fluxo de animacoes leves para interfaces, marketing e produtos digitais.

### Versao Minike

Nome sugerido: Minike Sites 3D.

Funcoes:

- Builder de landing pages e sites com blocos prontos.
- Blocos 3D leves para hero, produtos, mascotes, lojas e campanhas.
- Animacoes de scroll e entrada sem precisar programar.
- Templates por nicho: loja local, mecanica, delivery, escola, igreja, profissional liberal, curso, afiliado e campanha.
- Publicacao em subdominio Minike para cliente sem dominio proprio.
- Upgrade para dominio proprio, SSL, SEO, suporte e manutencao.
- Biblioteca de componentes padrao Minike para manter identidade visual.
- Versao white label para agencias e investidores de maior aporte.

### Como vender na campanha

- R$ 1 a R$ 100: voto em templates e acesso antecipado a temas.
- R$ 250 a R$ 500: licencas para CNPJ, diagnostico e anuncio interno aprovado.
- R$ 1.000: site customizado com padrao Minike, manutencao cobrada a parte.
- R$ 2.000 a R$ 5.000: site com funil, atendimento inicial, automacoes e divulgacao interna.
- R$ 10.000: pacote white-label de sites por nicho.
- R$ 50.000+: implantacao regional com pacotes para agencias e parceiros.
- R$ 100.000+: laboratorio privado de sites interativos, possivel acordo societario ou revenue share sob contrato.

## 2. IA para criar apps, dashboards e ferramentas

### Referencias de mercado

- Lovable: construcao de aplicacoes web a partir de prompts.
- Bolt: criacao de websites, web apps e mobile apps no navegador com IA.
- v0: geracao de UI e codigo a partir de linguagem natural, com deploy no ecossistema Vercel.
- Replit: ambiente cloud para criar, executar e publicar software.
- Cursor: editor de codigo com IA para acelerar desenvolvimento.

### Versao Minike

Nome sugerido: Minike App Builder.

Funcoes:

- Gerador de MVPs simples com prompt.
- Biblioteca de ferramentas prontas: calculadoras, validadores, geradores, conversores, formularios e dashboards.
- Modelos para CRM, agenda, ordem de servico, cardapio, loja, inscricao, landing page e area de membros.
- Exportacao para o ecossistema Minike com login, planos, pagamentos e afiliados.
- Publicacao em subdominio temporario.
- Integracao com WhatsApp oficial Meta para capturar lead e acionar atendimento.
- Painel para transformar ferramenta interna em produto vendavel.

### Como vender na campanha

- R$ 10: acesso a bastidores e enquetes sobre novas ferramentas.
- R$ 100: credito promocional para usar ferramentas premium.
- R$ 250 a R$ 500: licencas para equipes pequenas e prioridade em betas.
- R$ 1.000: prototipo guiado de uma ideia simples.
- R$ 2.000 a R$ 5.000: piloto de dashboard, ferramenta interna ou automacao comercial.
- R$ 10.000: MVP comercial com escopo fechado.
- R$ 100.000+: co-criacao de produto, codigo-fonte ou participacao em receita somente via contrato.

## 3. Criacao de video, voz, anuncios e campanhas

### Referencias de mercado

- Runway: IA para video, geracao visual e recursos criativos de midia.
- ElevenLabs: voz por IA, narracao, dublagem e audio para produtos digitais.
- Canva: design acessivel para nao designers, kits de marca e criativos de campanha.
- Figma: design colaborativo, prototipos e design system.
- Krea: geracao visual e experimentacao criativa com IA.

### Versao Minike

Nome sugerido: Minike Creative Studio.

Funcoes:

- Gerador de banners para campanhas, lojas, afiliados e vaquinhas.
- Criador de videos curtos para Instagram, TikTok, YouTube Shorts e anuncios.
- Vozes e roteiros para aulas, vendas, atendimento e promocao.
- Templates de post por nicho.
- Gerador de criativo para cada plano da campanha.
- Banco de assets Minike: logo, cores, mascotes, fundos, selos e chamadas.
- Publicacao assistida com copy em portugues e ingles.

### Como vender na campanha

- R$ 1: nome no mural e acesso a criativos publicos.
- R$ 10: pacote de wallpapers, badges e assets.
- R$ 100: pack de banners e templates premium.
- R$ 1.000: campanha personalizada com kit visual.
- R$ 10.000+: campanha co-branded para produto, loja ou comunidade.

## 4. Aprendizado, escolar, cursos e tutoria interativa

### Referencias de mercado

- Khanmigo/Khan Academy: tutor e assistente de ensino com IA.
- Duolingo: trilhas gamificadas, streaks, feedback rapido e praticas curtas.
- Brilliant: aprendizado interativo com foco em resolver problemas.
- Codecademy: trilhas praticas para aprender programacao fazendo.

### Versao Minike

Nome sugerido: Minike Tutor AI.

Funcoes:

- Tutor escolar em portugues e ingles.
- Conteudo por serie, materia e objetivo.
- Simulados, atividades, gabaritos e explicacoes passo a passo.
- Trilha de reforco escolar para Brasil e Estados Unidos.
- Cursos com desafios, projetos e certificados.
- Gamificacao com XP, MKC, medalhas, ranking e missao diaria.
- Area para professor montar atividade e acompanhar aluno.
- Modo inclusao: leitura facilitada, contraste, audio, fonte maior e explicacao simplificada.

### Como vender na campanha

- R$ 1: acesso Bronze de 30 dias a materiais basicos.
- R$ 10: acesso Prata de 90 dias com atividades e simulados selecionados.
- R$ 100: acesso Ouro de 180 dias com trilhas premium.
- R$ 1.000: plano familia/escola piloto por 360 dias.
- R$ 10.000+: laboratorio educacional para escola, ONG ou comunidade.

## 5. Automacoes, atendimento e CRM

### Referencias de mercado

- Zapier: automacoes entre aplicativos e fluxos de trabalho.
- Make: automacoes visuais e cenarios entre sistemas.
- n8n: automacoes flexiveis, self-hosted e integracoes customizadas.
- Airtable/Notion: organizacao de dados, bases internas, CRM leve e operacao colaborativa.

### Versao Minike

Nome sugerido: Minike Automations.

Funcoes:

- Conectar atendimento Meta com lojas, ERP, delivery, cursos, afiliados, pagamentos e campanhas.
- Criar automacoes por evento: novo lead, nova compra, carrinho abandonado, boleto vencido, ticket aberto, aluno inativo.
- Webhooks internos entre todos os subsites.
- Rotinas de follow-up por WhatsApp oficial.
- Painel de campanha para doador, membro, afiliado e investidor.
- Relatorios de conversao por canal.
- Automacoes white label para clientes e revendedores.

### Como vender na campanha

- R$ 100: acesso a templates de automacao simples.
- R$ 250 a R$ 500: licencas CNPJ, diagnostico e espaco de anuncio aprovado.
- R$ 1.000: implantacao guiada de funil WhatsApp + landing page.
- R$ 2.000 a R$ 5.000: automacao de captaÃ§Ã£o, atendimento, loja e relatorio.
- R$ 10.000: automacao completa para negocio parceiro.
- R$ 50.000+: rede regional de automacoes para varios clientes.
- R$ 100.000+: hub comercial com possivel revenue share sob contrato.

## 6. Comercio, criadores, afiliados e recorrencia

### Referencias de mercado

- Shopify/Nuvemshop: loja virtual, checkout, temas, apps e gestao de vendas.
- Hotmart/Kiwify: produtos digitais, checkout, afiliados e area de membros.
- Patreon/Catarse/Benfeitoria: apoio recorrente, comunidade e recompensas.
- Mercado Pago/Asaas: Pix, cartao, boleto, parcelamento, assinaturas e webhooks.

### Versao Minike

Nome sugerido: Minike Commerce Network.

Funcoes:

- Lojas white label em `lojas.minike.com.br` para clientes sem dominio.
- Checkout por Pix, cartao, boleto e parcelamento.
- Produtos fisicos, digitais, servicos, cursos e planos.
- Afiliados por produto e por subsite.
- Mural de membros e apoiadores.
- Planos com beneficios em todo o ecossistema.
- Cupons, cashback em MKC e campanhas por nicho.
- Upgrade para site proprio, atendimento oficial Meta e automacoes.

## 7. Ideias adicionais para o roadmap Minike

- Minike Universe: mapa visual do ecossistema com missoes, produtos, subdominios e oportunidades.
- Minike Quest: gamificacao unificada para ferramentas, cursos, escolar, games e afiliados.
- Minike Launchpad: area para comunidade votar nas proximas ferramentas e acompanhar entregas.
- Minike Marketplace: loja de templates, automacoes, sites, criativos, aulas, jogos e ferramentas.
- Minike Partner OS: painel para agencias e revendedores venderem o ecossistema inteiro.
- Minike Data Room: area privada para investidores com numeros, roadmap, documentos, propostas e contratos.
- Minike API Hub: API publica para ferramentas, conversores, atendimento, pagamentos e automacoes.
- Minike Local Heroes: programa para digitalizar pequenos negocios por cidade.
- Minike School Labs: pacotes para escolas, reforco, atividades, professores e pais.
- Minike Creator Fund: criadores recebem comissao por templates, aulas, jogos e ferramentas publicados.

## 8. Ordem sugerida de execucao

### Fase 1 - Conversao rapida

- Campanha publica.
- Mural de membros.
- Pix/checkout com webhook.
- Guia de investimento.
- Pagina de funcoes do imperio.
- Videos curtos apresentando cada produto.

### Fase 2 - Produto que vende sozinho

- Area de membros.
- Planos automaticos.
- Dashboard de pagamento.
- Afiliados simples.
- Templates de site/loja/campanha.
- Central de atendimento conectada ao funil.

### Fase 3 - Diferenciacao visual

- Sites 3D.
- Motion library.
- Criativos gerados por IA.
- Mascote/personagem Minike.
- Experiencias interativas para landing pages.

### Fase 4 - Plataforma

- App Builder.
- Automations.
- Marketplace.
- API Hub.
- Partner OS.
- Data Room para investidores.

## 9. Mensagem central para investidores

O Minike nao e um site unico. E uma rede de produtos digitais conectados: ferramentas geram trafego, campanhas geram comunidade, atendimento fecha vendas, lojas monetizam, cursos educam, games retÃªm, afiliados distribuem e automacoes escalam. O investimento entra para transformar essa rede em uma plataforma bilingue, mobile-first e pronta para pequenos negocios, criadores, escolas, agencias e investidores.


---

## Fonte: dossie-campanha-investidores-minike.md

# Dossie de Campanha e Investidores - Minike

Atualizado em 17/05/2026.

Este dossie organiza o que o Imperio Minike ja oferece, o que ainda esta em construcao, quais recompensas podem ser prometidas por faixa de apoio e qual estrutura de pagamento faz mais sentido.

## Regra de seguranca comercial

- Apoio publico de vaquinha deve prometer acesso, reconhecimento, bonus digital, comunidade, consultoria, site, white-label ou servico.
- Participacao societaria, revenue share, codigo-fonte exclusivo ou porcentagem da empresa devem ficar em proposta privada, com contrato, advogado e contador.
- O texto publico pode dizer "possibilidade de negociacao estrategica", mas nao deve vender equity automaticamente por Pix.

## Dados legais da empresa

No repositorio ainda nao encontrei o CNPJ real da empresa. A campanha ja foi preparada para ler estes campos do `.env`:

- `COMPANY_NAME`
- `COMPANY_CNPJ`
- `PIX_CHAVE`
- `PIX_TITULAR`

Quando esses campos estiverem preenchidos, `campanha.php` e `apoio.php` exibem os dados reais sem precisar mexer no codigo.

## Recomendacao de pagamento

Minha recomendacao pratica:

- Vaquinha publica e prova social: Vakinha, Catarse e Benfeitoria.
- Checkout principal e parcelamento no Brasil: Mercado Pago.
- Pix recorrente, cobranca, boleto, assinaturas e webhook: Asaas.
- Cursos, infoprodutos e afiliados digitais: Hotmart.
- Monetizze pode entrar depois, mas eu nao colocaria como primeira base do ecossistema.

O melhor caminho tecnico e:

1. Usuario escolhe plano na campanha.
2. Sistema cria cobranca no Asaas ou Mercado Pago.
3. Gateway envia webhook para o Minike.
4. O Minike salva pagamento confirmado.
5. O acesso e o mural sao atualizados automaticamente.

Nao recomendo depender de extrato manual do banco. Serve para comeco, mas nao escala.

## Sistema de apoiadores e painel de gestao

Implementado nesta fase:

- `campanha.php` registra apoiador, CPF/CNPJ, documento, plano, valor, mensagem e pedido especial.
- O pedido especial aceita qualquer solicitaÃ§Ã£o, desde que seja legal no Brasil, viÃ¡vel e alinhada com a marca.
- A tabela principal e `mk_campanha_membros`.
- O status inicial do pagamento e `pendente`.
- O sistema gera uma referencia `CAMP-AAAAMMDD-XXXXXX` para facilitar conferencia de Pix, comprovante e webhook.
- O ranking publico mostra apenas pagamentos confirmados.
- O painel administrativo fica em `admin/campanha.php`.
- O painel foi linkado no Painel Imperio e no Painel Supremo.

O painel permite:

- ver total registrado, pendentes, confirmados e valor confirmado
- rankear apoiadores por valor
- confirmar pagamento manualmente
- cadastrar referencia de Pix/gateway
- destacar apoiador
- acompanhar pedido especial
- marcar pedido como novo, em analise, aceito, em execucao, concluido ou recusado
- registrar resposta administrativa e notas internas

Verificacao de pagamento:

- Fase 1: Pix CNPJ `65.138.449/0001-66` com conferencia manual no painel.
- Fase 2: Asaas ou Mercado Pago com webhook.
- Webhook preparado: `webhooks/campanha-pagamento.php`.
- Seguranca do webhook: configurar `CAMPANHA_WEBHOOK_SECRET` no `.env`.

## Funcoes do Imperio Minike

### Minike principal

- Homepage comercial.
- Planos.
- Central do cliente.
- Moedas MKC.
- Apoio direto.
- Campanha de investidores.
- Rede de subdominios.
- Checkout e estrutura de pagamento.
- Painel mestre e diagnosticos.

### Ferramentas

- Catalogo de ferramentas por categoria.
- Busca inteligente por intencao.
- Sugestoes auxiliares.
- Ferramentas de texto.
- Calculadoras.
- Conversores.
- Geradores e validadores.
- Imagem.
- PDF.
- Desenvolvedor.
- SEO e marketing.
- Financeiro.
- Saude.
- Matematica.
- Data e hora.
- Negocios.
- Redes sociais.
- Educacao.
- Design.
- Redes e internet.
- Video com FFmpeg.
- WhatsApp.
- API publica planejada.
- Plano premium sem anuncios.

### Atendimento AI Meta

Fonte verificada: https://atendimento.minike.com.br/

Funcoes listadas no produto:

- WhatsApp Cloud API oficial.
- Instagram.
- Messenger.
- CRM.
- IA para respostas.
- Automacoes.
- Campanhas em massa.
- Templates.
- WhatsApp Flows.
- Relatorios.
- Socket.io em tempo real.
- White label.
- Demo instantanea.
- Configuracao Master.
- Conexao com token da Meta Cloud API.
- Palavras-chave.
- Horarios de atendimento.
- Base de conhecimento da empresa.
- Relatorios por atendente, canal e periodo.
- CSAT automatico.
- Conversas urgentes com prioridade.
- Bloqueio automatico de conversa em atendimento.
- Multiplos atendentes simultaneos.
- Respostas rapidas com atalhos.
- Notas internas.
- Historico completo.
- Rastreamento de Ads CTWA.
- API Keys.
- Modulo de revenda.
- Catalogo de produtos Meta.

Planos atuais do atendimento:

- Bronze: R$ 97/mes, 3 atendentes, 500 contatos, 3.000 mensagens/mes, 2 campanhas/mes.
- Prata: R$ 197/mes, 8 atendentes, 2.500 contatos, 15.000 mensagens/mes, Instagram, Messenger, white label.
- Ouro: R$ 397/mes, 20 atendentes, 10.000 contatos, 60.000 mensagens/mes, painel white label completo, revenda e relatorios avancados.

### Lojas

- Hub de lojas e mini-sites.
- Lojas em subdominio Minike para clientes sem dominio proprio.
- White-label sob contrato.
- Catalogo de produtos.
- Stories.
- Banners.
- Carrossel.
- Categorias.
- Painel do lojista.
- Planos.
- Personalizacao.
- Caminho futuro: frete, cupom, checkout, avaliacao, PDV, afiliados e estatisticas.

### Sites

- Criacao de sites profissionais.
- Landing pages.
- Portfolio.
- Simulador de preco.
- Templates.
- Planos de hospedagem.
- SEO.
- Dicas e novidades.
- FAQ.
- Painel para gerenciar site.
- Caminho futuro: builder completo, dominio, SSL, analytics, backup e publicacao.

### Cursos

- Hub de conhecimento.
- Categorias de cursos.
- Tecnologia.
- Design.
- Marketing.
- Negocios.
- Idiomas.
- Produtividade.
- Cards de cursos com preco.
- Caminho futuro: aulas completas, certificados, progresso, provas, trilhas, mentorias e banco persistente.

### Escolar

- Hub educacional.
- Curriculo BR/US.
- Materias por fase.
- Trilhas de reforco PT/EN.
- Aulas prontas e atividades.
- Caminho futuro: paginas por serie, simulados, gabaritos, certificacao, progresso, painel de aluno e professor.

### Games

- Arena de jogos HTML5.
- Catalogo por genero.
- Jogos classicos e casuais.
- MKC Coins planejado.
- Ranking planejado.
- Conquistas planejadas.
- Skins e loja interna planejadas.
- Ads apenas em abertura/vitrine, nao dentro da jogabilidade.

### Softwares

- Softwares prontos e sob medida.
- Ponto eletronico.
- CRM Lite.
- Agenda Pro.
- OS Service.
- API Manager.
- Automacoes.
- Integracoes.
- Linha Meta 999 para revenda.
- Caminho futuro: trial, licencas, comparativos, pagina por produto, revendedores e biblioteca de 999 SaaS.

### Delivery

- Cardapio digital.
- Carrinho.
- Checkout.
- Pedido via WhatsApp.
- Comanda/PDV.
- Caminho futuro: cozinha, motoboy, rota, fidelidade, cupons, multiunidade, cashback, estoque e ranking de entregadores.

### ERP

- Base de gestao empresarial.
- Empresas.
- Usuarios.
- Produtos.
- Estoque.
- Financeiro.
- Clientes.
- Fornecedores.
- Caminho futuro: NF-e, relatorios avancados, integracao forte com loja, delivery e ponto.

### Ads e afiliados

- Rede interna de anuncios.
- Espacos de publicidade.
- Vakinha com beneficios digitais.
- Afiliacao cruzada.
- API para parceiros.
- Comissoes.
- Saque via Pix.
- Caminho futuro: relatorios, frequencia por usuario, prioridade, rotacao e automacao total.

## Tabela de investimento e promessas

| Faixa | Nome | Duracao | Promessa publica segura |
|---|---|---:|---|
| R$ 1 / US$ 1 | Bronze | 30 dias | CPF: 1 acesso Bronze, nome no mural, badge, acesso antecipado e voto simples |
| R$ 5 / US$ 5 | Semente | 45 dias | CPF: destaque leve no mural, bastidores e voto em uma prioridade |
| R$ 10 / US$ 10 | Prata | 90 dias | CPF: 1 licenca Prata, area de membros, pack digital, enquetes e bastidores |
| R$ 25 / US$ 25 | Impulso | 120 dias | CPF/CNPJ: cupom de teste, badge especial e prioridade em sorteios de revisao |
| R$ 50 / US$ 50 | Turbo | 150 dias | CPF/CNPJ: pack premium, secao Turbo e divulgacao leve para CNPJ |
| R$ 100 / US$ 100 | Ouro | 180 dias | CPF/CNPJ: acesso premium, 2 licencas para CNPJ, revisao de presenca digital e prioridade |
| R$ 250 / US$ 250 | Premium | 240 dias | CNPJ: 3 licencas, mini diagnostico e anuncio interno rotativo por ate 15 dias |
| R$ 500 / US$ 500 | Fundador | 300 dias | CNPJ: 5 licencas, reuniao curta, piloto priorizado e anuncio interno por ate 30 dias |
| R$ 1.000 / US$ 1.000 | Diamante | 360 dias | CNPJ: ate 10 licencas, site customizado, acesso personalizado e banner por ate 45 dias |
| R$ 2.000 / US$ 2.000 | Arquiteto | 360 dias | CNPJ: ate 15 licencas, landing/site com funil, mapa de automacoes e divulgacao por ate 60 dias |
| R$ 5.000 / US$ 5.000 | Guardiao | 360 dias | CNPJ: ate 25 licencas, pacote site + funil + atendimento inicial e presenca por ate 90 dias |
| R$ 10.000 / US$ 10.000 | Imperio | 360 dias | CNPJ: ate 50 licencas, white-label, atendimento Meta, co-branding, cotas de anuncio e proposta comercial |
| R$ 50.000 / US$ 50.000 | Expansao | 360 dias | Implantacao regional, acesso vitalicio promocional a modulos selecionados e prioridade de produto |
| R$ 100.000+ / US$ 100.000+ | Conselho Fundador | contrato | Negociacao privada de participacao, revenue share, codigo-fonte ou produto dedicado |

## Parcelamento recomendado

- R$ 1 a R$ 50: pagamento unico por Pix/cartao.
- R$ 100: Pix, cartao ou 2x.
- R$ 250: Pix, cartao ou 3x.
- R$ 500: Pix, cartao, boleto ou 5x.
- R$ 1.000: Pix, cartao, boleto ou 10x/12x.
- R$ 2.000: entrada + 6x a 12x, com escopo claro.
- R$ 5.000: entrada + parcelas por marco de entrega.
- R$ 10.000: proposta formal, contrato simples, entrada + parcelas.
- R$ 50.000: contrato, milestones e cronograma.
- R$ 100.000+: contrato de investimento/parceria, due diligence e revisao juridica.

## Ideias do plano Minike ainda nao implementadas por completo

### Ferramentas

- Chegar a 999+ ferramentas.
- Completar suite PDF no nivel iLovePDF/PDF24.
- OCR, reparar PDF, comparar PDF, assinar PDF, web to PDF e extrair imagens.
- Remocao de fundo tipo remove.bg.
- Upscale, colorizacao, batch processing e templates.
- API paga por token.

### Games

- 999+ jogos.
- Gerador automatico de games.
- Ranking global.
- Perfil de jogador.
- MKC universal.
- Badges.
- Loja interna.
- Skins.
- Trofeus.
- Multiplayer.

### Cursos

- 999+ cursos.
- Gerador de aulas.
- Trilha por carreira.
- Certificado verificavel.
- Mentorias.
- Comunidade.
- Projetos.
- Quizzes.
- Progresso.
- Conteudo PT/EN com preco BRL/USD.

### Escolar

- 999+ temas.
- 9999 atividades.
- Paginas por ano/serie BR e EUA.
- Simulados.
- Gabaritos.
- Certificacao.
- Dashboard aluno/professor.
- Trilhas inclusivas para TDAH, dislexia, autismo, Libras/ASL e reforco cognitivo.

### Lojas

- Templates de loja.
- Importacao de produtos.
- Checkout.
- Frete.
- Cupom.
- Avaliacao.
- PDV.
- Afiliados.
- Estatisticas do lojista.

### Delivery

- Cozinha/KDS.
- Motoboy.
- Rota.
- Pedidos externos.
- Fidelidade.
- Estoque.
- Comissao.
- Multiunidade.
- Cashback.

### Atendimento

- Fluxo completo de tickets.
- SLA.
- Chatbot mais profundo.
- Mais integracoes.
- Historico comercial avancado.
- Base de conhecimento refinada.
- Pagina comercial integrada ao resto da campanha.

### Sites

- Builder.
- Dominio.
- SSL.
- Publicacao.
- Analytics.
- Backup.
- White-label para revendedores.

### Ads

- Rotacao inteligente.
- Frequencia por usuario.
- Relatorio.
- API externa.
- Prioridade por campanha.
- Cross-sell completo.

### Admin e monetizacao

- Painel admin para editar precos.
- Cupons.
- Integracao real de pagamentos.
- Webhooks.
- Liberacao automatica de acesso.
- Relatorios de receita.
- Alertas de tabelas/colunas faltantes.

## Novas ideias para vender melhor

### R$ 1 a R$ 100

- Mural publico com filtro por plano.
- Certificado digital de apoiador.
- Sorteio mensal de revisao de site.
- Votacao de qual ferramenta construir.

### R$ 1.000

- "Site de Fundador" dentro de `lojas.minike.com.br` ou `sites.minike.com.br`.
- Acesso de 1 ano ao atendimento Meta no modo starter, com consumo e manutencao cobrados conforme uso.
- Mentoria de implantacao de funil WhatsApp.
- Selo "Parceiro Fundador Minike".

### R$ 10.000

- Produto white-label por nicho.
- Setup completo de atendimento WhatsApp oficial.
- Loja + site + atendimento + funil.
- Relatorio mensal de evolucao do projeto.
- Direito de votar em roadmap de produto.

### R$ 50.000

- Pacote cidade/regiao: lojas, sites e atendimento para comerciantes locais.
- Revenda Minike com condicoes especiais.
- Acesso vitalicio promocional a um conjunto fechado de modulos.
- Participacao em receita de projeto especifico, por contrato.

### R$ 100.000+

- Conselho fundador.
- Produto dedicado.
- Codigo-fonte de modulo especifico, sob licenca.
- Revenue share ou equity, apenas com estrutura juridica.
- Expansao internacional PT/EN/ES.

## Onde postar e como adaptar

### Vakinha

Use copy emocional e direta. Foque em:

- "Ajude uma software house brasileira a competir com gigantes".
- "A partir de R$ 1 voce entra no mural do Imperio Minike".
- "O dinheiro vira servidor, ferramenta, atendimento e produto real".

### Catarse

Use projeto por recompensa. Foque em:

- tiers bem definidos.
- prazo de entrega.
- videos e atualizacoes.
- recompensas digitais.

### Benfeitoria

Use causa, comunidade e recorrencia. Foque em:

- impacto local em Guaramirim/SC.
- ferramentas gratuitas para pessoas e pequenos negocios.
- educacao, lojas e atendimento para quem nao consegue pagar caro.

### LinkedIn

Use pitch de investimento:

- "Ecossistema SaaS + ferramentas + WhatsApp oficial Meta".
- "Produtos integrados em vez de ferramentas isoladas".
- "Oportunidade de white-label e distribuicao regional".

### WhatsApp

Use mensagem curta:

> Estou abrindo uma campanha de apoiadores e investidores para o Minike, um ecossistema brasileiro com ferramentas, lojas, cursos, games, delivery, ERP e atendimento via WhatsApp oficial Meta. Da para apoiar com R$ 1 ou conversar sobre parceria grande. Quer que eu te mande a vitrine?

## Referencias de inovacao e versao Minike

Arquivo detalhado criado: `mapa-inovacao-experiencias-minike.md`.

### Sites, 3D e movimento

- Referencias: Framer, Webflow, Dora, Spline, Rive e LottieFiles.
- Versao Minike: `Minike Sites 3D` + `Minike Motion`, com builder de sites, blocos 3D, templates por nicho, animacoes leves, publicacao em subdominio e upsell para dominio proprio.
- Promessa por investimento: de voto em templates nos planos baixos ate laboratorio privado de sites interativos nos aportes estrategicos.

### Apps e ferramentas com IA

- Referencias: Lovable, Bolt, v0, Replit e Cursor.
- Versao Minike: `Minike App Builder`, um gerador de MVPs, dashboards e ferramentas internas a partir de prompts, sempre conectado ao login, pagamentos, afiliados e WhatsApp oficial Meta.
- Promessa por investimento: prototipo simples em R$ 1.000, MVP comercial em R$ 10.000 e co-criacao contratual acima de R$ 100.000.

### Criativos, video, voz e anuncios

- Referencias: Runway, ElevenLabs, Canva, Figma e Krea.
- Versao Minike: `Minike Creative Studio`, com gerador de banners, videos curtos, vozes, roteiros, posts, criativos de campanha e kits de marca em PT/EN.
- Promessa por investimento: pack digital nos planos baixos, campanha visual personalizada em R$ 1.000 e campanha co-branded nos aportes maiores.

### Educacao interativa

- Referencias: Khanmigo/Khan Academy, Duolingo, Brilliant e Codecademy.
- Versao Minike: `Minike Tutor AI`, com trilhas escolares BR/US, simulados, atividades, gabaritos, explicacoes passo a passo, gamificacao e dashboard para professor/responsavel.
- Promessa por investimento: acesso Bronze/Prata/Ouro para comunidade, piloto familia/escola em R$ 1.000 e laboratorio educacional em R$ 10.000+.

### Automacoes e operacao

- Referencias: Zapier, Make, n8n, Airtable e Notion.
- Versao Minike: `Minike Automations`, conectando atendimento Meta, lojas, ERP, delivery, cursos, afiliados, pagamentos, campanhas e CRM.
- Promessa por investimento: funil WhatsApp + landing page em R$ 1.000, automacao completa em R$ 10.000 e rede regional de automacoes em R$ 50.000+.

### Comercio, assinaturas e comunidade

- Referencias: Shopify, Nuvemshop, Hotmart, Kiwify, Patreon, Catarse, Benfeitoria, Mercado Pago e Asaas.
- Versao Minike: `Minike Commerce Network`, com lojas white label, checkout, produtos fisicos/digitais, cursos, afiliados, MKC, cupons, cashback e campanhas.
- Promessa por investimento: mural, acesso e comunidade nos planos baixos; loja/site/atendimento/funil nos planos altos.

## Fontes oficiais consultadas

- Atendimento Minike: https://atendimento.minike.com.br/
- Vakinha: https://www.vakinha.com.br/
- Catarse: https://suporte.catarse.me/
- Benfeitoria: https://benfeitoria.com/
- Asaas webhooks: https://docs.asaas.com/docs/webhook-para-cobrancas
- Asaas Pix automatico: https://docs.asaas.com/docs/pix-automatico
- Mercado Pago Pix: https://www.mercadopago.com.br/ferramentas-para-vender/aceitar-pix
- Mercado Pago webhooks: https://www.mercadopago.com.br/blog/webhooks-notificacoes-pagamento-tempo-real
- Hotmart assinaturas: https://help.hotmart.com/pt-br/article/208424858/como-funciona-um-plano-de-assinatura-
- CVM: https://conteudo.cvm.gov.br/
- Framer: https://www.framer.com/
- Webflow: https://webflow.com/
- Spline: https://spline.design/
- Rive: https://rive.app/
- LottieFiles: https://lottiefiles.com/
- Vercel v0: https://vercel.com/docs/v0
- Bolt: https://support.bolt.new/building
- Runway Gen-4: https://runwayml.com/research/introducing-runway-gen-4
- Khanmigo: https://www.khanacademy.org/khan-labs
- Brilliant: https://brilliant.org/
- Zapier: https://zapier.com/workflows


---

## Fonte: guia-captacao-investimento.md

# Guia de CaptaÃ§Ã£o Minike

Este arquivo reÃºne a estratÃ©gia para campanhas, vaquinhas e captaÃ§Ã£o de investimentos do ecossistema Minike.

## Objetivo

- Atrair apoios pequenos, mÃ©dios e grandes.
- Transformar a campanha em vitrine de confianÃ§a.
- Separar bem doaÃ§Ã£o, recompensa, patrocÃ­nio e investimento estratÃ©gico.
- Falar com brasileiros e com pÃºblico internacional.

## Regra prÃ¡tica

- Valores pequenos e mÃ©dios: use **recompensas digitais**, acesso temporÃ¡rio, Ã¡rea de membros, bÃ´nus e reconhecimento pÃºblico.
- Valores maiores: use **proposta privada**, contrato, white-label, consultoria, manutenÃ§Ã£o e suporte.
- ParticipaÃ§Ã£o societÃ¡ria, revenue share ou qualquer estrutura parecida: trate como assunto **privado e jurÃ­dico**, nunca como promessa automÃ¡tica na pÃ¡gina pÃºblica.

## Estrutura recomendada de planos

Use a escada abaixo em vaquinhas, landing pages, checkout e propostas. Ela atende CPF e CNPJ sem misturar doaÃ§Ã£o simples com sociedade.

| Valor | Plano | PÃºblico | BenefÃ­cio principal |
|---:|---|---|---|
| R$ 1 / US$ 1 | Bronze | CPF | 30 dias, mural, badge e acesso Bronze individual |
| R$ 5 / US$ 5 | Semente | CPF | 45 dias, bastidores, destaque leve e voto |
| R$ 10 / US$ 10 | Prata | CPF | 90 dias, Ã¡rea de membros, pack digital e 1 licenÃ§a Prata |
| R$ 25 / US$ 25 | Impulso | CPF/CNPJ | 120 dias, cupom de teste e prioridade em sorteios |
| R$ 50 / US$ 50 | Turbo | CPF/CNPJ | 150 dias, pack premium e divulgaÃ§Ã£o leve para CNPJ |
| R$ 100 / US$ 100 | Ouro | CPF/CNPJ | 180 dias, revisÃ£o digital e atÃ© 2 licenÃ§as para CNPJ |
| R$ 250 / US$ 250 | Premium | CNPJ | 240 dias, 3 licenÃ§as, mini diagnÃ³stico e anÃºncio de atÃ© 15 dias |
| R$ 500 / US$ 500 | Fundador | CNPJ | 300 dias, 5 licenÃ§as, reuniÃ£o curta e anÃºncio de atÃ© 30 dias |
| R$ 1.000 / US$ 1.000 | Diamante | CNPJ | 360 dias, atÃ© 10 licenÃ§as, site customizado e banner de atÃ© 45 dias |
| R$ 2.000 / US$ 2.000 | Arquiteto | CNPJ | AtÃ© 15 licenÃ§as, landing/site com funil e divulgaÃ§Ã£o de atÃ© 60 dias |
| R$ 5.000 / US$ 5.000 | GuardiÃ£o | CNPJ | AtÃ© 25 licenÃ§as, pacote site + funil + atendimento inicial e presenÃ§a de atÃ© 90 dias |
| R$ 10.000 / US$ 10.000 | ImpÃ©rio | CNPJ/parceiro | AtÃ© 50 licenÃ§as, white-label, atendimento Meta, co-branding e proposta comercial |

### Faixas privadas acima da campanha

- R$ 50.000 / US$ 50.000: ExpansÃ£o regional, parceria de cidade/nicho, acesso vitalÃ­cio promocional a mÃ³dulos selecionados e contrato de receita por projeto.
- R$ 100.000+ / US$ 100.000+: Conselho Fundador, negociaÃ§Ã£o privada de participaÃ§Ã£o, revenue share, cÃ³digo-fonte ou produto dedicado com advogado e contador.

### Regra para anÃºncios prometidos

- Nunca prometer anÃºncio sem aprovaÃ§Ã£o editorial.
- Deixar claro que anÃºncio interno nÃ£o garante venda, lead ou resultado.
- Usar espaÃ§os como pÃ¡ginas de apoiadores, banners internos, newsletters, posts, rodapÃ©s de campanha e vitrines de parceiros.
- Priorizar CNPJ, negÃ³cios locais, escolas, lojas, criadores e parceiros alinhados com a marca.

## Onde captar

### 1. Vakinha

Use quando o objetivo for:

- doaÃ§Ã£o direta
- campanha emocional
- meta pÃºblica com foco em visibilidade
- mobilizaÃ§Ã£o rÃ¡pida

Por que funciona:

- a pÃ¡gina pode ganhar destaque com interaÃ§Ãµes
- a plataforma destaca campanhas com apoio da comunidade
- hÃ¡ recursos para divulgaÃ§Ã£o, equipes e anÃºncios

### 2. Catarse

Use quando o objetivo for:

- projeto com recompensa clara
- produto, curso, conteÃºdo ou sÃ©rie
- comunidade recorrente

Por que funciona:

- o projeto define quanto quer arrecadar
- oferece recompensas em troca
- a pÃ¡gina do projeto concentra histÃ³ria, meta e contrapartidas

### 3. Benfeitoria

Use quando o objetivo for:

- crowdfunding de projeto
- recorrÃªncia mensal
- campanhas com forte apelo comunitÃ¡rio
- matchfunding com parceiro

Por que funciona:

- trabalha com recompensas por faixa de contribuiÃ§Ã£o
- permite recorrÃªncia
- Ã© muito forte para campanhas com causa e comunidade

### 4. WhatsApp oficial / Meta

Use quando o objetivo for:

- nutrir leads
- responder investidores
- enviar proposta
- fechar reuniÃ£o

Por que funciona:

- contato direto
- follow-up rÃ¡pido
- excelente para qualificaÃ§Ã£o de investidores e patrocinadores

## O que oferecer

### PÃºblico geral

- acesso antecipado
- badge e mural
- arquivos digitais
- votaÃ§Ã£o em prioridades
- comunidades e grupos fechados

### Pequenos apoiadores

- reconhecimento
- conteÃºdo exclusivo
- wallpapers
- packs e templates

### MÃ©dios apoiadores

- acesso premium
- consultoria breve
- revisÃ£o de pÃ¡gina
- prioridade de suporte

### Grandes apoiadores

- site customizado
- white-label
- co-branding
- reuniÃ£o estratÃ©gica
- proposta sob contrato

### Investidor Ã¢ncora

- expansÃ£o de produto
- parceria operacional
- participaÃ§Ã£o em roadmap
- possibilidade de estrutura societÃ¡ria ou revenue share, sempre com revisÃ£o jurÃ­dica

## Como escrever a campanha

1. Explique o problema de forma simples.
2. Mostre o que jÃ¡ existe.
3. Mostre para onde o dinheiro vai.
4. Mostre os planos de apoio.
5. Mostre os nomes dos membros.
6. Publique atualizaÃ§Ãµes frequentes.
7. Responda comentÃ¡rios e mensagens rÃ¡pido.
8. Reforce prova social e transparÃªncia.

## Como pensar Brasil + gringo

- Tenha a pÃ¡gina em portuguÃªs e inglÃªs.
- Mostre BRL como moeda principal.
- Mostre USD como faixa internacional.
- Use copy curta e objetiva.
- Mostre confianÃ§a visual, nÃºmeros e cases.
- Para grandes aportes, ofereÃ§a call privada e contrato.

## Canais de busca de investimento

- comunidades de empreendedores
- grupos de tecnologia e software
- redes de apoio local
- clientes antigos
- parceiros comerciais
- investidores-anjo
- aceleradoras
- hubs de inovaÃ§Ã£o
- redes de creators e afiliados
- campanhas de doaÃ§Ã£o com meta pÃºblica

## Cuidados legais

- NÃ£o prometa participaÃ§Ã£o societÃ¡ria como se fosse doaÃ§Ã£o comum.
- NÃ£o prometa ganho financeiro em campanhas de recompensa.
- Se houver equity, participaÃ§Ã£o ou revenue share, faÃ§a proposta privada.
- Antes de qualquer oferta estruturada, valide com advogado e contador.
- Para crowdfunding regulado, use plataforma adequada e respeite as regras do setor.

## Checklist antes de publicar

- PÃ¡gina bilÃ­ngue pronta
- Tiers definidos
- Murais e prova social ativos
- BotÃµes para Vakinha, Catarse, Benfeitoria e WhatsApp
- Texto claro de uso dos recursos
- Aviso sobre manutenÃ§Ã£o e mensalidades
- Modelo de contato para grandes aportes
- RevisÃ£o jurÃ­dica bÃ¡sica

## Links oficiais de referÃªncia

- Vakinha: https://www.vakinha.com.br/como-funciona/vakinha
- Vakinha AnÃºncios: https://www.vakinha.com.br/como-funciona/vakinha-anuncios
- Vakinha CoraÃ§Ãµes: https://www.vakinha.com.br/duvidas-frequentes/como-funcionam-os-coracoes-do-vakinha
- Catarse: https://suporte.catarse.me/hc/pt-br/articles/201982466-O-que-%C3%A9-e-como-funciona-o-Catarse
- Catarse Recompensas: https://suporte.catarse.me/hc/pt-br/articles/360023812472-O-que-s%C3%A3o-as-Recompensas
- Benfeitoria: https://benfeitoria.com/termos-de-uso
- Benfeitoria FAQ: https://parcerias.benfeitoria.com/faq
- CVM crowdfunding / investimento participativo: https://conteudo.cvm.gov.br/

## Minha recomendaÃ§Ã£o prÃ¡tica para o Minike

- **Base de cobranÃ§a e verificaÃ§Ã£o de pagamento:** Asaas.
  - Motivos: Pix, QR Code, cobranÃ§a recorrente e webhooks para atualizar o acesso automaticamente.
- **Checkout com cartÃ£o e parcelamento:** Mercado Pago.
  - Motivos: webhooks, Pix, link de pagamento e forte aceitaÃ§Ã£o no Brasil.
- **Cursos, assinaturas de conteÃºdo e afiliados digitais:** Hotmart.
  - Motivos: checkout, assinatura e ecossistema de afiliados jÃ¡ pronto.
- **Campanha de vaquinha e prova social:** Vakinha, Catarse e Benfeitoria.
  - Motivos: vitrine pÃºblica, recompensas e comunidade.

## Painel e verificaÃ§Ã£o de pagamentos

ImplementaÃ§Ã£o atual:

- Cadastro pÃºblico em `campanha.php`.
- Registro salvo em `mk_campanha_membros`.
- Status inicial: `pendente`.
- ReferÃªncia gerada: `CAMP-AAAAMMDD-XXXXXX`.
- Pix principal: CNPJ `65.138.449/0001-66`.
- GestÃ£o administrativa: `admin/campanha.php`.
- Webhook preparado: `webhooks/campanha-pagamento.php`.

Fluxo inicial manual:

1. Apoiador preenche o formulÃ¡rio da campanha.
2. Sistema mostra a referÃªncia do apoio.
3. Apoiador paga via Pix CNPJ e envia comprovante com referÃªncia.
4. Admin abre `admin/campanha.php`.
5. Admin confere valor, nome e referÃªncia.
6. Admin muda `pagamento_status` para confirmado.
7. Apoiador entra no ranking pÃºblico.

Fluxo profissional recomendado:

1. Conectar Asaas ou Mercado Pago.
2. Criar cobranÃ§a com `externalReference` igual Ã  referÃªncia `CAMP-...`.
3. Configurar webhook para `https://minike.com.br/webhooks/campanha-pagamento.php`.
4. Definir `CAMPANHA_WEBHOOK_SECRET` no `.env`.
5. Enviar o segredo no header `X-MINIKE-SECRET` ou no parÃ¢metro `?secret=`.
6. Quando o gateway aprovar, o Minike muda o status automaticamente.

## O que eu nÃ£o faria

- NÃ£o dependeria de conferÃªncia manual de extrato bancÃ¡rio para liberar acesso.
- NÃ£o colocaria participaÃ§Ã£o societÃ¡ria ou promessa de retorno financeiro na pÃ¡gina pÃºblica de doaÃ§Ã£o.
- NÃ£o misturaria campanha emocional com contrato de investimento.

## Como organizar os dados no site

- `COMPANY_NAME` no `.env` para nome legal exibido.
- `COMPANY_CNPJ` no `.env` para mostrar razÃ£o social/cadastro.
- `PIX_TITULAR` no `.env` para o titular do recebimento.
- `PIX_CHAVE` no `.env` para a chave Pix.
- `MERCADO_PAGO_ACCESS_TOKEN`, `MERCADO_PAGO_PUBLIC_KEY`, `ASAAS_API_KEY` e similares para integraÃ§Ãµes.

## Resumo de execuÃ§Ã£o

- Comece com a campanha pÃºblica.
- Direcione apoio pequeno para recompensa.
- Direcione apoio mÃ©dio para acesso e comunidade.
- Direcione apoio grande para white-label e parceria.
- Direcione investimento alto para conversa privada e contrato.


---

## Fonte: .agent.md

---
name: Minike Empire Builder
summary: Agente focado no ecossistema Minike para criar soluÃ§Ãµes incrÃ­veis, monetizar rÃ¡pido e unificar todos os subdomÃ­nios.
---

# Minike Empire Builder

## Quem Ã© este agente
VocÃª Ã© um construtor de impÃ©rio digital para o projeto Minike. Seu foco Ã© criar algo incrÃ­vel, gerar receita e transformar o ecossistema em um negÃ³cio auto-sustentÃ¡vel.

## Perfil
- Criativo e orientado a produto
- Mestre em programaÃ§Ã£o web PHP/JS
- Focado em monetizaÃ§Ã£o: ads, vendas, planos, cross-sell
- Capaz de usar o conteÃºdo dos sites existentes como fonte de verdade
- Trabalha com mÃºltiplos subdomÃ­nios e integram fluxo comercial

## Quando usar
Use este agente para qualquer tarefa no workspace Minike que envolva:
- criaÃ§Ã£o de conteÃºdo comercial
- geraÃ§Ã£o de pÃ¡ginas de produto, vendas e planos
- unificaÃ§Ã£o de subsites e bancos de dados
- implementaÃ§Ã£o de sistemas de pagamento, afiliados ou ads
- modernizaÃ§Ã£o de tema e experiÃªncia do usuÃ¡rio

## InstruÃ§Ãµes principais
1. Priorize dinheiro e valor comercial acima de ajustes estÃ©ticos menores.
2. Consulte `planominike.md` e todos os subdomÃ­nios para entender o ecossistema antes de editar.
3. Use o banco unificado `u340626637_minike` e `.env` para credenciais.
4. Procure integrar `softwares`, `ferramentas`, `games`, `cursos`, `escolar`, `lojas` e `ads` em uma experiÃªncia coesa.
5. Crie upsells, planos premium, vendas internas e cross-sell entre subdomÃ­nios.
6. Automatize tarefas de setup quando possÃ­vel (auto-criaÃ§Ã£o de tabelas, fallback de env, mensagens de erro amigÃ¡veis).
7. Sempre documente no plano ou em arquivos de projeto onde mudanÃ§as de arquitetura foram feitas.

## Ferramentas preferidas
- `file_search` para localizar arquivos importantes
- `grep_search` para encontrar padrÃµes de cÃ³digo e conexÃµes de banco
- `read_file` para revisar implementaÃ§Ãµes existentes
- `create_file` e `replace_string_in_file` para adicionar ou padronizar cÃ³digo
- `run_in_terminal` para executar verificaÃ§Ãµes de arquivo ou criar arquivos quando necessÃ¡rio

## O que evitar
- Evite mudanÃ§as grandes de arquitetura sem primeiro propor e documentar.
- NÃ£o use APIs externas desnecessÃ¡rias ou complexas se nÃ£o houver benefÃ­cio claro para monetizaÃ§Ã£o.
- NÃ£o deixe credenciais hardcoded no cÃ³digo.

## Exemplo de prompt ideal
- "Use a estrutura atual do Minike para criar uma landing page de vendas para o subdomÃ­nio `softwares` e adicionar um plano premium com preÃ§os BRL/USD."
- "Audite `config.php` em todos os subdomÃ­nios e padronize para usar `includes/db.php` e `.env`." 
- "Crie um painel simples de administraÃ§Ã£o para gerenciar preÃ§os, anÃºncios internos e afiliados no ecossistema Minike."

## ObservaÃ§Ã£o
Se faltar informaÃ§Ã£o sobre um fluxo de pagamento ou gerador de templates, busque no workspace atual e use os arquivos de site existentes do Minike como guia. Se ainda assim faltar, solicite o caminho exato ou os arquivos adicionais do projeto.


---

## Fonte: PARA_FELIPE.md

# PARA FELIPE

Este arquivo foi criado para evitar link quebrado no painel supremo.

Consulte planominike.md para o plano principal.


---

## Fonte: _missing_links_after_fix.csv

```csv
"source","link","target"
"admin_dashboard.php","' . $img . '","' . $img . '"
"admin_dashboard.php","' . $link . '","' . $link . '"
"admin_dashboard.php","<?= htmlspecialchars($ad_desta['imagem_url']) ?>","<"
"admin_dashboard.php","<?= htmlspecialchars($ad['imagem_url']) ?>","<"
"admin_dashboard.php","<?= htmlspecialchars($af['url_rel']) ?>","<"
"admin_dashboard.php","<?= htmlspecialchars($btn['url']) ?>","<"
"admin\ecossistema.php","<?= mk_admin_h($site['url']) ?>","admin\<"
"admin\multi-domain.php","<?php echo $domain['url']; ?>","admin\<"
"admin\painel_supremo.php","<?= $l[1] ?>","admin\<"
"ads\ad_footer.php",") !== false && stripos($script_seguro,","ads\) !== false && stripos($script_seguro,"
"ads\ad_header.php",") !== false && stripos($script_seguro,","ads\) !== false && stripos($script_seguro,"
"ads\ad_sidebar.php",") !== false && stripos($script_seguro,","ads\) !== false && stripos($script_seguro,"
"ads\config.php","'.$link_hostinger.'","ads\'.$link_hostinger.'"
"ads\engine.php","' . htmlspecialchars($ad['url'], ENT_QUOTES, 'UTF-8') . '","ads\' . htmlspecialchars($ad['url'], ENT_QUOTES, 'UTF-8') . '"
"ads\engine.php","' . htmlspecialchars($item['url'], ENT_QUOTES, 'UTF-8') . '","ads\' . htmlspecialchars($item['url'], ENT_QUOTES, 'UTF-8') . '"
"bio\index.php","'/bio/?u='+slug","bio\'\bio\index.php"
"bio\index.php","<?= htmlspecialchars($bio_data['foto_url'], ENT_QUOTES, 'UTF-8') ?>","bio\<"
"bio\index.php","<?= htmlspecialchars($lk['url'], ENT_QUOTES, 'UTF-8') ?>","bio\<"
"bio\index.php","<?= htmlspecialchars($url, ENT_QUOTES, 'UTF-8') ?>","bio\<"
"checkout.php","<?= htmlspecialchars($pix_data['pix_qrcode_img']) ?>","<"
"cursos\admin\cursos.php","<?= $c['capa'] ?: 'https://placehold.co/100x100/1e293b/64748b?text=MK' ?>","cursos\admin\<"
"cursos\admin\cursos.php","${cIn.value}","cursos\admin\${cIn.value}"
"cursos\admin\index.php","usuarios_edit.php?id=<?= $aluno['id'] ?>","cursos\admin\usuarios_edit.php"
"cursos\admin\monetizze.php","<?= $img ?>","cursos\admin\<"
"cursos\admin\monetizze.php","${midiaIn.value}","cursos\admin\${midiaIn.value}"
"cursos\detalhes.php","' . htmlspecialchars($embed, ENT_QUOTES, 'UTF-8') . '","cursos\' . htmlspecialchars($embed, ENT_QUOTES, 'UTF-8') . '"
"cursos\detalhes.php","' . htmlspecialchars($url, ENT_QUOTES, 'UTF-8') . '","cursos\' . htmlspecialchars($url, ENT_QUOTES, 'UTF-8') . '"
"cursos\detalhes.php","assistir.php?curso_id=<?= $id ?>","cursos\assistir.php"
"cursos\detalhes.php","checkout.php?id=<?= $id ?>","cursos\checkout.php"
"cursos\index.php","<?= $capaHot ?>","cursos\<"
"cursos\index.php","<?= $capaMon ?>","cursos\<"
"cursos\index.php","<?= htmlspecialchars($capaPreview, ENT_QUOTES, 'UTF-8') ?>","cursos\<"
"cursos\index.php","<?= htmlspecialchars($curso_link, ENT_QUOTES, 'UTF-8') ?>","cursos\<"
"cursos\meu-painel.php","<?= $c['capa'] ?: 'https://placehold.co/600x400/1e293b/64748b?text=Curso' ?>","cursos\<"
"cursos\meu-painel.php","<?= $sug['capa'] ?>","cursos\<"
"cursos\meu-painel.php","assistir.php?curso_id=<?= $c['id'] ?>","cursos\assistir.php"
"cursos\player.php","<?= $link ?>","cursos\<"
"cursos\player.php","<?= htmlspecialchars($link, ENT_QUOTES, 'UTF-8') ?>","cursos\<"
"cursos\produto.php","<?= $embed ?>","cursos\<"
"cursos\produto.php","<?= $imgSim ?>","cursos\<"
"cursos\produto.php","<?= $logo_garantia ?>","cursos\<"
"cursos\produto.php","<?= $produto['midia_url'] ?>","cursos\<"
"cursos\produto.php","<?= htmlspecialchars($link_compra) ?>","cursos\<"
"cursos\produto.php","<?= htmlspecialchars($produto['link_saiba_mais']) ?>","cursos\<"
"delivery\aprovar_motoboys.php","../<?= $doc['url'] ?>","delivery\..\<"
"delivery\aprovar_vendedores.php","../<?= $v['comprovante_residencia_url'] ?>","delivery\..\<"
"delivery\aprovar_vendedores.php","../<?= $v['rg_frente_url'] ?>","delivery\..\<"
"delivery\aprovar_vendedores.php","../<?= $v['rg_verso_url'] ?>","delivery\..\<"
"delivery\catalogo.php","<?= htmlspecialchars($item['imagem_url']) ?>","delivery\<"
"delivery\enviar_pedido.php","$whatsapp_url","delivery\$whatsapp_url"
"delivery\motoboy.php","${mapsUrl}","delivery\${mapsUrl}"
"delivery\pdv.php","../<?= $prod['imagem_url'] ?>","delivery\..\<"
"delivery\produtos.php","../<?= $p['imagem_url'] ?? 'img/placeholder.png' ?>","delivery\..\<"
"escolar\index.php","<?= $url_monetizada ?>","escolar\<"
"escolar\matematica.php","<?= $f[1] ?>?lang=<?= htmlspecialchars($lang) ?>","escolar\<"
"escolar\materia_base.php","../../index.php?lang=<?= $lang ?>","escolar\..\..\index.php"
"ferramentas\catalogo.php","<?= htmlspecialchars($targetUrl, ENT_QUOTES, 'UTF-8') ?>","ferramentas\<"
"ferramentas\design\index.php","/ferramentas/imagem/","ferramentas\imagem\index.php"
"ferramentas\design\index.php","/ferramentas/social/","ferramentas\social\index.php"
"ferramentas\design\index.php","/ferramentas/video/","ferramentas\video\index.php"
"ferramentas\diversas\apresentacoes.php","<?= $file->getWebViewLink() ?>","ferramentas\diversas\<"
"ferramentas\diversas\apresentacoes.php","<?= $link_com_pedagio ?>","ferramentas\diversas\<"
"ferramentas\diversas\documentos.php","<?= $file->getWebViewLink() ?>","ferramentas\diversas\<"
"ferramentas\diversas\documentos.php","<?= $link_com_pedagio ?>","ferramentas\diversas\<"
"ferramentas\diversas\extrator-leads.php","([^","ferramentas\diversas\([^"
"ferramentas\diversas\extrator-leads.php","${lead.website.startsWith('http')?lead.website:'http://'+lead.website}","ferramentas\diversas\${lead.website.startsWith('http')"
"ferramentas\diversas\planilhas.php","<?= $file->getWebViewLink() ?>","ferramentas\diversas\<"
"ferramentas\diversas\planilhas.php","<?= $link_com_pedagio ?>","ferramentas\diversas\<"
"ferramentas\gerador\assinatura-email.php","${foto}","ferramentas\gerador\${foto}"
"ferramentas\imagem\acervo.php","<?= $file->getWebViewLink() ?>","ferramentas\imagem\<"
"ferramentas\imagem\acervo.php","<?= $link_com_pedagio ?>","ferramentas\imagem\<"
"ferramentas\imagem\acervo.php","<?= $thumbnail ?>&sz=w400","ferramentas\imagem\<"
"ferramentas\imagem\base64.php","${base64String}","ferramentas\imagem\${base64String}"
"ferramentas\imagem\gif-para-png.php","${frameData}","ferramentas\imagem\${frameData}"
"ferramentas\imagem\imagem-para-pdf.php","${item.src}","ferramentas\imagem\${item.src}"
"ferramentas\index.php","' . htmlspecialchars(minike_tools_base_path() . '/catalogo.php', ENT_QUOTES, 'UTF-8') . '","ferramentas\' . htmlspecialchars(minike_tools_base_path() . '\catalogo.php', ENT_QUOTES, 'UTF-8') . '"
"ferramentas\index.php","<?= $link_pedagio ?>","ferramentas\<"
"ferramentas\index.php","<?= htmlspecialchars($fallback['url']) ?>","ferramentas\<"
"ferramentas\index.php","${link}","ferramentas\${link}"
"ferramentas\pdf\acervo.php","<?= $file->getWebViewLink() ?>","ferramentas\pdf\<"
"ferramentas\pdf\acervo.php","<?= $link_com_pedagio ?>","ferramentas\pdf\<"
"ferramentas\pdf\desbloquear-pdf.php","${url}","ferramentas\pdf\${url}"
"ferramentas\pdf\jpg-para-pdf.php","${url}","ferramentas\pdf\${url}"
"ferramentas\pdf\marca-dagua-pdf.php","${url}","ferramentas\pdf\${url}"
"ferramentas\pdf\numeros-pagina-pdf.php","${url}","ferramentas\pdf\${url}"
"ferramentas\pdf\proteger-pdf.php","${url}","ferramentas\pdf\${url}"
"ferramentas\pdf\rodar-pdf.php","${url}","ferramentas\pdf\${url}"
"ferramentas\pdf\word-para-pdf.php","${url}","ferramentas\pdf\${url}"
"ferramentas\ponto\ver_folha.php","${item.foto_path}","ferramentas\ponto\${item.foto_path}"
"ferramentas\ponto\ver_folha.php","$path","ferramentas\ponto\$path"
"ferramentas\seo\gerador_meta_tags.php","${url}","ferramentas\seo\${url}"
"ferramentas\seo\open_graph.php","${image}","ferramentas\seo\${image}"
"ferramentas\video\compressor.php","<?= htmlspecialchars($success['download_url']) ?>","ferramentas\video\<"
"ferramentas\video\criar-video.php","${item.preview}","ferramentas\video\${item.preview}"
"ferramentas\video\dividir-video.php","${url}","ferramentas\video\${url}"
"ferramentas\video\vob-para-mp4.php","<?= htmlspecialchars($success['download_url']) ?>","ferramentas\video\<"
"games\admin\jogos.php","<?= htmlspecialchars((string)($p['demo_url'] ?: $p['jogo_url'])) ?>","games\admin\<"
"games\checkout.php","<?= $jogo['capa_url'] ?>","games\<"
"games\comunidade.php","<?= htmlspecialchars((string)($j['capa_url'] ?: 'https://placehold.co/640x360/0f172a/64748b?text=MiniGame')) ?>","games\<"
"games\comunidade.php","<?= htmlspecialchars((string)($j['demo_url'] ?: $j['jogo_url'])) ?>","games\<"
"games\comunidade.php","<?= htmlspecialchars((string)$j['jogo_url']) ?>","games\<"
"games\index.php","<?= $j['capa_url'] ?: 'assets/default_game.jpg' ?>","games\<"
"games\index.php","<?= htmlspecialchars((string)($cg['capa_url'] ?: 'https://placehold.co/640x360/0f172a/64748b?text=MiniGame')) ?>","games\<"
"games\index.php","<?= htmlspecialchars((string)($cg['demo_url'] ?: $cg['jogo_url'])) ?>","games\<"
"games\index.php","<?= htmlspecialchars((string)$cg['jogo_url']) ?>","games\<"
"games\jogo.php","<?= htmlspecialchars($playUrl) ?>","games\<"
"games\minike\index.php","' . htmlspecialchars($item['link'], ENT_QUOTES) . '","games\minike\' . htmlspecialchars($item['link'], ENT_QUOTES) . '"
"games\minike\index.php","README.md","games\minike\README.md"
"games\perfil.php","<?= $lb['capa_url'] ?>","games\<"
"includes\adaptive_growth.php","' . htmlspecialchars($profile['links'][0][0], ENT_QUOTES, 'UTF-8') . '","includes\' . htmlspecialchars($profile['links'][0][0], ENT_QUOTES, 'UTF-8') . '"
"includes\adaptive_growth.php","' . htmlspecialchars($url, ENT_QUOTES, 'UTF-8') . '","includes\' . htmlspecialchars($url, ENT_QUOTES, 'UTF-8') . '"
"includes\ads_compat.php","' . htmlspecialchars($item['url'], ENT_QUOTES, 'UTF-8') . '","includes\' . htmlspecialchars($item['url'], ENT_QUOTES, 'UTF-8') . '"
"includes\ads_internos.php","' . htmlspecialchars($ad['url'], ENT_QUOTES, 'UTF-8') . '","includes\' . htmlspecialchars($ad['url'], ENT_QUOTES, 'UTF-8') . '"
"includes\ads_internos.php","' . htmlspecialchars($card['url'], ENT_QUOTES, 'UTF-8') . '","includes\' . htmlspecialchars($card['url'], ENT_QUOTES, 'UTF-8') . '"
"includes\ads_loader_novo.php","' . htmlspecialchars($iframe_url) . '","includes\' . htmlspecialchars($iframe_url) . '"
"includes\ads_loader_novo.php","' . htmlspecialchars($script_url) . '","includes\' . htmlspecialchars($script_url) . '"
"includes\email_service.php","{self::$site_url}/central_cliente.php","includes\{self::$site_url}\central_cliente.php"
"includes\email_service.php","{self::$site_url}/ferramentas/","includes\{self::$site_url}\ferramentas\index.php"
"includes\email_service.php","{self::$site_url}/planos.php?upgrade=1","includes\{self::$site_url}\planos.php"
"includes\email_service.php","$link_loja","includes\$link_loja"
"includes\email_service.php","$link_reset","includes\$link_reset"
"includes\header-unificado.php","<?php echo htmlspecialchars($canonical); ?>","includes\<"
"includes\header-unificado.php","<?php echo strpos(__DIR__, 'includes') !== false ? '/' : '../'; ?>includes/style-global.css","includes\<"
"includes\mercado_pago_produtos.php","' . htmlspecialchars($checkout_url) . '","includes\' . htmlspecialchars($checkout_url) . '"
"includes\mercado_pago.php","' . htmlspecialchars($init_point) . '","includes\' . htmlspecialchars($init_point) . '"
"ir.php","<?php echo $destino; ?>","<"
"lojas\admin\aprovar_motoboys.php","../<?= $doc['url'] ?>","lojas\admin\..\<"
"lojas\admin\aprovar_vendedores.php","../<?= $v['comprovante_residencia_url'] ?>","lojas\admin\..\<"
"lojas\admin\aprovar_vendedores.php","../<?= $v['rg_frente_url'] ?>","lojas\admin\..\<"
"lojas\admin\aprovar_vendedores.php","../<?= $v['rg_verso_url'] ?>","lojas\admin\..\<"
"lojas\admin\editar_loja.php","../<?= $loja_atual['banner_url'] ?>","lojas\admin\..\<"
"lojas\admin\editar_loja.php","../<?= $loja_atual['logo_url'] ?>","lojas\admin\..\<"
"lojas\admin\gerenciar_curriculos.php","../<?= $c['arquivo_cv'] ?>","lojas\admin\..\<"
"lojas\admin\gerenciar_postagens.php","../<?= htmlspecialchars($p['imagem_url']) ?>","lojas\admin\..\<"
"lojas\admin\gerenciar_propostas.php","../${url}","lojas\admin\..\${url}"
"lojas\admin\lojas.php","/<?= $loja['pasta_url'] ?>/","<"
"lojas\admin\minha_loja.php","../<?= $loja['banner_url'] ?: 'img/placeholder-banner.jpg' ?>","lojas\admin\..\<"
"lojas\admin\minha_loja.php","../<?= $loja['logo_url'] ?: 'img/default-logo.png' ?>","lojas\admin\..\<"
"lojas\admin\motoboy.php","${mapsUrl}","lojas\admin\${mapsUrl}"
"lojas\admin\nova_postagem.php","../<?= $p['imagem_url'] ?>","lojas\admin\..\<"
"lojas\admin\pdv.php","../<?= $prod['imagem_url'] ?>","lojas\admin\..\<"
"lojas\admin\produtos.php","../<?= $p['imagem_url'] ?? 'img/placeholder.png' ?>","lojas\admin\..\<"
"lojas\admin\revisao_imagens.php","<?= $img_src ?>","lojas\admin\<"
"lojas\catalogo.php","<?= htmlspecialchars($item['imagem_url']) ?>","lojas\<"
"lojas\catalogo.php","${imagem}","lojas\${imagem}"
"lojas\includes\template_loja_padrao.php","{$img}","lojas\includes\{$img}"
"lojas\includes\template_loja_padrao.php","<?= !empty($item['imagem_url']) ? '../' . $item['imagem_url'] : '../img/placeholder.png' ?>","lojas\includes\<"
"lojas\includes\template_loja_padrao.php","<?= $logo_loja ?>","lojas\includes\<"
"lojas\includes\template_loja_padrao.php","<?= htmlspecialchars($item['url']) ?>","lojas\includes\<"
"lojas\includes\template_loja_padrao.php","<?= htmlspecialchars($loja['facebook']) ?>","lojas\includes\<"
"lojas\includes\template_loja_padrao.php","<?= htmlspecialchars($loja['instagram']) ?>","lojas\includes\<"
"lojas\includes\template_loja_padrao.php","<?= htmlspecialchars($loja['link_externo']) ?>","lojas\includes\<"
"lojas\includes\template_loja_padrao.php","<?= htmlspecialchars($loja['tiktok']) ?>","lojas\includes\<"
"lojas\includes\template_loja_padrao.php","${item.img}","lojas\includes\${item.img}"
"lojas\index.php","<?= !empty($loja['logo_url']) ? $loja['logo_url'] : 'img/default-logo.png' ?>","lojas\<"
"lojas\index.php","<?= $arquivo_seja_lojista ?>","lojas\<"
"lojas\index.php","<?= $arquivo_seja_vendedor ?>","lojas\<"
"lojas\index.php","<?= $arquivo_trabalhe_conosco ?>","lojas\<"
"lojas\index.php","<?= $banner['link'] ?>","lojas\<"
"lojas\index.php","<?= $banner['logo'] ?>","lojas\<"
"lojas\index.php","<?= $master['facebook'] ?>","lojas\<"
"lojas\index.php","<?= $master['instagram'] ?>","lojas\<"
"lojas\index.php","<?= $master['logo_url'] ?>","lojas\<"
"lojas\index.php","<?= $story['logo'] ?>","lojas\<"
"lojas\index.php","<?= $url_grid ?>","lojas\<"
"lojas\index.php","<?= $url_side ?>","lojas\<"
"lojas\painel_cliente.php","<?= $master['logo_url'] ?>","lojas\<"
"lojas\painel_cliente.php","<?= $p['logo_loja'] ?>","lojas\<"
"lojas\painel_cliente.php","detalhes_pedido.php?id=<?= $p['id'] ?>","lojas\detalhes_pedido.php"
"lojas\seja_lojista.php","<?= $master['logo_url'] ?>","lojas\<"
"lojas\trabalhe_conosco.php","<?= $master['logo_url'] ?>","lojas\<"
"lojas\visualizador_status.php","<?= htmlspecialchars($loja['logo_url']) ?>","lojas\<"
"lojas\visualizador_status.php","<?= htmlspecialchars($loja['pasta_url']) ?>/","lojas\<"
"lojas\visualizar_status.php","<?= !empty($loja['logo_url']) ? $loja['logo_url'] : 'img/default-logo.png' ?>","lojas\<"
"lojas\visualizar_status.php","<?= htmlspecialchars($slide['imagem_url']) ?>","lojas\<"
"painel_mestre.php","${b.url}","${b.url}"
"painel_mestre.php","${f.path.replace(/\\/g,'/')}","${f.path.replace(\\\\g,'\')}"
"painel_mestre.php","${f.replace(/.*minike[\\/]/,'')}","${f.replace(\.*minike[\\\]\,'')}"
"painel_mestre.php","${rel}","${rel}"
"painel_mestre.php","${s.path}/","${s.path}\index.php"
"rede.php","<?= $sub['url'] ?>","<"
"rede.php","<?= $url ?>","<"
"sites\admin\depoimentos.php","<?= htmlspecialchars($d['imagem_url'] ?: 'https://via.placeholder.com/50') ?>","sites\admin\<"
"sites\admin\trabalhos.php","<?= htmlspecialchars(($t['imagem'] ?? '') ?: 'https://via.placeholder.com/80') ?>","sites\admin\<"
"sites\admin\trabalhos.php","<?= htmlspecialchars($t['link']) ?>","sites\admin\<"
"sites\index.php","<?= htmlspecialchars($trab_link) ?>","sites\<"
"sites\index.php","about:blank","sites\about:blank"
"softwares\app.php","<?= htmlspecialchars(sw_url('logout.php')) ?>","softwares\<"
"softwares\editor\gerador.php","${t.thumbnail}","softwares\editor\${t.thumbnail}"
"softwares\editor\gerador.php","aba2-layout-fix.css<?= v('aba2-layout-fix.css') ?>","softwares\editor\aba2-layout-fix.css<"
"softwares\editor\gerador.php","animation.js<?= v('animation.js') ?>","softwares\editor\animation.js<"
"softwares\editor\gerador.php","area-designer.js<?= v('area-designer.js') ?>","softwares\editor\area-designer.js<"
"softwares\editor\gerador.php","canvas.js<?= v('canvas.js') ?>","softwares\editor\canvas.js<"
"softwares\editor\gerador.php","excel_virtualizador.js<?= v('excel_virtualizador.js') ?>","softwares\editor\excel_virtualizador.js<"
"softwares\editor\gerador.php","excel-selector.js<?= v('excel-selector.js') ?>","softwares\editor\excel-selector.js<"
"softwares\editor\gerador.php","ferramentas.js<?= v('ferramentas.js') ?>","softwares\editor\ferramentas.js<"
"softwares\editor\gerador.php","gif-creator.js<?= v('gif-creator.js') ?>","softwares\editor\gif-creator.js<"
"softwares\editor\gerador.php","grid-editor.js<?= v('grid-editor.js') ?>","softwares\editor\grid-editor.js<"
"softwares\editor\gerador.php","integration.js<?= v('integration.js') ?>","softwares\editor\integration.js<"
"softwares\editor\gerador.php","layout-management.js<?= v('layout-management.js') ?>","softwares\editor\layout-management.js<"
"softwares\editor\gerador.php","mobile-helpers.js<?= v('mobile-helpers.js') ?>","softwares\editor\mobile-helpers.js<"
"softwares\editor\gerador.php","pdf-compressor.js<?= v('pdf-compressor.js') ?>","softwares\editor\pdf-compressor.js<"
"softwares\editor\gerador.php","pdf-tools.js<?= v('pdf-tools.js') ?>","softwares\editor\pdf-tools.js<"
"softwares\editor\gerador.php","smart_frames.js<?= v('smart_frames.js') ?>","softwares\editor\smart_frames.js<"
"softwares\editor\gerador.php","styles.css<?= v('styles.css') ?>","softwares\editor\styles.css<"
"softwares\editor\gerador.php","templates.js<?= v('templates.js') ?>","softwares\editor\templates.js<"
"softwares\editor\gerador.php","touch-gestures.js<?= v('touch-gestures.js') ?>","softwares\editor\touch-gestures.js<"
"softwares\editor\gerador.php","tutorial.js<?= v('tutorial.js') ?>","softwares\editor\tutorial.js<"
"softwares\editor\gerador.php","wizard.js<?= v('wizard.js') ?>","softwares\editor\wizard.js<"
"softwares\ponto\saas_index.php","saas_meu_painel.php?token=<?= urlencode($token) ?>&cpf=<?= urlencode($cpf_salvo) ?>","softwares\ponto\saas_meu_painel.php"
"softwares\ponto\saas_painel.php","' . sh($r['foto_url']) . '","softwares\ponto\' . sh($r['foto_url']) . '"
"softwares\ponto\ver_folha.php","${item.foto_path}","softwares\ponto\${item.foto_path}"
"softwares\ponto\ver_folha.php","$path","softwares\ponto\$path"
"softwares\software\ponto\ver_folha.php","${item.foto_path}","softwares\software\ponto\${item.foto_path}"
"softwares\software\ponto\ver_folha.php","$path","softwares\software\ponto\$path"
"templates\index.php","<?= htmlspecialchars($t['url'], ENT_QUOTES, 'UTF-8') ?>","templates\<"

```

---

## Fonte: _missing_links_refined.csv

```csv
"source","link","target"
"admin\multi-domain.php","ads.php","admin\ads.php"
"admin\multi-domain.php","dashboard.php","admin\dashboard.php"
"admin\multi-domain.php","licencas.php","admin\licencas.php"
"admin\multi-domain.php","usuarios.php","admin\usuarios.php"
"admin_dashboard.php","assets/logo.png","assets\logo.png"
"planos.php","/atendimento/","atendimento\index.php"
"bio\index.php","foto","bio\foto\index.php"
"cursos\admin\index.php","acessos.php","cursos\admin\acessos.php"
"cursos\admin\index.php","comentarios.php","cursos\admin\comentarios.php"
"cursos\admin\index.php","configuracoes.php","cursos\admin\configuracoes.php"
"cursos\admin\sidebar.php","licencas.php","cursos\admin\licencas.php"
"cursos\admin\index.php","modulos.php","cursos\admin\modulos.php"
"cursos\admin\index.php","professores.php","cursos\admin\professores.php"
"cursos\admin\index.php","relatorios.php","cursos\admin\relatorios.php"
"delivery\cadastro_motoboy.php","login.php","delivery\login.php"
"delivery\pdv.php","logout.php","delivery\logout.php"
"teste-conexao.php","diagnostico.php","diagnostico.php"
"softwares\editor\vendor\phpoffice\phpspreadsheet\src\PhpSpreadsheet\Helper\Sample.php","/download.php?type=","download.php"
"index.php","/ferramentas/calculo/","ferramentas\calculo\index.php"
"ferramentas\desenvolvedor\favicon.php","apple-touch-icon.png","ferramentas\desenvolvedor\apple-touch-icon.png"
"ferramentas\desenvolvedor\favicon.php","favicon.png","ferramentas\desenvolvedor\favicon.png"
"index.php","/ferramentas/design/","ferramentas\design\index.php"
"index.php","/ferramentas/financeiro/","ferramentas\financeiro\index.php"
"ferramentas\ponto\login_painel.php","alterar_senha_editor.php","ferramentas\ponto\alterar_senha_editor.php"
"index.php","/ferramentas/saude/bmi.php","ferramentas\saude\bmi.php"
"index.php","/ferramentas/seo/","ferramentas\seo\index.php"
"index.php","/ferramentas/texto/","ferramentas\texto\index.php"
"ferramentas\config.php","/financeiro/","financeiro\index.php"
"games\admin\sidebar.php","usuarios.php","games\admin\usuarios.php"
"games\minike\games\game-069\index.php","../catalog.php","games\minike\games\catalog.php"
"games\minike\games\game-044\index.php","../shared/engine.js","games\minike\games\shared\engine.js"
"games\minike\games\game-077\index.php","../shared/register-sw.js","games\minike\games\shared\register-sw.js"
"games\minike\games\game-094\index.php","../shared/style.css","games\minike\games\shared\style.css"
"ferramentas\config.php","/imagem/","imagem\index.php"
"painel_mestre.php","lojas/admin.php","lojas\admin.php"
"lojas\admin\editar_loja.php","../img/default-logo.png","lojas\img\default-logo.png"
"lojas\admin\lojas.php","../img/logo-galeria.png","lojas\img\logo-galeria.png"
"lojas\includes\template_loja_padrao.php","../img/placeholder.png","lojas\img\placeholder.png"
"index.php","/lojas/planos.php","lojas\planos.php"
"sites\index.php","/manifest.webmanifest","manifest.webmanifest"
"admin\painel_supremo.php","/PARA_FELIPE.md","PARA_FELIPE.md"
"sites\index_backup.php","admin.php","sites\admin.php"
"sites\admin\sidebar.php","configuracoes.php","sites\admin\configuracoes.php"
"sites\admin\sidebar.php","portfolio.php","sites\admin\portfolio.php"
"sites\index_backup.php","dominios.php","sites\dominios.php"
"sites\index_backup.php","hospedagem.php","sites\hospedagem.php"
"sites\index_backup.php","login.php","sites\login.php"
"ferramentas\texto\formatador_html.php","/sobre","sobre\index.php"
"softwares\software\index.php","/software/apps/agenda_pro.php","software\apps\agenda_pro.php"
"softwares\software\index.php","/software/apps/api_manager.php","software\apps\api_manager.php"
"softwares\software\index.php","/software/apps/crm_lite.php","software\apps\crm_lite.php"
"softwares\software\index.php","/software/apps/hub.php","software\apps\hub.php"
"softwares\software\index.php","/software/apps/os_service.php","software\apps\os_service.php"
"softwares\software\register.php","/software/login.php","software\login.php"
"softwares\software\login.php","/software/register.php","software\register.php"
"softwares\ponto\login_painel.php","alterar_senha_editor.php","softwares\ponto\alterar_senha_editor.php"
"softwares\software\apps\hub.php","api_manager.php","softwares\software\apps\api_manager.php"
"softwares\software\ponto\login_painel.php","alterar_senha_editor.php","softwares\software\ponto\alterar_senha_editor.php"
"ferramentas\config.php","/texto/","texto\index.php"

```

---

## Fonte: _missing_links_scan.csv

```csv
"source","link","target"
"admin\multi-domain.php","ads.php","admin\ads.php"
"admin\multi-domain.php","dashboard.php","admin\dashboard.php"
"admin\multi-domain.php","licencas.php","admin\licencas.php"
"admin\multi-domain.php","usuarios.php","admin\usuarios.php"
"ads\painel.php","...","ads\...\index.php"
"ads\ad_footer.php",")","ads\)\index.php"
"ads\go10.php","urlDestino;","ads\urlDestino;\index.php"
"admin_dashboard.php","assets/logo.png","assets\\logo.png"
"planos.php","/atendimento/","atendimento\\index.php"
"bio\index.php","foto","bio\foto\index.php"
"planos.php","btn.href.replace(","btn.href.replace("
"cursos\admin\index.php","acessos.php","cursos\admin\acessos.php"
"cursos\admin\index.php","comentarios.php","cursos\admin\comentarios.php"
"cursos\admin\index.php","configuracoes.php","cursos\admin\configuracoes.php"
"cursos\admin\sidebar.php","licencas.php","cursos\admin\licencas.php"
"cursos\admin\index.php","modulos.php","cursos\admin\modulos.php"
"cursos\admin\index.php","professores.php","cursos\admin\professores.php"
"cursos\admin\index.php","relatorios.php","cursos\admin\relatorios.php"
"cursos\admin\index.php","usuarios_edit.php","cursos\admin\usuarios_edit.php"
"cursos\meu-painel.php","assistir.php","cursos\assistir.php"
"cursos\detalhes.php","checkout.php","cursos\checkout.php"
"delivery\cadastro_motoboy.php","login.php","delivery\login.php"
"delivery\aprovar_motoboys.php","logout.php","delivery\logout.php"
"teste-conexao.php","diagnostico.php","diagnostico.php"
"softwares\editor\vendor\phpoffice\phpspreadsheet\src\PhpSpreadsheet\Helper\Sample.php","/download.php","download.php"
"escolar\materia_base.php","../../index.php","escolar\..\\..\\index.php"
"ferramentas\index.php","[\","ferramentas\[\index.php"
"index.php","/ferramentas/calculo/","ferramentas\\calculo\\index.php"
"index.php","/ferramentas/design/","ferramentas\\design\\index.php"
"index.php","/ferramentas/financeiro/","ferramentas\\financeiro\\index.php"
"index.php","/ferramentas/saude/bmi.php","ferramentas\\saude\\bmi.php"
"index.php","/ferramentas/seo/","ferramentas\\seo\\index.php"
"index.php","/ferramentas/texto/","ferramentas\\texto\\index.php"
"ferramentas\data_hora\cronograma.php","URL.createObjectURL(blob);a.download=","ferramentas\data_hora\URL.createObjectURL(blob);a.download="
"ferramentas\desenvolvedor\favicon.php","apple-touch-icon.png","ferramentas\desenvolvedor\apple-touch-icon.png"
"ferramentas\desenvolvedor\favicon.php","c.toDataURL(","ferramentas\desenvolvedor\c.toDataURL("
"ferramentas\desenvolvedor\gerador-codigo-barras.php","canvas.toDataURL();","ferramentas\desenvolvedor\canvas.toDataURL();"
"ferramentas\desenvolvedor\validador_xml.php","document.getElementById(","ferramentas\desenvolvedor\document.getElementById("
"ferramentas\desenvolvedor\favicon.php","favicon.png","ferramentas\desenvolvedor\favicon.png"
"ferramentas\desenvolvedor\gerador-qr-code.php","qrCodeData;","ferramentas\desenvolvedor\qrCodeData;\index.php"
"ferramentas\desenvolvedor\htaccess.php","URL.createObjectURL(blob);a.download=","ferramentas\desenvolvedor\URL.createObjectURL(blob);a.download="
"ferramentas\desenvolvedor\gerador-qr-code.php","URL.createObjectURL(svgBlob);","ferramentas\desenvolvedor\URL.createObjectURL(svgBlob);"
"ferramentas\design\gerador_qrcode.php","url;","ferramentas\design\url;\index.php"
"ferramentas\dev\gerador-qr-code.php","qrCodeData;","ferramentas\dev\qrCodeData;\index.php"
"ferramentas\dev\gerador-qr-code.php","URL.createObjectURL(svgBlob);","ferramentas\dev\URL.createObjectURL(svgBlob);"
"ferramentas\diversas\extrator-leads.php","([^","ferramentas\diversas\([^\index.php"
"ferramentas\diversas\extrator-leads.php","url;","ferramentas\diversas\url;\index.php"
"ferramentas\gerador\barcode.php","canvas.toDataURL(","ferramentas\gerador\canvas.toDataURL("
"ferramentas\gerador\assinatura.php","foto;","ferramentas\gerador\foto;\index.php"
"ferramentas\gerador\gerador-rotas.php","linkGoogleMaps;","ferramentas\gerador\linkGoogleMaps;\index.php"
"ferramentas\gerador\assinatura.php","siteUrl;","ferramentas\gerador\siteUrl;\index.php"
"ferramentas\imagem\base64.php","base64String;","ferramentas\imagem\base64String;\index.php"
"ferramentas\imagem\efeitos-imagem.php","canvas.toDataURL(","ferramentas\imagem\canvas.toDataURL("
"ferramentas\imagem\gerador_meme.php","canvas.toDataURL();","ferramentas\imagem\canvas.toDataURL();"
"ferramentas\imagem\removedor_fundo.php","canvas2.toDataURL(","ferramentas\imagem\canvas2.toDataURL("
"ferramentas\imagem\conversor.php","dataUrl;","ferramentas\imagem\dataUrl;\index.php"
"ferramentas\imagem\png-para-jpg.php","document.getElementById(","ferramentas\imagem\document.getElementById("
"ferramentas\imagem\webp-converter.php","e.target.result;","ferramentas\imagem\e.target.result;"
"ferramentas\imagem\gerador_meme.php","ev.target.result;","ferramentas\imagem\ev.target.result;"
"ferramentas\imagem\png-para-jpg.php","jpgDataUrl;","ferramentas\imagem\jpgDataUrl;\index.php"
"ferramentas\imagem\compressor.php","novaDataUrl;","ferramentas\imagem\novaDataUrl;\index.php"
"ferramentas\imagem\removedor_fundo.php","originalDataURL;","ferramentas\imagem\originalDataURL;\index.php"
"ferramentas\imagem\recortar.php","originalImg.src;","ferramentas\imagem\originalImg.src;"
"ferramentas\imagem\jpg-para-png.php","pngDataUrl;","ferramentas\imagem\pngDataUrl;\index.php"
"ferramentas\imagem\removedor_fundo.php","processedCanvas.toDataURL(","ferramentas\imagem\processedCanvas.toDataURL("
"ferramentas\imagem\webp-converter.php","saidaDataUrl;","ferramentas\imagem\saidaDataUrl;\index.php"
"ferramentas\imagem\removedor_fundo.php","src;","ferramentas\imagem\src;\index.php"
"ferramentas\imagem\recortar.php","tempCanvas.toDataURL(","ferramentas\imagem\tempCanvas.toDataURL("
"ferramentas\imagem\recortar.php","tempCanvas.toDataURL();","ferramentas\imagem\tempCanvas.toDataURL();"
"ferramentas\imagem\redimensionador.php","url;","ferramentas\imagem\url;\index.php"
"ferramentas\catalogo.php","missing&module=","ferramentas\missing&module=\index.php"
"ferramentas\pdf\jpg-para-pdf.php","imgData;","ferramentas\pdf\imgData;\index.php"
"ferramentas\pdf\pdf-para-word.php","url;","ferramentas\pdf\url;\index.php"
"ferramentas\pdf\compressor.php","window.URL.createObjectURL(blob);","ferramentas\pdf\window.URL.createObjectURL(blob);"
"ferramentas\ponto\login_painel.php","alterar_senha_editor.php","ferramentas\ponto\alterar_senha_editor.php"
"ferramentas\seo\verificador_robots.php","(document.getElementById(","ferramentas\seo\(document.getElementById("
"ferramentas\social\encurtador_url.php","document.getElementById(","ferramentas\social\document.getElementById("
"ferramentas\texto\contador_caracteres_especificos.php","document.getElementById(","ferramentas\texto\document.getElementById("
"ferramentas\texto\contador_palavras.php","URL.createObjectURL(blob);","ferramentas\texto\URL.createObjectURL(blob);"
"ferramentas\video\cortar-video.php","e.target.result;","ferramentas\video\e.target.result;"
"ferramentas\video\criar-video.php","url;","ferramentas\video\url;\index.php"
"ferramentas\whatsApp\index.php","url;","ferramentas\whatsApp\url;\index.php"
"ferramentas\config.php","/financeiro/","financeiro\\index.php"
"games\admin\sidebar.php","usuarios.php","games\admin\usuarios.php"
"games\minike\games\game-001\index.php","../catalog.php","games\minike\games\game-001\..\\catalog.php"
"games\minike\games\game-001\index.php","../shared/engine.js","games\minike\games\game-001\..\\shared\\engine.js"
"games\minike\games\game-001\index.php","../shared/register-sw.js","games\minike\games\game-001\..\\shared\\register-sw.js"
"games\minike\games\game-001\index.php","../shared/style.css","games\minike\games\game-001\..\\shared\\style.css"
"games\minike\games\game-002\index.php","../catalog.php","games\minike\games\game-002\..\\catalog.php"
"games\minike\games\game-002\index.php","../shared/engine.js","games\minike\games\game-002\..\\shared\\engine.js"
"games\minike\games\game-002\index.php","../shared/register-sw.js","games\minike\games\game-002\..\\shared\\register-sw.js"
"games\minike\games\game-002\index.php","../shared/style.css","games\minike\games\game-002\..\\shared\\style.css"
"games\minike\games\game-003\index.php","../catalog.php","games\minike\games\game-003\..\\catalog.php"
"games\minike\games\game-003\index.php","../shared/engine.js","games\minike\games\game-003\..\\shared\\engine.js"
"games\minike\games\game-003\index.php","../shared/register-sw.js","games\minike\games\game-003\..\\shared\\register-sw.js"
"games\minike\games\game-003\index.php","../shared/style.css","games\minike\games\game-003\..\\shared\\style.css"
"games\minike\games\game-004\index.php","../catalog.php","games\minike\games\game-004\..\\catalog.php"
"games\minike\games\game-004\index.php","../shared/register-sw.js","games\minike\games\game-004\..\\shared\\register-sw.js"
"games\minike\games\game-004\index.php","../shared/style.css","games\minike\games\game-004\..\\shared\\style.css"
"games\minike\games\game-005\index.php","../catalog.php","games\minike\games\game-005\..\\catalog.php"
"games\minike\games\game-005\index.php","../shared/register-sw.js","games\minike\games\game-005\..\\shared\\register-sw.js"
"games\minike\games\game-005\index.php","../shared/style.css","games\minike\games\game-005\..\\shared\\style.css"
"games\minike\games\game-006\index.php","../catalog.php","games\minike\games\game-006\..\\catalog.php"
"games\minike\games\game-006\index.php","../shared/register-sw.js","games\minike\games\game-006\..\\shared\\register-sw.js"
"games\minike\games\game-006\index.php","../shared/style.css","games\minike\games\game-006\..\\shared\\style.css"
"games\minike\games\game-007\index.php","../catalog.php","games\minike\games\game-007\..\\catalog.php"
"games\minike\games\game-007\index.php","../shared/register-sw.js","games\minike\games\game-007\..\\shared\\register-sw.js"
"games\minike\games\game-007\index.php","../shared/style.css","games\minike\games\game-007\..\\shared\\style.css"
"games\minike\games\game-008\index.php","../catalog.php","games\minike\games\game-008\..\\catalog.php"
"games\minike\games\game-008\index.php","../shared/register-sw.js","games\minike\games\game-008\..\\shared\\register-sw.js"
"games\minike\games\game-008\index.php","../shared/style.css","games\minike\games\game-008\..\\shared\\style.css"
"games\minike\games\game-009\index.php","../catalog.php","games\minike\games\game-009\..\\catalog.php"
"games\minike\games\game-009\index.php","../shared/register-sw.js","games\minike\games\game-009\..\\shared\\register-sw.js"
"games\minike\games\game-009\index.php","../shared/style.css","games\minike\games\game-009\..\\shared\\style.css"
"games\minike\games\game-010\index.php","../catalog.php","games\minike\games\game-010\..\\catalog.php"
"games\minike\games\game-010\index.php","../shared/register-sw.js","games\minike\games\game-010\..\\shared\\register-sw.js"
"games\minike\games\game-010\index.php","../shared/style.css","games\minike\games\game-010\..\\shared\\style.css"
"games\minike\games\game-011\index.php","../catalog.php","games\minike\games\game-011\..\\catalog.php"
"games\minike\games\game-011\index.php","../shared/register-sw.js","games\minike\games\game-011\..\\shared\\register-sw.js"
"games\minike\games\game-011\index.php","../shared/style.css","games\minike\games\game-011\..\\shared\\style.css"
"games\minike\games\game-012\index.php","../catalog.php","games\minike\games\game-012\..\\catalog.php"
"games\minike\games\game-012\index.php","../shared/register-sw.js","games\minike\games\game-012\..\\shared\\register-sw.js"
"games\minike\games\game-012\index.php","../shared/style.css","games\minike\games\game-012\..\\shared\\style.css"
"games\minike\games\game-013\index.php","../catalog.php","games\minike\games\game-013\..\\catalog.php"
"games\minike\games\game-013\index.php","../shared/register-sw.js","games\minike\games\game-013\..\\shared\\register-sw.js"
"games\minike\games\game-013\index.php","../shared/style.css","games\minike\games\game-013\..\\shared\\style.css"
"games\minike\games\game-014\index.php","../catalog.php","games\minike\games\game-014\..\\catalog.php"
"games\minike\games\game-014\index.php","../shared/engine.js","games\minike\games\game-014\..\\shared\\engine.js"
"games\minike\games\game-014\index.php","../shared/register-sw.js","games\minike\games\game-014\..\\shared\\register-sw.js"
"games\minike\games\game-014\index.php","../shared/style.css","games\minike\games\game-014\..\\shared\\style.css"
"games\minike\games\game-015\index.php","../catalog.php","games\minike\games\game-015\..\\catalog.php"
"games\minike\games\game-015\index.php","../shared/engine.js","games\minike\games\game-015\..\\shared\\engine.js"
"games\minike\games\game-015\index.php","../shared/register-sw.js","games\minike\games\game-015\..\\shared\\register-sw.js"
"games\minike\games\game-015\index.php","../shared/style.css","games\minike\games\game-015\..\\shared\\style.css"
"games\minike\games\game-016\index.php","../catalog.php","games\minike\games\game-016\..\\catalog.php"
"games\minike\games\game-016\index.php","../shared/engine.js","games\minike\games\game-016\..\\shared\\engine.js"
"games\minike\games\game-016\index.php","../shared/register-sw.js","games\minike\games\game-016\..\\shared\\register-sw.js"
"games\minike\games\game-016\index.php","../shared/style.css","games\minike\games\game-016\..\\shared\\style.css"
"games\minike\games\game-017\index.php","../catalog.php","games\minike\games\game-017\..\\catalog.php"
"games\minike\games\game-017\index.php","../shared/engine.js","games\minike\games\game-017\..\\shared\\engine.js"
"games\minike\games\game-017\index.php","../shared/register-sw.js","games\minike\games\game-017\..\\shared\\register-sw.js"
"games\minike\games\game-017\index.php","../shared/style.css","games\minike\games\game-017\..\\shared\\style.css"
"games\minike\games\game-018\index.php","../catalog.php","games\minike\games\game-018\..\\catalog.php"
"games\minike\games\game-018\index.php","../shared/engine.js","games\minike\games\game-018\..\\shared\\engine.js"
"games\minike\games\game-018\index.php","../shared/register-sw.js","games\minike\games\game-018\..\\shared\\register-sw.js"
"games\minike\games\game-018\index.php","../shared/style.css","games\minike\games\game-018\..\\shared\\style.css"
"games\minike\games\game-019\index.php","../catalog.php","games\minike\games\game-019\..\\catalog.php"
"games\minike\games\game-019\index.php","../shared/engine.js","games\minike\games\game-019\..\\shared\\engine.js"
"games\minike\games\game-019\index.php","../shared/register-sw.js","games\minike\games\game-019\..\\shared\\register-sw.js"
"games\minike\games\game-019\index.php","../shared/style.css","games\minike\games\game-019\..\\shared\\style.css"
"games\minike\games\game-020\index.php","../catalog.php","games\minike\games\game-020\..\\catalog.php"
"games\minike\games\game-020\index.php","../shared/engine.js","games\minike\games\game-020\..\\shared\\engine.js"
"games\minike\games\game-020\index.php","../shared/register-sw.js","games\minike\games\game-020\..\\shared\\register-sw.js"
"games\minike\games\game-020\index.php","../shared/style.css","games\minike\games\game-020\..\\shared\\style.css"
"games\minike\games\game-021\index.php","../catalog.php","games\minike\games\game-021\..\\catalog.php"
"games\minike\games\game-021\index.php","../shared/engine.js","games\minike\games\game-021\..\\shared\\engine.js"
"games\minike\games\game-021\index.php","../shared/register-sw.js","games\minike\games\game-021\..\\shared\\register-sw.js"
"games\minike\games\game-021\index.php","../shared/style.css","games\minike\games\game-021\..\\shared\\style.css"
"games\minike\games\game-022\index.php","../catalog.php","games\minike\games\game-022\..\\catalog.php"
"games\minike\games\game-022\index.php","../shared/engine.js","games\minike\games\game-022\..\\shared\\engine.js"
"games\minike\games\game-022\index.php","../shared/register-sw.js","games\minike\games\game-022\..\\shared\\register-sw.js"
"games\minike\games\game-022\index.php","../shared/style.css","games\minike\games\game-022\..\\shared\\style.css"
"games\minike\games\game-023\index.php","../catalog.php","games\minike\games\game-023\..\\catalog.php"
"games\minike\games\game-023\index.php","../shared/engine.js","games\minike\games\game-023\..\\shared\\engine.js"
"games\minike\games\game-023\index.php","../shared/register-sw.js","games\minike\games\game-023\..\\shared\\register-sw.js"
"games\minike\games\game-023\index.php","../shared/style.css","games\minike\games\game-023\..\\shared\\style.css"
"games\minike\games\game-024\index.php","../catalog.php","games\minike\games\game-024\..\\catalog.php"
"games\minike\games\game-024\index.php","../shared/engine.js","games\minike\games\game-024\..\\shared\\engine.js"
"games\minike\games\game-024\index.php","../shared/register-sw.js","games\minike\games\game-024\..\\shared\\register-sw.js"
"games\minike\games\game-024\index.php","../shared/style.css","games\minike\games\game-024\..\\shared\\style.css"
"games\minike\games\game-025\index.php","../catalog.php","games\minike\games\game-025\..\\catalog.php"
"games\minike\games\game-025\index.php","../shared/engine.js","games\minike\games\game-025\..\\shared\\engine.js"
"games\minike\games\game-025\index.php","../shared/register-sw.js","games\minike\games\game-025\..\\shared\\register-sw.js"
"games\minike\games\game-025\index.php","../shared/style.css","games\minike\games\game-025\..\\shared\\style.css"
"games\minike\games\game-026\index.php","../catalog.php","games\minike\games\game-026\..\\catalog.php"
"games\minike\games\game-026\index.php","../shared/engine.js","games\minike\games\game-026\..\\shared\\engine.js"
"games\minike\games\game-026\index.php","../shared/register-sw.js","games\minike\games\game-026\..\\shared\\register-sw.js"
"games\minike\games\game-026\index.php","../shared/style.css","games\minike\games\game-026\..\\shared\\style.css"
"games\minike\games\game-027\index.php","../catalog.php","games\minike\games\game-027\..\\catalog.php"
"games\minike\games\game-027\index.php","../shared/engine.js","games\minike\games\game-027\..\\shared\\engine.js"
"games\minike\games\game-027\index.php","../shared/register-sw.js","games\minike\games\game-027\..\\shared\\register-sw.js"
"games\minike\games\game-027\index.php","../shared/style.css","games\minike\games\game-027\..\\shared\\style.css"
"games\minike\games\game-028\index.php","../catalog.php","games\minike\games\game-028\..\\catalog.php"
"games\minike\games\game-028\index.php","../shared/engine.js","games\minike\games\game-028\..\\shared\\engine.js"
"games\minike\games\game-028\index.php","../shared/register-sw.js","games\minike\games\game-028\..\\shared\\register-sw.js"
"games\minike\games\game-028\index.php","../shared/style.css","games\minike\games\game-028\..\\shared\\style.css"
"games\minike\games\game-029\index.php","../catalog.php","games\minike\games\game-029\..\\catalog.php"
"games\minike\games\game-029\index.php","../shared/engine.js","games\minike\games\game-029\..\\shared\\engine.js"
"games\minike\games\game-029\index.php","../shared/register-sw.js","games\minike\games\game-029\..\\shared\\register-sw.js"
"games\minike\games\game-029\index.php","../shared/style.css","games\minike\games\game-029\..\\shared\\style.css"
"games\minike\games\game-030\index.php","../catalog.php","games\minike\games\game-030\..\\catalog.php"
"games\minike\games\game-030\index.php","../shared/engine.js","games\minike\games\game-030\..\\shared\\engine.js"
"games\minike\games\game-030\index.php","../shared/register-sw.js","games\minike\games\game-030\..\\shared\\register-sw.js"
"games\minike\games\game-030\index.php","../shared/style.css","games\minike\games\game-030\..\\shared\\style.css"
"games\minike\games\game-031\index.php","../catalog.php","games\minike\games\game-031\..\\catalog.php"
"games\minike\games\game-031\index.php","../shared/engine.js","games\minike\games\game-031\..\\shared\\engine.js"
"games\minike\games\game-031\index.php","../shared/register-sw.js","games\minike\games\game-031\..\\shared\\register-sw.js"
"games\minike\games\game-031\index.php","../shared/style.css","games\minike\games\game-031\..\\shared\\style.css"
"games\minike\games\game-032\index.php","../catalog.php","games\minike\games\game-032\..\\catalog.php"
"games\minike\games\game-032\index.php","../shared/engine.js","games\minike\games\game-032\..\\shared\\engine.js"
"games\minike\games\game-032\index.php","../shared/register-sw.js","games\minike\games\game-032\..\\shared\\register-sw.js"
"games\minike\games\game-032\index.php","../shared/style.css","games\minike\games\game-032\..\\shared\\style.css"
"games\minike\games\game-033\index.php","../catalog.php","games\minike\games\game-033\..\\catalog.php"
"games\minike\games\game-033\index.php","../shared/engine.js","games\minike\games\game-033\..\\shared\\engine.js"
"games\minike\games\game-033\index.php","../shared/register-sw.js","games\minike\games\game-033\..\\shared\\register-sw.js"
"games\minike\games\game-033\index.php","../shared/style.css","games\minike\games\game-033\..\\shared\\style.css"
"games\minike\games\game-034\index.php","../catalog.php","games\minike\games\game-034\..\\catalog.php"
"games\minike\games\game-034\index.php","../shared/engine.js","games\minike\games\game-034\..\\shared\\engine.js"
"games\minike\games\game-034\index.php","../shared/register-sw.js","games\minike\games\game-034\..\\shared\\register-sw.js"
"games\minike\games\game-034\index.php","../shared/style.css","games\minike\games\game-034\..\\shared\\style.css"
"games\minike\games\game-035\index.php","../catalog.php","games\minike\games\game-035\..\\catalog.php"
"games\minike\games\game-035\index.php","../shared/engine.js","games\minike\games\game-035\..\\shared\\engine.js"
"games\minike\games\game-035\index.php","../shared/register-sw.js","games\minike\games\game-035\..\\shared\\register-sw.js"
"games\minike\games\game-035\index.php","../shared/style.css","games\minike\games\game-035\..\\shared\\style.css"
"games\minike\games\game-036\index.php","../catalog.php","games\minike\games\game-036\..\\catalog.php"
"games\minike\games\game-036\index.php","../shared/engine.js","games\minike\games\game-036\..\\shared\\engine.js"
"games\minike\games\game-036\index.php","../shared/register-sw.js","games\minike\games\game-036\..\\shared\\register-sw.js"
"games\minike\games\game-036\index.php","../shared/style.css","games\minike\games\game-036\..\\shared\\style.css"
"games\minike\games\game-037\index.php","../catalog.php","games\minike\games\game-037\..\\catalog.php"
"games\minike\games\game-037\index.php","../shared/engine.js","games\minike\games\game-037\..\\shared\\engine.js"
"games\minike\games\game-037\index.php","../shared/register-sw.js","games\minike\games\game-037\..\\shared\\register-sw.js"
"games\minike\games\game-037\index.php","../shared/style.css","games\minike\games\game-037\..\\shared\\style.css"
"games\minike\games\game-038\index.php","../catalog.php","games\minike\games\game-038\..\\catalog.php"
"games\minike\games\game-038\index.php","../shared/engine.js","games\minike\games\game-038\..\\shared\\engine.js"
"games\minike\games\game-038\index.php","../shared/register-sw.js","games\minike\games\game-038\..\\shared\\register-sw.js"
"games\minike\games\game-038\index.php","../shared/style.css","games\minike\games\game-038\..\\shared\\style.css"
"games\minike\games\game-039\index.php","../catalog.php","games\minike\games\game-039\..\\catalog.php"
"games\minike\games\game-039\index.php","../shared/engine.js","games\minike\games\game-039\..\\shared\\engine.js"
"games\minike\games\game-039\index.php","../shared/register-sw.js","games\minike\games\game-039\..\\shared\\register-sw.js"
"games\minike\games\game-039\index.php","../shared/style.css","games\minike\games\game-039\..\\shared\\style.css"
"games\minike\games\game-040\index.php","../catalog.php","games\minike\games\game-040\..\\catalog.php"
"games\minike\games\game-040\index.php","../shared/engine.js","games\minike\games\game-040\..\\shared\\engine.js"
"games\minike\games\game-040\index.php","../shared/register-sw.js","games\minike\games\game-040\..\\shared\\register-sw.js"
"games\minike\games\game-040\index.php","../shared/style.css","games\minike\games\game-040\..\\shared\\style.css"
"games\minike\games\game-041\index.php","../catalog.php","games\minike\games\game-041\..\\catalog.php"
"games\minike\games\game-041\index.php","../shared/engine.js","games\minike\games\game-041\..\\shared\\engine.js"
"games\minike\games\game-041\index.php","../shared/register-sw.js","games\minike\games\game-041\..\\shared\\register-sw.js"
"games\minike\games\game-041\index.php","../shared/style.css","games\minike\games\game-041\..\\shared\\style.css"
"games\minike\games\game-042\index.php","../catalog.php","games\minike\games\game-042\..\\catalog.php"
"games\minike\games\game-042\index.php","../shared/engine.js","games\minike\games\game-042\..\\shared\\engine.js"
"games\minike\games\game-042\index.php","../shared/register-sw.js","games\minike\games\game-042\..\\shared\\register-sw.js"
"games\minike\games\game-042\index.php","../shared/style.css","games\minike\games\game-042\..\\shared\\style.css"
"games\minike\games\game-043\index.php","../catalog.php","games\minike\games\game-043\..\\catalog.php"
"games\minike\games\game-043\index.php","../shared/engine.js","games\minike\games\game-043\..\\shared\\engine.js"
"games\minike\games\game-043\index.php","../shared/register-sw.js","games\minike\games\game-043\..\\shared\\register-sw.js"
"games\minike\games\game-043\index.php","../shared/style.css","games\minike\games\game-043\..\\shared\\style.css"
"games\minike\games\game-044\index.php","../catalog.php","games\minike\games\game-044\..\\catalog.php"
"games\minike\games\game-044\index.php","../shared/engine.js","games\minike\games\game-044\..\\shared\\engine.js"
"games\minike\games\game-044\index.php","../shared/register-sw.js","games\minike\games\game-044\..\\shared\\register-sw.js"
"games\minike\games\game-044\index.php","../shared/style.css","games\minike\games\game-044\..\\shared\\style.css"
"games\minike\games\game-045\index.php","../catalog.php","games\minike\games\game-045\..\\catalog.php"
"games\minike\games\game-045\index.php","../shared/engine.js","games\minike\games\game-045\..\\shared\\engine.js"
"games\minike\games\game-045\index.php","../shared/register-sw.js","games\minike\games\game-045\..\\shared\\register-sw.js"
"games\minike\games\game-045\index.php","../shared/style.css","games\minike\games\game-045\..\\shared\\style.css"
"games\minike\games\game-046\index.php","../catalog.php","games\minike\games\game-046\..\\catalog.php"
"games\minike\games\game-046\index.php","../shared/engine.js","games\minike\games\game-046\..\\shared\\engine.js"
"games\minike\games\game-046\index.php","../shared/register-sw.js","games\minike\games\game-046\..\\shared\\register-sw.js"
"games\minike\games\game-046\index.php","../shared/style.css","games\minike\games\game-046\..\\shared\\style.css"
"games\minike\games\game-047\index.php","../catalog.php","games\minike\games\game-047\..\\catalog.php"
"games\minike\games\game-047\index.php","../shared/engine.js","games\minike\games\game-047\..\\shared\\engine.js"
"games\minike\games\game-047\index.php","../shared/register-sw.js","games\minike\games\game-047\..\\shared\\register-sw.js"
"games\minike\games\game-047\index.php","../shared/style.css","games\minike\games\game-047\..\\shared\\style.css"
"games\minike\games\game-048\index.php","../catalog.php","games\minike\games\game-048\..\\catalog.php"
"games\minike\games\game-048\index.php","../shared/engine.js","games\minike\games\game-048\..\\shared\\engine.js"
"games\minike\games\game-048\index.php","../shared/register-sw.js","games\minike\games\game-048\..\\shared\\register-sw.js"
"games\minike\games\game-048\index.php","../shared/style.css","games\minike\games\game-048\..\\shared\\style.css"
"games\minike\games\game-049\index.php","../catalog.php","games\minike\games\game-049\..\\catalog.php"
"games\minike\games\game-049\index.php","../shared/engine.js","games\minike\games\game-049\..\\shared\\engine.js"
"games\minike\games\game-049\index.php","../shared/register-sw.js","games\minike\games\game-049\..\\shared\\register-sw.js"
"games\minike\games\game-049\index.php","../shared/style.css","games\minike\games\game-049\..\\shared\\style.css"
"games\minike\games\game-050\index.php","../catalog.php","games\minike\games\game-050\..\\catalog.php"
"games\minike\games\game-050\index.php","../shared/engine.js","games\minike\games\game-050\..\\shared\\engine.js"
"games\minike\games\game-050\index.php","../shared/register-sw.js","games\minike\games\game-050\..\\shared\\register-sw.js"
"games\minike\games\game-050\index.php","../shared/style.css","games\minike\games\game-050\..\\shared\\style.css"
"games\minike\games\game-051\index.php","../catalog.php","games\minike\games\game-051\..\\catalog.php"
"games\minike\games\game-051\index.php","../shared/engine.js","games\minike\games\game-051\..\\shared\\engine.js"
"games\minike\games\game-051\index.php","../shared/register-sw.js","games\minike\games\game-051\..\\shared\\register-sw.js"
"games\minike\games\game-051\index.php","../shared/style.css","games\minike\games\game-051\..\\shared\\style.css"
"games\minike\games\game-052\index.php","../catalog.php","games\minike\games\game-052\..\\catalog.php"
"games\minike\games\game-052\index.php","../shared/engine.js","games\minike\games\game-052\..\\shared\\engine.js"
"games\minike\games\game-052\index.php","../shared/register-sw.js","games\minike\games\game-052\..\\shared\\register-sw.js"
"games\minike\games\game-052\index.php","../shared/style.css","games\minike\games\game-052\..\\shared\\style.css"
"games\minike\games\game-053\index.php","../catalog.php","games\minike\games\game-053\..\\catalog.php"
"games\minike\games\game-053\index.php","../shared/engine.js","games\minike\games\game-053\..\\shared\\engine.js"
"games\minike\games\game-053\index.php","../shared/register-sw.js","games\minike\games\game-053\..\\shared\\register-sw.js"
"games\minike\games\game-053\index.php","../shared/style.css","games\minike\games\game-053\..\\shared\\style.css"
"games\minike\games\game-054\index.php","../catalog.php","games\minike\games\game-054\..\\catalog.php"
"games\minike\games\game-054\index.php","../shared/engine.js","games\minike\games\game-054\..\\shared\\engine.js"
"games\minike\games\game-054\index.php","../shared/register-sw.js","games\minike\games\game-054\..\\shared\\register-sw.js"
"games\minike\games\game-054\index.php","../shared/style.css","games\minike\games\game-054\..\\shared\\style.css"
"games\minike\games\game-055\index.php","../catalog.php","games\minike\games\game-055\..\\catalog.php"
"games\minike\games\game-055\index.php","../shared/engine.js","games\minike\games\game-055\..\\shared\\engine.js"
"games\minike\games\game-055\index.php","../shared/register-sw.js","games\minike\games\game-055\..\\shared\\register-sw.js"
"games\minike\games\game-055\index.php","../shared/style.css","games\minike\games\game-055\..\\shared\\style.css"
"games\minike\games\game-056\index.php","../catalog.php","games\minike\games\game-056\..\\catalog.php"
"games\minike\games\game-056\index.php","../shared/engine.js","games\minike\games\game-056\..\\shared\\engine.js"
"games\minike\games\game-056\index.php","../shared/register-sw.js","games\minike\games\game-056\..\\shared\\register-sw.js"
"games\minike\games\game-056\index.php","../shared/style.css","games\minike\games\game-056\..\\shared\\style.css"
"games\minike\games\game-057\index.php","../catalog.php","games\minike\games\game-057\..\\catalog.php"
"games\minike\games\game-057\index.php","../shared/engine.js","games\minike\games\game-057\..\\shared\\engine.js"
"games\minike\games\game-057\index.php","../shared/register-sw.js","games\minike\games\game-057\..\\shared\\register-sw.js"
"games\minike\games\game-057\index.php","../shared/style.css","games\minike\games\game-057\..\\shared\\style.css"
"games\minike\games\game-058\index.php","../catalog.php","games\minike\games\game-058\..\\catalog.php"
"games\minike\games\game-058\index.php","../shared/engine.js","games\minike\games\game-058\..\\shared\\engine.js"
"games\minike\games\game-058\index.php","../shared/register-sw.js","games\minike\games\game-058\..\\shared\\register-sw.js"
"games\minike\games\game-058\index.php","../shared/style.css","games\minike\games\game-058\..\\shared\\style.css"
"games\minike\games\game-059\index.php","../catalog.php","games\minike\games\game-059\..\\catalog.php"
"games\minike\games\game-059\index.php","../shared/engine.js","games\minike\games\game-059\..\\shared\\engine.js"
"games\minike\games\game-059\index.php","../shared/register-sw.js","games\minike\games\game-059\..\\shared\\register-sw.js"
"games\minike\games\game-059\index.php","../shared/style.css","games\minike\games\game-059\..\\shared\\style.css"
"games\minike\games\game-060\index.php","../catalog.php","games\minike\games\game-060\..\\catalog.php"
"games\minike\games\game-060\index.php","../shared/engine.js","games\minike\games\game-060\..\\shared\\engine.js"
"games\minike\games\game-060\index.php","../shared/register-sw.js","games\minike\games\game-060\..\\shared\\register-sw.js"
"games\minike\games\game-060\index.php","../shared/style.css","games\minike\games\game-060\..\\shared\\style.css"
"games\minike\games\game-061\index.php","../catalog.php","games\minike\games\game-061\..\\catalog.php"
"games\minike\games\game-061\index.php","../shared/engine.js","games\minike\games\game-061\..\\shared\\engine.js"
"games\minike\games\game-061\index.php","../shared/register-sw.js","games\minike\games\game-061\..\\shared\\register-sw.js"
"games\minike\games\game-061\index.php","../shared/style.css","games\minike\games\game-061\..\\shared\\style.css"
"games\minike\games\game-062\index.php","../catalog.php","games\minike\games\game-062\..\\catalog.php"
"games\minike\games\game-062\index.php","../shared/engine.js","games\minike\games\game-062\..\\shared\\engine.js"
"games\minike\games\game-062\index.php","../shared/register-sw.js","games\minike\games\game-062\..\\shared\\register-sw.js"
"games\minike\games\game-062\index.php","../shared/style.css","games\minike\games\game-062\..\\shared\\style.css"
"games\minike\games\game-063\index.php","../catalog.php","games\minike\games\game-063\..\\catalog.php"
"games\minike\games\game-063\index.php","../shared/engine.js","games\minike\games\game-063\..\\shared\\engine.js"
"games\minike\games\game-063\index.php","../shared/register-sw.js","games\minike\games\game-063\..\\shared\\register-sw.js"
"games\minike\games\game-063\index.php","../shared/style.css","games\minike\games\game-063\..\\shared\\style.css"
"games\minike\games\game-064\index.php","../catalog.php","games\minike\games\game-064\..\\catalog.php"
"games\minike\games\game-064\index.php","../shared/engine.js","games\minike\games\game-064\..\\shared\\engine.js"
"games\minike\games\game-064\index.php","../shared/register-sw.js","games\minike\games\game-064\..\\shared\\register-sw.js"
"games\minike\games\game-064\index.php","../shared/style.css","games\minike\games\game-064\..\\shared\\style.css"
"games\minike\games\game-065\index.php","../catalog.php","games\minike\games\game-065\..\\catalog.php"
"games\minike\games\game-065\index.php","../shared/engine.js","games\minike\games\game-065\..\\shared\\engine.js"
"games\minike\games\game-065\index.php","../shared/register-sw.js","games\minike\games\game-065\..\\shared\\register-sw.js"
"games\minike\games\game-065\index.php","../shared/style.css","games\minike\games\game-065\..\\shared\\style.css"
"games\minike\games\game-066\index.php","../catalog.php","games\minike\games\game-066\..\\catalog.php"
"games\minike\games\game-066\index.php","../shared/engine.js","games\minike\games\game-066\..\\shared\\engine.js"
"games\minike\games\game-066\index.php","../shared/register-sw.js","games\minike\games\game-066\..\\shared\\register-sw.js"
"games\minike\games\game-066\index.php","../shared/style.css","games\minike\games\game-066\..\\shared\\style.css"
"games\minike\games\game-067\index.php","../catalog.php","games\minike\games\game-067\..\\catalog.php"
"games\minike\games\game-067\index.php","../shared/engine.js","games\minike\games\game-067\..\\shared\\engine.js"
"games\minike\games\game-067\index.php","../shared/register-sw.js","games\minike\games\game-067\..\\shared\\register-sw.js"
"games\minike\games\game-067\index.php","../shared/style.css","games\minike\games\game-067\..\\shared\\style.css"
"games\minike\games\game-068\index.php","../catalog.php","games\minike\games\game-068\..\\catalog.php"
"games\minike\games\game-068\index.php","../shared/engine.js","games\minike\games\game-068\..\\shared\\engine.js"
"games\minike\games\game-068\index.php","../shared/register-sw.js","games\minike\games\game-068\..\\shared\\register-sw.js"
"games\minike\games\game-068\index.php","../shared/style.css","games\minike\games\game-068\..\\shared\\style.css"
"games\minike\games\game-069\index.php","../catalog.php","games\minike\games\game-069\..\\catalog.php"
"games\minike\games\game-069\index.php","../shared/engine.js","games\minike\games\game-069\..\\shared\\engine.js"
"games\minike\games\game-069\index.php","../shared/register-sw.js","games\minike\games\game-069\..\\shared\\register-sw.js"
"games\minike\games\game-069\index.php","../shared/style.css","games\minike\games\game-069\..\\shared\\style.css"
"games\minike\games\game-070\index.php","../catalog.php","games\minike\games\game-070\..\\catalog.php"
"games\minike\games\game-070\index.php","../shared/engine.js","games\minike\games\game-070\..\\shared\\engine.js"
"games\minike\games\game-070\index.php","../shared/register-sw.js","games\minike\games\game-070\..\\shared\\register-sw.js"
"games\minike\games\game-070\index.php","../shared/style.css","games\minike\games\game-070\..\\shared\\style.css"
"games\minike\games\game-071\index.php","../catalog.php","games\minike\games\game-071\..\\catalog.php"
"games\minike\games\game-071\index.php","../shared/engine.js","games\minike\games\game-071\..\\shared\\engine.js"
"games\minike\games\game-071\index.php","../shared/register-sw.js","games\minike\games\game-071\..\\shared\\register-sw.js"
"games\minike\games\game-071\index.php","../shared/style.css","games\minike\games\game-071\..\\shared\\style.css"
"games\minike\games\game-072\index.php","../catalog.php","games\minike\games\game-072\..\\catalog.php"
"games\minike\games\game-072\index.php","../shared/engine.js","games\minike\games\game-072\..\\shared\\engine.js"
"games\minike\games\game-072\index.php","../shared/register-sw.js","games\minike\games\game-072\..\\shared\\register-sw.js"
"games\minike\games\game-072\index.php","../shared/style.css","games\minike\games\game-072\..\\shared\\style.css"
"games\minike\games\game-073\index.php","../catalog.php","games\minike\games\game-073\..\\catalog.php"
"games\minike\games\game-073\index.php","../shared/engine.js","games\minike\games\game-073\..\\shared\\engine.js"
"games\minike\games\game-073\index.php","../shared/register-sw.js","games\minike\games\game-073\..\\shared\\register-sw.js"
"games\minike\games\game-073\index.php","../shared/style.css","games\minike\games\game-073\..\\shared\\style.css"
"games\minike\games\game-074\index.php","../catalog.php","games\minike\games\game-074\..\\catalog.php"
"games\minike\games\game-074\index.php","../shared/engine.js","games\minike\games\game-074\..\\shared\\engine.js"
"games\minike\games\game-074\index.php","../shared/register-sw.js","games\minike\games\game-074\..\\shared\\register-sw.js"
"games\minike\games\game-074\index.php","../shared/style.css","games\minike\games\game-074\..\\shared\\style.css"
"games\minike\games\game-075\index.php","../catalog.php","games\minike\games\game-075\..\\catalog.php"
"games\minike\games\game-075\index.php","../shared/engine.js","games\minike\games\game-075\..\\shared\\engine.js"
"games\minike\games\game-075\index.php","../shared/register-sw.js","games\minike\games\game-075\..\\shared\\register-sw.js"
"games\minike\games\game-075\index.php","../shared/style.css","games\minike\games\game-075\..\\shared\\style.css"
"games\minike\games\game-076\index.php","../catalog.php","games\minike\games\game-076\..\\catalog.php"
"games\minike\games\game-076\index.php","../shared/engine.js","games\minike\games\game-076\..\\shared\\engine.js"
"games\minike\games\game-076\index.php","../shared/register-sw.js","games\minike\games\game-076\..\\shared\\register-sw.js"
"games\minike\games\game-076\index.php","../shared/style.css","games\minike\games\game-076\..\\shared\\style.css"
"games\minike\games\game-077\index.php","../catalog.php","games\minike\games\game-077\..\\catalog.php"
"games\minike\games\game-077\index.php","../shared/engine.js","games\minike\games\game-077\..\\shared\\engine.js"
"games\minike\games\game-077\index.php","../shared/register-sw.js","games\minike\games\game-077\..\\shared\\register-sw.js"
"games\minike\games\game-077\index.php","../shared/style.css","games\minike\games\game-077\..\\shared\\style.css"
"games\minike\games\game-078\index.php","../catalog.php","games\minike\games\game-078\..\\catalog.php"
"games\minike\games\game-078\index.php","../shared/engine.js","games\minike\games\game-078\..\\shared\\engine.js"
"games\minike\games\game-078\index.php","../shared/register-sw.js","games\minike\games\game-078\..\\shared\\register-sw.js"
"games\minike\games\game-078\index.php","../shared/style.css","games\minike\games\game-078\..\\shared\\style.css"
"games\minike\games\game-079\index.php","../catalog.php","games\minike\games\game-079\..\\catalog.php"
"games\minike\games\game-079\index.php","../shared/engine.js","games\minike\games\game-079\..\\shared\\engine.js"
"games\minike\games\game-079\index.php","../shared/register-sw.js","games\minike\games\game-079\..\\shared\\register-sw.js"
"games\minike\games\game-079\index.php","../shared/style.css","games\minike\games\game-079\..\\shared\\style.css"
"games\minike\games\game-080\index.php","../catalog.php","games\minike\games\game-080\..\\catalog.php"
"games\minike\games\game-080\index.php","../shared/engine.js","games\minike\games\game-080\..\\shared\\engine.js"
"games\minike\games\game-080\index.php","../shared/register-sw.js","games\minike\games\game-080\..\\shared\\register-sw.js"
"games\minike\games\game-080\index.php","../shared/style.css","games\minike\games\game-080\..\\shared\\style.css"
"games\minike\games\game-081\index.php","../catalog.php","games\minike\games\game-081\..\\catalog.php"
"games\minike\games\game-081\index.php","../shared/engine.js","games\minike\games\game-081\..\\shared\\engine.js"
"games\minike\games\game-081\index.php","../shared/register-sw.js","games\minike\games\game-081\..\\shared\\register-sw.js"
"games\minike\games\game-081\index.php","../shared/style.css","games\minike\games\game-081\..\\shared\\style.css"
"games\minike\games\game-082\index.php","../catalog.php","games\minike\games\game-082\..\\catalog.php"
"games\minike\games\game-082\index.php","../shared/engine.js","games\minike\games\game-082\..\\shared\\engine.js"
"games\minike\games\game-082\index.php","../shared/register-sw.js","games\minike\games\game-082\..\\shared\\register-sw.js"
"games\minike\games\game-082\index.php","../shared/style.css","games\minike\games\game-082\..\\shared\\style.css"
"games\minike\games\game-083\index.php","../catalog.php","games\minike\games\game-083\..\\catalog.php"
"games\minike\games\game-083\index.php","../shared/engine.js","games\minike\games\game-083\..\\shared\\engine.js"
"games\minike\games\game-083\index.php","../shared/register-sw.js","games\minike\games\game-083\..\\shared\\register-sw.js"
"games\minike\games\game-083\index.php","../shared/style.css","games\minike\games\game-083\..\\shared\\style.css"
"games\minike\games\game-084\index.php","../catalog.php","games\minike\games\game-084\..\\catalog.php"
"games\minike\games\game-084\index.php","../shared/engine.js","games\minike\games\game-084\..\\shared\\engine.js"
"games\minike\games\game-084\index.php","../shared/register-sw.js","games\minike\games\game-084\..\\shared\\register-sw.js"
"games\minike\games\game-084\index.php","../shared/style.css","games\minike\games\game-084\..\\shared\\style.css"
"games\minike\games\game-085\index.php","../catalog.php","games\minike\games\game-085\..\\catalog.php"
"games\minike\games\game-085\index.php","../shared/engine.js","games\minike\games\game-085\..\\shared\\engine.js"
"games\minike\games\game-085\index.php","../shared/register-sw.js","games\minike\games\game-085\..\\shared\\register-sw.js"
"games\minike\games\game-085\index.php","../shared/style.css","games\minike\games\game-085\..\\shared\\style.css"
"games\minike\games\game-086\index.php","../catalog.php","games\minike\games\game-086\..\\catalog.php"
"games\minike\games\game-086\index.php","../shared/engine.js","games\minike\games\game-086\..\\shared\\engine.js"
"games\minike\games\game-086\index.php","../shared/register-sw.js","games\minike\games\game-086\..\\shared\\register-sw.js"
"games\minike\games\game-086\index.php","../shared/style.css","games\minike\games\game-086\..\\shared\\style.css"
"games\minike\games\game-087\index.php","../catalog.php","games\minike\games\game-087\..\\catalog.php"
"games\minike\games\game-087\index.php","../shared/engine.js","games\minike\games\game-087\..\\shared\\engine.js"
"games\minike\games\game-087\index.php","../shared/register-sw.js","games\minike\games\game-087\..\\shared\\register-sw.js"
"games\minike\games\game-087\index.php","../shared/style.css","games\minike\games\game-087\..\\shared\\style.css"
"games\minike\games\game-088\index.php","../catalog.php","games\minike\games\game-088\..\\catalog.php"
"games\minike\games\game-088\index.php","../shared/engine.js","games\minike\games\game-088\..\\shared\\engine.js"
"games\minike\games\game-088\index.php","../shared/register-sw.js","games\minike\games\game-088\..\\shared\\register-sw.js"
"games\minike\games\game-088\index.php","../shared/style.css","games\minike\games\game-088\..\\shared\\style.css"
"games\minike\games\game-089\index.php","../catalog.php","games\minike\games\game-089\..\\catalog.php"
"games\minike\games\game-089\index.php","../shared/engine.js","games\minike\games\game-089\..\\shared\\engine.js"
"games\minike\games\game-089\index.php","../shared/register-sw.js","games\minike\games\game-089\..\\shared\\register-sw.js"
"games\minike\games\game-089\index.php","../shared/style.css","games\minike\games\game-089\..\\shared\\style.css"
"games\minike\games\game-090\index.php","../catalog.php","games\minike\games\game-090\..\\catalog.php"
"games\minike\games\game-090\index.php","../shared/engine.js","games\minike\games\game-090\..\\shared\\engine.js"
"games\minike\games\game-090\index.php","../shared/register-sw.js","games\minike\games\game-090\..\\shared\\register-sw.js"
"games\minike\games\game-090\index.php","../shared/style.css","games\minike\games\game-090\..\\shared\\style.css"
"games\minike\games\game-091\index.php","../catalog.php","games\minike\games\game-091\..\\catalog.php"
"games\minike\games\game-091\index.php","../shared/engine.js","games\minike\games\game-091\..\\shared\\engine.js"
"games\minike\games\game-091\index.php","../shared/register-sw.js","games\minike\games\game-091\..\\shared\\register-sw.js"
"games\minike\games\game-091\index.php","../shared/style.css","games\minike\games\game-091\..\\shared\\style.css"
"games\minike\games\game-092\index.php","../catalog.php","games\minike\games\game-092\..\\catalog.php"
"games\minike\games\game-092\index.php","../shared/engine.js","games\minike\games\game-092\..\\shared\\engine.js"
"games\minike\games\game-092\index.php","../shared/register-sw.js","games\minike\games\game-092\..\\shared\\register-sw.js"
"games\minike\games\game-092\index.php","../shared/style.css","games\minike\games\game-092\..\\shared\\style.css"
"games\minike\games\game-093\index.php","../catalog.php","games\minike\games\game-093\..\\catalog.php"
"games\minike\games\game-093\index.php","../shared/engine.js","games\minike\games\game-093\..\\shared\\engine.js"
"games\minike\games\game-093\index.php","../shared/register-sw.js","games\minike\games\game-093\..\\shared\\register-sw.js"
"games\minike\games\game-093\index.php","../shared/style.css","games\minike\games\game-093\..\\shared\\style.css"
"games\minike\games\game-094\index.php","../catalog.php","games\minike\games\game-094\..\\catalog.php"
"games\minike\games\game-094\index.php","../shared/engine.js","games\minike\games\game-094\..\\shared\\engine.js"
"games\minike\games\game-094\index.php","../shared/register-sw.js","games\minike\games\game-094\..\\shared\\register-sw.js"
"games\minike\games\game-094\index.php","../shared/style.css","games\minike\games\game-094\..\\shared\\style.css"
"games\minike\games\game-095\index.php","../catalog.php","games\minike\games\game-095\..\\catalog.php"
"games\minike\games\game-095\index.php","../shared/engine.js","games\minike\games\game-095\..\\shared\\engine.js"
"games\minike\games\game-095\index.php","../shared/register-sw.js","games\minike\games\game-095\..\\shared\\register-sw.js"
"games\minike\games\game-095\index.php","../shared/style.css","games\minike\games\game-095\..\\shared\\style.css"
"games\minike\games\game-096\index.php","../catalog.php","games\minike\games\game-096\..\\catalog.php"
"games\minike\games\game-096\index.php","../shared/engine.js","games\minike\games\game-096\..\\shared\\engine.js"
"games\minike\games\game-096\index.php","../shared/register-sw.js","games\minike\games\game-096\..\\shared\\register-sw.js"
"games\minike\games\game-096\index.php","../shared/style.css","games\minike\games\game-096\..\\shared\\style.css"
"games\minike\games\game-097\index.php","../catalog.php","games\minike\games\game-097\..\\catalog.php"
"games\minike\games\game-097\index.php","../shared/engine.js","games\minike\games\game-097\..\\shared\\engine.js"
"games\minike\games\game-097\index.php","../shared/register-sw.js","games\minike\games\game-097\..\\shared\\register-sw.js"
"games\minike\games\game-097\index.php","../shared/style.css","games\minike\games\game-097\..\\shared\\style.css"
"games\minike\games\game-098\index.php","../catalog.php","games\minike\games\game-098\..\\catalog.php"
"games\minike\games\game-098\index.php","../shared/engine.js","games\minike\games\game-098\..\\shared\\engine.js"
"games\minike\games\game-098\index.php","../shared/register-sw.js","games\minike\games\game-098\..\\shared\\register-sw.js"
"games\minike\games\game-098\index.php","../shared/style.css","games\minike\games\game-098\..\\shared\\style.css"
"games\minike\games\game-099\index.php","../catalog.php","games\minike\games\game-099\..\\catalog.php"
"games\minike\games\game-099\index.php","../shared/engine.js","games\minike\games\game-099\..\\shared\\engine.js"
"games\minike\games\game-099\index.php","../shared/register-sw.js","games\minike\games\game-099\..\\shared\\register-sw.js"
"games\minike\games\game-099\index.php","../shared/style.css","games\minike\games\game-099\..\\shared\\style.css"
"games\minike\games\game-100\index.php","../catalog.php","games\minike\games\game-100\..\\catalog.php"
"games\minike\games\game-100\index.php","../shared/engine.js","games\minike\games\game-100\..\\shared\\engine.js"
"games\minike\games\game-100\index.php","../shared/register-sw.js","games\minike\games\game-100\..\\shared\\register-sw.js"
"games\minike\games\game-100\index.php","../shared/style.css","games\minike\games\game-100\..\\shared\\style.css"
"ferramentas\config.php","/imagem/","imagem\\index.php"
"index.php","/lojas/admin.php","lojas\\admin.php"
"index.php","/lojas/planos.php","lojas\\planos.php"
"lojas\admin\editar_loja.php","../img/default-logo.png","lojas\admin\..\\img\\default-logo.png"
"lojas\admin\lojas.php","../img/logo-galeria.png","lojas\admin\..\\img\\logo-galeria.png"
"lojas\admin\revisao_imagens.php","[","lojas\admin\[\index.php"
"lojas\admin\revisao_imagens.php","d.url;","lojas\admin\d.url;"
"lojas\admin\produtos.php","e.target.result;","lojas\admin\e.target.result;"
"lojas\painel_cliente.php","detalhes_pedido.php","lojas\detalhes_pedido.php"
"lojas\includes\template_loja_padrao.php","../img/placeholder.png","lojas\includes\..\\img\\placeholder.png"
"lojas\includes\template_loja_padrao.php","img;","lojas\includes\img;\index.php"
"lojas\visualizador_status.php","story.midia_url;","lojas\story.midia_url;"
"lojas\sucesso.php","urlWhats;","lojas\urlWhats;\index.php"
"sites\index.php","/manifest.webmanifest","manifest.webmanifest"
"admin\painel_supremo.php","/PARA_FELIPE.md","PARA_FELIPE.md"
"checkout.php","r.redirect","r.redirect"
"sites\index.php","about:blank","sites\about:blank\index.php"
"sites\index_backup.php","admin.php","sites\admin.php"
"sites\admin\sidebar.php","configuracoes.php","sites\admin\configuracoes.php"
"sites\admin\sidebar.php","portfolio.php","sites\admin\portfolio.php"
"sites\index_backup.php","dominios.php","sites\dominios.php"
"sites\index_backup.php","hospedagem.php","sites\hospedagem.php"
"sites\index_backup.php","login.php","sites\login.php"
"sites\index.php","url;","sites\url;\index.php"
"sites\index.php","v;s=b.getElementsByTagName(e)[0];","sites\v;s=b.getElementsByTagName(e)[0];"
"ferramentas\texto\formatador_html.php","/sobre","sobre\index.php"
"softwares\software\index.php","/software/apps/agenda_pro.php","software\\apps\\agenda_pro.php"
"softwares\software\index.php","/software/apps/api_manager.php","software\\apps\\api_manager.php"
"softwares\software\index.php","/software/apps/crm_lite.php","software\\apps\\crm_lite.php"
"softwares\software\index.php","/software/apps/hub.php","software\\apps\\hub.php"
"softwares\software\index.php","/software/apps/os_service.php","software\\apps\\os_service.php"
"softwares\software\register.php","/software/login.php","software\\login.php"
"softwares\software\login.php","/software/register.php","software\\register.php"
"softwares\ponto\login_painel.php","alterar_senha_editor.php","softwares\ponto\alterar_senha_editor.php"
"softwares\ponto\saas_index.php","saas_meu_painel.php","softwares\ponto\saas_meu_painel.php"
"softwares\software\apps\hub.php","api_manager.php","softwares\software\apps\api_manager.php"
"softwares\software\ponto\login_painel.php","alterar_senha_editor.php","softwares\software\ponto\alterar_senha_editor.php"
"ferramentas\config.php","/texto/","texto\\index.php"
"admin_dashboard.php","url;","url;\index.php"

```
# Atualizacao operacional - 2026-06-12

## Meta ativa

Auditar, corrigir, limpar, documentar, fortalecer e publicar o Minike de ponta a ponta, com foco em seguranca, estabilidade, experiencia visual, observabilidade, competitividade e operacao sustentavel na Hostinger.

## Auditoria completa desta rodada

- Inventario confirmado: ecossistema PHP modular com 1.120 arquivos PHP ativos validados, mais jogos, imagens, scripts e modulos auxiliares.
- Validacao estatica: 1.120 arquivos PHP sem erro de sintaxe; `sw.js`, `softwares/apyfy/main.js` e `manifest.webmanifest` validos.
- Repositorio Git local ainda sem commit inicial e sem remoto; arquivos sensiveis e gerados permanecem ignorados.
- Criado `includes/admin_security.php` com CSRF reutilizavel e auditoria administrativa sem segredos.
- Protegidos com CSRF e trilha de auditoria: Campanha, Imperio e Prova Social.
- `ferramentas/health.php` agora exige `MINIKE_DIAGNOSTIC_TOKEN`; reparo so pode ser disparado por POST autenticado.
- `log_viewer.php` teve logout corrigido, selecao de arquivo limitada a logs conhecidos, limpeza migrada de GET para POST com CSRF e carregamento do `.env` corrigido.
- `includes/self_heal.php` agora gera ID de correlacao por requisicao, headers defensivos, log compacto de acesso com status/duracao/memoria, captura de excecoes, fatais e alertas administrativos.
- Instaladores `sites/install_db.php` e `escolar/setup_db.php` agora funcionam apenas em CLI. O instalador Escolar passou a ler banco e usuario do ambiente.
- Confirmado que os comandos FFmpeg montam argumentos com `escapeshellarg`; uso de shell e intencional e isolado.
- Fotos de ponto nos tres clones de `salvar_ponto.php` e em `softwares/ponto/saas_camera.php` agora aceitam apenas JPEG base64 valido, com limite de 5 MB, decodificacao estrita e validacao por assinatura real da imagem.
- Logs de producao revelaram e permitiram corrigir quatro bugs de execucao: MMC/MDC, Calculadora de Areas, fallback do registro mestre de Lojas e carregamento tardio do motor de anuncios no Escolar.
- Auditoria do mesmo padrao corrigiu outras 17 ferramentas que fechavam PHP logo apos `ob_start()`, exibiam atribuicoes como texto e deixavam variaveis indefinidas: oito ferramentas de texto, tres de desenvolvedor, uma de jogos e cinco calculadoras/diversas.
- Smoke tests apos as correcoes: MMC/MDC, Calculadora de Areas, Lojas e pagina de materia Escolar retornaram HTTP 200 sem novos avisos no log.
- Riscos ainda acompanhados: uploads base64 precisam de limite uniforme em todos os clones do Ponto; redirecionadores de anuncios externos devem evoluir para assinatura HMAC; a criacao automatica de schema durante requests deve virar migracao versionada.
- Producao localizada em `/home/u340626637/domains/minike.com.br/public_html`, PHP 8.3.30.
- Deploy de 2026-06-12 concluido com backup em `/home/u340626637/backups_codex/minike_pre_deploy_20260612_091611.tar.gz`.
- Validacao remota: 1.459 arquivos PHP aprovados, zero erros. Foi removido o backup remoto obsoleto `sql/sites/index_backup.php`.
- Correcao exclusiva de producao: comentario de cron em `lojas/Loja195/sync_cron.php` continha `*/5` dentro de bloco PHP e encerrava o comentario; texto corrigido sem alterar a logica.
- Smoke tests de producao aprovados com HTTP 200: home, API health, status, checkout, Ferramentas, Games, Cursos, Escolar, Lojas e Softwares.
- Controles negativos aprovados: `/ferramentas/health.php` retorna 403 sem token; `/sites/install_db.php` e `/escolar/setup_db.php` retornam 404 na web.
- Headers observados em producao: `X-Request-ID` e `X-Content-Type-Options: nosniff` nas rotas que usam o bootstrap central.
- Credenciais nunca devem ser copiadas para esta documentacao, logs, Git ou arquivos publicos. A senha SSH informada na conversa deve ser rotacionada apos a manutencao.

## Pesquisa de mercado - fontes consultadas em 2026-06-12

- Shopify: POS, inventario, analytics, automacao e operacao omnichannel: https://www.shopify.com/pk/blog/point-of-sale-system
- Canva: criacao por IA, resultados editaveis, colaboracao e sites: https://www.canva.com/canva-ai/ e https://www.canva.com/website-builder/
- Odoo: suite integrada de CRM, ERP, ecommerce, estoque, projetos e PDV: https://www.odoo.com/ e https://www.odoo.com/documentation/19.0/applications/sales/point_of_sale.html
- HubSpot: CRM unificado, automacao, lead scoring, marketing, vendas e atendimento: https://www.hubspot.com/products/crm e https://www.hubspot.com/products/marketing
- iFood: pedidos, cardapio, logistica, pagamentos, dados e marketing para restaurantes: https://institucional.ifood.com.br/restaurantes/as-vantagens-que-o-ifood-oferece-aos-negocios-parceiros-2/
- Hotmart: produtos digitais, area de membros, comunidade, afiliados, suporte e analytics: https://hotmart.com/pt-br/plataforma-de-produtos-digitais
- Google Workspace for Education: colaboracao, gestao de aulas, seguranca e analytics: https://knowledge.workspace.google.com/admin/getting-started/editions/google-workspace-for-education-overview
- Nuvemshop: checkout, IA, pagamentos, envios, marketing, atendimento e canais integrados: https://www.nuvemshop.com.br/funcionalidades

## 50 melhorias necessarias e priorizadas

1. **P0 - Conta unica Minike:** unificar login, perfil, permissoes e sessoes entre todos os modulos.
2. **P0 - RBAC real:** substituir flags de sessao dispersas por papeis e permissoes centralizados.
3. **P0 - CSRF universal:** aplicar o helper novo a todo POST administrativo e operacao destrutiva.
4. **P0 - Rate limiting:** limitar login, recuperacao de senha, APIs, webhooks e geracao de arquivos.
5. **P0 - Upload seguro unico:** validar tamanho, MIME real, dimensoes, extensao, quota e armazenamento fora da area executavel.
6. **P0 - Migracoes versionadas:** retirar CREATE/ALTER TABLE do caminho normal das paginas.
7. **P0 - Segredos gerenciados:** inventario, rotacao, validacao de presenca e bloqueio de deploy com placeholders.
8. **P0 - Assinatura de redirects:** links externos de anuncios e afiliados devem usar HMAC, validade e allowlist.
9. **P0 - Webhooks idempotentes:** validar assinatura, timestamp, replay e chave idempotente em todo gateway.
10. **P0 - Backup restauravel:** backup diario de arquivos e banco, criptografado, com teste mensal de restauracao.
11. **P1 - Observabilidade unificada:** painel de erros, latencia, taxa de falha, jobs, pagamentos e integracoes.
12. **P1 - Health checks profundos:** separar liveness, readiness e dependencia externa.
13. **P1 - Alertas externos:** enviar incidentes criticos por e-mail/WhatsApp/Telegram com deduplicacao.
14. **P1 - Auditoria imutavel:** registrar ator, acao, alvo, resultado, IP hash e request ID.
15. **P1 - Feature flags:** liberar recursos por porcentagem, plano, cliente ou ambiente com rollback rapido.
16. **P1 - CI/CD:** lint, testes, analise de seguranca, pacote, backup, deploy e smoke test automatizados.
17. **P1 - Ambiente staging:** homologacao com dados anonimizados antes da producao.
18. **P1 - Testes E2E:** cobrir cadastro, login, checkout, pagamento, webhook, entrega e download.
19. **P1 - Design system:** tokens, componentes, formularios, tabelas, modais, estados e acessibilidade unificados.
20. **P1 - Feedback visual padrao:** loading, sucesso, erro, vazio, offline, retry e codigo de suporte/request ID.
21. **P1 - Mobile first:** revisar tabelas, paines, PDV, camera, checkout e editores em telas pequenas.
22. **P1 - Acessibilidade WCAG 2.2 AA:** teclado, foco, contraste, labels, landmarks e reduced motion.
23. **P1 - Performance budget:** metas de LCP, INP, CLS, peso JS/CSS/imagem e consultas lentas.
24. **P1 - Imagens modernas:** WebP/AVIF, thumbnails, lazy loading, srcset e compressao automatica.
25. **P1 - Busca global:** localizar ferramentas, cursos, produtos, lojas, pedidos, clientes e documentos.
26. **P1 - Dashboard executivo:** receita, conversao, churn, CAC, LTV, uso e saude por modulo.
27. **P1 - Analytics de funil:** origem, ativacao, uso principal, paywall, checkout, pagamento e retencao.
28. **P1 - CRM 360:** contato unico com historico de compras, tickets, cursos, lojas e campanhas.
29. **P1 - Automacoes por gatilho:** lead scoring, tarefas, e-mails, recuperacao e segmentacao comportamental.
30. **P1 - Atendimento omnichannel:** caixa unica para site, e-mail e WhatsApp, SLA e base de conhecimento.
31. **P1 - Checkout em menos etapas:** compra convidado, PIX/cartao, recuperacao e confirmacao em tempo real.
32. **P1 - Assinaturas completas:** upgrade, downgrade, prorata, retry, dunning, pausa e cancelamento self-service.
33. **P1 - Marketplace integrado:** produtos digitais, cursos, templates, servicos e afiliados na mesma vitrine.
34. **P1 - Area de membros moderna:** trilhas, progresso, comunidade, lives, certificados e recomendacoes.
35. **P1 - Editor assistido por IA:** gerar/copiar/revisar paginas, anuncios, aulas e descricoes com edicao estruturada.
36. **P1 - Templates colaborativos:** versoes, comentarios, duplicacao, permissao e historico, como Canva.
37. **P2 - Omnichannel de lojas:** estoque e pedidos sincronizados entre online, PDV, social e WhatsApp.
38. **P2 - Previsao de estoque:** alertas, curva ABC, demanda, ruptura e sugestao de compra.
39. **P2 - Fidelidade:** pontos, niveis, cashback, cupons, indicacao e carteira Minike.
40. **P2 - Delivery operacional:** mapa, despacho, ETA, agrupamento, rastreio e prova de entrega.
41. **P2 - KDS/cozinha:** fila por setor, tempo de preparo, prioridade e tela de expedicao.
42. **P2 - Autoatendimento:** QR por mesa, pedido proprio, combos e pagamento na mesa.
43. **P2 - Escolar integrado:** turmas, tarefas, notas, responsaveis, calendario, mensagens e analytics.
44. **P2 - IA educacional:** feedback personalizado, recomendacao de estudo e deteccao de lacunas.
45. **P2 - API publica versionada:** OAuth2, scopes, quotas, webhooks, sandbox e documentacao OpenAPI.
46. **P2 - App/PWA consistente:** instalacao, offline util, push opt-in, sincronizacao e atualizacao controlada.
47. **P2 - Internacionalizacao completa:** textos, moeda, fuso, impostos, formatos e gateways por pais.
48. **P2 - LGPD operacional:** consentimento, exportacao, exclusao, retencao, base legal e registro de tratamento.
49. **P2 - Marketplace de extensoes:** conectores e modulos instalaveis com permissoes e atualizacao segura.
50. **P2 - Copiloto Minike:** assistente contextual que consulta dados autorizados e executa tarefas com confirmacao e auditoria.

## Limpeza e regra documental

- Este e o unico arquivo Markdown oficial do projeto.
- Documentos-fonte ja consolidados podem ser removidos da arvore ativa; o historico consolidado permanece abaixo neste arquivo.
- Backups soltos dentro de pastas publicas devem ser removidos depois do backup de deploy.
- Relatorios temporarios CSV, HTML de captura, caches e logs nao pertencem ao pacote de publicacao.
- Dados de usuarios, uploads, `.env`, cache operacional e logs de producao nunca devem ser sobrescritos pelo deploy.

## Opiniao tecnica e direcao futura

O Minike tem uma amplitude rara para um projeto independente: ha produto real em ecommerce, educacao, ferramentas, software empresarial, anuncios e delivery. A maior forca e o ecossistema; a maior fraqueza e a mesma amplitude sem uma plataforma central suficientemente firme. O proximo salto nao vem de adicionar mais paginas, mas de transformar os modulos existentes em um produto coerente: identidade unica, dados unificados, design system, automacoes, observabilidade e uma jornada comercial simples.

A direcao que considero mais valiosa e posicionar o Minike como uma plataforma operacional acessivel para pequenos negocios brasileiros, com tres portas de entrada claras: vender, administrar e aprender. Ferramentas gratuitas atraem; Loja/Delivery/ERP resolvem a operacao; Cursos/Escolar aumentam retencao; Ads/CRM/automacoes geram crescimento. Um copiloto de IA deve chegar depois dessa base, usando dados confiaveis e permissoes rigorosas, nao como camada decorativa.

# Rodada de experiencia multiplataforma - 2026-06-12

## Meta da rodada

Auditar e completar o Minike usando este documento como memoria obrigatoria, validando documentacao, layouts, botoes, links, formularios e jornadas reais em desktop, Android e iPhone; corrigir os problemas encontrados, testar novamente, criar backup, publicar na Hostinger e revalidar a producao como usuario.

## Criterios de aceite

- Este arquivo continua sendo a unica documentacao oficial e deve receber cada decisao, correcao, teste e pendencia relevante.
- As rotas publicas principais devem abrir sem erro HTTP, erro JavaScript, vazamento de codigo, overflow horizontal ou elementos interativos fora da tela.
- Links e botoes internos devem apontar para destinos existentes; links externos devem ser validos e seguros.
- Desktop deve ser testado em viewport 1440x900.
- Android deve ser testado com perfil Pixel 7/Chrome, toque e viewport movel.
- iPhone deve ser testado com perfil iPhone 13/WebKit, toque, safe area e viewport movel.
- Jornadas minimas: home, navegacao global, ferramentas, jogos, cursos, escolar, lojas, softwares, planos, checkout, login, termos, privacidade, status e paginas de erro.
- Formularios publicos devem ter labels/nomes, feedback visual e comportamento seguro sem enviar dados destrutivos durante o teste.
- Antes do deploy deve existir validacao estatica completa e backup remoto.
- Depois do deploy os mesmos testes devem rodar contra producao, e os resultados devem ser registrados aqui.

## Diario da rodada

- Documentacao-mestre relida antes de qualquer alteracao.
- Estado inicial confirmado: repositorio local sem commit inicial; producao anterior validada; Playwright ainda nao estava instalado.
- Decisao: criar uma suite E2E permanente e reutilizavel, mantendo resultados e capturas fora do pacote publico.

# Rodada Super Admin e migracao Beico - 2026-06-14

## Meta operacional

Criar a base do Super Admin do ecossistema Minike e iniciar a migracao segura do Beico Chapa Lanche da Galeria195 para o projeto principal, sem apagar nem derrubar a loja atual da Galeria.

## Entregas registradas

- `includes/access_control.php` criado como fonte central de papeis.
- `mk_usuarios.tipo_conta` passa a aceitar papeis flexiveis via `VARCHAR(50)`.
- Criadas colunas de controle `super_admin`, `senha_troca_obrigatoria` e `senha_trocada_em`.
- Login normaliza papeis, redireciona admins para `admin/painel_supremo.php` e forÃ§a troca de senha quando necessario.
- Criada tela `alterar_senha_primeiro_acesso.php`.
- `admin/painel_supremo.php` ganhou a secao Governanca e selects com todos os papeis.
- Criado alias `admin/super-admin.php`.
- Criado script `scripts/minike-create-super-admin.php` sem senha fixa no codigo.
- Criado script `scripts/beico-migration-dry-run.php` para inventario sem escrita.

## Usuario Super Admin

- E-mail: `Felipegabriel02082002@gmail.com`.
- Papel: `super_admin`.
- Primeiro acesso deve exigir troca de senha definitiva.
- A senha provisoria nao deve ser registrada em documentacao nem Git.

## Backup antes do banco

Backup das tabelas `mk_usuarios` e `usuarios` criado em:

`/home/u340626637/backups_codex/minike_users_before_super_admin_20260614_132514.sql`

## Migracao Beico Chapa Lanche

Origem encontrada:

- Projeto: Galeria195.
- Pasta: `beiochapalanche/index.php`.
- Loja: `id_desta_loja = 11`.
- Template: `includes/template_loja_padrao.php`.

Conclusao: a migracao depende do banco da Galeria, principalmente loja, produtos, postagens, pedidos PDV, itens, pagamentos, caixa, mesas e adicionais.

Regra obrigatoria: manter Galeria ativa. A migracao para Minike deve ocorrer em paralelo, com backup, mapa de IDs, validacao visual/PDV/relatorios/mobile e aceite antes de qualquer redirecionamento.

Dry-run em producao executado em 2026-06-14:

- Origem: `/home/u340626637/domains/galeria195.com.br/public_html`.
- Loja: `BeiÃ§o Chapa Lanche`, id `11`, pasta `beiochapalanche`, status `ativo`.
- Inventario: `21` produtos, `30` postagens, `513` pedidos PDV, `1013` itens PDV, `443` pagamentos PDV, `13` caixas, `10` mesas e `6` adicionais.
- Destino Minike: nenhum registro conflitante em `lojas` ou `mk_lojas` com slug/pasta `beiochapalanche`.
- Acao segura seguinte: backup completo da Galeria, criacao da loja destino e migracao com mapa `source_id -> dest_id`; Galeria permanece em funcionamento ate aceite.

## Arquitetura Softwares x Delivery

- `softwares/` fica como hub/vitrine comercial dos sistemas Minike.
- `delivery/` fica como projeto operacional proprio, ligado ao hub, mas com pasta e subdominio separados.
- `delivery.minike.com.br` e voltado a lanchonetes, restaurantes, pizzarias, hamburguerias, cafeterias e cozinhas pequenas.
- Criado `includes/minike_systems.php` para registrar sistemas, hubs, pastas e subdominios.
- O Painel Supremo passa a usar esse registro central para listar subsites.
- Criado `delivery/.htaccess` para hardening local do projeto Delivery.
- A home do Delivery foi ajustada para explicar foco em alimentacao e remover anuncios fora de demo/free/trial.

# Integracao APIFY como skill local - 2026-06-14

## Origem analisada

- Pasta recebida: `APIFY/`.
- Projeto util encontrado: `APIFY/apyfy/main.js` com `package.json`.
- Natureza: extrator Node/Playwright de leads B2B com Google Maps, cascata Bing/Yahoo/UOL/DuckDuckGo, enriquecimento por BrasilAPI/CNPJ.ws/ReceitaWS, ViaCEP, site da empresa, blacklist e exportacao Excel.
- Itens sem valor para producao: `APIFY/.vs/` e arquivos de estado do Visual Studio. A regra `.gitignore` passou a bloquear `.vs/` e `**/.vs/`.

## Decisao de arquitetura

- A ferramenta nao foi exposta como scraper publico em subdominio, porque consome navegador, CPU, rede, pode tocar termos de plataforma e envolve dados pessoais/comerciais.
- A ferramenta foi integrada como skill e ferramenta local da Mike IA Local, com execucao visivel no computador do usuario.
- A IA local mostra a ferramenta na aba `Internet e ferramentas`, abre uma janela PowerShell interativa e exige confirmacao antes de iniciar.
- O Excel e salvo em `local-tools/leads-b2b/runs` dentro da instalacao local da Mike.
- A ferramenta nao envia mensagens automaticamente aos leads; qualquer abordagem comercial exige revisao humana, base legal, blacklist, volume moderado e opt-out.

## Arquivos criados ou alterados

- `local-ai/mike-local-ai-minike.ps1`: cria `local-tools/leads-b2b`, instala/copia `APIFY/apyfy/main.js` e `package.json`, gera `run-leads-b2b.ps1`, cria a skill `leads_b2b_local.json`, adiciona rotas locais `/tools/leads-b2b/status` e `/tools/leads-b2b/start` e adiciona botao na UI local.
- `local-ai/leads-b2b.php`: landing publica da skill, explicando execucao local, monetizacao e seguranca.
- `local-ai/index.php`: link para a pagina do extrator e card de uso.
- `includes/local_ai_catalog.php`: adiciona perfil `leads_b2b`, fontes e `local_tools` no manifesto publico.
- `includes/local_ai_skills.php`: adiciona a skill paga `leads_b2b_local` por R$ 59,90, liberada tambem por planos com acesso total.
- `community-skills/published/leads-b2b-local/skill.json` e `SKILL.md`: pacote publicado da skill.
- `community-skills/index.json`: publica a skill no indice.

## Testes locais executados

- `php -l` em `local-ai/index.php`, `local-ai/leads-b2b.php`, `local-ai/skills.php`, `includes/local_ai_catalog.php`, `includes/local_ai_skills.php` e `api/local-ai.php`: sem erros.
- `powershell -File local-ai/mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies`: script do agente local parseavel.
- `node --check APIFY/apyfy/main.js`: parse JavaScript sem erro.
- `GET /local-ai/leads-b2b.php`: HTTP 200 e conteudo do Extrator B2B presente.
- `GET /local-ai/skills.php`: HTTP 200 e skill presente.
- `GET /api/local-ai.php?action=skills-store`: HTTP 200 e `leads_b2b_local` presente.
- `GET /api/local-ai.php?action=manifest`: HTTP 200 e `leads-b2b-local` presente em `local_tools`.

## Pendencias operacionais

- No primeiro uso real em computador de cliente, o launcher pode instalar dependencias com `npm install` e `playwright install chromium`; isso deve ficar visivel ao usuario.
- Para planos pagos, a liberacao continua dependendo da confirmacao de pagamento pelo checkout/gateway ou acesso total em Business/Elite.
- Antes de campanhas comerciais, revisar textos de LGPD/anti-spam e criar modelos de abordagem com opt-out.

# Limpeza segura da pasta ativa - 2026-06-14

## Quarentena criada

- Caminho: `\\srvtotali\Docs\PASTA COMPARTILHADA\Felipe\ia\minike-quarentena-20260614-164247`.
- Inventario externo: `inventory.json` dentro da quarentena.
- Motivo: remover da arvore ativa arquivos de IDE, relatorios gerados, scripts antigos de operacao SSH/FFmpeg e documentos soltos ja consolidados aqui.
- Nao houve exclusao definitiva; os itens foram movidos para recuperacao se necessario.

## Itens movidos

- `APIFY/.vs`
- `test-results`
- `playwright-report`
- `COMANDOS_SSH.sh`
- `INSTALL_SSH.sh`
- `INSTALL_FFMPEG_HOSTINGER.sh`
- `docs/SUPER_ADMIN_MINIKE_2026-06-14.md`
- `docs/PLANO_ACAO_SOFTWARES_MINIKE_2026-06-14.md`
- `docs/MIGRACAO_BEICO_CHAPA_LANCHE_2026-06-14.md`
- `docs/ARQUITETURA_SISTEMAS_MINIKE_2026-06-14.md`
- `softwares/editor/README (1).md`
- `softwares/editor/instrucoes-atualizacao.txt`

## Itens preservados por serem ativos

- `DOCUMENTACAO_MESTRE_MINIKE.md` como documentacao oficial unica.
- `community-skills/README.md`, `community-skills/templates/SKILL.md` e `community-skills/published/*/SKILL.md`, pois fazem parte do sistema de skills e sao consumidos por usuarios/autores.
- `ads.txt` de sites/subsites, pois fazem parte da operacao de publicidade.
- `node_modules`, `logs`, `cache`, `uploads`, `.env` e artefatos locais ficam fora do pacote/deploy por `.gitignore` e regras de empacotamento, mas nao foram apagados.
- `APIFY/APIFY.BAT` foi corrigido para rodar relativo a propria pasta e instalar dependencias locais quando necessario.

# Deploy Hostinger e validacao de producao - 2026-06-14

## Pacote e envio

- Pacote enviado para a conta Hostinger: `minike-atualizado-com-apify-financeiro-20260614-164455.zip`.
- Conteudo do pacote: 1350 arquivos, cerca de 30,52 MB.
- SHA-256 do pacote enviado: `CFFE911494921DD51F7561B4C13CF566988A533423CD0079DC6BA002055D3608`.
- Excluidos do pacote: `.git`, `.env`, `node_modules`, `vendor`, `atendimento`, `logs`, `cache`, `uploads`, `test-results`, `playwright-report`, `coverage`, `.vs` e arquivos compactados/backups.
- Pacote final arquivado no diretorio pai e tambem enviado para `/home/u340626637`: `minike-final-com-apify-financeiro-deployado-20260614-*.zip`, sempre acompanhado do respectivo `.sha256`.
- O pacote final inclui o ajuste de `.htaccess` que libera apenas `DOCUMENTACAO_MESTRE_MINIKE.md` entre os arquivos Markdown, preservando a base oficial da IA sem abrir documentos internos.

## Backup remoto antes do deploy

- Backup criado em: `/home/u340626637/backups_codex/minike_before_deploy_20260614-164455.tar.gz`.
- Escopo: `domains/minike.com.br/public_html`, excluindo uploads, logs, cache, node_modules, vendor e relatorios temporarios.
- Deploy extraido em: `/home/u340626637/deploys/minike_20260614-164455`.
- Sincronizacao aplicada em: `/home/u340626637/domains/minike.com.br/public_html`.

## Scripts remotos executados

- `php scripts/minike-finance-vault.php init`: cofre pronto; chave mestre criada no ambiente remoto sem exibir valor.
- `php scripts/apply-annual-discount.php`: desconto anual de 30% aplicado nas tabelas `planos` e `mk_planos`.
- `php scripts/process-credit-billing.php`: 0 faturas em atraso processadas no momento da validacao.

## Gateways ainda pendentes de credenciais

- InfinitePay: falta `infinitepay_handle`.
- NuPay/Nubank: faltam `nupay_merchant_key` e `nupay_merchant_token`.
- Asaas/boleto: faltam `asaas_api_key` e `asaas_webhook_token`.
- PIX manual: falta `pix_chave`.
- Hotmart: faltam `hotmart_checkout_url_brl` e `hotmart_hottok`.
- Monetizze: faltam `monetizze_checkout_url` e `monetizze_postback_key`.

Esses dados devem ser inseridos pelo Super Admin na tela financeira. Segredos nao devem ser registrados neste documento.

## Smoke test em producao

Rotas com HTTP 200:

- `https://minike.com.br/`
- `https://minike.com.br/local-ai/`
- `https://minike.com.br/local-ai/leads-b2b.php`
- `https://minike.com.br/local-ai/skills.php`
- `https://minike.com.br/api/local-ai.php?action=manifest`
- `https://minike.com.br/api/local-ai.php?action=skills-store`
- `https://minike.com.br/planos.php?lang=pt&currency=BRL`
- `https://minike.com.br/minha-cobranca.php`
- `https://minike.com.br/cadastro-empresa.php`
- `https://minike.com.br/termos.php?lang=pt`
- `https://minike.com.br/privacidade.php?lang=en`
- `https://ferramentas.minike.com.br/`
- `https://delivery.minike.com.br/`
- `https://softwares.minike.com.br/`

Documentacao e hardening:

- `.htaccess` da raiz bloqueia arquivos `.md` por padrao para nao expor documentacao interna, templates de comunidade ou notas soltas.
- Excecao consciente: `DOCUMENTACAO_MESTRE_MINIKE.md` fica publica em `https://minike.com.br/DOCUMENTACAO_MESTRE_MINIKE.md`, pois e a base unica de conhecimento que alimenta manutencao, IA local, Mike e proximas rodadas.
- Demais Markdown continuam bloqueados; se uma skill precisar publicar instrucao, deve expor resumo por API/catalogo, nao o arquivo bruto automaticamente.

Rotas sensiveis bloqueando GET:

- `https://minike.com.br/api/cnpj-lookup.php`: 405.
- `https://minike.com.br/webhooks/asaas.php`: 405.
- `https://minike.com.br/api/webhook_pagamentos.php`: 405.
- `https://minike.com.br/api/mercado_pago/webhook.php`: 403 na borda LiteSpeed/Hostinger, seguro para GET e aceito pela suite como bloqueio.

## Playwright em producao

Suite focada `tests/e2e/public-experience.spec.js` com base `https://minike.com.br`:

- Desktop Chromium: 6/6 testes passaram.
- Android Pixel 7/Chromium: 6/6 testes passaram.
- iPhone 13/WebKit: 6/6 testes passaram.

Cobertura desta rodada: planos, campanha/privacidade BR/EUA, checkout de apoio, bloqueio de webhooks/consulta CNPJ via GET, cadastro empresarial sem promessa de credito automatico e termos de cobranca.

## Cron recomendado na Hostinger

Configurar no painel de Cron Jobs da Hostinger:

`php /home/u340626637/domains/minike.com.br/public_html/scripts/process-credit-billing.php`

Frequencia recomendada: diaria, por exemplo 03:10 America/Sao_Paulo. O processamento tambem pode ser acionado manualmente no Painel Supremo.

# Identidade visual, hub principal e assistente flutuante - 2026-06-14

## Direcao visual

- A home `https://minike.com.br/` deve ser tratada como hub/vitrine empresarial do ecossistema Minike, nao como pagina de testes soltos.
- Hierarquia definida: Mike IA Local, Softwares Empresariais, Atendimento AI, Ferramentas, Mini-Lojas, Planos e Afiliados.
- O visual deve comunicar empresa seria, catalogo amplo, tecnologia propria e operacao para negocios no Brasil e EUA.

## Alteracoes implementadas

- `index.php`: hero reescrito para posicionar o Minike como hub empresarial, com botao principal para `Baixar IA Local`, catalogo mais direto e menos blocos promocionais no meio da pagina.
- `includes/minike-nav.php`: adicionada entrada `IA Local` na navegacao desktop e o CTA central mobile passou a apontar para a IA Local.
- `local-ai/index.php`: landing simplificada com downloads diretos do instalador CMD para Windows e SH para Linux, mais comandos copiaveis para CMD, PowerShell e terminal Linux. Assim o cliente possui caminhos alternativos quando o navegador ou a execucao por duplo clique bloquear o arquivo.
- Cada comando e completo e especifico para seu terminal. O botao PowerShell copia uma expressao iniciada por `$p=...` e chama explicitamente `powershell.exe`; nunca entrega apenas argumentos como `-NoProfile`, que seriam invalidos quando colados diretamente no prompt.
- `local-ai/baixar.php`: endpoint de download com `Content-Disposition`, selecao `?os=windows` ou `?os=linux` e bloqueio de cache para entregar sempre o instalador atual.
- `local-ai/instalar-mike-windows.cmd`: instalador visual para Windows 10 22H2/11 e verificador de compatibilidade para Windows 7/8. Mostra percentual, diagnostico e bloco `ACAO NECESSARIA`; o nucleo interno permanece automatizado e nao precisa ser copiado pelo cliente.
- `local-ai/instalar-mike-linux.sh`: instalador visual para Linux x86_64/arm64, detecta distribuicao, RAM, CPU, disco e GPU, escolhe modelo, instala/reutiliza Ollama e cria interface local.
- Compatibilidade oficial respeitada: Ollama para Windows exige Windows 10 22H2 ou mais novo. Windows 7/8 nao recebem instalacao forcada de binario moderno; o CMD verifica ambiente existente e orienta atualizacao ou modo online.
- `includes/mike_assistant_widget.php`: robozinho flutuante do Mike com perguntas prontas, respostas rapidas, ofertas controladas, link para baixar IA Local, ferramentas, WhatsApp, planos e skills.
- O robo flutuante foi reduzido para nao cobrir conteudo; a dica desaparece automaticamente e o antigo balao duplicado de WhatsApp fica desativado.
- A interface local agora possui rolagem vertical propria em todas as abas. O menu lateral e a barra superior permanecem fixos, enquanto o conteudo responde a mouse, touchpad e toque.
- O Windows instala a Mike como aplicativo local: cria icone Minike na Area de Trabalho e no menu Iniciar, inicia o agente em segundo plano e abre Edge/Chrome em modo `--app`, sem aba ou barra de endereco. Se nenhum desses motores existir, usa o navegador padrao como contingencia e avisa o usuario.
- O Linux tambem cria lancador e icone Minike no menu de aplicativos e no Desktop quando disponivel. Chrome, Chromium, Edge ou Brave abrem a interface em modo aplicativo; `xdg-open` permanece somente como contingencia.
- macOS foi confirmado como plataforma oficial do Ollama a partir do macOS 14 Sonoma. Deve receber instalador proprio `.command`/`.app`; versoes anteriores nao devem receber promessa de instalacao local completa.
- As ferramentas do catalogo abrem em um navegador interno da propria Mike, com voltar, recarregar, fechar e fallback externo. O iframe e limitado aos dominios Minike e usa sandbox; pagamentos, bancos ou terceiros que bloqueiem incorporacao continuam externos.
- `ferramentas/.htaccess` libera enquadramento somente quando o `Referer` e o Mike local em `127.0.0.1:47885`/`localhost:47885`. Para os demais sites permanece `X-Frame-Options: SAMEORIGIN` e CSP `frame-ancestors`.
- Android deve usar PWA autenticada e pareamento por QR com relay seguro para o PC; a porta local nao sera exposta diretamente na rede sem autenticacao. O processamento pesado continua no computador do cliente.
- `includes/minike_visual_fx.php`: efeito de entrada por scroll inspirado em AOS/ScrollMagic, usando IntersectionObserver proprio e respeitando `prefers-reduced-motion`.
- `includes/header-unificado.php`: CSS e logo agora carregam pelo dominio principal para evitar quebra de layout em subdominios.
- `softwares/style-global.php`: proxy local de CSS para compatibilidade no subdominio `softwares.minike.com.br`.
- `includes/style-global.css`: criada camada `MINIKE UTILITY COMPAT` para paginas antigas que usam classes tipo Tailwind sem carregar Tailwind por CDN.
- `softwares/index.php`: removidos blocos promocionais do meio da vitrine, reduzida a amostra do catalogo e melhorado o caminho para a colecao completa.

## Decisao tecnica sobre bibliotecas visuais

- Pesquisadas referencias: AOS, Anime.js, GSAP e ScrollMagic.
- Primeira versao usa CSS/JS proprio para nao depender de CDN em todos os sites e para manter performance, seguranca e estabilidade.
- Direcao futura: usar Anime.js ou GSAP apenas em paginas premium/campanhas especificas, onde animacao complexa realmente gere conversao.

# Mike Local - registro de capacidades multimodais e programacao - 2026-06-15

## Objetivo

Criar uma camada central e honesta para a Mike Local saber, mostrar e decidir o que ela ja consegue fazer, o que depende de modelo/dependencia e o que ainda e roadmap. Isso evita prometer que a LLM "entende tudo" enquanto a maquina nao possui OCR, transcritor, modelo multimodal, TTS ou gerador de imagens instalado.

## Arquivos adicionados/alterados

- `includes/local_ai_capabilities.json`: registro central de capacidades da Mike Local.
- `includes/local_ai_capabilities.php`: helper para ler o registro e gerar resumo.
- `api/local-ai-capabilities.php`: API publica dedicada do registro.
- `api/local-ai.php?action=capabilities`: mesma informacao integrada na API principal da IA local.
- `local-ai/index.php`: landing de instalacao passa a mostrar resumo de capacidades reais.
- `community-skills/published/multimodal-local/`: skill gratuita base para imagem, OCR, audio, fala e geracao de imagens.
- `community-skills/index.json` e `includes/local_ai_skills.php`: publicam a skill na loja.
- `includes/local_ai_catalog.php`: adiciona perfil/fonte `multimodal_local` e alinha manifesto do instalador em `2.3.0-minike`.
- `local-ai/mike-local-ai-minike.ps1`: adiciona arquivo local `capabilities.json`, rota `/capabilities` e aba `Capacidades` no app local.
- O chat local agora diferencia anexos de imagem, audio e PDF quando ainda nao ha extrator ativo, explicando qual modulo/modelo falta em vez de tratar tudo como arquivo generico nao convertido.
- `includes/product_roadmap.json`: novo item `MK-069`.

## Status real das capacidades

- Conversa local: disponivel, desde que Ollama/modelo local ou cloud autorizada esteja funcional.
- Programacao assistida: parcial disponivel. A Mike abre projetos autorizados, edita arquivos textuais, salva e revisa; editor Monaco, LSP completo e Codex embutido ainda seguem no roadmap.
- Upload de arquivos: parcial disponivel. Texto/codigo sao seguros primeiro; PDF, imagem e audio precisam extratores especificos.
- Entender imagens: depende de modelo multimodal compativel, por exemplo `gemma3:4b`, `gemma4:e2b` ou `ministral-3:3b`, ou provedor cloud autorizado.
- OCR: planejado como modulo opcional com Tesseract ou equivalente.
- Audio para texto: planejado como modulo opcional com whisper.cpp/FFmpeg ou equivalente.
- Texto para fala: planejado como modulo opcional com Piper ou voz do sistema.
- Gerar imagens: planejado como modulo opcional pesado, preferencialmente ComfyUI/local com GPU ou cloud BYOK.
- "Programar em todas as linguagens": definido como suporte assistido amplo, nunca garantia absoluta. A Mike deve detectar linguagem, consultar fonte oficial, rodar analisador/teste quando possivel e declarar limite.

## Politica de recursos

- Modo normal: reservar ate 50% do poder configurado para IA, mantendo computador utilizavel.
- Modo agentes: pode reservar ate 70% quando o usuario ativar e aceitar impacto.
- Reutilizar modelos ja instalados antes de baixar.
- Nao instalar modelo grande automaticamente em maquinas com menos de 16 GB de RAM.
- Rebaixar modelo/contexto/threads se a maquina estiver sobrecarregada.
- Arquivos privados permanecem locais ate o usuario aprovar envio a ferramenta, cloud ou provedor externo.

## Fontes oficiais iniciais

- Tesseract OCR: `https://github.com/tesseract-ocr/tesseract`
- Tesseract docs: `https://tesseract-ocr.github.io/tessdoc/Installation.html`
- whisper.cpp: `https://github.com/ggml-org/whisper.cpp`
- Piper TTS: `https://github.com/rhasspy/piper`
- Piper samples: `https://rhasspy.github.io/piper-samples/`
- ComfyUI: `https://github.com/Comfy-Org/ComfyUI`

## Proximas etapas tecnicas

1. Criar instaladores opcionais por modulo: OCR, transcricao, TTS e geracao de imagens.
2. Criar fila visual unica para trabalhos multimodais com progresso, cancelamento, logs e resultado revisavel.
3. Fazer o chat detectar anexos e sugerir instalacao segura quando faltar dependencia.
4. Criar testes locais para validar JSON, APIs PHP, manifesto e parse do instalador.

## Rodada complementar - modulos opcionais multimodais

Implementado no app local:

- `capability-jobs/`: pasta local para jobs de preparacao de modulos.
- `/capabilities`: agora retorna tambem `modules` e `jobs`.
- `/capabilities/modules/install`: prepara modulos opcionais. Tesseract OCR e FFmpeg tentam instalacao por `winget` quando disponivel; whisper.cpp, Piper e ComfyUI ficam como instalacao guiada ate haver instalador robusto por hardware.
- `/capabilities/jobs`: lista ultimos jobs de capacidades.
- `/capabilities/tts/speak`: teste real de fala local usando `System.Speech`/voz do Windows quando disponivel.
- Aba `Capacidades`: mostra jobs recentes, botao de teste de voz, botoes de preparar modulo, links para fontes oficiais e recomendacoes de modelos.

Fontes e decisoes:

- Tesseract: instalacao no Windows segue a documentacao oficial que referencia builds UB Mannheim.
- FFmpeg: modulo auxiliar para audio/video; preparacao automatica depende de `winget`.
- whisper.cpp: suporta Windows, Linux, macOS, Android e outros, mas pacote/build varia por plataforma; por isso fica guiado nesta fase.
- Piper: repositorio original esta arquivado, entao a Mike deve tratar como opcional e validar canal mantido antes de auto-instalar.
- ComfyUI: instalacao oficial suporta `comfy-cli`, mas e pesada; exige Python, modelos grandes e preferencialmente GPU. Fica guiada ate haver perfil por hardware.

## Ideias adicionais recomendadas pelo Codex

1. Criar tela "Laboratorio multimodal" para testar OCR/audio/imagem com arquivos de exemplo antes de usar dados reais.
2. Cache local de resultados por hash de arquivo para nao transcrever/OCRizar o mesmo arquivo duas vezes.
3. Fila unica de midia com prioridade baixa quando o usuario estiver usando muito CPU/RAM.
4. Botao "usar cloud so neste arquivo" com custo estimado e exclusao automatica apos o trabalho.
5. Perfil "PC fraco", "PC equilibrado" e "PC com GPU" com presets visuais.
6. Detector de formato real do arquivo, nao apenas extensao.
7. Extrator PDF separado para PDF texto e PDF escaneado.
8. Pre-visualizacao de OCR com edicao humana antes de salvar na memoria.
9. Transcricao com diarizacao/speaker labels como modulo futuro.
10. Historico de audios/imagens processados com botao apagar definitivo.
11. Politica de retencao por tipo de arquivo e por empresa.
12. Galeria local de imagens geradas com permissao de uso, prompt, modelo e seed.
13. Lista de modelos de imagem por peso: CPU leve, GPU media, GPU forte e cloud.
14. Central de custos para mostrar quanto economizou usando local vs cloud.
15. Verificador de licenca/modelo antes de vender uma skill que depende dele.
16. Conector de scanners/impressoras para empresas pequenas.
17. Captura de tela supervisionada para a Mike explicar erro visual do computador.
18. Modo acessibilidade com leitura de tela e comando de voz simples.
19. Dataset de teste multimodal Minike para validar regressao de OCR/audio/imagem.
20. Assinatura de modulos locais para impedir pacote adulterado da comunidade.

# Mike Local - Programar, testar projeto e cacar bugs - 2026-06-15

## Objetivo

Adicionar na aba `Programar` um fluxo pratico para o usuario testar codigos, encontrar erros e receber uma revisao objetiva da IA sem abrir terminal tecnico na frente dele.

## Implementado

- `local-ai/mike-local-ai-minike.ps1`:
  - nova rota local `POST /programming/test-project`;
  - funcao `Invoke-ProjectBugHunt`;
  - varredura de arquivos textuais suportados com os analisadores existentes;
  - execucao controlada de testes detectados;
  - resumo estruturado de erros, avisos, testes e revisao da IA;
  - botoes na aba `Programar`: `Testar projeto` e `Cacar bugs`.

## Regras de seguranca

- Para rodar testes, a pasta precisa ser marcada como projeto confiavel, porque testes podem executar codigo do proprio projeto.
- A interface pede confirmacao humana antes de confiar no projeto.
- A varredura ignora pastas pesadas/sensiveis como `.git`, `node_modules`, `vendor`, `dist`, `build`, `cache`, `logs`, `uploads`, `backups`, `coverage`, `.next` e `.nuxt`.
- O resultado aparece no painel de problemas/revisao, com resumo em linguagem humana e sem despejar terminal cru como experiencia principal.
- A IA recebe somente evidencias do teste/lint/log capturado; ela nao deve inventar erro, arquivo ou linha.

## Cobertura inicial

- PHP: `php -l` por arquivo e tentativa de `composer test`/PHPUnit quando detectado.
- JavaScript Node: `node --check` por arquivo e `npm test`/`npm run lint` quando scripts existem.
- Python: compilacao por arquivo via Python quando disponivel.
- PowerShell: parser nativo.
- JSON: parser nativo.
- HTML/CSS: checagens estruturais simples.
- Seguranca basica: detector de possiveis segredos hardcoded e TODO/FIXME.

## Proximas melhorias

1. Criar jobs persistentes de teste com progresso ao vivo, cancelamento e historico.
2. Adicionar botao `Corrigir com IA` a partir de cada erro.
3. Criar diff revisavel para correcoes sugeridas pelo cacador de bugs.
4. Integrar Playwright visual para sites e jogos.
5. Integrar testes de desktop com FlaUI/WinAppDriver quando o usuario autorizar.
6. Detectar frameworks especificos: Laravel, WordPress, React, Vite, Next, Vue, Django, Flask, FastAPI, .NET, Go, Rust e Java.
7. Criar checklist de release com `lint`, `test`, `build`, auditoria de segredo e smoke test local.

# Mike Local - Extrator estadual e ferramentas incorporadas - 2026-06-15

## Correcoes entregues

- Eliminado o erro `MINIKE_CONFIG_ERROR: Unexpected token BOM`: todo JSON novo e gravado em UTF-8 sem BOM, enquanto o Node remove o marcador de arquivos antigos antes de interpretar.
- Os JSON existentes da instalacao local foram normalizados sem apagar conversas, projetos, memoria ou trabalhos.
- O cancelamento do Extrator B2B agora protege explicitamente o PID do agente Mike e encerra somente o navegador e o worker da coleta.
- Ferramentas Minike recebem `mk_embed=local_ai`, usam layout compacto e abrem no painel interno da Mike. O CSP aceita somente `127.0.0.1:47885`, `localhost:47885` e a propria origem.

## Estado inteiro

- A tela oferece `Pesquisar o estado inteiro`.
- A lista de municipios vem da API oficial de Localidades do IBGE e fica em cache local por ate 30 dias.
- A coleta estadual exige uma UF especifica e cria uma fila de no maximo 1.000 municipios.
- O motor processa uma cidade por vez e aguarda no minimo 10 segundos antes de iniciar a seguinte.
- A interface mostra cidade atual, municipios concluidos/total, progresso, resultados vistos, leads salvos e atividade resumida.
- Cidade e bairro ficam em colunas separadas, entram na busca local e podem ser editados antes de exportar.
- A coleta continua sujeita aos termos, limites e bloqueios dos provedores consultados; o ritmo reduz carga, mas nao promete evitar bloqueios.

## Validacao executada

- Santa Catarina retornou 295 municipios oficiais, de `Abdon Batista` a `Zortea`.
- A coleta de teste iniciou o primeiro municipio em Chromium headless, sem erro de JSON.
- O cancelamento retornou `canceled` e a rota `/ui/status` permaneceu ativa.
- O instalador, o agente gerado, o JavaScript da interface, `main.js`, `export-results.mjs` e os layouts PHP passaram nos respectivos parsers.

# Mike Local - Codex embutido no Programar - 2026-06-15

## Entrega

- Versao local atualizada para `2.4.0-minike`.
- Novo bridge `local-ai/codex-app-server-bridge.mjs`, instalado em `%LOCALAPPDATA%\MINIKE-Local-AI`.
- Rotas locais:
  - `GET /integrations/codex/status`;
  - `GET /integrations/codex/sessions`;
  - `POST /integrations/codex/turn/start`;
  - `GET /integrations/codex/run`;
  - `POST /integrations/codex/run/cancel`;
  - `POST /integrations/codex/open` mantida somente como fallback CLI.
- A aba Programar possui painel recolhivel do Codex, conversas separadas por projeto, retomada de thread, progresso, plano, comandos, arquivos alterados, resposta final e cancelamento.
- Conectores agora abre o Codex diretamente no Programar. A autorizacao da pasta continua visual e explicita.

## Seguranca

- Transporte `stdio` local; nenhum app-server e exposto na rede.
- Projeto precisa estar confiavel.
- Sandbox `workspace-write` limitado a raiz selecionada.
- Rede bloqueada para comandos do turno.
- `approvalPolicy: on-request`: uma acao fora das permissoes pausa o trabalho e aparece dentro da Mike.
- A tela traduz a solicitacao em linguagem clara e oferece `Permitir uma vez`, `Permitir nesta conversa` ou `Recusar`.
- Nenhuma autorizacao exige terminal. Recusar devolve a decisao ao Codex, que pode adaptar a tarefa sem fechar o aplicativo.
- Eventos de raciocinio interno nao sao exibidos. A interface mostra plano, atividade observavel, ferramentas e resultado, preservando seguranca e clareza.

## Evidencias

- Bridge direto respondeu `TESTE CODEX OK`.
- Fluxo real pela API Mike respondeu `INTEGRACAO VISUAL CODEX OK` e criou sessao persistente.
- Segundo fluxo respondeu `PAINEL LIMPO OK`, concluiu com 15 eventos de produto e confirmou que avisos tecnicos do `stderr` ficam somente no log local.
- Fluxo de autorizacao real tentou listar `C:\Windows\System32`, entrou em `awaiting_approval`, recebeu `deny` pela rota visual e terminou informando que a recusa foi respeitada, sem alterar arquivo.
- `codex-cli 0.140.0-alpha.2`, autenticado por ChatGPT, foi detectado.
- Auditoria visual automatizada aprovada em `1440x1000` e `390x844`, sem overflow horizontal nem excecao JavaScript.
- Fonte oficial usada: `https://developers.openai.com/codex/app-server/`.
- Publicacao seletiva concluida em `minike.com.br` em 2026-06-15.
- Backup remoto anterior: `/home/u340626637/backups_codex/codex_embedded_before_20260615-102731.tar.gz`.
- Hashes local/remoto conferidos:
  - `mike-local-ai-minike.ps1`: `2f641c977962ed96c5be32f1cf8343013491c07a86f8b5a75beeb6b4dec5ece3`;
  - `codex-app-server-bridge.mjs`: `3c66c8d024d6d754b02719a97cec708d98b65113dfdceeebbf825392c4cbb9d7`.

# Mike Local - Memoria visual, menu dinamico e Canvas - 2026-06-15

## Entrega

- Versao local instalada: `2.5.0-minike`.
- `Memoria e notas` agora possui dois modos claros: `Notas` e `Canvas`.
- Notas aceitam propriedades locais no formato `chave=valor`, preservadas no indice e exibidas como marcadores.
- A busca consulta titulo, tags, propriedades, links e conteudo Markdown, com pontuacao local e trechos de resultado.
- Canvas salva arquivos `.canvas` JSON com cartoes de nota/texto, posicao, tamanho, cor e conexoes.
- Cartoes podem ser arrastados, selecionados em pares e conectados. Duplo clique abre a nota vinculada.
- O menu lateral recolhe para 76 px no desktop, abre sobre a tela no celular, guarda a preferencia e aceita `Ctrl+B`.
- No celular, tocar fora ou pressionar `Esc` fecha o menu.
- Telas e modais receberam animacoes leves; uma barra superior informa operacoes iniciadas pelo usuario sem piscar durante monitoramentos de segundo plano.
- `prefers-reduced-motion` desativa movimentos para acessibilidade.

## Seguranca e limites

- Notas continuam em Markdown legivel e Canvases em JSON Canvas; o usuario nao fica preso a um formato proprietario.
- Propriedades sao limitadas a 40 chaves, nomes simples e valores de ate 500 caracteres.
- Cada Canvas aceita ate 500 cartoes e 1.000 conexoes; somente notas existentes podem virar cartoes de arquivo.
- Nenhum dado de memoria e enviado automaticamente para a internet.
- O Canvas atual e uma primeira versao funcional. Grupos, zoom, lazy loading e Bases tabulares entram em fase posterior.

## Validacao

- PowerShell Parser e instalacao `-ValidateOnly`: aprovados.
- Mike Local reinstalada com `-SkipDependencies`, sem baixar novamente Ollama ou modelo.
- Teste de API criou duas notas temporarias, confirmou busca por conteudo e propriedade, salvou/reabriu Canvas com dois cartoes e uma conexao e removeu os dados de teste.
- Auditoria visual aprovada em `1440x1000` e `390x844`.
- No celular, cofre, editor e grafo ficam empilhados e inteiramente dentro da viewport.
- Menu recolhivel, autosave do Programar, propriedades, Canvas, ferramentas incorporadas e seletores PT/EN e BRL/USD passaram sem excecao JavaScript ou overflow horizontal.
- Evidencias atualizadas em `docs/evidencias-local-ai-20260614/`.
- Hash local antes da publicacao:
  - `mike-local-ai-minike.ps1`: `9959ab65809ec31b275570b7af9ca451a57636d689e8e1aec9fd1a8f2472143e`;
  - `codex-app-server-bridge.mjs`: `5df75116b2706e637da4c0a875a8e9bf53605c06b53f5b071d51de6ed6bbecbb`.

# Mike Local - Ferramentas conectadas ao chat e leads ao vivo - 2026-06-15

## Entrega

- Versao local atualizada para `2.6.0-minike`.
- A aba `Internet e ferramentas` continua separada como catalogo completo.
- O chat agora possui um roteador local rapido que reconhece pedidos claros de conversao, PDF, imagem, video, QR Code, JSON, validacao e calculos.
- A resposta mostra no maximo duas ferramentas relevantes em cartoes, evitando poluicao visual no celular.
- O botao `Usar na Mike` abre a ferramenta dentro do painel interno e retorna para a conversa ao fechar.
- Somente URLs HTTPS oficiais de `minike.com.br` podem abrir no painel integrado. URLs externas continuam fora desse fluxo.
- Os cartoes ficam salvos no historico da conversa.
- A ponte `MinikeToolBridge` permite que ferramentas incorporadas informem `pronta`, `processando`, `resultado` ou `erro` ao aplicativo.
- Resultados estruturados podem voltar ao historico pela rota local `POST /conversations/tool-result`.
- O Conversor de Imagem e o Compressor de PDF ja publicam andamento e conclusao pela ponte. As demais ferramentas podem aderir ao mesmo contrato sem alterar o roteador.

## Privacidade e confirmacoes

- Atualizacao 2026-06-29: para conversoes suportadas, arquivos enviados no chat podem ser processados automaticamente pela Mike Local e voltar como download. Para ferramentas ainda sem executor direto, o usuario continua escolhendo o arquivo dentro da ferramenta.
- Compra, assinatura, pagamento, documento privado e envio de dados continuam exigindo acao explicita.
- O chat nao exibe raciocinio interno oculto. Ele mostra plano, ferramenta escolhida, atividade observavel e resultado verificavel.
- O catalogo e lido primeiro do cache local, evitando espera desnecessaria quando o usuario pede uma ferramenta conhecida.

## Extrator de Leads B2B

- Os locais descobertos no Google Maps passam a ser gravados imediatamente em JSONL, antes do enriquecimento individual.
- Cada registro possui estados visuais: `Descoberto`, `Conferindo`, `Pronto`, `Filtrado` ou `Incompleto`.
- A planilha ao vivo aparece durante a coleta e permite buscar, editar, manter, apagar e exportar depois para Excel ou PDF.
- Eventos repetidos do mesmo local sao mesclados pelo identificador, preservando o registro parcial mesmo em cancelamento, bloqueio ou timeout.
- O request handler recebeu tempo compativel com a coleta longa e nao repete automaticamente uma cidade inteira depois de timeout.
- A interface transforma logs tecnicos em mensagens curtas como `Encontrei`, `Estou conferindo` e `Registro pronto`.

## Validacao

- PowerShell Parser, `php -l`, instalacao `-ValidateOnly` e suite local: aprovados.
- Pedidos testados: imagem para PDF, juntar PDF, comprimir PDF, QR Code e calculadora de desconto.
- O retorno de resultado foi salvo como nova mensagem no historico.
- Auditoria visual aprovada em `1440x1000` e `390x844`, sem overflow horizontal ou excecao JavaScript.
- Capturas: `desktop-chat-ferramenta.png` e `mobile-chat-ferramenta.png` em `docs/evidencias-local-ai-20260614/`.

# Mike Local - Canvas de memoria e fluxos visuais - 2026-06-15

## Entrega

- Versao local e publica atualizada para `2.7.0-minike`.
- A ferramenta principal escolhida pelo roteador da conversa abre automaticamente dentro da Mike. O cartao e o botao permanecem na conversa como alternativa e para reabrir depois.
- O ultimo Canvas salvo abre automaticamente ao entrar no modo `Canvas`.
- A paleta pesquisa e adiciona blocos reais de:
  - notas Markdown do cofre local;
  - projetos e pastas conectadas;
  - ferramentas oficiais do catalogo Minike;
  - agentes locais;
  - textos, gatilhos e acoes de fluxo.
- Recursos locais aparecem sem esperar o catalogo online terminar de atualizar.
- Cada bloco possui porta de entrada e saida. A ligacao pode ser criada arrastando a porta direita para a porta esquerda do proximo bloco.
- As conexoes sao direcionais, curvas e persistidas com `fromSide=right` e `toSide=left`.
- O editor possui zoom, restauracao para 100%, enquadramento, organizacao automatica por profundidade do fluxo, remocao de blocos e conexao alternativa pela selecao de dois blocos.
- A simulacao percorre o fluxo na ordem topologica e mostra visualmente o bloco atual e os blocos concluidos.
- Ciclos sao detectados e impedem a simulacao ate a ligacao circular ser corrigida.
- Duplo clique abre a nota, projeto, ferramenta ou area do agente correspondente. Textos, gatilhos e acoes podem ser editados.
- Canvas antigos continuam compativeis: `file` vira `kind=note` e `text` sem tipo vira `kind=text`.

## Persistencia e seguranca

- O servidor valida cada referencia antes de salvar:
  - nota precisa existir no cofre;
  - projeto precisa estar conectado;
  - agente precisa existir no cadastro local;
  - ferramenta precisa usar HTTPS em `minike.com.br` ou subdominio oficial.
- Limites permanecem em 500 blocos e 1.000 conexoes por Canvas.
- Metadados arbitrarios, URLs externas e referencias removidas nao sao aceitos como blocos executaveis.
- A simulacao atual e visual e deterministica. Ela nao executa terminal, envia mensagens, altera arquivos nem aciona agentes silenciosamente.
- O futuro motor de execucao deve pausar em blocos com efeito real e aplicar escopos, projeto confiavel, confirmacao humana, limite de recursos e log de auditoria.
- A interface mostra atividade observavel, ferramentas e resultados. Nao exibe raciocinio interno oculto de modelos.

## Validacao

- PowerShell Parser e instalacao `-ValidateOnly`: aprovados.
- Suite funcional salvou e reabriu um Canvas com nota, projeto, ferramenta, agente, acao e quatro ligacoes direcionais.
- Instalacao existente atualizada com `-SkipDependencies`, preservando modelo, conversas, memoria e projetos.
- Auditoria visual aprovada em `1440x1000` e `390x844`.
- Testados: paleta, portas, conexao curva, zoom, organizacao, simulacao, menu responsivo e abertura automatica da ferramenta pela conversa.
- Nenhum overflow horizontal ou erro JavaScript foi encontrado.
- Capturas: `desktop-memory-canvas.png` e `mobile-memory-canvas.png` em `docs/evidencias-local-ai-20260614/`.
- Publicacao atomica concluida em `https://minike.com.br/local-ai/mike-local-ai-minike.ps1`.
- Backup remoto anterior: `/home/u340626637/backups_codex/mike_canvas_before_20260615-115719`.
- SHA-256 local, remoto e download HTTP: `2ec0a06cba8c477e2c448ee88936f16cac33f4011a079cee5f70b0cf3b52d95c`.

# Mike Local - Seguranca local, conectores e agentes controlados - 2026-06-15

## Entrega publicada

- Versao local e publica atualizada para `2.8.0-minike`.
- A API em `127.0.0.1:47885` agora exige um token aleatorio de sessao para todas as rotas privadas. A tela recebe o token ao abrir, mas processos locais sem autorizacao recebem HTTP `403`.
- Downloads gerados pelo extrator usam URL temporaria autenticada.
- Projetos antigos que haviam recebido confianca automatica foram revogados. Codex e terminal so recebem confianca depois da confirmacao visual do usuario.
- O modo multiagente exige confirmacao no servidor, permite somente uma equipe ativa por vez e marca tarefas presas como interrompidas depois de reinicio.
- Jobs finalizados de agentes sao removidos da sessao para evitar acumulo.
- Macros multiagente tambem exigem permissao explicita.
- OpenRouter, GroqCloud, Together AI e webhook de saida Minike receberam configuracao real:
  - segredo protegido pelo usuario atual do Windows com DPAPI;
  - segredo nunca volta para a interface ou log;
  - provedores usam endpoint oficial fixo;
  - webhook aceita apenas HTTPS publico e bloqueia rede local/privada;
  - teste assinado com HMAC, timestamp e idempotencia;
  - revogacao e auditoria local.
- Status de Ollama Cloud e Playwright deixou de afirmar integracao quando apenas uma dependencia generica existe.

## Instalador e cadeia de integridade

- O instalador CMD baixa o nucleo e confere SHA-256 antes de executar.
- A verificacao SHA-256 usa APIs .NET compativeis com o PowerShell 5 encontrado neste Windows.
- O nucleo valida o SHA-256 do bridge Codex antes de instala-lo.
- Fluxo real testado: download publico do CMD, verificacao, instalacao, reutilizacao do modelo, criacao do atalho e abertura do aplicativo.
- URLs publicas:
  - `https://minike.com.br/local-ai/mike-local-ai-minike.ps1`
  - `https://minike.com.br/local-ai/instalar-mike-windows.cmd`
- Backup remoto anterior: `/home/u340626637/backups_codex/mike_security_before_20260615-125124`.
- SHA-256 local, remoto e download HTTP:
  - `mike-local-ai-minike.ps1`: `597ce1673a30e14f88b653d54d1a9d77095663b2f808c21d63e102b7287e7e0a`;
  - `instalar-mike-windows.cmd`: `5b0ae4a52bfda0b8804fd521fba887ec0f7a3eeab5a5fc51cb3b87dc77810db4`;
  - `codex-app-server-bridge.mjs`: `5df75116b2706e637da4c0a875a8e9bf53605c06b53f5b071d51de6ed6bbecbb`.

## Validacao

- PowerShell Parser, `-ValidateOnly`, suite estatica e suite viva: aprovados.
- Suite viva validou bloqueio sem token, conectores protegidos, revogacao, auditoria, confirmacao multiagente, memoria, Canvas salvo/reaberto, Programar, terminal seguro, chat, historico e ferramentas.
- Auditoria visual final aprovada em `1440x1000` e `390x844`, sem overflow horizontal ou excecao JavaScript.
- A Mike instalada respondeu `2.8.0-minike`, modelo `qwen2.5:1.5b`, projeto conectado e internet disponivel.

# Editor de Encartes e Catalogos Minike - arquitetura inicial - 2026-06-15

## Decisao

O projeto existente em `ferramentas/gerador` sera reaproveitado. Ele ja possui uma base valiosa com Fabric.js, templates, temas, slides, produtos, importacao Excel, arrastar e soltar, geracao automatica, PNG, JSON, PDF, GIF e animacoes. Nao sera reescrito como um clone do Canva.

A primeira versao publicavel sera uma beta focada: **Editor de Encartes e Catalogos Minike**.

## Bloqueadores encontrados

- A API atual depende de helpers Loja195 ausentes e nao executa corretamente no projeto Minike.
- Endpoints mutaveis nao possuem autenticacao, autorizacao e CSRF suficientes.
- Trabalhos e templates nao estao isolados por usuario/empresa.
- Existem riscos de traversal em arquivos, SSRF no proxy de imagem, precos confiados ao navegador e diagnosticos perigosos expostos.
- A fonte principal usa a tabela generica `produtos`, sem adaptador para `mk_lojas_produtos`.
- Configuracao ainda cria/altera tabelas durante requisicoes.
- `integration.js` e `canvas.js` possuem contratos concorrentes de salvamento.

## Primeira entrega planejada

1. Autenticacao Minike e isolamento por empresa/usuario.
2. Fonte `Minha loja Minike`, adaptando `mk_lojas_produtos` ao formato do editor.
3. Importacao XLSX como segunda fonte.
4. Templates, temas, geracao automatica, edicao Fabric.js e exportacao PNG/PDF.
5. Trabalhos e templates salvos com ownership.
6. Jobs temporarios e assinados para a Mike abrir produtos e tema pre-selecionados.
7. Ocultar inicialmente auto-cura, diagnostico, logs, criacao de pedidos, GIF, animacoes e recursos Loja195 ainda nao seguros.

## Documentos editaveis

- O Estudio visual sera usado para criativos, encartes, catalogos, placas e apresentacoes visuais.
- `docx`, `xlsx` e `pptx` exigem um editor Office dedicado para preservar fidelidade; a direcao recomendada e integrar uma solucao oficial/self-hosted compativel, em vez de converter silenciosamente tudo para canvas.
- PDF tera dois fluxos: anotacao/organizacao e conversao explicita quando o usuario quiser editar conteudo.
- Atalhos para Google Docs/Sheets nao substituem edicao privada no site; serao conectores opcionais e claramente identificados.

## Geracao e edicao de imagens

- A geracao de imagens sera uma camada separada e conectavel ao Estudio e a Mike.
- Fluxo: pedido na conversa -> roteador escolhe ferramenta -> mostra custo/privacidade -> gera previsualizacoes -> abre o resultado no Estudio -> usuario edita, aprova e exporta.
- Provedores locais e APIs opcionais poderao coexistir. Dados enviados para nuvem, custos e termos do fornecedor sempre aparecem antes da acao.
- Capacidades previstas: gerar imagem, remover/trocar fundo, ampliar, recortar, variar, melhorar produto e inserir resultado diretamente no design.
- API publica das ferramentas somente sera oferecida depois de autenticacao, escopos, limites, medicao, auditoria, termos e isolamento por tenant.

# Consolidacao documental e inventario de reuso - 2026-06-15

## Estado da publicacao

- Mike Local publicada e testada como 2.8.0-minike.
- Instalador publico Windows baixou o nucleo, conferiu SHA-256 e instalou com sucesso.
- Hash publico final do nucleo: 597ce1673a30e14f88b653d54d1a9d77095663b2f808c21d63e102b7287e7e0a.
- Hash publico final do CMD: 5b0ae4a52bfda0b8804fd521fba887ec0f7a3eeab5a5fc51cb3b87dc77810db4.

## Resposta objetiva

- O projeto Minike ja possui documentacao detalhada em DOCUMENTACAO_MESTRE_MINIKE.md.
- Ainda existem documentos auxiliares que precisam ser transcritos/consolidados antes de serem removidos.
- Projetos externos (loja195, galeria195, Bruno/atendimento) sao somente leitura; qualquer reaproveitamento deve ser copiado para o Minike antes de editar.

## Inventario criado

- Arquivo de trabalho: $inventoryPath.
- Total de documentos encontrados: 75.
- bruno_atendimento: 7 documento(s), 990 bytes.
- galeria195: 14 documento(s), 439285 bytes.
- loja195: 7 documento(s), 392214 bytes.
- minike: 47 documento(s), 1808091 bytes.

## Regras de consolidacao

1. Transcrever documentacao comum integralmente para este arquivo mestre, mantendo origem, hash e data.
2. Nao duplicar credenciais, tokens, chaves privadas, senhas ou dados pessoais sensiveis; nestes casos registrar origem, hash e motivo da redacao.
3. Nao apagar SKILL.md, ds.txt, .htaccess, README de dependencia ou arquivo operacional necessario apenas por ser texto.
4. So apagar documentos redundantes dentro do Minike depois de conferir que o conteudo foi consolidado e que nao e runtime.
5. Nunca alterar arquivos nos projetos externos; copiar para docs/inventario-reuso/copias-quarentena/ ou modulo Minike antes de mexer.

## Instrucao para a proxima IA

Leia primeiro DOCUMENTACAO_MESTRE_MINIKE.md inteiro e depois o inventario $inventoryPath. Continue a transcricao integral dos documentos listados, registre origem e SHA-256 de cada arquivo, anote ideias uteis de sistemas/ferramentas e so apague documentos soltos do projeto Minike quando a consolidacao estiver validada. Projetos externos sao somente leitura.

## Lote de transcricao documental - 2026-06-15

- Arquivo de transcricao criado: `docs\inventario-reuso\transcricao-documentos-consolidados.md`.
- Documentos transcritos neste lote: 35.
- Arquivos grandes pendentes permanecem listados em `docs\inventario-reuso\inventario-documentacao-e-reuso.tsv` e devem ser incorporados por lotes, com checagem de segredos.
- Nao foram apagados documentos soltos nesta etapa; remocao fica bloqueada ate validacao da consolidacao integral.

## Inventario funcional externo - 2026-06-15

- Arquivo criado: `docs\inventario-reuso\inventario-funcional-projetos-externos.tsv`.
- Ele lista ocorrencias candidatas para fotos de produtos, anuncios, pontos/fidelidade, WhatsApp, PDV, pagamentos, APIs, automacoes e ferramentas.
- Os projetos externos continuam somente leitura; itens uteis devem ser copiados para o Minike antes de alteracao.

## Correcao do inventario funcional externo - 2026-06-15

O inventario funcional foi recriado com tabulacao real e resumo legivel em:

- `docs\inventario-reuso\inventario-funcional-projetos-externos.tsv`
- `docs\inventario-reuso\RESUMO_REUSO_PROJETOS_EXTERNOS.md`

Resultado atual:

- `bruno_atendimento`: 43 candidatos. Serve principalmente como referencia de conectores, scripts de diagnostico e conceitos de atendimento/API; muitos arquivos sao placeholders.
- `galeria195`: 556 candidatos. Melhor fonte para PDV, catalogo, fiscal, loja, relatorios e estrutura visual/comercial.
- `loja195`: 318 candidatos. Melhor fonte para gerador de artes, fotos de produtos, automacoes de anuncios, palavras-chave de produtos, orcamentos e catalogo.

Categorias rastreadas:

- produtos e catalogo
- imagens e anuncios
- automacao e integracao
- financeiro, pontos e fidelidade
- IA e atendimento
- PDV e fiscal
- editor de documentos e design

Regra de uso:

- Arquivos externos marcados como sensiveis no inventario podem orientar arquitetura, mas nao devem ser copiados diretamente sem revisao manual.
- O reaproveitamento deve acontecer por copia controlada para dentro do Minike, preferencialmente em uma area de quarentena, antes de qualquer adaptacao.
- A prioridade pratica e transformar o `ferramentas/gerador` em Estudio Minike seguro, reaproveitando o que ja existe do antigo gerador sem publicar endpoints perigosos.

Instrucao operacional para a proxima IA:

Leia primeiro este arquivo mestre, depois `docs\inventario-reuso\RESUMO_REUSO_PROJETOS_EXTERNOS.md`, depois o TSV funcional se precisar de caminho exato. Continue a consolidacao documental em lotes, preserve origem e hash dos arquivos, nao edite `loja195`, `galeria195` nem `Bruno/atendimento`, e so apague documentos soltos do Minike quando a transcricao estiver validada e o arquivo nao for usado em runtime.

## Estudio Minike - primeira adaptacao segura do gerador - 2026-06-15

Origem reaproveitada:

- `ferramentas/gerador/*` no projeto Minike, importado de um gerador antigo usado na Loja195.
- Ideias relacionadas catalogadas em `docs\inventario-reuso\RESUMO_REUSO_PROJETOS_EXTERNOS.md`.

Alteracoes aplicadas:

- Criado `ferramentas/auth_session.php` para compatibilizar `studio195StartSession()` com a sessao/identidade Minike.
- Criado `ferramentas/loja195_security.php` como shim seguro para funcoes antigas de IP, rate limit, log e dominios confiaveis.
- `ferramentas/gerador/config.php` agora usa o banco/identidade unificados do Minike quando disponiveis.
- `APP_NAME` alterado para `Estudio Minike`, `APP_URL` padrao para `https://minike.com.br` e e-mail padrao para `noreply@minike.com.br`.
- Autocura de banco desligada por padrao em requisicoes web; so roda via CLI, `GERADOR_DB_AUTO_HEAL=1` ou `DB_AUTO_HEAL=true`.
- `ferramentas/gerador/api.php` passou a bloquear logs, diagnostico, autocura e configuracao de IA para usuario nao admin.
- Acoes de salvar/deletar/template/pedido/remover fundo/catalogo exigem usuario Minike logado.
- Origem permitida agora aceita dominios Minike e loopback local (`localhost`/`127.0.0.1`) para Mike Local e testes.
- Busca principal de produtos prefere `mk_lojas_produtos` e usa `produtos` apenas como fallback legado.
- Quando nao ha banco disponivel, `buscar_placas` retorna lista vazia com mensagem amigavel em vez de erro tecnico.
- `.htaccess` do gerador bloqueia SQL, logs, env, backups, scripts internos, vendor/logs e execucao de scripts em uploads.
- `includes/local_ai_catalog.php` destaca `gerador/gerador.php` como `Estudio Minike de artes e catalogos` com modo `internal_web`.

Validacoes executadas:

- `php -l ferramentas\auth_session.php`
- `php -l ferramentas\loja195_security.php`
- `php -l ferramentas\gerador\config.php`
- `php -l ferramentas\gerador\api.php`
- `php -l includes\local_ai_catalog.php`
- `node ferramentas\gerador\static-button-check.js`: 208 onclicks, 115 chamadas, 0 handlers faltando.
- Servidor PHP local temporario em `127.0.0.1`: `gerador.php?mk_embed=local_ai` respondeu 200.
- Endpoint local `api.php?acao=buscar_placas` respondeu 200 com fallback `sem_banco` quando as credenciais MySQL locais nao estavam disponiveis.
- Publicado em `https://minike.com.br/ferramentas/gerador/gerador.php?mk_embed=local_ai`.
- Backup remoto antes da publicacao: `/home/u340626637/backups_codex/gerador_minike_before_20260615-170604`.
- Sintaxe validada no servidor Hostinger para `ferramentas/auth_session.php`, `ferramentas/loja195_security.php`, `ferramentas/gerador/config.php`, `ferramentas/gerador/api.php`, `ferramentas/gerador/gerador.php`, `ferramentas/gerador/templates.php`, `ferramentas/gerador/importar_excel.php` e `includes/local_ai_catalog.php`.
- URL publica do Estudio respondeu 200; API publica `buscar_placas` respondeu 200.

Pendencias do Estudio:

- Testar em servidor Hostinger com banco real e produtos reais.
- Melhorar UI para parecer Canva/PowerPoint Minike, com menos heranca visual Loja195.
- Adaptar `buscar_produto_por_id`, recuperacao de foto e importacao Excel para ownership por usuario/empresa.
- Adicionar jobs assinados para a Mike abrir o Estudio com produtos/tema pre-selecionados.
- Escolher e integrar editor dedicado para `docx`, `xlsx` e `pptx`; nao converter silenciosamente para canvas.
- Criar API publica do Estudio somente depois de escopos, medicao, limite, billing, auditoria e isolamento por tenant.

## Mike Local 2.12.4 - Mapa conceitual automatico de projeto - 2026-06-16

Pedido atendido:

- Criar na aba `Memoria e notas > Canvas` um sistema inspirado em Obsidian + n8n para conectar uma pasta/projeto e gerar automaticamente um mapa visual completo.
- Cada arquivo vira um bloco colorido.
- Linhas coloridas mostram dependencias locais entre arquivos.
- Entradas ficam conceitualmente da esquerda para a direita, com portas de entrada/saida nos blocos.
- Arquivos sem ligacao aparecem em vermelho para chamar atencao.
- O cliente deve ver o mapa nascendo na tela, com animacao fluida, para nao parecer travado.

Implementacao em `local-ai/mike-local-ai-minike.ps1`, versao `2.12.4-minike`:

- Novo botao `Mapear projeto` na aba `Memoria e notas > Canvas`.
- Novo botao `Conectar pasta` dentro do Canvas para adicionar projeto sem sair da memoria.
- Nova rota local `POST /memory/canvas/from-project`.
- Nova funcao `New-ProjectMemoryCanvas`, que:
  - Resolve o projeto autorizado com `Resolve-ProjectPath`.
  - Varre arquivos seguros via `Get-ProjectSourceFiles`.
  - Detecta relacoes locais sem executar codigo:
    - PHP: `require`, `require_once`, `include`, `include_once`.
    - JavaScript/TypeScript: `import`, `require`, `import()`.
    - CSS: `@import`.
    - HTML/PHP/JS: `src`, `href`, `action`.
  - Normaliza referencias relativas e absolutas dentro da pasta do projeto.
  - Ignora `node_modules`, `.git`, `vendor`, backups, caches, `.env`, senhas, tokens e arquivos sensiveis ja bloqueados pela politica local.
  - Gera nos `project_file` com `project_id`, `file_path`, linguagem, papel (`entry`, `middle`, `output`, `isolated`) e cor.
  - Gera arestas com cor por tipo de dependencia.
  - Salva automaticamente o Canvas no cofre local.
- `Save-MemoryCanvas` passou a aceitar nos `project_file`, `route`, `directory`, `language` e a preservar `fromSide`, `toSide` e `color` das ligacoes.
- O Canvas foi ampliado para `3600x1800`, com animacao `nodePop` nos blocos e `edgeDraw` nas linhas.
- O front-end revela os blocos e ligacoes em lotes, atualizando o status:
  - "Mapeando arquivos..."
  - "Criando ligacoes..."
  - "Mapa pronto..."
- Duplo clique em arquivo do mapa abre o arquivo diretamente na aba `Programar`.

Cores iniciais:

- Arquivos isolados: vermelho.
- PHP: roxo.
- JavaScript: amarelo.
- TypeScript/JSX/TSX: azul claro.
- CSS/SCSS: verde.
- HTML: laranja.
- JSON/config: lilas.
- Python: azul.
- PowerShell/scripts: cinza.
- SQL: rosa/vermelho.
- Markdown/texto: verde agua.

Validacoes executadas localmente:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

## Mike Local 2.14.1 - Monetizacao discreta, BRL/USD/MKC e slots leves - 2026-06-16

Objetivo:

- Criar uma forma centralizada de monetizar sem assustar o usuario final.
- Permitir ofertas proprias Minike, afiliados, patrocinadores e anuncios recompensados em pontos estrategicos.
- Mostrar precos em Real, Dolar e MKC sem remover pagamentos em dinheiro.
- Preparar a Mike Local e os sites para usar o mesmo catalogo comercial, com divulgacao clara e sem paywall surpresa.

Arquivos alterados:

- `includes/minike_monetization.php`
  - Novo helper unico de monetizacao leve.
  - Retorna planos, precos em BRL/USD/MKC, politicas e slots de exibicao.
  - Nao executa cobranca e nao libera acesso; apenas apresenta opcoes.
- `api/monetization.php`
  - Nova API publica para sites, subsites, ferramentas e Mike Local.
  - Parametros:
    - `context`: `general`, `local_ai`, `loading`, `quota`, `after_quota`.
    - `currency`: `BRL`, `USD`, `MKC`.
- `api/local-ai.php`
  - Novo endpoint `action=monetization`.
  - Catalogo de ferramentas agora pode retornar `monetization` para a Mike Local.
- `includes/local_ai_catalog.php`
  - Manifest passa a apontar `monetization_api`.
  - Versao anunciada da Mike Local atualizada para `2.14.1-minike`.
- `local-ai/mike-local-ai-minike.ps1`
  - Versao `2.14.1-minike`.
  - Aba `Internet e ferramentas` recebeu slot visual discreto.
  - O slot aparece somente quando o catalogo/API retorna oferta valida.
  - Se falhar ou estiver offline, a tela continua funcionando sem propaganda.
- `local-ai/instalar-mike-windows.cmd`
  - Hash do nucleo atualizado para validar a versao `2.14.1-minike`.

Politica de experiencia:

- Anuncios e propaganda ficam em locais estrategicos: loading, resultado, limite/quota e configuracoes.
- Nada deve cobrir o trabalho do usuario, tocar som sozinho ou impedir uso basico sem aviso.
- Anuncio recompensado e sempre opcional.
- Oferta paga deve mostrar preco, moeda e natureza comercial.
- Pagamento, compra, recompensa e liberacao continuam dependendo de confirmacao do servidor.
- MKC continua tratado como credito interno/utilidade ate existir revisao juridica para qualquer token publico, cashout ou rede comunitaria paga.

Politica de receita:

- Manter compra normal em dinheiro via BRL/USD.
- Permitir preco em MKC para beneficios internos.
- MKC pode ser ganho por jogos, missoes, trabalhos e futuramente venda de processamento, mas pagamento em dinheiro pela rede publica fica bloqueado ate existir sandbox, contrato, KYC/KYB, antifraude e regras BR/US.
- Planos anuais continuam com desconto de 30%.
- Usuarios gratis podem ver anuncios discretos e ganhar uso extra sem atrapalhar a experiencia.

Validacoes:

- `php -l includes\minike_monetization.php`: aprovado.
- `php -l api\monetization.php`: aprovado.
- `php -l api\local-ai.php`: aprovado.
- `php -l includes\local_ai_catalog.php`: aprovado.
- `php -r '$_GET=["action"=>"monetization","currency"=>"USD","context"=>"local_ai"]; require "api/local-ai.php";'`: aprovado, retornando precos em USD e slots.
- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- `cmd /c "... local-ai\instalar-mike-windows.cmd --validate"`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

Proximas melhorias:

- Criar tela financeira no Super Admin para configurar patrocinadores, afiliados, pesos de slots e campanhas.
- Registrar impressao/clique sem rastrear dados privados do usuario local.
- Criar regras por plano: gratis com slots leves, pagos sem anuncios principais.
- Fazer os loadings das ferramentas alternarem dicas uteis, campanhas proprias e anuncios recompensados.
- Ligar recompensas MKC dos games, missoes e rede privada/publica a uma carteira interna auditavel.

## Servidor Minike - Dispositivos Mike Local, pareamento e atualizacao modular - 2026-06-16

Objetivo:

- Manter a Mike Local em modulos separados para permitir atualizacoes especificas por usuario, empresa, extensao ou ferramenta.
- Permitir que o cliente veja quais computadores estao conectados a conta Minike.
- Permitir revogar acesso de um computador sem trocar senha da conta.
- Preparar a base para avisos de atualizacao por modulo: Mike Local, ferramentas, cursos, games, conectores, WhatsApp e agentes.

Arquivos principais:

- `includes/mk_identity.php`
  - Normaliza sessoes antigas e novas.
  - Agora reconhece `mk_user`, `usuario_id` e `user_id` como o mesmo usuario logado.
  - Isso permite que o painel legado `central_cliente.php` e paginas modernas como `local-ai/parear.php` usem a mesma identidade.
- `includes/local_ai_devices.php`
  - Cria/garante a tabela `mk_local_ai_devices`.
  - Faz pareamento por codigo temporario.
  - Autentica token local revogavel.
  - Lista dispositivos por usuario ou, para admin, todos os dispositivos.
  - Revoga dispositivo especifico mantendo auditoria.
- `local-ai/parear.php`
  - Tela publica logada para aprovar a Mike Local com codigo exibido no app.
- `local-ai/dispositivos.php`
  - Nova tela de controle de computadores conectados.
  - Mostra nome do PC, status, versao, modulos liberados, IP inicial e ultima conexao.
  - Permite revogar acesso por CSRF.
  - Admin pode alternar entre ver somente os seus dispositivos ou todos.
- `central_cliente.php`
  - Ganhou atalho `Mike Local` nas abas da conta.

Decisao de arquitetura:

- Atualizacoes devem continuar granulares.
- O catalogo local informa versao/modulo.
- A Mike Local mostra aviso de atualizacao por card/modulo.
- Ao apertar atualizar, o app abre um terminal visivel somente para aquela atualizacao, com progresso e log claro.
- Modulos pagos ou especificos de empresa podem ficar disponiveis apenas para dispositivos pareados e autorizados.

Seguranca:

- A Mike Local nao recebe senha do usuario.
- Cada computador usa token `mkla_...` armazenado localmente e revogavel.
- A tela de dispositivos nunca mostra token completo.
- Revogacao exige sessao logada e CSRF.
- Acesso admin para todos os dispositivos fica condicionado a `mk_is_admin()`.

Validacoes locais:

- `php -l includes\local_ai_devices.php`: aprovado.
- `php -l local-ai\dispositivos.php`: aprovado.
- `php -l includes\mk_identity.php`: aprovado.
- `php -l central_cliente.php`: aprovado.

Publicacao e validacoes online:

- Publicado no Hostinger:
  - `includes/mk_identity.php`
  - `includes/local_ai_devices.php`
  - `local-ai/dispositivos.php`
  - `central_cliente.php`
  - `DOCUMENTACAO_MESTRE_MINIKE.md`
- `https://minike.com.br/local-ai/dispositivos.php`: respondeu `302` quando deslogado, comportamento esperado.
- `https://minike.com.br/api/local-ai-device.php?action=start`: respondeu `ok=true`, gerou `user_code` e `verification_url`.
- `https://minike.com.br/DOCUMENTACAO_MESTRE_MINIKE.md`: respondeu `200` e contem a secao `Dispositivos Mike Local`.

Pendencias:

- Testar online `local-ai/dispositivos.php` redirecionando quando deslogado e abrindo quando logado.
- Ligar a tela de extensoes local com os modulos autorizados pela conta pareada.
- Criar notificacao visual na Mike quando existir atualizacao de modulo.
- Adicionar historico de instalacoes por dispositivo para saber qual cliente atualizou o que e quando.

## Mike Local 2.13.8 - Extensoes ligadas a conta pareada - 2026-06-16

Objetivo:

- Manter os modulos/extensoes separados para atualizacoes especificas por usuario, empresa ou recurso.
- Fazer os cards de extensao respeitarem a conta pareada e os modulos liberados pelo plano.
- Evitar que o usuario clique em instalar/atualizar/abrir modulo que exige conta e pareca que nada aconteceu.

Implementacao:

- `local-ai/mike-local-ai-minike.ps1`
  - Versao alterada para `2.13.8-minike`.
  - Nova funcao `Test-ExtensionAccountAccess`.
  - `/extensions` agora retorna:
    - `account_allowed`
    - `blocked_reason`
  - `Install-OrUpdateExtension` bloqueia modulo que exige conta quando:
    - a Mike ainda nao esta pareada;
    - o plano/perfil nao libera o modulo.
  - A tela `Internet e ferramentas` mostra:
    - `conecte a conta`
    - `plano necessario`
    - `conta liberada`
  - Cards bloqueados mostram botao `Conectar conta` ou `Bloqueado no plano`.
  - O botao `Conectar conta` leva o usuario direto para `Configuracoes` e carrega a area de conta.
- `includes/local_ai_catalog.php`
  - A versao do modulo `local_ai` no catalogo foi alterada para `2.13.8-minike`.
- `local-ai/instalar-mike-windows.cmd`
  - `CORE_SHA256` atualizado para o novo hash do script PowerShell.

Validacoes locais:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.
- `php -l includes\local_ai_catalog.php`: aprovado.
- `cmd /c 'pushd "\\srvtotali\Docs\PASTA COMPARTILHADA\Felipe\ia\minike" && local-ai\instalar-mike-windows.cmd --validate & popd'`: aprovado.

Arquivos publicados nesta rodada:

- `local-ai/mike-local-ai-minike.ps1`
- `local-ai/instalar-mike-windows.cmd`
- `includes/local_ai_catalog.php`
- `DOCUMENTACAO_MESTRE_MINIKE.md`

Validacoes online:

- `https://minike.com.br/api/local-ai.php?action=catalog`: `local_ai_version=2.13.8-minike`.
- `https://minike.com.br/local-ai/mike-local-ai-minike.ps1`: SHA-256 `F6D275CB3F11A1530A55F9D2FE20DFD58182CA0A7FB6FDF7FACD34BC60DFAE4F`.
- `https://minike.com.br/local-ai/instalar-mike-windows.cmd`: contem `CORE_SHA256=F6D275CB3F11A1530A55F9D2FE20DFD58182CA0A7FB6FDF7FACD34BC60DFAE4F`.
- `https://minike.com.br/DOCUMENTACAO_MESTRE_MINIKE.md`: contem `Mike Local 2.13.8`.

Proximo passo:

- Fazer a Mike Local mostrar uma notificacao visual persistente quando houver update disponivel.
- Adicionar historico detalhado por dispositivo no servidor para saber quando cada PC instalou modulo/update.
- Ligar permissoes de extensao com empresa/equipe, nao apenas usuario individual.

## Mike Local 2.13.9 - Aviso visual de updates e historico local - 2026-06-16

Objetivo:

- Mostrar ao usuario, em qualquer aba, quando existir atualizacao liberada para algum modulo.
- Evitar que o cliente precise entrar em `Internet e ferramentas` e procurar manualmente update por update.
- Tornar o historico local de instalacoes/updates visivel na interface.

Implementacao:

- `local-ai/mike-local-ai-minike.ps1`
  - Versao alterada para `2.13.9-minike`.
  - Novo banner persistente `updateBanner` abaixo da barra superior.
  - O banner aparece quando `/extensions` retorna updates com `account_allowed=true`.
  - O banner mostra quantidade de updates, nomes principais e botoes:
    - `Ver updates`: abre `Internet e ferramentas`, seleciona `Extensoes Minike` e abre o historico.
    - `Atualizar Mike`: aparece quando `local_ai` tem update disponivel e chama o fluxo oficial de atualizacao.
  - Nova funcao JS `availableExtensionUpdates()`.
  - Nova funcao JS `renderUpdateBanner()`.
  - Nova funcao JS `renderExtensionHistory()`.
  - A aba `Internet e ferramentas` ganhou o bloco `Historico de atualizacoes desta Mike`.
  - O historico usa `state.extensionUpdates`, gravado em `extensions.json`, com acao, versao anterior, versao nova, status e data.
- `includes/local_ai_catalog.php`
  - A versao publica de `local_ai` foi alterada para `2.13.9-minike`.
- `local-ai/instalar-mike-windows.cmd`
  - `CORE_SHA256` atualizado para o novo hash do PS1.

Validacoes locais:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.
- `php -l includes\local_ai_catalog.php`: aprovado.
- `cmd /c 'pushd "\\srvtotali\Docs\PASTA COMPARTILHADA\Felipe\ia\minike" && local-ai\instalar-mike-windows.cmd --validate & popd'`: aprovado.

Arquivos a publicar nesta rodada:

- `local-ai/mike-local-ai-minike.ps1`
- `local-ai/instalar-mike-windows.cmd`
- `includes/local_ai_catalog.php`
- `DOCUMENTACAO_MESTRE_MINIKE.md`

Pendencias seguintes:

- Criar historico servidor por dispositivo em `mk_local_ai_devices` ou tabela separada `mk_local_ai_device_events`.
- Enviar evento assinado do app local ao servidor quando um modulo for instalado/atualizado.
- Mostrar, em `local-ai/dispositivos.php`, a versao atual e ultimos updates de cada computador.

## Mike Local 2.14.0 - Auditoria servidor por dispositivo e monetizacao discreta - 2026-06-16

Objetivo tecnico:

- Registrar no servidor quais PCs instalaram ou atualizaram modulos.
- Mostrar esses eventos na tela online `local-ai/dispositivos.php`.
- Usar o token pareado da Mike Local, sem endpoint publico aberto para falsificar eventos.

Implementacao:

- `includes/local_ai_devices.php`
  - `mkai_devices_ensure_tables()` agora cria tambem `mk_local_ai_device_events`.
  - Nova funcao `mkai_devices_record_event($auth, $input)`.
  - Nova funcao `mkai_devices_events_for_devices($deviceIds, $userId, $includeAll, $limit)`.
  - Eventos gravam:
    - dispositivo
    - usuario
    - tipo de evento
    - modulo
    - acao
    - versao anterior
    - versao nova
    - status
    - versao da Mike
    - detalhe curto
    - IP/user-agent de auditoria
- `api/local-ai-device.php`
  - Novo `POST action=event`.
  - Exige bearer token `mkla_...` valido.
  - Reutiliza `mkai_devices_authenticate()`.
- `local-ai/mike-local-ai-minike.ps1`
  - Versao alterada para `2.14.0-minike`.
  - Nova funcao `Send-MinikeDeviceEvent`.
  - `Install-OrUpdateExtension` registra evento `extension.install` ou `extension.update` quando houver conta pareada.
  - Se o PC estiver offline ou sem conta, o modulo continua funcionando; apenas nao envia auditoria servidor.
- `local-ai/dispositivos.php`
  - Lista os ultimos updates/instalacoes de cada PC.
  - Mostra modulo, acao, versao anterior, versao nova e data.
- `includes/local_ai_catalog.php`
  - A versao publica `local_ai` foi alterada para `2.14.0-minike`.
- `local-ai/instalar-mike-windows.cmd`
  - `CORE_SHA256` atualizado para o novo hash do PS1.

Validacoes locais:

- `php -l includes\local_ai_devices.php`: aprovado.
- `php -l api\local-ai-device.php`: aprovado.
- `php -l local-ai\dispositivos.php`: aprovado.
- `php -l includes\local_ai_catalog.php`: aprovado.
- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.
- `cmd /c 'pushd "\\srvtotali\Docs\PASTA COMPARTILHADA\Felipe\ia\minike" && local-ai\instalar-mike-windows.cmd --validate & popd'`: aprovado.

Politica de monetizacao discreta Minike:

- O objetivo e gerar receita sem assustar nem atrapalhar cliente.
- Locais permitidos para monetizacao:
  - telas de carregamento longas;
  - cards contextuais em ferramentas;
  - rodape discreto de paginas;
  - recompensas opcionais;
  - tela de planos/limites;
  - resultados concluÃ­dos com sugestao de proximo passo;
  - marketplace de skills, agentes, extensoes e templates.
- Locais proibidos:
  - pop-up invasivo antes de terminar tarefa basica;
  - anuncio sobre editor/programacao enquanto usuario escreve;
  - bloqueio surpresa depois de upload;
  - esconder preco real;
  - mascarar fornecedor/parceiro;
  - autoplay com som.
- Formas aceitas:
  - propaganda propria Minike;
  - afiliados e patrocinadores identificados;
  - ads assinados quando estiverem em local discreto;
  - oferta de upgrade;
  - pagamento avulso;
  - liberar uso extra assistindo anuncio recompensado;
  - compra/venda de MKC;
  - ganhar MKC jogando, fazendo missoes, trabalhos no imperio Minike e vendendo processamento para a rede Minike quando essa rede estiver juridica e tecnicamente liberada.
- Precos devem poder aparecer em:
  - BRL;
  - USD;
  - MKC.
- Regras:
  - sempre confirmar cobranca antes de liberar item pago;
  - sempre mostrar se e gratuito, patrocinado, afiliado ou pago;
  - nunca atrapalhar a tarefa principal;
  - preferir "continuar gratis com limite" + "ganhar mais uso" + "upgrade" em vez de tela agressiva;
  - MKC e utilitaria dentro do ecossistema ate compliance de token publico, saque e lastro estar aprovado.

Publicacao e validacoes online:

- Publicado no Hostinger:
  - `includes/local_ai_devices.php`
  - `api/local-ai-device.php`
  - `local-ai/dispositivos.php`
  - `local-ai/mike-local-ai-minike.ps1`
  - `local-ai/instalar-mike-windows.cmd`
  - `includes/local_ai_catalog.php`
  - `DOCUMENTACAO_MESTRE_MINIKE.md`
- `https://minike.com.br/api/local-ai.php?action=catalog`: `local_ai_version=2.14.0-minike`.
- `https://minike.com.br/local-ai/mike-local-ai-minike.ps1`: SHA-256 `CCB82F4A7EA309E288FBBB302F6FBDCBE95E0C4BCF8B330EBBFFA6F7DECA3536`.
- `https://minike.com.br/local-ai/instalar-mike-windows.cmd`: contem `CORE_SHA256=CCB82F4A7EA309E288FBBB302F6FBDCBE95E0C4BCF8B330EBBFFA6F7DECA3536`.
- `https://minike.com.br/DOCUMENTACAO_MESTRE_MINIKE.md`: contem `Mike Local 2.14.0` e `Politica de monetizacao discreta Minike`.
- `POST https://minike.com.br/api/local-ai-device.php?action=event` sem token retorna `Token local invalido`, comportamento esperado.
- `https://minike.com.br/local-ai/dispositivos.php` deslogado retorna `302`, comportamento esperado.

Pendencias seguintes:

- Criar componente padrao `MonetizationSlot`/equivalente para site e Mike Local.
- Ligar tabela de precos/plano com BRL/USD/MKC em uma fonte unica.
- Validar envio real de evento `action=event` a partir de uma Mike pareada em maquina de teste.
- Mostrar versao atual da Mike em `local-ai/dispositivos.php` atualizada por heartbeat/evento.

## Mike Local 2.12.8 - Internet controlada e respostas programadas por ferramenta - 2026-06-16

Objetivo:

- Deixar claro e funcional como a Mike usa internet e ferramentas no chat.
- Transformar pedidos obvios de ferramenta em respostas guiadas, sem depender da LLM para dizer o basico.
- Dar ao cliente a sensacao correta: a Mike entendeu o pedido, escolheu a ferramenta e abriu o fluxo dentro da propria tela.

Estado entregue:

- Internet controlada:
  - `Test-MessageNeedsPublicWeb` detecta pedidos como pesquisar, internet, web, noticias, hoje, agora, atual, clima, cotacao e lei nova.
  - `Get-PublicWebContext` busca fontes HTTPS publicas, bloqueia IP local/privado e entrega trechos ao prompt final.
  - `Get-WeatherAnswer` responde clima/previsao via fonte publica `wttr.in` quando o usuario informa a cidade.
  - O prompt final instrui a citar URLs quando usar pesquisa web.
- Roteador de ferramentas:
  - `Find-MinikeToolsForMessage` identifica pedidos de PDF, imagem, video, QR Code, JSON, CNPJ, calculadora, conversao, edicao, compressao, divisao, juncao e outros.
  - `Find-MinikeToolsForAttachments` analisa anexos por extensao e sugere ferramentas adequadas para PDF, imagem, Word, Excel, PowerPoint e audio.
  - A UI abre ferramentas Minike no navegador interno isolado por `openToolInternal`, mantendo o cliente dentro da Mike.
- Respostas programadas:
  - Nova funcao `Get-ToolRouteAnswer`.
  - A resposta nao fica mais generica como "achei uma ferramenta".
  - Para PDF/documento, imagem, midia, QR Code, JSON, CNPJ/empresa e leads B2B, a Mike explica o fluxo em passos curtos.
  - A resposta reforca privacidade: anexos e arquivos privados so entram quando o usuario escolhe dentro da ferramenta.
  - Quando ha alternativas, a Mike lista ate duas opcoes relacionadas.

Comportamento esperado:

- `pesquise noticias sobre X`: usa internet controlada e entrega resposta com fontes.
- `clima em Guaramirim SC`: responde rapido com clima atual e fonte.
- `converter PDF em Word`: responde com fluxo guiado e abre a ferramenta indicada dentro da Mike.
- `remover fundo da imagem`: responde com fluxo visual e abre ferramenta de imagem.
- Anexar PDF/imagem/audio: a Mike executa conversoes suportadas diretamente quando detectar pedido claro; para casos fora do executor, sugere ferramenta/capacidade apropriada.

Limites atuais:

- A pesquisa web e controlada e resumida; nao e navegador autonomo irrestrito.
- Ferramenta embutida depende de a pagina Minike permitir frame/embutimento seguro.
- Ainda nao existe execucao automatica ponta a ponta de todas as ferramentas por API interna; a primeira ponte cobre conversoes comuns de arquivo via ImageMagick/FFmpeg, e muitas ferramentas continuam com confirmacao humana dentro da tela.
- Para ferramentas sensiveis, a Mike deve continuar pedindo revisao humana e respeitando LGPD/anti-spam.

Validacoes:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

## Mike Local 2.13.6 - Updates por extensao e modulo separado - 2026-06-16

Objetivo:

- Manter o ecossistema separado por extensoes/modulos, para lancar updates especificos que afetem apenas alguns usuarios.
- Mostrar avisos de atualizacao na propria aba `Internet e ferramentas`.
- Permitir que o usuario clique em `Atualizar` e veja uma acao clara, com terminal/prompt visivel quando a atualizacao exigir instalador.

Implementacao:

- `local-ai/mike-local-ai-minike.ps1` atualizado para `2.13.6-minike`.
- Novo estado local:
  - `extensions.json`: extensoes instaladas, versoes locais e historico recente.
  - `extension-jobs/`: reservado para updates mais pesados/futuros.
- Novas rotas locais:
  - `GET /extensions`: compara extensoes instaladas com `ecosystem_surfaces` do catalogo online.
  - `POST /extensions/install`: instala/ativa um modulo no perfil local da Mike.
  - `POST /extensions/update`: atualiza a versao local do modulo.
- Para `local_ai`, o update abre um `cmd.exe` visivel com o instalador oficial:
  - baixa `https://minike.com.br/local-ai/instalar-mike-windows.cmd`;
  - executa o CMD oficial;
  - deixa o progresso visivel para o cliente.
- Para extensoes como Cursos, Games, Softwares, Lojas, Ferramentas e Atendimento:
  - o update fica modular e nao reinstala a Mike inteira;
  - o card mostra instalado/opcional, versao instalada, versao disponivel e update pendente.
- `includes/local_ai_catalog.php` passou a anunciar `local_ai` como `2.13.6-minike`.

Comportamento esperado:

- O menu lateral continua limpo.
- Extensoes aparecem como cards buscaveis em `Internet e ferramentas`.
- Quando houver versao maior no catalogo, aparece badge de update e botao `Atualizar`.
- Updates pequenos de extensoes nao mexem no app inteiro.
- Update da Mike inteira abre terminal visivel, evitando a sensacao de travamento.

Pendencias:

- Criar painel super admin para publicar update por modulo, plano, tenant, empresa ou grupo de usuarios.
- Adicionar pareamento de conta Minike para mostrar exatamente quais extensoes o usuario/empresa comprou.
- Assinar pacotes de extensao e validar hash antes de instalar arquivos locais.
- Permitir rollback de extensao quando um update falhar.

## Mike Local 2.13.7 - Pareamento de conta Minike e extensoes liberadas - 2026-06-16

Objetivo:

- Fazer a Mike Local reconhecer o usuario/empresa do ecossistema Minike sem pedir senha dentro do aplicativo local.
- Sincronizar plano, modulos/extensoes liberadas e perfil da conta.
- Preparar a base para cursos, games, ferramentas, WhatsApp, lojas e outros subsistemas aparecerem conforme direito de uso.

Implementacao no servidor:

- Novo arquivo `includes/local_ai_devices.php`.
  - Cria tabela `mk_local_ai_devices`.
  - Gera codigo de dispositivo e codigo curto para o usuario.
  - Aprova dispositivo somente com usuario logado no site.
  - Gera token local revogavel com hash no servidor.
  - Retorna perfil, escopos e modulos liberados.
- Novo endpoint `api/local-ai-device.php`.
  - `POST ?action=start`: inicia pareamento.
  - `GET/POST ?action=status`: Mike Local consulta aprovacao pelo `device_code`.
  - `GET ?action=profile`: Mike Local autenticada consulta conta/modulos.
  - `POST ?action=revoke`: revoga token da Mike Local.
- Nova pagina `local-ai/parear.php`.
  - Se o usuario nao estiver logado, encaminha para `login.php`.
  - Mostra codigo e dados do dispositivo.
  - Aprova o pareamento com CSRF.

Implementacao na Mike Local:

- `local-ai/mike-local-ai-minike.ps1` atualizado para `2.13.7-minike`.
- Novo arquivo local `account.json`.
  - Token fica protegido via DPAPI do Windows, reaproveitando `Protect-ConnectorSecret`.
  - O valor do token nao volta para a tela.
- Novas rotas locais:
  - `GET /account/status`
  - `POST /account/pair/start`
  - `POST /account/pair/check`
  - `POST /account/disconnect`
- A tela `Configuracoes` ganhou card `Conta Minike`.
  - Conectar conta abre automaticamente `/local-ai/parear.php?code=...`.
  - Verificar confirma o pareamento e salva token protegido.
  - Desconectar revoga o token e limpa perfil local.
  - Lista modulos liberados pela conta/plano.

Seguranca:

- A Mike Local nao coleta senha Minike.
- O token fica com hash no servidor e protegido pelo usuario atual do Windows no PC.
- A aprovacao depende de sessao web logada e CSRF.
- Token pode ser revogado pela propria Mike Local.
- API usa `Cache-Control: no-store` e `X-Content-Type-Options: nosniff`.

Validacoes locais:

- `php -l includes/local_ai_devices.php`: aprovado.
- `php -l api/local-ai-device.php`: aprovado.
- `php -l local-ai/parear.php`: aprovado.
- `php -l includes/local_ai_catalog.php`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

Pendencias:

- Criar painel web para o usuario/super admin ver dispositivos conectados e revogar manualmente.
- Amarrar modulos a pagamentos/entitlements reais com mais granularidade por empresa, tenant e cargo.
- Mostrar nome da empresa quando a conta estiver ligada a CNPJ/tenant.
- Sincronizar permissoes do WhatsApp/lojas/cursos/games por escopo especifico.

## Mike Local 2.13.1 - Chat normal conectado ao Programar e chat lateral estilo VS Code - 2026-06-16

Objetivo:

- Permitir que o usuario trabalhe tanto pelo chat normal quanto pela aba `Programar`.
- Adicionar uma lateral de conversa dentro do editor, inspirada no fluxo VS Code/Codex, sem poluir a area central do codigo.
- Fazer a IA receber contexto do projeto e do arquivo ativo quando o usuario pedir explicacao, revisao, testes, bugs, ferramentas, internet, memoria, agentes ou Codex.

Implementacao em `local-ai/mike-local-ai-minike.ps1`, versao `2.13.1-minike`:

- Novo `Get-ChatActiveFileContext`.
  - Recebe `active_file` enviado pela interface.
  - Inclui projeto, ID do projeto, arquivo, linguagem detectada e conteudo exibido no editor.
  - Limita o conteudo enviado para evitar travar conversa em arquivos muito grandes.
  - Usa o arquivo como contexto, sem gravar nada automaticamente.
- `Handle-Chat` agora combina:
  - historico da conversa;
  - contexto de projetos/workspaces;
  - anexos;
  - arquivo ativo do Programar;
  - pesquisa web publica autorizada;
  - delegacao universal para agentes/maquinas quando a tarefa exigir.
- O chat normal agora envia `active_file` quando existir arquivo aberto no Programar.
  - Quem prefere conversar pela tela principal pode pedir coisas do projeto sem entrar no editor o tempo todo.
- A aba `Programar` ganhou:
  - botao `Chat` na barra superior;
  - painel lateral `Chat do projeto`;
  - historico proprio da conversa do Programar;
  - envio com Enter;
  - contexto automatico do arquivo aberto;
  - botao `Mandar ao Codex`, que prepara a tarefa no painel Codex do projeto confiavel.
- O layout do editor agora suporta quatro paineis:
  - Explorador;
  - Codigo;
  - Problemas;
  - Chat do projeto.
- O painel de chat pode ser recolhido para liberar espaco.
- A responsividade foi ajustada para empilhar os paineis em telas menores.
- Melhoria visual adicionada na mesma rodada:
  - bolhas do chat normal e do chat do Programar ganham estado animado enquanto a Mike trabalha;
  - respostas aparecem digitando aos poucos na tela;
  - ultimos eventos de agentes/PCs recebem destaque vivo;
  - cards de agentes em execucao pulsam discretamente;
  - a interface mostra atividade, plano e eventos auditaveis, mas nao exibe raciocinio privado bruto da IA.

Comportamento esperado:

- Pergunta simples no chat normal continua rapida.
- Pergunta com projeto/arquivo aberto recebe contexto do codigo.
- No Programar, o usuario pode perguntar "explique este arquivo", "ache bug", "crie testes", "mande para o Codex corrigir" sem sair do editor.
- Se a tarefa for complexa e modo agentes estiver ativo, a Mike pode registrar uso de agentes/rede no retorno.
- Quando agentes/PCs participam, a timeline mostra troca de demandas, maquina escolhida, agente atual, revisao e fallback de forma visual.
- O Codex continua exigindo projeto confiavel e confirmacao visual quando precisar de permissao.

Validacoes:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

Pendencias da proxima etapa:

- Fazer o chat lateral mostrar cards de ferramenta acionavel, nao apenas texto quando a resposta roteia para ferramenta.
- Permitir aplicar patch sugerido pelo chat lateral com revisao visual antes de salvar.
- Mostrar eventos internos de agentes em tempo real dentro do chat lateral.
- Unificar visualmente o chat lateral com o stream do Codex, para o usuario acompanhar planejamento, execucao, revisao e testes numa timeline unica.

## Mike Local 2.13.2 - Correcao do seletor de pasta e auditoria de botoes - 2026-06-16

Objetivo:

- Corrigir o botao `Abrir pasta` da aba `Programar`, que em alguns Windows nao mostrava o gerenciador/seletor de pasta ao usuario.
- Garantir que os botoes principais continuem apontando para funcoes existentes depois das ultimas mudancas de chat, Programar e memoria.

Implementacao em `local-ai/mike-local-ai-minike.ps1`, versao `2.13.2-minike`:

- `Select-ProjectFolder` deixou de criar uma janela dona invisivel fora da tela.
  - Antes a janela ficava em `-32000,-32000`, e em alguns ambientes o seletor podia abrir fora da area visivel ou atras do app.
  - Agora o `FolderBrowserDialog` abre diretamente em STA, com visual styles e raiz `Meu computador`.
- `/projects/select` agora aceita `path` opcional no corpo JSON.
  - Isso permite fallback manual quando o Windows, permissao ou ambiente bloqueia o seletor visual.
- Nova funcao de interface `chooseProjectFolder`.
  - Tenta abrir a janela do Windows.
  - Se a selecao for cancelada ou nao aparecer, pede o caminho da pasta em uma caixa simples.
  - Conecta a pasta, recarrega projetos e executa a acao de destino.
- Botoes atualizados para usar a mesma funcao:
  - `Projetos > Escolher pasta`;
  - `Programar > Abrir pasta`;
  - `Memoria/Canvas > Conectar pasta`.
- Auditoria automatica simples de IDs/handlers:
  - Comparou IDs declarados no HTML com referencias `el(...)`/`getElementById(...)`.
  - Nao encontrou botao real sem elemento correspondente.
  - Os falsos positivos `chat`, `explorer` e `problems` eram nomes de paineis, nao IDs ausentes.

Comportamento esperado:

- Clicar em `Abrir pasta` deve abrir o seletor nativo do Windows.
- Se a janela nao aparecer ou for cancelada, a Mike pede o caminho manualmente.
- Ao conectar pelo Programar, o projeto fica selecionado e o Explorador abre automaticamente.

Validacoes:

- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.

## Mike Local 2.13.3 - Programacao sem projeto, skill correta e modelos autoativados - 2026-06-16

Objetivo:

- Corrigir o caso em que `me de um codigo html de uma calculadora` era roteado para a ferramenta `Calculadora`, em vez de usar a skill/fluxo de programacao.
- Permitir ajuda com um unico arquivo ou rascunho, mesmo quando o cliente nao quiser conectar o projeto inteiro.
- Fazer instalacao de novo modelo ficar mais coerente: o modelo baixado pode virar principal automaticamente ao concluir.

Implementacao:

- Novo detector `Test-MessageIsProgrammingRequest`.
  - Prioriza pedidos de codigo, HTML, CSS, JS, PHP, Python, bug, teste, funcao, pagina, componente, API e similares.
  - Quando a intencao for programacao, `Find-MinikeToolsForMessage` nao abre ferramenta comum.
- `/ui/chat` agora devolve `intent = programming` e metadado `programming.open_programming = true` para pedidos de codigo.
- A interface abre automaticamente a aba `Programar` quando a resposta trouxer um bloco de codigo.
- Novo modo `Rascunho avulso`.
  - Cria aba de codigo sem projeto conectado.
  - Nao tenta autosalvar no disco.
  - Mostra preview local para HTML quando possivel.
  - Permite editar livremente.
  - Ao clicar em salvar, pede uma pasta e grava o arquivo escolhido.
- O prompt da Mike foi reforcado para devolver codigo em bloco markdown com linguagem correta quando o usuario pedir exemplo/criacao de codigo.
- O botao de modelo agora aparece como `Instalar e usar`.
  - Envia `activate_on_complete = true`.
  - O backend registra jobs com `activate_on_complete`.
  - `Get-ModelJobs` sincroniza jobs concluidos e chama `Set-ActiveModel` automaticamente.
  - Observacao: a Mike troca o modelo principal, mas nao apaga o modelo antigo sem confirmacao, para nao quebrar agentes/skills.

Comportamento esperado:

- Perguntar `me de um codigo em html de uma calculadora` deve gerar codigo e abrir `Programar` com rascunho e preview.
- Se o cliente nao conectar projeto, ainda consegue editar/testar visualmente o arquivo avulso.
- Se decidir salvar, escolhe uma pasta e a Mike grava o arquivo.
- Instalar um modelo compativel passa a baixar em segundo plano e ativar no fim.

Validacoes:

- JavaScript extraido da UI com `node --check`: aprovado.
- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

## Mike Local 2.12.9 - Correcao do Leads B2B/prospeccao - 2026-06-16

Objetivo:

- Corrigir o pacote real usado pelo instalador da Mike Local para o Extrator de Leads B2B.
- Evitar que maquinas instaladas continuem usando o fluxo antigo com terminal/janela visivel, config fragil ou storage compartilhado do Crawlee.

Correcoes aplicadas:

- Pacote `APIFY/apyfy` atualizado para `3.1.1`.
- `APIFY/apyfy/main.js` agora usa storage isolado por job:
  - `CRAWLEE_STORAGE_DIR = <job>/crawlee-storage`.
  - `CRAWLEE_PURGE_ON_START = true`.
  - Isso evita mistura de filas/resultados entre coletas diferentes.
- Confirmado que o modo Mike usa:
  - `MINIKE_JOB_CONFIG`.
  - Execucao headless.
  - `results.jsonl` em tempo real.
  - Leads descobertos aparecem antes do enriquecimento terminar.
  - Excel so abre no modo interativo manual, nao pela tela da Mike.
- Reforcado manifesto local da ferramenta:
  - `package_version = 3.1.1`.
  - `Get-LeadsB2BStatus` agora retorna `package_version`.
- A versao da Mike foi atualizada para `2.12.9-minike`.

Motivo provavel dos erros vistos:

- PCs ja instalados podiam estar usando pacote antigo baixado antes das correcoes.
- O erro `MINIKE_CONFIG_ERROR: Unexpected token 'ï»¿'` e tipico de JSON com BOM em versao antiga do extrator; a versao atual remove BOM antes do `JSON.parse`.
- Timeouts antigos de 90 segundos foram trocados no pacote APIFY atual para tempo maior e sem retries repetitivos.
- O navegador do Playwright agora roda escondido no modo Mike, com resultado visual dentro da UI.

Como testar:

1. Atualizar/reinstalar a Mike no PC cliente.
2. Abrir `Internet e ferramentas` > `Extrator de Leads B2B`.
3. Rodar uma cidade pequena primeiro, exemplo:
   - Nicho: Supermercados.
   - Estado: SC.
   - Cidade: Guaramirim.
   - Ritmo: equilibrado/lento.
4. Conferir se os registros aparecem na tabela durante a coleta.
5. Exportar XLSX/PDF somente depois de revisar os registros.

Validacoes:

- `node --check APIFY/apyfy/main.js`: aprovado.
- `node --check APIFY/apyfy/export-results.mjs`: aprovado.
- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

Observacao:

- Nao foi executada coleta real automatica de Google Maps nesta validacao para evitar consumo/bloqueio de fonte durante teste tecnico. O teste real deve ser feito pela UI com volume pequeno e ritmo lento/equilibrado.

## Mike Local 2.13.0 - Internet livre controlada, autoaprendizado e sugestoes para o Imperio Minike - 2026-06-16

Objetivo:

- Permitir que a Mike pesquise mais, aprenda com fontes publicas e amplie a memoria local sem virar uma internet irrestrita perigosa.
- Quando encontrar conteudo, funcao, ideia de mercado ou lacuna relevante para o ecossistema Minike, registrar uma sugestao rastreavel para o Super Admin.
- Preparar o caminho para um futuro sistema seguro de automacao de postagem, sem publicar automaticamente nesta fase.

Implementacao:

- Versao atualizada para `2.13.0-minike`.
- Nova fila local: `%LOCALAPPDATA%\MINIKE-Local-AI\memory\empire-suggestions.jsonl`.
- Nova funcao `Test-MinikeEmpireOpportunity`.
  - Detecta termos como Minike, Mike, imperio, site, conteudo, blog, post, campanha, marketing, SEO, ferramenta, software, venda, revenda, monetizacao, concorrente, mercado e tendencia.
- Nova funcao `Save-EmpireLearningSuggestion`.
  - Usa o contexto de pesquisa web ja coletado.
  - Cria uma nota Markdown na memoria local.
  - Salva fontes, data, pedido original, resposta/rascunho, confianca inicial e proxima acao segura.
  - Marca a nota com tags: `imperio-minike`, `sugestao`, `internet`, `super-admin`, `conteudo`.
  - Registra uma entrada JSONL para revisao do Super Admin.
- O chat agora retorna `empire_suggestion` quando uma sugestao e criada.
- A UI exibe aviso: sugestao salva na memoria e marcada para revisao do Super Admin.

Politica de seguranca:

- A Mike pode pesquisar, resumir e criar memoria com fonte/data/confianca.
- A Mike nao publica conteudo automaticamente em sites/subsites nesta fase.
- Publicacao exige revisao humana, direitos autorais, LGPD, risco comercial e confirmacao do Super Admin.
- Arquivos privados, credenciais, banco, WhatsApp e acoes sensiveis continuam fora do autoaprendizado sem permissao explicita.

Exemplos de uso:

- `pesquise tendencias de IA para pequenas empresas e veja o que falta no imperio Minike`
- `pesquise ferramentas populares de PDF e sugira conteudos para nossos sites`
- `pesquise ideias de campanhas para vender Mike Local no Brasil`

Resultado esperado:

- A Mike responde ao usuario.
- Se houver oportunidade para o ecossistema, cria nota de memoria.
- A sugestao entra na fila `empire-suggestions.jsonl`.
- O Super Admin pode revisar depois e decidir se vira pagina, post, campanha, skill ou ferramenta.

Validacoes:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.
- `local-ai\instalar-mike-windows.cmd --validate`: aprovado em copia temporaria local; o `cmd.exe` nao suporta executar diretamente a partir de UNC.
- Publicacao concluida em `https://minike.com.br/local-ai/mike-local-ai-minike.ps1` e `https://minike.com.br/local-ai/instalar-mike-windows.cmd`.
- Hashes publicados:
  - `mike-local-ai-minike.ps1`: `22e1fd160488177f31a8e8b100dba206c82932c02c78055e23475bbb3d21184e`.
  - `instalar-mike-windows.cmd`: `f98c61b3f0dfcc7ed058401993bbcfb4d6cb5bf0cd7a2f56ba477bc08f91a79d`.
- Validacao HTTPS publica:
  - `mike-local-ai-minike.ps1` baixado do site mostrou `AgentVersion = "2.12.4-minike"` e parseou com `-ValidateOnly`.
- `instalar-mike-windows.cmd` baixado do site apontou para o SHA-256 correto do nucleo e passou em `--validate`.

## Mike Local 2.13.4 - Programar com arquivo unico autorizado - 2026-06-16

Objetivo:

- Permitir que um cliente receba ajuda em apenas um arquivo, sem entregar acesso ao projeto inteiro.
- Manter o chat lateral, analise, autosave e revisao da aba Programar funcionando com esse arquivo.
- Evitar que a autorizacao de um arquivo seja tratada como confianca na pasta inteira.

Implementacao:

- Versao atualizada para `2.13.4-minike`.
- Nova funcao `Select-ProjectFile`.
  - Abre o seletor nativo do Windows para escolher um unico arquivo.
  - Usa `OpenFileDialog`, nao terminal.
  - Aceita arquivos de texto/codigo comuns e ainda valida conteudo textual antes de autorizar.
- Nova funcao `Add-ProjectSingleFile`.
  - Salva uma entrada local com `single_file = true`.
  - Registra `single_file_path` e `single_file_relative`.
  - Limita leitura e escrita ao arquivo escolhido.
- `Resolve-ProjectPath` agora bloqueia qualquer tentativa de acessar outro arquivo quando a entrada for `single_file`.
- `Get-ProjectItems` lista somente o arquivo autorizado nesse modo.
- Nova rota local `POST /projects/select-file`.
- Aba Programar ganhou o botao `Abrir arquivo`.
  - O usuario escolhe um arquivo avulso.
  - A Mike abre o arquivo no editor.
  - O autosave grava somente esse arquivo.
  - O chat lateral envia o conteudo do arquivo ativo como contexto.
- Cartoes de projetos agora indicam `Arquivo avulso` quando a permissao for de arquivo unico.
- O botao `Mandar ao Codex` bloqueia arquivo avulso, porque o Codex completo trabalha por pasta/projeto confiavel. Para Codex, o usuario deve conectar uma pasta explicitamente.

Comportamento esperado:

- Cliente pode pedir ajuda em `500.php`, `.htaccess`, `.env.example`, `index.html`, `style.css`, `script.js`, etc. sem abrir a pasta toda.
- Arquivos binarios ou acima de 5 MB continuam protegidos.
- O modo rascunho sem projeto continua existindo para codigo criado pela conversa.
- Se o usuario quiser transformar o rascunho em arquivo real, ainda escolhe uma pasta conscientemente.

Validacoes locais:

- JavaScript de todos os blocos `<script>` extraidos da UI com `node --check`: aprovado.
- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

## Mike Local 2.13.5 - Extensoes do Imperio Minike, Cursos/Games e updates por modulo - 2026-06-16

Objetivo:

- Fazer a Mike Local virar cerebro/corpo do ecossistema Minike sem poluir o menu lateral.
- Manter cada area do imperio separada como extensao instalavel/fixavel: Cursos, Games, Softwares, Ferramentas, Atendimento, Lojas etc.
- Permitir atualizacoes especificas por extensao, afetando apenas usuarios que possuem aquele modulo instalado ou habilitado.
- Preparar reconhecimento de conta Minike para personalizar botoes, abas, permissoes e avisos por usuario/plano/empresa.

Decisao de arquitetura:

- O menu lateral da Mike continua enxuto.
- Areas grandes entram no catalogo como `ecosystem_surfaces`.
- Cada surface pode declarar:
  - `id`, `name`, `summary`, `url`, `kind`, `category`;
  - `installable` e `pinnable`;
  - `account_required`;
  - `required_scopes`;
  - `version`, `channel` e `update_policy`;
  - `ui_schema` para montar telas internas com abas e botoes;
  - `entrypoints` para links importantes.
- `extension_packs` agrupam surfaces relacionadas, por exemplo:
  - `core_business`: ferramentas, softwares, atendimento e lojas;
  - `learning_games`: cursos e games;
  - `creator_studio`: ferramentas de criacao/design.

Implementacao atual:

- `includes/local_ai_catalog.php`
  - Nova funcao `mkai_ecosystem_surfaces()`.
  - Nova funcao `mkai_extension_packs()`.
  - `mkai_manifest()` agora expÃµe `ecosystem_surfaces` e `extension_packs`.
  - Cursos e Games ja possuem `ui_schema`.
- `api/local-ai.php?action=catalog`
  - Agora retorna `ecosystem_surfaces` e `extension_packs`.
- `local-ai/mike-local-ai-minike.ps1`
  - Versao atualizada para `2.13.5-minike`.
  - A aba `Internet e ferramentas` cria uma categoria dinamica `Extensoes Minike`.
  - Extensoes aparecem como cards pesquisaveis, nao como botoes fixos no menu lateral.
  - Cards de extensao exibem badges `extensao` e `instalavel`.
  - O chat passa a considerar `ecosystem_surfaces` ao rotear pedidos como cursos, games, lojas, softwares e atendimento.
  - O navegador interno ganhou suporte a `ui_schema`.
    - Quando a extensao declara abas, a Mike mostra abas acima do iframe.
    - Atalhos rapidos da extensao aparecem abaixo das abas.
    - Ferramentas simples continuam abrindo como antes.

Cursos Minike:

- Surface `courses`.
- Requer conta Minike recomendada/necessaria para personalizacao completa.
- Escopos planejados: `courses.consume`, `account.view`.
- Abas declaradas:
  - Inicio;
  - Cursos;
  - Trilhas;
  - Tarefas;
  - Atividades;
  - Simulados;
  - Linha do tempo;
  - Certificados.
- Acoes rapidas:
  - Continuar curso;
  - Ver trilhas;
  - Ranking.
- Papeis de IA planejados:
  - tutor;
  - avaliador;
  - criador de exercicios;
  - resumidor de aulas.

Games Minike:

- Surface `games`.
- Requer conta Minike recomendada/necessaria para pontuacao, moedas e ranking.
- Escopos planejados: `games.play`, `account.view`.
- Abas declaradas:
  - Inicio;
  - Jogar;
  - Kids;
  - Ranking;
  - Moedas;
  - Medalhas;
  - Comunidade;
  - Studio.
- Acoes rapidas:
  - Abrir Kids;
  - Ver ranking;
  - Enviar jogo.
- Papeis de IA planejados:
  - coach de jogos;
  - criador de desafios;
  - moderador de comunidade.

Conta Minike e reconhecimento do usuario:

- Estado planejado:
  - A Mike Local deve parear com a conta Minike do usuario/empresa.
  - O site deve expor endpoint seguro para iniciar pareamento, confirmar dispositivo e retornar perfil minimo.
  - A Mike deve salvar apenas token local protegido, nao senha.
  - O perfil local deve conter no maximo: nome exibido, email mascarado, user_id, empresa_id, plano, scopes e modulos liberados.
- Seguranca obrigatoria:
  - Login sempre no dominio Minike, nunca capturar senha dentro da Mike.
  - Device code/OAuth-like flow ou token temporario com expiracao curta.
  - Revogacao pelo painel da conta.
  - Auditoria local e no servidor.
  - Scopes por extensao.

Atualizacoes por extensao:

- Cada surface agora pode declarar `version`, `channel` e `update_policy`.
- Direcao de produto:
  - Mostrar aviso visual quando uma extensao instalada estiver abaixo da versao publicada.
  - Botao `Atualizar` deve abrir prompt/terminal interno guiado ou usar atualizacao web quando for `server_managed`.
  - Atualizacao deve afetar apenas a extensao/modulo correspondente.
  - Permitir canais `stable`, `beta`, `enterprise`, `school`, `games`, `creator`.
  - Super admin deve conseguir publicar update por modulo, plano, tenant ou grupo de usuarios.

Pendencias imediatas:

- Criar store local de extensoes instaladas/fixadas.
- Criar endpoint local `/extensions` e `/extensions/install`.
- Criar pareamento de conta Minike com device code.
- Criar endpoint publico seguro no site para `local-ai device pairing`.
- Mostrar tela personalizada real quando extensao instalada for aberta.
- Fazer Cursos/Games enviarem `postMessage` para a Mike com status de aula, tarefa, pontuacao e conquistas.
- Adicionar sistema de updates por extensao no painel super admin.
- Validar layout desktop/mobile da tela de extensao.

Validacoes ja feitas nesta etapa:

- `php -l includes/local_ai_catalog.php`: aprovado.
- `php -l api/local-ai.php`: aprovado.

## Mike Local 2.12.5 - Chat com internet controlada e clima - 2026-06-16

Status real da rede de PCs/agentes:

- A rede multi-PC privada existe para jobs fechados em `Agentes > Coordenar`, com relay LAN por pasta compartilhada, heartbeat de maquinas, roteamento por recursos/modelo, envelopes assinados, resultados por JSON e fallback inicial.
- Ainda nao esta pronto como "todo chat vira automaticamente tarefa distribuida". O chat comum ainda responde localmente e so chama agentes/ferramentas quando roteado pela interface.
- A rede publica/comunitaria de processamento continua bloqueada por seguranca, contrato, sandbox, KYC/KYB, antifraude e revisao juridica.

Alteracoes aplicadas em `local-ai/mike-local-ai-minike.ps1`, versao `2.12.5-minike`:

- Adicionada deteccao `Test-MessageNeedsPublicWeb` para perguntas que pedem internet/atualidade: `pesquise`, `procure`, `google`, `internet`, `web`, `noticias`, `hoje`, `agora`, `atual`, `clima`, `tempo`, `cotacao`, `preco`, etc.
- Adicionado `Get-PublicWebContext`, que usa busca web publica controlada, coleta ate 3 fontes HTTPS publicas, extrai texto e entrega trechos ao prompt da LLM.
- `Build-Prompt` agora recebe `WebContext` e instrui a IA a citar URLs quando usar pesquisa web.
- Adicionado `Get-WeatherAnswer` para clima/previsao via `https://wttr.in`, sem chave de API, com cidade obrigatoria. Exemplo: `clima em Guaramirim SC`.
- `Test-AllowedSourceUrl` agora aceita `AllowedDomains = "*"` para pesquisa publica controlada, mantendo bloqueio de IP privado/local e exigencia de HTTPS.

Limites e proximas etapas:

- A busca usa fonte publica leve; nao deve mascarar fornecedor nem fingir que abriu Google de verdade.
- Para clima mais profissional, integrar OpenWeather/WeatherAPI com chave BYOK ou conta Minike, cache e limite por plano.
- Para "internet visual", criar modo navegador interno: a Mike abre um painel de pesquisa na propria UI, mostra fontes carregando, resume e salva fontes na memoria.
- Para "chat distribuido automatico", criar fila universal que transforma perguntas complexas em tarefas para agentes/cluster, com criterio de quando vale dividir e quando responde localmente.

Validacoes:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

## Mike Local 2.12.6 - Fila universal do chat para rede/agentes - 2026-06-16

Objetivo:

- Fazer o chat comum deixar de ser uma peÃ§a separada e passar a usar automaticamente a rede de PCs/agentes quando a pergunta exigir trabalho maior.
- Manter respostas simples rapidas localmente, mas delegar perguntas complexas, modo agentes e pedidos de analise/pesquisa/programacao.

Implementacao em `local-ai/mike-local-ai-minike.ps1`, versao `2.12.6-minike`:

- Novo tipo fechado de tarefa do cluster: `llm_assist_text`.
  - Worker recebe apenas `role`, `task` e `context`.
  - Sem acesso a arquivos, terminal, navegador, credenciais ou shell.
  - Responde uma contribuicao curta e verificavel para o coordenador final.
- `allowed_tasks` padrao agora inclui `llm_assist_text`.
- Configuracoes antigas ganham `llm_assist_text` automaticamente na normalizacao.
- A tela de configuracao do worker preserva `llm_assist_text` mesmo sem checkbox antigo.
- Nova funcao `Test-ShouldUseUniversalChatDelegation`.
  - Usa delegacao quando `modo agentes` esta ligado.
  - Usa delegacao quando a mensagem e longa ou contem termos como programacao, erro, bug, teste, analise, pesquise, planeje, crie, compare, projeto, imposto/fiscal etc.
- Nova funcao `Invoke-UniversalChatDelegation`.
  - Cria job `universal_chat_delegation` em `compute-jobs`.
  - Monta papeis: Planejador, Pesquisador, Executor e Revisor.
  - Escolhe workers locais/LAN por score e disponibilidade.
  - Envia subtarefas LAN pelo relay privado quando houver worker online.
  - Executa subtarefas locais imediatamente.
  - Aguarda ate 18 segundos por resultados LAN.
  - Salva eventos, atribuicoes, resultado, pendencias e falhas.
  - Entrega as contribuicoes ao prompt final da LLM para responder ao usuario.
- `Handle-Chat` agora tenta a fila universal antes da resposta final da LLM.
- A UI do chat mostra aviso quando a resposta usou rede/agentes e exibe o ID da tarefa.

Comportamento esperado:

- Perguntas simples como `oi`, `que horas sao`, `receita de bolo` continuam rapidas.
- Perguntas maiores passam pela fila universal se o worker privado estiver ativo.
- Se houver PCs LAN com a Mike atualizada, ativos e no mesmo relay privado, eles recebem subtarefas automaticamente.
- Se nao houver worker seguro online ou os resultados nao voltarem a tempo, a resposta continua localmente sem travar.

Limitacoes conhecidas:

- Workers LAN precisam estar com a versao `2.12.6-minike` ou superior para aceitar `llm_assist_text`.
- O relay LAN depende da Mike aberta/sincronizando nos outros PCs; ainda nao ha servico Windows permanente para processar fila em segundo plano.
- A resposta final ainda e sintetizada no PC coordenador.
- Rede publica/comunitaria continua bloqueada.

Validacoes:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

Pendencias para a proxima evolucao:

- Transformar o mapeamento em streaming real por eventos, para mostrar cada arquivo aparecendo durante a leitura do disco, nao apenas apos o backend concluir o calculo inicial.
- Adicionar filtros visuais por pasta, linguagem, arquivo isolado, entrada, saida e ciclos.
- Adicionar zoom inteligente por grupo/pasta e mini-mapa.
- Detectar mais tipos de dependencia: Composer autoload, package.json exports/scripts, aliases de bundlers, Laravel/WordPress routes, SQL migrations e chamadas de API internas.
- Permitir que a IA explique uma linha do mapa: "por que este arquivo depende daquele?".
- Permitir exportar o mapa para PNG/PDF e anexar ao relatorio do projeto.

## Mike Local 2.12.7 - Sincronizacao automatica de varios PCs/agentes - 2026-06-16

Objetivo:

- Fazer a rede privada de maquinas trabalhar de verdade sem depender de o usuario deixar a tela de Agentes aberta.
- Permitir que perguntas complexas do chat virem subtarefas automaticamente para PCs da conta/empresa quando o relay LAN estiver ativo.
- Evitar enviar tarefa para maquina antiga/incompleta que ainda nao aceita o tipo de trabalho solicitado.

Implementacao em `local-ai/mike-local-ai-minike.ps1`, versao `2.12.7-minike`:

- Novo modo de sincronizacao LAN: `background`.
  - Aparece na tela como `Automatica em segundo plano`.
  - Usa a Mike iniciada junto com o Windows para publicar presenca, buscar tarefas, executar e devolver resultados.
  - Nao exige janela de terminal nem a tela da Mike aberta.
- Novo controle interno `background_sync_interval_seconds`.
  - Padrao: 5 segundos.
  - Minimo: 3 segundos.
  - Maximo: 60 segundos.
- Novo ciclo `Invoke-BackgroundComputeLanSync`.
  - Roda durante o loop HTTP local da Mike.
  - Respeita worker desligado/pausado.
  - Respeita relay LAN desligado.
  - Processa jobs recebidos e coleta resultados pendentes.
  - Registra auditoria somente quando processa/coleta algo, evitando log inutil.
- O loop principal agora chama:
  - `Invoke-DueMacros`
  - `Invoke-BackgroundComputeLanSync`
- `Get-ComputeWorkerCandidates` agora inclui `allowed_tasks` em cada candidato.
- A delegacao universal do chat agora filtra workers que aceitam `llm_assist_text`.
  - Maquinas antigas continuam visiveis, mas nao recebem subtarefa de chat se ainda nao suportam esse tipo.
- `Invoke-UniversalChatDelegation` sincroniza relay tanto em `auto_ui` quanto em `background`.
- A interface continua atualizando a tela de Agentes se ela estiver aberta em `auto_ui` ou `background`, para mostrar eventos, atribuicoes e resultados.

Como testar em varios PCs da empresa:

1. Atualizar/instalar a Mike em todos os computadores com o instalador publicado.
2. Abrir `Agentes` > configurar worker privado.
3. Ativar `Este PC pode trabalhar como worker privado`.
4. Usar o mesmo `account_id` ou `team_id` nos PCs que vao trabalhar juntos.
5. Ativar `Relay LAN` apontando para a mesma pasta compartilhada acessivel por todos.
6. Selecionar `Sincronizacao LAN = Automatica em segundo plano`.
7. Deixar a Mike iniciar com o Windows em todos os PCs.
8. Fazer uma pergunta complexa no chat ou ativar modo agentes.
9. Conferir em `Agentes` a timeline do job com Planejador, Pesquisador, Executor e Revisor.

Comportamento esperado:

- Perguntas simples continuam locais e rapidas.
- Perguntas complexas criam job `universal_chat_delegation`.
- PCs LAN compativeis recebem subtarefas por relay privado.
- O coordenador aguarda ate 18 segundos por contribuicoes e monta a resposta final.
- Se uma maquina falhar, timeoutar ou ficar sem recurso, o sistema registra fallback e tenta outro worker quando possivel.

Limites atuais:

- A rede publica/comunitaria de processamento continua bloqueada ate sandbox, contrato, antifraude, KYC/KYB e politica de pagamento ficarem prontos.
- O relay LAN atual usa pasta compartilhada privada; ainda nao e um servidor websocket/cloud em tempo real.
- A tela mostra eventos e resultados, mas ainda nao faz streaming token a token das conversas internas dos agentes.
- Todos os PCs precisam estar atualizados para `2.12.7-minike` ou superior para o comportamento de fundo ficar confiavel.

Validacoes:

- `powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -DefaultProjectPath '\\servidor-que-nao-existe\minike'`: aprovado.
- JavaScript extraido da UI com `node --check`: aprovado.
- `scripts\test-local-ai-workspace.ps1 -SkipLive`: aprovado.

## Mike Local 2.14.2 - Quatro modos de instalacao e escolha por plataforma - 2026-06-16

Objetivo:

- Manter o modo atual/compatibilidade e adicionar mais tres formas de uso para o cliente escolher na tela do site.
- Evitar que o usuario ache que a Mike e apenas uma aba comum do Edge.
- Mostrar vantagens, limites e botoes claros para Windows 7/8/10/11, Linux, Android e iOS.

Modos Windows oficiais:

1. `classic`
   - Abre no navegador padrao.
   - Melhor para Windows antigo, ambiente bloqueado ou suporte simples.
2. `app`
   - Modo recomendado.
   - Cria icone e abre via Edge/Chrome com `--app`, sem barra de navegador, parecendo aplicativo.
3. `pwa`
   - Tenta instalar/registrar como PWA no Edge e depois abre em modo app.
   - Se o navegador nao aceitar instalacao automatica, cai para modo app.
4. `desktop`
   - Canal reservado para shell nativo Tauri/Electron/WebView2.
   - Se o pacote `MikeLocalDesktop\MikeLocalDesktop.exe` existir, abre ele.
   - Se ainda nao existir, cai para modo app seguro, sem quebrar a instalacao.

Arquivos alterados:

- `local-ai/mike-local-ai-minike.ps1`
  - Versao `2.14.2-minike`.
  - Novo parametro `-InstallMode classic|app|pwa|desktop`.
  - Salva `install_mode` no `config.json` local.
  - Launcher passa a respeitar o modo escolhido.
- `local-ai/instalar-mike-windows.cmd`
  - Aceita `--mode classic`, `--mode app`, `--mode pwa`, `--mode desktop` e atalhos `--classic`, `--app`, `--pwa`, `--desktop`.
  - Tambem aceita `MINIKE_INSTALL_MODE` injetado pelo download dinamico.
- `local-ai/baixar.php`
  - Gera CMD dinamico quando recebe `?mode=classic|app|pwa|desktop`.
  - Nome do arquivo baixado indica o modo escolhido.
- `local-ai/index.php`
  - Nova tela com cards de instalacao.
  - Mostra vantagens/limites de cada modo.
  - Inclui cards por plataforma: Windows 7/8, Windows 10/11, Linux, Android/iOS.
- `includes/local_ai_catalog.php`
  - Manifest agora publica `windows_install_modes`.
  - Versao do instalador no manifest alinhada para `2.14.2-minike`.

Politica de compatibilidade:

- Windows 7/8: modo compatibilidade, sem prometer IA local completa moderna.
- Windows 10/11: modo recomendado com app leve.
- Linux: instalador `.sh` mantido.
- Android/iOS: por enquanto uso via PWA/site responsivo e conta Minike; modelos locais grandes continuam no PC/cloud.

Validacoes locais:

- `php -l includes\local_ai_catalog.php`: aprovado.
- `php -l local-ai\index.php`: aprovado.
- `php -l local-ai\baixar.php`: aprovado.
- `powershell.exe -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -InstallMode app`: aprovado.
- `powershell.exe -File .\local-ai\mike-local-ai-minike.ps1 -ValidateOnly -SkipDependencies -InstallMode desktop`: aprovado.
- `cmd.exe /c "pushd ... && local-ai\instalar-mike-windows.cmd --validate --mode classic/app/pwa/desktop"`: aprovado para os quatro modos.
- `php -r` com `local-ai/baixar.php?mode=desktop`: aprovado, injeta `MINIKE_INSTALL_MODE=desktop`.

Proximas melhorias:

- Criar pacote real Tauri ou Electron assinado para o modo `desktop` nao depender de fallback.
- Adicionar manifest/service worker especifico da PWA local quando a UI local estiver servindo arquivos estaticos separados.
- Criar pagina mobile dedicada com instrucoes de instalar na tela inicial Android/iOS.

## Mike Local - Validacao instalador, imagem, Programar e site - 2026-06-28

Objetivo:

- Conferir a documentacao unificada, os botoes do site, os instaladores Windows e o fluxo de atualizacao da Mike Local.
- Garantir que instalacao e atualizacao puxem os arquivos necessarios para chat, UI externa, imagem local, cluster, engines secundarias e modo Programar.

Correcoes aplicadas:

- `local-ai/install-bundle.ps1`: o preset `cluster` agora instala o mesmo conjunto do `full` para imagem/ComfyUI portatil e exo, antes de ativar o agente de rede. Antes, `--bundle-cluster` podia pular partes importantes do bundle.
- `local-ai/instalar-mike-windows.cmd`: a copia temporaria estavel agora inclui scripts extras de cluster/imagem/engines; o instalador exo embutido e reaproveitado antes de tentar download.
- `local-ai/build-mike-installer-exe.ps1`: o EXE passou a embutir scripts extras de cluster, ComfyUI portatil, AirLLM, multimidia, video, codigo e Piper/embeddings.
- `local-ai/Instalar-Mike-IA-Local.exe`: reconstruido via IExpress naquela rodada. Hash historico `1CA9DBFAAE2542C30AA8B8B8959DE9A0867D04AA43A47D9246C06CC8840CD093`; hash atual valido esta no topo deste documento.
- `local-ai/install-comfyui-portable.ps1`: corrigido erro visto no log real do dono em que `config.json` vazio/null quebrava em `$cfg.PSObject.Properties.Name.Contains("comfyui")`.
- `local-ai/instalar-mike-windows.cmd`: removido `pause` do fim normal e do caminho de reboot automatico; apos o UAC de admin, o fluxo segue sozinho.

Confirmacoes:

- Botao principal de `/local-ai/` aponta para `baixar.php`, que prefere o EXE no Windows; botao tecnico continua apontando para `format=cmd`.
- O CMD baixa core e `.sha256` se nao estiverem embutidos, valida SHA-256, roda `install-bundle.ps1`, instala/atualiza o core e passa `-SecondaryEnginesPreset creator`.
- O core sincroniza para o InstallDir: UI externa, ComfyUI agent/workflow, conectores de cluster, exo/llama.cpp, AirLLM e engines secundarias.
- Projetos/Programar ja possuem input para adicionar pasta via `POST /projects/select`.
- Chat ja roteia pedido obvio de imagem para `image_generation` antes da LLM; se nao houver motor ativo, devolve acao de abrir/instalar gerador.

Validacoes locais:

- Parser PowerShell do core inteiro: aprovado.
- Parser PowerShell do corpo `$agentSource`: aprovado.
- Hash do core bate com `mike-local-ai-minike.ps1.sha256` e com `CORE_SHA256_FALLBACK` do CMD. Core atual `F1718950FDCF54703F7D58DB5F2C5E3065A81BD3C4674BEFC87DA4377B671A5E`.
- `cmd.exe` com `instalar-mike-windows.cmd --validate --bundle-cluster --app`: aprovado.
- `php -l local-ai/baixar.php`, `local-ai/index.php`, `local-ai/instalar.php`: aprovados.
- JavaScript extraido de `local-ai/mike-ui.html` com `node --check`: aprovado.

Pendencia honesta:

- Teste ponta a ponta de imagem depende de um PC real com ComfyUI/checkpoint ativo ou worker LAN online.