Allan Simões AdegasEnglish
Menu
Voltar para o início

Gestão Condominial

Projeto em equipe

Plataforma para síndicos profissionais que administram de 3 a 15 condomínios, com isolamento de dados garantido pelo banco.

Papel
Coautor, em equipe
Início
2026
síndico: todos os prédiosporteiro: só o próprio turnomorador: só a unidade
Ilustração do projeto
46
chaves estrangeiras compostas de isolamento
RLS
também no caminho de escrita
3
plataformas: web, iOS e Android

Visão geral

Um síndico entra uma vez e opera todos os prédios; um porteiro só enxerga o turno dele; um morador só vê a própria unidade. Projeto em equipe no Clube de Software Semiprofissional.

O ponto mais interessante é a segurança: as regras de quem vê o quê ficam no PostgreSQL (Row Level Security), não espalhadas pelo código.

O que ele faz

Isolamento pelo banco
A API roda com a identidade do usuário e as policies valem em leitura e escrita. Esquecer um filtro deixa de ser possível.
Um código, três apps
Frontend Vite empacotado com Capacitor para web, iOS e Android.

Arquitetura

Arquitetura: Gestão CondominialWeb · iOS · Android → FastAPI. FastAPI → PostgreSQL 17. Supabase Auth → PostgreSQL 17. PostgreSQL 17 → Storage · RealtimeJWTclaimsRLSWeb · iOS · AndroidVite + CapacitorFastAPIpapel authenticatedPostgreSQL 17RLS + FKs compostasSupabase AuthJWTStorage · Realtimesob RLS
A API assume a identidade do usuário; o banco decide o que ele pode ver.

Decisões e trade-offs

O SQL é a fonte da verdade
Migrations em SQL escrito à mão, sem autogeração: um ORM não representa policies, FKs compostas nem grants, e proporia apagar tudo que não conhece.
A coluna sozinha não isola
Além do condominio_id em toda tabela, FKs compostas impedem uma linha de um condomínio apontar para outro.

Qualidade e operação

  • Testes de contrato dos endpoints e de RLS de verdade, mais testes de isolamento do schema sem Docker (PGlite).

Estado e próximos passos

  • Módulos de conta, perfis, condomínios, membros e convites prontos; unidades, encomendas e avisos são os próximos.

Stack

PythonFastAPISQLAlchemy asyncSupabasePostgreSQL 17ViteCapacitor