⚡ Tech
AI
App Development
React Native
Expo

Aplicativo interno da Optagonen: por que eu o criei

Por dentro do aplicativo de oficina da Optagonen para iPhone e Android: por que eu o criei, como ele se conecta ao nosso negócio e o que Fable e Codex ajudaram a entregar.

Uygar DuzgunUUygar Duzgun
Nov 14, 2026
Atualizado 16 de nov. de 2026
13 min read
Aplicativo interno da Optagonen: por que eu o criei

Criei o aplicativo interno da Optagonen para que nossos facilitadores de oficinas pudessem trabalhar pelo celular: encontrar a próxima tarefa, ler o plano, entrar em contato com a equipe e reunir materiais vinculados à oficina correta.

A empresa já tinha um sistema para organizar esse trabalho. Eu queria que a experiência no celular acompanhasse a pessoa que conduz a oficina, com a câmera, a agenda e os detalhes práticos sempre à mão.

O aplicativo é destinado a iPhone e Android por meio de uma base de código compartilhada em React Native e Expo. A maior parte foi desenvolvida no Claude Code, com revisão do Codex. Os marcos de desenvolvimento descritos aqui vão de 5 a 14 de novembro de 2026.

Este é um estudo de caso de uma ferramenta interna ainda em desenvolvimento: o que ela faz, com o que se conecta e até que ponto foi testada.

A capa é uma ilustração de produto gerada por AI com base nas telas de demonstração do aplicativo. As imagens dentro do artigo são capturas originais do simulador.

Por que criar um aplicativo interno para a empresa?

A Optagonen, empresa que fundei, leva artistas profissionais e facilitadores a escolas, bibliotecas e centros juvenis. Jovens escrevem e gravam músicas, contam histórias e criam juntos. Os dados públicos da empresa descrevem mais de 500 oficinas em mais de 150 municípios suecos desde 2015. O catálogo de oficinas mostra os formatos e grupos com os quais trabalhamos.

Em nossas pesquisas históricas sobre as oficinas, 50 das 57 respostas que marcaram "professor/responsável" avaliaram a experiência geral com nota 4 ou 5 em uma escala de 5. As respostas abrangem o período de outubro de 2021 a outubro de 2026. São respostas voluntárias de participantes de oficinas, não uma medida representativa de todos os clientes nem uma avaliação do novo aplicativo.

Os comentários de professores publicados pela Optagonen acrescentam o aspecto humano. Um professor de música descreve a oficina como profissional e afirma que o professor e os alunos ficaram muito satisfeitos. Outro professor elogia o envolvimento dos facilitadores, a estrutura e a capacidade de envolver os alunos. Quero que o aplicativo apoie a preparação e o acompanhamento que estão por trás dessa experiência.

As pessoas que conduzem essas oficinas precisam de uma visão diferente do negócio daquela de quem trabalha no escritório.

Um facilitador precisa da tarefa atual, do plano original, do endereço da oficina e das pessoas envolvidas. Durante a sessão, pode precisar de um instrumental, de uma câmera ou de uma forma de registrar feedback. Depois, o escritório precisa que os materiais e as informações estejam vinculados ao projeto correto.

Esses requisitos definiram o escopo do aplicativo. Comecei com planos de oficinas e coleta de fotos, depois ampliei o mesmo fluxo para agendas, música, despesas e avaliações.

A decisão de design mais importante foi manter o sistema empresarial existente como fonte de verdade. Eu não precisava de um segundo banco de dados de clientes nem de uma cópia separada das permissões dos projetos. Precisava de uma interface móvel útil para as informações que já mantemos.

O que o aplicativo da Optagonen faz?

A tela inicial coloca a oficina atual ou a próxima ao alcance, junto de solicitações e ações que precisam de atenção. As oficinas anteriores continuam acessíveis. Dentro de uma oficina, o aplicativo organiza o trabalho em torno do plano, da agenda, dos materiais e das despesas.

Tela inicial de demonstração da Optagonen no modo escuro, com a oficina atual e o banco de conhecimento
Tela inicial de demonstração da Optagonen no modo escuro, com a oficina atual e o banco de conhecimento

Captura real do simulador da versão 0.4.0, build 48, no modo de demonstração. Todas as capturas de tela deste artigo usam oficinas e pessoas fictícias. Os horários das aulas de demonstração são gerados em relação ao momento da captura, por isso avançam até tarde da noite. Nenhum dado de cliente ou upload real aparece.

Prepare-se para o dia

Os facilitadores podem ler o plano original da oficina, ver a equipe e abrir o endereço da oficina no aplicativo de mapas. A agenda diária reúne os horários das sessões, as turmas e as salas quando esses detalhes estão disponíveis. Um resumo opcional de AI ajuda a organizar o plano em uma visão geral e uma agenda.

O plano escrito por uma pessoa continua sendo a fonte oficial. O resumo de AI é um auxiliar; o mapa abre o endereço da oficina explicitamente identificado, sem substituí-lo por um endereço de cobrança ou por um palpite da AI.

Agenda diária de demonstração da Optagonen mostrando horários das aulas, turmas, sala e local de oficina de exemplo
Agenda diária de demonstração da Optagonen mostrando horários das aulas, turmas, sala e local de oficina de exemplo

A agenda de demonstração agrupa horários de aulas, turmas e salas. O local de exemplo vem do resumo e é sinalizado para conferência com o plano. O aplicativo identifica a fonte e aponta de volta para o plano original.

O banco de conhecimento também está disponível dentro do aplicativo, com busca e cópias de leitura salvas. Isso aproxima as instruções das oficinas do trabalho, sem exigir que o usuário as procure em uma sessão separada do navegador todas as vezes.

Banco de conhecimento de demonstração da Optagonen com busca, rotinas de oficina e guias de configuração de áudio
Banco de conhecimento de demonstração da Optagonen com busca, rotinas de oficina e guias de configuração de áudio

O banco de conhecimento no aplicativo, exibido com artigos fictícios sobre preparação de materiais, oficinas e configuração de áudio. Esses exemplos permanecem separados do conteúdo empresarial real.

Receba lembretes e veja as sessões de hoje

Os facilitadores podem optar por receber lembretes na noite anterior a uma oficina e na manhã de cada dia de oficina. Outros avisos ajudam a mostrar o código da pesquisa para professores antes do fim de uma sessão mais longa e a enviar as fotos e os vídeos do dia depois. Tocar em um lembrete abre a parte relevante do aplicativo.

No iPhone, um widget Hoje e uma Live Activity colocam as sessões do dia na tela bloqueada e na Dynamic Island. Os horários das aulas aparecem somente quando o resumo e a agenda do sistema empresarial estão de acordo. A tela mantém os detalhes mínimos porque alunos ou outras pessoas podem ver o aparelho.

Os lembretes são executados no celular. As notificações push do servidor são separadas: elas transportam eventos como novas solicitações de oficinas, reservas, alterações de planos e solicitações de avaliação. A entrega e o momento do recebimento ainda precisam ser verificados em dispositivos físicos; a simples presença de código de notificações não prova que uma pessoa recebeu a mensagem.

Reúna fotos, vídeos e áudios

O aplicativo inclui fluxos de câmera e seleção de mídia vinculados à oficina selecionada. As fotos começam a ser enviadas depois que são adicionadas, e a interface diferencia materiais locais de um upload confirmado na nuvem. Arquivos de vídeo e áudio têm seus próprios caminhos compatíveis de upload e reprodução.

Tela de materiais de demonstração da Optagonen com categorias separadas para músicas, vídeos e fotos
Tela de materiais de demonstração da Optagonen com categorias separadas para músicas, vídeos e fotos

Músicas, vídeos e fotos ficam dentro da oficina selecionada. O modo de demonstração desativa explicitamente os uploads, portanto esta tela ilustra a interface, e não comprova a entrega na nuvem.

A mídia original das oficinas vai para o local existente do projeto no Dropbox. O servidor verifica o acesso e retorna um comprovante de upload armazenado antes que o aplicativo identifique uma foto como salva no Dropbox. Uploads malsucedidos ou incertos precisam de um estado de nova tentativa, em vez de uma mensagem de sucesso baseada apenas no toque em um botão.

Esta continua sendo uma área que precisa de testes em dispositivos físicos. As notas da versão mais recente registram uma limitação na fila da câmera: uma nova captura aguardando atrás de um upload pode continuar vulnerável a uma interrupção antes de chegar ao armazenamento local. Eu não descreveria o fluxo atual da câmera como à prova de perda.

Trabalhe com músicas e letras

A música faz parte do fluxo das oficinas, por isso o aplicativo inclui áudios de projetos e um reprodutor para a sala de aula. Instrumentais usados antes ou durante uma oficina permanecem separados das músicas finalizadas que depois precisam de revisão das letras.

O sistema mais amplo pode transcrever uma música finalizada e retornar a letra para correção e aprovação no aplicativo. As atualizações da letra são verificadas em relação à versão de áudio relevante, para que uma correção de uma gravação antiga não substitua silenciosamente o trabalho feito em sua substituta.

O reprodutor de sala de aula do iPhone também tem um mecanismo de áudio nativo com controles de forma de onda e repetição. Alguns recursos de áudio são específicos da plataforma; uma interface de reprodutor compartilhada não estabelece um comportamento idêntico no Android.

Conclua o trabalho administrativo

A equipe pode registrar despesas de oficinas dentro do aplicativo. Uma leitura do recibo pode sugerir campos, que a pessoa confere e edita antes de enviar. A inserção manual continua disponível.

Existem fluxos separados para acesso à pesquisa de professores, avaliação do próprio facilitador e avaliações das turmas após as aulas. Eles respondem a perguntas diferentes e não devem ser combinados em uma única pontuação genérica de feedback. Uma opção de ditado em sueco usa o serviço de reconhecimento de fala do celular para preencher anotações escritas; essa opção ainda não foi verificada em um telefone físico.

Os vendedores têm uma visão mais ampla das oficinas. Um vendedor pode consultar uma oficina que não está conduzindo, enquanto o backend mantém as ações relevantes restritas. Visibilidade e permissão para alterar um projeto são decisões separadas.

Como o aplicativo se conecta ao negócio existente

O aplicativo é um ponto de entrada focado em vários fluxos de trabalho existentes. As principais conexões são:

Sistema empresarial: identidade, atribuições de oficinas, planos, informações da equipe, despesas, solicitações e feedback.
Dropbox: arquivos originais de mídia dos projetos e links temporários de acesso para reprodução de áudio e vídeo.
Serviços de AI existentes: resumos opcionais de oficinas e sugestões de campos de recibos, além do fluxo mais amplo de transcrição de músicas.
Serviços do celular: câmera, armazenamento seguro de credenciais, mapas, lembretes locais e recursos específicos da plataforma.
Notificações do servidor: novas solicitações de oficinas, reservas, alterações de planos e solicitações de avaliação encaminhadas pela entrega push da Apple ou do Google.

O backend operacional usa o Perfex CRM com um módulo móvel dedicado. Esse módulo expõe os dados e as ações de que o aplicativo precisa, preservando as regras existentes de projetos e equipe. Ele evita transformar toda a interface administrativa em uma API móvel.

O fluxo de login abre o login existente baseado no navegador, incluindo sua autenticação de dois fatores. O aplicativo recebe uma sessão pessoal por meio de uma troca protegida por PKCE e armazena sua credencial usando o mecanismo de armazenamento seguro da plataforma. A Expo SecureStore documenta o mecanismo de armazenamento nativo usado aqui.

As credenciais dos provedores permanecem no servidor. O aplicativo não carrega uma senha compartilhada do Dropbox nem uma chave irrestrita do sistema empresarial. O backend verifica a pessoa e seu acesso em cada operação.

O Nextcloud existe em outra parte do ambiente, mas é separado do caminho de upload de mídia deste aplicativo. Os arquivos originais das oficinas descritos aqui vão para o Dropbox. Da mesma forma, a agenda de oficinas no aplicativo vem dos dados das oficinas e de seu resumo opcional; ela não é evidência de uma conexão direta com o Google Calendar.

Por que React Native e Expo para iPhone e Android?

Um único projeto em TypeScript me permite manter juntos o modelo de dados das oficinas, as telas conscientes das permissões e grande parte da interface. A Expo fornece o framework e as APIs de dispositivo em torno desse aplicativo compartilhado.

Ainda existe trabalho nativo. Widgets do iPhone e Live Activities precisam de uma implementação para iOS. O mecanismo de áudio da sala de aula também usa código nativo de iOS. O Android tem sua própria build, permissões e detalhes de interação a verificar.

O React Native oferece suporte a essas diferenças por meio de módulos e arquivos específicos da plataforma. O benefício prático é compartilhar o fluxo comum e, ao mesmo tempo, tratar explicitamente os requisitos de cada plataforma.

Para este aplicativo interno da empresa, essa é uma combinação útil. Posso alterar um fluxo de oficina em um só lugar e depois verificar a experiência resultante nas duas plataformas. Ainda preciso fazer as duas verificações.

Desenvolvendo com Fable e revisando com Codex

A maior parte do aplicativo foi desenvolvida no Claude Code. Uso o Claude Fable para a implementação e o Codex como revisor separado. A combinação atual de modelos é Fable 5.2 e Codex Sol 6.1. Meu artigo sobre o Fable 5.2 explica por que o uso em trabalhos que abrangem várias partes de um sistema.

Este aplicativo oferece um exemplo concreto desse tipo de trabalho. Um recurso de upload de fotos envolve a câmera, arquivos locais, separação de contas, permissões do backend, armazenamento em nuvem e a mensagem exibida depois de uma nova tentativa. Revisar apenas a tela deixaria de fora a maior parte do comportamento.

Usei minha própria AI Collab Bridge, disponível no GitHub, para conectar os dois. É uma skill e um protocolo de revisão gratuitos e de código aberto: uma AI prepara um pacote com a alteração e as perguntas de revisão, e a outra retorna um veredito, descobertas específicas e um registro do que verificou. A transferência funciona em qualquer direção.

Para o redesign da interface 0.4 do aplicativo, o Claude Code recebeu sua tarefa de implementação por meio da bridge. Em seguida, o Codex revisou o resultado e corrigiu áreas de toque, divisores, ações de expansão de texto e a navegação de login. Revisões posteriores aprimoraram as regras dos recursos de tela bloqueada do iPhone.

O Codex também fez correções pequenas e direcionadas. A revisão separada me forneceu descobertas concretas para resolver e um registro do que havia sido verificado. Explico a configuração no meu fluxo de revisão por pares com AI.

A atribuição histórica exata dos modelos exige cuidado. Os primeiros registros do aplicativo são anteriores ao lançamento do Fable 5.2 em 9 de novembro. O repositório oferece suporte ao fluxo de trabalho com Claude e Codex, mas não estabelece que todas as alterações anteriores tenham usado as versões atuais dos modelos.

Quanto tempo levou para desenvolver?

O primeiro commit do Git é datado de 5 de novembro de 2026, às 21h22 no horário sueco. Ele já inclui o aplicativo e evidências de uma instalação no iPhone. A instalação registrada aconteceu mais cedo naquela noite, portanto o primeiro commit é um marco, não um cronômetro do início do desenvolvimento.

Os marcos datados mostram como o escopo cresceu:

5 de novembro: instalação e login no iPhone, listagem de projetos e uma build do Android iniciada em um emulador.
6 de novembro: grandes iterações da interface, ferramentas de oficinas e melhorias na agenda e na mídia.
7–8 de novembro: fluxos de músicas e letras, seguidos pelo trabalho no widget do iPhone e na Live Activity.
12–14 de novembro: novos trabalhos no banco de conhecimento, avaliações, áudio, câmera e visão do vendedor; a distribuição interna de iOS chega à build 49.

Isso representa aproximadamente nove dias corridos de iteração registrada. Não é um total medido de horas trabalhadas, e a build 49 não significa 49 versões concluídas do produto. Os registros não sustentam uma afirmação precisa sobre horas de trabalho economizadas ou custo de desenvolvimento.

A infraestrutura existente faz parte desse cronograma. Identidade, projetos, pastas na nuvem e fluxos empresariais já existiam. O trabalho consistiu em conectá-los e adaptá-los ao celular, junto com a nova interface e os recursos nativos.

O que foi verificado em cada plataforma?

Uma build anterior do iPhone foi instalada e iniciada em um telefone físico. Confirmei que conseguia fazer login e ver meus projetos. As builds do Android foram instaladas e utilizadas em um emulador, incluindo navegação, temas e textos maiores.

O recibo de lançamento de 14 de novembro registra a build 49 de iOS como disponível para o grupo interno do TestFlight. Ele também registra 364 testes automatizados aprovados. O TestFlight é um canal de distribuição beta; esse status é separado de um lançamento público na App Store ou de um teste de todos os fluxos em um telefone.

A versão mais recente ainda precisa de testes em dispositivos. Sua nova integração do botão da câmera do Android não foi compilada nem exercitada nas verificações registradas, e não há um registro de aceitação em um Android físico. As notas da build 49 não verificam a instalação e o uso em um iPhone físico depois dessa versão. Uploads de fotos, envio de despesas, aprovação de letras e entrega de notificações push ainda precisam de verificações em telefones para esta versão. A visão do vendedor foi inspecionada por meio do modo de visualização como administrador, e não pelo login do próprio vendedor em um telefone.

Até agora, tenho um aplicativo compartilhado para iPhone e Android testado em um iPhone real e em um emulador de Android em etapas anteriores. Os testes completos dos recursos mais recentes nas duas plataformas ainda precisam ser realizados.

O resultado útil

A Optagonen agora tem um aplicativo interno organizado em torno da realização de uma oficina: preparar-se, encontrar a equipe e o local, trabalhar com os materiais e depois devolver as informações de que o escritório precisa.

Os modelos de AI ajudaram a implementar e revisar esse trabalho. O sistema empresarial existente forneceu grande parte da estrutura. Meu trabalho foi escolher o fluxo, manter claras as fontes de verdade e pedir evidências nos pontos em que o aplicativo toca pessoas, arquivos e permissões reais.

Agora quero ver como a equipe usa esses fluxos em oficinas reais: se conclui os uploads, encontra as informações certas e termina o acompanhamento. Isso me dirá mais sobre a utilidade do aplicativo do que outro número de build.

✻