> 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 menyimpan 40+ tabel yang mencakup pengguna, pelacak, kendaraan, tugas, dan geofence. Jelajahi definisi skema dan deskripsi tabel utama untuk analisis SQL

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

{% 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_tugas" {
  "record_added_at" penanda waktu [tidak boleh kosong]
  "start_mileage" numerik
  "komentar" "character varying(255)"
  "status" "character varying(10)" [tidak null]
  "completion_date" stempel waktu
  "start_engine_hours" numerik
  "service_Tugas_id" integer [tidak null]
  "is_notification_push_enabled" boolean [tidak null]
  "date_notification_interval" interval
  "predicted_datetime" stempel waktu
  "biaya" 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
  "mileage_repeat_interval" bilangan bulat
  "vehicle_id" bilangan bulat [tidak null]
  "engine_hours_notification_interval" bilangan bulat
  “start_date” stempel waktu
  "Jarak tempuh_notification_interval" bilangan bulat
  "date_repeat_interval" interval
  "deskripsi" "character varying(255)"
  "nomor telepon sms notifikasi" text
  "tanggal akhir" timestamp
  "interval pengulangan Jam mesin" integer
  "Jarak tempuh penyelesaian" integer
}

Tabel "garages" {
  "record_added_at" penanda waktu [tidak boleh kosong]
  "id garasi" integer [not null]
  "bujur" numeric
  "nama mekanik" "character varying(255)"
  "radius" integer [not null]
  "lintang" numerik
  "label_organisasi" "character varying(255)"
  "id_pengguna" integer [not null]
  "nama_dispatcher" "character varying(255)"
  "alamat" "character varying(255)"
}

Tabel "riwayat_Supir" {
  "tanggal_waktu_server" timestamp [not null]
  "alamat" "character varying(255)"
  "diperbarui_oleh" integer [not null]
  "id_Pelacak" integer
  "bujur" numeric
  "lintang" numerik
  "id_riwayat_Supir" integer [not null]
  "hardware_key" "character varying(64)"
  "new_employee_id" integer
  "changed_datetime" timestamp
  "record_added_at" penanda waktu [tidak boleh kosong]
  "old_employee_id" integer
}

Tabel "departments" {
  "record_added_at" penanda waktu [tidak boleh kosong]
  "department_label" "character varying(255)" [not null]
  "lintang" numerik
  "department_id" integer [not null]
  "alamat" "character varying(255)"
  "radius" integer [not null]
  "bujur" numeric
  "id_pengguna" integer [not null]
}

Tabel "checkins" {
  "radius" integer [not null]
  "latitude" numeric [not null]
  "employee_id" integer [not null]
  "longitude" numerik [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "actual_datetime" stempel waktu [tidak null]
  "id_pengguna" integer [not null]
  "form_id" bilangan bulat [tidak null]
  "alamat" "character varying(255)"
  "planned_datetime" stempel waktu [tidak null]
  "object_id" bilangan bulat [tidak null]
  "checkin_id" integer [tidak null]
  "komentar" teks
}

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

Tabel "Area_linked_entity_fields" {
  "value" bigint [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "Tempat_id" integer [not null]
  "field_id" integer [not null]
}

Tabel "Area_text_fields" {
  "Tempat_id" integer [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "value" text [not null]
  "field_id" integer [not null]
}

Tabel "users2zones" {
  "zone_id" integer [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "id_pengguna" integer [not null]
}

Tabel "objects" {
  "record_added_at" penanda waktu [tidak boleh kosong]
  "create_datetime" stempel waktu [tidak null]
  "client_id" bilangan bulat [tidak null]
  "kelompok_id" integer
  "Pelacak_label" "character varying(100)"
  "model" "character varying(64)"
  "is_clone" boolean [tidak null]
  "is_deleted" boolean [not null]
  "device_id" integer [tidak null]
  "object_id" bilangan bulat [tidak null]
}

Tabel "device_output_name" {
  "device_id" integer [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "label" "character varying(100)" [not null]
  "number" integer [tidak null]
}

Tabel "perimeter_points" {
  "longitude" numerik [tidak null]
  "number" integer [tidak null]
  "zone_id" integer [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "latitude" numeric [not null]
}

Tabel "custom_fields" {
  "record_added_at" penanda waktu [tidak boleh kosong]
  "entity_id" integer [tidak null]
  "is_required" boolean [tidak null]
  "custom_field_label" teks [tidak null]
  “parameter” jsonb
  "custom_field_type" integer [tidak null]
  teks "description"
  "custom_field_id" integer [tidak null]
}

Tabel "area_decimal_fields" {
  "field_id" integer [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "Tempat_id" integer [not null]
  "value" numerik [tidak boleh null]
}

Tabel "task_history" {
  "task_id" bilangan bulat [tidak boleh null]
  "aktivitas" integer [tidak null]
  "task_history_id" bilangan bulat [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "id_pengguna" integer [not null]
  "event_datetime" stempel waktu [tidak null]
  "muatan" teks
}

Tabel "Tagar" {
  "tag_label" "character varying(64)" [not null]
  "color" "character varying(6)"
  "id_pengguna" integer [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "tag_id" integer [tidak null]
}

Tabel "Area" {
  teks "description"
  "custom_fields" jsonb
  "Tempat_id" integer [not null]
  "external_id" "character varying(32)"
  "record_added_at" penanda waktu [tidak boleh kosong]
  "user_id" bilangan bulat
  "lintang" numerik
  "radius" bilangan bulat
  "tempat_label" "character varying(256)"
  "assigned_datetime" timestamp
  "address" "character varying(256)"
  "bujur" numeric
}

Tabel "status_listings" {
  "id_pengguna" integer [not null]
  "is_supervisor_controlled" boolean [not null]
  "is_deleted" boolean [not null]
  "status_listing_id" integer [not null]
  "is_employee_controlled" boolean [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "status_listing_label" "character varying(200)" [not null]
}

Tabel "models" {
  "record_added_at" penanda waktu [tidak boleh kosong]
  "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 null]
  "outputs_amount" integer [tidak null]
}

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

Tabel "groups" {
  "group_id" bilangan bulat [tidak null]
  "Warna Kelompok" "character varying(6)" [not null]
  "Label Kelompok" "character varying(255)" [not null]
  "client_id" bilangan bulat [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
}

Tabel "Deskripsi sensor" {
  "record_added_at" penanda waktu [tidak boleh kosong]
  “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" bilangan bulat [tidak 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" penanda waktu [tidak boleh kosong]
  "entity_id" integer [tidak null]
  "Tipe bawaan" integer [not null]
  "id_pengguna" integer [not null]
}

Tabel "Zona" {
  "alamat" "character varying(255)"
  "radius" integer [not null]
  "zone_id" integer [tidak null]
  "Lintang pusat lingkaran" numeric [not null]
  "client_id" bilangan bulat [tidak null]
  "Label zona" "character varying(100)"
  "color" "character varying(6)" [not null]
  "Tipe zona" "character varying(20)" [not null]
  "Bujur pusat lingkaran" numeric [not null]
  "latitude" numeric [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "longitude" 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)"
  "id_Pelacak" integer
  "ID status Kendaraan" integer
  "Masa berlaku Asuransi tanggung jawab" timestamp
  "Tahun pembuatan" integer
  "Kelas 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" penanda waktu [tidak boleh kosong]
  "Nomor registrasi trailer" "character varying(32)"
  "Tanggal kedaluwarsa Asuransi gratis" timestamp
  "Berat kotor" 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)"
  "id_pengguna" integer [not 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" penanda waktu [tidak boleh kosong]
  "tipe_entitas" integer [not null]
  "urutan" integer [not null]
  "tag_id" integer [tidak null]
}

Tabel "rules" {
  "rule_id" integer [tidak null]
  "object_id" bilangan bulat [tidak null]
  “parameter” jsonb
  "alert_phone" "character varying(210)" [tidak null]
  "event_type" "character varying(100)" [tidak null]
  "client_id" bilangan bulat [tidak null]
  "is_push_enabled" boolean [tidak null]
  "event_comment1" "character varying(255)" [tidak null]
  "event_label" "character varying(255)" [tidak null]
  "description" "character varying(255)" [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "alert_sms" text [tidak null]
  "event_Kelompok" integer [tidak null]
  "created_at" timestamp [tidak null]
  "maximum" integer [tidak null]
  "is_deleted" boolean [not null]
  "alert_email" text [tidak null]
  "event_comment2" "character varying(255)" [tidak null]
}

Tabel "status_history" {
  "bujur" numeric
  "new_status_id" integer
  "status_history_id" integer [tidak null]
  "device_id" integer [tidak null]
  "diperbarui_oleh" integer [not null]
  "alamat" "character varying(255)"
  "lintang" numerik
  "record_added_at" penanda waktu [tidak boleh kosong]
  "tanggal_waktu_server" timestamp [not null]
  "changed_datetime" timestamp
  "old_status_id" integer
}

Tabel "rules2zones" {
  "zone_id" integer [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "rule_id" integer [tidak null]
}

Tabel "forms" {
  "object_id" bilangan bulat [tidak null]
  teks "description"
  "formulir_label" "character varying(255)" [not null]
  "fields" text
  "created_at" timestamp [tidak null]
  "submission_address" "character varying(255)"
  "submission_latitude" numeric
  "form_id" bilangan bulat [tidak null]
  "submission_longitude" numeric
  "is_submission_in_zone" boolean [not null]
  "values" text
  "record_added_at" penanda waktu [tidak boleh kosong]
  "tugas_id" integer
  "submitted_at" timestamp
}


Tabel "rules2objects" {
  "Pelacak_params" jsonb
  "param_Kelompok_number" integer [not null]
  "object_id" bilangan bulat [tidak null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "rule_id" integer [tidak null]
}

Tabel "Tugas" {
  "time_from" timestamp
  "stay_duration_minutes" interval
  "external_id" "character varying(100)"
  "id_Pelacak" integer
  "Tugas_type" integer
  "arrival_duration_minutes" interval
  "status" integer
  "arrival_datetime" timestamp
  "record_added_at" penanda waktu [tidak boleh kosong]
  "task_id" bilangan bulat [tidak boleh null]
  "user_id" bilangan bulat
  "waktu perubahan status" timestamp
  "urutan penyortiran" integer
  "waktu sampai" timestamp
  "menit keterlambatan maksimum" integer
  "kontrol durasi tinggal diaktifkan" boolean
  "alamat" "character varying(255)"
  "label Tugas" "character varying(200)" [not null]
  "bujur" numeric
  "dibuat oleh" integer
  "deskripsi" text [not null]
  "radius" bilangan bulat
  "lintang" numerik
  "durasi tinggal" integer
  "created_at" timestamp [tidak null]
  "custom_fields" jsonb
  "id Tugas induk" integer
}

Tabel "bidang bigint Area" {
  "field_id" integer [not null]
  "value" bigint [not null]
  "Tempat_id" integer [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
}

Tabel "perangkat" {
  "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]
  "created_at" timestamp [tidak null]
  "id Pemilik" integer [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
}

Tabel "parameter deskripsi" {
  "deskripsi" "character varying(150)"
  "record_added_at" penanda waktu [tidak boleh kosong]
  "jenis" "character varying(100)" [not null]
  "kunci" integer [not null]
}

Tabel "pengguna" {
  "label perusahaan" "character varying(255)" [not null]
  "waktu pendaftaran" timestamp
  "nama depan" "character varying(100)" [not null]
  "id induk" integer
  "nama belakang" "character varying(100)" [not null]
  "tanggal lahir" timestamp
  "label zona waktu" "character varying(30)"
  "nama tengah" "character varying(100)" [not null]
  "id_pengguna" integer [not null]
  "lokal" "character varying(10)" [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
}

Tabel "penghitung" {
  "id sensor" integer
  "pengali" numeric [not null]
  "id penghitung" integer [not null]
  "device_id" integer [tidak null]
  "jenis penghitung" integer [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
}

Tabel "karyawan" {
  "masa berlaku lisensi Supir" timestamp
  "record_added_at" penanda waktu [tidak boleh kosong]
  "nama belakang" "character varying(100)"
  "id departemen" integer
  "nomor identitas warga" "character varying(32)"
  "nama depan" "character varying(100)"
  "kategori lisensi Supir" "character varying(32)"
  "id_pengguna" integer [not null]
  "nomor telepon" "character varying(32)"
  "id_Pelacak" integer
  "is_deleted" boolean [not null]
  "tanggal penerbitan lisensi Supir" boolean
  "hardware_key" "character varying(64)"
  "nama tengah" "character varying(100)"
  "alamat" "character varying(255)"
  "lintang" numerik
  "employee_id" integer [not null]
  "nomor personel" "character varying(15)"
  "biaya Bahan bakar" doubleprecision
  "nomor_sim_pengemudi" "karakter bervariasi(32)"
  "email" "character varying(100)"
  “konsumsi bahan bakar” presisi ganda
  "radius" integer [not null]
  "bujur" numeric
}

Tabel "places_longtext_fields" {
  "field_id" integer [not null]
  "value" text [not null]
  "record_added_at" penanda waktu [tidak boleh kosong]
  "Tempat_id" integer [not null]
}

Tabel "groups_objects" {
  "groups_client_id" bilangan bulat
  "objects_client_id" bilangan bulat

  Indeks {
    (groups_client_id, objects_client_id) [pk]
  }
}

Tabel "device_settings" {
  "device_id" integer [tidak null]
  "key" "character varying" [not null]
  "nilai" teks

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

Tabel "event_description" {
  "event_id" integer [tidak null, pk]
  teks "description"
}

Ref:"employees"."employee_id" < "checkins"."employee_id"

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

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

Ref:"sensor_description"."sensor_id" < "counters"."sensor_id"

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

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

Ruj:"departments"."department_id" < "employees"."department_id"

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

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

Referensi:"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"

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

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

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

Ref:"description_parameters"."key" < "Tugas"."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"

Referensi:"status_listings"."status_listing_id" < "devices"."status_listing_id"

Ref:"employees"."employee_id" < "driver_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"

Acuan:"users"."user_id" < "employees"."user_id"

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

Ref:"Tugas"."Tugas_id" < "forms"."Tugas_id"

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

Ref:"Pelacak"."Pelacak_id" < "Tugas"."Pelacak_id"

Ref:"users"."user_id" < "garages"."user_id"

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

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

Ruj:"models"."model" < "objects"."model"

Acuan:"devices"."device_id" < "objects"."device_id"

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

Ref:"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" < "Area_decimal_fields"."field_id"

Ref:"places"."place_id" < "places_decimal_fields"."place_id"

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

Ref:"Area"."Tempat_id" < "Area_linked_entity_fields"."Tempat_id"

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

Ruj:"Area"."Tempat_id" < "Area_longtext_fields"."Tempat_id"

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

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

Ruj:"rules"."rule_id" < "rules2zones"."rule_id"

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

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

Ruj:"zones"."zone_id" < "rules2zones"."zone_id"

Rujukan:"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"

Referensi:"devices"."device_id" < "status_history"."device_id"

Ref:"users"."user_id" < "status_listings"."user_id"

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

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

Ref:"users"."user_id" < "Tagar"."user_id"

Ref:"Tugas"."task_id" < "task_history"."task_id"

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

Ref:"Tugas"."parent_task_id" < "Tugas"."task_id"

Rujukan:"users"."user_id" < "Tugas"."user_id"

Referensi:"users"."master_id" < "users"."user_id"

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

Ref:"zones"."zone_id" < "users2zones"."zone_id"

Rujukan:"Kendaraan"."vehicle_id" < "vehicle_service_Tugas"."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"

Ref:"users"."user_id" < "Kendaraan"."user_id"

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

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

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

```

{% endcode %}

## Frekuensi pembaruan

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

## `parameter deskripsi`

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

<table><thead><tr><th width="167.1817626953125">Jenis referensi</th><th width="173.9090576171875">Deskripsi</th><th>Nilai contoh</th></tr></thead><tbody><tr><td>Definisi tipe</td><td>Tipe entitas standar</td><td><code>vehicle_type: mobil, truk, bus</code></td></tr><tr><td>Kode status</td><td>Nilai status Tugas dan sistem</td><td><code>status_tugas: belum ditugaskan, ditugaskan, selesai</code></td></tr><tr><td>Definisi unit</td><td>Satuan pengukuran untuk sensor</td><td><code>jenis satuan: 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 dalam **`raw_business_data`** skema diorganisasikan ke dalam kategori fungsional agar lebih mudah dinavigasi. Tabel di bawah ini 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>Field kunci</strong></td><td>- <code>user_id</code> - Pengenal unik pengguna<br>- <code>nama perusahaan</code> - Nama perusahaan yang terkait dengan pengguna<br>- <code>nama depan</code> - Nama pengguna<br>- <code>nama belakang</code> - Nama belakang pengguna<br>- <code>nama tengah</code> - Nama patronimik pengguna<br>- <code>lokal</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 merupakan bawahan)<br>- <code>registration_datetime</code> - Tanggal pendaftaran di sistem<br>- <code>birth_date</code> - Tanggal lahir pengguna</td></tr><tr><td><strong>Relasi</strong></td><td>Pengguna induk melalui <code>master_id</code>, tertaut 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-orang yang bekerja untuk organisasi, termasuk informasi pribadi, detail lisensi, penugasan departemen, kunci perangkat keras untuk identifikasi iButton/RFID, dan data lokasi dengan dukungan geofence

<table><thead><tr><th width="143">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>employee_id</code> - Pengidentifikasi entitas karyawan<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>object_id</code> - pengenal entitas objek<br>- <code>department_id</code> - ID departemen tempat karyawan ditugaskan<br>- <code>nama depan</code> - Atribut first_name pada tabel karyawan<br>- <code>nama belakang</code> - Atribut last_name dari tabel karyawan<br>- <code>nama tengah</code> - Atribut middle_name pada tabel karyawan<br>- <code>nomor surat izin mengemudi</code> - Nomor SIM Supir<br>- <code>kategori_surat_izin_mengemudi_Supir</code> - Kategori SIM Supir<br>- <code>tanggal penerbitan surat izin mengemudi</code> - Tanggal penerbitan SIM Supir<br>- <code>masa berlaku SIM Supir hingga</code> - Tanggal hingga lisensi Supir berlaku<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 kependudukan</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>dihapus</code> - atribut is_deleted dari tabel employees</td></tr><tr><td><strong>Relasi</strong></td><td>Tautan ke <code>Pengguna</code>, <code>departemen</code>, <code>objek</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 geofencing 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 asosiasi lokasi karyawan

<table><thead><tr><th width="156">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field 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 dari 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 alamat dari tabel departments</td></tr><tr><td><strong>Relasi</strong></td><td>Menghubungkan karyawan ke 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 penetapan daftar status untuk manajemen siklus hidup perangkat

<table><thead><tr><th width="138">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field 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 - <code>network_label</code> - Nama jaringan tempat kartu SIM terhubung - <code>signal_level</code> - Kekuatan sinyal perangkat - <code>has_roaming</code> - Flag ketersediaan roaming - <code>is_sim_blocked</code> - Flag penguncian kartu SIM - <code>created_at</code> - Tanggal dan waktu entri dibuat</td></tr><tr><td><strong>Relasi</strong></td><td>Entitas inti yang menaut ke <code>objek</code>, <code>model</code>, <code>sensor_description</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 dalam <code>raw_telematics_data</code> skema merujuk tabel ini melalui <code>device_id</code></td></tr></tbody></table>

</details>

<details>

<summary><strong><code>objek</code></strong></summary>

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

<table><thead><tr><th width="148">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>object_id</code> - pengenal entitas objek<br>- <code>client_id</code> - ID 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>dihapus</code> - Atribut is_deleted pada tabel objek<br>- <code>is_clone</code> - Penanda klon</td></tr><tr><td><strong>Relasi</strong></td><td>Pusat 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 objek 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 ke struktur organisasi melalui client\_id dan group\_id, yang merepresentasikan "trackable unit" dengan satu Pelacak aktif per perangkat

<table><thead><tr><th width="135">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>model_id</code> - ID model entitas<br>- <code>model</code> - Atribut model pada tabel model<br>- <code>vendor</code> - Nama perusahaan yang merilis pelacak<br>- <code>alternative_label</code> - Atribut alternative_label pada tabel model<br>- <code>analog_amount</code> - Jumlah input analog pada pelacak<br>- <code>digital_amount</code> - Jumlah input diskret pada pelacak<br>- <code>outputs_amount</code> - Jumlah keluaran diskret pada pelacak<br>- <code>has_battery_level</code> - Menentukan apakah pelacak mengirimkan pembacaan level 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> - Apakah pelacak dapat mengirimkan kekuatan sinyal GSM?<br>- <code>has_gsm_name</code> - Apakah pelacak dapat mengirimkan nama jaringan GSM atau kode operator (MCC + MNC)?<br>- <code>has_gsm_roaming</code> - Apakah pelacak dapat 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 tertentu, seperti mode mengemudi berbahaya (hbm_telfm) untuk peralatan Teltonika<br>- <code>is_clone</code> - Apakah model ini klon dari model lain?</td></tr><tr><td><strong>Konten</strong></td><td>Penanda kapabilitas boolean menunjukkan bidang data mana yang tersedia dari jenis perangkat ini</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Gunakan penanda kapabilitas untuk menentukan sensor dan input yang valid saat melakukan kueri data telematika</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>sensor_description</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 level bahan bakar, ambang batas akurasi, dan logika pengelompokan untuk pembacaan sensor agregat

<table><thead><tr><th width="142">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field 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 UI<br>- <code>input_label</code> - Nama field (atribut) pesan tempat data sensor diambil. Jika sama dengan "input_status," itu adalah sensor diskret<br>- <code>jenis_sensor</code> - Jenis sensor<br>- <code>jenis_satuan</code> - Satuan pengukuran<br>- <code>pengali</code> - Pengali - angka yang digunakan untuk mengalikan nilai field. Hanya untuk Sensor pengukuran<br>- <code>pembagi</code> - Pembagi - angka yang digunakan untuk membagi nilai field. Hanya untuk Sensor pengukuran<br>- <code>akurasi</code> - Persentase yang ditentukan untuk menghitung galat absolut volume tangki. Galat ini digunakan untuk menentukan kapan pengisian ulang atau pengurasan sedang terjadi. Ini digunakan hanya untuk sensor Bahan bakar<br>- <code>calibration_data</code> - Atribut calibration_data pada tabel sensor_description<br>- <code>input_id</code> - Masukkan nomor untuk sensor diskret<br>- <code>kelompok_id</code> - Sensor dengan tipe yang sama dengan group_id dan source_id yang sama dianggap termasuk dalam Kelompok yang sama. Data mereka dijumlahkan atau dirata-ratakan, tergantung pada nilai group_type. Ini diperlukan untuk sensor agregasi. Ini digunakan pada sensor pengukuran<br>- <code>tipe_kelompok</code> - 0 - jumlahkan nilai sensor dalam Kelompok, 1 - rata-rata<br>- <code>satuan_sensor</code> - Nama unit yang dimasukkan pengguna jika units_type=0 (kustom)<br>- <code>parameter</code> - Objek opsional dengan parameter tambahan parent_ids - larik opsional parent_ids untuk sensor komposit. volume - double. Opsional. Volume untuk sensor komposit. parent_ids - larik int opsional. Array parent_ids untuk sensor komposit. volume - opsional. Double. Volume untuk sensor komposit. min - opsional. Double. Nilai mentah minimum yang dapat diterima untuk sebuah sensor. max - opsional. Double. Nilai mentah maksimum yang dapat diterima untuk sebuah sensor. max_lowering_by_time - opsional. Double. Nilai legal maksimum penurunan per jam. max_lowering_by_mileage - opsional. Double. Nilai legal maksimum penurunan per 100 km. ignore_drains_in_move - opsional. Boolean. Nilai default false. Jika benar, pengurasan Bahan bakar tidak akan terdeteksi selama Gerakan. ignore_refuels_in_move - opsional. Boolean. Nilai default false. Jika benar, pengisian kembali tidak akan terdeteksi selama Gerakan. refuel_gap_minutes - opsional. Integer. Nilai default 5. Waktu dalam menit setelah dimulainya Gerakan, pengisian kembali akan terdeteksi selama Gerakan. custom_field_name - opsional. Boolean. Nilai default false. Parameter ini menentukan apakah field input_name merupakan nilai kustom yang dimasukkan oleh pengguna. Ini hanya masuk akal jika model pelacak memiliki fitur has_custom_fields</td></tr><tr><td><strong>Relasi</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>pengali</code> dan <code>pembagi</code> konversi nilai mentah ke satuan</td></tr></tbody></table>

</details>

Manajemen aset

<details>

<summary><strong><code>Kendaraan</code></strong></summary>

**Deskripsi**: Registri kendaraan yang komprehensif berisi spesifikasi (dimensi, berat, kapasitas), dokumentasi (VIN, pendaftaran, Asuransi), parameter operasional (Konsumsi bahan bakar, volume tangki), serta penugasan 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>Field kunci</strong></td><td>- <code>vehicle_id</code> - Pengenal entitas kendaraan<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>object_id</code> - pengenal entitas objek<br>- <code>id_garasi</code> - Pengenal entitas garasi<br>- <code>label kendaraan</code> - Atribut vehicle_label dari tabel Kendaraan<br>- <code>registration_number</code> - Nomor registrasi/ pelat nomor kendaraan<br>- <code>VIN</code> - Atribut VIN pada tabel kendaraan<br>- <code>manufacture_year</code> - Atribut manufacture_year dari tabel Kendaraan<br>- <code>jenis bahan bakar</code> - Atribut fuel_type dari tabel Kendaraan<br>- <code>Biaya bahan bakar</code> - Atribut fuel_cost dari tabel Kendaraan<br>- <code>volume tangki bahan bakar</code> - Atribut fuel_tank_volume dari tabel Kendaraan<br>- <code>max_speed</code> - Atribut max_speed dari tabel Kendaraan<br>- <code>model</code> - Atribut model pada tabel kendaraan<br>- <code>warna</code> - Atribut warna pada tabel kendaraan<br>- <code>trailer</code> - Atribut trailer pada tabel kendaraan<br>- <code>informasi_tambahan</code> - Atribut informasi_tambahan pada tabel kendaraan<br>- <code>tipe_kendaraan</code> - Atribut tipe_kendaraan pada tabel kendaraan<br>- <code>subtipe_kendaraan</code> - Atribut subtipe_kendaraan pada tabel kendaraan<br>- <code>vehicle_status_id</code> - Pengidentifikasi entitas status kendaraan<br>- <code>nomor_sasis</code> - Atribut nomor_sasis pada tabel kendaraan<br>- <code>nomor_rangka</code> - Atribut nomor_rangka pada tabel kendaraan<br>- <code>nomor_registrasi_trailer</code> - Atribut nomor_registrasi_trailer pada tabel kendaraan<br>- <code>berat_muatan</code> - Atribut berat_muatan pada tabel kendaraan<br>- <code>tinggi_muatan</code> - Atribut tinggi_muatan pada tabel kendaraan<br>- <code>panjang_muatan</code> - Atribut panjang_muatan pada tabel kendaraan<br>- <code>lebar_muatan</code> - Atribut lebar_muatan pada tabel kendaraan<br>- <code>kapasitas_penumpang</code> - Jumlah maksimum penumpang<br>- <code>berat_bruto</code> - Atribut berat_bruto 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>susunan_roda</code> - Atribut susunan_roda pada tabel kendaraan<br>- <code>ukuran_ban</code> - Ukuran kendaraan: dimensi dan ukuran roda<br>- <code>jumlah_ban</code> - Jumlah roda<br>- <code>nomor_polis_asuransi_tanggung_jawab</code> - Atribut nomor_polis_asuransi_tanggung_jawab pada tabel kendaraan<br>- <code>masa_berlaku_asuransi_tanggung_jawab</code> - Tanggal hingga asuransi tanggung jawab berlaku<br>- <code>nomor_polis_asuransi_gratis</code> - Atribut nomor_polis_asuransi_gratis pada tabel kendaraan<br>- <code>tanggal_berlaku_hingga_asuransi_gratis</code> - Tanggal hingga asuransi gratis berlaku</td></tr><tr><td><strong>Relasi</strong></td><td>Tautan ke <code>objek</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>Kolom dimensi fisik (<code>panjang_muatan</code>, <code>lebar_muatan</code>, <code>tinggi_muatan</code>, <code>berat_bruto</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 servis dan Pemeliharaan dengan koordinat geografis (lintang, bujur, radius), informasi kontak untuk mekanik dan petugas pengatur, memungkinkan deteksi kunjungan servis berbasis Perimeter dan analisis kedekatan

<table><thead><tr><th width="135">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>id_garasi</code> - Pengenal entitas garasi<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>Lintang</code> - Objek lokasi<br>- <code>Bujur</code> - Objek lokasi<br>- <code>Radius</code> - Ukuran geolokasi dalam meter<br>- <code>Alamat</code> - Objek lokasi<br>- <code>label_organisasi</code> - ID depot<br>- <code>mechanic_name</code> - Nama mekanik<br>- <code>dispatcher_name</code> - Nama pengatur</td></tr><tr><td><strong>Relasi</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**: Jadwal Pemeliharaan dan pelacakan riwayat servis dengan berbagai jenis pemicu (berbasis tanggal, berbasis jarak tempuh, berbasis jam mesin), interval tugas berulang, notifikasi multisaluran (email, SMS, push), serta 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>Field kunci</strong></td><td>- <code>service_tugas_id</code> - Pengidentifikasi entitas tugas layanan<br>- <code>vehicle_id</code> - Pengenal entitas kendaraan<br>- <code>deskripsi</code> - Atribut description dari tabel vehicle_service_tugas<br>- <code>status</code> - Nilai status dari atribut status<br>- <code>biaya</code> - Atribut biaya dari tabel vehicle_service_tasks<br>- <code>start_date</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 dari tabel vehicle_service_tasks<br>- <code>batas jam mesin</code> - Atribut engine_hours_limit dari tabel vehicle_service_tasks<br>- <code>jarak tempuh awal</code> - Atribut start_mileage dari tabel vehicle_service_tasks<br>- <code>start_engine_hours</code> - Atribut start_engine_hours dari tabel vehicle_service_tasks<br>- <code>interval notifikasi jarak tempuh</code> - Atribut Jarak tempuh_notification_interval dari tabel vehicle_service_Tugas<br>- <code>engine_hours_notification_interval</code> - Atribut engine_hours_notification_interval dari tabel vehicle_service_Tugas<br>- <code>date_notification_interval</code> - Mengonversi bilangan bulat N menjadi N hari<br>- <code>interval pengulangan jarak tempuh</code> - Atribut mileage_repeat_interval dari tabel vehicle_service_tasks<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_tugas<br>- <code>notification_sms_phone_numbers</code> - Atribut notification_sms_phone_numbers dari tabel vehicle_service_tasks<br>- <code>is_notification_push_enabled</code> - Atribut is_notification_push_enabled dari tabel vehicle_service_tasks<br>- <code>jarak tempuh penyelesaian</code> - Atribut completion_mileage dari tabel vehicle_service_tasks<br>- <code>jam mesin penyelesaian</code> - Atribut completion_engine_hours dari tabel vehicle_service_tasks<br>- <code>berulang</code> - Atribut is_repeat dari tabel vehicle_service_tasks<br>- <code>is_unplanned</code> - Atribut is_unplanned dari tabel vehicle_service_tasks<br>- <code>komentar</code> - Atribut komentar dari 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>is_unplanned</code> membedakan pemeliharaan terjadwal dan pemeliharaan reaktif</td></tr></tbody></table>

</details>

Lokasi dan perutean

<details>

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

**Deskripsi**: Area geofence yang menentukan batas 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>Field kunci</strong></td><td>- <code>zone_id</code> - Pengenal entitas zona<br>- <code>client_id</code> - ID entitas klien<br>- <code>zone_label</code> - Atribut zone_label pada tabel zone<br>- <code>zone_type</code> - Atribut zone_type pada tabel zone<br>- <code>Lintang</code> - Objek opsional, kotak pembatas yang dapat sepenuhnya memuat hasil yang dikembalikan<br>- <code>Bujur</code> - Objek opsional, kotak pembatas yang dapat sepenuhnya memuat hasil yang dikembalikan<br>- <code>circle_center_latitude</code> - Atribut circle_center_latitude pada tabel zone<br>- <code>circle_center_longitude</code> - Atribut circle_center_longitude pada tabel zone<br>- <code>Radius</code> - Ukuran geolokasi dalam meter<br>- <code>Alamat</code> - Atribut address pada tabel zone<br>- <code>warna</code> - Atribut color pada tabel zone</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>Relasi</strong></td><td>Direferensikan oleh <code>aturan ke zona</code>, <code>users2zones</code>; titik sudut poligon disimpan dalam <code>titik_perimeter</code></td></tr><tr><td><strong>Catatan khusus</strong></td><td>Fungsi PostGIS dapat digunakan untuk memeriksa titik dalam poligon 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>Field kunci</strong></td><td>- <code>place_id</code> - Tempat pengidentifikasi entitas<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>label Tempat</code> - Atribut place_label dari tabel Area<br>- <code>Lintang</code> - Objek lokasi<br>- <code>Bujur</code> - Objek lokasi<br>- <code>Radius</code> - Ukuran geolokasi dalam meter<br>- <code>Alamat</code> - Atribut alamat dari tabel Area<br>- <code>deskripsi</code> - Atribut deskripsi pada tabel Area<br>- <code>external_id</code> - ID untuk integrasi dengan sistem eksternal (CRM)<br>- <code>bidang kustom</code> - Bidang tambahan<br>- <code>assigned_datetime</code> - Tanggal dan waktu penetapan titik minat kepada pengguna</td></tr><tr><td><strong>Relasi</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>bidang kustom</code> JSONB menyediakan akses cepat; tabel terkait memungkinkan pemfilteran dan pengurutan berdasarkan atribut kustom</td></tr></tbody></table>

</details>

<details>

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

**Deskripsi**: Koordinat titik sudut berurutan (bidang angka menentukan urutan) yang menentukan batas poligon untuk bentuk Perimeter kompleks, memungkinkan perimeter geografis yang presisi di luar zona melingkar 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>Field 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>Relasi</strong></td><td>Beberapa catatan 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>ORDER BY number</code> untuk merekonstruksi jalur poligon; gunakan bersama PostGIS ST_MakePolygon untuk operasi geometri</td></tr></tbody></table>

</details>

Manajemen Tugas dan alur kerja

<details>

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

**Deskripsi**: Penugasan work order 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 serta operasi pengiriman

<table><thead><tr><th width="130">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>id_tugas</code> - Pengidentifikasi entitas Tugas<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>object_id</code> - pengenal entitas objek<br>- <code>parent_tugas_id</code> - Pengidentifikasi entitas Tugas induk<br>- <code>label_tugas</code> - Atribut task_label dari 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 tabel Tugas<br>- <code>Bujur</code> - Atribut longitude dari tabel Tugas<br>- <code>Radius</code> - Ukuran geolokasi dalam meter<br>- <code>arrival_datetime</code> - Ketika 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 sukses. Beberapa kunjungan bersifat kumulatif<br>- <code>arrival_duration_minutes</code> - Abaikan kunjungan acak yang lebih singkat daripada durasi yang ditentukan. Saat menghitung durasi minimum, kunjungan yang lebih singkat daripada durasi yang ditentukan akan diabaikan<br>- <code>max_delay_minuts</code> - Keterlambatan yang dapat diterima. Jumlah waktu maksimum seorang karyawan dapat terlambat. Setiap Tugas yang diselesaikan selama waktu ini akan ditandai sebagai “terlambat”<br>- <code>is_stay_control_enabled</code> - Atribut is_stay_control_enabled pada tabel Tugas<br>- <code>Alamat</code> - Atribut alamat dari tabel Tugas<br>- <code>deskripsi</code> - Atribut deskripsi dari tabel Tugas<br>- <code>bidang kustom</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 Tugas yang dibuat</td></tr><tr><td><strong>Konten</strong></td><td>Mendukung Tugas hierarkis melalui <code>parent_tugas_id</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>Relasi</strong></td><td>Tautan ke <code>formulir</code> (pengumpulan data), <code>riwayat tugas</code> (perubahan status), <code>objek</code> (pelacak yang ditugaskan)</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 yang 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>Field kunci</strong></td><td>- <code>formulir_id</code> - Pengidentifikasi entitas Formulir<br>- <code>id_tugas</code> - ID tugas yang dilampirkan pada Formulir ini<br>- <code>object_id</code> - pengenal entitas objek<br>- <code>label_formulir</code> - Label Formulir yang ditentukan pengguna<br>- <code>bidang</code> - Jika bernilai true, Formulir hanya dapat dikirimkan di zona tugas<br>- <code>nilai</code> - Peta dengan ID bidang sebagai kunci dan objek field_value sebagai nilai. Kunci digunakan untuk menautkan bidang dan nilai yang sesuai<br>- <code>dikirimkan_pada</code> - Tanggal saat nilai Formulir terakhir kali dikirimkan<br>- <code>lintang_pengiriman</code> - Lokasi saat nilai Formulir terakhir kali dikirimkan<br>- <code>submission_longitude</code> - Lokasi saat nilai Formulir terakhir kali dikirimkan<br>- <code>submission_address</code> - Lokasi saat nilai Formulir terakhir kali dikirimkan<br>- <code>is_submission_in_zone</code> - Jika bernilai true, 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>Relasi</strong></td><td>Tautan ke <code>Tugas</code> (perintah kerja terkait), <code>objek</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 versus 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>Field kunci</strong></td><td>- <code>checkin_id</code> - ID entitas check-in<br>- <code>employee_id</code> - ID entitas karyawan juga merupakan ID untuk Supir<br>- <code>object_id</code> - Perangkat karyawan<br>- <code>formulir_id</code> - Pengidentifikasi entitas Formulir<br>- <code>user_id</code> - Pengguna karyawan<br>- <code>planned_datetime</code> - Waktu perangkat saat check-in dilakukan<br>- <code>actual_datetime</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 dalam pemosisian pada suatu titik dalam meter<br>- <code>Alamat</code> - Alamat check-in<br>- <code>komentar</code> - Atribut komentar dari tabel check-in</td></tr><tr><td><strong>Relasi</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>planned_datetime</code> dan <code>actual_datetime</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, penetapan, pembaruan, dan modifikasi bidang dengan stempel waktu (event\_datetime), atribusi pengguna, dan jenis aktivitas (create, update, assign, status\_change) yang disimpan dalam 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>Field kunci</strong></td><td>- <code>id_riwayat_tugas</code> - Pengenal entitas riwayat Tugas<br>- <code>id_tugas</code> - Pengidentifikasi entitas Tugas<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>activity</code> - Operasi yang terjadi. Dapat berupa "create", "update", "assign" atau "status_change"<br>- <code>event_datetime</code> - Tanggal dan waktu peristiwa<br>- <code>payload</code> - Bergantung pada operasi. Biasanya, berisi bidang yang diubah selama operasi</td></tr><tr><td><strong>Konten</strong></td><td>Jenis aktivitas yang ditentukan dalam <code>parameter deskripsi</code>; <code>payload</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 (ngebut, pelanggaran Perimeter, ambang batas sensor, waktu menganggur) disimpan dalam parameter (JSONB), dan pengaturan notifikasi multikanal (alert\_email, alert\_sms, alert\_phone, is\_push\_enabled) untuk pemantauan dan peringatan otomatis berdasarkan data perangkat dan server

<table><thead><tr><th width="131">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>rule_id</code> - Pengidentifikasi entitas aturan<br>- <code>object_id</code> - pengenal entitas objek<br>- <code>client_id</code> - ID entitas klien<br>- <code>event_type</code> - Atribut event_type pada tabel aturan<br>- <code>label peristiwa</code> - Atribut event_label pada tabel aturan<br>- <code>event_kelompok</code> - Atribut event_group dari 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/backend-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>peringatan_telepon</code> - 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 rules<br>- <code>dihapus</code> - Atribut is_deleted pada tabel rules<br>- <code>maksimum</code> - Batas yang diterapkan pada berbagai aturan. Misalnya, untuk aturan waktu menganggur dengan mesin menyala dalam menit<br>- <code>event_comment1</code> - Atribut event_comment1 pada tabel rules<br>- <code>event_comment2</code> - Atribut event_comment2 pada tabel rules</td></tr><tr><td><strong>Konten</strong></td><td>Parameter aturan (JSONB) menentukan kondisi pemicu; mendukung notifikasi email, SMS, telepon, dan push</td></tr><tr><td><strong>Relasi</strong></td><td>Tautan ke objek melalui <code>aturan2objek</code>, zona melalui <code>aturan ke zona</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>maksimum</code> Bidang ini memungkinkan agregasi peristiwa untuk peringatan berbasis ambang batas</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>aturan2objek</code></strong></summary>

**Deskripsi**: Banyak-ke-banyak aturan relasi yang menautkan aturan ke Pelacak yang dimonitor dengan penyesuaian parameter per-Pelacak melalui object\_params (JSONB), sehingga memungkinkan nilai ambang batas yang 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>Field kunci</strong></td><td>- <code>rule_id</code> - Pengidentifikasi entitas aturan<br>- <code>object_id</code> - pengenal entitas objek<br>- <code>nomor_kelompok_parameter</code> - Atribut param_group_number dari tabel rules2objects<br>- <code>parameter_objek</code> - Atribut object_params dari tabel rules2objects</td></tr><tr><td><strong>Konten</strong></td><td><code>parameter_objek</code> (JSONB) memungkinkan penyesuaian aturan untuk setiap 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>aturan ke zona</code></strong></summary>

**Deskripsi**: Hubungan banyak-ke-banyak yang mengaitkan aturan dengan zona geofence, sehingga satu aturan dapat memantau peristiwa masuk/keluar di berbagai 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>Field kunci</strong></td><td>- <code>rule_id</code> - Pengidentifikasi entitas aturan<br>- <code>zone_id</code> - pengidentifikasi entitas zona</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Relasi banyak-ke-banyak memungkinkan pemantauan multi-zona untuk satu aturan (misalnya, peringatan saat memasuki salah satu dari beberapa area terlarang)</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 (color untuk tampilan situs web, order\_sort untuk penempatan) yang digunakan untuk merepresentasikan status kerja perangkat atau karyawan dengan dukungan penghapusan lunak melalui bendera is\_deleted

<table><thead><tr><th width="128">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>status_id</code> - Status pengenal entitas<br>- <code>listing_id</code> - Pengenal entitas listing<br>- <code>status_label</code> - Nilai status dari atribut status_label<br>- <code>warna</code> - Warna yang digunakan untuk ditampilkan di situs web<br>- <code>order_sort</code> - Posisi pengurutan di dalam status listing<br>- <code>dihapus</code> - Atribut is_deleted dari tabel statuses</td></tr><tr><td><strong>Relasi</strong></td><td>Kelompok status yang diatur berdasarkan <code>listing_id</code> (referensi <code>daftar_status</code>); digunakan dalam <code>riwayat_status</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>daftar_status</code></strong></summary>

**Deskripsi**: Definisi kumpulan status yang menentukan nilai status mana 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>Field kunci</strong></td><td>- <code>status_listing_id</code> - Pengenal entitas daftar status<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>label_daftar_status</code> - Nilai status dari atribut status_listing_label<br>- <code>dikendalikan_supervisor</code> - Jika benar, supervisor dapat mengubah status kerja, misalnya menggunakan aplikasi pemantauan seluler<br>- <code>is_employee_controlled</code> - Jika bernilai benar, karyawan dapat mengubah status kerja mereka sendiri, misalnya menggunakan aplikasi pelacakan seluler<br>- <code>dihapus</code> - Atribut is_deleted pada tabel status_listings<br>-</td></tr><tr><td><strong>Relasi</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>riwayat_status</code></strong></summary>

**Deskripsi**: Jejak audit seluruh transisi status perangkat dengan stempel waktu (changed\_datetime pada perangkat, server\_datetime pada server), atribusi pengguna (updated\_by), dan penangkapan lokasi (latitude, longitude, alamat) yang memungkinkan analisis geografis 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>Field kunci</strong></td><td>- <code>status_history_id</code> - Pengidentifikasi entitas riwayat status<br>- <code>device_id</code> - Pengidentifikasi entitas perangkat<br>- <code>old_status_id</code> - Pengenal entitas status lama<br>- <code>new_status_id</code> - Pengenal 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 penetapan status server baru<br>- <code>Lintang</code> - Pelacakan perangkat selama perubahan status<br>- <code>Bujur</code> - Pelacakan perangkat selama perubahan status<br>- <code>Alamat</code> - menentukan lokasi perangkat selama perubahan status</td></tr><tr><td><strong>Relasi</strong></td><td>Tautan ke <code>perangkat</code>, <code>status</code> (lama dan baru), <code>parameter deskripsi</code> (untuk <code>updated_by</code> peran)</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Pencatatan lokasi memungkinkan analisis geografis 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 penyaringan dan pencarian cepat di berbagai jenis entitas (Area, geofence, karyawan, Tugas, pelacak, Kendaraan) untuk pengorganisasian yang fleksibel

<table><thead><tr><th width="149">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field 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>Relasi</strong></td><td>Diterapkan pada entitas melalui <code>tag_links</code>; cakupan yang 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>Field kunci</strong></td><td>- <code>tag_id</code> - Tag ID entitas<br>- <code>entity_type</code> - Atribut entity_type dari tabel tag_links<br>- <code>entity_id</code> - Pengidentifikasi entitas<br>- <code>ordinal</code> - Atribut ordinal dari 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 pada berbagai jenis entitas</td></tr></tbody></table>

</details>

Grup dan hierarki

<details>

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

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

<table><thead><tr><th width="148">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>kelompok_id</code> - Kelompok pelacak (ditautkan oleh objects.group_id). Pembagian menjadi kelompok dapat dilihat dalam daftar beacon, misalnya<br>- <code>client_id</code> - ID entitas klien<br>- <code>label_Kelompok</code> - Judul kelompok yang ditentukan pengguna, 1 hingga 60 karakter yang dapat dicetak, misalnya "Karyawan"<br>- <code>warna_kelompok</code> - Warna Kelompok dalam format web (tanpa #), misalnya "FF6DDC". Menentukan warna penanda pelacak pada peta</td></tr><tr><td><strong>Relasi</strong></td><td>Direferensikan oleh <code>objects.group_id</code>; kepemilikan klien melalui <code>client_id</code> (referensi <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>grup_objek</code></strong></summary>

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

<table><thead><tr><th width="135">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>groups_client_id</code> - Pengidentifikasi entitas klien untuk grup<br>- <code>objects_client_id</code> - Pengidentifikasi entitas klien untuk objek</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Memungkinkan objek berada dalam beberapa grup secara bersamaan; 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 bidangnya (sections, field\_order) yang disimpan dalam entity\_label (JSONB), sehingga 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>Field kunci</strong></td><td>- <code>entity_id</code> - Pengidentifikasi entitas<br>- <code>user_id</code> - Pengidentifikasi entitas pengguna<br>- <code>label entitas</code> - id - int. Pengenal entitas. type - enum. Saat ini, hanya "Tempat" yang didukung. layout - Pelacak menjelaskan tata letak kolom untuk entitas. sections - larik dari Pelacak. Setiap bagian dapat berisi satu atau lebih kolom. Minimal satu bagian harus ada dalam tata letak. label - string. Nama bagian. field_order - larik string. Kolom bawaan dan ID Kolom isian kustom (sebagai string)<br>- <code>builtin_type</code> - Atribut builtin_type dari tabel entities</td></tr><tr><td><strong>Relasi</strong></td><td>Direferensikan oleh <code>bidang kustom</code> untuk menentukan kolom isian mana yang berlaku untuk tipe entitas mana</td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>builtin_type</code> terhubung ke <code>parameter deskripsi</code> untuk klasifikasi entitas yang ditentukan sistem</td></tr></tbody></table>

</details>

<details>

<summary><strong><code>bidang kustom</code></strong></summary>

**Deskripsi**: Definisi kolom isian yang memungkinkan perluasan skema dinamis untuk tipe entitas, dengan tipe kolom yang dapat dikonfigurasi (custom\_field\_type), aturan validasi dan opsi dalam parameters (JSONB), serta penanda keharusan (is\_required) untuk penangkapan data yang fleksibel di seluruh Area, Tugas, dan entitas lainnya

<table><thead><tr><th width="146">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>custom_field_id</code> - Pengidentifikasi entitas kolom isian<br>- <code>entity_id</code> - Pengidentifikasi entitas<br>- <code>custom_field_label</code> - Nama kolom<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>Relasi</strong></td><td>Menentukan atribut kustom yang tersedia untuk entitas; tipe field tertaut ke <code>parameter deskripsi</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 dari penugasan karyawan ke Kendaraan dari waktu ke waktu, melacak transisi old\_employee\_id ke new\_employee\_id dengan 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>Field kunci</strong></td><td>- <code>supir_riwayat_id</code> - ID entitas riwayat Supir<br>- <code>object_id</code> - pengenal entitas objek<br>- <code>id_karyawan_lama</code> - ID entitas karyawan lama<br>- <code>id_karyawan_baru</code> - Pengidentifikasi entitas karyawan baru<br>- <code>kunci perangkat keras</code> - Atribut hardware_key dari tabel driver_history<br>- <code>changed_datetime</code> - Perubahan tanggal dan waktu dilakukan pada perangkat<br>- <code>server_datetime</code> - Tanggal dan waktu perubahan yang dilakukan pada server<br>- <code>updated_by</code> - Tanggal dan waktu yang terkait dengan atribut updated_by<br>- <code>Lintang</code> - Atribut lintang dari tabel driver_history<br>- <code>Bujur</code> - Atribut longitude pada tabel Supir_history<br>- <code>Alamat</code> - Atribut alamat tabel driver_history</td></tr><tr><td><strong>Relasi</strong></td><td>Melacak penugasan Supir ke Kendaraan dari waktu ke waktu; tertaut ke <code>karyawan</code> dan <code>objek</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 perubahan penugasan</td></tr></tbody></table>

</details>

<details>

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

**Deskripsi**: Pelacakan jejak audit untuk melacak perangkat GPS (object\_id) mana yang dipasang pada Kendaraan (vehicle\_id) mana dari waktu ke waktu dengan cap waktu perubahan (changed\_datetime), sehingga memungkinkan atribusi data historis yang akurat dan perhitungan Jarak tempuh ketika pelacak dipindahkan antar Kendaraan

<table><thead><tr><th width="144">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>vehicle_tracker_history_id</code> - Identifier entitas riwayat pelacak kendaraan<br>- <code>vehicle_id</code> - Pengenal entitas kendaraan<br>- <code>object_id</code> - pengenal entitas objek<br>- <code>changed_datetime</code> - Tanggal dan waktu yang terkait dengan atribut changed_datetime</td></tr><tr><td><strong>Relasi</strong></td><td>Mencatat 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 saat 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>parameter deskripsi</code></strong></summary>

**Deskripsi**: Data referensi di seluruh sistem yang menyediakan label yang dapat dibaca manusia (description) untuk nilai integer terenumerasi (key) yang digunakan di seluruh basis data, disusun berdasarkan kolom tipe (misalnya, status Tugas, jenis Bahan bakar, jenis penghitung, klasifikasi entitas) untuk penerjemahan nilai yang konsisten dalam pelaporan dan tampilan UI

<table><thead><tr><th width="146">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>Kunci</code> - Nilai yang mungkin pada atribut<br>- <code>Tipe</code> - Atribut komposit yang terdiri atas nama tabel diikuti garis bawah dan nama atribut dalam tabel<br>- <code>deskripsi</code> - Nilai implisit dari 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 penghitung, dll.)</td></tr><tr><td><strong>Relasi</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 menjadi nilai yang mudah dibaca dalam pelaporan; <code>Tipe</code> kelompok field terkait enumerasi</td></tr></tbody></table>

</details>

<details>

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

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

<table><thead><tr><th width="140">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field kunci</strong></td><td>- <code>counter_id</code> - ID internal<br>- <code>device_id</code> - Pengidentifikasi entitas perangkat<br>- <code>counter_type</code> - Jenis penghitung<br>- <code>sensor_id</code> - Pengidentifikasi entitas sensor<br>- <code>pengali</code> - Koefisien untuk mengonversi nilai ke salah satu metrik (km, l, dll.)</td></tr><tr><td><strong>Relasi</strong></td><td>Menghubungkan perangkat ke pembacaan sensor yang merepresentasikan penghitung jarak atau waktu</td></tr><tr><td><strong>Catatan khusus</strong></td><td><code>pengali</code> mengonversi pulsa sensor menjadi satuan aktual (km, miles, hours); <code>counter_type</code> dari <code>parameter deskripsi</code> mendefinisikan jenis pengukuran</td></tr></tbody></table>

</details>

<details>

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

**Deskripsi**: Label kustom untuk pemetaan saluran keluaran perangkat yang memetakan pengidentifikasi keluaran numerik (angka) ke nama yang ditentukan pengguna (label) seperti "Kunci pintu" atau "Blok mesin" untuk pelaporan dan analisis perintah dan status keluaran perangkat yang mudah dibaca

<table><thead><tr><th width="140">Atribut</th><th>Detail</th></tr></thead><tbody><tr><td><strong>Field 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 saluran keluaran ke nama yang ditentukan pengguna (misalnya, "Kunci pintu", "Blok mesin")</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>Field 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 dengan data telematika atau bisnis.</td></tr></tbody></table>

</details>

<details>

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

**Deskripsi**: Tabel referensi kode peristiwa pelacak dengan deskripsi yang mudah dibaca manusia. Memuat 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>Field kunci</strong></td><td>- <code>event_id</code> - Kode peristiwa (kunci primer)<br>- <code>deskripsi</code> - Nama peristiwa yang mudah dibaca</td></tr><tr><td><strong>Catatan khusus</strong></td><td>Gabung ke <code>raw_telematics_data.tracking_data_core</code> on <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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
