CondoMaster Pro

CondoMaster Pro Preview

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.

Description
No description provided
Readme 144 KiB
Languages
HTML 85.6%
JavaScript 13.4%
CSS 1%