> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/id/iot-query/schema-overview/bronze-layer/raw-business-data.md).

# Skema raw\_business\_data

raw\_business\_data memuat lebih dari 40 tabel yang mencakup pengguna, objek, kendaraan, tugas, dan geofence. Telusuri definisi skema dan deskripsi tabel utama untuk analisis SQL

Skema ini berisi 40+ tabel yang dipilih secara cermat untuk mencakup berbagai aspek bisnis dan kasus penggunaan. Tabel-tabel ini merepresentasikan entitas bisnis inti Anda, struktur organisasi, dan data operasional.

{% hint style="info" %}
Diagram interaktif skema raw\_business\_data tersedia di **dbdiagram.io**: <https://dbdiagram.io/d/V3-bronze-layer-68ecfd1c2e68d21b4131089a>
{% endhint %}

Temukan detail skema data bisnis mentah di bawah ini.

{% code title="skema raw\_business\_data" expandable="true" %}

```sql
Tabel "vehicle_service_tasks" {
  "record_added_at" timestamp [tidak null]
  "start_mileage" numerik
  "komentar" "character varying(255)"
  "status" "character varying(10)" [not null]
  "completion_date" stempel waktu
  "start_engine_hours" numerik
  "service_task_id" integer [tidak boleh null]
  "is_notification_push_enabled" boolean [tidak null]
  "date_notification_interval" interval
  "predicted_datetime" stempel waktu
  "cost" numerik [tidak null]
  "batas_jarak_tempuh" numerik
  "notification_emails" teks
  "is_unplanned" boolean [tidak null]
  "is_repeat" boolean [tidak null]
  "completion_engine_hours" bilangan bulat
  "engine_hours_limit" numerik
  "jarak_tempuh_interval_pengulangan" bilangan bulat
  "vehicle_id" bilangan bulat [tidak null]
  "engine_hours_notification_interval" bilangan bulat
  "start_date" stempel waktu
  "interval notifikasi jarak tempuh" bilangan bulat
  "date_repeat_interval" interval
  "deskripsi" "character varying(255)"
  "notification_sms_phone_numbers" teks
  "end_date" stempel waktu
  "engine_hours_repeat_interval" bilangan bulat
  "completion_mileage" bilangan bulat
}

Tabel "garages" {
  "record_added_at" timestamp [tidak null]
  "garage_id" integer [tidak null]
  "longitude" numerik
  "mechanic_name" "character varying(255)"
  "radius" bilangan bulat [tidak null]
  "latitude" numerik
  "organization_label" "character varying(255)"
  "user_id" integer [tidak null]
  "dispatcher_name" "character varying(255)"
  "address" "character varying(255)"
}

Tabel "Supir_history" {
  "server_datetime" stempel waktu [tidak null]
  "address" "character varying(255)"
  "updated_by" integer [tidak null]
  "object_id" bilangan bulat
  "longitude" numerik
  "latitude" numerik
  "driver_history_id" integer [tidak boleh null]
  "hardware_key" "character varying(64)"
  "new_employee_id" integer
  "changed_datetime" timestamp
  "record_added_at" timestamp [tidak null]
  "old_employee_id" integer
}

Tabel "departments" {
  "record_added_at" timestamp [tidak null]
  "department_label" "character varying(255)" [not null]
  "latitude" numerik
  "department_id" integer [not null]
  "address" "character varying(255)"
  "radius" bilangan bulat [tidak null]
  "longitude" numerik
  "user_id" integer [tidak null]
}

Tabel "checkins" {
  "radius" bilangan bulat [tidak null]
  "latitude" numeric [not null]
  "employee_id" integer [not null]
  "garis bujur" numerik [tidak null]
  "record_added_at" timestamp [tidak null]
  "actual_datetime" stempel waktu [tidak null]
  "user_id" integer [tidak null]
  "form_id" bilangan bulat [tidak null]
  "address" "character varying(255)"
  "planned_datetime" timestamp [tidak null]
  "object_id" bilangan bulat [tidak boleh null]
  "checkin_id" integer [tidak null]
  "komentar" teks
}

Tabel "statuses" {
  "order_sort" integer [tidak null]
  "listing_id" integer [tidak null]
  "color" "character varying(6)" [tidak null]
  "status_id" bilangan bulat [tidak null]
  "status_label" "character varying(200)" [not null]
  "record_added_at" timestamp [tidak null]
  "is_deleted" boolean [tidak null]
}

Tabel "Area_linked_entity_fields" {
  "value" bigint [not null]
  "record_added_at" timestamp [tidak null]
  "place_id" integer [not null]
  "field_id" integer [tidak null]
}

Tabel "area_text_fields" {
  "place_id" integer [not null]
  "record_added_at" timestamp [tidak null]
  "value" teks [tidak null]
  "field_id" integer [tidak null]
}

Tabel "users2zones" {
  "zone_id" integer [tidak null]
  "record_added_at" timestamp [tidak null]
  "user_id" integer [tidak null]
}

Tabel "objek" {
  "record_added_at" timestamp [tidak null]
  "create_datetime" stempel waktu [tidak null]
  "client_id" integer [tidak null]
  "group_id" bilangan bulat
  "Pelacak_label" "character varying(100)"
  "model" "character varying(64)"
  "is_clone" boolean [tidak null]
  "is_deleted" boolean [tidak null]
  "device_id" integer [tidak null]
  "object_id" bilangan bulat [tidak boleh null]
}

Tabel "device_output_name" {
  "device_id" integer [tidak null]
  "record_added_at" timestamp [tidak null]
  "label" "character varying(100)" [not null]
  "number" bilangan bulat [tidak null]
}

Tabel "Perimeter_points" {
  "garis bujur" numerik [tidak null]
  "number" bilangan bulat [tidak null]
  "zone_id" integer [tidak null]
  "record_added_at" timestamp [tidak null]
  "latitude" numeric [not null]
}

Tabel "custom_fields" {
  "record_added_at" timestamp [tidak null]
  "entity_id" integer [tidak null]
  "is_required" boolean [tidak null]
  "custom_field_label" text [not null]
  "parameter" jsonb
  "custom_field_type" bilangan bulat [tidak null]
  "deskripsi" teks
  "custom_field_id" bilangan bulat [tidak null]
}

Tabel "area_decimal_fields" {
  "field_id" integer [tidak null]
  "record_added_at" timestamp [tidak null]
  "place_id" integer [not null]
  "value" numerik [tidak null]
}

Tabel "Tugas_history" {
  "task_id" bilangan bulat [tidak null]
  "activity" bilangan bulat [tidak null]
  "task_history_id" integer [not null]
  "record_added_at" timestamp [tidak null]
  "user_id" integer [tidak null]
  "event_datetime" timestamp [tidak null]
  "payload" teks
}

Tabel "Tagar" {
  "tag_label" "character varying(64)" [tidak null]
  "color" "character varying(6)"
  "user_id" integer [tidak null]
  "record_added_at" timestamp [tidak null]
  "tag_id" integer [tidak null]
}

Tabel "Area" {
  "deskripsi" teks
  "custom_fields" jsonb
  "place_id" integer [not null]
  "external_id" "character varying(32)"
  "record_added_at" timestamp [tidak null]
  "user_id" bilangan bulat
  "latitude" numerik
  "radius" bilangan bulat
  "tempat_label" "character varying(256)"
  "assigned_datetime" timestamp
  "address" "character varying(256)"
  "longitude" numerik
}

Tabel "status_listings" {
  "user_id" integer [tidak null]
  "is_supervisor_controlled" boolean [not null]
  "is_deleted" boolean [tidak null]
  "status_listing_id" integer [not null]
  "is_employee_controlled" boolean [not null]
  "record_added_at" timestamp [tidak null]
  "status_listing_label" "character varying(200)" [not null]
}

Tabel "models" {
  "record_added_at" timestamp [tidak null]
  "model_id" integer [not null]
  "has_battery_level" boolean [not null]
  "alternative_label" "character varying(50)" [not null]
  "vendor" "character varying(30)" [not null]
  "is_clone" boolean
  "has_altitude" boolean [not null]
  "has_phone" boolean [not null]
  "type_output_control" "character varying(30)" [not null]
  "has_gsm_roaming" boolean [not null]
  "has_gsm_level" boolean [not null]
  "model" "character varying(255)" [not null]
  "type_special_control" "character varying(255)" [not null]
  "digital_amount" bilangan bulat [tidak null]
  "has_detach_button" boolean [tidak null]
  "has_gsm_name" boolean [tidak null]
  "analog_amount" bilangan bulat [tidak boleh null]
  "outputs_amount" bilangan bulat [tidak null]
}

Tabel "vehicle_trackers_history" {
  "vehicle_id" bilangan bulat [tidak null]
  "record_added_at" timestamp [tidak null]
  "object_id" bilangan bulat [tidak boleh null]
  "changed_datetime" stempel waktu [tidak null]
  "vehicle_tracker_history_id" integer [tidak null]
}

Tabel "groups" {
  "group_id" integer [not null]
  "warna_Kelompok" "character varying(6)" [not null]
  "label_Kelompok" "character varying(255)" [not null]
  "client_id" integer [tidak null]
  "record_added_at" timestamp [tidak null]
}

Tabel "deskripsi_sensor" {
  "record_added_at" timestamp [tidak null]
  "parameter" jsonb
  "id_input" integer [not null]
  "akurasi" numeric [not null]
  "satuan_sensor" "character varying(10)"
  "pengali" doubleprecision [not null]
  "label_input" "character varying(64)"
  "label_sensor" "character varying(100)"
  "tipe_satuan" integer [not null]
  "pembagi" doubleprecision [not null]
  "group_id" integer [not null]
  "id_sensor" integer [not null]
  "device_id" integer [tidak null]
  "tipe_sensor" "character varying(45)" [not null]
  "tipe_Kelompok" integer [not null]
  "data_kalibrasi" jsonb
}

Tabel "entitas" {
  "label_entitas" jsonb
  "record_added_at" timestamp [tidak null]
  "entity_id" integer [tidak null]
  "tipe_bawaan" integer [not null]
  "user_id" integer [tidak null]
}

Tabel "zona" {
  "address" "character varying(255)"
  "radius" bilangan bulat [tidak null]
  "zone_id" integer [tidak null]
  "lintang_pusat_lingkaran" numeric [not null]
  "client_id" integer [tidak null]
  "label_zona" "character varying(100)"
  "color" "character varying(6)" [tidak null]
  "tipe_zona" "character varying(20)" [not null]
  "bujur_pusat_lingkaran" numeric [not null]
  "latitude" numeric [not null]
  "record_added_at" timestamp [tidak null]
  "garis bujur" numerik [tidak null]
}

Tabel "Kendaraan" {
  "vehicle_id" bilangan bulat [tidak null]
  "panjang_muatan" numeric
  "VIN" "character varying(20)"
  "nomor_polis_Asuransi_gratis" "character varying(50)"
  "label_Kendaraan" "character varying(100)"
  "lebar_muatan" numeric
  "color" "character varying(6)"
  "trailer" "character varying(255)"
  "object_id" bilangan bulat
  "id_status_Kendaraan" integer
  "berlaku_hingga_Asuransi_tanggung_jawab" timestamp
  "tahun_pembuatan" integer
  "mutu_Bahan bakar" "character varying(16)"
  "biaya_Bahan bakar" numeric
  "volume_tangki_Bahan bakar" numeric
  "model" "character varying(100)"
  "id_garasi" integer
  "tinggi_muatan" numeric
  "kecepatan_maksimum" numeric
  "nomor_registrasi" "character varying(32)"
  "ukuran_ban" "character varying(50)"
  "kapasitas_penumpang" integer
  "record_added_at" timestamp [tidak null]
  "nomor_registrasi_trailer" "character varying(32)"
  "tanggal_berlaku_hingga_Asuransi_gratis" timestamp
  "berat_bruto" numeric
  "konsumsi_Bahan bakar_standar" numeric
  "tipe_Bahan bakar" integer
  "berat_muatan" numeric
  "informasi_tambahan" text
  "subtipe_kendaraan" "character varying(32)"
  "nomor_polis_asuransi_tanggung_jawab" "character varying(50)"
  "nomor_rangka" "character varying(32)"
  "user_id" integer [tidak null]
  "tipe_kendaraan" integer [not null]
  "nomor_sasis" "character varying(32)"
  "jumlah_ban" integer
  "susunan_roda" "character varying(16)"
}

Tabel "tautan_tag" {
  "entity_id" integer [tidak null]
  "record_added_at" timestamp [tidak null]
  "tipe_entitas" integer [not null]
  "urutan" integer [not null]
  "tag_id" integer [tidak null]
}

Tabel "aturan" {
  "id_aturan" integer [not null]
  "object_id" bilangan bulat [tidak boleh null]
  "parameter" jsonb
  "nomor_telepon_notifikasi" "character varying(210)" [not null]
  "tipe_peristiwa" "character varying(100)" [not null]
  "client_id" integer [tidak null]
  "push_diaktifkan" boolean [not null]
  "komentar_peristiwa1" "character varying(255)" [not null]
  "label_peristiwa" "character varying(255)" [not null]
  "deskripsi" "character varying(255)" [not null]
  "record_added_at" timestamp [tidak null]
  "sms_notifikasi" text [not null]
  "kelompok_peristiwa" integer [not null]
  "dibuat_pada" timestamp [not null]
  "maksimum" integer [not null]
  "is_deleted" boolean [tidak null]
  "email_notifikasi" text [not null]
  "komentar_peristiwa2" "character varying(255)" [not null]
}

Tabel "riwayat_status" {
  "longitude" numerik
  "id_status_baru" integer
  "id_riwayat_status" integer [not null]
  "device_id" integer [tidak null]
  "updated_by" integer [tidak null]
  "address" "character varying(255)"
  "latitude" numerik
  "record_added_at" timestamp [tidak null]
  "server_datetime" stempel waktu [tidak null]
  "changed_datetime" timestamp
  "id_status_lama" integer
}

Tabel "aturan2zona" {
  "zone_id" integer [tidak null]
  "record_added_at" timestamp [tidak null]
  "id_aturan" integer [not null]
}

Tabel "formulir" {
  "object_id" bilangan bulat [tidak boleh null]
  "deskripsi" teks
  "label_formulir" "character varying(255)" [not null]
  "bidang" text
  "dibuat_pada" timestamp [not null]
  "alamat_pengiriman" "character varying(255)"
  "lintang_pengiriman" numeric
  "form_id" bilangan bulat [tidak null]
  "bujur_pengiriman" numeric
  "apakah_pengiriman_di_dalam_zona" boolean [not null]
  "nilai" text
  "record_added_at" timestamp [tidak null]
  "id_tugas" integer
  "dikirim_pada" timestamp
}


Tabel "aturan2pelacak" {
  "parameter_pelacak" jsonb
  "nomor_kelompok_parameter" integer [not null]
  "object_id" bilangan bulat [tidak boleh null]
  "record_added_at" timestamp [tidak null]
  "id_aturan" integer [not null]
}

Tabel "tugas" {
  "waktu_dari" timestamp
  "durasi_tinggal_menit" interval
  "id_eksternal" "character varying(100)"
  "object_id" bilangan bulat
  "tipe_tugas" integer
  "durasi_kedatangan_menit" interval
  "status" integer
  "tanggal_waktu_kedatangan" timestamp
  "record_added_at" timestamp [tidak null]
  "task_id" bilangan bulat [tidak null]
  "user_id" bilangan bulat
  "tanggal_waktu_perubahan_status" timestamp
  "urutan_sortir" integer
  "waktu_ke" timestamp
  "menit_keterlambatan_maksimum" integer
  "kontrol_tinggal_diaktifkan" boolean
  "address" "character varying(255)"
  "label_tugas" "character varying(200)" [not null]
  "longitude" numerik
  "dibuat_oleh" integer
  "deskripsi" text [not null]
  "radius" bilangan bulat
  "latitude" numerik
  "durasi_tinggal" integer
  "dibuat_pada" timestamp [not null]
  "custom_fields" jsonb
  "id_tugas_induk" integer
}

Tabel "bidang_bigint_area" {
  "field_id" integer [tidak null]
  "value" bigint [not null]
  "place_id" integer [not null]
  "record_added_at" timestamp [tidak null]
}

Tabel "perangkat" {
  "apakah_sim_diblokir" boolean [not null]
  "device_id" integer [tidak null]
  "imei_perangkat" "character varying(64)" [not null]
  "label_jaringan" "character varying(50)" [not null]
  "status_listing_id" integer [not null]
  "tingkat_sinyal" numeric [not null]
  "telepon" "character varying(32)" [not null]
  "memiliki_roaming" boolean [not null]
  "dibuat_pada" timestamp [not null]
  "id_pemilik" integer [not null]
  "record_added_at" timestamp [tidak null]
}

Tabel "parameter_deskripsi" {
  "deskripsi" "character varying(150)"
  "record_added_at" timestamp [tidak null]
  "tipe" "character varying(100)" [not null]
  "kunci" integer [not null]
}

Tabel "pengguna" {
  "label_perusahaan" "character varying(255)" [not null]
  "tanggal_waktu_pendaftaran" timestamp
  "nama_depan" "character varying(100)" [not null]
  "id_master" integer
  "nama_belakang" "character varying(100)" [not null]
  "tanggal_lahir" timestamp
  "label_zona_waktu" "character varying(30)"
  "nama_tengah" "character varying(100)" [not null]
  "user_id" integer [tidak null]
  "lokal" "character varying(10)" [not null]
  "record_added_at" timestamp [tidak null]
}

Tabel "penghitung" {
  "id_sensor" integer
  "pengali" numeric [not null]
  "id_penghitung" integer [not null]
  "device_id" integer [tidak null]
  "tipe_penghitung" integer [not null]
  "record_added_at" timestamp [tidak null]
}

Tabel "karyawan" {
  "berlaku_hingga_izin_supir" timestamp
  "record_added_at" timestamp [tidak null]
  "nama_belakang" "character varying(100)"
  "id_departemen" integer
  "nomor_identitas_warga" "character varying(32)"
  "nama_depan" "character varying(100)"
  "kategori_izin_supir" "character varying(32)"
  "user_id" integer [tidak null]
  "nomor_telepon" "character varying(32)"
  "object_id" bilangan bulat
  "is_deleted" boolean [tidak null]
  "tanggal_penerbitan_izin_supir" boolean
  "hardware_key" "character varying(64)"
  "nama_tengah" "character varying(100)"
  "address" "character varying(255)"
  "latitude" numerik
  "employee_id" integer [not null]
  "nomor_personel" "character varying(15)"
  "biaya_bahan_bakar" doubleprecision
  "nomor_lisensi_supir" "character varying(32)"
  "email" "character varying(100)"
  "konsumsi_bahan_bakar" doubleprecision
  "radius" bilangan bulat [tidak null]
  "longitude" numerik
}

Tabel "area_teks_panjang_fields" {
  "field_id" integer [tidak null]
  "value" teks [tidak null]
  "record_added_at" timestamp [tidak null]
  "place_id" integer [not null]
}

Tabel "grup_objek" {
  "grup_klien_id" integer
  "objek_klien_id" integer

  Indeks {
    (grup_klien_id, objek_klien_id) [pk]
  }
}

Tabel "pengaturan_perangkat" {
  "device_id" integer [tidak null]
  "key" "character varying" [tidak boleh null]
  “nilai” teks

  Indeks {
    (device_id, key) [pk]
  }
}

Tabel "event_description" {
  "event_id" bilangan bulat [tidak null, pk]
  "deskripsi" teks
}

Ruj:"employees"."employee_id" < "checkins"."employee_id"

Ref:"objects"."object_id" < "checkins"."object_id"

Ref:"forms"."form_id" < "checkins"."form_id"

Acuan:"sensor_description"."sensor_id" < "counters"."sensor_id"

Referensi:"devices"."device_id" < "counters"."device_id"

Ref:"entities"."entity_id" < "custom_fields"."entity_id"

Rujukan:"departments"."department_id" < "employees"."department_id"

Referensi:"users"."user_id" < "departments"."user_id"

Ref:"description_parameters"."key" < "counters"."counter_type"

Ruj:"description_parameters"."key" < "custom_fields"."custom_field_type"

Ref:"description_parameters"."key" < "driver_history"."updated_by"

Ref:"description_parameters"."key" < "entities"."builtin_type"

Ref:"description_parameters"."key" < "sensor_description"."units_type"

Ref:"description_parameters"."key" < "status_history"."updated_by"

Ref:"description_parameters"."key" < "tugas"."status"

Ref:"description_parameters"."key" < "Tugas"."created_at"

Ref:"description_parameters"."key" < "tasks"."task_type"

Ref:"description_parameters"."key" < "vehicles"."fuel_type"

Ref:"description_parameters"."key" < "task_history"."activity"

Ref:"description_parameters"."key" < "sensor_description"."group_type"

Ref:"devices"."device_id" < "device_output_name"."device_id"

Rujukan:"status_listings"."status_listing_id" < "devices"."status_listing_id"

Referensi:"employees"."employee_id" < "Supir_history"."new_employee_id"

Ref:"employees"."employee_id" < "driver_history"."old_employee_id"

Ref:"objects"."object_id" < "driver_history"."object_id"

Ref:"objects"."object_id" < "employees"."object_id"

Ref:"users"."user_id" < "employees"."user_id"

Rujukan:"users"."user_id" < "entities"."user_id"

Ref:"Tugas"."task_id" < "forms"."task_id"

Ref:"objects"."object_id" < "forms"."object_id"

Ref:"objects"."object_id" < "tasks"."object_id"

Ruj:"users"."user_id" < "garages"."user_id"

Referensi:"groups"."client_id" < "groups_objects"."groups_client_id"

Rujukan:"objects"."client_id" < "groups_objects"."objects_client_id"

Ref:"models"."model" < "objects"."model"

Referensi:"devices"."device_id" < "objects"."device_id"

Ref:"users"."user_id" < "Area"."user_id"

Referensi:"custom_fields"."custom_field_id" < "places_bigint_fields"."field_id"

Ref:"Area"."Tempat_id" < "Area_bigint_fields"."Tempat_id"

Ref:"custom_fields"."custom_field_id" < "places_decimal_fields"."field_id"

Ref:"area"."tempat_id" < "area_decimal_fields"."tempat_id"

Ref:"custom_fields"."custom_field_id" < "places_linked_entity_fields"."field_id"

Ruj:"Area"."Tempat_id" < "Area_linked_entity_fields"."Tempat_id"

Ref:"custom_fields"."custom_field_id" < "places_longtext_fields"."field_id"

Ref:"Area"."Tempat_id" < "Area_longtext_fields"."Tempat_id"

Ref:"custom_fields"."custom_field_id" < "places_text_fields"."field_id"

Ref:"Area"."Tempat_id" < "Area_text_fields"."Tempat_id"

Referensi:"rules"."rule_id" < "rules2zones"."rule_id"

Ref:"objects"."object_id" < "rules2objects"."object_id"

Ref:"rules"."rule_id" < "rules2objects"."object_id"

Ref:"zones"."zone_id" < "rules2zones"."zone_id"

Ref:"devices"."device_id" < "sensor_description"."device_id"

Ref:"statuses"."status_id" < "status_history"."new_status_id"

Ref:"statuses"."status_id" < "status_history"."old_status_id"

Ref:"devices"."device_id" < "status_history"."device_id"

Referensi:"users"."user_id" < "status_listings"."user_id"

Ruj:"status_listings"."status_listing_id" < "statuses"."listing_id"

Ref:"Tagar"."tag_id" < "tag_links"."tag_id"

Ref:"users"."user_id" < "tags"."user_id"

Ref:"tasks"."task_id" < "task_history"."task_id"

Ref:"users"."user_id" < "task_history"."user_id"

Ref:"tasks"."parent_task_id" < "tasks"."task_id"

Ref:"users"."user_id" < "Tugas"."user_id"

Ruj:"users"."master_id" < "users"."user_id"

Ref:"users"."user_id" < "users2zones"."user_id"

Ruj:"zones"."zone_id" < "users2zones"."zone_id"

Ref:"vehicles"."vehicle_id" < "vehicle_service_tasks"."vehicle_id"

Ref:"objects"."object_id" < "vehicle_trackers_history"."object_id"

Ref:"Kendaraan"."vehicle_id" < "vehicle_trackers_history"."vehicle_id"

Ref:"garages"."garage_id" < "Kendaraan"."garage_id"

Ref:"Pelacak"."pelacak_id" < "Kendaraan"."pelacak_id"

Acuan:"users"."user_id" < "Kendaraan"."user_id"

Ref:"zones"."zone_id" < "Perimeter_points"."zone_id"

Referensi:"users"."user_id" < "devices"."owner_id"

Ref:"users"."user_id" < "objects"."client_id"

```

{% endcode %}

## Frekuensi pembaruan

Data dalam skema ini disinkronkan dengan basis data inti. Pembaruan terjadi secara bertahap saat perubahan terjadi di basis data MySQL sumber, biasanya kurang dari 5 menit sejak perubahan sumber.

## `description_parameters`

Sistem menyertakan data referensi untuk menstandarkan nilai di seluruh basis data:

<table><thead><tr><th width="167.1817626953125">Jenis referensi</th><th width="173.9090576171875">Deskripsi</th><th>Contoh nilai</th></tr></thead><tbody><tr><td>Definisi jenis</td><td>Jenis entitas standar</td><td><code>vehicle_type: mobil, truk, bus</code></td></tr><tr><td>Kode status</td><td>Tugas dan nilai status sistem</td><td><code>status_tugas: tidak ditugaskan, ditugaskan, selesai</code></td></tr><tr><td>Definisi unit</td><td>Satuan pengukuran untuk sensor</td><td><code>units_type: liter, galon, Celsius</code></td></tr><tr><td>Klasifikasi entitas</td><td>Kategori entitas bisnis</td><td><code>entities_type: tempat, tugas, pelanggan</code></td></tr></tbody></table>

## Tabel utama berdasarkan kategori

Tabel-tabel dalam **`raw_business_data`** Skema diorganisasi ke dalam kategori fungsional untuk memudahkan navigasi. Tabel di bawah merangkum tabel utama berdasarkan tujuan bisnisnya:

Entitas bisnis inti

<details>

<summary><strong><code>pengguna</code></strong></summary>

**Deskripsi**: Akun pengguna yang berisi informasi profil, afiliasi perusahaan, pengaturan lokalisasi (zona waktu, lokal), dan hubungan hierarkis melalui master\_id untuk struktur akun multi-level

<table><thead><tr><th width="145">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>user_id</code> - Pengidentifikasi unik pengguna<br>- <code>company_label</code> - Nama perusahaan yang terkait dengan pengguna<br>- <code>first_name</code> - Nama pengguna<br>- <code>last_name</code> - Nama belakang pengguna<br>- <code>middle_name</code> - Nama patronimik pengguna<br>- <code>locale</code> - Pengaturan bahasa pengguna<br>- <code>timezone_label</code> - Zona waktu dalam format IANA<br>- <code>master_id</code> - ID pengguna utama (jika yang saat ini adalah bawahan)<br>- <code>registration_datetime</code> - Tanggal pendaftaran dalam sistem<br>- <code>birth_date</code> - Tanggal lahir pengguna</td></tr><tr><td><strong>Hubungan</strong></td><td>Pengguna induk melalui <code>master_id</code>, ditautkan ke <code>karyawan</code>, <code>departemen</code>, <code>Area</code>, <code>Tugas</code> melalui <code>user_id</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Entitas pusat yang menghubungkan data organisasi; <code>master_id</code> memungkinkan hierarki pengguna untuk struktur akun bertingkat</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>karyawan</code></strong></summary>

**Deskripsi**: Catatan karyawan dan Supir yang digunakan untuk mewakili orang yang bekerja untuk organisasi, termasuk informasi pribadi, detail lisensi, penetapan departemen, kunci perangkat keras untuk identifikasi iButton/RFID, dan data lokasi dengan dukungan pembatasan area

<table><thead><tr><th width="143">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>employee_id</code> - Pengidentifikasi entitas karyawan<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>department_id</code> - ID departemen tempat karyawan ditugaskan<br>- <code>first_name</code> - atribut first_name dari tabel employees<br>- <code>last_name</code> - Atribut last_name pada tabel employees<br>- <code>middle_name</code> - Atribut middle_name pada tabel employees<br>- <code>Supir_license_number</code> - Nomor SIM Supir<br>- <code>kategori surat izin mengemudi</code> - Kategori surat izin mengemudi<br>- <code>tanggal penerbitan surat izin mengemudi</code> - Tanggal penerbitan surat izin mengemudi<br>- <code>tanggal kedaluwarsa surat izin mengemudi</code> - Tanggal kedaluwarsa surat izin mengemudi<br>- <code>kunci perangkat keras</code> - Kunci perangkat keras<br>- <code>email</code> - Email karyawan<br>- <code>nomor_telepon</code> - nomor telepon karyawan tanpa tanda "+"<br>- <code>alamat</code> - alamat lokasi<br>- <code>nomor_personel</code> - nomor personel karyawan/Supir<br>- <code>nomor_identitas_warga_negara</code> - nomor Keamanan Sosial<br>- <code>lintang</code> - lokasi yang terkait dengan karyawan ini<br>- <code>bujur</code> - lokasi yang terkait dengan karyawan ini<br>- <code>radius</code> - Lokasi yang terkait dengan karyawan ini dalam meter<br>- <code>konsumsi_bahan_bakar</code> - Atribut konsumsi_bahan_bakar dari tabel karyawan<br>- <code>biaya_bahan_bakar</code> - Atribut biaya_bahan_bakar dari tabel karyawan<br>- <code>is_deleted</code> - Atribut is_deleted dari tabel karyawan</td></tr><tr><td><strong>Hubungan</strong></td><td>Tautan ke <code>pengguna</code>, <code>departemen</code>, <code>objects</code> (pelacak yang ditetapkan), dilacak di <code>riwayat_supir</code> dan <code>check-in</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Kunci perangkat keras memungkinkan identifikasi supir melalui iButton atau RFID; mendukung perimeter dengan <code>lintang</code>, <code>bujur</code>, <code>radius</code> bidang</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>departemen</code></strong></summary>

**Deskripsi**: Unit organisasi dengan data lokasi geografis (lintang, bujur, radius) yang memungkinkan analitik berbasis perimeter untuk pelaporan tingkat departemen dan pengaitan lokasi karyawan

<table><thead><tr><th width="156">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>department_id</code> - Pengenal entitas departemen<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>department_label</code> - Atribut department_label pada tabel departments<br>- <code>lintang</code> - Lokasi yang terkait dengan departments ini<br>- <code>bujur</code> - Lokasi yang terkait dengan departments ini<br>- <code>radius</code> - Ukuran geolokasi dalam meter<br>- <code>alamat</code> - Atribut address pada tabel departments</td></tr><tr><td><strong>Hubungan</strong></td><td>Menghubungkan karyawan dengan struktur organisasi melalui <code>department_id</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Kolom lokasi mendukung analitik berbasis Perimeter untuk pelaporan tingkat departemen</td></tr></tbody></table>

</details>

Pelacakan dan pemantauan

<details>

<summary><strong><code>perangkat</code></strong></summary>

**Deskripsi**: Registri perangkat pelacak fisik dengan pengenal perangkat keras (IMEI), informasi kartu SIM, status konektivitas jaringan (kekuatan sinyal, roaming, operator), dan penugasan daftar status untuk manajemen siklus hidup perangkat

<table><thead><tr><th width="138">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>device_id</code> - ID perangkat<br>- <code>Pemilik_id</code> - ID pemilik perangkat yang akunnya digunakan untuk menambahkan beacon<br>- <code>device_imei</code> - IMEI perangkat<br>- <code>telepon</code> - Nomor kartu SIM perangkat<br>- <code>status_listing_id</code> - ID status perangkat<br>- <code>network_label</code> - Nama jaringan tempat kartu SIM terhubung<br>- <code>signal_level</code> - Kekuatan sinyal perangkat<br>- <code>has_roaming</code> - Penanda ketersediaan roaming<br>- <code>is_sim_blocked</code> - Penanda kartu SIM terkunci<br>- <code>created_at</code> - Tanggal dan waktu entri dibuat</td></tr><tr><td><strong>Hubungan</strong></td><td>Entitas inti yang menaut ke <code>objects</code>, <code>model</code>, <code>deskripsi sensor</code>, <code>penghitung</code>; <code>Pemilik_id</code> referensi <code>users.user_id</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Semua data telematika di <code>raw_telematics_data</code> skema mereferensikan tabel ini melalui <code>device_id</code></td></tr></tbody></table>

</details>

<details>

<summary><strong><code>objects</code></strong></summary>

**Deskripsi**: Registri pusat entitas yang dipantau (Kendaraan, aset, personel) yang menghubungkan perangkat fisik dengan struktur organisasi melalui client\_id dan group\_id, merepresentasikan "unit yang dapat dilacak" dengan satu Pelacak aktif per perangkat

<table><thead><tr><th width="148">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>client_id</code> - Pengidentifikasi entitas klien<br>- <code>device_id</code> - Pengidentifikasi entitas perangkat<br>- <code>label_Pelacak</code> - Nama Pelacak<br>- <code>model</code> - Model perangkat<br>- <code>kelompok_id</code> - Kelompok ID entitas<br>- <code>create_datetime</code> - Tanggal dan waktu pembuatan baris baru di server<br>- <code>is_deleted</code> - atribut is_deleted pada tabel pelacak<br>- <code>is_clone</code> - Tanda kloning<br>-</td></tr><tr><td><strong>Hubungan</strong></td><td>Pusat penghubung yang menghubungkan perangkat ke pengguna (<code>client_id</code>), detail kendaraan, riwayat pelacakan, Tugas, dan aturan</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Mewakili "unit yang dapat dilacak" dalam sistem; satu Pelacak per perangkat yang sedang aktif digunakan</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>model</code></strong></summary>

**Deskripsi**: Registri pusat entitas yang dipantau (Kendaraan, aset, personel) yang menghubungkan perangkat fisik dengan struktur organisasi melalui client\_id dan group\_id, merepresentasikan "unit yang dapat dilacak" dengan satu Pelacak aktif per perangkat

<table><thead><tr><th width="135">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>model_id</code> - Pengidentifikasi model entitas<br>- <code>model</code> - Atribut model dari tabel models<br>- <code>vendor</code> - Nama perusahaan yang merilis pelacak<br>- <code>alternative_label</code> - Atribut alternative_label dari tabel models<br>- <code>analog_amount</code> - Jumlah input analog pelacak<br>- <code>digital_amount</code> - Jumlah input diskret pelacak<br>- <code>outputs_amount</code> - Jumlah keluaran diskret pelacak<br>- <code>has_battery_level</code> - Menentukan apakah pelacak mengirimkan pembacaan tingkat baterai<br>- <code>has_altitude</code> - Menentukan apakah pelacak mengirimkan ketinggian<br>- <code>has_phone</code> - Apakah ada kartu SIM?<br>- <code>has_gsm_level</code> - Dapatkah pelacak mengirimkan kekuatan sinyal GSM?<br>- <code>has_gsm_name</code> - Dapatkah pelacak mengirimkan nama jaringan GSM atau kode operator (MCC + MNC)?<br>- <code>has_gsm_roaming</code> - Dapatkah pelacak mengirimkan status roaming?<br>- <code>has_detach_button</code> - Apakah pelacak memiliki sensor pelepasan?<br>- <code>type_output_control</code> - Profil kontrol keluaran pelacak<br>- <code>type_special_control</code> - Berisi pengaturan khusus dan modul fungsional untuk model perangkat individual, seperti mode mengemudi berbahaya (hbm_telfm) untuk perangkat Teltonika<br>- <code>is_clone</code> - Apakah model ini merupakan klon dari model lain?</td></tr><tr><td><strong>Konten</strong></td><td>Penanda kemampuan boolean menunjukkan kolom data mana yang tersedia dari jenis perangkat ini</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Gunakan penanda kemampuan untuk menentukan sensor dan input yang valid saat melakukan kueri data telematika</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>deskripsi sensor</code></strong></summary>

**Deskripsi**: Konfigurasi sensor komprehensif yang menghubungkan input perangkat ke logika bisnis, termasuk pemetaan input, satuan pengukuran, faktor konversi (pengali/pembagi), tabel kalibrasi untuk sensor bahan bakar, ambang batas akurasi, dan logika pengelompokan untuk pembacaan sensor teragregasi

<table><thead><tr><th width="142">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>sensor_id</code> - Pengidentifikasi entitas sensor<br>- <code>device_id</code> - Pengidentifikasi entitas perangkat<br>- <code>sensor_label</code> - Nama sensor untuk antarmuka pengguna<br>- <code>input_label</code> - Nama kolom pesan (atribut) dari mana data sensor diambil. Jika sama dengan "input_status", maka itu adalah Sensor diskret<br>- <code>sensor_type</code> - Jenis sensor<br>- <code>units_type</code> - Satuan pengukuran<br>- <code>multiplier</code> - Pengali - angka yang digunakan untuk mengalikan nilai kolom. Hanya untuk Sensor pengukuran<br>- <code>divider</code> - Pembagi - angka yang digunakan untuk membagi nilai kolom. Hanya untuk Sensor pengukuran<br>- <code>accuracy</code> - Persentase yang ditentukan untuk menghitung galat absolut volume tangki. Galat ini digunakan untuk menentukan kapan pengisian ulang atau pengurasan terjadi. Ini hanya digunakan untuk sensor bahan bakar<br>- <code>calibration_data</code> - Atribut calibration_data dari tabel sensor_description<br>- <code>input_id</code> - Nomor input untuk Sensor diskret<br>- <code>kelompok_id</code> - Sensor dengan jenis yang sama serta group_id dan source_id yang sama dianggap termasuk dalam kelompok yang sama. Datanya dijumlahkan atau dirata-ratakan, bergantung pada nilai group_type. Hal ini diperlukan untuk sensor agregasi. Ini digunakan dalam sensor pengukuran<br>- <code>tipe_kelompok</code> - 0 - jumlahkan nilai sensor di dalam Kelompok, 1 - rata-rata<br>- <code>unit sensor</code> - Nama unit yang dimasukkan pengguna jika units_type=0 (kustom)<br>- <code>parameter</code> - Pelacak opsional dengan parameter tambahan parent_ids - array opsional parent_ids untuk sensor komposit. volume - double. Opsional. Volume untuk sensor komposit. parent_ids - opsional. Array int. Array parent_ids untuk sensor komposit. volume - opsional. Double. Volume untuk sensor komposit. min - opsional. Double. Nilai mentah minimum yang dapat diterima untuk sensor. max - opsional. Double. Nilai mentah maksimum yang dapat diterima untuk sensor. max_lowering_by_time - opsional. Double. Penurunan nilai maksimum yang diizinkan per jam. max_lowering_by_mileage - opsional. Double. Penurunan nilai maksimum yang diizinkan per 100 km. ignore_drains_in_move - opsional. Boolean. Nilai default adalah false. Jika true, pengurasan Bahan bakar tidak akan terdeteksi selama Gerakan. ignore_refuels_in_move - opsional. Boolean. Nilai default adalah false. Jika true, pengisian ulang tidak akan terdeteksi selama Gerakan. refuel_gap_minutes - opsional. Integer. Nilai default adalah 5. Waktu dalam menit setelah dimulainya Gerakan, pengisian ulang akan terdeteksi selama Gerakan. custom_field_name - opsional. Boolean. Nilai default false. Parameter ini menentukan apakah nilai pada field input_name adalah nilai khusus yang dimasukkan oleh pengguna. Ini hanya berlaku jika model pelacak memiliki fitur has_custom_fields</td></tr><tr><td><strong>Hubungan</strong></td><td>Menghubungkan input perangkat (dari <code>raw_telematics_data.inputs</code>) ke logika bisnis melalui <code>device_id</code> dan <code>input_label</code> pencocokan</td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>calibration_data</code> (JSONB) menyimpan tabel kalibrasi khusus sensor untuk sensor level bahan bakar; <code>multiplier</code> dan <code>divider</code> mengonversi nilai mentah ke satuan</td></tr></tbody></table>

</details>

Manajemen aset

<details>

<summary><strong><code>kendaraan</code></strong></summary>

**Deskripsi**: Registri kendaraan komprehensif yang memuat spesifikasi (dimensi, berat, kapasitas), dokumentasi (VIN, registrasi, Asuransi), parameter operasional (Konsumsi bahan bakar, volume tangki), dan penetapan pelacak saat ini melalui object\_id untuk Armada dan pelacakan kepatuhan

<table><thead><tr><th width="144">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>vehicle_id</code> - Pengidentifikasi entitas kendaraan<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>garage_id</code> - ID entitas garasi<br>- <code>label_kendaraan</code> - Atribut vehicle_label pada tabel Kendaraan<br>- <code>nomor registrasi</code> - Nomor registrasi/plat nomor kendaraan<br>- <code>VIN</code> - Atribut VIN pada tabel Kendaraan<br>- <code>tahun_pembuatan</code> - Atribut manufacture_year dari tabel Kendaraan<br>- <code>jenis_bahan bakar</code> - Atribut fuel_type pada tabel Kendaraan<br>- <code>biaya_bahan_bakar</code> - Atribut fuel_cost pada tabel Kendaraan<br>- <code>volume tangki bahan bakar</code> - Atribut fuel_tank_volume dari tabel Kendaraan<br>- <code>max_speed</code> - Atribut max_speed pada tabel Kendaraan<br>- <code>model</code> - Atribut model dari tabel kendaraan<br>- <code>warna</code> - Atribut warna pada tabel Kendaraan<br>- <code>treler</code> - Atribut trailer dari tabel Kendaraan<br>- <code>informasi tambahan</code> - Atribut additional_info dari tabel Kendaraan<br>- <code>tipe_kendaraan</code> - Atribut tipe_kendaraan dari tabel Kendaraan<br>- <code>subtipe_kendaraan</code> - Atribut subtipe_kendaraan dari tabel Kendaraan<br>- <code>id_status_kendaraan</code> - Pengenal entitas status kendaraan<br>- <code>nomor_sasis</code> - Atribut nomor_sasis dari tabel Kendaraan<br>- <code>nomor_rangka</code> - Atribut nomor_rangka dari tabel Kendaraan<br>- <code>trailer_reg_number</code> - Atribut trailer_reg_number pada tabel Kendaraan<br>- <code>payload_weight</code> - Atribut payload_weight pada tabel Kendaraan<br>- <code>payload_height</code> - Atribut payload_height pada tabel Kendaraan<br>- <code>payload_length</code> - Atribut payload_length pada tabel Kendaraan<br>- <code>payload_width</code> - Atribut payload_width pada tabel Kendaraan<br>- <code>Kapasitas penumpang</code> - Jumlah maksimum penumpang<br>- <code>Berat kotor</code> - Atribut berat kotor pada tabel Kendaraan<br>- <code>Konsumsi bahan bakar standar</code> - Konsumsi bahan bakar rata-rata normal dalam liter per 100 km<br>- <code>Jenis bahan bakar</code> - Atribut jenis bahan bakar pada tabel Kendaraan<br>- <code>Konfigurasi roda</code> - Atribut konfigurasi roda pada tabel Kendaraan<br>- <code>Ukuran ban</code> - Ukuran kendaraan: dimensi dan ukuran roda<br>- <code>Jumlah roda</code> - Jumlah roda<br>- <code>Nomor polis Asuransi tanggung jawab</code> - Atribut nomor polis Asuransi tanggung jawab pada tabel Kendaraan<br>- <code>Tanggal berakhir Asuransi tanggung jawab</code> - Tanggal berakhir Asuransi tanggung jawab<br>- <code>Nomor polis Asuransi gratis</code> - Atribut nomor polis Asuransi gratis pada tabel Kendaraan<br>- <code>Tanggal berakhirnya Asuransi gratis</code> - Tanggal berakhirnya Asuransi gratis</td></tr><tr><td><strong>Hubungan</strong></td><td>Tautan ke <code>objects</code> (pelacak saat ini), <code>garasi</code> (lokasi servis), <code>Tugas servis kendaraan</code>; dilacak di <code>riwayat pelacak kendaraan</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Bidang dimensi fisik (<code>payload_length</code>, <code>payload_width</code>, <code>payload_height</code>, <code>Berat kotor</code>) mendukung analitik perencanaan muatan; tanggal Asuransi memungkinkan pelacakan kepatuhan</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>garasi</code></strong></summary>

**Deskripsi**: Lokasi fasilitas layanan dan pemeliharaan dengan koordinat geografis (lintang, bujur, radius), informasi kontak untuk mekanik dan petugas pengiriman, memungkinkan deteksi kunjungan layanan berbasis perimeter dan analisis kedekatan

<table><thead><tr><th width="135">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>garage_id</code> - ID entitas garasi<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>lintang</code> - Pelacak lokasi<br>- <code>bujur</code> - Pelacak lokasi<br>- <code>radius</code> - Ukuran geolokasi dalam meter<br>- <code>alamat</code> - Pelacak lokasi<br>- <code>label_organisasi</code> - ID depot<br>- <code>mechanic_name</code> - Nama mekanik<br>- <code>dispatcher_name</code> - Nama dispatcher</td></tr><tr><td><strong>Hubungan</strong></td><td>Direferensikan oleh <code>kendaraan.garage_id</code> untuk penetapan lokasi layanan</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Kolom lokasi memungkinkan deteksi kunjungan layanan berbasis Perimeter dan analisis kedekatan</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Tugas servis kendaraan</code></strong></summary>

**Deskripsi** : Pemeliharaan jadwal dan pelacakan riwayat layanan dengan beberapa jenis pemicu (berdasarkan tanggal, berdasarkan Jarak tempuh, berdasarkan jam mesin), interval Tugas berulang, notifikasi multikanal (email, SMS, push), dan pembedaan antara peristiwa Pemeliharaan terencana (is\_repeat) dan tidak terencana

<table><thead><tr><th width="132">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>service_task_id</code> - pengidentifikasi entitas Tugas layanan<br>- <code>vehicle_id</code> - Pengidentifikasi entitas kendaraan<br>- <code>deskripsi</code> - Atribut deskripsi pada tabel vehicle_service_tasks<br>- <code>status</code> - Nilai status dari atribut status<br>- <code>biaya</code> - Atribut biaya pada tabel vehicle_service_tasks<br>- <code>tanggal mulai</code> - Tanggal dan waktu yang terkait dengan atribut start_date<br>- <code>end_date</code> - Tanggal dan waktu yang terkait dengan atribut end_date<br>- <code>tanggal_penyelesaian</code> - Tanggal dan waktu yang terkait dengan atribut completion_date<br>- <code>predicted_datetime</code> - Tanggal dan waktu yang terkait dengan atribut predicted_datetime<br>- <code>batas jarak tempuh</code> - Atribut mileage_limit pada tabel vehicle_service_tasks<br>- <code>batas jam mesin</code> - Atribut engine_hours_limit pada tabel vehicle_service_tasks<br>- <code>jarak_tempuh_awal</code> - Atribut start_mileage pada tabel vehicle_service_tasks<br>- <code>start_engine_hours</code> - Atribut start_engine_hours pada tabel vehicle_service_tasks<br>- <code>interval notifikasi jarak tempuh</code> - Atribut mileage_notification_interval pada tabel vehicle_service_tasks<br>- <code>engine_hours_notification_interval</code> - Atribut engine_hours_notification_interval pada tabel vehicle_service_tasks<br>- <code>date_notification_interval</code> - Mengonversi bilangan bulat N menjadi N hari<br>- <code>jarak_tempuh_repeat_interval</code> - Atribut Jarak tempuh_repeat_interval dari tabel kendaraan_layanan_tugas<br>- <code>engine_hours_repeat_interval</code> - Atribut engine_hours_repeat_interval dari tabel vehicle_service_tugas<br>- <code>date_repeat_interval</code> - Mengonversi bilangan bulat N menjadi N hari<br>- <code>notification_emails</code> - Atribut notification_emails pada tabel vehicle_service_tasks<br>- <code>nomor_telepon_sms_notifikasi</code> - Atribut notification_sms_phone_numbers dari tabel vehicle_service_tugas<br>- <code>is_notification_push_enabled</code> - Atribut is_notification_push_enabled pada tabel vehicle_service_tasks<br>- <code>jarak tempuh saat selesai</code> - Atribut completion_mileage dari tabel vehicle_service_tasks<br>- <code>jam mesin penyelesaian</code> - Atribut completion_engine_hours pada tabel vehicle_service_tasks<br>- <code>berulang</code> - Atribut is_repeat dari tabel vehicle_service_tugas<br>- <code>tidak_terencana</code> - Atribut is_unplanned dari tabel vehicle_service_tugas<br>- <code>komentar</code> - Atribut komentar pada tabel vehicle_service_tugas</td></tr><tr><td><strong>Konten</strong></td><td>Mendukung tiga jenis pemicu: berbasis tanggal, berbasis jarak tempuh, berbasis jam mesin; pengaturan notifikasi untuk email, SMS, push</td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>berulang</code> dan kolom interval memungkinkan jadwal pemeliharaan berulang; <code>tidak_terencana</code> membedakan pemeliharaan terjadwal vs. pemeliharaan reaktif</td></tr></tbody></table>

</details>

Lokasi dan perutean

<details>

<summary><strong><code>zona</code></strong></summary>

**Deskripsi**: Area geofence yang mendefinisikan perimeter virtual menggunakan lingkaran atau poligon untuk memantau peristiwa masuk dan keluar kendaraan/Aset, mendukung otomatisasi berbasis aturan dan analitik lokasi dengan kode warna untuk pembedaan visual

<table><thead><tr><th width="150">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>zone_id</code> - Pengidentifikasi entitas zona<br>- <code>client_id</code> - Pengidentifikasi entitas klien<br>- <code>zone_label</code> - Atribut zone_label pada tabel zones<br>- <code>zone_type</code> - Atribut zone_type pada tabel zones<br>- <code>lintang</code> - Pelacak opsional, kotak pembatas yang dapat sepenuhnya memuat hasil yang dikembalikan<br>- <code>bujur</code> - Pelacak opsional, kotak pembatas yang dapat sepenuhnya memuat hasil yang dikembalikan<br>- <code>circle_center_latitude</code> - Atribut circle_center_latitude pada tabel zones<br>- <code>circle_center_longitude</code> - Atribut circle_center_longitude dari tabel zones<br>- <code>radius</code> - Ukuran geolokasi dalam meter<br>- <code>alamat</code> - Atribut alamat pada tabel zona<br>- <code>warna</code> - Atribut warna dari tabel zona</td></tr><tr><td><strong>Konten</strong></td><td>Jenis zona mencakup lingkaran, poligon (ditentukan melalui <code>titik_perimeter</code>), dan klasifikasi area khusus</td></tr><tr><td><strong>Hubungan</strong></td><td>Direferensikan oleh <code>rules2zones</code>, <code>users2zones</code>; titik sudut poligon yang disimpan dalam <code>titik_perimeter</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Fungsi PostGIS dapat digunakan untuk memeriksa point-in-polygon untuk analisis Perimeter yang kompleks</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Area</code></strong></summary>

**Deskripsi**: Titik minat dengan koordinat geografis, definisi radius, dan dukungan bidang kustom yang dapat diperluas untuk menyimpan informasi kontak pelanggan dan data khusus bisnis, memungkinkan integrasi CRM/ERP melalui external\_id dan pelaporan berbasis lokasi

<table><thead><tr><th width="129">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>tempat_id</code> - Pengenal entitas Tempat<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>label tempat</code> - Atribut place_label dari tabel Area<br>- <code>lintang</code> - Pelacak lokasi<br>- <code>bujur</code> - Pelacak lokasi<br>- <code>radius</code> - Ukuran geolokasi dalam meter<br>- <code>alamat</code> - Atribut alamat dari tabel Area<br>- <code>deskripsi</code> - Atribut deskripsi tabel Area<br>- <code>external_id</code> - ID untuk integrasi dengan sistem eksternal (CRM)<br>- <code>custom_fields</code> - Bidang tambahan<br>- <code>assigned_datetime</code> - Tanggal dan waktu penetapan titik minat kepada pengguna</td></tr><tr><td><strong>Hubungan</strong></td><td>Diperluas dengan nilai bidang kustom melalui <code>Area_text_fields</code>, <code>Area_decimal_fields</code>, <code>Area_bigint_fields</code>, <code>Area_longtext_fields</code>, <code>Area_linked_entity_fields</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>custom_fields</code> JSONB menyediakan akses cepat; tabel terkait memungkinkan penyaringan dan pengurutan pada atribut kustom</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>titik_perimeter</code></strong></summary>

**Deskripsi**: Koordinat verteks yang diurutkan (kolom angka menentukan urutan) yang menentukan batas poligon untuk bentuk Perimeter yang kompleks, memungkinkan perimeter geografis yang presisi di luar zona lingkaran sederhana, digunakan dengan PostGIS ST\_MakePolygon untuk operasi geometris

<table><thead><tr><th width="133">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>zone_id</code> - ID zona tempat Formulir ini dilampirkan<br>- <code>angka</code> - Nomor seri<br>- <code>lintang</code> - Lokasi<br>- <code>bujur</code> - Lokasi</td></tr><tr><td><strong>Hubungan</strong></td><td>Beberapa rekaman per <code>zone_id</code> menentukan batas poligon; <code>angka</code> kolom menentukan urutan verteks</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Kueri dengan <code>Urutkan berdasarkan nomor</code> untuk merekonstruksi lintasan poligon; gunakan bersama PostGIS ST_MakePolygon untuk operasi geometris</td></tr></tbody></table>

</details>

Manajemen tugas dan alur kerja

<details>

<summary><strong><code>Tugas</code></strong></summary>

**Deskripsi**: Penugasan perintah kerja dengan validasi lokasi (latitude, longitude, radius), jendela waktu (time\_from, time\_to), persyaratan durasi kunjungan (stay\_duration\_minutes, arrival\_duration\_minutes), struktur hierarkis melalui parent\_task\_id, dan pelacakan status untuk manajemen layanan lapangan dan operasi pengiriman

<table><thead><tr><th width="130">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>Tugas_id</code> - Pengidentifikasi entitas tugas<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>id_tugas_induk</code> - Pengidentifikasi entitas tugas induk<br>- <code>label tugas</code> - Atribut task_label pada tabel Tugas<br>- <code>status</code> - Nilai status dari atribut status<br>- <code>jenis_tugas</code> - Jenis tugas, tugas, rute atau titik pemeriksaan<br>- <code>lintang</code> - Atribut lintang dari tabel Tugas<br>- <code>bujur</code> - Atribut bujur dari tabel Tugas<br>- <code>radius</code> - Ukuran geolokasi dalam meter<br>- <code>arrival_datetime</code> - Saat pelacak tiba di area tugas. DIABAIKAN saat membuat/memperbarui<br>- <code>created_at</code> - Atribut created_at dari tabel Tugas<br>- <code>status_change_datetime</code> - Tanggal dan waktu pembaruan tugas<br>- <code>time_from</code> - Tanggal dan waktu yang terkait dengan atribut time_from<br>- <code>time_to</code> - Tanggal dan waktu yang terkait dengan atribut time_to<br>- <code>stay_duration</code> - Atribut stay_duration pada tabel Tugas<br>- <code>stay_duration_minutes</code> - Durasi kunjungan. Waktu yang harus dihabiskan pekerja lapangan di lokasi penugasan untuk menyelesaikan Tugas dengan berhasil. Beberapa kunjungan bersifat kumulatif<br>- <code>arrival_duration_minutes</code> - Abaikan kunjungan acak yang lebih singkat dari durasi yang ditentukan. Saat menghitung durasi minimum, kunjungan yang lebih singkat dari durasi yang ditentukan akan diabaikan<br>- <code>max_delay_minuts</code> - Keterlambatan yang dapat diterima. Jumlah waktu maksimum seorang karyawan dapat terlambat. Tugas apa pun yang diselesaikan selama waktu ini akan ditandai sebagai "terlambat"<br>- <code>is_stay_control_enabled</code> - Atribut is_stay_control_enabled dari tabel Tugas<br>- <code>alamat</code> - Atribut alamat dari tabel Tugas<br>- <code>deskripsi</code> - Atribut deskripsi dari tabel Tugas<br>- <code>custom_fields</code> - Atribut custom_fields dari tabel Tugas<br>- <code>external_id</code> - Pengidentifikasi entitas eksternal<br>- <code>order_sort</code> - Atribut order_sort dari tabel Tugas<br>- <code>created_by</code> - Sumber dari tugas yang dibuat</td></tr><tr><td><strong>Konten</strong></td><td>Mendukung Tugas hierarkis melalui <code>id_tugas_induk</code>; jendela waktu yang ditentukan oleh <code>time_from</code>/<code>time_to</code>; validasi Perimeter dengan lokasi dan radius</td></tr><tr><td><strong>Hubungan</strong></td><td>Tautan ke <code>formulir</code> (pengumpulan data), <code>Riwayat Tugas</code> (perubahan status), <code>objects</code> (pelacak yang ditetapkan)</td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>stay_duration</code> dan <code>arrival_duration_minutes</code> Aktifkan pemantauan kepatuhan untuk Tugas pengiriman dan layanan</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>formulir</code></strong></summary>

**Deskripsi**: Formulir pengumpulan data yang dapat dikonfigurasi untuk menangkap informasi terstruktur selama penyelesaian Tugas atau Checkin aplikasi seluler, dengan bidang dan nilai disimpan sebagai JSON, validasi lokasi opsional (is\_submission\_in\_zone), dan persyaratan pengiriman wajib saat dilampirkan ke Tugas

<table><thead><tr><th width="141">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>id_formulir</code> - Pengenal entitas Formulir<br>- <code>Tugas_id</code> - ID dari tugas tempat formulir ini dilampirkan<br>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>label_formulir</code> - Label formulir yang ditentukan pengguna<br>- <code>bidang</code> - Jika benar, formulir hanya dapat dikirimkan di zona tugas<br>- <code>nilai</code> - Peta dengan ID field sebagai kunci dan objek field_value sebagai nilai. Kunci yang digunakan untuk menautkan field dan nilai yang sesuai<br>- <code>dikirim_pada</code> - Tanggal saat nilai formulir terakhir dikirimkan<br>- <code>submission_latitude</code> - Lokasi tempat nilai formulir terakhir dikirimkan<br>- <code>submission_longitude</code> - Lokasi tempat nilai formulir terakhir dikirimkan<br>- <code>submission_address</code> - Lokasi tempat nilai formulir terakhir dikirimkan<br>- <code>is_submission_in_zone</code> - Jika benar, formulir hanya dapat dikirimkan di zona tugas<br>- <code>deskripsi</code> - Tanggal saat formulir ini dibuat (atau dilampirkan ke tugas)<br>- <code>created_at</code> - Tanggal saat formulir ini dibuat (atau dilampirkan ke tugas)</td></tr><tr><td><strong>Konten</strong></td><td><code>bidang</code> mendefinisikan struktur formulir (JSON); <code>nilai</code> berisi data yang dikirimkan (JSON)</td></tr><tr><td><strong>Hubungan</strong></td><td>Tautan ke <code>Tugas</code> (surat perintah kerja terkait), <code>objects</code> (pengirim), dirujuk dalam <code>check-in</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Penanda validasi lokasi <code>is_submission_in_zone</code> mengaktifkan aturan pengiriman formulir berbasis Perimeter</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>check-in</code></strong></summary>

**Deskripsi**: Catatan kehadiran dan aktivitas berbasis lokasi yang dikirim melalui aplikasi seluler, melacak waktu kedatangan yang direncanakan dibandingkan dengan waktu kedatangan aktual (planned\_datetime vs actual\_datetime) dengan koordinat geografis dan pengukuran akurasi lokasi (radius) untuk pelaporan ketepatan waktu

<table><thead><tr><th width="129">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>checkin_id</code> - Pengidentifikasi entitas Checkin<br>- <code>employee_id</code> - Pengidentifikasi entitas karyawan juga menjadi pengidentifikasi untuk Supir<br>- <code>object_id</code> - Perangkat karyawan<br>- <code>id_formulir</code> - Pengenal entitas Formulir<br>- <code>user_id</code> - Pengguna karyawan<br>- <code>waktu_terjadwal</code> - Waktu perangkat saat check-in dilakukan<br>- <code>waktu_aktual</code> - Waktu server saat permintaan/pesan diproses<br>- <code>lintang</code> - Lokasi tempat check-in dikirim<br>- <code>bujur</code> - Lokasi tempat check-in dikirim<br>- <code>radius</code> - Galat penentuan posisi pada suatu titik dalam meter<br>- <code>alamat</code> - Alamat check-in<br>- <code>komentar</code> - Atribut komentar dari tabel checkins</td></tr><tr><td><strong>Hubungan</strong></td><td>Menghubungkan karyawan dengan formulir dan lokasi; melacak penyimpangan dari jadwal yang direncanakan</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Selisih waktu antara <code>waktu_terjadwal</code> dan <code>waktu_aktual</code> memungkinkan pelaporan ketepatan waktu; radius menentukan toleransi lokasi yang dapat diterima</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Riwayat Tugas</code></strong></summary>

**Deskripsi**: Jejak audit lengkap dari peristiwa siklus hidup Tugas yang menangkap semua perubahan status, penugasan, pembaruan, dan modifikasi bidang dengan stempel waktu (event\_datetime), atribusi pengguna, serta jenis aktivitas (create, update, assign, status\_change) yang disimpan di bidang payload untuk kepatuhan dan analisis alur kerja

<table><thead><tr><th width="137">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>tugas_history_id</code> - Pengidentifikasi entitas riwayat tugas<br>- <code>Tugas_id</code> - Pengidentifikasi entitas tugas<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>aktivitas</code> - Operasi yang terjadi. Dapat berupa "create", "update", "assign" atau "status_change"<br>- <code>event_datetime</code> - Tanggal dan waktu kejadian<br>- <code>muatan</code> - Tergantung pada operasi. Biasanya, berisi field yang diubah selama operasi</td></tr><tr><td><strong>Konten</strong></td><td>Jenis aktivitas yang didefinisikan dalam <code>description_parameters</code>; <code>muatan</code> menyimpan detail khusus peristiwa (teks)</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Penting untuk analisis penyelesaian Tugas, pelaporan transisi status, dan pelacakan aktivitas pengguna</td></tr></tbody></table>

</details>

Aturan dan otomatisasi

<details>

<summary><strong><code>Aturan</code></strong></summary>

**Deskripsi**: Aturan deteksi peristiwa dengan kondisi pemicu yang dapat dikonfigurasi (pelanggaran batas kecepatan, pelanggaran Perimeter, ambang batas sensor, waktu menganggur) yang disimpan dalam parameter (JSONB), serta pengaturan notifikasi multisaluran (alert\_email, alert\_sms, alert\_phone, is\_push\_enabled) untuk pemantauan dan pemberian peringatan otomatis berdasarkan data perangkat dan server

<table><thead><tr><th width="131">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>rule_id</code> - Pengidentifikasi entitas aturan<br>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>client_id</code> - Pengidentifikasi entitas klien<br>- <code>event_type</code> - Atribut event_type pada tabel rules<br>- <code>label peristiwa</code> - Atribut event_label pada tabel aturan<br>- <code>Kelompok kejadian</code> - Atribut event_group pada tabel aturan<br>- <code>deskripsi</code> - Atribut deskripsi tabel aturan<br>- <code>parameter</code> - Parameter peristiwa. Untuk detail lebih lanjut tentang parameter yang tersedia, lihat <a href="https://www.navixy.com/docs/navixy-api/user-api/resources/tracking/tracker/rules/rule_types/">Dokumentasi API Navixy</a>.<br>- <code>email peringatan</code> - Email untuk notifikasi<br>- <code>alert_sms</code> - Nomor telepon untuk notifikasi SMS<br>- <code>alert_phone</code> - Nomor telepon untuk panggilan suara<br>- <code>is_push_enabled</code> - Jika benar, notifikasi push tersedia<br>- <code>created_at</code> - Atribut created_at pada tabel aturan<br>- <code>is_deleted</code> - Atribut is_deleted pada tabel aturan<br>- <code>maximum</code> - Batas yang diterapkan pada berbagai aturan. Misalnya, untuk aturan waktu diam dengan mesin menyala dalam menit<br>- <code>event_comment1</code> - Atribut event_comment1 dari tabel aturan<br>- <code>event_comment2</code> - Atribut event_comment2 dari tabel aturan</td></tr><tr><td><strong>Konten</strong></td><td>Parameter aturan (JSONB) menentukan kondisi pemicu; mendukung email, SMS, telepon, dan notifikasi push</td></tr><tr><td><strong>Hubungan</strong></td><td>Tautan ke objek melalui <code>rules2objects</code>, zona melalui <code>rules2zones</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>event_type</code> Mendefinisikan skenario pemantauan tertentu (pelanggaran batas kecepatan, pelanggaran Perimeter, ambang batas sensor); <code>maximum</code> Bidang ini memungkinkan agregasi peristiwa untuk peringatan berbasis ambang batas</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>rules2objects</code></strong></summary>

**Deskripsi**: Relasi banyak-ke-banyak yang menghubungkan aturan dengan pelacak yang dipantau, dengan penyesuaian parameter per-pelacak melalui object\_params (JSONB), yang memungkinkan nilai ambang batas berbeda (misalnya, batas kecepatan) untuk setiap kendaraan atau Aset dalam aturan yang sama

<table><thead><tr><th width="140">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>rule_id</code> - Pengidentifikasi entitas aturan<br>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>nomor_kelompok_parameter</code> - Atribut param_group_number dari tabel rules2objects<br>- <code>parameter_objek</code> - Atribut pelacak_params pada tabel rules2objects</td></tr><tr><td><strong>Konten</strong></td><td><code>parameter_objek</code> (JSONB) memungkinkan kustomisasi aturan per pelacak (misalnya, batas kecepatan berbeda per kendaraan)</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Relasi banyak-ke-banyak memungkinkan satu aturan memantau beberapa objek dengan parameter yang berbeda</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>rules2zones</code></strong></summary>

**Deskripsi**: Hubungan banyak ke banyak yang mengaitkan aturan dengan zona geofence, sehingga satu aturan dapat memantau peristiwa masuk/keluar di beberapa area geografis untuk skenario pemantauan spasial yang kompleks

<table><thead><tr><th width="144">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>rule_id</code> - Pengidentifikasi entitas aturan<br>- <code>zone_id</code> - ID entitas zona</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Relasi banyak-ke-banyak memungkinkan pemantauan multi-zona untuk satu aturan (misalnya, memberi peringatan saat memasuki salah satu dari beberapa area terbatas)</td></tr></tbody></table>

</details>

Status dan kategorisasi

<details>

<summary><strong><code>status</code></strong></summary>

**Deskripsi**: Definisi status kustom dalam daftar status, termasuk properti tampilan (warna untuk tampilan situs web, order\_sort untuk penempatan) yang digunakan untuk merepresentasikan status kerja perangkat atau karyawan dengan dukungan penghapusan lunak melalui flag is\_deleted

<table><thead><tr><th width="128">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>status_id</code> - ID entitas status<br>- <code>listing_id</code> - ID entitas daftar<br>- <code>status_label</code> - Nilai status dari atribut status_label<br>- <code>warna</code> - Warna yang digunakan untuk tampilan di situs web<br>- <code>order_sort</code> - Posisi pengurutan dalam daftar status<br>- <code>is_deleted</code> - Atribut is_deleted dari tabel statuses</td></tr><tr><td><strong>Hubungan</strong></td><td>Kelompok status yang diatur berdasarkan <code>listing_id</code> (mengacu pada <code>status_listings</code>); digunakan dalam <code>status_history</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>order_sort</code> menentukan urutan tampilan; warna memungkinkan pembedaan visual dalam pelaporan</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>status_listings</code></strong></summary>

**Deskripsi**: Definisi set status yang mengendalikan nilai status yang tersedia untuk perangkat atau karyawan, dengan penanda izin (is\_supervisor\_controlled, is\_employee\_controlled) yang menentukan apakah supervisor, karyawan, atau keduanya dapat mengubah nilai status

<table><thead><tr><th width="144">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>status_listing_id</code> - Pengidentifikasi entitas daftar status<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>status_listing_label</code> - Nilai status dari atribut status_listing_label<br>- <code>is_supervisor_controlled</code> - Jika bernilai true, supervisor dapat mengubah status kerja, misalnya menggunakan aplikasi pemantauan seluler<br>- <code>is_employee_controlled</code> - Jika bernilai true, karyawan dapat mengubah status kerja mereka sendiri, misalnya menggunakan aplikasi pelacakan seluler<br>- <code>is_deleted</code> - Atribut is_deleted dari tabel status_listings</td></tr><tr><td><strong>Hubungan</strong></td><td>Direferensikan oleh <code>devices.status_listing_id</code> dan <code>statuses.listing_id</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Bendera kontrol menentukan siapa yang dapat mengubah status: hanya supervisor, layanan mandiri karyawan, atau keduanya</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>status_history</code></strong></summary>

**Deskripsi**: Jejak audit semua transisi status perangkat dengan cap waktu (changed\_datetime pada perangkat, server\_datetime pada server), atribusi pengguna (updated\_by), dan pencatatan lokasi (latitude, longitude, address) yang memungkinkan analisis geografis atas perubahan status dan pelaporan lokasi awal/akhir hari kerja

<table><thead><tr><th width="143">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>status_history_id</code> - ID entitas riwayat status<br>- <code>device_id</code> - Pengidentifikasi entitas perangkat<br>- <code>old_status_id</code> - ID entitas status lama<br>- <code>new_status_id</code> - ID entitas status baru<br>- <code>updated_by</code> - Tanggal dan waktu yang terkait dengan atribut updated_by<br>- <code>changed_datetime</code> - Tanggal dan waktu penetapan status baru pada perangkat<br>- <code>server_datetime</code> - Tanggal dan waktu pemberian status server baru<br>- <code>lintang</code> - Penentuan lokasi perangkat selama perubahan status<br>- <code>bujur</code> - Penentuan lokasi perangkat selama perubahan status<br>- <code>alamat</code> - Penentuan lokasi perangkat selama perubahan status</td></tr><tr><td><strong>Hubungan</strong></td><td>Tautan ke <code>perangkat</code>, <code>status</code> (lama dan baru), <code>description_parameters</code> (untuk <code>updated_by</code> peran)</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Pengambilan lokasi memungkinkan analisis geografis atas transisi status; berguna untuk pelaporan lokasi awal/akhir hari kerja</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>Tagar</code></strong></summary>

**Deskripsi**: Label kategorisasi yang ditentukan pengguna dengan kode warna yang memungkinkan pemfilteran dan pencarian cepat di berbagai jenis entitas (Area, geofence, pegawai, Tugas, pelacak, Kendaraan) untuk pengorganisasian yang fleksibel

<table><thead><tr><th width="149">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>tag_id</code> - Tag ID entitas<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>tag_label</code> - Atribut tag_label dari tabel Tagar<br>- <code>warna</code> - Atribut warna dari tabel Tagar</td></tr><tr><td><strong>Hubungan</strong></td><td>Diterapkan pada entitas melalui <code>tag_links</code>; cakupan ditentukan oleh pengguna</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Sistem kategorisasi fleksibel yang mendukung beberapa Tagar per entitas</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>tag_links</code></strong></summary>

**Deskripsi**: Tabel relasi polimorfik yang mengaitkan Tagar dengan jenis entitas apa pun melalui entity\_type dan entity\_id, dengan kolom ordinal untuk pengelolaan urutan tampilan, sehingga memungkinkan penandaan multi-entitas yang fleksibel

<table><thead><tr><th width="127">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>tag_id</code> - Tag ID entitas<br>- <code>entity_type</code> - Atribut entity_type pada tabel tag_links<br>- <code>entity_id</code> - Pengidentifikasi entitas<br>- <code>ordinal</code> - Atribut ordinal pada tabel tag_links</td></tr><tr><td><strong>Konten</strong></td><td><code>entity_type</code> mengidentifikasi tabel (kendaraan, karyawan, Tugas, dll.); <code>ordinal</code> menentukan urutan tampilan</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Relasi polimorfik memungkinkan penandaan di berbagai jenis entitas</td></tr></tbody></table>

</details>

Grup dan hierarki

<details>

<summary><strong><code>grup</code></strong></summary>

**Deskripsi**: Struktur pengelompokan organisasi untuk pelacak yang memungkinkan pengorganisasian visual di antarmuka pengguna dengan warna yang dapat disesuaikan (group\_color) dan pengelolaan hierarkis seperti folder, yang saat ini hanya berfungsi secara visual

<table><thead><tr><th width="148">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>kelompok_id</code> - Kelompok pelacak (ditautkan oleh objects.group_id). Pembagian ke dalam kelompok dapat dilihat di daftar suar, misalnya<br>- <code>client_id</code> - Pengidentifikasi entitas klien<br>- <code>label_kelompok</code> - Judul kelompok yang ditentukan pengguna, 1 hingga 60 karakter yang dapat dicetak, misalnya "Employees"<br>- <code>warna_kelompok</code> - warna Kelompok dalam format web (tanpa #), misalnya "FF6DDC". Menentukan warna penanda pelacak pada peta</td></tr><tr><td><strong>Hubungan</strong></td><td>Direferensikan oleh <code>objects.group_id</code>; kepemilikan klien melalui <code>client_id</code> (mengacu pada <code>pengguna</code>)</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Memungkinkan pengorganisasian entitas pemantauan seperti folder untuk pelaporan dan izin</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>groups_objects</code></strong></summary>

**Deskripsi**: Relasi banyak-ke-banyak antara kelompok dan objek menggunakan kunci utama gabungan (groups\_client\_id, objects\_client\_id), sehingga objek dapat menjadi bagian dari beberapa kelompok secara bersamaan untuk struktur organisasi yang fleksibel

<table><thead><tr><th width="135">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>groups_client_id</code> - Pengenal entitas klien untuk kelompok<br>- <code>objects_client_id</code> - Pengenal entitas klien untuk objek</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Memungkinkan objek menjadi bagian dari beberapa kelompok secara bersamaan; lakukan kueri dengan keduanya <code>client_id</code> Nilai untuk keanggotaan kelompok</td></tr></tbody></table>

</details>

Kolom isian dan entitas

<details>

<summary><strong><code>Entitas</code></strong></summary>

**Deskripsi**: Registri jenis entitas yang menentukan entitas bisnis mana yang mendukung Kolom isian dan struktur tata letak kolomnya (sections, field\_order) yang disimpan dalam entity\_label (JSONB), memungkinkan perluasan skema dinamis di seluruh Area, Tugas, dan entitas lainnya tanpa perubahan basis data

<table><thead><tr><th width="141">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>entity_id</code> - Pengidentifikasi entitas<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>label entitas</code> - id - bilangan bulat. Pengidentifikasi entitas. type - enumerasi. Saat ini, hanya "Tempat" yang didukung. layout - Pelacak menjelaskan tata letak bidang untuk entitas. sections - larik Pelacak. Setiap bagian dapat memuat satu atau lebih bidang. Setidaknya satu bagian harus ada dalam tata letak. label - string. Nama bagian. field_order - larik teks. Bidang bawaan dan ID Kolom isian (sebagai teks)<br>- <code>tipe bawaan</code> - Atribut builtin_type dari tabel entities</td></tr><tr><td><strong>Hubungan</strong></td><td>Direferensikan oleh <code>custom_fields</code> untuk menentukan kolom isian mana yang berlaku untuk jenis entitas mana</td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>tipe bawaan</code> tautan ke <code>description_parameters</code> untuk klasifikasi entitas yang ditentukan sistem</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>custom_fields</code></strong></summary>

**Deskripsi**: Definisi bidang kustom yang memungkinkan perluasan skema dinamis untuk tipe entitas, dengan tipe bidang yang dapat dikonfigurasi (custom\_field\_type), aturan validasi dan opsi dalam parameter (JSONB), serta penanda kewajiban (is\_required) untuk pengambilan data yang fleksibel di Area, Tugas, dan entitas lainnya

<table><thead><tr><th width="146">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>custom_field_id</code> - Pengidentifikasi entitas field kustom<br>- <code>entity_id</code> - Pengidentifikasi entitas<br>- <code>custom_field_label</code> - Nama field<br>- <code>custom_field_type</code> - Tipe data dalam field<br>- <code>deskripsi</code> - Deskripsi field<br>- <code>is_required</code> - Apakah ini wajib atau tidak?<br>- <code>parameter</code> - Parameter field</td></tr><tr><td><strong>Konten</strong></td><td><code>parameter</code> (JSONB) menyimpan konfigurasi khusus tipe field (aturan validasi, opsi dropdown, dll.)</td></tr><tr><td><strong>Hubungan</strong></td><td>Menentukan atribut kustom yang tersedia untuk entitas; tipe bidang tertaut ke <code>description_parameters</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Memungkinkan perluasan skema dinamis tanpa perubahan basis data; digunakan secara luas dalam <code>Area</code> dan <code>Tugas</code></td></tr></tbody></table>

</details>

Pelacakan historis

<details>

<summary><strong><code>riwayat_supir</code></strong></summary>

**Deskripsi**: Jejak audit lengkap atas penugasan karyawan ke Kendaraan dari waktu ke waktu, dengan pelacakan transisi old\_employee\_id ke new\_employee\_id beserta stempel waktu (changed\_datetime, server\_datetime), data lokasi (latitude, longitude, address), informasi kunci perangkat keras, dan atribusi pengguna (updated\_by) yang memungkinkan analitik khusus Supir saat Supir berpindah antara Kendaraan

<table><thead><tr><th width="146">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>driver_history_id</code> - Pengidentifikasi entitas riwayat Supir<br>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>id_karyawan_lama</code> - Pengenal entitas karyawan lama<br>- <code>id_karyawan_baru</code> - Pengenal entitas karyawan baru<br>- <code>kunci perangkat keras</code> - Atribut hardware_key pada tabel driver_history<br>- <code>changed_datetime</code> - Perubahan tanggal dan waktu telah dibuat pada perangkat<br>- <code>server_datetime</code> - Tanggal dan waktu perubahan yang dibuat di server<br>- <code>updated_by</code> - Tanggal dan waktu yang terkait dengan atribut updated_by<br>- <code>lintang</code> - Atribut latitude dari tabel riwayat Supir<br>- <code>bujur</code> - Atribut bujur dari tabel riwayat supir<br>- <code>alamat</code> - Atribut alamat pada tabel driver_history</td></tr><tr><td><strong>Hubungan</strong></td><td>Melacak penugasan Supir ke Kendaraan dari waktu ke waktu; menaut ke <code>karyawan</code> dan <code>objects</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Penting untuk pelaporan khusus Supir saat Supir berganti Kendaraan; perekaman lokasi memungkinkan analisis lokasi saat perubahan penugasan</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>riwayat pelacak kendaraan</code></strong></summary>

**Deskripsi**: Jejak audit yang melacak perangkat GPS (object\_id) mana yang dipasang pada kendaraan (vehicle\_id) mana dari waktu ke waktu, beserta stempel waktu perubahan (changed\_datetime), sehingga memungkinkan atribusi data historis yang akurat dan perhitungan jarak tempuh saat pelacak dipindahkan antar kendaraan

<table><thead><tr><th width="144">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>vehicle_tracker_history_id</code> - Pengenal entitas riwayat pelacak kendaraan<br>- <code>vehicle_id</code> - Pengidentifikasi entitas kendaraan<br>- <code>object_id</code> - Pelacak pengidentifikasi entitas<br>- <code>changed_datetime</code> - Tanggal dan waktu yang terkait dengan atribut changed_datetime</td></tr><tr><td><strong>Hubungan</strong></td><td>Melacak perangkat GPS mana yang dipasang pada kendaraan mana dari waktu ke waktu</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Kritis untuk analisis data historis ketika pelacak dipindahkan antar Kendaraan; memungkinkan atribusi Jarak tempuh dan penggunaan yang akurat</td></tr></tbody></table>

</details>

Data referensi dan pencarian

<details>

<summary><strong><code>description_parameters</code></strong></summary>

**Deskripsi**: Data referensi seluruh sistem yang menyediakan label yang mudah dibaca manusia (deskripsi) untuk nilai bilangan bulat yang dienumerasi (kunci) yang digunakan di seluruh basis data, dikelompokkan berdasarkan kolom tipe (misalnya, task\_status, fuel\_type, counter\_type, entity\_classification) untuk menerjemahkan nilai secara konsisten dalam pelaporan dan tampilan UI

<table><thead><tr><th width="146">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>kunci</code> - Nilai yang mungkin dalam atribut<br>- <code>tipe</code> - Atribut komposit yang terdiri dari nama tabel diikuti oleh garis bawah dan nama atribut dalam tabel<br>- <code>deskripsi</code> - Nilai implisit dari sebuah atribut</td></tr><tr><td><strong>Konten</strong></td><td>Menyediakan label yang dapat dibaca manusia untuk nilai berkode di seluruh basis data (status Tugas, jenis Bahan bakar, jenis pencacah, dll.)</td></tr><tr><td><strong>Hubungan</strong></td><td>Direferensikan melalui kunci asing dari beberapa tabel untuk kategorisasi terstandar</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Penting untuk menerjemahkan kode bilangan bulat ke nilai yang dapat dibaca dalam laporan; <code>tipe</code> kelompok bidang untuk enumerasi terkait</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>penghitung</code></strong></summary>

**Deskripsi**: Konfigurasi pencacah odometer dan jam mesin yang menghubungkan pembacaan sensor perangkat (sensor\_id) ke pengukuran jarak atau waktu dengan koefisien pengali untuk konversi satuan (km, mil, jam) dan counter\_type dari description\_parameters yang mendefinisikan jenis pengukuran

<table><thead><tr><th width="140">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>counter_id</code> - ID internal<br>- <code>device_id</code> - Pengidentifikasi entitas perangkat<br>- <code>counter_type</code> - Jenis pencacah<br>- <code>sensor_id</code> - Pengidentifikasi entitas sensor<br>- <code>multiplier</code> - Koefisien untuk mengonversi nilai ke salah satu metrik (km, l, dll.)</td></tr><tr><td><strong>Hubungan</strong></td><td>Menghubungkan perangkat ke pembacaan sensor yang merepresentasikan pencacah jarak atau waktu</td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>multiplier</code> mengonversi pulsa sensor ke satuan sebenarnya (km, mil, jam); <code>counter_type</code> dari <code>description_parameters</code> mendefinisikan jenis pengukuran</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>device_output_name</code></strong></summary>

**Deskripsi**: Label khusus untuk kanal keluaran perangkat yang memetakan pengenal keluaran numerik (number) ke nama yang ditentukan pengguna (label) seperti "Door Lock" atau "Engine Block" untuk pelaporan yang mudah dibaca dan analisis perintah serta status keluaran perangkat

<table><thead><tr><th width="140">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>device_id</code> - Pengidentifikasi entitas perangkat<br>- <code>angka</code> - Atribut number pada tabel device_output_name<br>- <code>label</code> - Atribut label pada tabel device_output_name</td></tr><tr><td><strong>Konten</strong></td><td>Memetakan nomor kanal keluaran ke nama yang ditentukan pengguna (mis., "Door Lock", "Engine Block")</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Memungkinkan pelaporan yang mudah dibaca saat menganalisis perintah dan status keluaran perangkat</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>device_settings</code></strong></summary>

**Deskripsi**: Pasangan kunci-nilai konfigurasi perangkat yang disinkronkan dari platform sumber. Setiap baris menyimpan satu pengaturan konfigurasi untuk perangkat tertentu.

<table><thead><tr><th width="140">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>device_id</code> - Pengidentifikasi entitas perangkat<br>- <code>kunci</code> - Nama pengaturan<br>- <code>nilai</code> - Nilai pengaturan</td></tr><tr><td><strong>Kunci utama</strong></td><td>Komposit: <code>(device_id, key)</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Diisi selama sinkronisasi klien penuh. Gunakan tabel ini untuk membaca nilai konfigurasi tingkat perangkat bersama data telematika atau data bisnis.</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>event_description</code></strong></summary>

**Deskripsi**: Tabel referensi kode peristiwa pelacak dengan deskripsi yang dapat dibaca manusia. Berisi 134 entri yang mencakup peristiwa pelacak umum seperti SOS, Mode Sleep, Pengapian, dan perubahan input/output digital.

<table><thead><tr><th width="140">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Bidang kunci</strong></td><td>- <code>event_id</code> - Kode peristiwa (kunci primer)<br>- <code>deskripsi</code> - Nama peristiwa yang dapat dibaca manusia</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Gabungkan ke <code>raw_telematics_data.tracking_data_core</code> pada <code>event_id</code> untuk menampilkan nama peristiwa dalam laporan dan dasbor alih-alih kode numerik.</td></tr></tbody></table>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/id/iot-query/schema-overview/bronze-layer/raw-business-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
