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

# Configuração inicial do ambiente

> Onboarding de um ambiente novo ou local: criação da conta master e cadastro da primeira empresa.

<Info>
  Este fluxo só aparece quando o Symphony é implantado em um **ambiente novo** ou executado **localmente**, sem nenhuma conta cadastrada. **Usuários comuns não passam por aqui** — em ambientes já configurados, a tela inicial é o [login](/guia/primeiro-acesso).
</Info>

## O que é

A **configuração inicial** cobre os dois primeiros passos de um ambiente novo: criar a **conta master** (a primeira conta administradora da instalação) e cadastrar a **primeira empresa (tenant)**.

## Como o Symphony detecta a etapa

Ao abrir o endereço da plataforma, o Symphony identifica automaticamente em qual etapa o ambiente está:

* **Ambiente novo (sem nenhuma conta):** inicia o fluxo de **onboarding** e a criação da **conta master**.
* **Ambiente já configurado:** exibe diretamente a **tela de login**.

## Criar a conta master

Quando a plataforma ainda não possui contas, ela exibe uma tela de **boas‑vindas/onboarding** com um botão para começar. Ao avançar, você é levado ao formulário de **criação da conta master**.

<Steps>
  <Step title="Comece o onboarding">
    Na tela de boas‑vindas, clique no botão para **começar**.
  </Step>

  <Step title="Preencha o formulário Criar conta master">
    * **Nome completo**
    * **E‑mail**
    * **Senha** e **Confirmação de senha** (um indicador mostra a força da senha e os requisitos a cumprir).
  </Step>

  <Step title="Crie a conta">
    Clique em **Criar conta**.
  </Step>
</Steps>

<Note>
  No fluxo de conta master, os campos **Área de atuação**, **Unidade de negócio (BU)** e o aceite de termos não são solicitados — eles aparecem apenas no cadastro comum de usuários.
</Note>

## Cadastrar a primeira empresa

Com a conta master criada, o passo seguinte é **cadastrar as empresas (tenants)** que usarão a plataforma. Cada empresa terá seu próprio endereço de acesso, limite de licenças e provedor de login (SSO).

<Card title="Empresas — cadastro e gestão" icon="building" href="/admin/perfil-master#empresas-cadastro-e-gestão">
  O passo a passo completo (campos, abas e regras) está no Perfil Master.
</Card>

<Tip>
  Antes de criar usuários, é recomendável ter pelo menos **uma empresa cadastrada**. A criação e a configuração de empresas são exclusivas do perfil **Master**.
</Tip>

## Boas práticas

* Guarde com segurança as credenciais da **conta master**: ela tem o nível mais alto de acesso.
* Crie uma senha **forte**, atendendo a todos os requisitos exibidos pelo verificador.

## Limitações conhecidas

* O fluxo de onboarding/conta master só aparece **uma vez**, em ambientes sem contas.
* A criação e a configuração de empresas são exclusivas do perfil **Master**.