← Voltar ao portfólio
Sprint 3 · Data Engineering + NOC Analytics

TelecomPulse Analytics

Plataforma de analytics concebida para transformar eventos operacionais de conectividade em indicadores rastreáveis de disponibilidade, SLA, incidentes, reincidência e desempenho por operadora e unidade.

Python 3.13PandasPytestContratos JSON/CSVReact + TypeScriptVite
HomologadoSprints 0–2Fundação, dados, qualidade e contratos analíticos
Em homologaçãoSprint 3Dashboard implementado · PR #4 · CI verde
Ainda não executadoDeploy públicoCloudflare permanece previsto para a Sprint 5
01 · Contexto

Dados de NOC existem. Respostas confiáveis nem sempre.

Planilhas, ITSM, monitoramento e controles manuais fragmentam o histórico e dificultam transformar eventos em decisão operacional.

Problema

Visibilidade dispersa.

Sem uma camada analítica comum, perguntas simples exigem consolidação manual: onde a indisponibilidade se concentra, quais links reincidem, qual operadora acumula maior impacto e quanto tempo a operação leva para restaurar o serviço.

Proposta

Rastreabilidade antes do dashboard.

O projeto organiza ingestão, validação, normalização, métricas e datasets de apresentação antes de construir a interface. O dashboard consome saídas processadas e não redefine silenciosamente os KPIs no navegador.

02 · Perguntas do MVP

O produto nasce das decisões que precisa apoiar.

O escopo foi limitado a perguntas operacionais verificáveis, sem machine learning, tempo real ou infraestrutura distribuída prematura.

01DisponibilidadePor período, unidade e operadora.
02IncidentesVolume, duração e evolução temporal.
03MTTRTempo médio de restauração.
04ReincidênciaSites, links e operadoras recorrentes.
05CausasConcentração de indisponibilidade.
06QualidadeRegistros inválidos, nulos e duplicados.
03 · Arquitetura implementada

Pipeline e contratos primeiro. Dashboard sem lógica analítica escondida.

Python e Pandas calculam os KPIs e geram contratos JSON/CSV versionados; o React consome esses artefatos sem recalcular métricas críticas. A publicação Cloudflare continua fora do estado atual.

Arquitetura-alvo do TelecomPulse: dados sintéticos, Python e Pandas, validação, KPIs, JSON e CSV, React e Vite, build estático e Cloudflare
Arquitetura por camadas. Pipeline, validação, KPIs, contratos e dashboard React/Vite já possuem implementação verificável. Apenas a etapa Cloudflare continua planejada.
Dados públicos seguros

Sintético por padrão

O MVP usa dados sintéticos e reproduzíveis. Nenhum dado corporativo, pessoal ou identificador operacional sensível deve entrar no repositório público.

Separação de responsabilidades

KPIs fora da UI

Regras como downtime, MTTR, disponibilidade e recorrência pertencem à camada analítica. A interface apresenta, filtra e explica — não altera a definição das métricas.

Complexidade sob demanda

Sem API no MVP

Workers, D1 ou outro backend em runtime só entram se volume, atualização frequente, autenticação ou consultas server-side justificarem a mudança.

04 · Implementação verificável

Três sprints homologadas e um dashboard pronto para decisão humana.

As Sprints 0, 1 e 2 estão na branch principal. A Sprint 3 está implementada em branch dedicada, passou no CI e aguarda homologação visual e autorização de merge.

Sprint 1 · Dados confiáveis

Qualidade testada.

Contrato versionado, gerador sintético, normalização determinística, rejeição de duplicidades e inconsistências temporais, relatório de qualidade e cálculo de disponibilidade sem dupla contagem.

Sprint 2 · Analytics

Contrato dashboard v1.

Visão geral, rankings por operadora, unidade e causa, timeline, detalhe serializável e seis artefatos JSON/CSV reconciliados. A disponibilidade usa site-time com união de intervalos sobrepostos.

Sprint 3 · Produto

Dashboard React.

Cards executivos, evolução temporal, rankings, filtros de detalhe, tabela de incidentes e estados loading, error e empty, com responsividade e sem mover KPIs críticos para o navegador.

✓15 testesPytest verde na base analítica homologada da Sprint 2.
✓CI Sprint 3Ruff, pipeline, seis artefatos, TypeScript e Vite build passaram.
→Gate humanoDireção visual, cards, rankings, filtros, tabela e merge ainda dependem de aprovação.
05 · Contrato de dados

O incidente precisa ser auditável.

O modelo mínimo combina identificação técnica, dimensão operacional, tempo, causa e origem do registro.

GrupoCamposRegra principal
Identidadeincident_id, site_idID técnico único e site anonimizado.
Operaçãocarrier, status, cause_categoryDimensões normalizadas e status controlado.
Tempoopened_at, restored_atResolvidos exigem restauração posterior à abertura.
Segmentaçãoregion, link_typePermite análise geográfica e tecnológica.
RastreabilidadesourceOrigem explícita; dataset público identificado como sintético.
06 · Governança

Evidência antes de narrativa.

O projeto adota uma ordem explícita para reduzir decisões invisíveis e impedir que uma demo visual seja confundida com produto homologado.

01 · NormasEscopo, risco e critérios de aceite.
02 · BaselineEstado anterior e validadores aplicáveis.
03 · ImplementaçãoMudança pequena e rastreável.
04 · RevalidaçãoLint, testes, build e segurança.
05 · ReviewEvidências, regressões e documentação.
Regra de publicação

Cloudflare não significa “já publicado”.

O ambiente foi criado, mas integração, build reproduzível, URL pública, smoke test e rollback ainda precisam ser validados. O deploy só pertence à Sprint 5 e exige autorização explícita.

07 · Roadmap

Seis gates até o MVP público.

O avanço depende de qualidade e evidência, não apenas de calendário.

  1. Sprint 0 · HomologadaFundação governadaStack, schema, pipeline mínimo, testes, lint, frontend e CI.
  2. Sprint 1 · HomologadaDados e qualidadeIngestão, regras, normalização, relatório de qualidade e KPIs testados.
  3. Sprint 2 · HomologadaCamada analíticaAgregações, séries temporais e contratos do dashboard.
  4. Sprint 3 · Em homologaçãoDashboard MVPVisão executiva, filtros, análises e estados de interface implementados.
  5. Sprint 4Qualidade de produtoTestes frontend, UX, acessibilidade, performance e homologação.
  6. Sprint 5Cloudflare e releaseDeploy autorizado, smoke test, evidência, rollback e tag.
Papel no projeto

Produto + dados + engenharia.

O case reúne definição do problema, arquitetura, contrato de dados, pipeline, metodologia de KPIs, frontend e governança de entrega. Essa combinação conecta experiência operacional de NOC com construção de produto analítico.

Critério de sucesso

Reproduzível por terceiros.

O MVP só será concluído quando pipeline, fórmulas, testes, contratos, build, segurança, documentação e homologação pública puderem ser verificados a partir do repositório.

Evidências e próximos passos

Do CSV sintético a um dashboard analítico navegável.

O estado atual comprova pipeline de dados, regras de qualidade, métricas documentadas, contratos de apresentação e dashboard React buildável. O próximo gate é a homologação humana da Sprint 3; deploy público, auditoria UX aprofundada e hardening permanecem fora desta entrega.