Documentação Inclusa

documentação/01_MVP_DEFINITION.md

@@ -0,0 +1,101 @@
+# 🎯 MVP — Definição do Produto Mínimo Viável
+
+## Objetivo do MVP
+
+Criar a versão mais simples possível da app que já seja útil para um utilizador real.  
+**Sem IA avançada. Sem funcionalidades complexas. Sem over-engineering.**
+
+O MVP deve validar a hipótese central:  
+> "Os utilizadores estão dispostos a fotografar os seus itens para depois receber sugestões contextuais."
+
+---
+
+## Funcionalidades obrigatórias (must-have)
+
+### 1. 📸 Upload / Captura de Foto
+- O utilizador tira foto a um item com a câmara do telemóvel
+- Alternativa: selecionar foto da galeria
+- A foto é guardada no perfil do item
+- **Requisito mínimo:** uma foto por item
+
+### 2. 📦 Guardar Item
+- Cada item tem:
+  - `nome` (texto livre ou sugerido pela IA de imagem)
+  - `foto` (obrigatória)
+  - `categoria` (selecionada pelo utilizador ou auto-detetada)
+  - `tags` (opcional, atribuídas manualmente ou automaticamente)
+  - `data de adição`
+- O item é guardado na base de dados do utilizador
+
+### 3. 🏷️ Categorização
+- O utilizador escolhe a categoria principal do item
+- Categorias base disponíveis no MVP:
+  - Roupa
+  - Eletrónica
+  - Calçado
+  - Acessórios
+  - Documentos
+  - Outros
+- Subcategorias simples dentro de cada categoria (ver `04_CATEGORIES_AND_TAGS.md`)
+
+### 4. 🔍 Pesquisa e Visualização do Inventário
+- Lista de todos os itens (grid de fotos ou lista)
+- Filtrar por categoria
+- Pesquisa por nome ou tag
+- Detalhe do item ao clicar
+
+### 5. 🎯 Sugestões Simples por Contexto (sem IA)
+- O utilizador seleciona um contexto pré-definido:
+  - "Vou viajar (curta duração)"
+  - "Vou viajar (longa duração)"
+  - "Vou ao trabalho"
+  - "Fim de semana casual"
+- A app filtra e mostra os itens relevantes para esse contexto
+- As regras são estáticas e definidas manualmente (ver `05_RECOMMENDATION_ENGINE.md`)
+
+---
+
+## Funcionalidades excluídas do MVP
+
+> Estas funcionalidades são importantes mas ficam para iterações futuras.
+
+- ❌ Sugestões baseadas em clima
+- ❌ Montagem automática de outfits
+- ❌ Integração com calendário
+- ❌ Assistente conversacional ("O que devo levar amanhã?")
+- ❌ Sistema de preferências pessoais aprendidas
+- ❌ Multi-utilizador / partilha
+- ❌ Exportação de listas
+- ❌ Notificações inteligentes
+
+---
+
+## Fluxo principal do utilizador (MVP)
+
+```
+1. Utilizador abre a app
+2. Tira foto de um item
+3. App sugere nome e categoria (via Google Vision)
+4. Utilizador confirma ou edita
+5. Item guardado no inventário
+6. Utilizador acede ao inventário → pesquisa / filtra
+7. Utilizador seleciona contexto → app mostra lista filtrada
+```
+
+---
+
+## Critérios de sucesso do MVP
+
+- [ ] Utilizador consegue adicionar 10 itens em menos de 5 minutos
+- [ ] Pesquisa devolve resultados corretos em menos de 1 segundo
+- [ ] Sugestão por contexto é considerada "útil" por 70%+ dos utilizadores testados
+- [ ] Taxa de retenção ao fim de 7 dias > 40%
+
+---
+
+## Notas para o agente IA
+
+- Quando o utilizador pedir para construir uma funcionalidade, verificar primeiro se está no MVP ou no roadmap futuro
+- Se estiver fora do MVP, avisar e perguntar se deve ser priorizada ou adiada
+- Nunca adicionar complexidade desnecessária ao MVP
+- Preferir sempre a solução mais simples que funcione