Participants-App | Gerenciamento de Inscrições

Esta aplicação foi desenvolvida para gerenciar inscrições em eventos, conectando participantes com interesses em comum. A ideia principal é oferecer funcionalidades que permitam a organização de eventos para os participantes, a interação entre eles e a compra de ingressos.

🚀 Funcionalidades

✅ Visualizar Eventos

Lista de eventos publicados com data a partir do dia atual.
Exibição de detalhes como:
- Descrição completa.
- Nome do organizador.
- Agenda do evento.
- Valor do ingresso.
- Botão para compra de ingresso (se disponível) ou mensagem de esgotado.

✅ Criar Conta de Participante

Cadastro de novos usuários com nome, sobrenome, cpf, e-mail e senha.
Possibilidade de completar o perfil com:
- Links para redes sociais.
- Cidade, estado e telefone.
Salvar eventos como favoritos.
Visualizar lista de ingressos adquiridos.
Visulizar lista de feedbacks feitos.

✅ Compra de Ingressos

Escolha de ingressos disponíveis na página de detalhes do evento.
Compra com status temporário de “ingresso confirmado”.
Exibição de ingressos comprados na seção "Meus ingressos".

✅ Ingresso QR Code e Controle de Entrada

Cada ingresso confirmado possui:
- Token único de 36 caracteres alfanuméricos.
- QR Code gerado para controle de acesso.
Registro de utilização do ingresso:
- Apenas uma vez por dia configurado no evento.

✅ Lembretes para Ingressos

Solicitação de lembrete para eventos futuros sem ingressos disponíveis.
Envio de e-mail no dia da abertura de vendas de ingressos.

✅ Feed do Evento

Feed para postagens entre participantes com ingresso confirmado.
Recursos do feed:
- Suporte a texto enriquecido.
- Upload de imagens.
- Curtidas e comentários.
Resumo das últimas 10 postagens na página inicial do usuário.
Comunicados oficiais destacados, sem curtidas ou comentários.
Feedbacks feitos pelos usuários que participaram do evento.

✅ Feedbacks

Após o evento, usuários podem fornecer feedback:
- Feedback geral ou específico por item da agenda.
- Público ou anônimo.
Feedbacks públicos aparecem no feed do evento.
Palestrantes do evento podem responder feedbacks.
Organizadores têm acesso a todos os feedbacks.

📝 Pré-requisitos

Setup:
- Ruby 3.3.2+
- Rails 8.0.1+
- SQLite
Gems:
- capybara
- carmen
- cpf_cnpj
- cuprite
- devise
- faraday
- factory_bot_rails
- image_processing
- rack-cors
- rqrcode
- rspec-rails
- shoulda-matchers
- simplecov
- solid_cache
- solid_cable
- solid_queue
- stimulus-rails
- tailwindcss-rails

💻 Como Contruir

Para construir o projeto, siga estas etapas:

# Abra o terminal (Prompt de comando ou PowerShell para Windows, Terminal para macOS ou Linux)
# Clone este repositório:
git clone https://github.com/TreinaDev/participants-app.git

# Navegue para a pasta do projeto:
cd participants-app

# Instale as dependências:
bundle install

# Crie e migre o banco de dados:
rails db:create
rails db:migrate

# Também é possível rodar as seeds para popular o banco com dados iniciais:
rails db:seed

# Pré-compile os assets estáticos para melhorar visualização do css
rails assets:precompile

# Execute o servidor:
bin/dev

Acesse a aplicação: Abra seu navegador e acesse http://localhost:3000 para ver o participants-app em funcionamento.

Login no Sistema: Para se logar com o usuário criado pelas seeds, use os seguintes dados:

Email: [email protected]
Senha: 123456

🚨 Testes

Execute os testes:
```
rspec
```

APIs

O Participants-App funciona em conjunto com as aplicações [Events-App|https://github.com/TreinaDev/events-app] [Speakers-App|https://github.com/TreinaDev/speakers-app]. Dados são compartilhados com as demais aplicações pelos endpoints descritos abaixo. De modo geral, erros no servidor retornam status http 500.

Endpoint: usuários que participam de um evento

`GET /api/v1/events/:id`

Parâmetros

Par	Tipo	Descrição
`id`	string	Código alfanumérico único do evento

Código HTTP

200 OK

JSON

{
  [
    {
      "name": "Carla",
      "last_name": "Fernandes",
      "email": "[email protected]",
      "cpf": "222.222.222-80"
    },
    {
      "name": "Eduardo",
      "last_name": "Menezes",
      "email": "[email protected]",
      "cpf": "333.333.333-70"
    }
  ]
}

Endpoint: número de ingressos de um lote de um evento que já foram vendidos

`GET /api/v1/events/:event_id/batches/:id`

Parâmetros

Par	Tipo	Descrição
`event_id`	string	Código alfanumérico único do lote de um evento
`id`	string	Código alfanumérico único do evento

JSON

{
  "id": 198,
  "sold_tickets": 27
}

Outros retornos*

Retorna 404 quando o lote não foi encontrado

Endpoint: feebacks de um evento e de todas as atividades do evento

`GET /api/v1/events/:event_id/feedbacks`

Parâmetros

Par	Tipo	Descrição
`event_id`	string	Código alfanumérico único do evento

JSON

{
  "event_id": 12345,
  "feedbacks": [
    {
      "id": 1,
      "title": "Ótimo Evento",
      "comment": "Gostei muito do evento, foi bem organizado!",
      "mark": 5,
      "user": "João Silva"
    },
    {
      "id": 2,
      "title": "Poderia ser melhor",
      "comment": "O local estava muito lotado.",
      "mark": 3,
      "user": "Maria Souza"
    }
  ],
  "item_feedbacks": [
    {
      "id": 10,
      "title": "Qualidade do Palestrante",
      "comment": "O palestrante principal foi incrível.",
      "mark": 5,
      "user": "Ana Pereira",
      "schedule_item_id": 1001
    },
    {
      "id": 11,
      "title": "Feedback sobre Workshop",
      "comment": "A sessão prática foi muito curta.",
      "mark": 4,
      "user": "Carlos Oliveira",
      "schedule_item_id": 1002
    }
  ]
}

Outros retornos*

Retorna 404 quando não há feedbacks para o evento ou se o evento não foi encontrado

Endpoint: Cria resposta para feedback da atividade de um evento

`POST /api/v1/item_feedbacks/:item_feedback_id/feedback_answers`

Parâmetros

Par	Tipo	Descrição
`item_feedback_id`	string	Código alfanumérico único da atividade de um evento
`name`	string	Nome que quem está respondendo
`email`	string	Email de quem está respondendo
`comment`	string	Corpo da resposta ao feedback

JSON

Status 201

{
  "id": 1,
  "name": "John Doe",
  "email": "[email protected]",
  "comment": "Obrigado pelo seu feedback",
  "item_feedback_id": 5,
  "created_at": "2025-02-09T12:34:56Z",
  "updated_at": "2025-02-09T12:34:56Z"
}

Status 406

{
  "errors": [
    "Nome não pode ficar em branco",
    "Email é inválido"
  ]
}

Status 406

{
  "error": "Item feedback not found"
}

Endpoint: feedbacks de uma atividade de um evento

`GET /api/v1/schedule_items/:schedule_item_id/item_feedbacks`

Parâmetros

Par	Tipo	Descrição
`schedule_item_id`	string	Código alfanumérico único da atividade

JSON

{
  "comentarios_itens": [
    {
      "id": 1,
      "titulo": "Ótima Sessão",
      "comentario": "Discussão muito esclarecedora!",
      "nota": 5,
      "usuario": "João Silva",
      "id_item_agenda": 101
    },
    {
      "id": 2,
      "titulo": "Poderia ser melhor",
      "comentario": "A sessão foi informativa, mas faltou mais engajamento.",
      "nota": 3,
      "usuario": "Maria Oliveira",
      "id_item_agenda": 102
    }
  ]
}

Outros retornos*

Retorna 404 quando não há feedbacks para a atividade

Endpoint: Alteração de status de um ticket para "usado"

`POST /api/v1/tickets/:token/used`

Parâmetros

Par	Tipo	Descrição
`token`	string	Código alfanumérico do ingresso

JSON

Status 200

  {
    "token": "ABC123",
    "status_confirmed": false,
    "date_of_purchase": "2025-02-09T12:00:00Z",
    "payment_method": 1,
    "user_id": 2,
    "event_id": "EVT001",
    "batch_id": "BATCH001",
    "usage_status": 1
  }

Status 422: quando ticket já está marcado como usado

  {
    "error": "This ticket is already used for this day"
  }

Status 404: quando a requisição ocorre em um dia diferente da validade do ticket

  {
    "error": "This ticket can be used only on the day of the event"
  }

Endpoint: dados de um usuário

`GET /api/v1/users/:code`

Parâmetros

Par	Tipo	Descrição
`code`	string	Código alfanumérico do usuário

JSON

Status 200

  {
    "name": "Nome Teste",
    "last_name": "Sobrenome Teste",
    "cpf": "42547083000",
    "email": "[email protected]"
  }

Status 404

{
  "error": "User not found"
}

🤝 Contribuidores

_{Cristiano Santana}	_{César Faustino}	_{David Bolivar}	_{Gabriel Ribeiro}	_{João Branco}	_{Samuel Rocha}

Name		Name	Last commit message	Last commit date
Latest commit History 548 Commits
.github/workflows		.github/workflows
app		app
bin		bin
config		config
db		db
lib/tasks		lib/tasks
log		log
public		public
script		script
spec		spec
storage		storage
tmp		tmp
.gitattributes		.gitattributes
.gitignore		.gitignore
.rspec		.rspec
.rubocop.yml		.rubocop.yml
.ruby-version		.ruby-version
Gemfile		Gemfile
Gemfile.lock		Gemfile.lock
Procfile.dev		Procfile.dev
README.md		README.md
Rakefile		Rakefile
config.ru		config.ru
package-lock.json		package-lock.json
package.json		package.json
yarn.lock		yarn.lock

TreinaDev/participants-app

Folders and files

Latest commit

History

Repository files navigation

Participants-App | Gerenciamento de Inscrições

🚀 Funcionalidades

✅ Visualizar Eventos

✅ Criar Conta de Participante

✅ Compra de Ingressos

✅ Ingresso QR Code e Controle de Entrada

✅ Lembretes para Ingressos

✅ Feed do Evento

✅ Feedbacks

📝 Pré-requisitos

💻 Como Contruir

🚨 Testes

APIs

Endpoint: usuários que participam de um evento

GET /api/v1/events/:id

Parâmetros

Código HTTP

JSON

Endpoint: número de ingressos de um lote de um evento que já foram vendidos

GET /api/v1/events/:event_id/batches/:id

Parâmetros

JSON

Outros retornos*

Endpoint: feebacks de um evento e de todas as atividades do evento

GET /api/v1/events/:event_id/feedbacks

Parâmetros

JSON

Outros retornos*

Endpoint: Cria resposta para feedback da atividade de um evento

POST /api/v1/item_feedbacks/:item_feedback_id/feedback_answers

Parâmetros

JSON

Endpoint: feedbacks de uma atividade de um evento

GET /api/v1/schedule_items/:schedule_item_id/item_feedbacks

Parâmetros

JSON

Outros retornos*

Endpoint: Alteração de status de um ticket para "usado"

POST /api/v1/tickets/:token/used

Parâmetros

JSON

Endpoint: dados de um usuário

GET /api/v1/users/:code

Parâmetros

JSON

🤝 Contribuidores

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 9

Uh oh!

Languages

`GET /api/v1/events/:id`

`GET /api/v1/events/:event_id/batches/:id`

`GET /api/v1/events/:event_id/feedbacks`

`POST /api/v1/item_feedbacks/:item_feedback_id/feedback_answers`

`GET /api/v1/schedule_items/:schedule_item_id/item_feedbacks`

`POST /api/v1/tickets/:token/used`

`GET /api/v1/users/:code`

Packages