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

# Introdução

> O que é o muveya, o que ele não é, quem o usa e onde fica cada parte do produto

A **muveya** é onde uma clínica odontológica, ou uma rede de clínicas odontológicas, pede, aprova, movimenta e consome seus insumos com um registro completo de quem fez o quê. Um insumo é pedido por uma unidade, aprovado (por alguém diferente de quem pediu, quando a sua política exige uma decisão), reservado em um depósito, retirado caixa por caixa, despachado, entregue, recebido no destino e, por fim, consumido. Cada etapa fica registrada, e nada do que foi registrado é editado ou apagado.

O muveya se apoia em três ideias:

* **Uma única verdade operacional.** O estoque só muda por meio de lançamentos em um registro de movimentos que só aceita inclusões. Toda quantidade que você vê (em mãos, reservada, disponível) é derivada desse registro.
* **Menor privilégio, aplicado pelo servidor.** Ver estoque não significa ver custos, valores de pedidos ou referências de pacientes. Se a pessoa não tem a permissão, o servidor omite esses campos da resposta; o console nunca os recebe.
* **Dupla custódia.** Entregar e receber são atos distintos, registrados separadamente e, em geral, por pessoas diferentes.

## O que o muveya não é

| O muveya não é | O que isso significa para você |
| - | - |
| Um prontuário eletrônico | Um pedido clínico pode levar uma referência opaca do paciente (`patientRef`), como o código interno do seu sistema clínico. O muveya não tem onde guardar diagnósticos, odontogramas, planos de tratamento ou nomes de pacientes. |
| Um ERP ou sistema contábil | Os custos servem para mostrar valores de pedidos e orientar as aprovações. O muveya não emite faturas, não paga fornecedores nem faz a contabilidade. |
| Um marketplace ou portal de compras | Você registra o que chegou dos seus fornecedores; o muveya não emite ordens de compra para eles nem compara cotações. |
| Um chatbot de uso geral | O canal do WhatsApp executa operações curtas e guiadas, com confirmação explícita. Nunca aprova pedidos nem altera estoque por conta própria. |

## Quem usa

No console, cada pessoa pertence à sua **Clínica odontológica** com uma de três funções: **Proprietário**, **Administrador** ou **Membro**. A função é só um modelo inicial. O que a pessoa pode fazer de fato é a lista de permissões atribuídas a ela, mais as unidades e os depósitos que ela alcança. As funções de proprietário e administrador incluem só `catalog.read`, `catalog.manage`, `members.manage` e `settings.manage`; a função de membro inclui só `catalog.read`. Todo o resto, como ver o estoque, criar pedidos ou aprová-los, é concedido de forma explícita, inclusive a um proprietário.

A tabela mostra pessoas típicas e as permissões que costumam receber. É um guia, não uma regra: dê a cada pessoa exatamente o que o trabalho dela exige. [Funções e permissões](/docs/pt/account/roles-and-permissions) lista todas as permissões.

| Pessoa | O que faz no muveya | Permissões que costuma ter |
| - | - | - |
| Proprietário ou administrador | Configura unidades, depósitos, salas e áreas, o catálogo e a equipe | `settings.manage`, `members.manage`, `catalog.manage` (incluídas na função) |
| Responsável por compras ou pelo catálogo | Mantém insumos, apresentações e custos | `catalog.manage`, `catalog.cost.read` |
| Aprovador (gestão) | Decide os pedidos que a política de aprovação envia para ele | `approvals.decide`, `orders.value.read`, e `approvals.policy.manage` para quem mantém a política |
| Gestor de unidade | Pede insumos para a unidade, recebe entregas, acompanha o estoque | `orders.create`, `inventory.read`, `inventory.receive`, `receipt.confirm`, `fulfillment.read`, `fulfillment.close` |
| Operador de depósito | Recebe estoque, prepara e despacha pedidos, transfere e conta caixas | `inventory.read`, `inventory.receive`, `inventory.transfer`, `fulfillment.pick`, `fulfillment.dispatch`, `delivery.confirm`, e `inventory.adjust` se também corrige estoque |
| Assistente ou técnico de laboratório | Registra o que foi consumido | `inventory.read`, `inventory.consume` |
| Profissional clínico | Pede insumos, inclusive pedidos clínicos para um paciente | `orders.create`, `orders.clinical.create` |
| Gestor que acompanha números | Consulta o consumo | `reports.read` |

<Note>
  A permissão `audit.read` pode ser atribuída, mas ainda não existe tela nem API que pesquise o histórico de auditoria. Os registros de auditoria são guardados mesmo assim. Para acompanhar hoje o que aconteceu com uma caixa ou um pedido, use os **Movimentos** da caixa e o **Histórico** do pedido.
</Note>

## Onde o muveya fica

<CardGroup cols={2}>
  <Card title="Console web" icon="window-maximize" href="/docs/pt/quickstart">
    `https://console.muveya.com`. Configuração, pedidos, aprovações, entregas, estoque, contagens, relatórios e gestão da equipe. Funciona no computador e no navegador do celular, em inglês, espanhol e português.
  </Card>

  <Card title="Canal do WhatsApp" icon="whatsapp" href="/docs/pt/whatsapp/overview">
    Uma pessoa da equipe com o celular vinculado pode consultar uma caixa, registrar consumo e receber estoque pelo celular, exatamente com as permissões que tem no console. O console ainda não tem uma tela para vincular um celular; a visão geral explica como a vinculação funciona. O canal ainda não está ativado no serviço de produção.
  </Card>

  <Card title="App Android" icon="android" href="/docs/pt/android/overview">
    Um app nativo para celular que escaneia etiquetas de caixas e códigos de fornecedor, registra usos, transfere caixas e recebe entregas, com as mesmas permissões do console. Ainda não está publicado no Google Play: escreva para [team@muveya.com](mailto:team@muveya.com) para usá-lo.
  </Card>

  <Card title="API pública /v1" icon="code" href="/docs/pt/api-reference/introduction">
    `https://api.muveya.com/v1`. Acesso somente leitura a unidades, depósitos, catálogo, estoque, pedidos, atendimento e análises, mais uma escrita: `POST /v1/analytics/exports`. Ainda não há webhooks, e as chaves de API não são criadas pelo console: escreva para [team@muveya.com](mailto:team@muveya.com) para solicitar uma.
  </Card>

  <Card title="MCP" icon="robot" href="/docs/pt/mcp/introduction">
    Um endpoint Model Context Protocol somente leitura em `/mcp`, autenticado pelo Console com OAuth, para que um assistente de IA consulte estoque, pedidos e números de gestão. Ele não pode aprovar, movimentar estoque nem alterar nada.
  </Card>
</CardGroup>

O [app Android](/docs/pt/android/overview) nativo ainda não está disponível para todos (escreva para [team@muveya.com](mailto:team@muveya.com) para usá-lo), então, enquanto isso, use o console no navegador do seu celular.

## A tela Início

Depois de entrar, o console abre em **Início**. A tela é montada conforme as permissões que você tem, então duas pessoas veem cartões diferentes.

<AccordionGroup>
  <Accordion title="Para começar a operar">
    Aparece enquanto falta algo para a sua clínica odontológica operar, e só para o que você pode criar. Cada cartão abre a tela que resolve a pendência:

    | Cartão | Aparece quando | Abre | Necessário para ver |
    | - | - | - | - |
    | **Crie a primeira unidade** | Ainda não há unidades. O fluxo cria a unidade e depois oferece o depósito principal dela. | **Unidades** | função de proprietário ou administrador, ou `settings.manage` |
    | **Crie um depósito** | Há unidades, mas nenhum depósito | **Depósitos** | função de proprietário ou administrador, ou `settings.manage` |
    | **Adicione o primeiro insumo** | O catálogo está vazio | **Novo insumo** | função de proprietário ou administrador, ou `catalog.manage` |
    | **Adicione como os insumos são embalados** | Há insumos, mas nenhum tem apresentação ativa | **Catálogo** | função de proprietário ou administrador, ou `catalog.manage` |
    | **Convide a sua equipe** | Você é a única pessoa ativa e não há convites pendentes | **Convidar pessoa** | função de proprietário ou administrador, ou `members.manage` |
    | **Ainda não há política de aprovação: os pedidos enviados aguardam até que uma seja publicada** | Nenhuma política de aprovação foi publicada | **Política de aprovação** | `approvals.policy.manage` |
  </Accordion>

  <Accordion title="Trabalho pendente">
    O que espera por você agora, um cartão para cada permissão que você tem. Cada cartão mostra quantos itens aguardam (uma página cheia aparece como `50+` ou `200+`) e abre a fila certa. Cartões sem pendências ficam ocultos; quando não há nada, você vê **Não há nada esperando por você agora.**

    | Cartão | Conta | Abre | Permissão |
    | - | - | - | - |
    | **Pedidos aguardando a sua aprovação** | Pedidos das suas unidades que aguardam sua decisão (nunca os seus) | **Aprovação de pedidos** | `approvals.decide` |
    | **Pedidos a preparar** | Pedidos em `allocated` ou `picking` | **Entregas** | `fulfillment.pick` ou `fulfillment.dispatch` |
    | **Entregas a confirmar** | Pedidos em `dispatched` | **Entregas** | `delivery.confirm` |
    | **Pedidos a receber** | Pedidos em `delivered` | **Entregas** | `receipt.confirm` |
    | **Pedidos a encerrar** | Pedidos em `received` ou `partially_fulfilled` | **Entregas** | `fulfillment.close` |
    | **Rascunhos de pedidos** | Pedidos em `draft` | **Pedidos** | `orders.create` |
    | **Alertas de estoque abertos** | Alertas abertos de estoque baixo e de validade nos seus depósitos | **Alertas de estoque** | `inventory.read` |
    | **Caixas a contar** | Caixas não contadas nos últimos 30 dias | **Contagens** | `inventory.read` |
  </Accordion>

  <Accordion title="Sua clínica odontológica">
    O nome da clínica odontológica em que você está trabalhando, o e-mail com que você entrou e o link **Escolha uma clínica odontológica** para mudar para outra clínica odontológica da qual você faz parte.
  </Accordion>
</AccordionGroup>

A barra lateral (ou o menu no celular) mostra **Início**, **Pedidos**, **Aprovação de pedidos**, **Entregas**, **Unidades**, **Depósitos**, **Catálogo**, **Inventário**, **Reposição**, **Correções de estoque**, **Relatórios** e **Equipe**. **Pedidos**, **Aprovação de pedidos**, **Entregas**, **Relatórios** e **Equipe** só aparecem para quem participa desse trabalho. Ocultar um link é só uma comodidade: o servidor verifica cada solicitação por conta própria.

## Guias

<CardGroup cols={2}>
  <Card title="Início rápido" icon="rocket" href="/docs/pt/quickstart">
    De uma conta nova a um insumo recebido, consumido e reportado.
  </Card>

  <Card title="Conceitos" icon="shapes" href="/docs/pt/concepts">
    Clínica odontológica, unidades, depósitos, caixas, registro de movimentos, pedidos e custódia.
  </Card>

  <Card title="Conta e equipe" icon="users" href="/docs/pt/account/team">
    Entre, convide pessoas, atribua permissões e acesso a unidades e depósitos.
  </Card>

  <Card title="Unidades e depósitos" icon="building" href="/docs/pt/locations/clinics">
    Unidades, depósitos centrais e express, salas e áreas.
  </Card>

  <Card title="Catálogo" icon="boxes-stacked" href="/docs/pt/catalog/items">
    Insumos, categorias, apresentações, códigos, custos e CSV.
  </Card>

  <Card title="Estoque" icon="warehouse" href="/docs/pt/inventory/overview">
    Receba, consuma, transfira, corrija, conte, reponha e recolha lotes.
  </Card>

  <Card title="Pedidos e aprovações" icon="clipboard-check" href="/docs/pt/orders/create-and-track">
    Peça insumos, decida pedidos e publique a política de aprovação.
  </Card>

  <Card title="Entregas" icon="truck" href="/docs/pt/deliveries/overview">
    Prepare, despache, entregue, receba e encerre.
  </Card>

  <Card title="Relatórios" icon="chart-line" href="/docs/pt/reports/consumption">
    Consumo por insumo e análises de gestão.
  </Card>

  <Card title="Segurança e privacidade" icon="shield-halved" href="/docs/pt/trust/security-and-privacy">
    Isolamento, omissão de dados e como suas informações são protegidas.
  </Card>
</CardGroup>

## Próximos passos

* [Início rápido](/docs/pt/quickstart): faça seu primeiro pedido de ponta a ponta.
* [Conceitos](/docs/pt/concepts): o modelo por trás de cada tela.
* [Glossário](/docs/pt/glossary): cada termo, status e rótulo em três idiomas.
* [Solução de problemas](/docs/pt/help/troubleshooting): o que fazer quando algo não avança.


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