# 🚀 FASTAPP CORE — Evolução do Projeto (Provisório)

Este documento registra os marcos alcançados e os próximos passos para a soberania do motor FastApp.

## ✅ Concluído Recentemente (Fev/2026)

### 🧱 Arquitetura DevShell Singleton (UX & Infra)
- **Global Architect Sidebar**: O "Object Design Hub" foi movido para o layout global (`default.vue`), tornando-se o **Centro de Comando do Designer**.
- **Persistência de Sessão**: Uso de `useStorage` para manter o sidebar aberto/fechado entre reloads e snapshots.
- **Singleton Management**: O sidebar agora é único e consome o esquema via `systemStore.activeObjectSchema`, eliminando conflitos de múltiplas instâncias.
- **UX Stability**: Desabilitação do fechamento acidental (`:dismissable="false"`) para permitir que o arquiteto interaja com o formulário real sem perder as ferramentas de edição.

### 🎨 Componentes & Páginas Dinâmicas (Core Runtime)
- **Active Schema Bridging**: Implementação de watchers em `DynamicCRUD.vue` e `[[id]].vue` (Formulário) que "injetam" o esquema atual no Singleton global.
- **Context Awareness**: O motor agora entende se você está editando uma lista ou um formulário e mantém o Architect Sidebar sincronizado com a taxonomia do objeto em foco.
- **Responsive Grid Manager**: Adição do seletor de `layout_grid` (12, 6, 4, 3 colunas) diretamente no sidebar.
- **Real-time Form Feedback**: O sidebar agora está integrado à página de formulário, permitindo que o `CoreDynamicForm` absorva mudanças estruturais instantaneamente.

### 🛡️ Soberania de Dados & Integridade (Stability Patch)
- **Sovereign Restore Milestone**: Recuperação bem-sucedida de metadados corrompidos via script de restauração (StaticManifest -> PATCH -> Snapshot).
- **Multiplicity Refinement**: A lógica de detecção de multiplicidade foi corrigida para garantir que arrays de objetos genéricos (`inner_collection`) nunca percam dados durante a hidratação.
- **Defensive Components**: `DynamicTable` resiliente a propriedades com labels ausentes (prevenção de crashes catastróficos).

---

## ✅ Concluído (Março/2026)

### ⚡ L3 Data Engine & SWR Stability
- **Hydration Crash Fix**: Eliminação do erro "Cannot read properties of undefined" ao achatar o `objectsState` no `appDataStore`, removendo o aninhamento por `appSlug` que causava race conditions no SSR.
- **True SWR Implementation**: O motor agora compartilha dados entre Dashboard e CRUD. O dashboard faz o prefetch de até 50 objetos, e a navegação para o CRUD consome esse cache instantaneamente.
- **Request Coalescing**: Implementação de `pendingRequests` para evitar chamadas de API duplicadas. Se você navega para o CRUD enquanto o prefetch do dashboard ainda corre, o sistema aguarda a mesma promessa em vez de disparar um novo fetch.
- **Case-Insensitive Mapping**: Normalização de nomes de objetos (lowercase) no store para garantir que o cache funcione independente de como o slug vem na URL ou no manifesto.
- **Property Groups (v3-UI)**: Integração completa da UI de agrupamento de propriedades no Schema Manager e renderização automática no `DynamicForm` e `RecordDetail`.
- **UI UX Polish**: Correções globais de escopo para `useToast` (PrimeVue) e resolução de chaves duplicadas no `AppMenu.vue`.

---

## 📅 Próximos Passos (Roadmap)

### 🔍 Camada de Inteligência & UX (Core L3)
- [ ] **Smart Grouping AI**: O Agente agora pode sugerir e criar grupos de propriedades automaticamente com base na semântica (ex: agrupar "logradouro, numero, cep" em um grupo "Endereço").
- [ ] **Semantic-Aware Components**: Evolução onde o `CoreDynamicForm` escolhe o renderizador não apenas por tipo (string/number), mas pela **Taxonomia Semântica** (ex: campos `identity` ganham destaque visual, campos `event` ganham visibilidade cronológica).
- [ ] **AI-Driven Schema Suggestions**: Loop de feedback onde o Agente sugere novos campos com base na descrição semântica do objeto.
- [ ] **Visual Action Builder**: Interface drag-and-drop para definir comportamentos de botões e triggers de API diretamente no sidebar.

### 🌐 Conectividade & Orquestração
- [ ] **Component Presets System**: Permitir que o Arquiteto defina "Temas de Componente" via metadados (ex: formulário estilo "Glassmorphism" vs "Solid Minimalist").
- [ ] **Multi-App Context Isolation**: Garantir que o Arquiteto limpe o estado corretamente ao trocar de App no Hub.
- [ ] **Advanced Widget Engine**: Extensão do sistema de `layout_grid` para dashboards e listagens híbridas complexas.

### 🧪 Robustez & Governança de Taxonomia
- [ ] **Metadata Integrity Layer**: Validação server-side para impedir salvamentos parciais que zeram listas de objetos.
- [ ] **Admin Disaster Recovery Tool**: Botão de "One-click Restore from Static" no painel de administração.
- [ ] **Advanced Migration Preview**: Dashboard para visualizar alterações de DDL antes da confirmação.
- [ ] **Schema Versioning**: Rollback de rascunhos de arquitetura.

---

> "O código que escrevemos hoje é a fundação para o sistema que se construirá sozinho amanhã."