Pular para o conteúdo principal

B1 Admin

O B1Admin é o painel de administração da igreja -- uma aplicação React de página única construída com Vite e Material-UI. A equipe da igreja o utiliza para gerenciar pessoas, grupos, presença, doações, conteúdo e mais.

Antes de Começar

Configuração​

1. Clone o repositório​

git clone https://github.com/ChurchApps/B1Admin.git

2. Instale as dependências​

cd B1Admin
npm install

3. Configure as variáveis de ambiente​

cp dotenv.sample.txt .env

Abra o .env e configure os endpoints da API. Você pode apontar para a API de staging ou para sua instância local da API.

4. Inicie o servidor de desenvolvimento​

npm start

Isso inicia o servidor de desenvolvimento Vite. A aplicação estará disponível no seu navegador com hot module replacement habilitado.

Variáveis de Ambiente Principais​

VariávelDescrição
REACT_APP_STAGENome do ambiente (ex: local, staging, prod)
PORTPorta do servidor de desenvolvimento (padrão: 3101)
REACT_APP_*_APIURLs dos endpoints de API para cada módulo
Info

O script postinstall copia arquivos de localização e CSS do @churchapps/apphelper. Se os componentes aparecerem sem estilo, execute npm run postinstall manualmente.

Comandos Principais​

ComandoDescrição
npm startIniciar servidor de desenvolvimento Vite
npm run buildBuild de produção via Vite
npm run testExecutar testes end-to-end com Playwright
npm run lintExecutar ESLint com auto-correção

Stack Tecnológica​

  • React 19 com TypeScript
  • Vite para ferramentas de build e servidor de desenvolvimento
  • Material-UI 7 para componentes de UI
  • React Query 5 para estado do servidor
  • Pacotes @churchapps/apphelper* para componentes compartilhados

Implantação​

Os builds de produção são implantados no S3 + CloudFront:

  1. npm run build gera os assets estáticos
  2. Os assets são sincronizados com um bucket S3
  3. A invalidação do CloudFront é acionada para servir a nova versão
Dica

Para instruções detalhadas de implantação, veja o guia de Implantação de Aplicações Web.