@criapix/saas-assinaturas-client/PORTS.md

SDK JavaScript/TypeScript para o AssinaturasService - Sistema de gestão de assinaturas SaaS com processamento de pagamentos de faturas (cartão, PIX, débito), gerenciamento de métodos de pagamento, pagamentos recorrentes e análise de falhas de pagamento

# Configuração de Portas - AssinaturasService

## Portas Disponíveis

O **AssinaturasService** pode rodar em diferentes portas dependendo do ambiente:

### Desenvolvimento Local (dotnet run)
- **Porta**: `5097`
- **URL**: `http://localhost:5097`
- **Configuração**: `launchSettings.json`
- **Uso**: Quando você executa `dotnet run` no diretório `AssinaturasService.API`

### Docker Compose (ambiente containerizado)
- **Porta Externa**: `8082`
- **Porta Interna**: `8080`
- **URL**: `http://localhost:8082`
- **Configuração**: `docker-compose.yml` (linha 102)
- **Uso**: Quando você executa `docker-compose up`

## Configuração no Frontend (predin-admin-front)

### Arquivo `.env.development` (desenvolvimento local)
```env
VITE_ASSINATURAS_SERVICE_URL=http://localhost:5097
```

### Docker Compose (frontend containerizado)
```env
VITE_ASSINATURAS_SERVICE_URL=http://localhost:8082
```

## Mapeamento de Portas nos Serviços

| Serviço | Porta Local | Porta Docker | Descrição |
|---------|-------------|--------------|-----------|
| **auth-service** | 8000 | 8000 | Autenticação Multi-tenant |
| **assinaturas-api** | 5097 | 8082 | Gestão de Assinaturas SaaS |
| **predin-api** | 8081 | 8081 | Sistema de Condomínios |
| **paymentservice-api** | - | 8083 | Pagamentos Recorrentes |
| **predin-admin** | 3001 | 3001 (80 interno) | Painel Administrativo |
| **predin-website** | 3000 | 3000 (80 interno) | Site Institucional |

## Como Usar

### 1. Desenvolvimento Local (sem Docker)

Execute o serviço:
```bash
cd AssinaturasService.API
dotnet run
```

Configure o frontend:
```env
# .env.development
VITE_ASSINATURAS_SERVICE_URL=http://localhost:5097
```

### 2. Docker Compose

Execute todos os serviços:
```bash
docker-compose up -d
```

O frontend automaticamente usará:
```env
VITE_ASSINATURAS_SERVICE_URL=http://localhost:8082
```

## Troubleshooting

### Erro: "Connection refused" ou "404 Not Found"

1. **Verifique se o serviço está rodando**:
   ```bash
   # Local
   curl http://localhost:5097/health

   # Docker
   curl http://localhost:8082/health
   ```

2. **Verifique a porta correta no .env**:
   - Desenvolvimento local: `5097`
   - Docker Compose: `8082`

3. **Verifique os logs do serviço**:
   ```bash
   # Docker
   docker logs saas-assinaturas-api
   ```

### Mudança de Porta

Se precisar mudar a porta:

1. **Desenvolvimento Local**: Edite `launchSettings.json`
2. **Docker Compose**: Edite `docker-compose.yml` e altere `"PORTA:8080"`
3. **Frontend**: Atualize `VITE_ASSINATURAS_SERVICE_URL` em todos os `.env`

## Referências

- **launchSettings.json**: `AssinaturasService.API/Properties/launchSettings.json`
- **docker-compose.yml**: `docker-compose.yml` (linha 78-117)
- **Frontend .env**: `predin-admin-front/.env.development`