🏢 Transformando a Gestão de Condomínios: Por Dentro do Projeto Portaria Digital

🌌 CodeVerse2026 – Artigo #11

🧑💻 Fala Galera Dev! 👋

Nos últimos artigos do CodeVerse2026 eu vim mostrando bastante projetos voltados para jogos, IA, deploy e aplicações mais criativas. Mas dessa vez quero trazer algo muito mais próximo do mundo corporativo e da realidade de empresas que precisam resolver problemas do dia a dia. O projeto de hoje foi desenvolvido para o Projeto Integrador III da faculdade e acabou se tornando um dos sistemas mais completos que já desenvolvi até agora.

E vou ser sincero com vocês… esse projeto me fez evoluir bastante como desenvolvedor. Porque aqui não era apenas fazer algo “bonitinho” funcionar na tela. Eu precisei pensar em estrutura, experiência do usuário, permissões, segurança, organização do banco de dados, fluxo entre usuários e principalmente como um sistema real funciona dentro de uma operação do dia a dia.

Foi um daqueles projetos onde você começa programando uma funcionalidade simples… e quando percebe já está pensando praticamente como uma empresa de software. 😅

💡 A ideia do projeto

A ideia do sistema surgiu observando algo que vemos em praticamente qualquer condomínio: processos manuais e desorganizados. Reserva de churrasqueira feita em papel, encomendas esquecidas na portaria, moradores sem saber quem entrou no condomínio e administradores sem controle centralizado das informações.

Então comecei a pensar em como transformar tudo isso em um sistema único, moderno e acessível tanto pelo computador quanto pelo celular. A proposta era justamente criar uma plataforma que centralizasse reservas, encomendas, visitantes, notificações e gerenciamento do condomínio em um único ambiente.

O mais interessante é que durante o desenvolvimento eu comecei a perceber que criar software não é apenas escrever código. Desenvolver sistemas é basicamente resolver problemas reais de pessoas reais. E isso muda totalmente a forma como começamos a enxergar programação.

🔐 Níveis de acesso: cada usuário vê apenas o que precisa

Uma das partes mais importantes do sistema foi o controle de permissões e níveis de acesso. Porque em um condomínio existem vários tipos de usuários, e cada um possui funções diferentes dentro da operação.

O morador, por exemplo, consegue reservar espaços, acompanhar encomendas, cadastrar visitantes e visualizar comunicados do condomínio.
Já o porteiro ou zelador possui um acesso mais operacional, podendo registrar entregas, controlar entrada de visitantes e atualizar o status das encomendas.
E existe também o administrador, que funciona praticamente como o “super usuário” do sistema. Ele consegue alterar configurações gerais, personalizar o condomínio, gerar relatórios, cadastrar espaços comuns e gerenciar todas as reservas e usuários do sistema.

Isso parece simples olhando pronto… mas controlar corretamente quem pode acessar cada tela e cada funcionalidade deu bastante trabalho. Porque qualquer erro de permissão poderia acabar mostrando informações indevidas para usuários errados. Foi praticamente como criar classes diferentes dentro de um RPG, onde cada personagem possui habilidades específicas dentro do sistema. 😅

🛠️ Tecnologias utilizadas

Nesse projeto resolvi subir bastante o nível técnico da stack para aproximar mais da realidade do mercado. Diferente dos jogos feitos apenas com HTML, CSS e JavaScript, aqui precisei trabalhar com backend robusto, autenticação e banco de dados real.

Utilizei FastAPI com Python no backend;
PostgreSQL como banco de dados;
Autenticação JWT;
Docker para containerização;
Swagger para documentação automática da API;
Já no frontend continuei usando HTML5, CSS3 e JavaScript Vanilla, justamente porque queria continuar fortalecendo minha base sem depender de frameworks pesados.

Além disso, também trabalhei com API REST, organização em módulos, responsividade mobile-first e estruturação mais profissional de pastas e componentes. Foi literalmente um projeto onde consegui conectar vários conhecimentos diferentes dentro de uma única aplicação.

📦 O módulo de encomendas foi minha maior batalha 😅

Sem dúvida, uma das partes mais difíceis de todo o projeto foi o módulo de encomendas. A ideia parecia simples na teoria: o porteiro registra a entrega, tira uma foto da encomenda, envia para o sistema e o morador recebe a notificação podendo marcar posteriormente como recebida.

Mas na prática… foi uma verdadeira guerra contra bugs 😂

Sempre aparecia algum problema diferente. Às vezes a imagem não salvava corretamente, em outros momentos a notificação não aparecia para o morador, ou então o status da encomenda não atualizava após o recebimento. Teve momentos em que eu achava que finalmente tinha terminado o módulo… e quando testava novamente surgia outro erro completamente diferente.

Essa funcionalidade acabou me ensinando muito sobre integração entre frontend, backend e banco de dados. Porque bastava um pequeno detalhe errado no fluxo para tudo parar de funcionar. Foi provavelmente o módulo onde mais aprendi durante todo o desenvolvimento do sistema.

🎨 Personalização completa do condomínio

Uma funcionalidade que achei muito legal implementar foi a parte de personalização do condomínio. Eu queria que o sistema deixasse de ser algo genérico e pudesse realmente representar a identidade visual de cada condomínio que utilizasse a plataforma.

Então o administrador consegue adicionar a logo oficial do condomínio, alterar as cores principais do sistema usando um color picker e até personalizar os espaços comuns. Cada espaço pode possuir nome, descrição, regras específicas de reserva, limite de pessoas e foto personalizada do ambiente.

Isso deixa a experiência muito mais profissional e personalizada. Porque o sistema passa a parecer algo realmente desenvolvido para aquele condomínio específico, e não apenas um software genérico igual vemos em muitos lugares hoje em dia.

📅 Sistema de reservas

Outra funcionalidade que deu bastante trabalho, mas ficou muito legal, foi o sistema de reservas. O morador consegue visualizar os espaços disponíveis, verificar datas livres e realizar reservas diretamente pela plataforma.

Já o administrador possui controle total sobre essas reservas, podendo bloquear datas, limitar horários, criar regras específicas e aprovar solicitações dependendo do tipo de espaço reservado.

E vou falar uma coisa pra vocês… trabalhar com datas, horários e calendário é MUITO mais complicado do que parece 😂. Qualquer pequeno erro em validação ou conflito de horário já faz o sistema inteiro começar a apresentar comportamento estranho.

Mas no final, depois de muito ajuste, consegui deixar um fluxo funcional e relativamente simples de usar.

📱 O mobile também me fez sofrer bastante 😅

Assim como aconteceu nos outros projetos do CodeVerse2026, o mobile acabou virando praticamente outro projeto separado dentro do sistema. E vou ser sincero: a parte responsiva desse sistema me deu bastante dor de cabeça.

Teve dias em que eu ajustava tudo, testava no celular e ficava perfeito. Aí no outro dia eu abria novamente para validar… e parecia que o layout tinha brigado sozinho durante a madrugada 😂

Botões saíam do lugar, tabelas quebravam, cards desalinhavam e menus simplesmente paravam de funcionar direito em algumas resoluções. Isso acabou me ensinando algo muito importante: responsividade não é apenas diminuir elementos na tela. Muitas vezes precisamos repensar completamente a experiência do usuário para dispositivos móveis.

Então precisei revisar menus, grids, formulários, espaçamentos e dashboards praticamente várias vezes até deixar tudo minimamente agradável no mobile.

🤖 O papel da IA no desenvolvimento

Claro que a IA também participou bastante desse projeto. Usei GitHub Copilot e ChatGPT como apoio durante várias partes do desenvolvimento, principalmente na documentação automática, organização da API, validações e estruturação de algumas funcionalidades e para tirar dúvidas de várias funcionalidades que eu ia implementando.

Mas uma coisa que venho percebendo cada vez mais é que IA funciona muito melhor quando você já entende minimamente o que está construindo. Porque ela acelera MUITO o processo… mas quem toma as decisões ainda é o desenvolvedor.

Muitas vezes precisei corrigir código, reorganizar funcionalidades, revisar permissões e até pedir explicações do próprio código gerado para conseguir entender exatamente o que estava acontecendo. Ou seja: a IA ajudou bastante, mas ainda assim o olhar humano continuou sendo essencial durante todo o projeto.

🚫 Dessa vez não poderei liberar o código fonte

Diferente de alguns projetos anteriores do CodeVerse2026, dessa vez eu não vou conseguir disponibilizar publicamente o código fonte completo no GitHub.

E o motivo é simples: já estou em processo de adaptação e implementação desse sistema dentro da empresa, transformando ele em algo realmente utilizável no mundo real. Então por questões de segurança, privacidade e estratégia, não faria sentido deixar toda a estrutura pública nesse momento.

Mas achei importante compartilhar a experiência, os aprendizados e os desafios do desenvolvimento. Porque muitas vezes aprendemos tanto nos bastidores do projeto quanto no código em si.

🚀 O que esse projeto me ensinou

Esse projeto me ensinou muito mais do que programação. Ele me ensinou organização, estruturação de sistemas, fluxo de usuários, controle de permissões, experiência do usuário e principalmente como um sistema real precisa ser pensado antes mesmo da primeira linha de código.

Foi um projeto onde precisei sair bastante da zona de conforto e começar a pensar muito mais próximo da realidade do mercado tech. Porque desenvolver software não é apenas escrever código bonito… é construir soluções que pessoas reais consigam utilizar sem dor de cabeça.

E talvez essa seja uma das maiores viradas na vida de um desenvolvedor: quando ele entende que programar não é apenas fazer funcionar… é resolver problemas reais de verdade.

🚀 Conclusão

Esse foi facilmente um dos projetos mais importantes que já desenvolvi até agora dentro da minha jornada. Porque nele consegui juntar backend, frontend, banco de dados, autenticação, mobile, experiência do usuário, permissões e organização em um único sistema funcional.

E o mais interessante é perceber como projetos assim fazem a gente evoluir rápido. Porque no meio do caminho aparecem bugs, erros, dificuldades e situações que nenhum tutorial consegue ensinar completamente.

No final das contas, é justamente isso que transforma conhecimento em experiência prática.

🔥 Código bonito impressiona… mas código que resolve problemas reais é o que realmente gera valor. 🚀

🚀 Se curte acompanhar projetos reais, aprendizados na prática e toda essa jornada de evolução dentro da programação, me acompanha por aqui. No CodeVerse2026 eu compartilho não só os acertos, mas também os bugs, desafios, refatorações, ideias e tudo aquilo que realmente faz parte da vida de um dev. 👨💻🔥

🔗 Link do Vídeo: Post_Video_Linkedin
🔗 LinkedIn: Carlos Garcia no LinkedIn
💻 GitHub: Carlos-CGS no GitHub

Porque no final das contas… a melhor forma de evoluir na programação é construindo projetos reais e aprendendo um bug de cada vez. 🚀