{"id":"repo/product","source":"repo","sourceLabel":"repository root","sourcePath":"PRODUCT.md","routePath":"/fastapp/public-docs/page/repo/product","rawPath":"/fastapp/public-docs/raw/repo/product","slug":["repo","product"],"slugPath":"repo/product","title":"⚙️ Fastapp Engine — Produto","description":"Documento de produto. Define o quê, para quem, e para onde estamos indo sob a filosofia Anti Gravity .","headings":["⚙️ Fastapp Engine — Produto","O que é?","Para quem?","🗺️ O Mapa de Voo — As 4 Fases do Fastapp","Fase 1: O Intérprete ✅ (Base)","Fase 2: O Snapshot ✅ (Performance)","Fase 3: A Forja 🔮 (Próximo Passo)","Fase 4: O Ecossistema 🌐 (Visão)","Fase 2.5: O Arquiteto & O Gestor ✅ (Concluído)","Fase 2.75: Architect Tool Chain & Sovereign Navigation ✅ (Concluído)","Fase 3: A Forja 🔮 (Próximo Passo)","Fase 4: O Ecossistema 🌐 (Visão)","Features Implementadas","Motor Dinâmico (Core)","Schema Manager v3 (Novo) 🏗️","Inteligência Artificial (Arquiteto) 🧠","API Dinâmica","Taxonomia","Snapshot System","Dashboard de Ecossistema 🔗","CRM Flux (Modelo 01)","Admin Panel","Builder Hub & Sovereign Navigation 🛣️","Ontologia v3 (Semântica Expandida) 🧠"],"wordCount":1377,"markdown":"# ⚙️ Fastapp Engine — Produto\r\n\r\n> Documento de produto. Define o quê, para quem, e para onde estamos indo sob a filosofia **Anti-Gravity**.\r\n\r\n--- \r\n\r\n## O que é?\r\n\r\nO **Fastapp** é uma **fábrica de aplicações**. Ele transforma definições JSON em interfaces funcionais completas — CRUD, formulários, tabelas, navegação — sem escrever código repetitivo. A meta básica é a **abstração máxima**: se algo é repetitivo, deve ser automatizado pelo motor; se é específico, deve ser parametrizado.\r\n\r\nA primeira aplicação construída sobre o motor (o \"carro-chefe\") é o **CRM Flux** — o \"Modelo 01\" que sai da fábrica para validar todos os processos.\r\n\r\n```mermaid\r\ngraph LR\r\n    subgraph \"A Fábrica (Fastapp Engine)\"\r\n        ENGINE[\"⚙️ Motor Dinâmico\"]\r\n        BUILDER[\"🔧 Builder (Admin)\"]\r\n        SNAPSHOT[\"📸 Snapshot\"]\r\n        APIV1[\"🔌 API v1\"]\r\n    end\r\n\r\n    subgraph \"Modelo 01\"\r\n        CRM[\"🏢 CRM Flux\"]\r\n    end\r\n\r\n    subgraph \"Modelo 02...N\"\r\n        TICKETS[\"🎫 Helpdesk\"]\r\n        INVENTORY[\"📦 Inventário\"]\r\n        CUSTOM[\"🧩 Sua App\"]\r\n    end\r\n\r\n    ENGINE --> CRM\r\n    BUILDER --> ENGINE\r\n    ENGINE -.-> TICKETS\r\n    ENGINE -.-> INVENTORY\r\n    ENGINE -.-> CUSTOM\r\n\r\n    style ENGINE fill:#4338ca,color:#fff\r\n    style CRM fill:#f59e0b,color:#000\r\n    style BUILDER fill:#6366f1,color:#fff\r\n    style SNAPSHOT fill:#7c3aed,color:#fff\r\n    style APIV1 fill:#059669,color:#fff\r\n```\r\n\r\n---\r\n\r\n## Para quem?\r\n\r\n| Persona | Necessidade | Como o Fastapp resolve |\r\n|---------|------------|----------------------|\r\n| **Dev solo / startup** | SaaS rápido sem boilerplate | Define o objeto no JSON, motor gera tudo |\r\n| **Equipe comercial** | CRM simples e visual | CRM Flux pronto, Kanban + stats |\r\n| **Gestor técnico** | Customização sem código | Schema Manager v3 edita objetos e props |\r\n| **Dev avançado** | Estender o ecossistema | Camada custom sobre o motor (ex: L3 Orquestração) |\r\n\r\n---\r\n\r\n## 🗺️ O Mapa de Voo — As 4 Fases do Fastapp\r\n\r\nA evolução do Fastapp não é sobre acumular features, mas sobre **mudar onde a inteligência reside**.\r\n\r\n```mermaid\r\ngraph LR\r\n    F1[\"🔄 Fase 1<br/>O Intérprete\"]\r\n    F2[\"📸 Fase 2<br/>O Snapshot\"]\r\n    F3[\"🏭 Fase 3<br/>A Forja\"]\r\n    F4[\"🌐 Fase 4<br/>O Ecossistema\"]\r\n\r\n    F1 ==>|\"Otimizar\"| F2\r\n    F2 ==>|\"Gerar código\"| F3\r\n    F3 ==>|\"Distribuir\"| F4\r\n\r\n    style F1 fill:#059669,color:#fff\r\n    style F2 fill:#7c3aed,color:#fff\r\n    style F3 fill:#dc2626,color:#fff\r\n    style F4 fill:#0891b2,color:#fff\r\n```\r\n\r\n### Fase 1: O Intérprete ✅ (Base)\r\nO sistema é 100% dinâmico. O motor interpreta o JSON e renderiza componentes genéricos em tempo real.\r\n\r\n### Fase 2: O Snapshot ✅ (Performance)\r\nCongelamento do DNA do app em `static-manifest.ts` para evitar consultas ao banco e garantir carregamento instantâneo.\r\n\r\n### Fase 3: A Forja 🔮 (Próximo Passo)\r\nO motor lê o manifesto e **escreve arquivos físicos** (`.vue`, `.ts`) no disco, permitindo performance nativa com a flexibilidade do design-time.\r\n\r\n### Fase 4: O Ecossistema 🌐 (Visão)\r\nO Fastapp gera infraestrutura distribuída, onde módulos de diferentes apps conversam via contratos semânticos.\r\n\r\n---\r\n\r\n### Fase 2.5: O Arquiteto & O Gestor ✅ (Concluído)\r\nImplementamos a inteligência de criação. O **Arquiteto IA** projeta sistemas via briefing, e o **Schema Manager v3** permite o ajuste fino técnico 3-pane.\r\n\r\n### Fase 2.75: Architect Tool Chain & Sovereign Navigation ✅ (Concluído)\r\nImplementamos a **cadeia completa de ferramentas do arquiteto** e a **navegação soberana**:\r\n- **Builder Hub**: Top bar contextual com seleção de contexto e acesso às ferramentas\r\n- **FastApp Architect** (🟣 Indigo): Schema Studio v3 com editor 3-pane\r\n- **FastApp Flow** (🔵 Blue): Visualização de metadados via Vue Flow (ER e Process)\r\n- **FastApp Agent** (💜 Purple): AI Copilot com streaming e Domain-Aware Gap Analysis\r\n- **Sidebar colapsável**: 15rem → 4rem com tooltips, estado persistido\r\n- **Separação de contextos**: Navegação (rota) vs Builder (`selectedAppId`)\r\n- **Ontologia v3**: Semântica expandida com `semantic`, `topology`, e campos enriquecidos\r\n\r\n---\r\n\r\n### Fase 3: A Forja 🔮 (Próximo Passo)\r\n\r\n**O que é:** O nível \"Pro\". O sistema lê o manifesto e **escreve arquivos físicos** (`.vue`, `.ts`, `.prisma`) no disco.\r\n\r\n**Fluxo:** `Manifesto → Engine lê → Gera pages/leads/index.vue de verdade`\r\n\r\n**Vantagem:** Performance de código nativo + liberdade para customizar sem limitações do dinâmico.\r\n\r\n**Impacto da Taxonomia:**\r\n- `category: transactional` → gera automaticamente rotas de relatório/stats\r\n- `category: master` → gera caches e dropdowns globais\r\n- `category: configuration` → gera \"Settings Page\" simplificada\r\n- `relations` → gera includes/joins automáticos nas queries\r\n\r\n**Preparação (fazer agora):**\r\n- Manter os componentes de Lead **muito bem organizados** — são os **Arquétipos**\r\n- Documentar padrões de código nos componentes Lead/CRM\r\n- Separar lógica de presentation vs logic nos componentes\r\n\r\n**O que construir quando chegar aqui:**\r\n- [ ] Template engine (Handlebars/EJS para .vue templates)\r\n- [ ] CLI: `fastapp generate --app crm-flux`\r\n- [ ] Diffing: detectar customizações do dev antes de re-gerar\r\n- [ ] Scaffold: gerar `schema.prisma` a partir do manifesto + taxonomy\r\n\r\n---\r\n\r\n### Fase 4: O Ecossistema 🌐 (Visão)\r\n\r\n**O que é:** O Fastapp gera não só código, mas **infraestrutura**.\r\n\r\n**Fluxo:** `Módulo Financeiro → AWS A / Módulo CRM → AWS B / Micro-frontends conversam`\r\n\r\n**Preparação (fazer agora):**\r\n- [x] APIs padronizadas com `v1/data/` para roteamento futuro\r\n- [ ] Pensar em namespaces por app no banco\r\n- [ ] Design de API gateway\r\n\r\n**Impacto da Taxonomia:**\r\n- Objetos `master` (User) → serviço de Autenticação Central\r\n- Objetos `transactional` → bancos de alta escrita\r\n- Objetos `configuration` → config service com cache distribuído\r\n\r\n---\r\n\r\n## Features Implementadas\r\n\r\n### Motor Dinâmico (Core)\r\n- **CoreDynamicCRUD** — Orquestrador: modal, page, ou inline\r\n- **CoreDynamicTable** — DataTable com colunas por `show_in_list`\r\n- **CoreDynamicList** — List view com edição in-place\r\n- **CoreDynamicForm** — Zod runtime + VeeValidate\r\n- **CoreDynamicFields** — Recursivo para inner_collection\r\n- **CoreFieldRenderer** — type → PrimeVue component\r\n- **CoreDynamicFilter** — Filtro universal URL-driven com inputs adaptativos por tipo\r\n- **CoreAppMenu** — Sidebar dinâmica por App/Module\r\n\r\n### Schema Manager v3 (Novo) 🏗️\r\n- **Arquitetura 3-Pane** — Navegação ágil e edição profunda simultânea\r\n- **Editor Visual** — Drag & drop reordering, cards interativos\r\n- **Deep Editor** — Controle total sobre metadados (labels, icons, types)\r\n- **Live Sync** — Edições refletem imediatamente no Arquiteto IA\r\n\r\n### Inteligência Artificial (Arquiteto) 🧠\r\n- **Heuristic Parser** — Interpretação resiliente de outputs variados (JSON, Markdown)\r\n- **Contexto Silencioso** — Handshake técnico invisível ao usuário\r\n- **Taxonomy Aware** — Sugere e valida tipos, naturezas e categorias automaticamente\r\n\r\n### API Dinâmica\r\n- **Endpoints v1** — GET, POST, PATCH, DELETE genéricos\r\n- **Hybrid Strategy** — Prisma model nativo ou tabela Record\r\n- **Meta-validation** — Valida body contra manifest properties\r\n- **Query Parser** — 9 operadores de filtro + sort, coerção de tipos\r\n- **URL-Driven Sync** — URL ↔ Filter ↔ API ↔ Table (bookmarkável)\r\n\r\n### Taxonomia\r\n- **Category** — master, transactional, configuration (semântica do dado)\r\n- **Nature** — physical, embedded, virtual (onde mora o dado)\r\n- **Relations** — belongs_to, has_one, has_many, associates_with + storage strategy\r\n- **Super-Seed** — App Gestão de Ativos com 6 objetos validando toda a taxonomia\r\n\r\n### Snapshot System\r\n- **Geração** — Endpoint converte DB → static-manifest.ts\r\n- **Smart Store** — Prioriza estático em prod, fallback API\r\n- **is_frozen** — Flag por App para forçar modo estático\r\n\r\n### Dashboard de Ecossistema 🔗\r\n- **Propostas Estratégicas** — Componentes visuais de alto impacto para pré-venda e roadmap.\r\n- **SosPlantao**: Foco em Gestão Médica e Kit de Sucesso.\r\n- **Central Filtros**: Foco em Manutenção Industrial e Automação Preventiva.\r\n- **Technical Exploration** — Dashboard técnico gerado automaticamente com contagem de objetos, módulos e navegação rápida.\r\n- **Custom Pages Routing** — Suporte a rotas hardcoded integradas dinamicamente ao menu do App.\r\n\r\n### CRM Flux (Modelo 01)\r\n- **Dashboard** com stats em tempo real\r\n- **Kanban** com drag & drop + optimistic updates\r\n- **Formulário inline** e modo página\r\n- **Offline-first** com persistência localStorage\r\n- **WebSocket** para sync multi-tab\r\n\r\n### Admin Panel\r\n- **App Management** — CRUD de Apps, Modules, Objects\r\n- **Snapshot** — Botão gerar + badge STATIC/LIVE\r\n- **Seed System** — Popula definições base\r\n\r\n### Builder Hub & Sovereign Navigation 🛣️\r\n- **Builder Hub** — Top bar contextual (`h-14`, `bg-[#0a0d14]`) com pill buttons segmentados\r\n- **Sidebar Colapsável** — `15rem` expandida, `4rem` colapsada, estado persistido\r\n- **App Switcher** — OverlayPanel com ícones gradiente e animações hover\r\n- **2 Contextos Independentes** — Navegação (baseada em rota) vs Builder (baseado em selectedAppId)\r\n- **Design DNA Consistente** — Mesmo padrão visual do Architect/Flow/Agent\r\n\r\n### Ontologia v3 (Semântica Expandida) 🧠\r\n- **Semantic Fields** — `asset`, `money`, `percentage`, `phone`, `email`, `url`\r\n- **Topology** — `focal`, `connected`, `hierarchical` (governa a navegação)\r\n- **Spatial Types** — `point`, `polygon` (ativa inteligência GIS)\r\n- **Routing Types** — `waypoint`, `route` (ativa logística)\r\n\r\n### Logística & Mapa 🗺️\r\n- **CoreMapRenderer** — Renderização de pins com gradiente por status\r\n- **CoreMapExplorer** — Mapa explorativo com Leaflet/Google Maps\r\n- **Flow de Logística** — Vue Flow com topologia de rotas/atendimentos\r\n- **Seed Automático** — Scripts `seed-[app-slug]-data.ts` para população\r\n\r\n---\r\n\r\n## Definições e Termos\r\n\r\n| Termo | Significado |\r\n|-------|-----------|\r\n| **App** | Aplicação completa (CRM Flux, Helpdesk) |\r\n| **Module** | Agrupamento lógico dentro do App (CRM, Financeiro) |\r\n| **Object** | Entidade de dados (Lead, Tarefa, Contato) |\r\n| **Property** | Campo do Object (nome, email, status) |\r\n| **Manifest** | Estrutura JSON que define App → Module → Object → Property |\r\n| **Static Manifest** | Snapshot: versão \"congelada\" do manifest em `.ts` |\r\n| **Native Model** | Object com tabela Prisma dedicada (Lead) |\r\n| **Generic Record** | Object dinâmico na tabela `Record` (data: Json) |\r\n| **Builder** | Interface admin para criar/editar Objects e Properties (Schema Manager v3) |\r\n| **Builder Hub** | Top bar contextual que conecta as ferramentas do Arquiteto |\r\n| **Architect Tool Chain** | Conjunto: Agent + Architect + Flow, acessados pelo Builder Hub |\r\n| **Query Parser** | Converte query params da URL em cláusulas `where`/`orderBy` do Prisma |\r\n| **URL-Driven** | A URL é a fonte única de verdade para filtros (bookmarkável) |\r\n| **Category** | Classificação semântica: master, transactional, configuration |\r\n| **Nature** | Onde o dado mora: physical (tabela), embedded (JSON), virtual (calculado) |\r\n| **Semantic** | Natureza semântica do campo: asset, money, phone, email, url |\r\n| **Topology** | Dinâmica de navegação: focal (dashboard), connected, hierarchical |\r\n| **Relation** | Vínculo tipado entre objects: belongs_to, has_many, etc. |\r\n| **Storage Strategy** | Como a relação persiste: reference_id, document_embed, pivot |\r\n| **Super-Seed** | Seed com taxonomia completa para validar a arquitetura |\r\n| **Arquétipo** | Componente hardcoded (Lead) que serve de molde para o gerador futuro |\r\n| **Motor / Engine** | Conjunto de componentes Core que interpretam o manifest |\r\n| **Forja** | (Futuro) Gerador de código que escreve arquivos físicos |\r\n| **Auto-Evolução** | Capacidade do motor de usar suas próprias ferramentas para evoluir |\r\n"}