Voltar aos projetos
Plataforma de gestão condominial

Residencial Grama 13

Plataforma que integra site público, portal do morador e painel do síndico, com API autorizada por papel, Firebase Authentication e Firestore.

ReactTypeScriptViteExpressZodFirebase AuthenticationFirestoreFirebase HostingCloud RunCloud TasksSecret ManagerCloudflare Turnstile

O Residencial Grama 13 evoluiu de um site institucional para uma plataforma de gestão condominial. A área pública apresenta o residencial e seus canais de contato; as áreas autenticadas concentram rotinas de moradores e da administração em uma mesma experiência.

No portal do morador, a aplicação organiza faturas e histórico, chamados, comunicados e informações de contato. O painel do síndico reúne a gestão de lotes, cobranças, solicitações, avisos e mensagens recebidas. Essa separação mantém cada jornada focada no que seu usuário precisa consultar ou resolver.

O frontend usa React, TypeScript e Vite. A autenticação é feita pelo Firebase Authentication, com fluxos de acesso por link de e-mail, senha e recuperação de conta. A API em Express valida os dados com contratos Zod compartilhados, confere a identidade e aplica autorização por papel e por lote. O acesso administrativo exige autenticação multifator; dados privados passam pelo backend, sem leitura direta do Firestore pelo navegador.

O Firestore armazena os dados de negócio, enquanto o Firebase Hosting entrega a interface. A API roda em Cloud Run com escala até zero. Cloud Tasks e um worker privado em Cloud Run separam o envio assíncrono de e-mails das requisições do usuário; Secret Manager mantém as configurações sensíveis fora do código. O formulário público usa Cloudflare Turnstile para reduzir abuso.

A solução combina uma presença pública com fluxos de gestão e controles de acesso adequados a informações condominiais. O monorepo separa frontend, backend e contratos compartilhados, permitindo evoluir as jornadas sem perder a consistência entre interface, API e dados.