FlowCore Space Scanner

App Desktop — Diagnóstico de Disco para Mac e Windows

---

Como usar (2 formas)

FORMA 1 — Script automático (recomendado)

Mac:

# 1. Extraia o ZIP em qualquer pasta
# 2. Abra o Terminal nessa pasta e execute:
chmod +x instalar-mac.sh
./instalar-mac.sh
# O script instala tudo, compila e abre o app

Windows:

1. Extraia o ZIP
2. Clique duas vezes em: instalar-windows.bat
3. Siga as instruções na tela

---

FORMA 2 — Manual (se tiver Node.js instalado)

# 1. Instale as dependências
npm install

# 2. Rode em modo dev (para testar)
npm start

# 3. Compile o instalador final
npm run build:mac    # → gera .dmg para Mac
npm run build:win    # → gera Setup.exe para Windows

---

O que o app faz

✅ Escaneia seu disco real (Downloads, Caches, Renders, Backups iOS, VSTs, Docker, etc.)
✅ Mostra quanto espaço cada pasta usa em GB / MB / Bytes
✅ Classifica cada pasta por risco: ✅ Seguro / ⚠️ Atenção / ⛔ Não recomendado
✅ Botão "Abrir" para cair diretamente na pasta no Finder/Explorer
✅ Botão "Copiar caminho" para colar onde quiser
✅ Guia manual com passo a passo para limpar sem apagar nada errado
✅ Não apaga NADA — é 100% guia de diagnóstico

---

Estrutura do projeto

flowcore-space-scanner/
├── src/
│   ├── main.js          ← Processo principal Electron (escaneia disco)
│   ├── preload.js       ← Bridge segura entre UI e sistema
│   └── renderer/
│       ├── index.html   ← Interface gráfica
│       └── app.js       ← Lógica da UI
├── assets/              ← Ícones e recursos do instalador
├── package.json         ← Configuração do projeto e do build
├── instalar-mac.sh      ← Script de instalação Mac (1 clique)
├── instalar-windows.bat ← Script de instalação Windows (1 clique)
└── README.md

---

Tecnologia

• Electron 28 — framework que transforma HTML/JS em app desktop nativo
• electron-builder — gera o .dmg (Mac) e o Setup .exe com wizard (Windows)
• Node.js nativo — varredura de disco via fs e child_process (sem Python, sem extensão)
• Zero dependência externa em runtime — o usuário final só abre o app

---

Requisitos para build

	Mac	Windows
Node.js	18+	18+
Sistema	macOS 10.14+	Windows 10+
RAM mínima	4 GB	4 GB
Espaço para build	~500 MB	~500 MB

---

Distribuição para usuários finais

Após o build:

Mac: dist/FlowCore Space Scanner-1.0.0.dmg
→ Usuário abre o .dmg, arrasta para /Applications, pronto.

Windows: dist/FlowCore Space Scanner Setup 1.0.0.exe
→ Usuário clica duas vezes no .exe, wizard de instalação completo (Next → Next → Finish).

---

FlowCore | Criado por LEONARDO ASSIS | 2026
flowcoresolucoes.com · Automatize seu negócio