riseup-squad18/MEDICONNECT 2/API-CONFIG.md

# 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** ✅

```typescript
{
  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:**

```bash
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** ✅

```typescript
{
  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:**

```bash
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** ✅

```typescript
{
  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:**

```bash
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** ✅

```typescript
{
  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:
    ```json
    {
      "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

```typescript
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

```typescript
// 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

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

## 🚀 Próximos Passos

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

## 📝 Exemplos de Uso

### Criar Consulta

```typescript
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

```typescript
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",
});
```

### Login

```typescript
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
```