Uso assistido com revisão 14
O registro pode apoiar demo e operação assistida, mas sistemas de cautela ou evidência fraca exigem revisão antes de promessa pública.
- Alta cautela
- 3
- Restritos
- 11
- Gates
- 6
Registro público
Transparência algorítmica BairroSafe
Este registro documenta os principais sistemas que transformam dados urbanos em scores, previsões, descobertas e controles de qualidade. A página explica o que cada sistema faz, quais dados usa, onde pode falhar e onde existe supervisão humana.
Como protegemos o uso
Controles antes da publicação
01
Audience gate
Todo padrão recebe uma audiência: público, B2G restrito ou controle interno. O banco impede que padrão sem evidência seja publicado como público.
02
Quality gate
Descobertas públicas precisam ter suporte mínimo, promoção documentada, dimensões de confiança e proteção contra linguagem causal indevida.
03
Supervisão humana
Modelos preditivos e recomendações operacionais entram como apoio à decisão. A plataforma não aponta indivíduos e não automatiza ação policial.
04
Separação de acesso
Superfícies B2G ficam atrás de login, secret operacional ou Cloudflare Access. Páginas públicas recebem apenas resumo agregado e seguro.
Revisão municipal
Relatório de accountability operacional
A revisão cruza documentação, audiência, força de evidência, supervisão humana e QA pós-publicação para indicar quais sistemas podem apoiar decisão municipal e quais precisam de cautela.
aprovado
Documentação mínima
14/14 sistemas têm fonte, saída, limite e supervisão registrados.
Manter revisão em cada alteração de fonte, peso ou superfície. revisar
Sincronização com catálogo
33/115 itens técnicos têm ponte explícita com as fichas curadas; 0 fichas ainda nasceu depois do catálogo fonte.
Atualizar o catálogo gerado e decidir quais itens LIVE precisam virar ficha pública ou B2G. revisar
Separação de acesso
3 públicos; 11 restritos ou internos; 3 com alta cautela.
Manter sistemas de alta cautela fora da superfície pública e revisar benchmark antes de demo. revisar
Força de evidência
7 sistemas ainda dependem de validação local ou evidência fraca.
Tratar como hipótese operacional e anexar medição antes de vender economia ou causalidade. aprovado
Supervisão humana
14/14 sistemas declaram exposição e limite de uso.
Confirmar responsável humano em mudanças de threshold, audience ou copy causal. revisar
QA pós-publicação
Revisão do registro em 2026-05-25; QA visual e leak audit devem acompanhar cada release.
Anexar build, leak audit, console/network e screenshots desktop/mobile ao fechamento da release.Lista de cautela
Sistemas que exigem cautela em reunião
Previsão Criminal LightGBM
Alta cautela operacional
Restringir a B2G/interno e exigir revisão humana antes de comunicação externa.ETAS Near-Repeat Wavefront
Alta cautela operacional
Restringir a B2G/interno e exigir revisão humana antes de comunicação externa.Custo Fiscal do Crime v1
Evidência fraca
Apresentar como hipótese operacional e medir resultado antes de afirmar impacto.ROI Municipal e Eficiencia Fiscal
Evidência fraca
Apresentar como hipótese operacional e medir resultado antes de afirmar impacto.Econometria Espacial Municipal GWR
Evidência fraca
Apresentar como hipótese operacional e medir resultado antes de afirmar impacto.Pipeline Municipal de Anomalias
Alta cautela operacional
Restringir a B2G/interno e exigir revisão humana antes de comunicação externa.Difusao Criminal Municipal Hawkes
Evidência fraca
Apresentar como hipótese operacional e medir resultado antes de afirmar impacto.Mapa Municipal de Corredores de Crime
Evidência fraca
Apresentar como hipótese operacional e medir resultado antes de afirmar impacto.Inventário técnico
Catálogo completo sincronizado
O registro abaixo é a parte curada para leitura pública e reuniões. O inventário técnico vem do catálogo revisado em 2026-05-21 e separa produção, conexão pendente, estrutura e planejamento.
Em produção
100 Já aparece em alguma superfície, job, RPC ou fluxo operacional.
Construído, não conectado
10 Código ou artefato existe, mas ainda não está conectado ao produto principal.
Somente estrutura
4 Estrutura de banco ou contrato existe, ainda sem entrega operacional completa.
Planejado
1 Mapeado no catálogo para decisão futura, sem implementação pronta.
Sincronização auditável
Ponte entre ficha curada e catálogo técnico
A ficha pública não tenta listar os 115 itens técnicos. Ela mostra quais sistemas impactam decisão municipal e aponta explicitamente os IDs do catálogo gerado que sustentam cada ficha.
- IDs ligados
- 33/115
- Fichas com ponte
- 14/14
- LIVE sem ficha
- 68
- Fichas sem ponte
- 0
vinculado
5 LIVE BairroSafe Score V5.10
Catálogo 1.1, 1.2, 1.3, 1.4, 1.7 · Scoring System
vinculado
4 LIVE Teia Descobertas Públicas
Catálogo 3.2, 3.11, 30.2, 27.1 · Teia Ontology (Crime Relationship Graph) / Security & Governance / Teia Discovery RPCs
vinculado
4 LIVE Previsão Criminal LightGBM
Catálogo 2.1, 2.2, 2.5, 18.2 · Forecasting / Prediction / API Endpoints
vinculado
2 LIVE ETAS Near-Repeat Wavefront
Catálogo 7.1, 7.2 · ETAS Hotspot Detection
vinculado
1 LIVE Custo Fiscal do Crime v1
Catálogo 31.1 · B2G Municipal Finance
vinculado
8 LIVE Command Center Municipal CompStat
Catálogo 2.1, 2.2, 3.1, 3.3, 4.1, 6.1, 7.1, 20.1 · Forecasting / Prediction / Teia Ontology (Crime Relationship Graph) / HDBSCAN / Spatial Clustering / Flow / Displacement Detection / ETAS Hotspot Detection / Anomaly / Subgroup Detection
vinculado
3 LIVE ROI Municipal e Eficiencia Fiscal
Catálogo 8.1, 19.1, 22.1, 23.1 · Causal Analysis / Action Framework (B2G) / Correlation Analysis / Monitoring & Health
vinculado
4 LIVE Econometria Espacial Municipal GWR
Catálogo 1.4, 2.2, 2.4, 22.1 · Scoring System / Forecasting / Prediction / Correlation Analysis
vinculado
3 LIVE Pipeline Municipal de Anomalias
Catálogo 3.6, 20.1, 20.2 · Teia Ontology (Crime Relationship Graph) / Anomaly / Subgroup Detection
vinculado
3 LIVE Difusao Criminal Municipal Hawkes
Catálogo 3.1, 6.1, 2.4 · Teia Ontology (Crime Relationship Graph) / Flow / Displacement Detection / Forecasting / Prediction
vinculado
7 LIVE Mapa Municipal de Corredores de Crime
Catálogo 3.1, 4.1, 5.3, 6.1, 7.2, 17.3, 17.8 · Teia Ontology (Crime Relationship Graph) / HDBSCAN / Spatial Clustering / Drug Market Intelligence / Flow / Displacement Detection / ETAS Hotspot Detection / Map Overlays / Visualization (deck.gl)
vinculado
2 LIVE HDBSCAN Hotspots Locais
Catálogo 4.1, 3.13 · HDBSCAN / Spatial Clustering / Teia Ontology (Crime Relationship Graph)
vinculado
2 LIVE Teia Governance Quality Gate
Catálogo 3.11, 30.2 · Teia Ontology (Crime Relationship Graph) / Security & Governance
vinculado
1 LIVE Relatório de Endereço
Catálogo 21.1 · Address Report Pipeline
Checklist prático
Accountability antes de recomendar ação
01
Fonte e recorte
Cada sistema declara fonte, período, granularidade e camada de acesso antes de virar card público.
02
Saída e limite
Toda saída explica o que mede e o que não mede. Previsões são apoio agregado, não decisão automática.
03
Viés e sensibilidade
Features sensíveis recebem luz de risco e tratamento operacional antes de recomendação.
04
Supervisão
Mudança de peso, threshold, audience gate ou copy causal exige revisão humana rastreável.
05
Acesso
B2G, interno e público ficam separados. Endpoints e RPCs sensíveis exigem auth ou service role.
06
Pós-publicação
Build, leak audit, console/network e screenshots desktop/mobile entram no fechamento.
Registro inicial
Sistemas documentados
3 públicos 10 B2G 1 internos
Em produção
BairroSafe Score V5.10
Transformar sinais urbanos agregados em uma nota de leitura rápida para bairro, cidade e região.
Público Evidência forte Cautela operacional
- Responsável
- Produto e Dados
- Atualização
- Diária para snapshots e conforme disponibilidade das fontes oficiais.
- Exposição pública
- Exibido em páginas públicas de cidade, bairro, rankings e relatórios.
- Supervisão
- Mudanças de peso, fontes e thresholds passam por revisão técnica antes de entrar no build público.
Dados usados
- SSP quando disponivel
- IBGE
- OSM
- infraestrutura urbana
- noticias locais
- snapshots internos
Saídas
- score 0-10
- dimensões explicáveis
- faixa de confiança
- histórico por período
Limitações
- Não substitui boletins oficiais, avaliação presencial ou emergência policial.
- Bairros com baixa cobertura recebem comunicação de dados limitados.
- A nota é direcional e agregada, não uma avaliação de pessoas.
Em produção
Teia Descobertas Públicas
Promover padrões urbanos validados para explicações públicas sem expor sinais fracos ou internos.
Público Evidência forte Cautela operacional
- Responsável
- Teia Ontologia
- Atualização
- Revalidação periódica via jobs Teia e flush de lens verdicts após build.
- Exposição pública
- Exibido em descobertas, correlações e explicações de bairro quando passa nos gates.
- Supervisão
- Publicação exige audience public, evidence_grade diferente de untested e passagem pelo quality gate.
Dados usados
- teia_patterns
- teia_edges
- quality gate público
- snapshots por cidade e bairro
Saídas
- descobertas por escopo
- evidência resumida
- categoria
- confiança e suporte
Limitações
- Padrões públicos não devem ser lidos como prova causal isolada.
- O escopo publicado pode ser cidade, zona, bairro ou tipo de local, conforme suporte estatístico.
B2G em produção
Previsão Criminal LightGBM
Estimar tendência futura agregada por série de bairro/cidade para planejamento municipal.
B2G restrito Evidência moderada Alta cautela
- Responsável
- Forecasting B2G
- Atualização
- Mensal ou sob demanda após refresh do feature mart.
- Exposição pública
- Rota premium auth-gated, não anunciada em sitemap público.
- Supervisão
- Uso público direto é bloqueado; leitura passa por RPCs B2G e revisão de benchmark antes de comunicação externa.
Dados usados
- mv_feature_mart_monthly
- SSP agregado
- janelas históricas
- features urbanas por bairro
Saídas
- forecast mensal
- intervalo operacional
- ranking por cidade
- métrica de avaliação
Limitações
- Modelo não prevê indivíduo, suspeito ou evento específico.
- Acurácia é reportada com framing futuro X_T para y_T+horizon.
- Series raras ou bairros com poucos eventos podem ter erro maior.
Validação local
ETAS Near-Repeat Wavefront
Gerar hotspot H3 agregado de 24-72h com calibração Knox por categoria e decaimento espacial-temporal.
B2G restrito Evidência fraca Alta cautela
- Responsável
- Operacoes B2G
- Atualização
- Batch B2G sob demanda; fila incremental service-only por evento SSP aplicada e validada com fixture transacional.
- Exposição pública
- Endpoint privado exige login, secret B2G ou Cloudflare Access.
- Supervisão
- Execução exige TEIA_ETAS_ENABLED, chave enable-etas e confirmação B2G para escrita.
Dados usados
- v_ssp_enriched
- H3
- eventos SSP com coordenada
- teia_etas_event_queue
- artefatos dry-run salvos em disco
Saídas
- hotspot H3
- expected_events
- baseline_events
- near_repeat_wavefront_signal
- evidence_data
Limitações
- Versão local ainda não usa p-value Monte Carlo para significância Knox.
- Sinal serve para alocação agregada, não predição individual.
- Aplicação em produção exige job B2G confirmado e revisão operacional.
Validação local
Custo Fiscal do Crime v1
Traduzir volume agregado de crimes por bairro em estimativa monetária auditável para conversa fiscal.
B2G restrito Evidência fraca Cautela operacional
- Responsável
- Inteligencia Municipal
- Atualização
- Sob demanda após ingestão SSP e validação da migration.
- Exposição pública
- B2G privado, sem leitura anônima.
- Supervisão
- Endpoint é auth-gated; deploy de migration e calibração externa ainda pendentes.
Dados usados
- staging_ssp
- bairros
- cidades
- SAE/PR 2018
- proxies internos marcados por confiança
Saídas
- estimativa R$
- cobertura de precificação
- rank municipal
- metodologia_version
Limitações
- Não é contabilidade municipal oficial.
- Roubo e furto usam proxies internos até calibração por Susep, DATASUS ou fonte equivalente.
- Eventos sem preço unitário ficam explicitamente sem precificação.
B2G em produção
Command Center Municipal CompStat
Transformar sinais agregados de crime, previsao, hotspots, anomalias e recursos em pauta semanal de decisao municipal.
B2G restrito Evidência moderada Cautela operacional
- Responsável
- Operacoes B2G
- Atualização
- Semanal para reuniao CompStat, com refresh conforme novas cargas SSP, forecasts e logs operacionais.
- Exposição pública
- Painel municipal auth-gated; sem entrada em sitemap publico e sem leitura anonima de API B2G.
- Supervisão
- Secretario, analista ou operador B2G revisa pauta, responsaveis, dosagem e leitura de resultado antes de qualquer acao externa.
Dados usados
- staging_ssp
- mv_feature_mart_monthly
- teia_edges
- teia_patterns
- forecast_bairro
- logs B2G service-only
Saídas
- fila GCM
- briefing CompStat
- dosagem D+7
- revisao D+30
- evidencias por bairro
Limitações
- A fila orienta priorizacao operacional, nao ordem automatica de patrulha.
- Resultado D+30 observacional nao deve ser vendido como causalidade sem controle ou contrafactual.
- Rotina real de campo depende de logs service-only ou integracao da GCM.
Validação local
ROI Municipal e Eficiencia Fiscal
Cruzar custo fiscal estimado, carteira de acoes e despesa municipal para priorizar intervencoes com payback auditavel.
B2G restrito Evidência fraca Cautela operacional
- Responsável
- Inteligencia Municipal
- Atualização
- Mensal ou conforme fechamento SICONFI, nova SSP e revisoes de outcome.
- Exposição pública
- B2G privado; metricas monetarias detalhadas ficam fora das rotas publicas.
- Supervisão
- Autorizacao orcamentaria, execucao D+7 e revisao D+30 exigem registro humano autenticado antes de promover conclusao.
Dados usados
- ref_crime_unit_costs
- staging_ssp
- SICONFI RREO
- portfolio ROI
- b2g_roi_authorizations
- b2g_compstat_outcome_reviews
Saídas
- faixa de ROI
- payback planejado
- cobertura fiscal
- status de autorizacao
- medicao observada
Limitações
- Economia evitavel e potencial ate existir execucao de campo e nova janela observada.
- Proxies patrimoniais ficam marcados como baixa confianca ate calibracao externa.
- Comparacao SICONFI nao mede eficiencia sozinha sem entrega e outcome.
Validação local
Econometria Espacial Municipal GWR
Estimar como covariaveis urbanas variam localmente por bairro para apoiar leitura territorial e priorizacao de campo.
B2G restrito Evidência fraca Cautela operacional
- Responsável
- Modelagem Espacial B2G
- Atualização
- Sob demanda apos refresh do feature mart e rodada GWR confirmada.
- Exposição pública
- B2G auth-gated; resultados formais persistem em tabelas service-only.
- Supervisão
- Coeficientes sao apresentados como briefing tecnico; decisao operacional exige validacao local e comparacao com evidencia de campo.
Dados usados
- mv_feature_mart_monthly
- bairro_neighbors
- bairros.geom
- SSP agregado
- IBGE
- OSM
Saídas
- coeficientes locais
- beta dominante
- t-value
- R2 local
- mapa compacto por centroide
Limitações
- GWR e associacao espacial nao provam causalidade isolada.
- Run formal depende de amostra minima, bandwidth e migration service-only aplicada.
- Bairros sem vizinhanca ou centroide confiavel ficam em fallback honesto.
B2G em produção
Pipeline Municipal de Anomalias
Detectar desvios multivariados por bairro e tipo criminal para triagem humana antes de alerta operacional.
B2G restrito Evidência fraca Alta cautela
- Responsável
- Operacoes B2G
- Atualização
- Sob demanda ou rotina operacional apos refresh mensal e validacao de ruido; primeiro apply remoto validado em Guaruja.
- Exposição pública
- Interno/B2G; nenhuma lista de alerta fica disponivel anonimamente.
- Supervisão
- Operador B2G revisa alertas, taxa critica e justificativa antes de qualquer comunicacao com prefeitura.
Dados usados
- mv_feature_mart_monthly
- slice miner
- hourly breakdown
- holdout mensal salvo em disco
- b2g_anomaly_alerts
Saídas
- alertas candidatos
- score de severidade
- calibracao holdout
- alertas persistidos service-only
Limitações
- Alertas sao triagem, nao despacho automatico.
- Apply fica bloqueado quando a calibracao holdout esta ruidosa sem override humano.
- Thresholds precisam revisao por cidade e categoria criminal.
B2G em produção
Difusao Criminal Municipal Hawkes
Estimar sinal agregado de difusao bairro a bairro por categoria criminal para apoiar checagem territorial e CompStat.
B2G restrito Evidência fraca Cautela operacional
- Responsável
- Modelagem Territorial B2G
- Atualização
- Sob demanda apos refresh SSP; primeiro apply remoto validado em Guaruja com 80 arestas persistidas.
- Exposição pública
- B2G auth-gated; tabelas formais sao service-only e sem grants publicos diretos.
- Supervisão
- Analista B2G valida arestas, comunidades e bairros-gateway antes de transformar o sinal em pauta CompStat ou acao de campo.
Dados usados
- v_ssp_enriched
- bairros
- b2g_crime_diffusion_runs
- b2g_crime_diffusion_edges
Saídas
- arestas bairro a bairro
- parametros Hawkes por categoria
- comunidades Louvain
- gateway por betweenness
Limitações
- Difusao observacional nao prova causalidade entre bairros.
- Nao e previsao individual nem ordem automatica de policiamento.
- Estabilidade por janela e holdout ainda precisam revisao antes de escala multi-cidade.
Validação local
Mapa Municipal de Corredores de Crime
Identificar bairros ponte e nucleos de sinal criminal para orientar verificacao territorial de corredores.
B2G restrito Evidência fraca Cautela operacional
- Responsável
- Modelagem Territorial B2G
- Atualização
- Semanal no painel municipal, conforme novos sinais e refresh de vizinhanca.
- Exposição pública
- B2G auth-gated, sem exposicao anonima de comunidades ou gateways.
- Supervisão
- Analista B2G valida gateways e nucleos antes de transformar corredor em prioridade de patrulha ou fiscalizacao.
Dados usados
- fila GCM
- hotspots 72h
- forecasts
- teia_edges
- drug market candidates
- bairro_neighbors
- vias OSM agregadas
Saídas
- centralidade de intermediacao
- comunidades ponderadas
- arestas explicaveis
- bairro gateway
Limitações
- Corte atual e grafo de sinais por bairro, nao grafo viario segmentado por rua.
- Pontes fracas sao hipoteses para campo, nao prova de rota de deslocamento.
- Louvain/Infomap viario formal ainda depende de rede segmentada por rua.
B2G em produção
HDBSCAN Hotspots Locais
Agrupar concentrações locais por categoria para apoiar leitura territorial e priorização de patrulha.
B2G restrito Evidência moderada Cautela operacional
- Responsável
- Teia Analitica
- Atualização
- Sob demanda por cidade/categoria.
- Exposição pública
- Resumo pode aparecer publicamente apenas quando passa o quality gate.
- Supervisão
- Resultados B2G são revisados antes de virar recomendação operacional.
Dados usados
- SSP geocodificado
- categorias criminais
- coordenadas validadas
- períodos de referência
Saídas
- clusters por categoria
- centroide
- densidade
- estabilidade
- evidencia resumida
Limitações
- Clusters dependem de densidade de registros e qualidade de geocodificação.
- Hotspot não implica causalidade, apenas concentração espacial observada.
Controle ativo
Teia Governance Quality Gate
Bloquear publicação de padrões sem suporte, sem holdout ou com linguagem causal indevida.
Controle interno Evidência forte Baixa cautela
- Responsável
- Governanca Teia
- Atualização
- Executado em auditorias, builds e fluxos de promoção Teia.
- Exposição pública
- Não exibe dados crus; apenas seus efeitos aparecem em superfícies públicas.
- Supervisão
- Falhas de gate exigem correção ou justificativa documentada antes de promoção.
Dados usados
- teia_patterns
- teia_edges
- validation_data
- quality audit scripts
Saídas
- pass/fail
- blockers
- score de qualidade
- motivos de promoção
Limitações
- Controle automático reduz risco editorial, mas não substitui revisão humana em mudanças sensíveis.
- Novas famílias de padrões precisam de critérios calibrados antes de promoção pública.
Em produção
Relatório de Endereço
Combinar sinais de entorno em um resumo exportável para quem avalia um endereço específico.
Público Evidência moderada Cautela operacional
- Responsável
- Produto Plus
- Atualização
- Conforme snapshots e camadas de cidade são atualizados.
- Exposição pública
- Preview e compra pública; dados sensíveis ficam atrás de fluxo autenticado ou pago.
- Supervisão
- Templates e textos de risco passam por revisão de produto para evitar alarmismo.
Dados usados
- score de bairro
- camadas urbanas públicas
- proximidades
- alertas e histórico agregado
Saídas
- resumo de risco
- evidencias por camada
- alertas de contexto
Limitações
- A precisao depende da resolucao das fontes no entorno.
- O relatório não substitui vistoria, seguro, contrato ou diligência jurídica.
Three Lights
Classificação de features do LightGBM
Cada feature real do worker de previsão recebe uma luz de risco. A classificação não substitui auditoria, mas deixa claro o que pode ser usado com monitoramento normal, revisão reforçada ou restrição operacional.
Histórico agregado
Tendência, médias móveis, aceleração e variação do histórico criminal agregado.
Contexto espacial
Sinais de vizinhança e possível deslocamento entre bairros próximos.
Clima e ambiente
Temperatura, chuva, vento, umidade e alagamentos agregados.
Infraestrutura urbana
Comércio, escolas, câmeras, iluminação, delegacias e relatos comunitários.
Proxies socioeconômicos
Sinais sociais que exigem cautela por risco de estigmatização territorial.
Calendário
Sazonalidade, feriados e eventos públicos que alteram fluxo urbano.
Perfil da cidade
Tipo amplo de cidade usado para ajustar escala e sazonalidade.
Interações derivadas
Cruzamentos entre sinais, como noite, clima, vizinhança e território.
Identificador territorial
Codificação histórica de bairro usada apenas com restrição e auditoria.
Precisão observada
Erro por família, sem ablação inventada
O artefato local ainda não traz erro causal por família. Por isso, cada família fica vinculada ao último benchmark válido de forecast e recebe uma ação obrigatória para o próximo retreino.
- MAPE
- 89,55%
- WAPE
- 160,23%
- MAE
- 4.23
- Séries
- 2.528
crimes_total_per_1k
lgbm:all:crimes_total_per_1k:h1:20260517T181125Z:625d8541de Histórico agregado
20 features · MAPE 89,55% · WAPE 160,23%
Comparar erro por cidade e bairro a cada retreino; se WAPE ou MAPE piorar, rodar ablação de família antes de publicar nova versão.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Contexto espacial
9 features · MAPE 89,55% · WAPE 160,23%
Comparar erro por cidade e bairro a cada retreino; se WAPE ou MAPE piorar, rodar ablação de família antes de publicar nova versão.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Clima e ambiente
9 features · MAPE 89,55% · WAPE 160,23%
Manter regressão de forecast e confirmar que a família não aumenta erro fora da janela de tolerância no próximo retreino.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Infraestrutura urbana
12 features · MAPE 89,55% · WAPE 160,23%
Comparar erro por cidade e bairro a cada retreino; se WAPE ou MAPE piorar, rodar ablação de família antes de publicar nova versão.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Proxies socioeconômicos
4 features · MAPE 89,55% · WAPE 160,23%
Manter uso somente B2G agregado, abrir ablação holdout por família antes de promover narrativa externa e exigir aprovação humana para ação operacional.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Calendário
12 features · MAPE 89,55% · WAPE 160,23%
Comparar erro por cidade e bairro a cada retreino; se WAPE ou MAPE piorar, rodar ablação de família antes de publicar nova versão.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Perfil da cidade
4 features · MAPE 89,55% · WAPE 160,23%
Manter regressão de forecast e confirmar que a família não aumenta erro fora da janela de tolerância no próximo retreino.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Interações derivadas
5 features · MAPE 89,55% · WAPE 160,23%
Manter uso somente B2G agregado, abrir ablação holdout por família antes de promover narrativa externa e exigir aprovação humana para ação operacional.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Identificador territorial
1 features · MAPE 89,55% · WAPE 160,23%
Manter uso somente B2G agregado, abrir ablação holdout por família antes de promover narrativa externa e exigir aprovação humana para ação operacional.
Sem artefato de ablação causal por família neste repo; este monitor vincula cada família ao benchmark observado válido e define a próxima checagem obrigatória.Model card
Model card operacional: Previsão Criminal LightGBM
Release aceito somente como apoio B2G agregado, com restrição de features sensíveis e aprovação humana.
- Família
- LightGBM global mensal por bairro/cidade
- Superfície
- Painel B2G e RPCs autenticadas de forecast
- Framing
- X_T -> y_T+horizon, com alvo futuro separado do observado.
- Limite
- Apoio agregado para planejamento municipal e priorização de revisão humana.
- Uso proibido
- Proibido usar para identificar indivíduo, suspeito, abordagem ou evento específico.
- Aprovação
- Features vermelhas exigem aprovação operacional antes de recomendação ou narrativa externa.
- Monitoramento
- Revisão a cada retreino, build público relevante ou mudança no worker de forecasting.
28 verdes 43 amarelas 5 vermelhas
Passou
Inventário do worker
76 features LightGBM classificadas em verde, amarelo ou vermelho.
Manter teste de cobertura contra o worker Python antes de cada release. Revisar
Restrição de features vermelhas
5 features em famílias sensíveis: Proxies socioeconômicos, Interações derivadas, Identificador territorial.
Uso somente B2G agregado, sem explicação pública direta e com aprovação humana antes de ação operacional. Revisar
Monitoramento de features amarelas
43 features exigem revisão de erro por cidade, bairro ou família.
Publicar benchmark por cidade e registrar desvio relevante depois de retreino. Passou
Limite de decisão humana
O modelo gera sinal agregado de planejamento; não aponta pessoa, suspeito ou evento específico.
Manter copy e endpoints alinhados: previsão e apoio a despacho, nunca decisão automática. Revisar
Erro observado por família
9 famílias vinculadas ao benchmark válido lgbm:all:crimes_total_per_1k:h1:20260517T181125Z:625d8541de: MAPE 89.55%, WAPE 160.23%.
Substituir este baseline por ablação holdout por família quando o próximo artefato de treino trouxer erro family-drop. Revisar
Contrato de ablação family-drop
0/9 famílias têm ablação family-drop; o relatório permanece no benchmark global. Artefato esperado: .codex/three-lights-family-drop-ablation/latest.json.
Gerar artefato family-drop por família no próximo treino antes de declarar precisão isolada por família.Ver tabela completa de features classificadas 76 features
| Feature | Luz | Família | Tratamento |
|---|---|---|---|
lag1 | Amarelo | Histórico agregado | Comparar erro por cidade e bairro; nunca comunicar como previsao de pessoa ou evento especifico. |
lag2 | Amarelo | Histórico agregado | Comparar erro por cidade e bairro; nunca comunicar como previsao de pessoa ou evento especifico. |
lag3 | Amarelo | Histórico agregado | Comparar erro por cidade e bairro; nunca comunicar como previsao de pessoa ou evento especifico. |
lag6 | Amarelo | Histórico agregado | Comparar erro por cidade e bairro; nunca comunicar como previsao de pessoa ou evento especifico. |
lag12 | Amarelo | Histórico agregado | Comparar erro por cidade e bairro; nunca comunicar como previsao de pessoa ou evento especifico. |
crimes_lag1 | Amarelo | Histórico agregado | Usar apenas em agregado territorial e manter intervalos de confianca na comunicacao. |
crimes_lag3 | Amarelo | Histórico agregado | Usar apenas em agregado territorial e manter intervalos de confianca na comunicacao. |
crimes_lag12 | Amarelo | Histórico agregado | Usar apenas em agregado territorial e manter intervalos de confianca na comunicacao. |
ma3 | Amarelo | Histórico agregado | Auditar contra baseline sazonal e nao usar isoladamente para acao operacional. |
ma6 | Amarelo | Histórico agregado | Auditar contra baseline sazonal e nao usar isoladamente para acao operacional. |
ma12 | Amarelo | Histórico agregado | Auditar contra baseline sazonal e nao usar isoladamente para acao operacional. |
std6 | Amarelo | Histórico agregado | Usar com volume minimo e sinalizar baixa confianca em series raras. |
diff_1 | Amarelo | Histórico agregado | Exigir leitura com janela historica e volume minimo. |
diff_12 | Amarelo | Histórico agregado | Comparar com cidade e vizinhos antes de virar recomendacao. |
neighbor_crimes_avg | Amarelo | Contexto espacial | Mostrar como contexto agregado e revisar antes de recomendar patrulha. |
neighbor_crimes_per_1k_avg | Amarelo | Contexto espacial | Mostrar como contexto agregado e revisar antes de recomendar patrulha. |
n_neighbors | Verde | Contexto espacial | Monitoramento normal e documentacao de fonte geografica. |
neighbor_crimes_diff_1 | Amarelo | Contexto espacial | Usar com evidencias complementares e revisao humana. |
neighbor_anomaly_drop | Amarelo | Contexto espacial | Exigir leitura com mapas e janela temporal antes de acao. |
influence_in_total | Amarelo | Contexto espacial | Usar como contexto agregado da rede territorial; nunca como rota individual. |
influence_out_total | Amarelo | Contexto espacial | Comunicar apenas como hipotese analitica da rede, com revisao local. |
influence_pressure | Amarelo | Contexto espacial | Revisar calibracao do diffusion run antes de usar em comunicacao. |
momentum_score | Amarelo | Histórico agregado | Limitar a planejamento agregado e comparar com intervalo de confianca. |
acceleration | Amarelo | Histórico agregado | Combinar com volume minimo e revisao humana. |
avg_precipitation_mm | Verde | Clima e ambiente | Monitoramento normal e fonte meteorologica documentada. |
total_precipitation_mm | Verde | Clima e ambiente | Monitoramento normal e fonte meteorologica documentada. |
avg_temp_avg | Verde | Clima e ambiente | Monitoramento normal e fonte meteorologica documentada. |
avg_temp_max | Verde | Clima e ambiente | Monitoramento normal e fonte meteorologica documentada. |
days_heavy_rain | Verde | Clima e ambiente | Monitoramento normal e fonte meteorologica documentada. |
avg_humidity_pct | Verde | Clima e ambiente | Monitoramento normal e fonte meteorologica documentada. |
avg_wind_kmh | Verde | Clima e ambiente | Monitoramento normal e fonte meteorologica documentada. |
flood_events_count | Verde | Clima e ambiente | Monitoramento normal com fonte e periodo visiveis. |
flood_area_km2 | Verde | Clima e ambiente | Monitoramento normal com fonte e periodo visiveis. |
crowd_reports_total | Amarelo | Infraestrutura urbana | Nunca usar como prova isolada; exigir volume minimo e anonimato. |
crowd_assalto | Amarelo | Infraestrutura urbana | Usar como sinal complementar com volume minimo e anonimato. |
comercios | Amarelo | Infraestrutura urbana | Usar para contexto de fluxo urbano, nao para estigmatizar bairro. |
delegacias | Amarelo | Infraestrutura urbana | Interpretar como contexto institucional e revisar efeitos de enforcement. |
comercio_noturno | Amarelo | Infraestrutura urbana | Usar com tipo de crime e horario, nao como julgamento de bairro. |
nightlife_amenities | Amarelo | Infraestrutura urbana | Usar com horario e categorias de ocorrencia. |
escolas | Verde | Infraestrutura urbana | Monitoramento normal e fonte geoespacial documentada. |
cameras | Amarelo | Infraestrutura urbana | Usar para cobertura e capacidade operacional, nao como proxy direto de risco. |
bars_per_km2 | Amarelo | Infraestrutura urbana | Usar com horario/categoria e evitar linguagem causal isolada. |
escolas_per_km2 | Verde | Infraestrutura urbana | Monitoramento normal e fonte geoespacial documentada. |
cameras_per_km2 | Amarelo | Infraestrutura urbana | Usar para cobertura operacional e revisar por cidade. |
lighting_proxy_per_km2 | Amarelo | Infraestrutura urbana | Usar para priorizar zeladoria, nao para rotular moradores. |
renda_media | Vermelho | Proxies socioeconômicos | Uso restrito a ajuste de contexto; revisar impacto antes de recomendacao operacional. |
escolaridade_media | Vermelho | Proxies socioeconômicos | Uso restrito a ajuste de contexto; revisar impacto antes de recomendacao operacional. |
densidade_demografica | Amarelo | Proxies socioeconômicos | Normalizar por populacao e revisar erro por porte de bairro. |
pct_favela | Vermelho | Proxies socioeconômicos | Uso restrito e revisado; nunca comunicar como causa direta de crime. |
has_saidinha | Amarelo | Calendário | Usar como marcador temporal agregado, sem associar a individuos. |
has_carnaval | Verde | Calendário | Monitoramento normal com periodo documentado. |
has_fim_de_ano | Verde | Calendário | Monitoramento normal com periodo documentado. |
has_ferias_escolares | Verde | Calendário | Monitoramento normal com periodo documentado. |
n_feriados | Verde | Calendário | Monitoramento normal com periodo documentado. |
max_event_impact_pct | Amarelo | Calendário | Revalidar por cidade e evitar causalidade isolada. |
bars_x_noturno_lag1 | Amarelo | Interações derivadas | Usar apenas em agregado e revisar linguagem operacional. |
temp_x_noturno_lag1 | Verde | Interações derivadas | Monitoramento normal e validacao de erro. |
rain_x_violencia_lag1 | Verde | Interações derivadas | Monitoramento normal e validacao de erro. |
favela_x_crime_rate | Vermelho | Interações derivadas | Uso restrito; exigir revisao humana e nao publicar como explicacao direta. |
cidade_type_capital | Verde | Perfil da cidade | Monitoramento normal. |
cidade_type_litoral | Verde | Perfil da cidade | Monitoramento normal. |
cidade_type_metropolitana | Verde | Perfil da cidade | Monitoramento normal. |
cidade_type_interior | Verde | Perfil da cidade | Monitoramento normal. |
lag_ratio_12 | Amarelo | Histórico agregado | Usar com volume minimo e monitoramento de erro. |
lag_ratio_6 | Amarelo | Histórico agregado | Usar com volume minimo e monitoramento de erro. |
lag_ratio_3 | Amarelo | Histórico agregado | Usar com volume minimo e monitoramento de erro. |
bairro_target_enc | Vermelho | Identificador territorial | Uso restrito, com shrinkage, auditoria de erro e proibicao de explicacao publica direta. |
cv6 | Amarelo | Histórico agregado | Sinalizar baixa confianca em series raras. |
spatial_momentum | Amarelo | Contexto espacial | Revisar com mapa e evidencias complementares. |
neighbor_x_season | Amarelo | Interações derivadas | Revisar por cidade e usar apenas em agregado. |
month_sin | Verde | Calendário | Monitoramento normal. |
month_cos | Verde | Calendário | Monitoramento normal. |
month_sin2 | Verde | Calendário | Monitoramento normal. |
month_cos2 | Verde | Calendário | Monitoramento normal. |
month_sin3 | Verde | Calendário | Monitoramento normal. |
month_cos3 | Verde | Calendário | Monitoramento normal. |
Governança prática
Registro feito para decisão municipal brasileira
O padrão aqui é operacional: fonte visível, limitação escrita, audiência definida, revisão humana e trilha de auditoria. O objetivo é permitir que uma prefeitura use o painel em reuniões e despachos sem transformar sinal estatístico em decisão automática.
- Dados agregados por território, sem identificação de pessoas.
- Uso B2G separado de superfícies públicas e linguagem sem causalidade indevida.
- Features sensíveis marcadas para revisão antes de recomendação operacional.