Home - prfs91/VolunteerCodeCarajas GitHub Wiki

🏡 Home | Wiki do Projeto VolunteerCodeCarajas

👋 Bem-vindo(a) ao Wiki do VolunteerCodeCarajas!

Este é o espaço oficial de documentação do sistema VolunteerCodeCarajas — um projeto que une tecnologia, propósito social e aprendizado contínuo. Aqui você encontrará orientações técnicas, fluxos de uso, aprendizados, instruções de instalação, contribuição e muito mais.

💡 “A tecnologia não tem fronteiras, assim como a inclusão e o conhecimento. Juntos, podemos construir um mundo sem barreiras.” 🌍

📌 Introdução

🔍 O que é o projeto?

O VolunteerCodeCarajas é um sistema web de apoio à gestão da Associação Carajás de Pessoas com Deficiência, localizado em Tucuruí - PA. Ele nasceu com o propósito de transformar realidades sociais por meio da tecnologia e da inclusão digital.

Este sistema está sendo desenvolvido de forma voluntária e colaborativa, com foco em aprendizado prático, acessibilidade e impacto real.

💡 Ideias iniciais e motivação

A motivação surgiu da vivência direta da idealizadora como voluntária da associação, percebendo a necessidade de melhor organização de dados e processos. A missão é clara: usar a tecnologia para empoderar pessoas e organizações sociais.

🛣️ Evolução e roadmap

Veja os planos futuros e funcionalidades a serem implementadas:

  • Cadastro de associados ✅
  • Controle de mensalidades
  • Gestão financeira
  • Gestão de projetos
  • Acessibilidade e usabilidade
  • Integrações futuras

🔗 Veja mais em: Roadmap

🧰 Tecnologias Utilizadas

Este projeto foi desenvolvido com foco em ferramentas modernas, acessíveis e que promovem boas práticas em engenharia de dados e desenvolvimento web.

💻 Linguagens de Programação

📚 Bibliotecas e Frameworks

  • Django
  • Pandas

🧱 Ferramentas

  • Git
  • Docker

☁️ Plataformas

  • GitHub
  • Neon (PostgreSQL as a service)

🗄️ Banco de Dados

  • PostgreSQL

⚙️ Ambiente de Desenvolvimento

  • Visual Studio Code (VS Code)
  • .env e arquivos de segredo (secret management)

Cada tecnologia tem sua própria página com explicações sobre:

  • O que é
  • Para que serve
  • Como instalar
  • Como é usada no projeto

🔗 Explore em: Tecnologias Utilizadas

📖 Diário de Bordo

A jornada de desenvolvimento do projeto, aprendizados, dificuldades e decisões estão sendo registradas aqui com carinho.

  • 🧗 Desafios enfrentados
  • 🧠 Aprendizados contínuos
  • 🔧 Soluções encontradas
  • 📝 Registros por fases ou datas

🔗 Leia em: Diário de Bordo

🔄 Fluxos Importantes

Guia prático para desenvolvedores e colaboradores.

  • 🧬 Como clonar o projeto
  • ⚙️ Como configurar o .env local
  • 🐳 Implantação com Docker
  • 🔁 Manutenção e atualizações locais
  • 🖥️ Ambiente recomendado (VS Code + extensões)
  • ✅ Checklist de primeiros passos

🔗 Acesse: Fluxo de Instalação e Uso

🤝 Como Colaborar

Este projeto é colaborativo! Sua ajuda é muito bem-vinda 💙

Dicas para contribuir:

  • 📥 Abrir issues e dar feedback
  • 🌱 Sugerir melhorias e ideias
  • 🧪 Criar branches e Pull Requests
  • ✍️ Ajudar na documentação e no Wiki
  • 📑 Seguir boas práticas e padrões do projeto

🔗 Veja como: Guia de Contribuição

👤 Colaboradores

🧠 Criadora e Idealizadora

Pamella Roberta Ferreira da Silva (@prfs91)
Acadêmica de Engenharia da Computação (UFPA) | Engenheira de Dados em formação
Voluntária na Associação Carajás | Autista, TDAH e entusiasta da inclusão 🌈

👥 Contribuidores

Em breve, aqui estarão os nomes das pessoas que contribuírem com ideias, códigos ou melhorias.

🔗 Veja a seção: Colaboradores

📬 Entre em Contato

Se você tem sugestões, deseja colaborar ou quer conversar sobre o projeto:

🌟 Seções Extras (Em Desenvolvimento)

  • 🧭 Visão Técnica do Sistema
    Diagrama de arquitetura e fluxo de dados

  • 🧪 Testes
    Estratégias de testes manuais e automatizados

  • 🌍 Versão em Inglês
    Em breve, links para a versão traduzida de cada página do Wiki

  • 📦 Histórico de Versões
    Release notes e milestones principais do projeto

⚠️ Este Wiki está em construção.
Ainda estou estruturando os conteúdos e links. Algumas páginas podem estar vazias ou indisponíveis.
Esta é uma versão inicial da estrutura e pode ser atualizada conforme o projeto evolui.

Última modificação em: 2025/04/21