# 🚚 Módulo de Rotas - Índice de Documentação

## 📍 Localização

Toda a documentação do módulo de Rotas está organizada na pasta:

```
/projects/idt_app/docs/router/
```

## 📁 Arquivos Disponíveis

### 📋 Documentação Técnica
- **[ROUTES_MODULE_DOCUMENTATION.md](./router/ROUTES_MODULE_DOCUMENTATION.md)**
  - Documentação técnica completa
  - Estrutura de dados (camelCase)
  - Interfaces TypeScript
  - Fluxos operacionais
  - Integração com app mobile

### 📊 Dados Mockados
- **[ROUTES_MOCK_DATA_COMPLETE.json](./router/ROUTES_MOCK_DATA_COMPLETE.json)** (765KB)
  - 500 rotas mockadas
  - Coordenadas reais (RJ, SP, MG, ES)
  - Placas de veículos reais
  - Distribuição estatística correta

### 🛠️ Scripts e Ferramentas
- **[generate_routes_data.py](./router/generate_routes_data.py)**
  - Script Python para gerar dados
  - Configurável e reutilizável
  - Baseado em dados reais

### 📖 Guia de Uso
- **[ROUTES_README.md](./router/ROUTES_README.md)**
  - Instruções de uso
  - Exemplos de código
  - Configuração do ambiente

### 📈 Dados de Origem
- **[mercado-lives_export.csv](./router/mercado-lives_export.csv)**
  - Placas de veículos reais
  - Fonte dos dados mockados

## 🎯 Acesso Rápido

### Para Desenvolvedores:
```bash
# Navegar para a documentação
cd projects/idt_app/docs/router/

# Visualizar documentação principal
cat ROUTES_MODULE_DOCUMENTATION.md

# Usar dados mockados
cat ROUTES_MOCK_DATA_COMPLETE.json
```

### Para Regenerar Dados:
```bash
cd projects/idt_app/docs/router/
python3 generate_routes_data.py
```

## 🔗 Integração com Sistema

O módulo de Rotas deve ser implementado seguindo os padrões:
- **BaseDomainComponent** para componentes
- **Sidebar**: "Rotas" (ícone: fa-route)
- **Posição**: Após "Veículos" e "Motoristas"

## 📊 Resumo dos Dados

- **Total**: 500 rotas mockadas
- **Tipos**: First Mile (60%), Line Haul (25%), Last Mile (15%)
- **Regiões**: SP, RJ, MG, ES com coordenadas reais
- **Status**: Distribuição realística de estados
- **Placas**: Extraídas do sistema real PraFrota

---

**Versão**: 1.0  
**Última Atualização**: 28/12/2024  
**Localização**: `/projects/idt_app/docs/router/`