Recebe Avisa

Decisões técnicas

1. 01

   O OCR nunca bloqueia o registro

   A rota de scan responde sucesso sempre. Se o OCR falhar, vier ilegível ou com baixa confiança, o fluxo cai em modo degradado: a etiqueta é registrada mesmo assim e o porteiro confirma o morador a partir de sugestões ou da busca manual. Portaria em horário de pico não pode parar por causa de uma etiqueta amassada — e essa é a diferença entre um sistema que é usado e um que é abandonado na primeira semana.

2. 02

   Busca fuzzy em vez de correspondência exata

   O nome impresso na etiqueta quase nunca bate com o cadastro: vem abreviado, com o nome de quem comprou, sem acento ou com erro do remetente. A identificação usa pg_trgm com apelidos cadastrados por morador, devolvendo sugestões ranqueadas em vez de um acerto ou erro binário.

3. 03

   Multi-tenant por coluna, filtrado em toda query

   Cada tabela carrega o identificador do condomínio e nenhuma query cruza tenants — é regra de arquitetura, não convenção. Um SaaS de condomínio que vaze dado entre clientes não tem segunda chance comercial.

4. 04

   Dado pessoal fora da telemetria, com portão automatizado

   A telemetria é OpenTelemetry coletada por um agente que remove PII ainda dentro da VM, antes de qualquer coisa sair para fora. E há um verificador de PII rodando no CI que quebra o build se dado pessoal aparecer em span, métrica ou log. O portão não é teórico: um vazamento real, causado pela forma como o ORM interpola valores dentro do SQL, motivou a normalização das queries antes de virarem atributo de span.

5. 05

   Custo zero como requisito de arquitetura

   O MVP inteiro roda em camada gratuita: VM ARM na Oracle Cloud, mil requisições de OCR por mês, WhatsApp Cloud API e observabilidade no plano free. Fila gerenciada e serviços pagos só entram a partir de cinquenta condomínios. Restrição de custo declarada desde o início evita a arquitetura que fica cara antes de ter cliente.