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

# Introdução

> Visão geral da documentação NextMed: plataformas Manager e Atendimento, referência técnica do PWA e APIs REST de gestão.

Esta documentação cobre o ecossistema **NextMed**: telas e fluxos da **Plataforma Manager** e do **Webapp PWA de Atendimento**, contratos técnicos do PWA e a **referência REST** (OpenAPI) para gestão de usuários, instituições, unidades, especialidades, serviços e protocolos clínicos.

## O que você pode fazer

<CardGroup cols={2}>
  <Card title="Plataforma Manager" icon="layout-dashboard" href="/manager/sobre-plataforma">
    Documentação das telas administrativas (usuários, instituições, serviços, etc.).
  </Card>

  <Card title="Plataforma Atendimento" icon="stethoscope" href="/atendimento/introducao">
    Documentação dos fluxos de acesso, cadastro, solicitações, atendimentos e perfil médico.
  </Card>

  <Card title="Atendimento Técnico" icon="code-2" href="/atendimento-tech/introduction">
    Visão técnica do PWA: arquitetura, autenticação, integrações, IA, videochamadas e contratos.
  </Card>

  <Card title="Usuários" icon="users" href="/api-reference">
    Criar e gerenciar usuários admin, médicos e pacientes; aprovar e rejeitar perfis.
  </Card>

  <Card title="Instituições" icon="building-2" href="/api-reference">
    CRUD de instituições de saúde; vincular usuários e listar unidades e coordenadores.
  </Card>

  <Card title="Unidades" icon="map-pin" href="/api-reference">
    Gerenciar unidades (locais) das instituições e seus usuários.
  </Card>

  <Card title="Especialidades" icon="stethoscope" href="/api-reference">
    Gerenciar especialidades médicas usadas pelos médicos.
  </Card>

  <Card title="Serviços" icon="briefcase" href="/api-reference">
    Serviços e tipos de serviço; preços e histórico.
  </Card>

  <Card title="Protocolos" icon="clipboard-list" href="/api-reference">
    Protocolos clínicos: formulários, perguntas, opções e faixas de pontuação.
  </Card>
</CardGroup>

## Base URLs

A API pode ser acessada nos seguintes ambientes:

<Tabs>
  <Tab title="Serviço direto">
    Base URL: `http://localhost:8081`\
    Os paths são montados na raiz: `/users`, `/institutions`, `/protocols`, etc.
  </Tab>

  <Tab title="Via gateway">
    Base URL: `http://localhost:8080/admin-service`\
    A maioria dos paths usa o prefixo `/admin-service`; `/protocols` é exposto sem prefixo no gateway.
  </Tab>
</Tabs>

<Info>
  Na API Reference, os paths documentados seguem o uso via gateway (com prefixo `/admin-service` onde aplicável).
</Info>

## Autenticação

A maioria dos endpoints exige autenticação. Envie o header `origin` (e, se aplicável, tokens) conforme exigido pelo seu ambiente. No [Quickstart](/quickstart) você encontra exemplos de requisição.

<Warning>
  Não exponha credenciais em repositórios ou em exemplos públicos. Use variáveis de ambiente no seu cliente.
</Warning>

## Arquitetura

Quer entender como o backend de gestão está organizado (camadas, módulos, fluxo de requisição e integrações)? Veja [Arquitetura](/architecture), com diagramas de alto nível e de sequência.

## Buscar esta documentação no IDE (MCP)

Depois do deploy no Mintlify, desenvolvedores podem conectar o **MCP HTTP** da documentação no Cursor ou VS Code para o assistente consultar estas páginas durante o trabalho. Passo a passo: [MCP Mintlify para desenvolvedores](/mintlify-mcp-devs).

## Próximos passos

<Steps>
  <Step title="Fazer sua primeira requisição">
    Siga o [Quickstart](/quickstart) para configurar a base URL e enviar um request de exemplo.
  </Step>

  <Step title="Entender a arquitetura">
    Leia [Arquitetura](/architecture) para ver diagramas e módulos do backend de gestão.
  </Step>

  <Step title="Explorar a API Reference">
    Use a [API Reference](/api-reference) para ver schemas de request/response, parâmetros e exemplos por endpoint.
  </Step>
</Steps>