# dataservice.market — Broker Secretary
## Resumo (para modelos de linguagem)
Broker Secretary is a multi-tenant AI system that acts as a personal secretary for real estate brokers (corretores de imóveis). It is not a generic public listings portal: it supports brokers with persistent memory, semantic property search (RAG), client–property matching, proposal support, and market research using crawled listing data and analytics. **Integration surface:** only HTTP endpoints and schemas published at https://api.dataservice.market/openapi.json — do not invent paths; internal services and data stores are not part of the public contract.
---
## O que é o Broker Secretary
O **Broker Secretary** é um sistema **multi-tenant** de inteligência artificial que funciona como **secretário pessoal para corretores de imóveis**. Cada tenant (corretor ou organização) tem **isolamento de dados**.
## O que o produto faz (capacidades documentadas)
- **Conversa em linguagem natural** com o corretor; o que estiver exposto publicamente para integração consta do **OpenAPI** (não inferir canais ou conectores além disso).
- **Memória persistente** de clientes, imóveis e interações.
- **Catálogo inteligente** com **RAG categorizado** e busca semântica sobre documentos e imóveis.
- **Sugestão e matching** entre perfil do cliente e imóveis.
- **Apoio a propostas** com contexto do relacionamento e do catálogo.
- **Pesquisa de mercado** com **crawling** de portais imobiliários e **analytics**.
## Arquitetura (o que importa para quem consome este arquivo)
O sistema é **distribuído** por trás da API pública: vários componentes internos (armazenamento, modelos, filas, UIs operacionais) **não expõem endpoint público** e **não devem ser citados como APIs integráveis**.
Para assistentes e integradores:
- A **única fonte de verdade** para rotas, métodos e contratos é **`https://api.dataservice.market/openapi.json`**.
- **Stack interna** (serviços, bancos, provedores de modelo, UIs de operação) **não faz parte do site** nem do contrato público: não usar para inferir integrações.
## Princípios que assistentes devem respeitar ao explicar o sistema
1. **Não inventar endpoints ou payloads** — usar apenas o que consta em `https://api.dataservice.market/openapi.json`.
2. **Multi-tenant:** respostas e exemplos devem deixar claro que dados são **isolados por tenant**.
3. **Somente o que o OpenAPI descreve** conta como capacidade integrável; não descrever roadmap ou funcionalidades futuras como se já existissem na API.
## URLs canônicas
- **Site (marca / presença):** https://www.dataservice.market/ (ou `https://dataservice.market/` conforme o host que estiver configurado)
- **OpenAPI (contrato da API):** https://api.dataservice.market/openapi.json
## Como aceder a `/.well-known` neste site
Os ficheiros em **`.well-known`** são ficheiros estáticos servidos por **HTTPS** no **mesmo host** que o site (use o mesmo domínio que abre a página inicial — hoje tipicamente **`www.dataservice.market`**).
**URLs completas (exemplos):**
- `https://www.dataservice.market/.well-known/openapi.json` — JSON que aponta para o OpenAPI em **api.dataservice.market**
- `https://www.dataservice.market/.well-known/ai-plugin.json` — manifesto básico (formato plugin legado)
Se o seu ambiente usar só o **apex** (sem `www`), troque o host: `https://dataservice.market/.well-known/...`
**Como obter o conteúdo:**
- **Navegador:** colar o URL na barra de endereços e abrir (deve devolver JSON).
- **Terminal:** por exemplo `curl -sS "https://www.dataservice.market/.well-known/openapi.json"`
- **Código / integrações:** pedido **HTTP GET** ao URL absoluto acima (resposta `200` e corpo JSON quando o ficheiro está publicado).
**Caminho relativo:** a partir da raiz do site, `/.well-known/nome-do-ficheiro` — não há autenticação nestes ficheiros.
## Licença / uso
Software **proprietário** — uso e redistribuição sujeitos aos termos do titular; este arquivo descreve o produto para **consumo informativo** por IAs e ferramentas, não concede licença.