1. Contexto & O Problema Real
A astrologia védica tradicional (Jyotisha) carrega uma das maiores densidades informacionais do mundo dos sistemas de dados: graus, minutos e segundos de arco zodiacal, 27 nakshatras, dignidades planetárias (exaltação, debilitação, mulatrikona), 12 casas de Bhava e complexos períodos preditivos temporais (Vimshottari Dasha).
No entanto, praticamente todos os softwares existentes nesse nicho foram desenvolvidos nos anos 1990 e início dos anos 2000. O cenário encontrado pelos praticantes e estudiosos é desolador: interfaces caóticas em cinza-chumbo, tabelas superpovoadas sem hierarquia visual e absoluta falta de ergonomia para telas sensíveis ao toque em smartphones.
O desafio estratégico foi conceber e programar uma experiência web moderna, rápida e visualmente serena em português, transformando cálculos astronômicos rigorosos em uma ferramenta de consulta fluida e intuitiva.
2. Restrições & Desafios Técnicos
Diferente de um website institucional estático, um motor de cálculo astrológico impõe restrições severas de computação e renderização gráfica:
- Computação no Cliente (Client-Side Edge): As posições planetárias dependem de algoritmos de efemérides densos. Transferir cada recálculo para uma API de servidor geraria latência inaceitável. O motor precisava rodar localmente no dispositivo em menos de 100ms.
-
Operação Offline-First Rigorosa: O aplicativo precisava funcionar plenamente em retiros, templos e viagens com sinal móvel nulo ou intermitente, exigindo estratégias de cache via Workbox Service Workers (
NetworkFirstcom persistência JSON). - Ergonomia Tátil Estrita: Alvos de toque com dimensão mínima de 44×44px e zonas de controle acessíveis ao polegar na porção inferior da tela do smartphone.
3. Decisões Críticas & Concessões (Trade-Offs)
Projetar para alta densidade exige escolhas arquiteturais deliberadas entre sobrecarga visual e facilidade de descoberta:
Decisão 01: Revelação Progressiva vs. Sobrecarga de Tabelas
A hipótese tradicional: Softwares legados despejam 15 tabelas simultâneas de uma vez sob o pretexto de "completude analítica". Em testes de usabilidade, isso causava paralisia de decisão e estresse visual imediato.
A decisão final: Adotamos o princípio de Revelação Progressiva (Progressive Disclosure). O mapa central Kundali exibe inicialmente apenas os ascendentes e planetas em suas casas; aspectos profundos (Drishtis), divisões de Navamsha (D9) e períodos Dasha expandem-se sob demanda ao toque, reduzindo a carga cognitiva sem omitir dados essenciais.
Decisão 02: SVG Semântico Dinâmico vs. Canvas 2D
Optar por Canvas 2D facilitaria a renderização rápida de linhas geométricas, porém tornaria a interface completamente inacessível a leitores de tela e causaria perda de nitidez gráfica ao redimensionar em displays Retina. Descartamos o Canvas em favor de SVG paramétrico gerado via componentes React com semântica ARIA completa.
4. A Solução & Design System (@astryxdesign/core)
Para assegurar consistência visual e velocidade de evolução, formalizei o sistema de design proprietário @astryxdesign/core, regido por tokens estritos exportados diretamente do Figma para código:
- Paleta Índigo Cósmico & Âmbar Védico: Tons profundos de alto contraste combinados com fundos claros equilibrados, proporcionando excelente legibilidade diurna e noturna em conformidade com as diretrizes WCAG AAA.
-
Sanitização Semântica em Python: Criação de utilitários de validação (
jyotisha_sanitizer.py) para auditar termos em sânscrito transliterado e eliminar ambiguidades conceituais nos textos interpretativos.
5. Resultados & Validação Técnica
O aplicativo foi auditado em ambiente de produção com medições automatizadas de desempenho e testes com astrólogos profissionais:
6. Retrospectiva & Transparência de Ferramentas
O que eu faria diferente hoje: Teria estruturado testes visuais de regressão automatizados para os diagramas SVG mais cedo no pipeline de integração contínua (CI), o que teria economizado iterações manuais em geometrias complexas de casas angulares.
- React 19, TypeScript & Vite: Arquitetura modular e prototipagem interativa direta em código vivo com Service Workers via Workbox.
- Python: Automação de testes de integridade de dados e validação de regras astronômicas.
- Claude 3.5 & Antigravity: Utilizados como aceleradores na geração de testes unitários para matrizes astronômicas e suporte à documentação de tokens. Todas as decisões de interface, arquitetura de informação e ergonomia visual foram criadas e homologadas por mim.