Sistema de gestão de presença e acompanhamento para o Programa Bombeiro Mirim (PBM) do Corpo de Bombeiros Militar do Distrito Federal

O FireForce - PPBM é uma solução web desenvolvida para modernizar e centralizar a gestão do Programa Bombeiro Mirim (PBM), uma iniciativa social gratuita do CBMDF que atende crianças e adolescentes de 7 a 14 anos em 12 cidades do Distrito Federal.

• Centralizar e Automatizar o controle de frequência dos brigadinos
• Melhorar a Análise de Dados com relatórios e dashboards para gestores
• Facilitar a Comunicação entre equipe e responsáveis
• Aprimorar o Acompanhamento individualizado, especialmente para crianças neurodivergentes
• Garantir Acessibilidade e alta usabilidade para diferentes perfis de usuário

• Astro - Framework web moderno focado em performance
• TypeScript - Tipagem estática para maior segurança no código
• Starlight - Sistema de documentação baseado em Astro

• Node.js + Express - Servidor web robusto e escalável
• TypeScript - Desenvolvimento type-safe
• RESTful API - Arquitetura de comunicação padronizada

• Supabase - Plataforma backend-as-a-service
• PostgreSQL - Banco de dados relacional robusto
• Row Level Security (RLS) - Segurança a nível de linha

• Docker - Containerização para padronização de ambientes
• Git - Controle de versão distribuído
• GitHub Actions - CI/CD automatizado

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │   Backend       │    │   Database      │
│   (Astro)       │◄──►│   (Express)     │◄──►│   (Supabase)    │
│                 │    │                 │    │                 │
│ • Interface     │    │ • API REST      │    │ • PostgreSQL    │
│ • Componentes   │    │ • Autenticação  │    │ • RLS Security  │
│ • Responsivo    │    │ • Validações    │    │ • Real-time     │
└─────────────────┘    └─────────────────┘    └─────────────────┘

• Autenticação segura de usuários
• Controle de permissões por papel
• Operação multiunidade

• Cadastro completo de crianças
• Gestão de responsáveis
• Ficha médica e informações complementares
• Perfis neurodivergentes

• Registro de presença, falta e atraso
• Sistema de justificativas com anexos
• Política diferenciada para faltas
• Autonomia docente para aprovação

• Consultas avançadas por aluno/período
• Relatórios individuais e consolidados
• Dashboards com indicadores em tempo real
• Exportação em PDF e Excel

• Sistema de notificações (WhatsApp, e-mail)
• Registro de advertências
• Templates personalizáveis

• Planos de acompanhamento pedagógico
• Registro de relatórios dos responsáveis
• Histórico acessível para docentes

• Cadastro de conteúdos institucionais
• Editor de texto com formatação
• Controle de versões

• Sistema de auditoria completo
• Filtros e busca avançada
• Cadastro de turmas e sessões

• Node.js 18+
• Docker e Docker Compose
• Git

git clone https://github.com/seu-usuario/REQ-2025.2-T01-PPBM.git
cd REQ-2025.2-T01-PPBM

# Frontend (Documentação)
cd docs
npm install

# Backend (quando disponível)
cd ../backend
npm install

# Crie um arquivo .env na raiz do projeto
cp .env.example .env
# Edite as variáveis conforme necessário

# Suba todos os serviços
docker-compose up -d

# Ou execute individualmente
docker-compose up frontend
docker-compose up backend
docker-compose up database

# Frontend (Documentação)
cd docs
npm run dev

# Backend (quando disponível)
cd ../backend
npm run dev

A documentação completa do projeto está disponível em:

• Desenvolvimento: http://localhost:4321 (modo dev)
• Produção: [Link para documentação online]

docs/src/content/docs/
├── visao/           # Visão geral do projeto
├── requisitos/      # Especificação de requisitos
├── user-stories/    # Histórias de usuário
├── cronograma/      # Planejamento e entregas
├── evidencias/      # Evidências de desenvolvimento
└── atas/           # Atas de reuniões

• Preparação e alinhamento inicial
• Setup do ambiente de desenvolvimento

• Estruturação e primeira iteração
• Protótipo inicial navegável

• Módulo de Cadastro e Acesso
• Primeira entrega funcional

• Módulo de Presença e Justificativas
• Segunda entrega funcional

• Módulos de Relatórios e Comunicação
• Terceira entrega funcional

• Módulos Complementares e Integração
• Quarta entrega funcional

• Entrega final do MVP
• Homologação e produção

# Executar testes unitários
npm run test

# Executar testes de integração
npm run test:integration

# Executar testes E2E
npm run test:e2e

# Cobertura de testes
npm run test:coverage

# Build da aplicação
npm run build

# Preview local
npm run preview

# Deploy automatizado via GitHub Actions
git push origin main

• Disponibilidade: 99,5% de uptime
• Tempo de Resposta: < 5 segundos para operações críticas
• Cobertura de Testes: > 80%
• Performance: Lighthouse Score > 90

• LGPD: Conformidade com a Lei Geral de Proteção de Dados
• Criptografia: Dados transmitidos de forma segura
• Autenticação: Sistema robusto de login e permissões
• Auditoria: Trilha completa de operações sensíveis

Este é um projeto acadêmico desenvolvido para o Corpo de Bombeiros Militar do Distrito Federal. Para contribuições, entre em contato com a equipe de desenvolvimento.

• Projeto: FireForce - PPBM
• Instituição: Universidade de Brasília (UnB)
• Disciplina: Requisitos de Software (2025.2)
• Professor: Dr. George Marsicano
• Cliente: Corpo de Bombeiros Militar do Distrito Federal (CBMDF)

• Corpo de Bombeiros Militar do Distrito Federal (CBMDF)
• Universidade de Brasília (UnB)
• Dr. George Marsicano - Professor Orientador
• Equipe de desenvolvimento FireForce