79 lines
4.2 KiB
Markdown
79 lines
4.2 KiB
Markdown
# 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.
|
|
|
|
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.***
|