48 lines
2.4 KiB
Markdown
48 lines
2.4 KiB
Markdown
# MyCondominium
|
|
|
|
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.
|
|
|
|
## 🎯 Sobre o Projeto
|
|
|
|
O **MyCondominium** é 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).*
|
|
|
|
---
|
|
*Construído com simplicidade e foco na comunidade.*
|