🌉 Amparo Digital

💛 Uma ponte entre a generosidade de quem quer ajudar e o esforço de quem transforma vidas.

💡 Sobre o Projeto

O Amparo Digital é um catálogo de ONGs reais, com validação manual feita pela nossa equipe, garantindo que cada instituição seja legítima.
A proposta é simples: quem quer doar encontra uma ONG verificada, lê sua história e faz a doação diretamente via Pix — sem taxas e sem intermediários.

🎯 Nossa Missão

💛 Programar também é um ato de empatia.
Acreditamos que a tecnologia pode ser uma ferramenta poderosa de solidariedade, conectando quem quer ajudar com quem transforma vidas.

⚙️ Como Funciona

• ✅ ONGs verificadas: cada ONG é checada manualmente
• 💸 Doação direta: via Pix, sem taxas ou intermediários
• 🔍 Transparência total: todas as informações são públicas e verificadas
• 💚 Gratuito: 100% sem fins lucrativos

🧩 Funcionalidades

👥 Para Doadores

• Catálogo completo de ONGs verificadas
• Busca por nome ou categoria
• Detalhes e histórias de cada ONG
• Doação direta via Pix
• Interface leve, responsiva e intuitiva

🏢 Para ONGs

• Cadastro gratuito e seguro
• Página personalizada com informações
• Chave Pix para doações diretas
• Validação manual da equipe
• Selo de ONG Parceira

🛠️ Para Administradores

• Painel administrativo completo
• Gerenciamento de ONGs
• Sistema de validação
• Relatórios e estatísticas
• Interface CLI para operações avançadas

🧱 Tecnologias Utilizadas

🖥️ Backend

• 🟨 Node.js – Runtime principal
• ⚡ Express – Framework web
• 🗄️ PostgreSQL – Banco de dados relacional
• 🔐 JWT – Autenticação segura
• 🔒 bcrypt – Hash de senhas
• ✅ Zod – Validação de dados

🎨 Frontend

• 🧩 HTML5 – Estrutura semântica
• 🎨 CSS3 – Estilos modernos
• ✨ JavaScript (ES6+) – Interatividade
• 🖼️ Bootstrap – Ícones e cards do sistema

🧰 Ferramentas

• 🌿 Git – Controle de versão
• 📦 NPM – Gerenciamento de dependências

🚀 Instalação

📋 Pré-requisitos

• Node.js v16+
• PostgreSQL v12+
• Git

🧭 Passo a Passo

1. Clone o repositório

   git clone https://github.com/maxineathos/amparo-digital.git
   cd amparo-digital

2. Instale as dependências

   npm install

3. Configure o banco de dados

   • Crie um banco no PostgreSQL
   • Configure as tabelas necessárias
   • Para acesso, entre em contato:
     📧 maxineathos03@gmail.com

4. Crie o arquivo .env

   DATABASE_URL=sua_chave_aqui
   JWT_SECRET=amparo_digital_secret_key
   NODE_ENV=development
   PORT=3000

5. Execute o projeto

   # Front-end web
   npm start
   
   # CLI
   node cli/index.js

🌐 Como Usar

💛 Interface Web

1. Acesse http://localhost:3000
2. Explore o catálogo de ONGs
3. Clique em “Ver mais” para detalhes e doação via Pix
4. Para o painel administrativo:
   • Usuário: admin
   • Senha: 12345

💻 CLI (Interface de Linha de Comando)

node cli/index.js

Navegue pelo menu, escolha uma opção e siga as instruções!

Dica: digite "cancelar" a qualquer momento para sair de uma operação.

📚 Documentação

• 🧠 CLI - Documentação Técnica
• 🌐 Web - Documentação Técnica
• 🔌 API - Documentação Técnica
• 📖 Manuais do Usuário
• 🧾 Endpoints da API

🏗️ Arquitetura do Projeto

amparo-digital/
├── cli/                      # Interface de linha de comando
│   ├── controllers/
│   ├── core/
│   └── index.js
├── js/                       # Backend
│   ├── config/
│   ├── managers/
│   ├── models/
│   ├── utils/
│   └── reports/
├── web/                      # Frontend
│   ├── pages/
│   └── assets/
├── docs/                     # Documentação
└── server.js                 # Servidor principal

🤝 Como Contribuir

1. Faça um fork do projeto
2. Crie uma branch:

   git checkout -b feature/nova-feature

3. Commit suas alterações:

   git commit -m "Adiciona nova feature"

4. Envie a branch:

   git push origin feature/nova-feature

5. Abra um Pull Request 💛

🧩 Boas Práticas

• Siga os padrões de nomenclatura
• Escreva comentários em português
• Mantenha a documentação atualizada

📜 Licença

Este projeto está licenciado sob a Licença ISC.
Consulte o arquivo LICENSE para mais informações.

👩‍💻 Equipe Amparo Digital

💛 Desenvolvido com empatia, propósito e colaboração.

💛 Agradecimentos

Agradecemos a todos que acreditam que programar é um ato de empatia.
Cada linha de código escrita com amor transforma vidas — e constrói pontes. 🌉

🕊️ “A Amparo Digital não nasceu como um negócio — nasceu como uma ponte.”
Uma ponte entre a generosidade de quem quer ajudar e o esforço de quem transforma vidas.

💛 Feito com amor pela equipe Amparo Digital.