diff --git a/README.md b/README.md new file mode 100644 index 0000000..d3b5b5b --- /dev/null +++ b/README.md @@ -0,0 +1,44 @@ +# Sistema de Rastreamento GPS - Oestepan + +Este repositório contém a infraestrutura em Docker para o sistema de rastreamento veicular da **Oestepan**, empresa especializada na fabricação e venda de farinha. + +O sistema é baseado na plataforma open-source [Traccar](https://www.traccar.org/), customizado para atender às necessidades de logística e monitoramento da frota da empresa. + +## Arquitetura do Sistema + +O ambiente foi projetado para ser robusto e performático, utilizando containers Docker para isolamento e facilidade de deploy. + +- **Aplicação Principal**: Traccar (versão latest). +- **Banco de Dados**: TimescaleDB (PostgreSQL otimizado para séries temporais), garantindo alta performance na gravação de coordenadas GPS. +- **Rede**: `traccar_net` (rede interna isolada). + +### Fluxo de Dados +1. **Dispositivos GPS**: Enviam dados de localização via TCP/UDP. +2. **Servidor Traccar**: Processa os dados recebidos. +3. **TimescaleDB**: Armazena histórico de posições e eventos. +4. **Interface Web**: Disponibiliza visualização em tempo real e relatórios para a equipe de logística da Oestepan. + +## Configuração do Ambiente + +### Pré-requisitos +- Docker Engine +- Docker Compose + +### Instalação e Execução + +1. Clone o repositório. +2. Inicie os serviços e a infraestrutura: + ```bash + docker-compose up -d + ``` +3. O sistema estará acessível em: + - **Interface Web**: [http://localhost:8083](http://localhost:8083) (Porta alterada para evitar conflitos no servidor) + +### Portas e Comunicação + +| Serviço | Porta Interna | Porta Externa (Host) | Descrição | +|---------|---------------|----------------------|-----------| +| Web UI | 8082 | **8083** | Interface de Gestão e API | +| GPS | 5000-5500 | *Desabilitado* | Recepção de dados dos dispositivos (TCP/UDP) | + +> **Nota:** O range de portas de dispositivos (5000-5500) está atualmente **desabilitado** no `docker-compose.yml` para evitar conflitos de porta no servidor. Para colocar em produção, habilite apenas as portas específicas dos modelos de rastreadores utilizados pela frota da Oestepan. diff --git a/docker-compose.yml b/docker-compose.yml index 67fb4f5..ad74bc0 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -24,17 +24,18 @@ services: db: condition: service_healthy environment: - CONFIG_USE_ENVIRONMENT_VARIABLES: "true" + # CONFIG_USE_ENVIRONMENT_VARIABLES: "true" DATABASE_DRIVER: org.postgresql.Driver DATABASE_URL: jdbc:postgresql://db:5432/traccar DATABASE_USER: traccar DATABASE_PASSWORD: traccar ports: - "8083:8082" - - "5000-5500:5000-5500" - - "5000-5500:5000-5500/udp" + # - "5000-5500:5000-5500" + # - "5000-5500:5000-5500/udp" volumes: - ./logs:/opt/traccar/logs + - ./traccar.xml:/opt/traccar/conf/traccar.xml networks: - traccar_net diff --git a/traccar.xml b/traccar.xml new file mode 100644 index 0000000..995c60c --- /dev/null +++ b/traccar.xml @@ -0,0 +1,14 @@ + + + + + ./conf/default.xml + + org.postgresql.Driver + jdbc:postgresql://db:5432/traccar + traccar + traccar + + 8082 + +