Docs

# CHECKLIST DE ARRANQUE DO SELF_V2

## Estado atual por lotes

### Lote A — base e estrutura
- [x] `admin/` mantido na raiz
- [x] `admin/index.php` como entrada principal do admin
- [x] `admin/pages/*` criado e ligado ao menu principal
- [x] `public/` mantido para webchat e assets
- [ ] limpar totalmente redundâncias e restos transitórios
- [ ] rever convenção final de naming/paths e remover incoerências

### Lote B — admin real
- [x] dashboard inicial
- [x] menu lateral
- [x] topo operacional
- [x] página de bots/agents
- [x] página de projects
- [x] página de providers
- [x] página de models
- [x] página de settings
- [x] página de env dedicada
- [x] página de chat actions
- [x] página de MCP
- [x] página de logs
- [x] página de tools
- [x] página de docs/checklists
- [x] página de defaults/routing dedicada
- [ ] layout premium semelhante ao exemplo de referência
- [ ] rever ergonomia, animação e consistência visual global
- [ ] garantir que tudo é realmente editável e não apenas visualizável
- [ ] validar CRUD completo real em todas as páginas do admin

### Lote C — chat e runtime
- [x] `chat_reply.php` identificado como ponto crítico do fluxo
- [x] bug de include destrutivo em `chat_reply.php` corrigido
- [x] webchat com split principal + admin embebido
- [x] input + send
- [x] `Shift + Enter` para nova linha
- [x] `Enter` para envio
- [x] timestamps configuráveis
- [x] copiar mensagens do LLM
- [x] botão de fullscreen
- [x] sidebar de conversas base
- [x] nova conversa
- [x] renomear conversa
- [x] apagar conversa
- [x] duplicar conversa
- [x] pesquisar conversas
- [x] fixar/desfixar conversas
- [x] marcar lida/não lida
- [x] ordenação de conversas
- [x] rever feedback base de erro/sucesso sem `alert`
- [x] indicador visual base de processamento/a pensar
- [x] aumento de contexto conversacional no router
- [x] injeção base das regras de `projects/regras/regras.md` no contexto do LLM
- [ ] validar fluxo completo de histórico/log/resposta em todos os cenários
- [ ] validar persistência real do histórico em todos os fluxos
- [ ] visual final do chat ao nível pretendido
- [ ] aproximar o chat do estilo visual pretendido
- [ ] garantir aplicação efetiva das regras na execução, não apenas no prompt

### Lote D — gestão funcional
- [x] bots com criar/editar/eliminar
- [x] projects com criar/renomear/eliminar
- [x] models com criar/editar/eliminar
- [x] settings com guardar flags principais
- [x] providers com gestão base no admin
- [x] chat actions com gestão base no admin
- [x] routing/defaults com gestão base no admin
- [x] tabs/workspace com gestão base
- [ ] providers com gestão completa
- [ ] chat actions com gestão completa
- [ ] routing/defaults com gestão completa
- [ ] tabs/workspace com gestão completa
- [ ] eliminar prompts de UX crua e substituir por modais/forms no interface

## O QUE FALTA FECHAR MESMO

### Admin
- [ ] visual premium muito mais próximo do exemplo fornecido
- [ ] melhorar cards, espaçamentos, hierarquia visual e estados hover/active
- [ ] uniformizar formulários, tabelas, filtros e ações rápidas
- [x] criar interface de gestão dedicada para `env.php`
- [ ] reforçar segurança e ergonomia final da gestão de `env.php`
- [ ] validar que todas as páginas têm criar/editar/eliminar quando aplicável
- [ ] remover aspeto de protótipo e deixar aspeto de produto

### Chat
- [ ] garantir que a mensagem enviada entra no histórico persistente sempre
- [ ] garantir que a resposta do assistant é gravada sempre que exista resposta
- [ ] garantir coerência entre histórico, log e UI
- [x] substituir base de `alert()` por feedback inline
- [ ] polir renderização e alinhamento final das mensagens
- [ ] corrigir cópia da resposta ao nível final esperado
- [ ] garantir memória/contexto suficiente em cenários longos

### Workspace / Tabs
- [x] tab ativa persistente
- [x] URL por tab persistente
- [x] refresh por tab
- [ ] editar tabs existentes sem `prompt()`
- [ ] ordenar tabs
- [ ] abrir tabs a partir de ações do sistema/admin de forma integrada
- [ ] melhorar UX visual das tabs

### Limpeza
- [ ] limpar ficheiros redundantes/transitórios criados fora do fluxo final
- [ ] rever assets/CSS/JS para remover duplicações e restos antigos
- [ ] rever código do admin para simplificar e consolidar estilos

## 1. Fundação do projeto
- [ ] criar estrutura base limpa
- [x] manter `admin/` na raiz
- [ ] definir convenção de paths e naming
- [x] definir arquitetura inicial

## 2. Base de dados
- [ ] levantar definições de BD relevantes do `self`
- [ ] confirmar prefixo / instance prefix
- [ ] definir schema mínimo novo para `self_v2`
- [x] recriar tabela de settings
- [x] recriar tabela de agents
- [x] recriar tabela de chat actions
- [x] definir conversations/messages
- [x] definir providers/models/routing

## 3. Agents / LLM
- [ ] Tozé como default global
- [ ] Sara como agent secundário
- [x] suporte a seleção manual de agent
- [ ] suporte a chamada explícita de agent
- [x] carregar no chat apenas agents configurados e ativos
- [ ] guardar agent default em settings
- [x] guardar default model por agent
- [x] guardar estado ativo/inativo por agent

## 4. Providers e modelos
- [ ] configurar OpenAI para Tozé
- [ ] configurar Gemini para Sara
- [ ] definir secret refs sem expor chaves
- [x] criar models por provider
- [x] permitir alterar modelo no chat por agent
- [x] dropdown de modelos por agent

## 5. Chat UI
- [x] split screen
- [x] sidebar de conversas base
- [ ] sidebar de conversas final ao nível esperado
- [ ] mensagens do utilizador à direita
- [ ] mensagens do LLM à esquerda
- [x] barra de agents
- [x] dropdown de modelos por agent
- [x] input + send
- [x] `Shift + Enter` para nova linha
- [x] `Enter` para envio
- [x] timestamps nas mensagens
- [x] copiar mensagens do LLM
- [x] foco regressa à input box
- [ ] visual estilo ChatGPT
- [x] modo claro/escuro persistente
- [x] botão de fullscreen
- [x] feedback inline base em vez de alerts
- [x] estado visual base de processamento

## 6. Workspace / tabs
- [x] workspace lateral com tabs
- [x] criar tab base fixa por defeito
- [x] a tab base deve abrir o admin interno
- [x] impedir fecho da tab base
- [x] permitir abrir e fechar outras tabs
- [x] refresh independente por tab
- [x] guardar URL/estado por tab
- [ ] editar/gerir tabs sem prompts
- [ ] ordenar tabs
- [ ] UX final de tabs ao nível pretendido

## 7. Chat actions
- [x] tabela de chat actions
- [x] gestão base no admin
- [x] label / command / position / enabled
- [x] tipo de ação
- [ ] implementar `Paste + Send`
- [ ] ligar `Paste + Send` à memória
- [ ] polir gestão visual/operacional das chat actions

## 8. Admin
- [x] dashboard inicial
- [ ] layout premium
- [x] menu lateral
- [x] topo operacional
- [x] página de agents
- [x] página de providers
- [x] página de models
- [x] página de defaults/routing
- [x] página de chat actions
- [x] página de MCP
- [x] página de env
- [x] página de docs/checklists
- [ ] consistência visual final
- [ ] CRUD completo validado em todas as páginas

## 9. MCP
- [ ] definir modo MCP ligado
- [ ] trocar papel do Tozé por ChatGPT quando ativo
- [ ] manter Sara local/selecionável
- [ ] indicador visual de estado MCP
- [x] fallback quando MCP estiver indisponível