Documentação Inclusa

documentação/00_PROJECT_OVERVIEW.md

@@ -0,0 +1,64 @@
+# 📦 InventoryAI — Project Overview
+
+## Visão Geral
+
+**InventoryAI** é uma aplicação móvel de gestão de inventário pessoal inteligente.  
+O utilizador fotografa os seus pertences, a app organiza-os automaticamente por categoria, e sugere o que levar consoante o contexto (viagem, clima, ocasião).
+
+---
+
+## Problema que resolve
+
+As pessoas não sabem o que têm em casa. Perdem tempo a procurar itens, esquecem-se do que possuem, e não conseguem planear eficientemente o que levar para viagens ou eventos.
+
+---
+
+## Proposta de Valor
+
+> "Fotografa uma vez. A app lembra-se para sempre. Diz-te o que levar quando precisas."
+
+---
+
+## Utilizador-alvo
+
+- Pessoas que viajam frequentemente
+- Quem tem muita roupa e não consegue gerir outfits
+- Utilizadores organizados que querem controlo total dos seus bens pessoais
+- Nómadas digitais e viajantes de longa duração
+
+---
+
+## Princípios de Design
+
+1. **Simplicidade primeiro** — o MVP não tem IA avançada. Regras simples parecem inteligentes.
+2. **Foto como input principal** — tirar foto é mais rápido do que escrever.
+3. **Categorização automática** — o utilizador não quer trabalho manual.
+4. **Sugestões contextuais** — a app responde a perguntas reais do utilizador.
+5. **Evolução progressiva** — começar simples, adicionar IA com dados reais.
+
+---
+
+## Estado atual do projeto
+
+| Fase | Estado |
+|------|--------|
+| Definição do MVP | ✅ Concluído |
+| Arquitetura técnica | ✅ Definida |
+| Implementação | 🔲 Por iniciar |
+| Testes com utilizadores | 🔲 Por iniciar |
+| IA avançada | 🔲 Fase futura |
+
+---
+
+## Ficheiros de contexto deste projeto
+
+| Ficheiro | Conteúdo |
+|----------|----------|
+| `00_PROJECT_OVERVIEW.md` | Este ficheiro — visão geral |
+| `01_MVP_DEFINITION.md` | Funcionalidades mínimas viáveis |
+| `02_ARCHITECTURE.md` | Stack técnica e estrutura da app |
+| `03_AI_VISION_LAYER.md` | Integração de IA para imagens |
+| `04_CATEGORIES_AND_TAGS.md` | Sistema de organização de itens |
+| `05_RECOMMENDATION_ENGINE.md` | Lógica de sugestões (regras + IA futura) |
+| `06_FUTURE_FEATURES.md` | Roadmap e funcionalidades avançadas |
+| `07_AGENT_BEHAVIOR.md` | Como o agente IA deve comportar-se |