CondoMaster Pro
O CondoMaster Pro é uma aplicação web moderna e responsiva (Single Page Application - SPA) desenvolvida para simplificar e digitalizar a gestão de condomínios. Desenhado a pensar tanto na entidade gestora (Administradores) como nos habitantes (Moradores), o sistema integra todas as comunicações, finanças e ocorrências do dia a dia.
✨ Funcionalidades Principais
Acesso Baseado em Perfis (Role-Based Access Control)
- 🧑💻 Administradores (
admin): Visão 360º. Podem gerir moradores, registar receitas e despesas globais, cobrar dívidas, enviar faturas manuais (com um clique) e alterar papéis de acesso ("promover" ou "despromover"). - 🏠 Moradores (
morador): Painel simplificado desenhado para transparência. Permite verificar as próprias quotas em atraso, reportar danos/anomalias (manutenção) e reservar espaços comuns.
💰 Faturação e Gestão Financeira (Exclusivo Admins)
- Visão geral completa de Fluxo de Caixa (Despesas vs. Receitas).
- Emissão instantânea de recibos avulso.
- Notificações de dívidas encaminhadas com apenas um clique na tabela integrada de Faturação.
📅 Gestão de Reservas
- Lista e Mapa: Sistema visual de reservas em três ginásios, salões de festas e parques de jogos.
- Histórico Completo: Página exclusiva para listagem de todas as reservas agendadas, acessível a todas as entidades.
🛠️ Ocorrências e Manutenção
- Secção para os condóminos relatarem problemas no edifício (ex: candeeiros partidos, problemas de elevador) indicando o grau de severidade.
- Os administradores avaliam a prioridade, resolvem as ocorrências digitalmente e mantêm os residentes notificados do estado.
🎨 Design Moderno & UI Inteligente
- Compatível com Mobile e Desktop.
- Inclui um switch suave para Modo Escuro (Dark Mode), Modo Claro e deteção por Sistema, integrados perfeitamente no menu de perfil.
- Sistema de notificações do tipo Themed/Toasts para validações imediatas (Confirmações, Erros, Avisos).
💻 Stack Tecnológica
O projeto foi construído usando uma arquitetura modular moderna num formato de ficheiro de entrada principal que integra os ecossistemas:
- React: Implementado diretamente do navegador (sem build step local). Geração de componentes declarativos (UI Dinâmica).
- Tailwind CSS: Carregado dinamicamente para aplicar estilos sofisticados e reativos, acelerando o desenvolvimento visual da interface.
- Lucide React: Biblioteca adotada inteiramente para a vasta panóplia de ícones (
lucide-react).
🚀 Como Iniciar (Quick Start)
Visto que o projeto já traz toda a lógica baseada na Web injetada, não é precisa uma instalação exaustiva na máquina.
-
Baixar o Projeto: Basta que tenhas o ficheiro principal (geralmente
index.html) e o ambiente disponível na mesma pasta (neste casoGestorCondominio). -
Abrir a Aplicação:
- Para pré-visualizar rapidamente a aplicação, podes apenas fazer duplo-clique no
index.htmlpara abrir o sistema num browser moderno. - Alternativamente, podes hospedar este ficheiro num serviço de Live Server ou num host online (ex: Vercel, Netlify, Github Pages), não existindo configuração complexa.
- Para pré-visualizar rapidamente a aplicação, podes apenas fazer duplo-clique no
🔐 Credenciais de Base (Ambiente de Testes)
Neste momento as credenciais estão pré-programadas para experimentação do comportamento do sistema:
Acesso de Administrador:
- Email:
administradores@gmail.com - Palavra-passe:
admin123
Acesso de Morador:
- Email:
moradores@gmail.com - Palavra-passe:
moradores123
(Nota: Alguns moradores registados na base de dados fictícia no "Estado" da app podem aceder através da palavra-passe padrão de morador ou usando o respetivo contacto telefónico).
👨🔧 Desenvolvimento e Melhorias Mapeadas
- Ligação completa de base de dados escalável com a inicialização nativa contida do Firebase.
- Emissão e importação de documentos faturação automatizados PDF.
Desenvolvido para criar comunidades perfeitamente ligadas.
