From 541248b103e82d87169e729a61e717c27316bfbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=98=D0=BB=D1=8C=D1=8F=D1=81=20=D0=A1=D1=83=D0=BB=D1=82?=
 =?UTF-8?q?=D0=B0=D0=BD=D0=BE=D0=B2?= <si@op16.ru>
Date: Mon, 24 Aug 2026 19:42:26 +0300
Subject: [PATCH] =?UTF-8?q?chore:=20traccar.xml=20=D0=B2=D1=8B=D0=BD=D0=B5?=
 =?UTF-8?q?=D1=81=D0=B5=D0=BD=20=D0=B2=20.gitignore=20(=D1=88=D0=B0=D0=B1?=
 =?UTF-8?q?=D0=BB=D0=BE=D0=BD=20traccar.xml.example),=20forward.type=3Djso?=
 =?UTF-8?q?n?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore                                   |  1 +
 traccar/{traccar.xml => traccar.xml.example} | 12 +++++++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)
 rename traccar/{traccar.xml => traccar.xml.example} (59%)

diff --git a/.gitignore b/.gitignore
index b1d9abd..60df432 100644
--- a/.gitignore
+++ b/.gitignore
@@ -33,3 +33,4 @@ data/
 cookies.txt
 tmp/
 
+traccar/traccar.xml
diff --git a/traccar/traccar.xml b/traccar/traccar.xml.example
similarity index 59%
rename from traccar/traccar.xml
rename to traccar/traccar.xml.example
index a34ae1c..ce46759 100644
--- a/traccar/traccar.xml
+++ b/traccar/traccar.xml.example
@@ -2,7 +2,14 @@
 <!DOCTYPE properties SYSTEM 'http://java.sun.com/dtd/properties.dtd'>
 <properties>
 
-    <!-- Минимальная конфигурация Traccar для GPS-модуля iistwin -->
+    <!-- Минимальная конфигурация Traccar для GPS-модуля iistwin.
+
+         ВАЖНО: это ШАБЛОН. Реальный конфиг — traccar/traccar.xml —
+         в git НЕ хранится (в .gitignore), потому что содержит токен,
+         а деплой делает git reset --hard и затёр бы его.
+         Установка на сервере:
+           cp traccar/traccar.xml.example traccar/traccar.xml
+           # и вписать токен из GPS_INGEST_TOKEN (.env) в forward.header ниже -->
 
     <!-- Встроенная база H2 (данные в volume traccar_data) -->
     <entry key='database.driver'>org.h2.Driver</entry>
@@ -20,6 +27,9 @@
          в переменной GPS_INGEST_TOKEN в .env CRM. -->
     <entry key='forward.enable'>true</entry>
     <entry key='forward.url'>http://app:5000/api/gps/ingest</entry>
+    <!-- json = POST с телом {position: {...}, device: {...}} — его понимает наш ingest;
+         по умолчанию forward.type=url (GET с query-параметрами), нам он не подходит -->
+    <entry key='forward.type'>json</entry>
     <entry key='forward.header'>X-Gps-Token: ВСТАВИТЬ_СЮДА_ТОКЕН_GPS_INGEST_TOKEN</entry>
 
 </properties>