guisilvagomes a4851de2e0 feat: configurar APIs funcionais - appointments com scheduled_at e availability com weekday string

2025-10-27 21:58:05 -03:00

8.1 KiB

Raw Blame History

Configuração das APIs - MediConnect

✅ APIs Testadas e Funcionando

1. Autenticação (Auth API)

Base URL: https://yuanqfswhberkoevtmfr.supabase.co/auth/v1

Endpoints Funcionais:

Login ✅
- POST /token?grant_type=password
- Body: { email, password }
- Retorna: { access_token, refresh_token, user }
Recuperação de Senha ✅
- POST /recover
- Body: { email, options: { redirectTo: url } }
- Envia email com link de recuperação
Atualizar Senha ✅
- PUT /user
- Headers: Authorization: Bearer <access_token>
- Body: { password: "nova_senha" }
- IMPORTANTE: Nova senha deve ser diferente da anterior (erro 422 se for igual)

2. REST API

Base URL: https://yuanqfswhberkoevtmfr.supabase.co/rest/v1

Tabelas e Campos Corretos:

appointments ✅

{
  id: string (UUID)
  order_number: string (auto-gerado: APT-YYYY-NNNN)
  patient_id: string (UUID)
  doctor_id: string (UUID)
  scheduled_at: string (ISO 8601 DateTime)
  duration_minutes: number
  appointment_type: "presencial" | "telemedicina"
  status: "requested" | "confirmed" | "checked_in" | "in_progress" | "completed" | "cancelled" | "no_show"
  chief_complaint: string | null
  patient_notes: string | null
  notes: string | null
  insurance_provider: string | null
  checked_in_at: string | null
  completed_at: string | null
  cancelled_at: string | null
  cancellation_reason: string | null
  created_at: string
  updated_at: string
  created_by: string (UUID)
  updated_by: string | null
}

Criar Consulta:

POST /rest/v1/appointments
Headers:
  - apikey: <SUPABASE_ANON_KEY>
  - Authorization: Bearer <user_access_token>
  - Content-Type: application/json
  - Prefer: return=representation

Body:
{
  "patient_id": "uuid",
  "doctor_id": "uuid",
  "scheduled_at": "2025-11-03T10:00:00.000Z",
  "duration_minutes": 30,
  "appointment_type": "presencial",
  "chief_complaint": "Motivo da consulta"
}

doctor_availability ✅

{
  id: string (UUID)
  doctor_id: string (UUID)
  weekday: "sunday" | "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday"
  start_time: string (HH:MM:SS, ex: "07:00:00")
  end_time: string (HH:MM:SS, ex: "19:00:00")
  slot_duration_minutes: number (ex: 30)
  appointment_type: "presencial" | "telemedicina"
  is_active: boolean
  created_at: string
  updated_at: string
  created_by: string (UUID)
  updated_by: string | null
}

Criar Disponibilidade:

POST /rest/v1/doctor_availability
Headers:
  - apikey: <SUPABASE_ANON_KEY>
  - Authorization: Bearer <admin_access_token>
  - Content-Type: application/json
  - Prefer: return=representation

Body:
{
  "doctor_id": "uuid",
  "weekday": "monday",  // ⚠️ Texto, não número!
  "start_time": "07:00:00",
  "end_time": "19:00:00",
  "slot_duration_minutes": 30,
  "appointment_type": "presencial",
  "is_active": true,
  "created_by": "admin_user_id"
}

patients ✅

{
  id: string (UUID)
  user_id: string (UUID) // ⚠️ Deve estar vinculado ao auth.users
  full_name: string
  email: string
  cpf: string
  phone_mobile: string
  // ... outros campos
}

Atualizar Patient:

PATCH /rest/v1/patients?id=eq.<patient_id>
Headers:
  - apikey: <SUPABASE_ANON_KEY>
  - Authorization: Bearer <admin_access_token>
  - Content-Type: application/json

Body:
{
  "user_id": "auth_user_id"
}

doctors ✅

{
  id: string (UUID)
  user_id: string (UUID)
  full_name: string
  email: string
  crm: string
  crm_uf: string
  specialty: string
  // ... outros campos
}

3. Edge Functions

Base URL: https://yuanqfswhberkoevtmfr.supabase.co/functions/v1

Funcionais:

create-user-with-password ✅

POST /functions/v1/create-user-with-password
Cria usuário com senha e perfil completo

Body:

{
  "email": "email@example.com",
  "password": "senha123",
  "full_name": "Nome Completo",
  "phone_mobile": "(11) 99999-9999",
  "cpf": "12345678900",
  "create_patient_record": true,
  "role": "paciente"
}

Com Problemas:

request-password-reset ❌
- CORS blocking - não usar
- Usar diretamente /auth/v1/recover em vez disso

🔑 Chaves de API

SUPABASE_URL = "https://yuanqfswhberkoevtmfr.supabase.co"
SUPABASE_ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Inl1YW5xZnN3aGJlcmtvZXZ0bWZyIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTQ5NTQzNjksImV4cCI6MjA3MDUzMDM2OX0.g8Fm4XAvtX46zifBZnYVH4tVuQkqUH6Ia9CXQj4DztQ"

👥 Usuários de Teste

Admin

Email: riseup@popcode.com.br
Senha: riseup

Dr. Fernando Pirichowski

Email: fernando.pirichowski@souunit.com.br
Senha: fernando123
User ID: 38aca60d-7418-4c35-95b6-cb206bb18a0a
Doctor ID: 6dad001d-229b-40b5-80f3-310243c4599c
CRM: 24245
Disponibilidade: Segunda a Domingo, 07:00-19:00

Aurora Sabrina Clara Nascimento (Paciente)

Email: aurora-nascimento94@gmx.com
Senha: auroranasc94
User ID: 6dc15cc5-7dae-4b30-924a-a4b4fa142f24
Patient ID: b85486f7-9135-4b67-9aa7-b884d9603d12
CPF: 66864784231
Telefone: (21) 99856-3014

⚠️ Pontos de Atenção

1. Weekday no doctor_availability

❌ NÃO usar números (0-6)
✅ USAR strings em inglês: "sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"

2. scheduled_at em appointments

❌ NÃO usar campos separados appointment_date e appointment_time
✅ USAR campo único scheduled_at com ISO 8601 DateTime
Exemplo: "2025-11-03T10:00:00.000Z"

3. user_id nas tabelas patients e doctors

⚠️ Sempre vincular ao auth.users.id
Sem esse vínculo, queries por user_id não funcionam

4. Senha na recuperação

⚠️ Nova senha DEVE ser diferente da anterior
Erro 422 com error_code: "same_password" se tentar usar a mesma

5. redirectTo no password recovery

⚠️ Supabase pode ignorar o parâmetro redirectTo
✅ Implementar detecção de token no lado do cliente
Verificar tanto query string ?token= quanto hash #access_token=

📦 Estrutura de Serviços no Frontend

// Tudo configurado em:
src/services/api/config.ts         // URLs e chaves
src/services/api/client.ts         // Cliente axios
src/services/appointments/          // Serviço de consultas
src/services/availability/          // Disponibilidade médicos
src/services/auth/                  // Autenticação
src/services/doctors/               // Médicos
src/services/patients/              // Pacientes
src/services/index.ts               // Exportações centralizadas

✅ Status Atual

Autenticação funcionando
Recuperação de senha funcionando
Criação de usuários funcionando
Criação de pacientes funcionando
Criação de disponibilidade médica funcionando
Criação de consultas funcionando
Vinculação user_id ↔ patient_id corrigida
Todos os serviços usando campos corretos

🚀 Próximos Passos

Testar agendamento completo no frontend
Verificar listagem de consultas
Testar cancelamento e atualização de consultas
Verificar notificações SMS
Testar fluxo completo de check-in e prontuário

📝 Exemplos de Uso

Criar Consulta

import { appointmentService } from '@/services';

const appointment = await appointmentService.create({
  patient_id: 'patient-uuid',
  doctor_id: 'doctor-uuid',
  scheduled_at: '2025-11-03T10:00:00.000Z',
  duration_minutes: 30,
  appointment_type: 'presencial',
  chief_complaint: 'Consulta de rotina'
});

Criar Disponibilidade

import { availabilityService } from '@/services';

const availability = await availabilityService.create({
  doctor_id: 'doctor-uuid',
  weekday: 'monday',
  start_time: '07:00:00',
  end_time: '19:00:00',
  slot_duration_minutes: 30,
  appointment_type: 'presencial'
});

import { authService } from '@/services';

const response = await authService.login({
  email: 'user@example.com',
  password: 'senha123'
});

// response.access_token - JWT token
// response.user - dados do usuário

8.1 KiB Raw Blame History