Add README with project details and finalize config

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.

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"
-      - "5000-5500:5000-5500/udp"
+      # - "5000-5500:5000-5500/udp"
     volumes:
       - ./logs:/opt/traccar/logs
+      - ./traccar.xml:/opt/traccar/conf/traccar.xml
     networks:
       - traccar_net
 

traccar.xml

@@ -0,0 +1,14 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE properties SYSTEM 'http://java.sun.com/dtd/properties.dtd'>
+<properties>
+
+    <entry key='config.default'>./conf/default.xml</entry>
+
+    <entry key='database.driver'>org.postgresql.Driver</entry>
+    <entry key='database.url'>jdbc:postgresql://db:5432/traccar</entry>
+    <entry key='database.user'>traccar</entry>
+    <entry key='database.password'>traccar</entry>
+    
+    <entry key='web.port'>8082</entry>
+
+</properties>