This commit is contained in:
Carlos Correia
2026-05-29 11:03:29 +01:00
parent 967584f083
commit fee538eebd
14 changed files with 1349 additions and 1149 deletions

View File

@@ -1,64 +1,79 @@
# 📦 InventoryAI — Project Overview
# DayMaker — Project Overview
## Visão Geral
## 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).
**DayMaker** é uma aplicação móvel Flutter para organizar itens pessoais, planear o que usar/levar durante a semana e pedir sugestões a uma IA com base no inventário real do utilizador.
A app permite guardar roupas, eletrónica, calçado, acessórios, documentos e outros itens com categoria, tags e imagem. Depois, esses itens podem ser usados no planeamento semanal ou em sugestões geradas pela IA.
---
## 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.
Muitas pessoas esquecem o que têm, perdem tempo a escolher outfits ou não sabem o que levar para viagens, trabalho, praia, piqueniques e outros planos do dia.
O DayMaker centraliza o inventário pessoal e ajuda o utilizador a decidir rapidamente o que precisa.
---
## Proposta de Valor
## Proposta de valor
> "Fotografa uma vez. A app lembra-se para sempre. Diz-te o que levar quando precisas."
> "Guarda os teus itens uma vez. Planeia a semana e pede à IA sugestões com o que já tens."
---
## Funcionalidades atuais
- Autenticação com Supabase.
- Home com saudação, resumo do dia, contagem de itens e itens recentes.
- Inventário com pesquisa, filtros por categoria, vista em grid/lista e detalhe do item.
- Adição e edição de itens com categorias e tags.
- Imagens associadas aos itens via `item_images`.
- Planeamento semanal com tabela `plans` e relação `plan_items`.
- Chat com IA usando endpoint Ollama em `https://apichat.epvc.pt/api/chat`.
- Botão "Pedir sugestão à IA" na home, com input de ocasião e sugestões rápidas.
- Sugestões da IA limitadas aos itens existentes no inventário.
- Exibição dos itens sugeridos com imagem, nome e categoria.
- Exportação das sugestões para um dia da semana.
---
## 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.
- Pessoas que querem organizar roupa, acessórios e objetos do dia a dia.
- Utilizadores que planeiam outfits semanais.
- Pessoas que viajam ou preparam atividades com frequência.
- Estudantes e profissionais que querem saber rapidamente o que levar.
---
## Estado atual do projeto
| Fase | Estado |
| Área | 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 |
| App Flutter | Implementada |
| Autenticação Supabase | Implementada |
| Inventário | Implementado |
| Imagens dos itens | Implementado |
| Planeamento semanal | Implementado |
| Chat IA | Implementado |
| Sugestão IA com itens reais | Implementada |
| Exportar sugestão para dia | Implementado |
| Testes automatizados | Pendente |
---
## Ficheiros de contexto deste projeto
## Documentos do 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 |
| `00_PROJECT_OVERVIEW.md` | Visão geral do projeto |
| `01_MVP_DEFINITION.md` | Definição do produto atual |
| `02_ARCHITECTURE.md` | Arquitetura técnica e dados |
| `03_AI_VISION_LAYER.md` | Estado da camada de imagem/visão |
| `04_CATEGORIES_AND_TAGS.md` | Categorias e tags usadas |
| `05_RECOMMENDATION_ENGINE.md` | Funcionamento das sugestões da IA |
| `06_FUTURE_FEATURES.md` | Roadmap futuro |
| `07_AGENT_BEHAVIOR.md` | Regras para agentes de código |
| `AI_AGENTS_LOG.md` | Histórico técnico das decisões de IA |
| `RULE_ENGINE.md` | Regras atuais do sistema de sugestão |