Desenvolvedores

A Agenda Sacramental Online é um projeto voluntário, sem fins lucrativos e com usuários reais. Se você está desenvolvendo suas habilidades e quer praticar em um ambiente real — com código em produção, fluxo de tarefas, revisão e entrega — este projeto pode ser a oportunidade que você procura.

Um projeto real, não um exercício

Grande parte dos desenvolvedores iniciantes enfrenta o mesmo impasse: sem experiência, não conseguem oportunidade — e sem oportunidade, não constroem experiência. Cursos ensinam a sintaxe, tutoriais mostram exemplos isolados, mas nenhum deles simula o que é trabalhar em um sistema com usuários reais, banco de dados com dados reais, deploy automatizado e código que precisa funcionar toda semana.

A Agenda Sacramental Online existe e funciona. Não é um projeto de portfólio criado para parecer real — é real. Isso muda tudo: qualquer alteração no código pode afetar alguém que está usando o sistema num domingo de manhã. Essa responsabilidade é justamente o que transforma um desenvolvedor iniciante em um desenvolvedor confiável.

Contribuir com um projeto em produção é diferente de fazer um exercício. Aqui você vai errar com consequências reais, revisar código de outra pessoa, ter o seu código revisado e entender por que cada detalhe importa.


O que você vai encontrar aqui

O projeto é dividido em três repositórios independentes, cada um com seu contexto e stack próprios. Você pode contribuir em qualquer um deles — ou em todos, dependendo do seu interesse e perfil.

Site Institucional — agenda-site

O site que você está acessando agora. Um projeto de frontend estático com foco em performance, SEO e experiência do usuário.

  • Vite como bundler e servidor de desenvolvimento
  • Handlebars para templating e reuso de partials
  • SCSS com arquitetura modular por componente
  • Vanilla JavaScript sem dependências de framework
  • Deploy automatizado via Bitbucket Pipelines com rsync

Ideal para quem quer praticar HTML semântico, CSS organizado, JavaScript puro e entender como um site estático chega ao ar de forma profissional.

Aplicação Web — agenda-app

A plataforma de uso diário dos bispados. Uma SPA completa com autenticação, múltiplos módulos e integração com a API.

  • Angular 20 com arquitetura de componentes e módulos
  • TypeScript 5.8 com tipagem estrita
  • Angular Material como biblioteca de componentes
  • RxJS para gerenciamento de estado reativo e requisições assíncronas
  • SCSS com estilos por componente

Ideal para quem quer aprender ou aprofundar Angular em um projeto com múltiplas telas, rotas protegidas, guards, resolvers, formulários reativos e integração com API REST.

API REST — agenda-api

O backend que serve toda a plataforma. Uma API PHP estruturada com separação de responsabilidades, autenticação JWT e geração de PDFs.

  • PHP 8.2 com orientação a objetos e autoload PSR-4
  • Doctrine DBAL para acesso ao banco de dados
  • MySQL como banco de dados relacional
  • JWT (lcobucci/jwt) para autenticação stateless
  • FPDF/FPDI para geração de documentos PDF
  • Monolog para logging estruturado
  • PHPMailer para envio de e-mails transacionais
  • Cronjobs agendados para relatórios e monitoramento

Ideal para quem quer entender como uma API REST é estruturada na prática — roteamento, autenticação, validação, tratamento de erros, persistência e comunicação com serviços externos.


O que você vai praticar

Além das tecnologias específicas de cada repositório, contribuir com este projeto coloca você em contato com práticas que o mercado exige e que dificilmente se aprende sozinho:

Fluxo real de desenvolvimento

Cada contribuição passa por um ciclo completo: entendimento da tarefa, implementação em branch separada, abertura de Pull Request, revisão de código e merge controlado. Você vai aprender a escrever mensagens de commit claras, descrever o que mudou e por quê, e lidar com o feedback de revisão — tudo isso antes de chegar ao código em produção.

Entrega contínua e deploy automatizado

Os três repositórios utilizam Bitbucket Pipelines para automatizar o processo de build e deploy. Todo merge na branch principal dispara automaticamente o pipeline — o código é compilado, validado e enviado ao servidor sem intervenção manual. Você vai entender como um sistema chega ao ar e o que acontece entre o seu commit e o usuário final acessando a tela.

Leitura e compreensão de código existente

Entrar em um projeto que já existe é uma habilidade fundamental e subestimada. Antes de escrever qualquer linha nova, você vai precisar entender a arquitetura, os padrões adotados e as convenções do projeto. Essa leitura crítica de código alheio é o que diferencia quem apenas escreve código de quem consegue trabalhar em equipe.

Testes e qualidade

O projeto está evoluindo para incluir cobertura de testes unitários e de integração. Participar dessa construção — escrever os primeiros testes de um módulo, identificar casos de borda, garantir que uma mudança não quebra o que já funciona — é uma das experiências mais formadoras que um desenvolvedor pode ter.


Como funciona a contribuição

O projeto é mantido de forma controlada. Não temos repositórios públicos abertos para qualquer fork — o acesso é concedido individualmente após uma conversa inicial. Isso garante que cada contribuidor entende o contexto, o propósito e as responsabilidades antes de começar.

O processo é simples:

  1. Você entra em contato apresentando seu perfil e interesse
  2. Temos uma conversa rápida para entender onde você está e o que quer aprender
  3. Você recebe acesso ao repositório correspondente ao seu interesse
  4. As tarefas são atribuídas e acompanhadas via sistema de issues
  5. Toda contribuição passa por revisão antes de chegar à produção

Não exigimos experiência prévia em nenhuma das tecnologias do projeto — exigimos disposição para aprender, leitura atenta e comprometimento com a qualidade. O projeto tem usuários reais que dependem dele. Isso não é um detalhe: é o que torna a experiência significativa.


Para quem é esta oportunidade

Este projeto é especialmente adequado para você se:

  • Está concluindo ou concluiu um curso de desenvolvimento e quer sua primeira experiência em projeto real
  • Tem conhecimento teórico mas pouca vivência prática em equipe e fluxo de entrega
  • Quer construir ou fortalecer um portfólio com contribuições verificáveis em código em produção
  • Tem interesse específico em Angular, PHP, SCSS, pipelines de CI/CD ou arquitetura de APIs REST
  • Quer entender na prática o ciclo completo — da tarefa ao deploy — dentro de um contexto real

Não é necessário ser membro da Igreja para contribuir. O projeto é técnico e a contribuição é técnica — o contexto eclesiástico é o domínio de negócio, não um pré-requisito.


Entre em contato

Se você chegou até aqui e se identificou com o que foi descrito, entre em contato. Não precisa de currículo formatado nem de carta de apresentação — apenas nos diga quem você é, o que já estudou ou praticou, e o que você quer aprender contribuindo com este projeto.

E-mail: contato@agendasacramental.online

Toda mensagem é lida e respondida. Pode levar alguns dias, mas você receberá um retorno.

Última atualização: Abril de 2026