# Guia Rápido - TMS010 Operação de Transporte

## 🚀 Como Usar

### 1️⃣ **Criar Nova Operação**

1. Navegue para **Transporte → Operação de Transporte**
2. Clique em **"Novo"** ou **"Nova Operação"**
3. Preencha os dados:

#### Seção 1 - Identificação
| Campo | Tipo | Obrigatório | Exemplo |
|-------|------|-------------|---------|
| Número | Texto | ✅ | OP-2025-001 |
| Data Operação | Data | ✅ | 2025-01-20 |
| Situação | Select | ✅ | Aberto |

#### Seção 2 - Negociação / Contratação
| Campo | Tipo | Obrigatório | Nota |
|-------|------|-------------|------|
| Cliente | Select2 | ✅ | Selecione digitando |
| Fornecedor Transportador | Select2 | ❌ | Opcional |
| Expedidor | Select2 | ❌ | Quem envia a carga |
| Destinatário | Select2 | ❌ | Quem recebe |
| Recebedor | Select2 | ❌ | Documento de destino |
| Peso Estimado | Número | ❌ | Em kg |
| Volume Estimado | Número | ❌ | Em m³ |
| Temp. Inicial | Número | ❌ | °C |
| Temp. Final | Número | ❌ | °C |
| Data Prev. Coleta | Data/Hora | ❌ | Quando pega a carga |
| Data Prev. Entrega | Data/Hora | ❌ | Quando entrega |
| Distância Estimada | Número | ❌ | Em km |

#### Seção 3 - Programação / Veículos e Motoristas
| Campo | Tipo | Obrigatório | Nota |
|-------|------|-------------|------|
| Veículo Principal | Select2 | ✅ | Placa do veículo |
| Motorista | Select2 | ✅ | Nome do motorista |
| Carreta 1 | Select2 | ❌ | Se houver reboque |
| Carreta 2 | Select2 | ❌ | Se houver 2ª carreta |

#### Seção 4 - Notas
| Campo | Tipo | Obrigatório |
|-------|------|-------------|
| Observações | Texto | ❌ |

4. Clique em **"Salvar"**

---

### 2️⃣ **Editar Operação Existente**

1. Na listagem, clique no número da operação ou no ícone de edição
2. Altere os dados desejados
3. Clique em **"Atualizar"**

⚠️ **IMPORTANTE**: O campo **Status** é gerenciado automaticamente pelo sistema:
- Novo registro = Status "Ativo"
- Não é possível alterar status manualmente
- Para desativar, use o botão de **Deletar**

---

### 3️⃣ **Entender os Status**

#### Situação (Pode ser alterada pelo usuário)
```
Aberto           → Operação criada, aguardando cotação
    ↓
Cotada           → Fornecedor enviou proposta
    ↓
Contratada       → Negociação fechada
    ↓
Agendada         → Veículo e motorista designados
    ↓
Em Transporte    → Carga em movimento
    ↓
Entregue         → Carga recebida no destino
    ↓
Cancelada        → Operação cancelada
```

#### Status (Gerenciado pelo Sistema)
```
Ativo (0)        → Registro disponível
Excluído (1)     → Registro deletado (não aparece na listagem)
```

---

### 4️⃣ **Usar SelectTwo Buscador**

Todos os campos de seleção (Cliente, Veículo, Motorista, etc.) usam **SelectTwo**:

1. Clique no campo select
2. Comece a digitar (mínimo 1 caractere)
3. Selecione uma opção da lista
4. O valor é preenchido automaticamente

Exemplo:
```
Campo "Veículo": 
  Clico → abre dropdown
  Digito "ABC" → filtra veículos com "ABC" na placa
  Clico na opção → seleciona
```

---

### 5️⃣ **Filtrar Operações**

Na listagem, use a barra de filtro:

```
Número:        [_______]  → Filtra por número da operação
Cliente:       [_______]  → Filtra por cliente
Veículo:       [_______]  → Filtra por placa
Motorista:     [_______]  → Filtra por nome
Fornecedor:    [_______]  → Filtra por fornecedor
Situação:      [_______]  → Filtra por situação
Status:        [_______]  → Ativo/Excluído
```

---

## 🔄 Fluxo Completo Exemplo

### Cenário: Cliente X precisa transportar carga para SP

**Passo 1: Criar Operação**
- Número: `OP-2025-0520`
- Data: `20/01/2025`
- Situação: `Aberto`
- Cliente: `Cliente X`
- Expedidor: `Filial RJ`
- Destinatário: `Destino SP`
- Peso: `5000 kg`
- Volume: `25 m³`
- Distância: `450 km`

**Passo 2: Cotar Fornecedor**
- Situação muda para: `Cotada`
- Fornecedor Transportador: `Transportadora ABC`

**Passo 3: Fechar Contrato**
- Situação muda para: `Contratada`

**Passo 4: Designar Recursos**
- Situação muda para: `Agendada`
- Veículo: `ABC-1234` (Scania)
- Motorista: `João Silva`
- Carreta 1: `ABC-5678`

**Passo 5: Saída da Carga**
- Situação muda para: `Em Transporte`
- Data Saída: `20/01/2025 10:00`

**Passo 6: Carga Entregue**
- Situação muda para: `Entregue`
- Data Entrega: `21/01/2025 15:30`

---

## ⚡ Atalhos e Dicas

| Ação | Como Fazer |
|------|-----------|
| Voltar à Listagem | Clique em "Cancelar" ou use navegação |
| Deletar Operação | Botão com ícone de lixeira (marca como excluído) |
| Ver Histórico | Veja datas de criação e alteração no rodapé |
| Buscar Rápido | Use Ctrl+F no navegador + filtre por número |
| Imprimir | Use Ctrl+P do navegador |

---

## ❓ Perguntas Frequentes

**P: Posso mudar o status?**  
R: Não, status é automático. Use "Situação" para rastrear fase da operação.

**P: Posso deletar uma operação?**  
R: Sim, clique em deletar. Ela não sumirá do banco, apenas marcará como excluída.

**P: Preciso de todas as carretas?**  
R: Não, carreta 1 e 2 são opcionais. Preencha apenas as necessárias.

**P: SelectTwo não funciona?**  
R: Verifique se tem dados no banco. Mínimo 1 caractere para buscar. Limpe o navegador cache se persistir.

**P: Posso editar motorista após salvar?**  
R: Sim, abra a operação novamente e altere. Clique "Atualizar".

---

## 📞 Suporte

Em caso de dúvidas:
1. Verifique este guia
2. Consulte a documentação completa: `TMS010_OPERACAO_ARQUITETURA.md`
3. Veja as alterações recentes: `AJUSTES_REALIZADOS.md`
4. Contate o administrador do sistema

