# Guia Prático de Preparação Doméstica — Brasil

## 🛡️ Sentinel Status
- **Status:** 🟡 Beta (pronto para publicar)
- **Tier:** B pela régua de `labs/solicitacao-de-novos-projetos.md` (cumpre R1–R8 e diferenciais; vira **S** quando o subdomínio responder 200 HTTPS no VPS).
- **Stack:** HTML5, CSS3 (Vanilla), Vanilla JS (ES6+), PWA Service Worker (Offline-First), localStorage, Web Print API

---

Aplicação web progressiva (PWA) de utilidade pública e segurança familiar baseada no guia de **Araguaci Carlos de Andrade** (*Nov 3, 2026*). Desenvolvida para orientar famílias brasileiras a reduzir vulnerabilidades e mitigar dificuldades decorrentes de desastres climáticos (temporais severos, enchentes, deslizamentos, ondas de calor) e interrupções prolongadas de infraestrutura (água encanada, energia elétrica, internet, transporte e pagamentos).

## 🌟 Funcionalidades & Módulos

1. **Calculadora Interativa de Autonomia Hídrica & Alimentar (Ferramenta de Decisão)**:
   - Dimensionamento com base na regra de ouro: **2L/dia por pessoa só para beber** e **4L/dia para beber, cozinhar e higiene básica** (+ 1L/pet/dia).
   - Controles dinâmicos para quantidade de adultos, crianças, animais de estimação e período pretendido (3 dias de evacuação, 7 dias de crise, 15 dias ou 30 dias de isolamento no lar).
   - Conversão instantânea em galões de 20L, garrafas de 5L e dosagem de hipoclorito de sódio 2,5% necessária (gotas e ml).
   - Exportação da lista calculada diretamente para a área de transferência / WhatsApp.
2. **Mochila para 3 Dias (72 Horas / Bug-Out Bag)**:
   - Checklists operacionais divididos por filtros de categoria: Água, Comida sem preparo, Saúde & Primeiros Socorros, Documentos & Dinheiro em espécie, Luz & Rádio, Roupa & Abrigo, Higiene, Ferramentas e Necessidades Específicas (crianças, idosos/PCD e animais).
   - Growth Tracker com percentual de prontidão e persistência automática em `localStorage`.
3. **Reserva Doméstica para 30 Dias (Permanecer no Lar / Shelter-in-Place)**:
   - Estoque planejado segundo o princípio **PEPS ("Primeiro que Entra, Primeiro que Sai")**.
   - Setores cobertos: Água & baldes para descarga, grãos e proteínas não perecíveis, cozinha sem eletricidade (fogareiro a gás/botijão reserva), farmácia de 30 dias (com plano térmico para insulina), energia (lanternas/pilhas/power banks e alerta de monóxido em geradores), banheiro seco de emergência e segurança patrimonial.
4. **Plano Familiar de Emergência & Cartão Imprimível**:
   - Formulário interativo para definir pontos de encontro (local e fora do bairro), contato de outra cidade e distribuição de tarefas familiares.
   - Pré-visualização ao vivo do **Cartão de Emergência Familiar** com formatação de impressão rápida (`Ctrl+P`) otimizada para caber no bolso ou carteira.
5. **Protocolo Imediato: "Quando um Alerta Chegar"**:
   - Linha de ação sequencial em 6 etapas para quando a Defesa Civil emitir aviso severo de tempestade, vendaval ou inundação.
6. **Guia de Potabilização de Água em Crises**:
   - Dosagem exata de hipoclorito de sódio 2,5% (2 gotas/litro + 30 min de espera) e fervura (1 minuto contínuo).
   - Alerta sanitário vital sobre os riscos de contaminação por água de enchente (leptospirose e compostos tóxicos).
7. **Central Telefônica & Alerta SMS 40199 da Defesa Civil**:
   - Botões de discagem rápida com um toque: 199 (Defesa Civil), 193 (Bombeiros), 192 (SAMU) e 190 (Polícia).
   - Atalho de envio de SMS gratuito com o CEP para o canal nacional `40199`.
8. **PWA First & Offline Completo**:
   - 100% utilizável sem internet através de Service Worker (`sw.js`, cache `guiadomestico-v1`).
   - Monitor de status de rede (`ONLINE` / `OFFLINE`).
   - Banner de instalação A2HS para fixar na tela inicial do smartphone.
   - Alternância de temas *Vigília* (Dark) e *Dia* (Light).

## 📏 Avaliação pela Régua (`labs/solicitacao-de-novos-projetos.md`)

| # | Requisito | Situação | Evidência no Projeto |
| :---: | :--- | :---: | :--- |
| R1 | Tese clara na primeira tela | ✅ | Título, subtítulo, botões de ação imediata e aviso preventivo visíveis acima da dobra |
| R2 | 5+ módulos distintos | ✅ | 8 módulos: Calculadora, Mochila 72h, Reserva 30d, Plano Familiar, Protocolo de Alerta, Potabilização, Central Telefônica e Manutenção |
| R3 | Fontes citadas | ✅ | Guia técnico de Araguaci Carlos de Andrade (Nov 2026), normas da Defesa Civil Nacional e Ministério da Saúde |
| R4 | Evidência classificada | ✅ | Selos `[Defesa Civil]`, `[Norma Sanitária]`, `[Regra PEPS]` e alertas destacados |
| R5 | Identidade visual própria | ✅ | Tema tático brasileiro (ardósia, laranja alerta e ciano água), ícone de mochila/escudo em SVG, hero cinemático |
| R6 | Mobile sem quebra (390px) | ✅ | Layout flexível e adaptativo, sliders e steppers touch-friendly, sem rolagem horizontal |
| R7 | Zero erro de JS | ✅ | Vanilla JS puro, encapsulado em IIFE, validado com Node.js |
| R8 | Estado salvo | ✅ | Tema, cálculos, itens checados da mochila/reserva e dados do plano familiar persistidos no `localStorage` |
| R9 | No ar (200 + HTTPS) | ⏳ | Subdomínio `guiadomestico.artesdosul.com` a apontar no VPS |
| R10 | Integrado ao ecossistema | ⏳ | Aguardando autorização do usuário para post showcase, home card e catálogo |

**Diferenciais entregues:**
- 💧 **Ferramenta de decisão:** Calculadora dinâmica de consumo d'água familiar e conversão em galões e dosagem de cloro.
- 🖨️ **Utilitário prático:** Cartão Familiar de Emergência com formatação de impressão em 1 página.
- 📋 **Compartilhamento rápido:** Exportação formatada para WhatsApp e discagem rápida direta.

## 📁 Estrutura de Arquivos

```
labs/guiadomestico/
├── index.html         # SPA Masterpiece completa (HTML5 + CSS3 + JS inline, sem build)
├── manifest.json      # Manifesto PWA (standalone, pt-BR, tema tático laranja)
├── sw.js              # Service Worker (Cache offline guiadomestico-v1)
├── icon-192.svg       # Ícone vetorial do Escudo/Mochila de Emergência (192x192)
├── icon-512.svg       # Ícone vetorial do Escudo/Mochila de Emergência (512x512)
├── hero.jpg           # Imagem Hero cinemática gerada com IA
├── hero.webp          # Capa otimizada em WebP
├── og-image.webp      # Capa social Open Graph (1200x675)
├── CNAME              # guiadomestico.artesdosul.com
├── MANUAL.md          # Conteúdo original integral preservado
└── README.md          # Documentação técnica e Sentinel Status
```

## 🚀 Publicação & Acesso

- **Produção:** https://guiadomestico.artesdosul.com/ (subdomínio a configurar no VPS)
- **Desenvolvido por:** [Artes do Sul](https://artesdosul.com/)