How kernel-panic-fatecsjc/kp-4dsm-api works
Data Panic é uma plataforma web de monitoramento de riscos naturais para equipes da Defesa Civil e gestão de contratos da Tecsus. O fluxo central vai da recepção de telemetria de estações à persistência de leituras e sua disponibilização para consulta, alertas e dashboard. O produto também inclui cadastro de equipamentos e usuários, controle de acesso, licitações e auditoria. O README documenta capacidades gerais; conexões entre componentes não amostrados são omitidas ou marcadas como não verificadas.
Main entry points: prisma.service.ts Banco de dados · auditoria.service.ts Trilha de auditoria · page.tsx Portal operacional · alertas.service.ts Alertas configuráveis
Components 23
Aplicação web
- Portal operacional
frontend/frontend/app/(protegido)/dashboard/page.tsx - Telas de gestão
frontend/frontend/app/(protegido)/estacoes/page.tsx - Telas de alertas
frontend/frontend/app/(protegido)/alarmes/page.tsx
Acesso e gestão
- Usuários
kernelpanic-backend/src/usuarios/usuarios.service.ts - Autenticação e perfis
kernelpanic-backend/src/autenticacao/guarda-jwt.guard.ts - Estações
kernelpanic-backend/src/estacoes/estacoes.service.ts - Sensores
kernelpanic-backend/src/sensores/sensores.service.ts - Licitações e contratos
kernelpanic-backend/src/licitacoes/licitacoes.service.ts
Telemetria e dados
- API de ingestão
kernelpanic-backend/servicos/ingestao/http/ingestao.controller.ts - Buffer e ingestão
kernelpanic-backend/servicos/ingestao/ingestao.service.ts - Repositório bruto
kernelpanic-backend/servicos/ingestao/leituras-brutas.repositorio.ts - Leituras brutas
- Assinante MQTT
kernelpanic-backend/servicos/ingestao/mqtt/assinante-mqtt.service.ts - Tratamento de leituras
kernelpanic-backend/servicos/tratamento/tratamento.service.ts - Banco de dados
kernelpanic-backend/src/prisma/prisma.service.ts
Risco e consulta
- Dashboard e indicadores
kernelpanic-backend/src/dashboard/dashboard.service.ts - Alertas configuráveis
kernelpanic-backend/src/alertas/alertas.service.ts - Alarmes em tempo real
kernelpanic-backend/src/alarmes/tempo-real/alarmes-tempo-real.service.ts - Consultas de leituras
kernelpanic-backend/src/leituras-brutas/leituras-brutas.service.ts
Auditoria
- Trilha de auditoria
kernelpanic-backend/src/auditoria/auditoria.service.ts
Other components
- Operador
- Estação meteorológica
- Broker MQTT
Connections 27
- Operador → Portal operacional: usa
- Portal operacional → Dashboard e indicadores: consulta APIs
- Portal operacional → Telas de gestão: acessa telas
- Portal operacional → Telas de alertas: acessa telas
- Telas de gestão → Estações: gerencia
- Telas de gestão → Sensores: gerencia
- Telas de alertas → Alertas configuráveis: configura e consulta
- Estação meteorológica → API de ingestão: envia telemetria
- API de ingestão → Buffer e ingestão: encaminha pacote
kernelpanic-backend/servicos/ingestao/http/ingestao.controller.ts - Buffer e ingestão → Banco de dados: consulta estação
kernelpanic-backend/servicos/ingestao/ingestao.service.ts - Buffer e ingestão → Repositório bruto: grava lote
kernelpanic-backend/servicos/ingestao/ingestao.service.ts - Repositório bruto → Leituras brutas: persiste
- Broker MQTT → Assinante MQTT: publica mensagens
- Assinante MQTT → Buffer e ingestão: repassa leituras
kernelpanic-backend/servicos/ingestao/mqtt/assinante-mqtt.service.ts - Tratamento de leituras → Leituras brutas: processa lotes
- Dashboard e indicadores → Banco de dados: consulta indicadores
- Alertas configuráveis → Banco de dados: persiste regras
- Alertas configuráveis → Alarmes em tempo real: emite eventos
- Consultas de leituras → Banco de dados: consulta leituras
- Licitações e contratos → Estações: lista estações
kernelpanic-backend/src/licitacoes/licitacoes.controller.ts - Usuários → Banco de dados: persiste usuários
- Autenticação e perfis → Usuários: valida sessão
- Estações → Trilha de auditoria: registra ações
kernelpanic-backend/src/estacoes/estacoes.controller.ts - Alertas configuráveis → Trilha de auditoria: registra ações
kernelpanic-backend/src/alertas/alertas.controller.ts - Usuários → Trilha de auditoria: registra ações
kernelpanic-backend/src/usuarios/usuarios.controller.ts - Licitações e contratos → Trilha de auditoria: registra ações
kernelpanic-backend/src/licitacoes/licitacoes.controller.ts - Trilha de auditoria → Banco de dados: grava e consulta
kernelpanic-backend/src/auditoria/auditoria.service.ts