feat: agenda de próximos eventos da comunidade na landing page

[fernanduandrade]

Agenda de próximos eventos na landing page

O que construir

• Exibir na landing page uma seção "Próximos eventos da comunidade" com a agenda de encontros comunitários, apresentada em cards navegáveis (carrossel).
• Permitir que a comunidade edite a agenda por meio do painel administrativo: criar, editar e desativar eventos, além de controlar a ordem de exibição.
• Suportar dois tipos de agendamento: eventos recorrentes (repetem semanalmente, com dia da semana e horário) e eventos pontuais (data e hora específicas).
• Registrar para cada evento o conteúdo editorial: título, descrição, categoria (ex.: reunião semanal, aula livre, aula de inglês, onboarding, networking), capa, anfitrião (nome e cargo), local (presencial/online) e link de participação.
• Gerar dados estruturados de SEO (rich results) para que o Google exiba os eventos nos resultados de busca.
• Exibir apenas eventos ativos cuja próxima ocorrência ainda não aconteceu, ordenados pela data mais próxima.

Critérios de aceite

• A seção "Próximos eventos da comunidade" é renderizada na landing page com os cards dos eventos ativos.
• Eventos recorrentes exibem o padrão semanal (dia da semana e horário) e eventos pontuais exibem a data específica.
• Eventos inativos, eventos passados e eventos sem próxima ocorrência definida não aparecem na landing.
• Os cards são ordenados pela próxima ocorrência, do mais próximo para o mais distante.
• Cada card apresenta capa (ou placeholder da marca), badge de local (presencial/online), título, descrição, anfitrião (nome e cargo) e botão de participação.
• O painel administrativo permite criar, editar, ativar/desativar, reordenar e pular a próxima ocorrência de um evento.
• A landing inclui dados estruturados (JSON-LD) dos eventos quando existem eventos ativos com ocorrência futura.
• Quando não há eventos futuros, a seção exibe uma mensagem de fallback orientando o visitante para o Discord.
• Os cenários BDD abaixo estão cobertos por testes automatizados.

Teste

BDD

# language: pt

Funcionalidade: Agenda de próximos eventos da comunidade

  Cenário: Exibir a agenda com eventos ativos na landing page
    Dado que existem eventos recorrentes e pontuais ativos com ocorrências futuras
    Quando um visitante acessa a landing page
    Então a seção "Próximos eventos da comunidade" é exibida
    E os cards dos eventos ativos aparecem com título, data/horário, local e botão de participação

  Cenário: Ocultar eventos inativos
    Dado que existe um evento marcado como inativo
    Quando a landing page é renderizada
    Então esse evento não aparece na seção de agenda

  Cenário: Ocultar eventos sem ocorrência futura
    Dado que existe um evento cuja próxima ocorrência já passou
    Quando a landing page é renderizada
    Então esse evento não aparece na seção de agenda

  Cenário: Ordenar eventos pela próxima ocorrência
    Dado que existem vários eventos ativos com ocorrências futuras em datas diferentes
    Quando a landing page é renderizada
    Então os eventos são ordenados do mais próximo para o mais distante

  Cenário: Diferenciar eventos recorrentes de pontuais
    Dado que existe um evento recorrente (semanal) e um evento pontual (data única)
    Quando a landing page é renderizada
    Então o evento recorrente exibe o padrão semanal (ex.: "Toda Seg • 21:00")
    E o evento pontual exibe a data específica (ex.: "28 AGO • 20:00")

  Cenário: Publicar dados estruturados para SEO
    Dado que existem eventos ativos com ocorrência futura
    Quando a landing page é renderizada
    Então a página contém dados estruturados de eventos (formato de busca do Google)

  Cenário: Exibir fallback quando não há eventos futuros
    Dado que não existem eventos ativos com ocorrência futura
    Quando a landing page é renderizada
    Então a seção exibe a mensagem "Nenhum evento agendado no momento"
    E o visitante é orientado a entrar no Discord

  Cenário: Pular a próxima ocorrência de um evento recorrente
    Dado que um evento recorrente tem a opção de pular a próxima ocorrência ativada
    Quando a landing page é renderizada
    Então a próxima ocorrência exibida é a da semana seguinte

Bloqueada por

[fernanduandrade]

@stherzada @hefeus @guisaliba

[hefeus]

Obrigado por me marcar!

• Hoje já temos no módulo de eventos, que espero que seja mergeado na proxima semana, que já possui o cadastro de eventos da comunidade pelos os admins, você acha que poderia aproveitar essa lista ou ter uma listagem a parte somente para landing page por conta de alguma coisa especifica só dela?

• No caso de pular para a próxima ocorrencia, seria um botão que faria renderizar somente as proximas ocorrencias daquele evento em um modal, em uma nova pagina ou no próprio componente? Qual sua idéia?

[fernanduandrade]

Obrigado por me marcar!

• Hoje já temos no módulo de eventos, que espero que seja mergeado na proxima semana, que já possui o cadastro de eventos da comunidade pelos os admins, você acha que poderia aproveitar essa lista ou ter uma listagem a parte somente para landing page por conta de alguma coisa especifica só dela?
• No caso de pular para a próxima ocorrencia, seria um botão que faria renderizar somente as proximas ocorrencias daquele evento em um modal, em uma nova pagina ou no próprio componente? Qual sua idéia?

Eu acredito que sim mano, conceituamente são diferentes mais podemos interligar os dados do modulo de eventos para puxar e evitar duplicação de cadastros.
No caso de pular a ocorrência apenas é adicionado 1 semana para frente e é possível fazer isso editando os dados do formulário pelo painel do filament.

[stherzada]

Que arraso! Adorei a ideia, ia citar o que yuri disse, logo mais terá o modulo de evento, que abordaria esse lado com features a mais, se pudesse no futuro o evento cadastrado pelo que eles fizesse refletisse, seria muito bacana, mas adorei o MVP e acho válido já mergear, e quando mergear eventos pensamos nesse caso.

Faz sentido @hefeus?

[gvieira18]

Concordo que a funcionalidade é necessária, mas discordo de que seja implementada fora da feat/events.

Não vejo sentido em manter uma tabela upcoming_events, já que ela representa apenas uma pseudo-query sobre a tabela que já existe:

SELECT * FROM events WHERE now() < starts_at

A migration de events já contempla isso, inclusive com o índice idx_events_window sobre starts_at, exatamente para esse tipo de consulta. Manter uma tabela separada significa duplicar estado e assumir o custo de mantê-la sincronizada, sem ganho claro.

O segundo ponto é arquitetural. Por ter sido desenvolvida fora da feature de events, a implementação acabou divergindo do padrão de módulos: as migrations de upcoming_events ficaram em app-modules/community/, e não em app-modules/events/. Com isso, community passou a carregar o schema de um domínio que não é dele.

[fernanduandrade]

Concordo que a funcionalidade é necessária, mas discordo de que seja implementada fora da feat/events.

Não vejo sentido em manter uma tabela upcoming_events, já que ela representa apenas uma pseudo-query sobre a tabela que já existe:

SELECT * FROM events WHERE now() < starts_at
A migration de events já contempla isso, inclusive com o índice idx_events_window sobre starts_at, exatamente para esse tipo de consulta. Manter uma tabela separada significa duplicar estado e assumir o custo de mantê-la sincronizada, sem ganho claro.

O segundo ponto é arquitetural. Por ter sido desenvolvida fora da feature de events, a implementação acabou divergindo do padrão de módulos: as migrations de `upcoming_events` ficaram em `app-modules/community/`, e não em `app-modules/events/`. Com isso, `community` passou a carregar o schema de um domínio que não é dele.

Entendi a proposta, nesse caso posso trabalhar em cima da branch do modulo de events e extender com alguns campos para fazer a query e conseguir o mesmo resultado. A dificuldade que eu estava tendo era de entender como poder usar um evento que tem participação confirmada e tudo mais para conseguir exibir na landing.

[hefeus]

Que arraso! Adorei a ideia, ia citar o que yuri disse, logo mais terá o modulo de evento, que abordaria esse lado com features a mais, se pudesse no futuro o evento cadastrado pelo que eles fizesse refletisse, seria muito bacana, mas adorei o MVP e acho válido já mergear, e quando mergear eventos pensamos nesse caso.

• Faz total sentido

Entendi a proposta, nesse caso posso trabalhar em cima da branch do modulo de events e extender com alguns campos para fazer a query e conseguir o mesmo resultado. A dificuldade que eu estava tendo era de entender como poder usar um evento que tem participação confirmada e tudo mais para conseguir exibir na landing.

• Como o Gabriel e a Sther citaram, o ideal será está dentro de eventos para reaproveitar os dados. No caso, você poderia criar o card do evento com o resumo e com um botão de link que levaria para a pagina de confirmação do evento, o card seria mais informativo com as informações de rápido acesso como data, nome e tipo do evento, e local do evento se for online ou presencial, e dentro a pagina do evento propriamente dito teria mais informações.

[fernanduandrade]

Valeu pelo feedback galera. Vou trabalhar por cima da branch do modulo de eventos pra conseguir o mesmo resultado e reabro a pr

[fernanduandrade]

@gvieira18 @hefeus @stherzada disponível para review #491

Adicionei um campo no formulário para fazer upload de uma imagem cover nos cards de exibição na landing, do mais está puxando da tabela principal.