Fatia 8: relatorio do tecnico, linha de comando, Explorer, Opcoes e pagina

README.md

@@ -10,7 +10,9 @@ As regras do projeto estão no [`AGENTS.md`](AGENTS.md) e o desenho em [`docs/su
 
 Baixe o `mapdisk.exe` e abra. Não precisa instalar nem ser administrador. Escolha a unidade, digite uma pasta ou um caminho de rede (`\\servidor\pasta`) e clique em **Varrer**.
 
-> Uso autorizado. O MapDisk - MT mostra o espaço ocupado em discos e pastas e permite enviar arquivos para a Lixeira, movê-los ou, em pastas de rede, excluí-los definitivamente. Use o programa só em computadores e pastas que você tem autorização para administrar. Antes de apagar ou mover, confira a lista de itens e o destino. Em pastas de rede não existe Lixeira: a exclusão não pode ser desfeita pelo programa. O programa não envia nenhuma informação para fora do computador.
+> Uso autorizado. O MapDisk - MT mostra o espaço ocupado em discos e pastas e permite enviar arquivos para a Lixeira, movê-los ou excluí-los definitivamente. Use o programa só em computadores e pastas que você tem autorização para administrar. Antes de apagar ou mover, confira a lista de itens e o destino. Em pastas de rede e em unidades removíveis ou mapeadas, o MapDisk não usa a Lixeira: a exclusão não pode ser desfeita pelo programa e os itens só voltam por uma cópia de segurança. O programa não envia nenhuma informação para fora do computador.
+
+> Licença e garantias. O MapDisk - MT é distribuído gratuitamente sob a GPL-3.0. Os tamanhos mostrados dependem do que o sistema de arquivos informa e das permissões da conta que roda o programa, e podem ficar incompletos quando alguma pasta não pode ser lida. A licença não inclui promessa de funcionamento em todo computador nem serviço de suporte técnico. Quem apaga ou move arquivos pelo programa decide o que tratar e deve ter cópia de segurança do que for importante. As disposições da GPL-3.0 sobre garantias e responsabilidade aplicam-se nos limites permitidos pela legislação brasileira e não restringem direitos assegurados ao consumidor por lei.
 
 Pastas que o Windows não deixa ler aparecem como **sem acesso**, e a barra de baixo diz quantas são. O total não inclui o que está nelas.
 
@@ -26,7 +28,7 @@ Na árvore:
 À direita da árvore, o painel **Análises** responde "o que eu trato?" sobre a pasta selecionada:
 
 - **Gráfico:** o que pesa dentro da pasta, em blocos (área proporcional ao tamanho) ou em pizza (as 10 maiores, com legenda). Segue o "Mostrar" da árvore. Clique duplo num bloco ou numa fatia abre a pasta, e Voltar retorna. Pasta sem leitura fica fora do desenho e aparece pelo nome embaixo dele.
-- **Maiores arquivos:** os 100 maiores.
+- **Maiores arquivos:** os 100 maiores, ou a quantidade escolhida em **Opções**.
 - **Arquivos antigos:** sem alteração há mais de 6 meses, 1, 2 ou 5 anos, com a quantidade e o total.
 - **Por tipo:** vídeo, imagem, áudio, e-mail (.pst, .ost), imagem de disco, compactado e backup, instalador, documento e outros, mais o ranking por extensão.
 - **Por usuário:** o ranking das pastas de perfil em `Users`.
@@ -42,17 +44,35 @@ Para tratar o que ocupa espaço, selecione pastas ou arquivos na árvore ou nas
 - **Excluir definitivamente**, em pasta de rede, unidade mapeada, pendrive e disco removível, onde o programa não usa a Lixeira. A confirmação pede que você digite EXCLUIR.
 - **Mover**, para a pasta que você escolher. Entre unidades, a origem só é apagada depois de a cópia ser conferida.
 
-A confirmação mostra a lista, o total e o destino. O programa não deixa agir na raiz da unidade, nas pastas do Windows, em Program Files, em ProgramData, em arquivos do sistema e em pastas sem leitura, e diz o motivo. Cada item fica no registro de ações, em `%LOCALAPPDATA%\MapDisk\acoes.log`, que o botão **Registro de ações** mostra no Explorer. A barra de baixo soma o que a sessão enviou para a Lixeira, moveu e excluiu. No modo `--demonstracao`, as ações seguem o fluxo na tela, mas nada é apagado nem movido.
+A confirmação mostra a lista, o total e o destino. O programa não deixa agir na raiz da unidade, nas pastas do Windows, em Program Files, em ProgramData, em arquivos do sistema e em pastas sem leitura, e diz o motivo. Cada item fica no registro de ações, em `%LOCALAPPDATA%\MapDisk\acoes.log`, que **Opções** > **Registro de ações** mostra no Explorer. A barra de baixo soma o que a sessão enviou para a Lixeira, moveu e excluiu. No modo `--demonstracao`, as ações seguem o fluxo na tela, mas nada é apagado nem movido.
 
 Quando os arquivos são do cliente, ele decide o que sai. O botão **Relatório do cliente**, no cartão Pastas, tem duas opções:
 
 - **Gerar relatório:** monte a lista com **Sugerir** (maiores pastas, maiores arquivos, antigos e tipos que costumam sobrar, com os critérios que você ajusta), com **Acrescentar a seleção** e com **Tirar da lista**. Escreva o nome do cliente e clique em **Gerar**. Saem dois arquivos: uma página HTML, que o cliente abre no navegador, marca e salva a resposta (ou imprime em PDF), e uma planilha Excel com a coluna Decisão. Para cada item, ele escolhe Apagar, Mover, Manter ou Conversar. Itens bloqueados pelas ações, como pastas do sistema, não entram. Se você já procurou duplicados, o **Sugerir** também traz as cópias repetidas, deixando a mais antiga.
 - **Ler resposta:** depois de varrer a pasta de novo, abra a planilha devolvida ou o arquivo salvo pela página. O MapDisk mostra o que o cliente decidiu e a situação de cada item. Item que mudou depois do relatório ou não existe mais fica de fora. Se a resposta veio por e-mail, use **Marcar pelos números** (por exemplo, `1, 3, 7-9`). Apagar e mover seguem a confirmação de sempre. Guarde a resposta com a ordem de serviço: ela é a autorização do cliente.
 
-Linha de comando (só lê, nunca apaga nem move). O alvo é um caminho completo:
+O botão **Exportar**, no cartão Pastas, grava a pasta das análises (a selecionada ou a raiz mostrada) em dois formatos:
+
+- **Relatório HTML:** um arquivo só, com o logo da MT, o resumo, o gráfico em blocos, as maiores pastas e arquivos, os tipos, os arquivos antigos, os perfis de usuário e, se você já procurou, os duplicados. Pasta sem leitura aparece como "sem acesso", nunca como zero. Para ter em PDF, use o "Imprimir" do navegador.
+- **Planilha CSV:** todas as pastas, para abrir no Excel.
+
+O botão **Opções**, ao lado de Sobre, guarda o que vale entre sessões, em `%LOCALAPPDATA%\MapDisk\opcoes.txt`:
+
+- **Menu do Explorer:** **Ligar** põe "Analisar com MapDisk" no botão direito das pastas, das unidades e do fundo de uma pasta, só para o seu usuário e sem administrador. Esse item abre o MapDisk já varrendo. No Windows 11, ele fica em "Mostrar mais opções". Se o `mapdisk.exe` mudar de lugar, as Opções avisam e **Ligar** aponta para o novo lugar. **Desligar** tira o item por completo.
+- **Análises:** quantos maiores arquivos mostrar e o tamanho mínimo dos duplicados.
+- **Relatório para o cliente:** os critérios do **Sugerir**. A janela do relatório também guarda os critérios usados.
+- **Últimos alvos:** **Esquecer** um alvo ou **Limpar a lista**.
+- **Registro de ações:** onde ele fica, com o botão para abrir.
+
+Linha de comando (só lê, nunca apaga nem move arquivo). O alvo é um caminho completo:
 
     mapdisk varrer C:
+    mapdisk varrer D:\ --relatorio d.html
     mapdisk varrer \\servidor\dados --csv dados.csv --top 30
+    mapdisk --integrar
+    mapdisk --remover-integracao
+
+`--relatorio` grava o relatório HTML, com `--top` itens em cada lista (padrão: 10). `--integrar` e `--remover-integracao` ligam e desligam o item do menu do Explorer.
 
 No Prompt de Comando, use `start /wait mapdisk varrer C:` para o prompt esperar o fim. No PowerShell, termine a linha com `| Out-Host`.
 
@@ -67,4 +87,4 @@ No Prompt de Comando, use `start /wait mapdisk varrer C:` para o prompt esperar
 | 5 | Ações seguras: Lixeira, mover, exclusão onde não há Lixeira, proteção, registro de ações, "Nesta sessão" | `acoes` | Plano em [#9](https://github.com/manfredjr/mapdisk/pull/9), código em [#10](https://github.com/manfredjr/mapdisk/pull/10) | Concluída em 30/09/2026 |
 | 6 | Relatório para o cliente avaliar: página, planilha e leitura da resposta | `relatorio-cliente` | Spec em [#11](https://github.com/manfredjr/mapdisk/pull/11), plano em [#12](https://github.com/manfredjr/mapdisk/pull/12), código em [#13](https://github.com/manfredjr/mapdisk/pull/13) | Concluída em 30/09/2026 |
 | 7 | Duplicados: busca em três etapas, aba no painel e cópias no relatório para o cliente | `duplicados` | Plano em [#14](https://github.com/manfredjr/mapdisk/pull/14), código em [#15](https://github.com/manfredjr/mapdisk/pull/15) | Concluída em 01/10/2026 |
-| 8 | Relatório do técnico em HTML com o gráfico, exportar pela janela, linha de comando completa, item "Analisar com MapDisk" no Explorer, tela de Opções e página do programa | `relatorio-e-integracao` | Plano em [#16](https://github.com/manfredjr/mapdisk/pull/16) | Plano em revisão |
+| 8 | Relatório do técnico em HTML com o gráfico, exportar pela janela, linha de comando completa, item "Analisar com MapDisk" no Explorer, tela de Opções e página do programa | `relatorio-e-integracao` | Plano em [#16](https://github.com/manfredjr/mapdisk/pull/16), código em [#17](https://github.com/manfredjr/mapdisk/pull/17) | Concluída em 01/10/2026 |

docs/legal/verificacao-distribuicao-e-lgpd-2026-09-28.md

@@ -110,12 +110,12 @@ Os textos seguem o modelo do parecer do MapNet, adaptados ao risco do MapDisk. P
 
 ## 6. Requisitos para implementação
 
-- [ ] Textos "Uso autorizado" e "Licença e garantias" na página e no README, perto do download (fatia 7).
+- [x] Textos "Uso autorizado" e "Licença e garantias" na página e no README, perto do download (fatia 8, com o ajuste da seção 11).
 - [x] Confirmação de cada ação com a lista, o total e o destino, e o aviso de risco da seção 5 (fatia 5).
 - [x] Exclusão em rede com a palavra EXCLUIR digitada e o aviso de que não há Lixeira (fatia 5). Vale também para unidade removível e mapeada, com o texto da seção 9.
 - [x] Registro de ações só com data e hora, usuário do Windows, ação, origem, destino, tamanho e resultado. Sem conteúdo de arquivo (fatia 5).
-- [x] Opções mostra onde fica o registro e abre a pasta dele (fatia 5). Por enquanto, pelo botão "Registro de ações" no cartão das pastas; vai para a tela de Opções na fatia 7.
-- [ ] Nada sai da máquina: nenhum envio de rede no programa, conferido por teste (todas as fatias).
+- [x] Opções mostra onde fica o registro e abre a pasta dele (fatia 5, e na tela de Opções desde a fatia 8).
+- [x] Nada sai da máquina: nenhum envio de rede no programa, conferido pelo teste `SemRedeTestes` (fatia 8).
 - [ ] Fora do programa, no atendimento da MT: autorização do cliente para as exclusões registrada na ordem de serviço, com cópia do `acoes.log` anexada. Fica em `docs/superpowers/pendencias.md` como decisão de processo do Manfred.
 
 ## 7. Pendências de validação
@@ -162,3 +162,52 @@ Autorização, na página e na planilha:
 
 **RECOMENDAÇÃO de processo, fora do programa.** O relatório tem nomes de pastas e de arquivos do cliente. No atendimento, enviar só ao contato do cliente que pediu o serviço e guardar a resposta junto da ordem de serviço. Não há pendência de validação.
 
+
+## 11. Página do programa (acréscimo de 01/10/2026)
+
+**Contexto.** A fatia 8 cria a página `public/index.html`, para `mapdisk.manfred.com.br`, com o download, a lista do que o programa faz, os textos "Uso autorizado" e "Licença e garantias" da seção 5 e uma nota de privacidade. A página fica num serviço de hospedagem, atrás do Cloudflare. A publicação é um passo separado, com autorização do Manfred.
+
+**Premissas.** Valem as da seção 3. Vale também a premissa de que a distribuição gratuita pode ser relação de consumo, adotada por cautela. Na página, a MT é quem decide sobre os registros de acesso que a hospedagem e o Cloudflare guardam, como o endereço IP. Nessa condição, ela é controladora desses dados, que são dados pessoais (LGPD, art. 5º, I e VI, verificados na seção 3).
+
+**FATO LEGAL.** CDC, art. 30, verificado no Planalto em 01/10/2026 (`https://www.planalto.gov.br/ccivil_03/leis/l8078compilado.htm`):
+
+> "Toda informação ou publicidade, suficientemente precisa, veiculada por qualquer forma ou meio de comunicação com relação a produtos e serviços oferecidos ou apresentados, obriga o fornecedor que a fizer veicular ou dela se utilizar e integra o contrato que vier a ser celebrado."
+
+**Incidência:** a página apresenta o programa ao público, perto do download, e cada frase precisa sobre o que ele faz passa a valer como oferta. O art. 37, § 1º, verificado na mesma fonte e na mesma data, diz que "É enganosa qualquer modalidade de informação ou comunicação de caráter publicitário, inteira ou parcialmente falsa, ou, por qualquer outro modo, mesmo por omissão, capaz de induzir em erro o consumidor [...]".
+
+**FATO LEGAL.** LGPD, art. 6º, VI, na biblioteca local (`fontes-md/leis/03-lgpd-lei-13709-2018-compilado.md`), em dia no relatório de 23/09/2026: "transparência: garantia, aos titulares, de informações claras, precisas e facilmente acessíveis sobre a realização do tratamento e os respectivos agentes de tratamento [...]".
+
+**INTERPRETAÇÃO, ponto 1: "Uso autorizado".** O texto aprovado fala de exclusão definitiva só em pastas de rede. Desde a seção 9, a exclusão definitiva vale também em unidade removível e em unidade mapeada. Uma página que cita só a rede omite um caso de risco, e o art. 37, § 1º, alcança a omissão capaz de induzir em erro. O texto passa a citar as duas situações, com a mesma frase da seção 9 ("o MapDisk não usa a Lixeira").
+
+**INTERPRETAÇÃO, ponto 2: frases sobre segurança.** As frases sobre segurança e funcionamento vinculam a MT (art. 30). Por isso, cada uma tem que corresponder ao que o programa faz e ao que os testes conferem:
+
+| Frase | Situação |
+|---|---|
+| "Feito para não dar susto" | Promessa vaga de resultado. Sai. O título passa a ser "Segurança" |
+| "O programa não envia nenhuma informação pela internet" | Já aprovada na seção 5. Fica. A seção 6 pedia um teste que confira isso. A fatia 8 cria esse teste |
+| "Pasta do sistema e raiz de unidade ficam bloqueadas" | Fica, com o alcance exato: bloqueadas para apagar e mover |
+| "Nunca como zero" | Fica: regra 3 do produto, conferida por teste |
+| Requisitos (Windows 10 e 11, Windows Server 2016 ou mais novo, 64 bits) | Fica. A página só vai ao ar depois do teste de lançamento do Manfred, que inclui um Windows Server |
+
+**INTERPRETAÇÃO, ponto 3: privacidade da página.** "Não usa cookies" seria uma afirmação absoluta sobre um serviço de terceiros que a MT não controla por completo: o Cloudflare pode gravar cookie técnico de segurança. O texto passa a dizer o que a página não tem e o que a hospedagem registra, para atender o art. 6º, VI, sem prometer o que depende de terceiros.
+
+**INTERPRETAÇÃO, ponto 4: GitHub.** O nome do GitHub aparece só para indicar onde está o download e o código, sem o logotipo e sem sugerir parceria. Não precisa de aviso de marca. A marca TreeSize não aparece, e um teste confere isso (seção 4.7).
+
+**RECOMENDAÇÃO aplicada.** Textos finais da página:
+
+> Segurança. O programa não envia nenhuma informação pela internet. Abre como usuário comum e só pede administrador pelo botão "Varrer como administrador". Não instala nada: roda de um pendrive ou de uma pasta de rede. Antes de apagar ou mover, mostra a lista, o total e o destino, e espera a sua confirmação. Cada ação fica registrada num arquivo do computador. As pastas do sistema do Windows e a raiz das unidades ficam bloqueadas para apagar e mover. Pasta que não pôde ser lida aparece como "sem acesso", nunca como zero.
+
+> Uso autorizado. O MapDisk - MT mostra o espaço ocupado em discos e pastas e permite enviar arquivos para a Lixeira, movê-los ou excluí-los definitivamente. Use o programa só em computadores e pastas que você tem autorização para administrar. Antes de apagar ou mover, confira a lista de itens e o destino. Em pastas de rede e em unidades removíveis ou mapeadas, o MapDisk não usa a Lixeira: a exclusão não pode ser desfeita pelo programa e os itens só voltam por uma cópia de segurança. O programa não envia nenhuma informação para fora do computador.
+
+> Licença e garantias. Texto da seção 5, sem mudança.
+
+> Privacidade. O programa não coleta nem envia dados. Esta página não tem formulário, propaganda nem ferramenta de estatística. A hospedagem e o Cloudflare, que entrega a página, registram dados técnicos de acesso, como o endereço IP, e podem gravar um cookie técnico de segurança.
+
+**Requisitos para implementação.**
+
+- [ ] Página com os quatro textos acima, "Uso autorizado" e "Licença e garantias" perto do botão de download (fatia 8).
+- [ ] README com o novo "Uso autorizado" e com "Licença e garantias" perto do download (fatia 8). Fecha o primeiro item da seção 6.
+- [ ] Teste que confere que o programa não usa classe de rede (fatia 8). Fecha o item "Nada sai da máquina" da seção 6.
+- [ ] Página publicada só depois do teste de lançamento, que inclui um Windows Server.
+
+Não há pendência de validação.