Obly

O que o sistema faz

• Diário de obra registrado no canteiro, com foto tirada na hora e digitalização de documento pela câmera.
• Financeiro por obra: orçamento por etapa, despesa, cotação de fornecedor e comparação entre orçado e gasto.
• Cronograma com EAP, montagem assistida e importação de XML do MS Project.
• Acervo de documentos no nível da conta, com projeto, contrato, nota fiscal e licença.
• Leitura de planta em PDF e importação de orçamento em planilha, as duas por modelo de linguagem, com revisão obrigatória antes de gravar.
• Assistente de voz que classifica o que foi dito e transforma em lançamento.
• Relatório de obra em PDF, montado a partir do que já foi lançado.
• Time do assinante e acesso do cliente, com permissão por papel.
• Assinatura em três planos, com teste de catorze dias sem cartão.

Arquitetura

• API em NestJS sobre PostgreSQL concentra a regra de negócio, em vinte e sete módulos e setenta e sete migrations. Web em Next.js e aplicativo em Expo consomem o mesmo modelo de domínio.
• Isolamento por conta contratante: time, plantas, armazenamento e direitos comerciais vivem no nível da conta, não do usuário. Não existe entidade de conta separada, a conta é o usuário dono.
• Autenticação por token do Firebase verificado no servidor em guard de rota. O backend não guarda senha, sessão nem refresh token.
• Motor de direitos no servidor: catálogo de capacidades, molde por plano em tabela, guard por capacidade nas rotas de escrita e reserva mensal atômica para a cota de importação por modelo.
• Arquivo do acervo em armazenamento compatível com S3 no Cloudflare R2, com URL assinada para subir e baixar. O PostgreSQL guarda a chave do objeto, e a reconciliação de upload abandonado roda uma vez por dia.
• Planta em PDF renderizada com mupdf e interpretada por modelo Gemini. O mesmo provedor atende a importação de orçamento e a classificação do assistente, sempre com saída validada por esquema antes de virar escrita.
• Importação de cronograma a partir de XML do MS Project e de planilha. A importação é sempre prévia: nada entra no domínio antes da confirmação.
• Cobrança por assinatura em Stripe, com preço lido do provedor e nunca copiado para banco ou tela.
• CI contra PostgreSQL real em GitHub Actions, migration aplicada antes do deploy e rotina diária de limpeza agendada no mesmo lugar.
• Repositório de documentação sem código guarda a intenção do produto: PRD único, cento e setenta e seis regras de negócio com status em quinze domínios, seis ADRs, especificação por funcionalidade com critério de aceitação, e duas skills que descrevem o procedimento de mudança.

Detalhes de implementação

• Nenhum preço fica escrito em banco ou em tela: o catálogo é lido do provedor de pagamento a cada consulta.
• O webhook de cobrança registra o evento antes de qualquer mapeamento, e um índice único parcial garante uma assinatura vigente por conta.
• O aplicativo não vende assinatura: a cobrança acontece na web, e o aplicativo apenas lê o direito vigente.