Raízes do Futuro — MVP
Protótipo digital do projeto Raízes do Futuro (Youth Challenge Blockchain — UNICEF Brasil).
Demonstra o ciclo completo: Coleta → Validação DeTrash → Relatório de Circularidade → Receita (turistas + empresas) → Cofre multisig 2-de-3 (Fundo Infância) → Conta Decaf da família → Pix, incluindo o onboarding gamificado das famílias — sem seed phrase, sem jargão.
Como rodar (VS Code)
Pré-requisito: Node.js 18+
npm install
npm run dev
Abra http://localhost:5173
Duas telas independentes:
As duas últimas são o módulo de Validação de Coleta, que transforma a etapa
de validação (hoje apoiada em confiança pessoal) em evidência verificável por
máquina: classificação do material no próprio aparelho, hash perceptual da foto,
árvore de Merkle diária e ancoragem. Documentação em
VALIDACAO.md; o pipeline do modelo em
modelo/README.md.
Arquitetura simulada
| Camada | Escolha | Por quê |
|---|
| Rede | Solana (devnet simulada) | taxa de fração de centavo e confirmação em segundos — viável para bônus de R$ 30 |
| Transações | signature base58 de 88 chars + slot incremental | mesmo formato do explorador da Solana; cada signature carrega a da anterior, formando a cadeia auditável |
| Endereços | pubkey base58 de 44 chars | idem |
| Cofre do Fundo Infância | multisig 2-de-3 (padrão Squads) | nenhuma organização move o dinheiro sozinha |
| Signatários | Instituto Vivá, DeTrash, Representante Comunitário | validação social, verificação ambiental e voz da comunidade |
| Stablecoin | BRZ/cRED (1 = R$ 1) | a família nunca vê o valor oscilar |
| Carteira da família | Decaf (provider: 'Decaf', rede: 'Solana') | custódia simplificada: celular + PIN de 4 números, sem seed phrase |
Fluxo de liberação do bônus
comprovação enviada pela família (foto, off-chain)
→ Instituto Vivá valida → tx VALIDAÇÃO
→ cofre cria uma proposta → tx PROPOSTA (status: aguardando)
→ signatário 1 assina → tx ASSINATURA (1/2)
→ signatário 2 assina → tx ASSINATURA (2/2) → limiar atingido
→ cofre executa automaticamente → tx LIBERAÇÃO (debita cofre, credita a conta Decaf)
Sem conta Decaf ou sem saldo livre no cofre, a proposta nasce reservada (tx RESERVA): o valor nunca é perdido e a proposta é reaberta sozinha quando a família cria a conta.
Tipos de transação no explorador: RECEITA, VALIDAÇÃO, PROPOSTA, ASSINATURA, LIBERAÇÃO, RESERVA, CARTEIRA, SAQUE, RENDA (renda incondicional da coleta), CONSENTIMENTO, CONTESTACAO e ANCORAGEM (registro real na devnet) — mais GÊNESE e CIRCULARIDADE.
O que cada aba demonstra
| Perfil | O que faz |
|---|
| 📊 Dashboard | Indicadores vs. metas do piloto, gráfico de kg por semana (barras) e receita por fonte (donut) — SVG puro. Botão ▶ Ver o ciclo completo |
| 🧹 Coletor | Registra ações de coleta (material, kg, local) |
| ✅ Instituto Vivá | Valida coletas (metodologia DeTrash), emite Relatórios de Circularidade e valida comprovações — que passam a criar propostas no cofre |
| 🛒 Mercado | Turista compra produto reciclado; empresa compra crédito/relatório ESG. Cada venda dispara a animação do split 60/25/15 com contadores animados |
| 🔗 Cofre Multisig | Saldo e endereço do cofre, painel de propostas com os 3 signatários e botão "Assinar como […]", animação de execução ao atingir 2/3, e explorador de transações (tipo, descrição, signature truncada, slot) com modal de detalhes |
| 📝 Cadastro | Inclui família no piloto (nome, crianças, código pseudônimo) com o consentimento no mesmo formulário, e abre os compromissos de cada mês em lote |
| 👨👩👧 Família (operação) | Visão do agente: conectar carteira Decaf, metadados (rede: Solana · provider: Decaf), extrato e saque Pix |
| 📱 App da Família | A tela do celular, dentro de uma moldura — igual à rota #/familia |
App da família (#/familia)
Mobile-first e com zero jargão cripto — nunca aparece "wallet", "token", "blockchain", "multisig" ou "hash". A linguagem é "conta da família", "dinheiro", "bônus" e "cofre digital".
This is the beginning of the README. Read the rest at the original. Read the full README ↗
