Files
dayMaker_lp/documentação/00_PROJECT_OVERVIEW.md
Carlos Correia fee538eebd MVP
2026-05-29 11:03:29 +01:00

80 lines
2.9 KiB
Markdown

# DayMaker — Project Overview
## Visão geral
**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
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
> "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 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
| Área | Estado |
|------|--------|
| 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 |
---
## Documentos do projeto
| Ficheiro | Conteúdo |
|----------|----------|
| `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 |