@horizon-framework/website-dev-docs 2.3.0

package/checklists/ADICIONAR_CAMPO.md

@@ -0,0 +1,95 @@
+# Checklist: Adicionar Campo — 13 Arquivos que Mudam
+
+> Ao adicionar ou remover campo na busca, cards ou pagina do imovel.
+
+---
+
+## MAPA: Por onde um campo percorre
+
+```
+CRM externo → Pacote conversor → API entity-schema → Banco → Frontend schema
+→ fields-lists → select-fields → busca → cards → pagina → impressao
+```
+
+**SE ESQUECER QUALQUER PONTO, O CAMPO NAO FUNCIONA.**
+
+---
+
+## Arquivos que Mudam (ate 13)
+
+### Backend (apps/api/)
+
+1. **entity-schema.ts** — Adicionar campo com key, type, categories, ui.label, audit
+2. **create.sql** — ALTER TABLE adicionar coluna (se campo novo no banco)
+3. **generated-columns.sql** — Adicionar ao FTS tsvector (se campo textual buscavel)
+4. **computedFields/index.ts** — Se campo e computed (derivado de outros)
+
+### Prisma
+5. **Sync Prisma** — `npx prisma db pull` + `pnpm db:patch-relations` + `npx prisma generate`
+
+### Frontend Schema
+6. **schema.generated.json** — Regenerar: `npx tsx scripts/generate-schema.ts`
+
+### Frontend Listas
+7. **fields-lists.ts** — Adicionar campo na lista de atributos (FIELD_LISTS_REGISTRY)
+8. **select-fields.config.ts** — Adicionar campo no select dos cards
+
+### Frontend Busca
+9. **search-list/schema.ts** — Adicionar campo no schema Zod da busca
+10. **search-list/config/schema.ts** — Adicionar facet config
+11. **search-list/components/fields/** — Criar componente de filtro (se necessario)
+
+### Frontend Display
+12. **Resolvers** — Se campo precisa de resolver especifico
+13. **item-print** — Se campo deve aparecer na impressao
+
+---
+
+## Protocolo Passo a Passo
+
+### Etapa 1 — Backend
+- [ ] Adicionar campo no entity-schema.ts (key, type, categories, ui, audit)
+- [ ] Se campo novo no banco: `ALTER TABLE "Property" ADD COLUMN IF NOT EXISTS "campo" TIPO DEFAULT valor;`
+- [ ] Se campo textual buscavel: adicionar ao generated-columns.sql (FTS)
+- [ ] Se campo computed: adicionar logica em computedFields/index.ts
+- [ ] Verificar: campo correto no entity-schema
+
+### Etapa 2 — Prisma
+- [ ] `npx prisma db pull`
+- [ ] `pnpm db:patch-relations`
+- [ ] `npx prisma generate`
+- [ ] Verificar: prisma generate sem erros
+
+### Etapa 3 — Reiniciar API
+- [ ] REINICIAR A API (obrigatorio! Prisma Client cacheado!)
+- [ ] Verificar: API inicia sem erros
+- [ ] Se campo computed: re-sincronizar dados (upload)
+
+### Etapa 4 — Frontend Schema
+- [ ] `cd apps/web && npx tsx scripts/generate-schema.ts`
+- [ ] Verificar: campo aparece no schema.generated.json
+
+### Etapa 5 — Frontend Listas
+- [ ] Adicionar campo em fields-lists.ts (se deve aparecer na pagina)
+- [ ] Adicionar campo em select-fields.config.ts (se deve aparecer no card)
+
+### Etapa 6 — Frontend Busca (se campo filtravel)
+- [ ] Adicionar no schema Zod da busca
+- [ ] Adicionar config de facet
+- [ ] Criar componente de filtro se necessario
+
+### Etapa 7 — Verificacao
+- [ ] Rodar inspect-fields
+- [ ] Testar: campo aparece na pagina do imovel
+- [ ] Testar: campo aparece no card (se adicionado)
+- [ ] Testar: filtro funciona na busca (se adicionado)
+- [ ] `next build` sem erros
+
+---
+
+## Regras
+
+1. **Campos BOOLEAN em listas** — SEMPRE filtrar `.filter(f => f.value === true)` apos getFieldsByKeys
+2. **SEMPRE reiniciar API** apos mudancas no banco/Prisma
+3. **SEMPRE regenerar schema** apos mudancas no entity-schema
+4. **NUNCA usar ALTER TABLE** para adicionar coluna em tabela que nao existe (so ao trocar CRM inteiro)

package/checklists/CRIAR_SITE_NOVO.md

@@ -0,0 +1,163 @@
+# Checklist: Criar Site Novo — Template Horizon ate Publicacao
+
+> Checklist completa para transformar o template Horizon base em um site de cliente.
+
+---
+
+## Fase 1 — Setup Inicial
+
+- [ ] Clonar template Horizon base (horizon-starter-2.x)
+- [ ] Criar repositorio no GitHub para o cliente
+- [ ] Configurar pnpm install em todos os apps (web, api, automations)
+- [ ] Criar banco PostgreSQL no DigitalOcean (ou provider)
+- [ ] Executar extensoes PostGIS: `pnpm db:setup`
+- [ ] Criar tabelas: `pnpm db:create`
+- [ ] Gerar Prisma client: `npx prisma generate`
+- [ ] Configurar .env em cada app (web, api, automations)
+- [ ] Testar: API rodando na porta 5000
+- [ ] Testar: Web rodando na porta 3001
+- [ ] Testar: Automations rodando na porta 8080
+
+---
+
+## Fase 2 — Identidade do Cliente
+
+### Branding
+- [ ] Trocar logo (`/public/brand/logo.svg` ou similar)
+- [ ] Trocar favicon (`/public/brand/favicon.png`)
+- [ ] Trocar OG image (`/public/brand/og-image.svg`, 800x450)
+- [ ] Trocar cores primaria/secundaria no tema (tailwind config ou CSS vars)
+- [ ] Trocar nome no title suffix (`capabilities/metatags/seo.ts`)
+
+### Contatos
+- [ ] Editar `capabilities/contacts/data/contacts.data.ts` — telefones, emails, WhatsApp
+- [ ] Editar redes sociais — Instagram, Facebook, etc.
+- [ ] Configurar WhatsAppProvider — numero, mensagem, avatar do atendente
+
+### Textos Institucionais
+- [ ] Trocar conteudo da pagina Quem Somos
+- [ ] Trocar enderecos na pagina Localizacao
+- [ ] Trocar textos na pagina Contato
+- [ ] Trocar nome empresa nos Termos de Uso
+- [ ] Trocar nome empresa na Politica de Privacidade
+- [ ] Trocar texto da pagina Anuncie
+- [ ] Trocar texto da pagina Encomende
+- [ ] Trocar texto da pagina Obrigado
+
+---
+
+## Fase 3 — Integracao CRM
+
+- [ ] Definir CRM do cliente (Jetimob, SI9, Publisher, Arbo)
+- [ ] Instalar pacote CRM no backend: `pnpm add @horizon-integrations/{crm}-crm`
+- [ ] Ler FICHA_TECNICA_INTEGRACAO.md do pacote CRM
+- [ ] Configurar entity-schema.ts com schema do CRM
+- [ ] Recriar tabela no banco com novos campos
+- [ ] Sincronizar Prisma: `npx prisma db pull && npx prisma generate`
+- [ ] Reiniciar API
+- [ ] Fazer primeiro sync de dados (upload imoveis)
+- [ ] Verificar: imoveis aparecendo na API
+- [ ] Regenerar schema no frontend: `npx tsx scripts/generate-schema.ts`
+- [ ] Verificar: imoveis aparecendo no site
+- [ ] Rodar inspect-fields para verificar cobertura de campos
+- [ ] Ajustar campos na busca (search-list/config)
+- [ ] Ajustar campos nos cards (select-fields.config.ts)
+- [ ] Ajustar campos na pagina do imovel (fields-lists.ts)
+
+---
+
+## Fase 4 — Configuracao do Frontend
+
+### Home Page
+- [ ] Trocar hero (imagem, titulo, subtitulo)
+- [ ] Configurar barra de busca (campos, opcoes)
+- [ ] Configurar vitrines de destaque (filtros)
+- [ ] Trocar categorias do carousel
+- [ ] Trocar depoimentos (se houver)
+
+### Navegacao
+- [ ] Verificar menus dinamicos (Venda, Locacao) — automatico via API
+- [ ] Ajustar menus estaticos (Especiais, Institucional)
+- [ ] Verificar footer
+- [ ] Verificar menu mobile
+
+### Busca de Imoveis
+- [ ] Verificar filtros disponiveis
+- [ ] Verificar facets funcionando
+- [ ] Verificar mapa (se lat/lng disponiveis)
+- [ ] Verificar paginacao
+- [ ] Verificar ordenacao
+
+### Pagina do Imovel
+- [ ] Verificar fotos/galeria
+- [ ] Verificar campos de atributos
+- [ ] Verificar formulario de contato
+- [ ] Verificar imoveis similares
+- [ ] Verificar botao WhatsApp
+- [ ] Verificar impressao (print)
+
+---
+
+## Fase 5 — Marketing e SEO
+
+- [ ] Configurar Google Tag Manager ID (`capabilities/code-snippets/scripts-marketing.tsx`)
+- [ ] Configurar Google Analytics ID
+- [ ] Configurar Facebook Pixel ID
+- [ ] Verificar sitemap.xml funcionando
+- [ ] Verificar meta tags em cada pagina
+- [ ] Verificar OG tags para compartilhamento
+- [ ] Configurar redirects se necessario (`capabilities/redirects/`)
+
+---
+
+## Fase 6 — Automations (Leads)
+
+- [ ] Configurar RESEND_API_KEY (emails)
+- [ ] Configurar chaves do CRM (se enviar leads pro CRM)
+- [ ] Testar envio de lead pelo formulario de contato
+- [ ] Verificar email chegando
+- [ ] Verificar lead chegando no CRM (se configurado)
+- [ ] Configurar CORS para dominio do cliente
+
+---
+
+## Fase 7 — Deploy Vercel
+
+- [ ] Criar projeto WEB na Vercel
+- [ ] Criar projeto API na Vercel (region gru1)
+- [ ] Criar projeto AUTOMATIONS na Vercel
+- [ ] Configurar variaveis de ambiente em cada projeto
+- [ ] Fazer primeiro deploy de cada app
+- [ ] Testar: site funcionando no dominio Vercel
+- [ ] Configurar dominio customizado do cliente
+- [ ] Configurar DNS (A record ou CNAME)
+- [ ] Verificar SSL (automatico Vercel)
+- [ ] Testar: site funcionando no dominio do cliente
+
+---
+
+## Fase 8 — Verificacao Final
+
+- [ ] Testar TODAS as paginas basicas no desktop
+- [ ] Testar TODAS as paginas basicas no mobile
+- [ ] Testar formularios (contato, anuncie, encomende)
+- [ ] Testar busca de imoveis (filtros, mapa, paginacao)
+- [ ] Testar favoritos
+- [ ] Testar compartilhamento
+- [ ] Testar impressao de imovel
+- [ ] Testar WhatsApp flutuante
+- [ ] Testar links de redes sociais
+- [ ] Verificar Google Analytics recebendo dados
+- [ ] Verificar performance (Lighthouse > 80)
+- [ ] Verificar SEO (meta tags, sitemap, robots.txt)
+- [ ] `next build` sem erros em web e api
+
+---
+
+## Fase 9 — Documentacao do Cliente
+
+- [ ] Criar `/ai/horizon.config.md` com dados do cliente
+- [ ] Criar `/ai/client/INFO.md` com informacoes do cliente
+- [ ] Criar `/ai/client/CUSTOMIZACOES.md` com campos extras
+- [ ] Atualizar Notion do cliente com estado do projeto
+- [ ] Registrar no Notion: dominio, CRM, modulos, paginas ativas

package/checklists/PUBLICAR_SITE.md

@@ -0,0 +1,75 @@
+# Checklist: Publicar Site — Deploy Vercel + Dominio
+
+> Passos para colocar o site em producao.
+
+---
+
+## Fase 1 — Build Local
+
+- [ ] `cd apps/web && pnpm build` — sem erros
+- [ ] `cd apps/api && pnpm build` — sem erros
+- [ ] `cd apps/automations && pnpm build` — sem erros
+- [ ] Verificar: TypeScript sem erros em todos os apps
+
+---
+
+## Fase 2 — Criar Projetos na Vercel
+
+### API
+- [ ] Criar projeto na Vercel: nome `{cliente}-api`
+- [ ] Root directory: `apps/api`
+- [ ] Framework: Next.js
+- [ ] Region: gru1 (Sao Paulo)
+- [ ] Configurar env vars: DATABASE_URL, API_SECRET_KEY, API_BASE_URL, FRONTEND_BASE_URL
+- [ ] Deploy
+
+### Web
+- [ ] Criar projeto na Vercel: nome `{cliente}-web`
+- [ ] Root directory: `apps/web`
+- [ ] Framework: Next.js
+- [ ] Configurar env vars: API_SECRET_KEY, ADMIN_PASSWORD, NEXT_PUBLIC_SITE_URL, NEXT_PUBLIC_API_URL, NEXT_PUBLIC_AUTOMATIONS_URL
+- [ ] Atualizar NEXT_PUBLIC_API_URL para URL da API na Vercel
+- [ ] Deploy
+
+### Automations
+- [ ] Criar projeto na Vercel: nome `{cliente}-automations`
+- [ ] Root directory: `apps/automations`
+- [ ] Framework: Next.js
+- [ ] Configurar env vars: API_SECRET_KEY, RESEND_API_KEY, chaves CRM, NEXT_PUBLIC_API_URL
+- [ ] Atualizar CORS allowed origins com dominio do cliente
+- [ ] Deploy
+
+---
+
+## Fase 3 — Dominio Customizado
+
+- [ ] Adicionar dominio no projeto Web da Vercel
+- [ ] Configurar DNS no registrador do cliente:
+  - A record: `76.76.21.21` (Vercel)
+  - CNAME www: `cname.vercel-dns.com`
+- [ ] Aguardar propagacao DNS (ate 48h, geralmente minutos)
+- [ ] Verificar SSL automatico (Vercel gera certificado)
+- [ ] Testar: site acessivel pelo dominio do cliente
+
+---
+
+## Fase 4 — Pos-Deploy
+
+- [ ] Verificar: todas as paginas carregando
+- [ ] Verificar: API respondendo (testar /api/property/search)
+- [ ] Verificar: leads chegando (formulario de contato)
+- [ ] Verificar: emails sendo enviados (Resend)
+- [ ] Verificar: Google Analytics recebendo dados
+- [ ] Verificar: sitemap.xml acessivel
+- [ ] Verificar: robots.txt correto
+- [ ] Verificar: OG tags funcionando (compartilhar no WhatsApp/Facebook)
+- [ ] Verificar: performance Lighthouse > 80
+
+---
+
+## IMPORTANTE
+
+- NUNCA matar portas do frontend (3000, 3001) — pode ter OUTRO site rodando
+- API backend (5000) — pode matar e reiniciar livremente
+- Atualizar NEXT_PUBLIC URLs apos deploy (apontam para Vercel, nao localhost)
+- CORS do automations deve incluir dominio de producao do cliente

package/checklists/TROCAR_CRM.md

@@ -0,0 +1,96 @@
+# Checklist: Trocar CRM — Migrar de um Provedor para Outro
+
+> 25+ passos para migrar completamente de um CRM para outro.
+
+---
+
+## Pre-requisitos
+
+- [ ] Saber CRM atual e CRM destino
+- [ ] Ter pacote NPM do CRM destino disponivel (`@horizon-integrations/{crm}-crm`)
+- [ ] Ler FICHA_TECNICA_INTEGRACAO.md do CRM destino
+- [ ] Ter credenciais de API do novo CRM
+
+---
+
+## Fase 1 — Backend
+
+### Pacote CRM
+- [ ] Instalar novo pacote: `cd apps/api && pnpm add @horizon-integrations/{novo-crm}-crm`
+- [ ] Remover pacote antigo: `pnpm remove @horizon-integrations/{antigo-crm}-crm`
+- [ ] Atualizar package.json
+
+### Entity Schema
+- [ ] Abrir `src/modules/property/schemas/entity-schema.ts`
+- [ ] Trocar import do schema: de `{antigo}` para `{novo}`
+- [ ] Revisar overrides locais (podem ter campos que nao existem no novo CRM)
+- [ ] Revisar computed fields (podem depender de campos do CRM antigo)
+- [ ] Verificar: key, type, categories, ui.label corretos para cada campo
+
+### Banco de Dados
+- [ ] DROP tabela Property: `pnpm db:drop` (CUIDADO: perde dados!)
+- [ ] Recriar tabela com novos campos: `pnpm db:create`
+- [ ] Executar generated-columns.sql (FTS, PostGIS)
+- [ ] Sincronizar Prisma: `npx prisma db pull`
+- [ ] Patch relations: `pnpm db:patch-relations`
+- [ ] Gerar client: `npx prisma generate`
+- [ ] Verificar: `SELECT column_name FROM information_schema.columns WHERE table_name='Property'`
+
+### API
+- [ ] Reiniciar API (Prisma Client e cacheado!)
+- [ ] Verificar: API inicia sem erros
+- [ ] Configurar credenciais do novo CRM no .env
+- [ ] Fazer primeiro sync de dados (upload)
+- [ ] Verificar: dados chegando corretamente
+- [ ] Verificar: 0 erros no sync
+
+---
+
+## Fase 2 — Frontend
+
+### Schema
+- [ ] Regenerar schema: `cd apps/web && npx tsx scripts/generate-schema.ts`
+- [ ] Verificar: campo aparece no schema.generated.json
+
+### Busca
+- [ ] Revisar `search-list/config/schema.ts` — facets podem ter mudado
+- [ ] Revisar componentes de filtro — campos podem nao existir mais
+- [ ] Revisar ranges — valores min/max podem ser diferentes
+- [ ] Testar: busca funcionando com novos campos
+
+### Cards
+- [ ] Revisar `select-fields.config.ts` — campos do card
+- [ ] Verificar: campos existem no novo schema
+- [ ] Testar: cards renderizando corretamente
+
+### Pagina do Imovel
+- [ ] Revisar `fields-lists.ts` (FIELD_LISTS_REGISTRY)
+- [ ] Verificar: campos de atributos existem
+- [ ] Verificar: labels corretos
+- [ ] Testar: pagina renderizando corretamente
+
+### Navegacao
+- [ ] Menus dinamicos se adaptam automaticamente (vem da API)
+- [ ] Verificar: contagens atualizadas nos menus
+
+---
+
+## Fase 3 — Verificacao
+
+- [ ] Rodar inspect-fields: `npx tsx src/modules/property/core/cli/inspect-fields.ts`
+- [ ] Verificar: cobertura de campos (publicos, orfaos, ocultos)
+- [ ] Acessar `/imovel/inspect/{referencia}` — tab "Exibicao dos campos"
+- [ ] Verificar: nenhum campo orfao critico
+- [ ] Testar: busca completa (filtros, facets, mapa)
+- [ ] Testar: pagina do imovel completa
+- [ ] Testar: cards na listagem
+- [ ] `next build` sem erros
+
+---
+
+## Fase 4 — Automations
+
+- [ ] Atualizar credenciais do novo CRM no .env do automations
+- [ ] Atualizar pacote CRM no automations (se usado la)
+- [ ] Testar: sync automatico funcionando
+- [ ] Testar: leads chegando no novo CRM

package/commercial/PACOTES_PAGINAS.md

@@ -0,0 +1,86 @@
+# Pacotes Comerciais — Horizon Platform
+
+> Definicao dos pacotes de venda do Horizon.
+
+---
+
+## Horizon Starter 2.0 — Pacote Base (R$ 6.200)
+
+### O que inclui
+
+**14 paginas basicas:**
+1. Home Page
+2. Busca/Lista de Imoveis (com filtros avancados)
+3. Pagina do Imovel (detalhes completos)
+4. Perfil do Corretor
+5. Favoritos
+6. Imoveis Compartilhados
+7. Quem Somos
+8. Localizacao/Unidades
+9. Formulario de Contato
+10. Financiamento
+11. Anuncie seu Imovel
+12. Encomende seu Imovel
+13. Pagina de Agradecimento
+14. Termos de Uso + Politica de Privacidade
+
+**Modulo imobiliario completo:**
+- Integracao com 1 CRM (configuravel)
+- Busca avancada com filtros dinamicos
+- Mapa com geolocalizacao
+- Favoritos e compartilhamento
+- SEO otimizado (sitemap, meta tags)
+- Full-text search em portugues
+
+**Infraestrutura inclusa:**
+- Deploy Vercel (web + api + automations)
+- Banco PostgreSQL com PostGIS
+- Envio de leads por email (Resend)
+- Widget WhatsApp flutuante
+- Google Analytics + GTM
+- Multilingue (PT, EN, ES)
+- Responsivo (mobile-first)
+
+---
+
+## Paginas Avancadas — Sob Medida (orcamento separado)
+
+Paginas customizadas desenvolvidas especificamente para o cliente:
+- Pagina de imoveis premium/luxo
+- Blog integrado
+- Area do cliente (portal)
+- Pagina para investidores
+- Pagina para estrangeiros
+- Pagina de equipe/corretores
+- Galeria Instagram integrada
+- Pagina setor agro/rural
+- FAQ interativo
+- Depoimentos
+- Qualquer pagina institucional customizada
+
+**Referencia de estilo:** Ver paginas avancadas do projeto Guise (8 paginas de exemplo).
+
+---
+
+## Modulos Adicionais — Expansoes (orcamento separado)
+
+| Modulo | Descricao | Status |
+|---|---|---|
+| Corretor (avancado) | Perfis completos, busca por corretor | Disponivel |
+| Blog | Sistema de posts com MDX | Futuro |
+| Condominio/Empreendimento | Integracao com CRM | Futuro |
+| Instagram Advanced | Feed integrado com categorias | Futuro |
+| Cidade e Bairros | Guia de bairros com dados | Futuro |
+
+---
+
+## Integracoes CRM — Disponiveis
+
+| CRM | Pacote | Pronto |
+|---|---|---|
+| Jetimob | @horizon-integrations/jetimob-crm | Sim |
+| SI9 | @horizon-integrations/si9-crm | Sim |
+| Publisher | @horizon-integrations/publisher-crm | Sim |
+| Arbo | @horizon-integrations/arbo-crm | Sim |
+| Vista | (futuro) | Nao |
+| Flexpro | (futuro) | Nao |

package/commercial/POSSIBILIDADES_VENDA.md

@@ -0,0 +1,52 @@
+# Possibilidades de Venda — O que Oferecer ao Cliente
+
+> Lista de servicos e expansoes que podem ser vendidos alem do pacote base.
+
+---
+
+## Expansoes de Paginas
+
+| Pagina | Complexidade | Valor Sugerido | Exemplo |
+|---|---|---|---|
+| Pagina institucional simples | Baixa | R$ 500-800 | FAQ, Depoimentos |
+| Pagina institucional avancada | Media | R$ 1.000-2.000 | Equipe, Sobre Nos customizado |
+| Pagina de produto/servico | Media | R$ 1.500-2.500 | Imoveis Premium, Investidores |
+| Portal do cliente | Alta | R$ 3.000-5.000 | Area do Cliente com subpaginas |
+| Blog completo | Alta | R$ 2.000-4.000 | Posts, categorias, busca |
+| Landing page campanha | Baixa | R$ 800-1.500 | Lancamento, promocao |
+
+---
+
+## Expansoes de Modulos
+
+| Modulo | O que faz | Valor Sugerido |
+|---|---|---|
+| Corretor avancado | Perfis, busca, showcase | R$ 1.500-2.500 |
+| Condominio | Empreendimentos com plantas | R$ 3.000-5.000 |
+| Blog + MDX | Posts ricos com componentes | R$ 2.000-3.000 |
+| Instagram Feed | Feed integrado, categorias | R$ 1.000-2.000 |
+| Guia de Bairros | Mapas, dados, fotos | R$ 2.000-3.500 |
+
+---
+
+## Servicos Recorrentes
+
+| Servico | Descricao | Valor Mensal |
+|---|---|---|
+| Manutencao | Updates, correcoess, ajustes | R$ 300-600/mes |
+| SEO avancado | Otimizacao continua | R$ 500-1.000/mes |
+| Conteudo | Paginas novas, blog posts | Sob demanda |
+| Integracao CRM novo | Trocar/adicionar CRM | R$ 1.000-2.000 (unico) |
+
+---
+
+## Como Identificar Oportunidades
+
+O agente UX pode analisar o site do cliente e identificar:
+1. **Paginas faltando** — ex: cliente nao tem FAQ, depoimentos
+2. **Modulos uteis** — ex: cliente tem corretores mas nao tem modulo broker avancado
+3. **Integracoes** — ex: cliente usa CRM que ainda nao tem conversor
+4. **Melhorias visuais** — ex: paginas basicas que podem ser "upadas" para avancadas
+5. **Performance** — ex: SEO que pode ser melhorado
+
+Essas informacoes ficam em `/ai/client/ANOTACOES.md` e no Notion do cliente.

package/index.md

@@ -0,0 +1,54 @@
+# Horizon Platform Docs — Website Dev Docs
+
+> Documentacao inteligente da plataforma Horizon para agentes de IA.
+> Versao: 2.3.0
+
+---
+
+## Agentes (instrucoes de comportamento)
+- [AGENTE_FULLSTACK.md](./agents/AGENTE_FULLSTACK.md) — Desenvolvedor full stack completo: backend, frontend, banco, deploy
+- [AGENTE_LAYOUT_DESIGNER.md](./agents/AGENTE_LAYOUT_DESIGNER.md) — Regras de UI/UX, tipografia, cores, secoes, componentes visuais
+- [AGENTE_UX_CLIENTE.md](./agents/AGENTE_UX_CLIENTE.md) — Relacionamento com cliente, Notion, vendas, experiencia do usuario
+
+## Knowledge — Arquitetura Geral
+- [ARQUITETURA_GERAL.md](./knowledge/ARQUITETURA_GERAL.md) — 5 partes: web, api, automacao, /ai/, /dev/
+- [SISTEMA_MODULAR.md](./knowledge/SISTEMA_MODULAR.md) — Como funcionam modulos, como criar/instalar novos
+- [SISTEMA_SCHEMAS.md](./knowledge/SISTEMA_SCHEMAS.md) — Domain models, 45 campos base, SSOT, conversores CRM
+
+## Knowledge — API e Backend
+- [API_PROPERTY.md](./knowledge/API_PROPERTY.md) — Stack, arquitetura, endpoints da API
+- [SEARCH_ENGINE_API.md](./knowledge/SEARCH_ENGINE_API.md) — Motor de busca, facets, pagination, cursor vs offset
+- [BATCH_TOTALS_API.md](./knowledge/BATCH_TOTALS_API.md) — API batch totals, contagens dinamicas
+- [SSOT_SPECIFICATION_V2.md](./knowledge/SSOT_SPECIFICATION_V2.md) — Spec SSOT v2.0, metadados hierarquicos
+- [MODULE_CREATION_PATTERN.md](./knowledge/MODULE_CREATION_PATTERN.md) — Padrao de criacao de modulos backend + frontend
+
+## Knowledge — Frontend e UI
+- [ARQUITETURA_MODULOS_WEB.md](./knowledge/ARQUITETURA_MODULOS_WEB.md) — Arquitetura de modulos frontend (core/features)
+- [NAVEGACAO_DINAMICA.md](./knowledge/NAVEGACAO_DINAMICA.md) — Sistema de navegacao dinamica, menus, fetchers
+- [UI_KIT_COMPLETO.md](./knowledge/UI_KIT_COMPLETO.md) — shadcn + extras Horizon + todos componentes
+- [HOOKS_REGISTRY.md](./knowledge/HOOKS_REGISTRY.md) — Todos hooks (tema, responsive, scroll, animacao)
+- [COMPONENTES_GLOBAIS_UI.md](./knowledge/COMPONENTES_GLOBAIS_UI.md) — Toast, modal, sheet, loading, etc.
+- [CAPABILITIES.md](./knowledge/CAPABILITIES.md) — Contatos, redes sociais, WhatsApp, snippets, SEO, sitemap
+
+## Knowledge — Design e Paginas
+- [DESIGN_AVANCADO.md](./knowledge/DESIGN_AVANCADO.md) — Como criar paginas e secoes custom, estilo de design, composicoes
+- [DESIGN_SYSTEM_CATALOG.md](./knowledge/DESIGN_SYSTEM_CATALOG.md) — Catalogo de secoes base
+- [PAGINAS_BASICAS.md](./knowledge/PAGINAS_BASICAS.md) — Pacote 14 paginas que todo site Horizon tem
+- [DESIGN_TEMPLATES_CATALOG.md](./knowledge/DESIGN_TEMPLATES_CATALOG.md) — Catalogo de templates: paginas, secoes, blocos prontos
+
+## Knowledge — Dominio e Dados
+- [DOMINIO_ENTIDADES.md](./knowledge/DOMINIO_ENTIDADES.md) — Fluxo de dados ponta a ponta
+- [CRMS_INTEGRACOES.md](./knowledge/CRMS_INTEGRACOES.md) — Pacotes CRM, FICHA_TECNICA, normalizacao
+
+## Checklists
+- [CRIAR_SITE_NOVO.md](./checklists/CRIAR_SITE_NOVO.md) — Template ate publicacao (tudo que trocar)
+- [TROCAR_CRM.md](./checklists/TROCAR_CRM.md) — Migrar de um CRM para outro (25+ passos)
+- [ADICIONAR_CAMPO.md](./checklists/ADICIONAR_CAMPO.md) — 13 arquivos que mudam ao adicionar campo
+- [PUBLICAR_SITE.md](./checklists/PUBLICAR_SITE.md) — Vercel, dominio, DNS, SEO
+
+## Comercial
+- [PACOTES_PAGINAS.md](./commercial/PACOTES_PAGINAS.md) — Basicas vs avancadas, o que vem incluso
+- [POSSIBILIDADES_VENDA.md](./commercial/POSSIBILIDADES_VENDA.md) — Modulos, paginas, integracoes vendaveis
+
+## Modulos
+- [property/MODULO_IMOBILIARIO.md](./modules/property/MODULO_IMOBILIARIO.md) — Modulo imobiliario completo