Case: pwE — Pray With Me

†

Portal Técnico Interativo pwE

Explore a fundo a engenharia do aplicativo com diagramas do modelo C4, fluxos de sequência, logs de refatoração, ADRs e um console interativo de API (Playground Swagger).

Acessar Documentação Interativa →

O pwE (Pray With Me) é um companheiro digital e santuário privativo para a prática da Lectio Divina (Leitura Orante), concebido sob os mais rigorosos padrões da Doutrina Católica e do Cânon Bíblico dos 73 livros. O projeto é minha principal vitrine de engenharia de software avançada: um aplicativo Flutter que reúne Clean Architecture modular, Inteligência Artificial On-Device (Gemma 4 via LiteRT-LM), Dual AI com RAG On-Device (TFLite/MiniLM), Segurança Zero-Knowledge (AES-256-GCM), ingestão oficial da CNBB via Cloud Run Jobs no GCP e uma governança técnica de alta maturidade sustentada por um comitê de 16 subagentes assíncronos do Google Antigravity e 34 ADRs formais.

Arquitetura & Engenharia de Software

  • Clean Architecture + DDD Modular: Isolamento estrito entre Core agnóstico, camada de Domínio pura (livre de dependências de UI, Flutter ou Firebase), DataSources e Camada de Apresentação. Cada feature (lectio_divina, auth, profile, preferences, security_vault, subscription) gerencia seu próprio contêiner isolado de injeção de dependência (GetIt), impedindo vazamento de escopo e acoplamento desnecessário (ADR 0004 e ADR 0032).
  • Decomposição do God BLoC (ADR 0015): Superação de um BLoC monolítico inicial através da divisão em 6 sub-BLoCs altamente coesos e desacoplados: LectioSessionBloc, DailyLiturgyBloc, ExegesisBloc, PrayerJournalBloc, AiOratioBloc e SubscriptionBloc. Cada um opera com estados e eventos imutáveis via Equatable, eliminando concorrência de UI e facilitando testes isolados.
  • Governança Multiagente & Antigravity (ADR 0034): O ciclo contínuo de engenharia é governado por um comitê de 16 agentes especialistas de IA distribuídos em 4 pilares estratégicos (Governança/FinOps/Doutrina, Engenharia Core/Dados/IA, Interface/Plataforma/Ritmo Orante e Qualidade/DevOps). Todos foram implementados como subagentes assíncronos nativos do Google Antigravity (.agents/agents/) com schemas YAML padronizados, controle de permissões e monitoramento concorrente.
  • Roteamento Reativo & Blindagem de Ciclo de Vida: Utilização de GoRouter com 14 rotas sacras tipadas, auth_redirect reativo prevenindo desvios prematuros no cold start e proteção da experiência de primeiro uso (FTUE) nas rotas /onboarding e /profile_setup.
  • Tratamento Funcional de Erros: Adoção estrita de programação funcional com dartz (Either<Failure, Success>), garantindo que nenhuma exceção silenciosa ou inesperada quebre o fluxo de oração.

Inteligência Artificial & Machine Learning (Edge-First)

O diferencial técnico central do pwE é a sua estratégia de IA híbrida com privacidade por design:

  • Gemma 4 E2B (On-Device via LiteRT-LM): Inferência local no smartphone através da engine LiteRT-LM com plugin nativo Android em Kotlin, acelerada por GPU/NPU via MethodChannel e protegida por mutex de concorrência de memória (ADR 0005). O modelo é instalado via download opt-in com verificação criptográfica SHA256.
  • Dual AI & RAG On-Device: Sistema de memória espiritual de longo prazo que recupera sentimentos, meditações e orações passadas para contextualizar os prompts pastorais. A vetorização é 100% realizada no smartphone via TFLite com o modelo all-MiniLM-L6-v2 (384 dimensões), tokenização WordPiece nativa (BertTokenManager) e Mean Pooling adaptativo — sem que nenhuma anotação de fé saia do dispositivo.
  • Escadaria Gemini na Nuvem (Fallback Resiliente): Integração com a família Gemini (padrão gemini-3.5-flash-lite, parametrizado dinamicamente via Firebase Remote Config) com Smart Retry (backoff exponencial com jitter) e Cache de Sessão no BLoC para evitar chamadas redundantes.
  • Transparência & Consentimento Explícito (ADRs 0025 e 0033): O usuário tem soberania total sobre seus dados. A interface exibe claramente a origem do processamento via Escudo Dourado (inferência 100% local) ou nuvem com consentimento prévio, permitindo ainda a escolha da Lectio Divina puramente contemplativa sem nenhum uso de IA.
  • Fading Scaffolding: Sistema de maturidade adaptativa em que a IA reduz progressivamente sua verbosidade conforme a constância espiritual do fiel (Beginner → Practitioner → Contemplative), diminuindo o "andaime" tecnológico para valorizar o silêncio interior.
  • OCR Guiado: Digitalização de páginas físicas da Bíblia com Google ML Kit Vision, dotado de binarização adaptativa prévia por Canvas e correção lexical para eliminar ruídos de sombra e textura do papel.

Segurança Zero-Knowledge & Caderno Espiritual

  • Criptografia em Repouso AES-256-GCM (ADR 0029): As anotações do diário de oração, exegeses salvas e resoluções espirituais no Caderno Espiritual são criptografadas em repouso no banco local Hive com algoritmo AES-256-GCM, vetor de inicialização (IV) aleatório e chave derivada via PBKDF2.
  • Ancoragem em Hardware: Chaves protegidas no Android Keystore e iOS Keychain, garantindo que nem mesmo backups de sistema ou acessos físicos desautorizados exponham a intimidade do fiel.
  • Cofre de Chaves e Senha Opcional (ADR 0026 & ADR 0032): Feature isolada security_vault permitindo ao usuário definir uma senha extra para o cofre, oferecendo camadas adicionais de blindagem.

Infraestrutura Cloud, Ingestão & Dados

  • Worker Litúrgico no GCP (Cloud Run Jobs): Ingestão automatizada de liturgia executada em Cloud Run Jobs e acionada por Cloud Scheduler, consumindo diretamente a API oficial da CNBB com fallback resiliente para Canção Nova e sanitização canônica de versículos.
  • As 7 Gotas de Sabedoria: O pipeline litúrgico pré-computa e armazena no Firestore reflexões bíblicas profundas sob 7 lentes da Tradição da Igreja: histórica, social, filológica, patrística, magistério, teológica e ascética.
  • Monetização Ética (Benfeitores): Gestão de assinaturas via RevenueCat SDK, com período gratuito de acolhida de 7 dias, total transparência e zero exibição de anúncios intrusivos (ADR 0009 e ADR 0017).
  • CI/CD Automatizado: Pipelines robustos em GitHub Actions cobrindo análise estática rigorosa (dart analyze), gate de cobertura mínima de 70% e distribuição automatizada para Android e iOS.

Qualidade & Métricas Consolidadas

  • 931 testes automatizados (unitários, de widget, golden tests e testes de acessibilidade tipográfica com escalonamento 1.15x) distribuídos em 193 suítes de teste (*_test.dart), superando 80% de cobertura no core.
  • 34 ADRs formais documentando desde a gerência de estado e estratégia Edge LLM até a segurança de caixas Hive, desacoplamento de BLoCs e arquitetura de subagentes.
  • 77+ releases registradas no CHANGELOG canônico, adotando Semantic Versioning e rastreabilidade total de PRs e commits.
  • Comitê de 16 subagentes assíncronos mantendo a integridade doutrinária, estabilidade arquitetural e conformidade com as diretrizes das lojas Google Play e Apple App Store.

UX & Design System Sacro

  • Design System Sacro (Pergaminho Nobre / Shalom): Identidade visual solene inspirada na Tradição e no carisma Shalom, empregando paleta SacredThemeColors, tipografia clássica Cinzel e Lora, divisores ornamentais sacros (CrossOrnamentalDivider) e microinterações táteis como o HoldToSaveButton (2 segundos contínuos para salvar a oração).
  • Acessibilidade Universal (a11y): Testado e validado contra quebras de layout em dispositivos compactos sob escalonamento de fontes de acessibilidade (textScaler >= 1.15x), garantindo inclusão e conforto visual para idosos e fiéis com baixa visão.
  • Internacionalização: Seletor de datas litúrgicas com suporte a 18 idiomas de interface e liturgia pré-computada em 7 idiomas canônicos.

Status: Versão 0.9.77+103 — Sprint Store Readiness & Subagentes Antigravity ativos. 931 testes automatizados, 34 ADRs formais e preparação para o marco v1.0.0 (Outubro 2026).

← Voltar ao Portfólio