Kero Ótica

ERP especializado para o mercado óptico, em produção há aproximadamente cinco anos.

Utilizado por aproximadamente 500 empresas e crítico para a operação diária das óticas.

Ambiente multi-tenant com usuários concorrentes.

Escopo funcional conhecido: módulos financeiros, fiscais, PDV, estoque, dashboards e integrações bancárias.

A modernização do frontend ainda está em andamento.

O frontend legado foi construído com Vue 2, Nuxt 2 e Vuetify 2.

O código apresentava alto acoplamento, componentes monolíticos e baixa separação de responsabilidades.

Essas características dificultavam a evolução do produto à medida que o domínio crescia.

Não havia gerenciamento explícito da complexidade em um sistema que continua expandindo módulos e integrações.

Consequência de não agir: o custo de mudança tenderia a aumentar, a evolução de módulos críticos ficaria mais lenta e o risco operacional associado a alterações no frontend cresceria em um sistema já em produção.

A arquitetura-alvo foi definida para suportar evolução incremental, permitindo modernizar o frontend sem exigir interrupção total do sistema em produção.

A escolha de React + Next.js estabelece a base tecnológica do novo frontend; a estratégia de migração gradual define como essa base coexiste com o legado Vue 2 / Nuxt 2 / Vuetify 2 ao longo do tempo.

O raciocínio arquitetural prioriza fronteiras que reduzam acoplamento e permitam gerenciar complexidade à medida que módulos e integrações continuam a crescer.

Condução da pesquisa técnica e comparação de alternativas.

Produção de documentação técnica, RFCs e diretrizes para alinhar decisões.

Definição e comunicação da estratégia de modernização orientada a evolução incremental.

Apoio contínuo a decisões técnicas da equipe durante a execução.

Em sistemas críticos em produção, a estratégia de modernização deve ser condicionada pela continuidade operacional — evidenciado pela escolha de migração gradual em vez de reescrita.

Governança, observabilidade e longevidade podem ser critérios explícitos de arquitetura, não apenas atributos desejáveis a posteriori.

Documentação técnica (RFCs e diretrizes) faz parte da condução da decisão, não é apêndice da implementação.