Skip to content

Latest commit

 

History

History
68 lines (40 loc) · 2.55 KB

README.md

File metadata and controls

68 lines (40 loc) · 2.55 KB

API de Sistema de Sorteios para Igrejas

Este repositório contém uma API desenvolvida para criar e gerenciar sorteios específicos para igrejas. A API permite aos membros da comunidade participar de sorteios transparentes e visualizar os resultados de forma imparcial e eficiente. Abaixo estão as etapas para configurar e executar a API em seu ambiente local.

Instruções de Instalação:

  1. Clonar o Repositório:

    Clone este repositório em sua máquina local usando o comando:

    git clone https://github.com/seu-usuario/nome-do-repositorio.git
    
  2. Configuração do Banco de Dados:

    Configure as credenciais do banco de dados no arquivo .env. Certifique-se de que as configurações de DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME e DB_PASSWORD estejam corretas.

  3. Executar Migrações:

    Execute o seguinte comando para criar as tabelas no banco de dados:

    php artisan migrate
    
  4. Popular o Banco de Dados (Opcional):

    Se desejar, você pode popular o banco de dados com dados de exemplo usando o comando:

    php artisan db:seed
    

Como Usar a API:

A API oferece endpoints para gerenciar igrejas, grupos de sorteios, sorteios, prêmios, participantes e ganhadores. Você pode utilizar ferramentas como o Postman ou o Insomnia para testar os endpoints e interagir com a API.

Exemplos de Endpoints:

  • GET /api/churches: Retorna a lista de igrejas cadastradas.
  • POST /api/churches: Cria uma nova igreja.
  • GET /api/draw-groups: Retorna a lista de grupos de sorteios.
  • POST /api/draw-groups: Cria um novo grupo de sorteios.
  • GET /api/draws: Retorna a lista de sorteios.
  • POST /api/draws: Cria um novo sorteio.
  • GET /api/prizes: Retorna a lista de prêmios.
  • POST /api/prizes: Cria um novo prêmio.
  • GET /api/participants: Retorna a lista de participantes.
  • POST /api/participants: Cria um novo participante.
  • GET /api/winners: Retorna a lista de ganhadores.
  • POST /api/winners: Cria um novo ganhador.

Observações:

Certifique-se de ter o Composer e o PHP instalados em sua máquina antes de executar os comandos.

Esta API foi desenvolvida como parte de um projeto de demonstração e pode conter recursos limitados em relação a um sistema completo. Sinta-se à vontade para explorar, testar e modificar a API conforme suas necessidades.

Licença:

Este projeto é licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.