ajusteLogin
This commit is contained in:
117
README.md
117
README.md
@@ -1,78 +1,47 @@
|
||||
# CondoMaster Pro
|
||||
# CondoMasterResults
|
||||
|
||||
|
||||
Uma plataforma moderna de gestão de condomínios focada em transparência, comunicação em tempo real e facilidade de uso, tanto para moradores como para a administração.
|
||||
|
||||
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.
|
||||
## 🎯 Sobre o Projeto
|
||||
|
||||
O **CondoMasterResults** é uma *Single Page Application* concebida para digitalizar a gestão do dia a dia num condomínio. Permite aos moradores consultar despesas, reservar espaços comuns e reportar ocorrências, enquanto oferece aos administradores um painel de controlo completo sobre as finanças e os utilizadores.
|
||||
|
||||
## 🚀 Funcionalidades Chave
|
||||
|
||||
* **Perfis Diferenciados**: Acessos específicos para Administradores (gestão total) e Moradores (painel simplificado).
|
||||
* **Fórum em Tempo Real**: Chat integrado (Mural) sincronizado instantaneamente entre todos os vizinhos.
|
||||
* **Gestão de Espaços Comuns**: Sistema prático de reservas para Ginásio, Salão de Festas e Parque de Jogos.
|
||||
* **Portal de Manutenção**: Plataforma para reportar avarias (moradores) e gerir a resolução das mesmas (administração).
|
||||
* **Gestão Financeira e Faturação**: Visão clara sobre quotas pendentes, geração de faturas e fluxo de caixa.
|
||||
|
||||
## 🛠️ Tecnologias Utilizadas
|
||||
|
||||
Esta aplicação corre integralmente no lado do cliente com forte integração de serviços cloud:
|
||||
|
||||
- **Frontend**: React (UI Declarativa), Tailwind CSS (Estilização) e Lucide React (Ícones).
|
||||
- **Backend & Base de Dados**: Firebase Auth (Autenticação) e Firebase Realtime Database (Sincronização de dados em direto).
|
||||
|
||||
## 📥 Como Começar
|
||||
|
||||
Uma vez que a aplicação está desenhada para correr diretamente no navegador (recorrendo ao Firebase para armazenar estado):
|
||||
|
||||
1. Clona ou descarrega este repositório para o teu computador.
|
||||
2. Abre a pasta do projeto num servidor local. Recomendamos o uso de ferramentas como o **Live Server** (extensão VS Code) ou a execução de `npx serve` no terminal.
|
||||
3. Acede ao endereço gerado no teu navegador (ex: `http://localhost:3000`).
|
||||
|
||||
### 🔑 Credenciais de Teste
|
||||
|
||||
Podes explorar a plataforma utilizando as seguintes contas de demonstração:
|
||||
|
||||
**Administrador**
|
||||
- Email: `administradores@gmail.com`
|
||||
- Senha: `admin123`
|
||||
|
||||
**Morador**
|
||||
- Email: `moradores@gmail.com`
|
||||
- Senha: `moradores123`
|
||||
|
||||
*(Nota: É possível testar o envio de mensagens em tempo real abrindo duas janelas com contas diferentes lado a lado).*
|
||||
|
||||
---
|
||||
|
||||
## ✨ 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.***
|
||||
*Construído com simplicidade e foco na comunidade.*
|
||||
|
||||
Reference in New Issue
Block a user