Início Rápido

Este guia cobre tanto a experiência do usuário final (como usar o sistema) quanto o setup para desenvolvedores.

Para Usuários — Primeiros Passos

1. Criar sua Organização

Acesse a página de cadastro e preencha os dados da sua clínica:

• Nome da clínica
• CNPJ (único na plataforma)
• E-mail administrativo
• Telefone com DDD

Após o cadastro, sua organização é criada em modo TRIAL (14 dias gratuitos). As credenciais de acesso do administrador são enviadas por e-mail.

2. Configurar a Primeira Unidade

No painel Configurações → Unidades, adicione sua primeira unidade com:

• Nome da unidade
• Endereço completo
• Horário de funcionamento por dia da semana

3. Cadastrar Profissionais

Em Configurações → Profissionais, cadastre os membros da equipe clínica com:

• Nome completo
• Especialidade
• Número do conselho (CRM, CRO, CREFITO...)
• Unidades de atuação
• Grade de disponibilidade (horários por dia da semana)

4. Convidar Usuários

Em Usuários, convide recepcionistas e outros usuários via e-mail. Cada usuário recebe um link de convite com validade de 48 horas.

5. Cadastrar Procedimentos

Em Configurações → Procedimentos, cadastre os serviços oferecidos com nome, duração e valor. Esses dados alimentam o faturamento automático.

6. Criar o Primeiro Agendamento

No módulo Agendamentos, clique em um horário disponível no calendário e preencha:

1. Paciente (buscar existente ou criar novo)
2. Profissional
3. Procedimento
4. Unidade e sala (opcional)

O agendamento é criado e uma confirmação é enviada automaticamente por e-mail.

---

Para Desenvolvedores — Setup Local

Pré-requisitos

Ferramenta	Versão mínima
.NET SDK	10.0
Node.js	18 ou 20
Angular CLI	18
Docker + Docker Compose	—

1. Clonar o Repositório

git clone https://github.com/estevooliveira111/fastgivr-systemclinic.git
cd system-clinic

2. Subir Serviços de Infraestrutura

docker compose up -d db redis

Isso inicia:

• PostgreSQL 16 na porta 5432 (credenciais: postgres:postgres)
• Redis 7 na porta 6379

3. Iniciar o Backend

cd api
dotnet run --project src/SystemClinic.Api

Na primeira execução, as migrations são aplicadas automaticamente e o banco é populado com dados de seed determinísticos.

URLs disponíveis:

• API: http://localhost:5032
• Documentação Scalar: http://localhost:5032/scalar/v1

4. Iniciar o Frontend

cd web
npm install
npm start

Frontend disponível em: http://localhost:4200

5. Rodar os Testes

# Testes da API
cd api && dotnet test

# Testes do Frontend
cd web && npm run test:ci

6. Comandos Makefile

O projeto inclui um Makefile com atalhos:

make api-run      # Inicia a API
make api-build    # Build de produção da API
make api-test     # Executa testes da API
make docker-up    # Sobe todos os containers
make docker-down  # Para todos os containers
make web-dev      # Inicia o frontend em modo dev
make web-build    # Build de produção do frontend
make web-install  # Instala dependências npm

Variáveis de Ambiente

Crie o arquivo api/src/SystemClinic.Api/appsettings.Development.json com:

{
  "Jwt": {
    "SecretKey": "sua-chave-secreta-minimo-32-caracteres",
    "Issuer": "systemclinic-api",
    "Audience": "systemclinic-web"
  },
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Database=systemclinic;Username=postgres;Password=postgres"
  },
  "Redis": {
    "ConnectionString": "localhost:6379"
  },
  "Firebase": {
    "ProjectId": "seu-projeto-firebase",
    "StorageBucket": "seu-projeto.appspot.com"
  },
  "Resend": {
    "ApiKey": "sua-chave-resend"
  },
  "PagarMe": {
    "ApiKey": "sua-chave-pagarme",
    "WebhookSecret": "seu-webhook-secret"
  }
}

Atenção: Nunca comite chaves de API ou secrets no repositório. Use variáveis de ambiente ou um gerenciador de secrets em produção.

Credenciais Padrão (Seed de Desenvolvimento)

Após a primeira execução, o banco é populado com dados de exemplo:

E-mail	Senha	Papel
admin@clinicapiloto.com.br	Admin@123	Owner
recepcao@clinicapiloto.com.br	Recepcao@123	Receptionist
dr.silva@clinicapiloto.com.br	Medico@123	Professional

---

Próximos Passos

• Guia do Dashboard
• Documentação da API
• Permissões e Papéis