> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# página inicial

a rachel é a IA da teceo e ocupa a primeira tela depois do login.

## a rachel na tela inicial

a tela inicial é o primeiro contato com a plataforma. em vez de abrir com um resumo fixo, ela abre com a conversa da rachel, perguntando o que é preciso fazer.

a rachel responde sobre a própria plataforma: o que um termo quer dizer, como uma tela funciona, qual é o passo a passo de uma tarefa e o que entrou nas últimas atualizações. não é necessário sair da conversa para procurar na documentação.

| o que pedir | o que a rachel faz |
| - | - |
| entender um termo, uma tela ou um passo a passo | responde com base na documentação oficial da teceo, e mostra o link da página de origem |
| acompanhar as novidades da plataforma | responde com base no histórico de novidades publicado na documentação |

arquivos e imagens entram na conversa por **adicionar arquivos e imagens** ou arrastados sobre ela. as conversas ficam salvas: o título no topo abre **conversas com a rachel**, com busca e histórico por data, onde cada conversa é renomeada no próprio título ou excluída em definitivo.

as respostas precisam ser verificadas, porque a rachel é uma IA e pode errar.

<Info>
  a rachel depende de habilitação para a marca. sem ela, a tela inicial traz a saudação do dia, o menu lateral ganha o item **início** e, no acesso do lojista, a tela lista até cinco atalhos das marcas conectadas, com o botão **+** para **minhas conexões**.
</Info>

## o topo da tela

o topo e o menu lateral acompanham todas as telas da plataforma e dão acesso às demais áreas.

| elemento | o que faz |
| - | - |
| **menu** | abre o menu lateral de navegação, por onde se chega às áreas da plataforma. nas telas internas, dá lugar à seta de voltar |
| logotipo da marca | leva ao showroom da marca. no acesso do lojista, antes de entrar em uma marca, o topo traz o logotipo da teceo e leva à tela inicial |
| **selecionar marca** | troca a marca em que a loja está navegando. aparece apenas no acesso do lojista |
| **pesquisar** | abre a busca global da plataforma |
| **talão de pedidos** | abre o talão para criar ou selecionar um pedido. com um pedido ativo, o botão passa a mostrar o nome do cliente e um contador de itens ou peças |
| **voltar ao catálogo** | retorna ao último catálogo navegado, no ponto em que a navegação parou. depende de um catálogo já aberto antes, e fica fora da própria tela do catálogo |

o talão de pedidos e o retorno ao catálogo aparecem dentro de uma marca, e é ali que o lojista monta os pedidos.

## a busca global

a busca global encontra registros da plataforma sem depender da tela aberta. abre pelo botão **pesquisar** no topo ou pelo atalho **cmd + K** (**ctrl + K** no windows), e fecha com `esc` ou com um clique fora. a busca parte de três caracteres. no celular, ocupa a tela inteira, com seta de voltar no topo.

### o que a busca encontra

são seis tipos de registro, e cada pessoa vê apenas os tipos liberados para o seu perfil.

| tipo | o que abre | campos do próprio registro |
| - | - | - |
| produtos | os detalhes do produto | nome, código e referência |
| pedidos | o pedido | número do pedido e código externo |
| catálogos | os produtos do catálogo | nome e código |
| clientes | o cadastro do cliente | nome fantasia, razão social, código, CPF e CNPJ |
| notas fiscais | a listagem filtrada pela nota | número da nota e chave de acesso |
| contas a receber | a listagem filtrada pela parcela | código do título |

no acesso do lojista, contas a receber aparece como **contas a pagar**, e clientes fica de fora.

### chegar ao registro pelo que está dentro dele

a busca não olha apenas os campos do próprio registro: ela alcança um nível abaixo, o que permite chegar a um registro por aquilo que ele contém ou a quem ele pertence.

| buscar por | também traz |
| - | - |
| nome ou CNPJ do cliente | os pedidos, as notas fiscais e os títulos daquele cliente |
| nome do contato | o cliente em que o contato está cadastrado |
| nome da coleção | os catálogos que têm a coleção |
| código ou referência do produto | os catálogos que têm o produto, quando o termo casa com o começo ou o fim do código ou da referência, nunca com o meio |
| código do SKU ou código de barras | o produto do SKU |
| cor ou categoria | os produtos que têm aquela cor ou categoria |

esses resultados entram na mesma lista, abaixo de quem casou direto com o termo. o catálogo só aparece pelo produto para quem tem acesso a produtos, e apenas pelos produtos que a própria pessoa vê na busca. além disso, o catálogo precisa mostrar o produto para ela: entra quando tem uma cor desse produto à venda, ou quando exibe produtos indisponíveis, e quem tem permissão para ver produtos indisponíveis encontra o catálogo por qualquer cor ativa.

### as abas

o resultado é dividido em abas por tipo, na ordem produtos, pedidos, catálogos, clientes, notas fiscais e contas a receber, com a contagem ao lado do nome, que exibe **100+** quando passa desse teto. quando mais de um tipo retorna, a aba **tudo** abre a lista com todos misturados; quando só um tipo retorna, existe apenas a aba daquele tipo.

as abas **ações** (criar pedido, criar catálogo, criar cliente) e **atalhos** (ir para pedidos, catálogos, clientes) aparecem quando o termo casa com o nome de uma delas ou com um apelido configurado: digitar `ped` traz **criar pedido** e **ir para pedidos**, e atalhos como `novo pedido` e `coleção` exibem nos resultados as opções **criar pedido** e **ir para catálogos** respectivamente.

nas abas **clientes** e **catálogos**, o rodapé traz **ver pesquisa '\[termo]' em \[tipo]**, para quem precisa ampliar a pesquisa: o mesmo termo segue para a listagem, com o campo de busca já preenchido, e é lá que estão os filtros avançados, as colunas e as ações em lote.

na aba **produtos**, o rodapé carrega mais vinte resultados por vez. no celular, a lista continua conforme a rolagem.

### como o resultado é ordenado

cada resultado recebe uma nota de relevância pelo quanto o termo casa com os campos do registro, e a lista sai ordenada por essa nota, com os tipos misturados.

* identificadores, como código e código de barras, valem nota cheia no acerto exato, e menos no começo e no trecho do meio.
* código e referência do produto também casam sem espaço, hífen, ponto ou barra: digitar `1161129` encontra o produto cadastrado como `1 16 1 129`, logo abaixo do produto com o código idêntico ao digitado.
* documento (CPF ou CNPJ) vale nota cheia no acerto exato e menos no começo, sem casar pelo meio.
* a chave de acesso da nota vale nota cheia no acerto exato e menos no começo ou no fim, sem casar pelo meio.
* nomes valem pela proximidade com o texto digitado, e toleram acento, maiúscula e erro de digitação.
* os campos do nível abaixo pesam menos que o nome e o código do próprio registro.

em empate de nota, vale a ordem das abas.

### o campo vazio

antes de digitar, a busca já traz por onde começar.

| elemento | o que faz |
| - | - |
| buscas recentes | as cinco últimas buscas. clicar refaz a busca, e o **X** remove o item do histórico |
| catálogos sugeridos | até três catálogos, que abrem direto. só no acesso da marca |
| ler código de barras | abre a câmera e insere o código lido no campo de busca |

### agir a partir do resultado

nos resultados de produto, o botão **+** adiciona o produto ao pedido ativo sem sair da busca, do mesmo jeito que no catálogo: o produto adicionado passa a mostrar o check, e clicar no check remove. sem pedido ativo, a busca abre o talão para criar ou selecionar um pedido.

com um termo digitado, o campo traz o ícone de **perguntar à rachel**, que fecha a busca e abre uma conversa nova com o termo. na aba clientes, a conversa começa por `buscar por 'termo' em clientes`.

### atalhos de teclado

| atalho | o que faz |
| - | - |
| cmd + K / ctrl + K | abre a busca de qualquer tela |
| setas para cima e para baixo | percorrem os resultados |
| enter | abre o resultado em foco |
| cmd + enter / ctrl + enter | adiciona ao pedido o produto em foco |
| esc | fecha a busca |

## o menu lateral e o rodapé

o menu lateral lista as áreas da plataforma, da **rachel** a **configurações**, e mostra apenas o que está liberado para o perfil e habilitado para a marca.

| elemento do rodapé | o que faz |
| - | - |
| nome da marca ou da loja | abre o menu com **minha conta**, **trocar de time**, **trocar de usuário**, **novidades**, **docs**, **teceo status**, **relatar problema** e **sair** |
| destaques | abrem os avisos publicados na plataforma, com marcação nos não lidos |
| campo de mensagem | é o mesmo campo da tela inicial. nas outras telas ele fica no rodapé, e o ícone da rachel abre e fecha a conversa ao lado do conteúdo |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.