Documentação Inclusa

documentação/06_FUTURE_FEATURES.md

@@ -0,0 +1,119 @@
+# 🚀 Roadmap e Funcionalidades Futuras
+
+## Visão a longo prazo
+
+> "Uma app que conhece tudo o que possuis e te diz exatamente o que precisas, quando precisas."
+
+---
+
+## Fases de desenvolvimento
+
+```
+FASE 1 — MVP (agora)
+├── Upload de fotos
+├── Guardar itens
+├── Categorização manual + auto (Google Vision)
+├── Pesquisa / filtro
+└── Sugestões simples por regras
+
+FASE 2 — IA de Linguagem
+├── Input em linguagem natural
+├── Integração OpenAI API
+└── Contextos dinâmicos
+
+FASE 3 — Personalização
+├── Aprendizagem por histórico
+├── Integração com clima
+└── Sugestões proativas
+
+FASE 4 — Social e Avançado
+├── Outfits automáticos
+├── Pack automático para viagens
+├── Integração com calendário
+└── Assistente conversacional
+```
+
+---
+
+## Funcionalidades por fase
+
+### 🔵 Fase 2 — IA de Linguagem
+
+**Input em linguagem natural**
+- Utilizador escreve ou fala: "Vou a uma conferência em Londres por 3 dias"
+- App interpreta e gera lista personalizada
+- Implementado via OpenAI API (ver `05_RECOMMENDATION_ENGINE.md`)
+
+**Contextos dinâmicos**
+- Em vez de escolher de uma lista, o utilizador descreve a situação
+- App infere contexto, duração, clima esperado, formalidade
+
+---
+
+### 🟡 Fase 3 — Personalização
+
+**Aprendizagem por histórico**
+- App regista quais itens o utilizador aceitou/ignorou nas sugestões
+- Com 10+ interações, começa a ajustar pesos de relevância
+- Exemplo: utilizador nunca leva sapatos formais em viagens curtas → app para de sugerir
+
+**Integração com API de clima**
+- Utilizador indica destino e datas
+- App consulta previsão meteorológica
+- Filtra roupa por temperatura e condições
+- APIs candidatas: OpenWeatherMap, WeatherAPI
+
+**Sugestões proativas (push notifications)**
+- "Tens uma reunião amanhã — lembra-te do teu fato"
+- "Viagem na sexta — queres ver a tua lista?"
+
+---
+
+### 🔴 Fase 4 — Funcionalidades Avançadas
+
+**Montagem automática de outfits**
+- App combina peças de roupa compatíveis visualmente
+- Usa cor dominante extraída das fotos
+- Sugere conjuntos completos (peça cima + baixo + calçado + acessório)
+
+**Pack automático para viagens**
+- Utilizador diz: "Vou 5 dias ao Porto, clima ameno, reuniões + lazer"
+- App gera lista completa, organizada por tipo de item
+- Permite marcar o que já está na mala (checklist)
+
+**Integração com Google Calendar / Apple Calendar**
+- App lê eventos do calendário
+- Antecipa necessidades: "Reunião importante na 5ª feira → fato?"
+- Notificações contextuais automáticas
+
+**Assistente conversacional**
+- Chat dentro da app
+- Perguntas como: "O que devo levar amanhã?"
+- Resposta baseada em calendário + clima + inventário
+- Implementado via OpenAI Assistants API ou similar
+
+**Funcionalidades sociais (opcional)**
+- Partilhar listas com parceiro de viagem
+- "O que ele/ela já vai levar?" para evitar duplicações
+- Listas de viagem colaborativas
+
+---
+
+## Integrações externas planeadas
+
+| Serviço | Fase | Objetivo |
+|---------|------|----------|
+| Google Vision AI | 1 (MVP) | Identificar objetos nas fotos |
+| OpenAI API | 2 | Processar linguagem natural |
+| OpenWeatherMap | 3 | Dados de clima por destino |
+| Google Calendar | 4 | Antecipação de necessidades |
+| Apple Calendar | 4 | Antecipação de necessidades (iOS) |
+
+---
+
+## Notas para o agente IA
+
+- Quando o utilizador pedir uma funcionalidade das Fases 2-4, não recusar — mas clarificar que está fora do MVP e perguntar se deve ser planeada para uma fase futura
+- Não implementar funcionalidades de fases futuras sem confirmação explícita do utilizador
+- Ao planear uma funcionalidade futura, criar um documento de especificação separado antes de implementar
+- A ordem das fases é intencional — não saltar fases sem validação com utilizadores reais