Formação · Células · Eventos · Escala · WhatsApp · Acessibilidade
- Sobre o projeto
- Funcionalidades
- Módulos do sistema
- Stack tecnológica
- Pré-requisitos
- Instalação
- Configuração
- Comandos úteis
- Estrutura do projeto
- Deploy
- Documentação
- Contato
Casa dos Discípulos é uma plataforma web moderna desenvolvida para centralizar a gestão, formação e engajamento de comunidades cristãs. O sistema resolve o desafio da dispersão de materiais, controles manuais e processos informais, oferecendo uma experiência estruturada e acessível tanto para administradores quanto para discípulos.
| Diferencial | Descrição |
|---|---|
| Tudo em um lugar | Cursos, lições, formulários, eventos e escala integrados em uma única plataforma |
| Formação gamificada | Escola de Discípulos com módulos progressivos, quizzes e ranking de pontuação |
| Secretaria digital | Formulários dinâmicos criados pelo admin, relatórios semanais por célula |
| Engajamento via WhatsApp | Notificações automáticas de escalação, lembretes de módulos pendentes |
| Acessibilidade WCAG 2.1 | Skip Link, alto contraste, ajuste de tamanho de texto, navegação por teclado |
| Segurança | JWT, bcrypt, Helmet, rate limiting, validação com Joi |
| Autenticação | Escola de Discípulos | Secretaria | Eventos | Escala | Extras |
|---|---|---|---|---|---|
| Login/Registro | Módulos + Quizzes | Lições + Formulários | Carrossel home | Calendário .ics | |
| JWT + bcrypt | Gamificação | Campos dinâmicos | CRUD | Notificações | Upload |
| Roles (admin/líder/membro) | Ranking | Relatórios por célula | Divulgação | Ministérios | A11y |
- Autenticação segura — JWT com refresh, bcrypt para senhas, registro público apenas para membros
- Escola de Discípulos — Módulos educacionais com ordem definida, quizzes opcionais, pontuação e ranking
- Secretaria das Células — Lições com textos, vídeos e PDFs; formulários com campos configuráveis (texto, textarea, número, data, link, upload)
- Eventos — Carrossel na home com próximos eventos e informações importantes
- Fala Aí, Discípulo — Devocional e palavra do dia
- Escala — Calendário de ministérios, escalação por área, exportação .ics, notificações WhatsApp
- Gestão completa — Usuários, células, níveis, ministérios; painel admin com visão de dashboards
- Acessibilidade — Skip Link, barra de ajustes (tamanho de texto, alto contraste), suporte a leitores de tela
| Módulo | Público | O que faz |
|---|---|---|
| Escola de Discípulos | Membros e líderes | Estudo de módulos, quizzes gamificados, ranking |
| Secretaria das Células | Líderes e admin | Lições para download, formulários e relatórios semanais |
| Eventos | Todos | Carrossel com próximos eventos e divulgação |
| Fala Aí, Discípulo | Todos | Devocional e palavra do dia |
| Escala | Líderes e admin | Calendário, escalas de ministérios, notificações |
| Gestão | Admin | CRUD de usuários, células, níveis, ministérios |
|
Frontend
|
Backend
|
| Ferramenta | Versão |
|---|---|
| Node.js | 18+ |
| npm | 9+ |
| MySQL | 8+ |
| Git | 2.x |
git clone https://github.com/SEU_ORG/CasaDosDiscipulos.git
cd CasaDosDiscipulosCREATE DATABASE CasaDosDiscipulos CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;cd Codigo/backend
npm install
cp .env.example .env
# Edite o .env (veja seção Configuração)
npm run migrate
npm run seed
npm run devAPI em: http://localhost:3001
cd Codigo/frontend
npm install
# Crie o .env com REACT_APP_API_URL (veja seção Configuração)
npm startAplicação em: http://localhost:3000
| Senha | Tipo | |
|---|---|---|
| admin@test.com | 123456 | administrador |
| lider@test.com | 123456 | lider |
| membro@test.com | 123456 | membro |
PORT=3001
DB_HOST=localhost
DB_PORT=3306
DB_USER=casadiscipulos
DB_PASSWORD=sua_senha_segura
DB_NAME=CasaDosDiscipulos
JWT_SECRET=minimo_32_caracteres_aleatorios_seguros
NODE_ENV=development
# Opcional: WhatsApp (Evolution API)
# EVOLUTION_API_URL=http://localhost:8080
# EVOLUTION_INSTANCE_NAME=casadosdiscipulos
# EVOLUTION_API_KEY=sua-chave
# Opcional: Rate limit (padrão 300 req/15min)
# RATE_LIMIT_MAX=300Gerar JWT_SECRET:
openssl rand -hex 32REACT_APP_API_URL=http://localhost:3001/api| Contexto | Comando | Descrição |
|---|---|---|
| Backend | npm run dev |
Desenvolvimento com hot reload |
| Backend | npm run migrate |
Executar migrations |
| Backend | npm run migrate:rollback |
Reverter última migration |
| Backend | npm run seed |
Popular banco com dados de teste |
| Frontend | npm start |
Desenvolvimento |
| Frontend | npm run build |
Build para produção |
CasaDosDiscipulos/
├── Codigo/
│ ├── backend/ # API Node.js
│ │ ├── src/
│ │ │ ├── controllers/
│ │ │ ├── models/
│ │ │ ├── services/
│ │ │ ├── routes/
│ │ │ ├── middlewares/
│ │ │ ├── validations/
│ │ │ └── migrations/
│ │ └── seeds/
│ └── frontend/ # React SPA
│ ├── src/
│ │ ├── components/
│ │ ├── pages/
│ │ ├── services/
│ │ ├── hooks/
│ │ ├── contexts/
│ │ └── style/
│ └── public/
├── Documentacao/ # Documentação completa
├── Artefatos/ # Wireframes, diagramas
├── evolution-whatsapp/ # Docker Evolution API (opcional)
└── deploy/ # Docker para produção
A aplicação pode ser hospedada em VPS com Docker. Requisitos:
- Docker e Docker Compose
- Nginx (proxy reverso)
- MySQL 8
- HTTPS (Let's Encrypt recomendado)
Guia completo: Documentacao/HOSPEDAGEM.md
| Documento | Conteúdo |
|---|---|
| Começando | Instalação passo a passo, troubleshooting |
| Arquitetura | Stack, estrutura, fluxos de dados |
| Hospedagem | Deploy em VPS com Docker |
| Segurança | JWT, CORS, rate limit, checklist |
| Acessibilidade | WCAG 2.1, recursos inclusivos |
| Evolution API, notificações | |
| Índice completo | Todos os documentos |
O projeto nasceu da necessidade da Casa dos Discípulos de centralizar materiais de formação (cursos, módulos, lições, quizzes) e acompanhamento de células que estavam dispersos entre arquivos, mensagens e controles manuais. A plataforma oferece organização, autonomia e uma experiência estruturada para toda a comunidade.
Júlia Rocha Fiorini
| 📧 | juliarochafiorini@gmail.com |
| 💻 | GitHub @jrcfxx |
| 🔗 |
PUC Minas · ICEI · Engenharia de Software · 2025
Casa dos Discípulos — Plataforma de gestão e formação para igrejas