ParkWise - Sistema Inteligente de Gestão de Estacionamento 🚗💨

Desenvolvido com dedicação 💙 pelos estudantes de Engenharia Informática e Telecomunicações do ISUTC
👨‍💻 Azam Uzman | Edilson Tovele | Edwilson Cossa | Hayder Diogo
📅 Maio de 2025 | Maputo, Moçambique

ParkWise é uma solução tecnológica inovadora desenvolvida para o Instituto Superior de Transportes e Comunicações (ISUTC) de Moçambique, com o objectivo de revolucionar a gestão de vagas de estacionamento no campus. A aplicação móvel, construída com Flutter e Firebase, oferece uma experiência intuitiva para estudantes, docentes, gestores e visitantes.

🌟 Funcionalidades Implementadas

🔐 Autenticação Segura

• Sistema de registro e login com verificação de e-mail/senha
• Categorização de utilizadores: Estudante, Docente, Gestor e Visitante
• Armazenamento seguro de perfis no Cloud Firestore

🎨 Interface Adaptativa

• Dark/Light Mode inteligente que respeita preferências do sistema
• Design responsivo para diferentes tamanhos de ecrã
• Componentes reutilizáveis para consistência visual

🚦 Gestão de Vagas (MVP)

• Visualização imediata do estado das vagas (Livre 🟢 / Ocupada 🔴)
• Reserva de vagas por utilizadores autenticados
• Painel administrativo básico para gestores

🔄 Sincronização em Tempo Real

• Actualização instantânea usando Firestore Streams
• Transições suaves entre ecrãs com animações personalizadas

🚀 Próximas Etapas (Roadmap)

🗺️ Mapa Interativo do Campus

• Visualização georreferenciada das vagas de estacionamento
• Navegação por blocos com filtros inteligentes

📊 Dashboard Avançado

• Relatórios de ocupação em tempo real
• Histórico de reservas com análise temporal
• Exportação de dados para gestão estratégica

📱 Modo Visitante Completo

• Acesso limitado sem necessidade de autenticação
• Informação sobre horários de pico e disponibilidade

⚙️ Funcionalidades Offline

• Cache inteligente para operação sem conectividade
• Sincronização automática quando online

🛠️ Tecnologias Utilizadas

Camada	Tecnologias
Frontend	Flutter • Provider • Shared Preferences
Backend	Firebase Authentication • Cloud Firestore • Firebase Security Rules
Ferramentas	Android Studio • GitHub • Firebase Console

📂 Estrutura do Projecto

• lib/
• ├── core/
• │ ├── constants/ # Constantes globais
• │ ├── routes/ # Configuração de navegação
• │ ├── theme/ # Definições de temas
• │ └── utils/ # Utilidades compartilhadas
• ├── data/
• │ ├── datasources/ # Fontes de dados
• │ ├── models/ # Modelos de dados
• │ └── repositories_impl/ # Implementação de repositórios
• ├── domain/
• │ ├── entities/ # Entidades de negócio
• │ ├── repositories/ # Contratos de repositórios
• │ └── use_cases/ # Casos de uso
• ├── presentation/
• │ ├── viewmodels/ # Lógica de apresentação
• │ ├── views/ # Ecrãs principais
• │ └── widgets/ # Componentes reutilizáveis
• ├── services/
• │ ├── auth_service.dart # Serviço de autenticação
• │ ├── parking_service.dart # Serviço de gestão de vagas
• │ └── theme_provider.dart # Gestor de temas
• ├── firebase_options.dart # Configuração Firebase
• └── main.dart # Ponto de entrada

👥 Como Contribuir

1. Clonar o repositório
   git clone https://github.com/seu-usuario/parkwise.git

2. Instalar dependências
   flutter pub get

3. Configurar Firebase

   • Entrar projecto no Firebase Console
   • Adicionar aplicação Android/iOS
   • Descarregar google-services.json e colocar em android/app

4. Executar aplicação

   • flutter create --platform ios,android
   • flutter run

📜 Licença

Este projecto é licenciado sob a Licença MIT - ver o ficheiro LICENSE para detalhes.

---

Se precisar fazer download do parkwise.zip do release, e dai pega as atualizacoes, tudo estara a funcionar, i guess.