MVP

documentação/AI_AGENTS_LOG.md

@@ -1,70 +1,81 @@
-# 📝 AI Agents Log
+# AI Agents Log
 
 ## Propósito
 
-Este ficheiro regista toda a atividade do agente de recomendação.  
-Cada execução gera uma entrada neste log.
+Este ficheiro regista decisões e alterações relevantes relacionadas com a IA e recomendações do DayMaker.
 
 ---
 
-## Formato de Entrada
+## Formato recomendado
 
-### Data:
+```text
+### Data
 YYYY-MM-DD
 
-### Agente:
-Recommender-MVP
+### Área
+Chat IA / Sugestão IA / Inventário / Planeamento / Documentação
 
-### Tipo:
-- recomendacao
-- erro
-- melhoria
+### Descrição
+Resumo do que mudou.
 
-### Descrição:
-O que foi feito
-
-### Itens afetados:
-Lista de itens usados
-
-### Ação tomada:
-O que se decidiu
-
-### Notas:
-Observações úteis
-
----
-
-## Regras de Logging
-
-1. **SEMPRE** registar após cada execução
-2. Tipo `recomendacao` → quando sugestões são geradas com sucesso
-3. Tipo `erro` → quando lista vazia, pedido ambíguo ou dados incompletos
-4. Tipo `melhoria` → quando se detetam problemas no sistema
-5. Nunca omitir entradas de erro — são tão importantes como sucessos
+### Impacto
+Como afeta o utilizador ou o código.
+```
 
 ---
 
 ## Histórico
 
-### Data:
+### Data
 2026-04-24
 
-### Agente:
-Recommender-MVP
+### Área
+Recomendação inicial
 
-### Tipo:
-recomendacao
+### Descrição
+Primeiras ideias de motor de recomendações baseado em regras estáticas e contextos.
 
-### Descrição:
-Implementação inicial do motor de recomendações MVP. Sistema de regras estáticas com 6 contextos, parser por palavras-chave, logging e deteção de melhorias.
+### Impacto
+Serviu como base conceptual, mas não representa a implementação final.
 
-### Itens afetados:
-T-shirt preta, Portátil, Nintendo Switch, Fones de ouvido, Passaporte, Carregador USB-C, Jeans azul, Sapatilhas brancas, Mochila, Fato de treino
+---
 
-### Ação tomada:
-Criado APPprojetoLP.dart com modelo de dados alinhado com 02_ARCHITECTURE.md, contextos de 05_RECOMMENDATION_ENGINE.md, e tags de 04_CATEGORIES_AND_TAGS.md
+### Data
+2026-05-21
 
-### Notas:
-- Parser de pedidos é básico (palavras-chave). Fase 2 usará OpenAI API.
-- Clima e formalidade são detetados mas não filtram itens no MVP.
-- Duração "medium" (ex: 4 horas) não tem regras específicas ainda.
+### Área
+Chat IA
+
+### Descrição
+Integração do chat com endpoint Ollama remoto `https://apichat.epvc.pt/api/chat` usando o modelo `llama3.2:3b`.
+
+### Impacto
+A app passou a ter ecrã de conversa com IA acessível pela barra inferior.
+
+---
+
+### Data
+2026-05-22
+
+### Área
+Sugestão IA na Home
+
+### Descrição
+Criado fluxo de sugestão por ocasião. O utilizador escreve algo como `piquenique no parque`; a IA responde com nomes de itens do inventário; a app cruza com itens reais, mostra imagens e permite exportar para a semana.
+
+### Impacto
+A sugestão deixou de ser texto solto e passou a produzir itens acionáveis.
+
+---
+
+### Data
+2026-05-28
+
+### Área
+Documentação
+
+### Descrição
+Documentação reescrita para refletir o projeto final: Flutter, Supabase, inventário, planeamento semanal, chat IA e sugestões Ollama.
+
+### Impacto
+Removidas referências antigas a React Native/Firebase/OpenAI como stack atual.