PangoFlow: uma extensão de navegador para transformar progresso em blocos visíveis
em desenvolvimento ativo
O PangoFlow é uma extensão de navegador (Manifest V3) escrita em ClojureScript para acompanhar hábitos de autodesenvolvimento. A ideia é fugir da lógica frágil de "streaks": cada esforço vira um Block, e os blocos acumulados formam um heatmap de contribuição que torna o progresso visível ao longo do tempo. O popup serve para captura rápida no momento; o dashboard é para revisar e configurar.
Por que este projeto é interessante
Mais do que uma extensão, o PangoFlow é um exercício deliberado de design de domínio. Antes do código, defini uma linguagem ubíqua e um PRD de MVP, e a arquitetura foi montada para manter as regras de negócio isoladas da UI e do navegador, testáveis em ClojureScript puro.
Design & Decisões
- Linguagem ubíqua documentada: um glossário de domínio fixa os termos do produto (Activity, Entry, Block, Flow, Focus Session, Target) e lista os termos a evitar, mantendo código, UI e docs falando a mesma língua.
-
Domínio separado da UI: os módulos de
activity,entry,block-ruleecategorynão sabem que existe React, popup ou navegador. A UI apenas consome esses módulos. -
Block Rule como módulo profundo: uma API pequena (
entry->blocks) esconde a conversão de esforço em blocos para os três modos de medição (completion, count, duration), com blocos fracionários internos e blocos inteiros na interface. - Local-first: o histórico local é a fonte da verdade (sem conta, sem nuvem), com export/import validado e versionamento pronto para migração.
- Templates de atividade: presets (leitura, meditação, exercício, código, escrita) já trazem modo de medição, regra de blocos, cor de destaque e categoria sugeridos.
-
Consciência da plataforma: o build lida com a restrição de CSP do Manifest V3 (sem
unsafe-eval), usando release bundles do shadow-cljs em vez dos bundles de dev.
Disciplina de Testes
Cada módulo de domínio tem seu arquivo de teste correspondente. Os testes verificam comportamento pelas interfaces estáveis (dadas atividades, entries e regras, o sistema devolve os blocos, totais diários e células de heatmap esperados), sem depender de helpers privados ou de detalhes de implementação da UI.
Stack
- ClojureScript
- shadow-cljs
- Extensão de navegador (Manifest V3, Chromium)
- Armazenamento local da extensão (local-first)