O Meu Moriá é um sistema projetado para atender às necessidades do Clube de Desbravadores – Moriá, com foco no gerenciamento de membros, organização de eventos e controle financeiro. Este README apresenta uma visão geral do sistema, seus objetivos, funcionalidades e organização do repositório.
O sistema foi desenvolvido para:
- Gerenciar Membros: Facilitar o cadastro, edição e visualização de membros, incluindo desbravadores, voluntários e responsáveis.
- Controlar o Fluxo Financeiro: Automatizar o controle de mensalidades e gerenciar recursos financeiros alocados para eventos.
- Organizar Eventos: Proporcionar ferramentas para criação, divulgação, inscrição e monitoramento de participações em eventos.
O Moria Desbravadores centraliza e automatiza os processos administrativos do Clube de Desbravadores, promovendo eficiência, segurança e acessibilidade. O escopo do sistema é definido pelos seguintes aspectos:
-
Gestão de Membros:
- Cadastro de membros, incluindo informações pessoais, categorias (desbravadores, voluntários, responsáveis) e status.
- Controle de permissões e autenticação para garantir acesso seguro às informações.
- Histórico detalhado de participação e atividades dos membros.
-
Organização de Eventos:
- Criação e gerenciamento de eventos públicos e privados.
- Definição de público-alvo para eventos, como categorias específicas de membros.
- Controle de inscrições e geração de relatórios de participação.
- Avaliação pós-evento para coleta de feedback e melhorias futuras.
-
Controle Financeiro:
- Registro de pagamentos de mensalidades e gestão de recursos financeiros alocados para eventos.
- Emissão de relatórios financeiros para acompanhamento detalhado das receitas e despesas.
- Monitoramento de orçamentos para diferentes atividades e eventos do clube.
-
Interface e Acessibilidade:
- Design intuitivo e responsivo para garantir uma experiência amigável em dispositivos diversos.
- Implementação de padrões de acessibilidade para atender a usuários com diferentes necessidades.
-
Segurança e Privacidade:
- Proteção dos dados dos usuários através de autenticação robusta e criptografia.
- Controle de acesso baseado em funções, garantindo que cada usuário veja apenas as informações relevantes para seu perfil.
Ao alinhar as funcionalidades às necessidades reais do Clube de Desbravadores – Moriá, o sistema busca otimizar o tempo dos gestores, engajar membros e promover uma administração eficiente e transparente.
Links para os principais tópicos explicativos:
docs/: Contém documentação geral sobre o sistema e seus fluxos, incluindo Requisitos, Arquitetura, Diagramas, Fluxograma de Processos, Protótipos de Interface e Plano de Testes.front-end/: Implementação do cliente.server/: Backend com endpoints e lógica de negócios.
- Cadastro, edição e visualização detalhada.
- Controle de permissões e autenticação de usuários.
- Monitoramento de status e histórico.
- Registro de mensalidades e recursos de eventos.
- Geração de relatórios financeiros detalhados.
- Configuração e monitoramento de orçamentos.
- Criação e definição de público-alvo.
- Registro e controle de participações.
- Histórico de eventos e avaliações.
- Java 17 - Linguagem principal da aplicação backend.
- Spring Boot 3.3.4 - Framework para construção de aplicações web e microsserviços.
- Spring Web - Para construção de APIs REST.
- Spring Security - Gerenciamento de autenticação e autorização.
- Spring Data JPA - Abstração para persistência de dados com o banco relacional.
- Spring Validation - Validação de dados de entrada.
- JWT (JSON Web Token) - Autenticação baseada em token.
- MapStruct - Framework para mapeamento de objetos DTO.
- Lombok - Redução de boilerplate no código.
- Maven - Gerenciamento de dependências e build da aplicação.
- MySQL Connector - Conector para o banco de dados MySQL.
- React 18 - Biblioteca para construção de interfaces de usuário reativas.
- React Router DOM - Gerenciamento de rotas no frontend.
- Axios - Cliente HTTP para comunicação com a API.
- Vite - Ferramenta para build e desenvolvimento rápido.
- ESLint - Linter para manter qualidade do código.
- JWT-Decode - Decodificação de tokens JWT no cliente.
- SCSS (Sass) - Pré-processador CSS para melhor organização de estilos.
- MySQL - Banco de dados relacional utilizado para armazenamento persistente de dados.
- Docker - Para containerização da aplicação.
- Postman - Testes manuais da API REST.
- Swagger/OpenAPI - Documentação automatizada da API.
- JUnit - Framework de testes unitários.
- Mockito - Mocking de dependências em testes.
Contribuições são bem-vindas!
Sinta-se à vontade para abrir issues e enviar pull requests com melhorias, correções de bugs ou novas funcionalidades.
Certifique-se de seguir as boas práticas de desenvolvimento e as diretrizes do projeto.
Agradecemos a todas as pessoas que contribuíram para este projeto, seja com código, sugestões, testes ou feedback.
Gostaríamos de reconhecer o esforço das seguintes pessoas que ajudaram no desenvolvimento do projeto:
- Luiz Henrique de Santana - Desenvolvedor Fullstack
- Gabriel Cruz - Desenvolvedor Fullstack
- Daniel Leite Pereira - Desenvolvedor Frontend
- Wesley Paulow - Desenvolvedor Backend
- Diego de Paula - Desenvolvedor Frontend
- Nicole Carvalho Fukushima - UX/UI Designer
Se você deseja ser reconhecido como colaborador, sinta-se à vontade para adicionar seu nome nesta lista.
Este projeto está licenciado sob a Creative Commons Attribution-NonCommercial 4.0 International.
Isso significa que você pode usar, compartilhar e modificar o projeto, desde que não seja para fins comerciais.
Confira os detalhes completos da licença aqui.