# CondoMaster Pro ![CondoMaster Pro Preview](https://via.placeholder.com/800x400.png?text=CondoMaster+Pro+-+Gestão+de+Condomínios) 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. 1. **Baixar o Projeto:** Basta que tenhas o ficheiro principal (geralmente `index.html`) e o ambiente disponível na mesma pasta (neste caso `GestorCondominio`). 2. **Abrir a Aplicação:** - Para pré-visualizar rapidamente a aplicação, podes apenas fazer duplo-clique no **`index.html`** para 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. --- ## 🔐 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.***