Lapisan data mentah

Lihat dataset sumber untuk entitas bisnis, telemetri perangkat, dan aset/inventaris, serta tabel utama dan waktu pembaruannya.

Layer Data Mentah berisi 3 skema data yang berbeda, masing-masing melayani aspek berbeda dari platform telematika dan intelijen bisnis:

• raw_business_data - berisi tabel, atribut, dan nilai yang terkait dengan informasi bisnis, seperti kendaraan, karyawan, geofence yang ditambahkan oleh pengguna, dll.

• raw_telematics_data - berisi tabel, atribut, dan nilai yang terkait dengan data telematika yang dikirim dari perangkat yang dipantau, seperti lokasi, input, output, dan peristiwa.

• repo - berisi tabel untuk manajemen aset dan inventaris, termasuk tipe aset yang dapat dikonfigurasi, bidang kustom, hubungan aset, dan data geospasial untuk pelacakan sumber daya organisasi.

Setiap skema dioptimalkan untuk domain data dan pola akses spesifiknya, memberikan cakupan komprehensif untuk kebutuhan operasional, telematik, dan manajemen aset.

raw_business_data struktur

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

Diagram interaktif skema raw_business_data tersedia di dbdiagram.io: https://dbdiagram.io/d/V3-bronze-layer-68ecfd1c2e68d21b4131089a

Temukan detail skema data bisnis mentah di bawah ini.

skema raw_business_data

Tabel "vehicle_service_tasks" {
  "record_added_at" timestamp [not null]
  "start_mileage" numeric
  "comment" "character varying(255)"
  "status" "character varying(10)" [not null]
  "completion_date" timestamp
  "start_engine_hours" numeric
  "service_task_id" integer [not null]
  "is_notification_push_enabled" boolean [not null]
  "date_notification_interval" interval
  "predicted_datetime" timestamp
  "cost" numeric [not null]
  "mileage_limit" numeric
  "notification_emails" text
  "is_unplanned" boolean [not null]
  "is_repeat" boolean [not null]
  "completion_engine_hours" integer
  "engine_hours_limit" numeric
  "mileage_repeat_interval" integer
  "vehicle_id" integer [not null]
  "engine_hours_notification_interval" integer
  "start_date" timestamp
  "mileage_notification_interval" integer
  "date_repeat_interval" interval
  "description" "character varying(255)"
  "notification_sms_phone_numbers" text
  "end_date" timestamp
  "engine_hours_repeat_interval" integer
  "completion_mileage" integer
}

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

Tabel "driver_history" {
  "server_datetime" timestamp [not null]
  "address" "character varying(255)"
  "updated_by" integer [not null]
  "object_id" integer
  "longitude" numeric
  "latitude" numeric
  "driver_history_id" integer [not null]
  "hardware_key" "character varying(64)"
  "new_employee_id" integer
  "changed_datetime" timestamp
  "record_added_at" timestamp [not null]
  "old_employee_id" integer
}

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

Tabel "checkins" {
  "radius" integer [not null]
  "latitude" numeric [not null]
  "employee_id" integer [not null]
  "longitude" numeric [not null]
  "record_added_at" timestamp [not null]
  "actual_datetime" timestamp [not null]
  "user_id" integer [not null]
  "form_id" integer [not null]
  "address" "character varying(255)"
  "planned_datetime" timestamp [not null]
  "object_id" integer [not null]
  "checkin_id" integer [not null]
  "comment" text
}

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

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

Tabel "places_text_fields" {
  "place_id" integer [not null]
  "record_added_at" timestamp [not null]
  "value" text [not null]
  "field_id" integer [not null]
}

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

Tabel "objects" {
  "record_added_at" timestamp [not null]
  "create_datetime" timestamp [not null]
  "client_id" integer [not null]
  "group_id" integer
  "object_label" "character varying(100)"
  "model" "character varying(64)"
  "is_clone" boolean [not null]
  "is_deleted" boolean [not null]
  "device_id" integer [not null]
  "object_id" integer [not null]
}

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

Tabel "geofence_points" {
  "longitude" numeric [not null]
  "number" integer [not null]
  "zone_id" integer [not null]
  "record_added_at" timestamp [not null]
  "latitude" numeric [not null]
}

Tabel "custom_fields" {
  "record_added_at" timestamp [not null]
  "entity_id" integer [not null]
  "is_required" boolean [not null]
  "custom_field_label" text [not null]
  "parameters" jsonb
  "custom_field_type" integer [not null]
  "description" text
  "custom_field_id" integer [not null]
}

Tabel "places_decimal_fields" {
  "field_id" integer [not null]
  "record_added_at" timestamp [not null]
  "place_id" integer [not null]
  "value" numeric [not null]
}

Tabel "task_history" {
  "task_id" integer [not null]
  "activity" integer [not null]
  "task_history_id" integer [not null]
  "record_added_at" timestamp [not null]
  "user_id" integer [not null]
  "event_datetime" timestamp [not null]
  "payload" text
}

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

Tabel "places" {
  "description" text
  "custom_fields" jsonb
  "place_id" integer [not null]
  "external_id" "character varying(32)"
  "record_added_at" timestamp [not null]
  "user_id" integer
  "latitude" numeric
  "radius" integer
  "place_label" "character varying(256)"
  "assigned_datetime" timestamp
  "address" "character varying(256)"
  "longitude" numeric
}

Tabel "status_listings" {
  "user_id" 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" timestamp [not null]
  "status_listing_label" "character varying(200)" [not null]
}

Tabel "models" {
  "record_added_at" timestamp [not 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" integer [not null]
  "has_detach_button" boolean [not null]
  "has_gsm_name" boolean [not null]
  "analog_amount" integer [not null]
  "outputs_amount" integer [not null]
}

Tabel "vehicle_trackers_history" {
  "vehicle_id" integer [not null]
  "record_added_at" timestamp [not null]
  "object_id" integer [not null]
  "changed_datetime" timestamp [not null]
  "vehicle_tracker_history_id" integer [not null]
}

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

Tabel "sensor_description" {
  "record_added_at" timestamp [not null]
  "parameters" jsonb
  "input_id" integer [not null]
  "accuracy" numeric [not null]
  "sensor_units" "character varying(10)"
  "multiplier" doubleprecision [not null]
  "input_label" "character varying(64)"
  "sensor_label" "character varying(100)"
  "units_type" integer [not null]
  "divider" doubleprecision [not null]
  "group_id" integer [not null]
  "sensor_id" integer [not null]
  "device_id" integer [not null]
  "sensor_type" "character varying(45)" [not null]
  "group_type" integer [not null]
  "calibration_data" jsonb
}

Tabel "entities" {
  "entity_label" jsonb
  "record_added_at" timestamp [not null]
  "entity_id" integer [not null]
  "builtin_type" integer [not null]
  "user_id" integer [not null]
}

Tabel "zones" {
  "address" "character varying(255)"
  "radius" integer [not null]
  "zone_id" integer [not null]
  "circle_center_latitude" numeric [not null]
  "client_id" integer [not null]
  "zone_label" "character varying(100)"
  "color" "character varying(6)" [not null]
  "zone_type" "character varying(20)" [not null]
  "circle_center_longitude" numeric [not null]
  "latitude" numeric [not null]
  "record_added_at" timestamp [not null]
  "longitude" numeric [not null]
}

Tabel "vehicles" {
  "vehicle_id" integer [not null]
  "payload_length" numeric
  "vin" "character varying(20)"
  "free_insurance_policy_number" "character varying(50)"
  "vehicle_label" "character varying(100)"
  "payload_width" numeric
  "color" "character varying(6)"
  "trailer" "character varying(255)"
  "object_id" integer
  "vehicle_status_id" integer
  "liability_insurance_valid_till" timestamp
  "manufacture_year" integer
  "fuel_grade" "character varying(16)"
  "fuel_cost" numeric
  "fuel_tank_volume" numeric
  "model" "character varying(100)"
  "garage_id" integer
  "payload_height" numeric
  "max_speed" numeric
  "registration_number" "character varying(32)"
  "tyre_size" "character varying(50)"
  "passenger_capacity" integer
  "record_added_at" timestamp [not null]
  "trailer_reg_number" "character varying(32)"
  "free_insurance_valid_till_date" timestamp
  "gross_weight" numeric
  "standard_fuel_consumption" numeric
  "fuel_type" integer
  "payload_weight" numeric
  "additional_info" text
  "vehicle_subtype" "character varying(32)"
  "liability_insurance_policy_number" "character varying(50)"
  "frame_number" "character varying(32)"
  "user_id" integer [not null]
  "vehicle_type" integer [not null]
  "chassis_number" "character varying(32)"
  "tyres_number" integer
  "wheel_arrangement" "character varying(16)"
}

Tabel "tag_links" {
  "entity_id" integer [not null]
  "record_added_at" timestamp [not null]
  "entity_type" integer [not null]
  "ordinal" integer [not null]
  "tag_id" integer [not null]
}

Tabel "rules" {
  "rule_id" integer [not null]
  "object_id" integer [not null]
  "parameters" jsonb
  "alert_phone" "character varying(210)" [not null]
  "event_type" "character varying(100)" [not null]
  "client_id" integer [not null]
  "is_push_enabled" boolean [not null]
  "event_comment1" "character varying(255)" [not null]
  "event_label" "character varying(255)" [not null]
  "description" "character varying(255)" [not null]
  "record_added_at" timestamp [not null]
  "alert_sms" text [not null]
  "event_group" integer [not null]
  "created_at" timestamp [not null]
  "maximum" integer [not null]
  "is_deleted" boolean [not null]
  "alert_email" text [not null]
  "event_comment2" "character varying(255)" [not null]
}

Tabel "status_history" {
  "longitude" numeric
  "new_status_id" integer
  "status_history_id" integer [not null]
  "device_id" integer [not null]
  "updated_by" integer [not null]
  "address" "character varying(255)"
  "latitude" numeric
  "record_added_at" timestamp [not null]
  "server_datetime" timestamp [not null]
  "changed_datetime" timestamp
  "old_status_id" integer
}

Tabel "rules2zones" {
  "zone_id" integer [not null]
  "record_added_at" timestamp [not null]
  "rule_id" integer [not null]
}

Tabel "forms" {
  "object_id" integer [not null]
  "description" text
  "form_label" "character varying(255)" [not null]
  "fields" text
  "created_at" timestamp [not null]
  "submission_address" "character varying(255)"
  "submission_latitude" numeric
  "form_id" integer [not null]
  "submission_longitude" numeric
  "is_submission_in_zone" boolean [not null]
  "values" text
  "record_added_at" timestamp [not null]
  "task_id" integer
  "submitted_at" timestamp
}


Tabel "rules2objects" {
  "object_params" jsonb
  "param_group_number" integer [not null]
  "object_id" integer [not null]
  "record_added_at" timestamp [not null]
  "rule_id" integer [not null]
}

Tabel "tasks" {
  "time_from" timestamp
  "stay_duration_minutes" interval
  "external_id" "character varying(100)"
  "object_id" integer
  "task_type" integer
  "arrival_duration_minutes" interval
  "status" integer
  "arrival_datetime" timestamp
  "record_added_at" timestamp [not null]
  "task_id" integer [not null]
  "user_id" integer
  "status_change_datetime" timestamp
  "order_sort" integer
  "time_to" timestamp
  "max_delay_minuts" integer
  "is_stay_control_enabled" boolean
  "address" "character varying(255)"
  "task_label" "character varying(200)" [not null]
  "longitude" numeric
  "created_by" integer
  "description" text [not null]
  "radius" integer
  "latitude" numeric
  "stay_duration" integer
  "created_at" timestamp [not null]
  "custom_fields" jsonb
  "parent_task_id" integer
}

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

Tabel "devices" {
  "is_sim_blocked" boolean [not null]
  "device_id" integer [not null]
  "device_imei" "character varying(64)" [not null]
  "network_label" "character varying(50)" [not null]
  "status_listing_id" integer [not null]
  "signal_level" numeric [not null]
  "phone" "character varying(32)" [not null]
  "has_roaming" boolean [not null]
  "created_at" timestamp [not null]
  "owner_id" integer [not null]
  "record_added_at" timestamp [not null]
}

Tabel "description_parameters" {
  "description" "character varying(150)"
  "record_added_at" timestamp [not null]
  "type" "character varying(100)" [not null]
  "key" integer [not null]
}

Tabel "users" {
  "company_label" "character varying(255)" [not null]
  "registration_datetime" timestamp
  "first_name" "character varying(100)" [not null]
  "master_id" integer
  "last_name" "character varying(100)" [not null]
  "birth_date" timestamp
  "timezone_label" "character varying(30)"
  "middle_name" "character varying(100)" [not null]
  "user_id" integer [not null]
  "locale" "character varying(10)" [not null]
  "record_added_at" timestamp [not null]
}

Tabel "counters" {
  "sensor_id" integer
  "multiplier" numeric [not null]
  "counter_id" integer [not null]
  "device_id" integer [not null]
  "counter_type" integer [not null]
  "record_added_at" timestamp [not null]
}

Tabel "employees" {
  "driver_license_valid_till" timestamp
  "record_added_at" timestamp [not null]
  "last_name" "character varying(100)"
  "department_id" integer
  "citizen_id_number" "character varying(32)"
  "first_name" "character varying(100)"
  "driver_license_categories" "character varying(32)"
  "user_id" integer [not null]
  "phone_number" "character varying(32)"
  "object_id" integer
  "is_deleted" boolean [not null]
  "driver_license_issue_date" boolean
  "hardware_key" "character varying(64)"
  "middle_name" "character varying(100)"
  "address" "character varying(255)"
  "latitude" numeric
  "employee_id" integer [not null]
  "personnel_number" "character varying(15)"
  "fuel_cost" doubleprecision
  "driver_license_number" "character varying(32)"
  "email" "character varying(100)"
  "fuel_consumption" doubleprecision
  "radius" integer [not null]
  "longitude" numeric
}

Tabel "places_longtext_fields" {
  "field_id" integer [not null]
  "value" text [not null]
  "record_added_at" timestamp [not null]
  "place_id" integer [not null]
}

Tabel "raw_device_data" {
  "device_id" integer
  "device_time" timestamp
  "created_at" timestamp
  "gps_fix_type" integer
  "longitude" integer
  "latitude" integer
  "altitude" integer
  "speed" integer
  "satellites" integer
  "hdop" integer
  "event_id" integer
  "inputs" jsonb
  "states" jsonb
}

Tabel "groups_objects" {
  "groups_client_id" integer
  "objects_client_id" integer

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

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"

Ref:"devices"."device_id" < "counters"."device_id"

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

Ref:"departments"."department_id" < "employees"."department_id"

Ref:"users"."user_id" < "departments"."user_id"

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

Ref:"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" < "tasks"."status"

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

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

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

Ref:"users"."user_id" < "entities"."user_id"

Ref:"tasks"."task_id" < "forms"."task_id"

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

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

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

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

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

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

Ref:"devices"."device_id" < "objects"."device_id"

Ref:"users"."user_id" < "places"."user_id"

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

Ref:"places"."place_id" < "places_bigint_fields"."place_id"

Ref:"custom_fields"."custom_field_id" < "places_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:"places"."place_id" < "places_linked_entity_fields"."place_id"

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

Ref:"places"."place_id" < "places_longtext_fields"."place_id"

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

Ref:"places"."place_id" < "places_text_fields"."place_id"

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

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

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

Ref:"tags"."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" < "tasks"."user_id"

Ref:"users"."master_id" < "users"."user_id"

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

Ref:"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:"vehicles"."vehicle_id" < "vehicle_trackers_history"."vehicle_id"

Ref:"garages"."garage_id" < "vehicles"."garage_id"

Ref:"objects"."object_id" < "vehicles"."object_id"

Ref:"users"."user_id" < "vehicles"."user_id"

Ref:"zones"."zone_id" < "geofence_points"."zone_id"

Ref:"devices"."device_id" < "raw_device_data"."device_id"

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

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

Frekuensi pembaruan

Data dalam skema ini disinkronkan dengan DB inti. Pembaruan terjadi secara inkremental ketika perubahan terjadi di database MySQL sumber, biasanya kurang dari 5 menit sejak perubahan sumber.

description_parameters

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

Tipe referensi	Deskripsi	Contoh nilai
Definisi tipe	Tipe entitas standar	vehicle_type: car, truck, bus
Kode status	Nilai status tugas dan sistem	tasks_status: unassigned, assigned, done
Definisi satuan	Satuan pengukuran untuk sensor	units_type: liter, gallon, celsius
Klasifikasi entitas	Kategori entitas bisnis	entities_type: place, task, customer

Tabel kunci menurut kategori

Tabel dalam raw_business_data skema diorganisasikan ke dalam kategori fungsional untuk mempermudah navigasi. Tabel di bawah merangkum tabel kunci berdasarkan tujuan bisnis mereka:

Entitas bisnis inti

users

Deskripsi: Akun pengguna yang berisi informasi profil, afiliasi perusahaan, pengaturan lokalisasi (zona waktu, locale), dan hubungan hierarkis melalui master_id untuk struktur akun bertingkat

Atribut	Rincian
Bidang kunci	- user_id - Pengidentifikasi unik pengguna - company_label - Nama perusahaan yang terkait dengan pengguna - first_name - Nama pengguna - last_name - Nama belakang pengguna - middle_name - Nama tengah/patronimik pengguna - locale - Pengaturan bahasa pengguna - timezone_label - Zona waktu dalam format IANA - master_id - ID pengguna utama (jika yang sekarang adalah bawahan) - registration_datetime - Tanggal pendaftaran dalam sistem - birth_date - Tanggal lahir pengguna
Hubungan	Pengguna induk melalui master_id, terhubung ke employees, departments, places, tasks melalui user_id
Catatan khusus	Entitas pusat yang menghubungkan data organisasi; master_id memungkinkan hierarki pengguna untuk struktur akun bertingkat

employees

Deskripsi: Catatan karyawan dan pengemudi yang digunakan untuk merepresentasikan orang yang bekerja untuk organisasi, termasuk informasi pribadi, detail lisensi, penugasan departemen, kunci perangkat keras untuk identifikasi iButton/RFID, dan data lokasi dengan dukungan geofencing

Atribut	Rincian
Bidang kunci	- employee_id - Pengidentifikasi entitas karyawan - user_id - Pengidentifikasi entitas pengguna - object_id - Pengidentifikasi entitas objek - department_id - ID departemen tempat karyawan ditugaskan - first_name - Atribut first_name dari tabel employees - last_name - Atribut last_name dari tabel employees - middle_name - Atribut middle_name dari tabel employees - driver_license_number - Nomor SIM pengemudi - driver_license_categories - Kategori lisensi pengemudi - driver_license_issue_date - Tanggal penerbitan lisensi mengemudi - driver_license_valid_till - Tanggal hingga lisensi mengemudi berlaku - hardware_key - Kunci perangkat keras - email - Email karyawan - phone_number - Nomor telepon karyawan tanpa tanda "+" - address - Alamat lokasi - personnel_number - Nomor personel karyawan/pengemudi - citizen_id_number - Nomor identitas nasional - latitude - Lokasi yang terkait dengan karyawan ini - longitude - Lokasi yang terkait dengan karyawan ini - radius - Lokasi yang terkait dengan karyawan ini dalam meter - fuel_consumption - Atribut fuel_consumption dari tabel employees - fuel_cost - Atribut fuel_cost dari tabel employees - is_deleted - Atribut is_deleted dari tabel employees
Hubungan	Tautan ke users, departments, objects (pelacak yang ditugaskan), dilacak di driver_history dan checkins
Catatan khusus	Kunci perangkat keras memungkinkan identifikasi pengemudi melalui iButton atau RFID; mendukung geofencing dengan latitude, longitude, radius fields

departments

Deskripsi: Unit organisasi dengan data lokasi geografis (latitude, longitude, radius) yang memungkinkan analitik berbasis geofence untuk pelaporan tingkat departemen dan asosiasi lokasi karyawan

Atribut	Rincian
Bidang kunci	- department_id - Pengidentifikasi entitas departemen - user_id - Pengidentifikasi entitas pengguna - department_label - Atribut department_label dari tabel departments - latitude - Lokasi yang terkait dengan departemen ini - longitude - Lokasi yang terkait dengan departemen ini - radius - Ukuran geolokasi dalam meter - address - Atribut address dari tabel departments
Hubungan	Menghubungkan karyawan ke struktur organisasi melalui department_id
Catatan khusus	Kolom lokasi mendukung analitik berbasis geofence untuk pelaporan tingkat departemen

Pelacakan dan pemantauan

devices

Deskripsi: Daftar perangkat pelacakan 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

Atribut	Rincian
Bidang kunci	- device_id - ID perangkat - owner_id - ID pemilik perangkat di akun yang menambahkan beacon - device_imei - IMEI perangkat - phone - Nomor kartu SIM perangkat - status_listing_id - ID Status Perangkat - network_label - Nama jaringan tempat kartu SIM terhubung - signal_level - Kekuatan sinyal perangkat - has_roaming - Flag ketersediaan roaming - is_sim_blocked - Flag penguncian SIM - created_at - Tanggal dan waktu entri dibuat
Hubungan	Entitas inti yang menautkan ke objects, models, sensor_description, counters; owner_id references users.user_id
Catatan khusus	Semua data telematik di raw_telematics_data skema merujuk tabel ini melalui device_id

objects

Deskripsi: Daftar pusat entitas yang dipantau (kendaraan, aset, personel) yang menautkan perangkat fisik ke struktur organisasi melalui client_id dan group_id, mewakili "unit yang dapat dilacak" dengan satu objek aktif per perangkat

Atribut	Rincian
Bidang kunci	- object_id - Pengidentifikasi entitas objek - client_id - Pengidentifikasi entitas klien - device_id - Pengidentifikasi entitas perangkat - object_label - Nama objek - model - Model perangkat - group_id - ID grup entitas - create_datetime - Tanggal dan waktu pembuatan baris baru di server - is_deleted - Atribut is_deleted dari tabel objects - is_clone - Tanda klon
Hubungan	Hub pusat yang menghubungkan perangkat ke pengguna (client_id), detail kendaraan, riwayat pelacakan, tugas, dan aturan
Catatan khusus	Mewakili "unit yang dapat dilacak" dalam sistem; satu objek per perangkat yang sedang digunakan aktif

models

Deskripsi: Daftar pusat entitas yang dipantau (kendaraan, aset, personel) yang menautkan perangkat fisik ke struktur organisasi melalui client_id dan group_id, mewakili "unit yang dapat dilacak" dengan satu objek aktif per perangkat

Atribut	Rincian
Bidang kunci	- model_id - Pengidentifikasi model entitas - model - Atribut model dari tabel models - vendor - Nama perusahaan yang merilis pelacak - alternative_label - Atribut alternative_label dari tabel models - analog_amount - Jumlah input analog pada pelacak - digital_amount - Jumlah input diskrit pada pelacak - outputs_amount - Jumlah output diskrit pelacak - has_battery_level - Menentukan apakah pelacak mengirimkan pembacaan daya baterai - has_altitude - Menentukan apakah pelacak mengirimkan ketinggian - has_phone - Apakah ada kartu SIM? - has_gsm_level - Dapatkah pelacak mengirimkan kekuatan sinyal GSM? - has_gsm_name - Dapatkah pelacak mengirimkan nama jaringan GSM atau kode operator (MCC + MNC)? - has_gsm_roaming - Dapatkah pelacak mengirimkan status roaming? - has_detach_button - Apakah pelacak memiliki sensor pelepasan? - type_output_control - Profil Kontrol Output Pelacak - type_special_control - Berisi pengaturan khusus dan modul fungsional untuk model perangkat tertentu, seperti mode berkendara berbahaya (hbm_telfm) untuk Teltonika - is_clone - Apakah model merupakan klon dari model lain?
Konten	Flag kemampuan boolean menunjukkan bidang data mana yang tersedia dari tipe perangkat ini
Catatan khusus	Gunakan flag kemampuan untuk menentukan sensor dan input yang valid saat mengambil data telematik

sensor_description

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

Atribut	Rincian
Bidang kunci	- sensor_id - Pengidentifikasi entitas sensor - device_id - Pengidentifikasi entitas perangkat - sensor_label - Nama sensor untuk antarmuka pengguna - input_label - Nama bidang pesan (atribut) dari mana data sensor diambil. Jika sama dengan "input_status," itu adalah sensor diskrit - sensor_type - Tipe sensor - units_type - Satuan pengukuran - multiplier - Pengali - angka yang digunakan untuk mengalikan nilai bidang. Hanya untuk sensor pengukuran - divider - Pembagi - angka yang digunakan untuk membagi nilai bidang. Hanya untuk sensor pengukuran - accuracy - Persentase yang ditentukan untuk menghitung kesalahan absolut volume tangki. Kesalahan ini digunakan untuk menentukan kapan terjadi pengisian ulang atau pengosongan. Ini hanya digunakan untuk sensor bahan bakar - calibration_data - Atribut calibration_data dari tabel sensor_description - input_id - Nomor input untuk sensor diskrit - group_id - Sensor dengan tipe sama yang memiliki group_id dan source_id yang sama dianggap termasuk dalam grup yang sama. Data mereka dijumlahkan atau dirata-rata, tergantung pada nilai group_type. Ini diperlukan untuk sensor teragregasi. Digunakan pada sensor pengukuran - group_type - 0 - jumlahkan nilai sensor dalam sebuah grup, 1 - rata-rata - sensor_units - Nama satuan yang dimasukkan pengguna jika units_type=0 (kustom) - parameters - Objek opsional dengan parameter tambahan parent_ids - array opsional dari 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 maksimal yang diizinkan per jam. max_lowering_by_mileage - opsional. Double. Penurunan nilai maksimal yang diizinkan per 100 km. ignore_drains_in_move - opsional. Boolean. Default adalah false. Jika true, pengosongan bahan bakar tidak akan terdeteksi selama pergerakan. ignore_refuels_in_move - opsional. Boolean. Default adalah false. Jika true, pengisian ulang tidak akan terdeteksi selama pergerakan. refuel_gap_minutes - opsional. Integer. Default adalah 5. Waktu dalam menit setelah mulai pergerakan, pengisian ulang akan terdeteksi selama pergerakan. custom_field_name - opsional. Boolean. Default false. Parameter menentukan apakah field input_name adalah nilai kustom yang dimasukkan oleh pengguna. Ini hanya masuk akal jika model pelacak memiliki fitur has_custom_fields
Hubungan	Menautkan input perangkat (dari raw_telematics_data.inputs) ke logika bisnis melalui device_id dan input_label matching
Catatan khusus	calibration_data (JSONB) menyimpan tabel kalibrasi khusus sensor untuk sensor level bahan bakar; multiplier dan divider mengonversi nilai mentah ke satuan

Manajemen aset

vehicles

Deskripsi: Daftar kendaraan komprehensif yang berisi spesifikasi (dimensi, berat, kapasitas), dokumentasi (VIN, registrasi, asuransi), parameter operasional (konsumsi bahan bakar, volume tangki), dan penugasan pelacak saat ini melalui object_id untuk manajemen armada dan pelacakan kepatuhan

Atribut	Rincian
Bidang kunci	- vehicle_id - Pengidentifikasi entitas kendaraan - user_id - Pengidentifikasi entitas pengguna - object_id - Pengidentifikasi entitas objek - garage_id - Pengidentifikasi entitas garasi - vehicle_label - Atribut vehicle_label dari tabel vehicles - registration_number - Nomor registrasi/plat kendaraan - vin - Atribut vin dari tabel vehicles - manufacture_year - Atribut manufacture_year dari tabel vehicles - fuel_type - Atribut fuel_type dari tabel vehicles - fuel_cost - Atribut fuel_cost dari tabel vehicles - fuel_tank_volume - Atribut fuel_tank_volume dari tabel vehicles - max_speed - Atribut max_speed dari tabel vehicles - model - Atribut model dari tabel vehicles - color - Atribut color dari tabel vehicles - trailer - Atribut trailer dari tabel vehicles - additional_info - Atribut additional_info dari tabel vehicles - vehicle_type - Atribut vehicle_type dari tabel vehicles - vehicle_subtype - Atribut vehicle_subtype dari tabel vehicles - vehicle_status_id - Pengidentifikasi entitas status kendaraan - chassis_number - Atribut chassis_number dari tabel vehicles - frame_number - Atribut frame_number dari tabel vehicles - trailer_reg_number - Atribut trailer_reg_number dari tabel vehicles - payload_weight - Atribut payload_weight dari tabel vehicles - payload_height - Atribut payload_height dari tabel vehicles - payload_length - Atribut payload_length dari tabel vehicles - payload_width - Atribut payload_width dari tabel vehicles - passenger_capacity - Jumlah maksimum penumpang - gross_weight - Atribut gross_weight dari tabel vehicles - standard_fuel_consumption - Rata‑rata konsumsi bahan bakar normal dalam liter per 100 km - fuel_grade - Atribut fuel_grade dari tabel vehicles - wheel_arrangement - Atribut wheel_arrangement dari tabel vehicles - tyre_size - Ukuran kendaraan: dimensi dan ukuran roda - tyres_number - Jumlah roda - liability_insurance_policy_number - Atribut liability_insurance_policy_number dari tabel vehicles - liability_insurance_valid_till - Tanggal sampai asuransi tanggung jawab berlaku - free_insurance_policy_number - Atribut free_insurance_policy_number dari tabel vehicles - free_insurance_valid_till_date - Tanggal sampai asuransi gratis berlaku
Hubungan	Tautan ke objects (pelacak saat ini), garages (lokasi layanan), vehicle_service_tasks; dilacak di vehicle_trackers_history
Catatan khusus	Kolom dimensi fisik (payload_length, payload_width, payload_height, gross_weight) mendukung analitik perencanaan muatan; tanggal asuransi memungkinkan pelacakan kepatuhan

garages

Deskripsi: Lokasi fasilitas layanan dan perawatan dengan koordinat geografis (latitude, longitude, radius), informasi kontak untuk mekanik dan dispatcher, memungkinkan deteksi kunjungan layanan berbasis geofence dan analisis kedekatan

Atribut	Rincian
Bidang kunci	- garage_id - Pengidentifikasi entitas garasi - user_id - Pengidentifikasi entitas pengguna - latitude - Objek lokasi - longitude - Objek lokasi - radius - Ukuran geolokasi dalam meter - address - Objek lokasi - organization_label - ID depo - mechanic_name - Nama mekanik - dispatcher_name - Nama dispatcher
Hubungan	Dirujuk oleh vehicles.garage_id untuk penugasan lokasi layanan
Catatan khusus	Kolom lokasi memungkinkan deteksi kunjungan layanan berbasis geofence dan analisis kedekatan

vehicle_service_tasks

Deskripsi: Penjadwalan perawatan dan pelacakan riwayat layanan dengan beberapa tipe pemicu (berbasis tanggal, berbasis jarak tempuh, berbasis jam mesin), interval tugas berulang, pemberitahuan multi-saluran (email, SMS, push), dan pembedaan antara perawatan terencana (is_repeat) dan perawatan tak terencana

Atribut	Rincian
Bidang kunci	- service_task_id - Pengidentifikasi entitas tugas layanan - vehicle_id - Pengidentifikasi entitas kendaraan - description - Atribut description dari tabel vehicle_service_tasks - status - Nilai status dari atribut status - cost - Atribut cost dari tabel vehicle_service_tasks - start_date - Tanggal dan waktu yang terkait dengan atribut start_date - end_date - Tanggal dan waktu yang terkait dengan atribut end_date - completion_date - Tanggal dan waktu yang terkait dengan atribut completion_date - predicted_datetime - Tanggal dan waktu yang terkait dengan atribut predicted_datetime - mileage_limit - Atribut mileage_limit dari tabel vehicle_service_tasks - engine_hours_limit - Atribut engine_hours_limit dari tabel vehicle_service_tasks - start_mileage - Atribut start_mileage dari tabel vehicle_service_tasks - start_engine_hours - Atribut start_engine_hours dari tabel vehicle_service_tasks - mileage_notification_interval - Atribut mileage_notification_interval dari tabel vehicle_service_tasks - engine_hours_notification_interval - Atribut engine_hours_notification_interval dari tabel vehicle_service_tasks - date_notification_interval - Mengonversi integer N menjadi N hari - mileage_repeat_interval - Atribut mileage_repeat_interval dari tabel vehicle_service_tasks - engine_hours_repeat_interval - Atribut engine_hours_repeat_interval dari tabel vehicle_service_tasks - date_repeat_interval - Mengonversi integer N menjadi N hari - notification_emails - Atribut notification_emails dari tabel vehicle_service_tasks - notification_sms_phone_numbers - Atribut notification_sms_phone_numbers dari tabel vehicle_service_tasks - is_notification_push_enabled - Atribut is_notification_push_enabled dari tabel vehicle_service_tasks - completion_mileage - Atribut completion_mileage dari tabel vehicle_service_tasks - completion_engine_hours - Atribut completion_engine_hours dari tabel vehicle_service_tasks - is_repeat - Atribut is_repeat dari tabel vehicle_service_tasks - is_unplanned - Atribut is_unplanned dari tabel vehicle_service_tasks - comment - Atribut comment dari tabel vehicle_service_tasks
Konten	Mendukung tiga tipe pemicu: berbasis tanggal, berbasis jarak tempuh, berbasis jam mesin; pengaturan notifikasi untuk email, SMS, push
Catatan khusus	is_repeat dan kolom interval memungkinkan jadwal perawatan berulang; is_unplanned membedakan antara perawatan terjadwal vs. reaktif

Lokasi dan perutean

zones

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 pewarnaan untuk pembedaan visual

Atribut	Rincian
Bidang kunci	- zone_id - Pengidentifikasi entitas zona - client_id - Pengidentifikasi entitas klien - zone_label - Atribut zone_label dari tabel zones - zone_type - Atribut zone_type dari tabel zones - latitude - Objek opsional, bounding box yang dapat sepenuhnya memuat hasil yang dikembalikan - longitude - Objek opsional, bounding box yang dapat sepenuhnya memuat hasil yang dikembalikan - circle_center_latitude - Atribut circle_center_latitude dari tabel zones - circle_center_longitude - Atribut circle_center_longitude dari tabel zones - radius - Ukuran geolokasi dalam meter - address - Atribut address dari tabel zones - color - Atribut color dari tabel zones
Konten	Jenis zona meliputi circle, polygon (didefinisikan melalui geofence_points), dan klasifikasi area khusus
Hubungan	Dirujuk oleh rules2zones, users2zones; verteks polygon disimpan di geofence_points
Catatan khusus	Fungsi PostGIS dapat digunakan untuk memeriksa point-in-polygon untuk analisis geofence yang kompleks

places

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

Atribut	Rincian
Bidang kunci	- place_id - Pengidentifikasi entitas place - user_id - Pengidentifikasi entitas pengguna - place_label - Atribut place_label dari tabel places - latitude - Objek lokasi - longitude - Objek lokasi - radius - Ukuran geolokasi dalam meter - address - Atribut address dari tabel places - description - Atribut description dari tabel places - external_id - ID untuk integrasi dengan sistem eksternal (CRM) - custom_fields - Bidang tambahan - assigned_datetime - Tanggal dan waktu penugasan titik minat ke pengguna
Hubungan	Diperluas dengan nilai bidang kustom melalui places_text_fields, places_decimal_fields, places_bigint_fields, places_longtext_fields, places_linked_entity_fields
Catatan khusus	custom_fields JSONB menyediakan akses cepat; tabel terkait memungkinkan penyaringan dan pengurutan berdasarkan atribut kustom

geofence_points

Deskripsi: Koordinat verteks yang terurut (field number menentukan urutan) yang mendefinisikan batas polygon untuk bentuk geofence kompleks, memungkinkan perimeter geografis yang presisi di luar zona lingkaran sederhana, digunakan dengan PostGIS ST_MakePolygon untuk operasi geometris

Atribut	Rincian
Bidang kunci	- zone_id - ID dari zona yang terkait dengan formulir ini - number - Nomor seri - latitude - Lokasi - longitude - Lokasi
Hubungan	Banyak catatan per zone_id mendefinisikan batas polygon; number field menentukan urutan verteks
Catatan khusus	Query dengan ORDER BY number untuk merekonstruksi jalur polygon; gunakan dengan PostGIS ST_MakePolygon untuk operasi geometris

Manajemen tugas dan alur kerja

tasks

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 dan operasi pengiriman

Atribut	Rincian
Bidang kunci	- task_id - Pengidentifikasi entitas tugas - user_id - Pengidentifikasi entitas pengguna - object_id - Pengidentifikasi entitas objek - parent_task_id - Pengidentifikasi entitas tugas induk - task_label - Atribut task_label dari tabel tasks - status - Nilai status dari atribut status - task_type - Jenis tugas, task, route atau checkpoint - latitude - Atribut latitude dari tabel tasks - longitude - Atribut longitude dari tabel tasks - radius - Ukuran geolokasi dalam meter - arrival_datetime - Ketika pelacak tiba di area tugas. DIABAIKAN saat membuat/memperbarui - created_at - Atribut created_at dari tabel tasks - status_change_datetime - Tanggal dan waktu pembaruan tugas - time_from - Tanggal dan waktu yang terkait dengan atribut time_from - time_to - Tanggal dan waktu yang terkait dengan atribut time_to - stay_duration - Atribut stay_duration dari tabel tasks - stay_duration_minutes - Durasi kunjungan. Waktu yang harus dihabiskan pekerja lapangan di lokasi penugasan untuk menyelesaikan tugas dengan sukses. Kunjungan berganda bersifat kumulatif - arrival_duration_minutes - Abaikan kunjungan acak yang lebih pendek dari durasi yang ditentukan. Ketika menghitung durasi minimum, kunjungan yang lebih pendek dari durasi yang ditentukan akan diabaikan - max_delay_minuts - Keterlambatan yang dapat diterima. Jumlah maksimum waktu seorang karyawan dapat terlambat. Setiap tugas yang diselesaikan selama periode ini akan ditandai sebagai "terlambat" - is_stay_control_enabled - Atribut is_stay_control_enabled dari tabel tasks - address - Atribut address dari tabel tasks - description - Atribut Description dari tabel tasks - custom_fields - Atribut custom_fields dari tabel tasks - external_id - Pengidentifikasi entitas eksternal - order_sort - Atribut order_sort dari tabel tasks - created_by - Sumber tugas yang dibuat
Konten	Mendukung tugas hierarkis via parent_task_id; jendela waktu didefinisikan oleh time_from/time_to; validasi geofence dengan lokasi dan radius
Hubungan	Tautan ke forms (pengumpulan data), task_history (perubahan status), objects (pelacak yang ditugaskan)
Catatan khusus	stay_duration dan arrival_duration_minutes mengaktifkan pemantauan kepatuhan untuk tugas pengiriman dan layanan

forms

Deskripsi: Formulir pengumpulan data yang dapat dikonfigurasi untuk menangkap informasi terstruktur selama penyelesaian tugas atau check-in aplikasi seluler, dengan field dan nilai disimpan sebagai JSON, validasi lokasi opsional (is_submission_in_zone), dan persyaratan pengiriman wajib saat dilampirkan pada tugas

Atribut	Rincian
Bidang kunci	- form_id - Pengidentifikasi entitas formulir - task_id - ID dari tugas yang terkait dengan formulir ini - object_id - Pengidentifikasi entitas objek - form_label - Label formulir yang ditentukan pengguna - fields - Jika true, formulir hanya dapat dikirimkan di zona tugas - values - Peta dengan ID field sebagai kunci dan objek field_value sebagai nilai. Kunci digunakan untuk menghubungkan field dan nilai yang sesuai - submitted_at - Tanggal saat nilai formulir terakhir dikirim - submission_latitude - Lokasi saat nilai formulir terakhir dikirim - submission_longitude - Lokasi saat nilai formulir terakhir dikirim - submission_address - Lokasi saat nilai formulir terakhir dikirim - is_submission_in_zone - Jika true, formulir hanya dapat dikirimkan di zona tugas - description - Tanggal saat formulir ini dibuat (atau dilampirkan ke tugas) - created_at - Tanggal saat formulir ini dibuat (atau dilampirkan ke tugas)
Konten	fields mendefinisikan struktur formulir (JSON); values mengandung data yang dikirimkan (JSON)
Hubungan	Tautan ke tasks (work order terkait), objects (pengirim), direferensikan di checkins
Catatan khusus	Flag validasi lokasi is_submission_in_zone mengaktifkan aturan pengiriman formulir berbasis geofence

checkins

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

Atribut	Rincian
Bidang kunci	- checkin_id - Pengidentifikasi entitas checkin - employee_id - Pengidentifikasi entitas karyawan juga merupakan pengidentifikasi untuk pengemudi - object_id - Perangkat karyawan - form_id - Pengidentifikasi entitas formulir - user_id - Pengguna karyawan - planned_datetime - Waktu perangkat saat check-in dilakukan - actual_datetime - Waktu server saat permintaan/pesan diproses - latitude - Lokasi saat checkin dikirim - longitude - Lokasi saat checkin dikirim - radius - Kesalahan pemposisian pada suatu titik dalam meter - address - Alamat check-in - comment - Atribut comment dari tabel checkins
Hubungan	Menghubungkan karyawan ke formulir dan lokasi; melacak deviasi dari jadwal yang direncanakan
Catatan khusus	Selisih waktu antara planned_datetime dan actual_datetime mengaktifkan pelaporan ketepatan waktu; radius menentukan toleransi lokasi yang dapat diterima

task_history

Deskripsi: Jejak audit lengkap dari peristiwa siklus hidup tugas yang menangkap semua perubahan status, penugasan, pembaruan, dan modifikasi lapangan dengan cap waktu (event_datetime), atribusi pengguna, dan jenis aktivitas (create, update, assign, status_change) yang disimpan dalam field payload untuk analisis kepatuhan dan alur kerja

Atribut	Rincian
Bidang kunci	- task_history_id - Pengidentifikasi entitas riwayat tugas - task_id - Pengidentifikasi entitas tugas - user_id - Pengidentifikasi entitas pengguna - activity - Operasi yang terjadi. Bisa berupa "create", "update", "assign" atau "status_change" - event_datetime - Tanggal dan waktu peristiwa - payload - Bergantung pada operasi. Biasanya, berisi field yang diubah selama operasi
Konten	Jenis aktivitas didefinisikan di description_parameters; payload menyimpan detail spesifik peristiwa (teks)
Catatan khusus	Esensial untuk analisis penyelesaian tugas, pelaporan transisi status, dan pelacakan aktivitas pengguna

Aturan dan otomatisasi

rules

Deskripsi: Aturan deteksi peristiwa dengan kondisi pemicu yang dapat dikonfigurasi (kecepatan berlebih, pelanggaran geofence, ambang sensor, waktu diam) disimpan dalam parameters (JSONB), dan pengaturan notifikasi multi-saluran (alert_email, alert_sms, alert_phone, is_push_enabled) untuk pemantauan otomatis dan pemberitahuan berdasarkan data perangkat dan server

Atribut	Rincian
Bidang kunci	- rule_id - Pengidentifikasi entitas aturan - object_id - Pengidentifikasi entitas objek - client_id - Pengidentifikasi entitas klien - event_type - Atribut event_type dari tabel rules - event_label - Atribut event_label dari tabel rules - event_group - Atribut event_group dari tabel rules - description - Atribut Description dari tabel rules - parameters - Parameter peristiwa. Untuk detail lebih lanjut tentang parameter yang tersedia, lihat Navixy API docs. - alert_email - Email untuk notifikasi - alert_sms - Nomor telepon untuk notifikasi SMS - alert_phone - Telepon untuk panggilan suara - is_push_enabled - Jika true, notifikasi push tersedia - created_at - Atribut created_at dari tabel rules - is_deleted - Atribut is_deleted dari tabel rules - maximum - Batas yang diterapkan pada berbagai aturan. Misalnya, untuk aturan waktu diam dengan mesin menyala dalam menit - event_comment1 - Atribut event_comment1 dari tabel rules - event_comment2 - Atribut event_comment2 dari tabel rules
Konten	Parameter aturan (JSONB) mendefinisikan kondisi pemicu; mendukung notifikasi via email, SMS, telepon, dan push
Hubungan	Menghubungkan ke objek melalui rules2objects, zona melalui rules2zones
Catatan khusus	event_type mendefinisikan skenario pemantauan spesifik (kecepatan berlebih, pelanggaran geofence, ambang sensor); maximum field memungkinkan agregasi peristiwa untuk pemberitahuan berbasis ambang

rules2objects

Deskripsi: Hubungan many-to-many yang menghubungkan aturan ke objek yang dipantau dengan kustomisasi parameter per-objek melalui object_params (JSONB), memungkinkan nilai ambang yang berbeda (mis. batas kecepatan) untuk setiap kendaraan atau aset dalam aturan yang sama

Atribut	Rincian
Bidang kunci	- rule_id - Pengidentifikasi entitas aturan - object_id - Pengidentifikasi entitas objek - param_group_number - Atribut param_group_number dari tabel rules2objects - object_params - Atribut object_params dari tabel rules2objects
Konten	object_params (JSONB) memungkinkan kustomisasi aturan per-objek (mis. batas kecepatan berbeda per kendaraan)
Catatan khusus	Hubungan many-to-many memungkinkan satu aturan memantau banyak objek dengan parameter berbeda

rules2zones

Deskripsi: Hubungan many-to-many mengaitkan aturan dengan zona bergeofence, memungkinkan satu aturan memantau peristiwa masuk/keluar di banyak area geografis untuk skenario pemantauan spasial yang kompleks

Atribut	Rincian
Bidang kunci	- rule_id - Pengidentifikasi entitas aturan - zone_id - Pengidentifikasi entitas zona
Catatan khusus	Hubungan many-to-many memungkinkan pemantauan multi-zona untuk satu aturan (mis. pemberitahuan saat memasuki salah satu dari beberapa area terbatas)

Status dan kategorisasi

statuses

Deskripsi: Definisi status kustom dalam listing status, termasuk properti tampilan (color untuk tampilan situs web, order_sort untuk penempatan) yang digunakan untuk merepresentasikan status kerja perangkat atau karyawan dengan dukungan soft delete melalui flag is_deleted

Atribut	Rincian
Bidang kunci	- status_id - Pengidentifikasi entitas status - listing_id - Pengidentifikasi entitas listing - status_label - Nilai status dari atribut status_label - color - Warna yang digunakan untuk tampilan di situs web - order_sort - Posisi urut dalam listing status - is_deleted - Atribut is_deleted dari tabel statuses
Hubungan	Kelompok status diorganisasikan oleh listing_id (mereferensikan status_listings); digunakan di status_history
Catatan khusus	order_sort mendefinisikan urutan tampilan; warna memungkinkan pembedaan visual dalam pelaporan

status_listings

Deskripsi: Definisi set status yang mengontrol nilai status mana yang tersedia untuk perangkat atau karyawan, dengan flag izin (is_supervisor_controlled, is_employee_controlled) yang menentukan apakah supervisor, karyawan, atau keduanya dapat mengubah nilai status

Atribut	Rincian
Bidang kunci	- status_listing_id - Pengidentifikasi entitas listing status - user_id - Pengidentifikasi entitas pengguna - status_listing_label - Nilai status dari atribut status_listing_label - is_supervisor_controlled - Jika true supervisor dapat mengubah status kerja, mis. menggunakan aplikasi pemantauan seluler - is_employee_controlled - Jika true karyawan dapat mengubah status kerja mereka sendiri, mis. menggunakan aplikasi pelacakan seluler - is_deleted - Atribut is_deleted dari tabel status_listings
Hubungan	Dirujuk oleh devices.status_listing_id dan statuses.listing_id
Catatan khusus	Flag kontrol menentukan siapa yang dapat mengubah status: hanya supervisor, layanan mandiri karyawan, atau keduanya

status_history

Deskripsi: Jejak audit dari semua transisi status perangkat dengan cap waktu (changed_datetime di perangkat, server_datetime di server), atribusi pengguna (updated_by), dan tangkapan lokasi (latitude, longitude, address) yang memungkinkan analisis geografis perubahan status dan pelaporan lokasi mulai/akhir hari kerja

Atribut	Rincian
Bidang kunci	- status_history_id - Pengidentifikasi entitas riwayat status - device_id - Pengidentifikasi entitas perangkat - old_status_id - Pengidentifikasi entitas status lama - new_status_id - Pengidentifikasi entitas status baru - updated_by - Tanggal dan waktu yang terkait dengan atribut updated_by - changed_datetime - Tanggal dan waktu penetapan status baru di perangkat - server_datetime - Tanggal dan waktu penetapan status server baru - latitude - Melokasikan perangkat selama perubahan status - longitude - Melokasikan perangkat selama perubahan status - address - Melokasikan perangkat selama perubahan status
Hubungan	Tautan ke devices, statuses (lama dan baru), description_parameters (untuk updated_by role)
Catatan khusus	Penangkapan lokasi memungkinkan analisis geografis transisi status; berguna untuk pelaporan lokasi mulai/akhir hari kerja

tags

Deskripsi: Label kategorisasi yang ditentukan pengguna dengan pengkodean warna yang memungkinkan penyaringan dan pencarian cepat di berbagai tipe entitas (places, geofences, employees, tasks, trackers, vehicles) untuk organisasi yang fleksibel

Atribut	Rincian
Bidang kunci	- tag_id - ID entitas tag - user_id - Pengidentifikasi entitas pengguna - tag_label - Atribut tag_label dari tabel tags - color - Atribut color dari tabel tags
Hubungan	Diterapkan ke entitas melalui tag_links; ruang lingkup didefinisikan oleh pengguna
Catatan khusus	Sistem kategorisasi fleksibel yang mendukung beberapa tag per entitas

tag_links

Deskripsi: Tabel relasi polymorphic yang mengaitkan tag dengan tipe entitas apa pun melalui entity_type dan entity_id, dengan field ordinal untuk pengelolaan urutan tampilan, memungkinkan penandaan multi-entitas yang fleksibel

Atribut	Rincian
Bidang kunci	- tag_id - ID entitas tag - entity_type - Atribut entity_type dari tabel tag_links - entity_id - Pengidentifikasi entitas - ordinal - Atribut ordinal dari tabel tag_links
Konten	entity_type mengidentifikasi tabel (vehicle, employee, task, dll.); ordinal menentukan urutan tampilan
Catatan khusus	Relasi polymorphic memungkinkan penandaan lintas berbagai tipe entitas

Grup dan hierarki

groups

Deskripsi: Struktur pengelompokan organisasi untuk tracker yang memungkinkan organisasi visual di antarmuka pengguna dengan warna yang dapat disesuaikan (group_color) dan manajemen hierarkis seperti folder, saat ini berfungsi murni sebagai fungsi visual

Atribut	Rincian
Bidang kunci	- group_id - Grup tracker (terkait melalui objects.group_id). Pembagian ke dalam grup dapat dilihat di daftar beacon, misalnya - client_id - Pengidentifikasi entitas klien - group_label - Judul grup yang ditentukan pengguna, 1 hingga 60 karakter yang dapat dicetak, mis. "Employees" - group_color - Warna grup dalam format web (tanpa #), mis. "FF6DDC". Menentukan warna penanda tracker di peta
Hubungan	Dirujuk oleh objects.group_id; kepemilikan klien via client_id (mereferensikan users)
Catatan khusus	Memungkinkan organisasi seperti folder dari entitas pemantauan untuk pelaporan dan izin

groups_objects

Deskripsi: Hubungan many-to-many antara groups dan objects menggunakan primary key komposit (groups_client_id, objects_client_id), memungkinkan objek menjadi anggota beberapa grup secara bersamaan untuk struktur organisasi yang fleksibel

Atribut	Rincian
Bidang kunci	- groups_client_id - Pengidentifikasi entitas klien untuk groups - objects_client_id - Pengidentifikasi entitas klien untuk objects
Catatan khusus	Memungkinkan objek menjadi anggota beberapa grup secara bersamaan; query dengan kedua client_id nilai untuk keanggotaan grup

Bidang kustom dan entitas

entities

Deskripsi: Registri tipe entitas yang menentukan entitas bisnis mana yang mendukung bidang kustom dan struktur tata letak field mereka (sections, field_order) disimpan dalam entity_label (JSONB), memungkinkan perpanjangan skema dinamis di places, tasks, dan entitas lain tanpa perubahan basis data

Atribut	Rincian
Bidang kunci	- entity_id - Pengidentifikasi entitas - user_id - Pengidentifikasi entitas pengguna - entity_label - id - int. Pengidentifikasi entitas. type - enum. Saat ini, hanya "place" yang didukung. layout - objek yang menggambarkan tata letak bidang untuk entitas. sections - array objek. Setiap section dapat berisi satu atau lebih field. Setidaknya satu section harus ada dalam sebuah layout. label - string. Nama section. field_order - array string. Field bawaan dan ID bidang kustom (sebagai string) - builtin_type - Atribut builtin_type dari tabel entities
Hubungan	Dirujuk oleh custom_fields untuk mendefinisikan bidang kustom mana yang berlaku untuk tipe entitas mana
Catatan khusus	builtin_type terkait ke description_parameters untuk klasifikasi entitas yang didefinisikan sistem

custom_fields

Deskripsi: Definisi bidang kustom yang memungkinkan perpanjangan skema dinamis untuk tipe entitas, dengan tipe field yang dapat dikonfigurasi (custom_field_type), aturan validasi dan opsi dalam parameters (JSONB), serta flag kewajiban (is_required) untuk penangkapan data yang fleksibel di places, tasks, dan entitas lainnya

Atribut	Rincian
Bidang kunci	- custom_field_id - Pengidentifikasi entitas bidang kustom - entity_id - Pengidentifikasi entitas - custom_field_label - Nama field - custom_field_type - Tipe data dalam field - description - Deskripsi field - is_required - Apakah ini wajib atau tidak? - parameters - Parameter field
Konten	parameters (JSONB) menyimpan konfigurasi spesifik tipe field (aturan validasi, opsi dropdown, dll.)
Hubungan	Mendefinisikan atribut kustom yang tersedia untuk entitas; tipe field terkait ke description_parameters
Catatan khusus	Memungkinkan perpanjangan skema dinamis tanpa perubahan basis data; digunakan secara ekstensif di places dan tasks

Pelacakan historis

driver_history

Deskripsi: Jejak audit lengkap dari penugasan karyawan ke kendaraan dari waktu ke waktu melacak transisi old_employee_id ke new_employee_id dengan cap waktu (changed_datetime, server_datetime), data lokasi (latitude, longitude, address), informasi kunci hardware, dan atribusi pengguna (updated_by) yang memungkinkan analitik spesifik pengemudi ketika pengemudi berpindah antar kendaraan

Atribut	Rincian
Bidang kunci	- driver_history_id - Pengidentifikasi entitas riwayat pengemudi - object_id - Pengidentifikasi entitas objek - old_employee_id - Pengidentifikasi entitas karyawan lama - new_employee_id - Pengidentifikasi entitas karyawan baru - hardware_key - Atribut hardware_key dari tabel driver_history - changed_datetime - Tanggal dan waktu perubahan dibuat pada perangkat - server_datetime - Tanggal dan waktu perubahan dibuat di server - updated_by - Tanggal dan waktu yang terkait dengan atribut updated_by - latitude - Atribut latitude dari tabel driver_history - longitude - Atribut longitude dari tabel driver_history - address - Atribut address dari tabel driver_history
Hubungan	Melacak penugasan pengemudi ke kendaraan dari waktu ke waktu; terkait ke employees dan objects
Catatan khusus	Esensial untuk pelaporan spesifik pengemudi saat pengemudi berpindah kendaraan; penangkapan lokasi memungkinkan analisis lokasi perubahan penugasan

vehicle_trackers_history

Deskripsi: Jejak audit yang melacak perangkat GPS (object_id) mana yang dipasang di kendaraan mana (vehicle_id) dari waktu ke waktu dengan cap waktu perubahan (changed_datetime), memungkinkan atribusi data historis yang akurat dan perhitungan jarak tempuh saat pelacak dipindahkan antar kendaraan

Atribut	Rincian
Bidang kunci	- vehicle_tracker_history_id - Pengidentifikasi entitas riwayat pelacak kendaraan - vehicle_id - Pengidentifikasi entitas kendaraan - object_id - Pengidentifikasi entitas objek - changed_datetime - Tanggal dan waktu yang terkait dengan atribut changed_datetime
Hubungan	Melacak perangkat GPS mana yang dipasang pada kendaraan mana dari waktu ke waktu
Catatan khusus	Kritis untuk analisis data historis ketika pelacak dipindahkan antar kendaraan; memungkinkan atribusi jarak tempuh dan penggunaan yang akurat

Data referensi dan lookup

description_parameters

Deskripsi: Data referensi sistem yang menyediakan label yang dapat dibaca manusia (description) untuk nilai integer enumerasi (key) yang digunakan di seluruh basis data, diorganisasikan berdasarkan field type (mis. task_status, fuel_type, counter_type, entity_classification) untuk terjemahan nilai yang konsisten dalam pelaporan dan tampilan UI

Atribut	Rincian
Bidang kunci	- key - Nilai yang mungkin pada atribut - type - Atribut komposit yang terdiri dari nama tabel diikuti oleh underscore dan nama atribut dalam tabel - description - Nilai tersirat dari sebuah atribut
Konten	Menyediakan label yang dapat dibaca manusia untuk nilai berkode di seluruh basis data (status tugas, jenis bahan bakar, jenis penghitung, dll.)
Hubungan	Direferensikan melalui foreign key dari banyak tabel untuk kategorisasi yang distandarisasi
Catatan khusus	Esensial untuk menerjemahkan kode integer ke nilai yang dapat dibaca dalam pelaporan; type kelompok field terkait enumerasi

counters

Deskripsi: Konfigurasi odometer dan penghitung jam mesin yang menghubungkan pembacaan sensor perangkat (sensor_id) ke pengukuran jarak atau waktu dengan koefisien pengali untuk konversi unit (km, miles, jam) dan counter_type dari description_parameters yang mendefinisikan tipe pengukuran

Atribut	Rincian
Bidang kunci	- counter_id - ID internal - device_id - Pengidentifikasi entitas perangkat - counter_type - Tipe penghitung - sensor_id - Pengidentifikasi entitas sensor - multiplier - Koefisien untuk mengubah nilai menjadi salah satu metrik (km, l, dll.)
Hubungan	Menghubungkan perangkat ke pembacaan sensor yang merepresentasikan penghitung jarak atau waktu
Catatan khusus	multiplier mengonversi pulsa sensor menjadi unit aktual (km, miles, jam); counter_type from description_parameters mendefinisikan tipe pengukuran

device_output_name

Deskripsi: Label kustom untuk saluran output perangkat yang memetakan pengidentifikasi output numerik (number) ke nama yang ditentukan pengguna (label) seperti "Door Lock" atau "Engine Block" untuk pelaporan yang dapat dibaca dan analisis perintah serta status output perangkat

Atribut	Rincian
Bidang kunci	- device_id - Pengidentifikasi entitas perangkat - number - Atribut number dari tabel device_output_name - label - Atribut label dari tabel device_output_name
Konten	Memetakan nomor saluran output ke nama yang ditentukan pengguna (mis. "Door Lock", "Engine Block")
Catatan khusus	Memungkinkan pelaporan yang dapat dibaca saat menganalisis perintah dan status output perangkat

raw_telematics_data struktur

Skema raw_telematics_data schema contains three primary table types that work together to provide comprehensive device data.

ERD data telematika mentah lapisan Bronze

Diagram interaktif skema raw_telematics_data tersedia di dbdiagram.io: https://dbdiagram.io/d/v1-schema-telematics-bd-67a0acef263d6cf9a0d8e750

Temukan detail skema data telematika mentah di bawah.

skema raw_telematics_data

Tabel tracking_data_core {

  device_id integer [primary key]

  device_time timestampz [primary key]

  platform_time timestampz

  record_added_at timestampz [default: `now()`]

  latitude integer

  longitude integer

  speed integer

  altitude integer

  satellites integer

  event_id integer

  gps_fix_type integer

  hdop integer

  

  indexes {(device_id, device_time)}

}

  

Tabel inputs {

  event_id integer [primary key]

  device_id integer [primary key]

  record_added_at timestampz [default: `now()`]

  device_time timestampz [primary key]

  sensor_name text [primary key]

  value text

  indexes {(device_id, device_time)}

}

  

Tabel states {

  event_id integer [primary key]

  device_id serial [primary key]

  record_added_at timestampz [default: `now()`]

  device_time timestampz [primary key]

  state_name text [primary key]

  value text

  indexes {(device_id, device_time)}

}

  

Ref: inputs.(device_id, device_time) > tracking_data_core.(device_id, device_time)

Ref: states.(device_id, device_time) > tracking_data_core.(device_id, device_time)

Tabel kunci menurut kategori

Setiap tabel melayani tujuan spesifik dalam menangkap aspek berbeda dari informasi perangkat:

tracking_data_core

Tujuan: Data inti lokasi dan gerakan

Atribut	Rincian
Bidang kunci	device_id, device_time, platform_time, latitude, longitude, speed, altitude, satellites, hdop, event_id
Pengindeksan	Dioptimalkan dengan indeks pada (device_id, device_time)
Catatan khusus	Data lokasi (latitude dan longitude) menggunakan format integer dengan presisi 10⁷ untuk kinerja TimescaleDB yang optimal Kecepatan juga disimpan dalam integer, jadi Anda perlu membaginya dengan 100

inputs

Tujuan: Pembacaan sensor dari perangkat

Atribut	Rincian
Bidang kunci	input_id, device_id, device_time, sensor_name, value
Konten	Pembacaan analog (tingkat bahan bakar, suhu, tegangan), nilai yang dihitung (RPM mesin)
Hubungan	FROM raw_telematics_data.inputs AS i JOIN raw_business_data.sensor_description AS sd ON i.device_id = sd.device_id AND i.sensor_name = sd.input_label JOIN raw_telematics_data.tacking_data_core AS tdc ON i.device_id = tdc.device_id AND i.device_time = tdc.device_time

states

Tujuan: Indikator status perangkat dan mode operasional

Atribut	Rincian
Bidang Kunci	state_id, device_id, device_time, state_name, value
Konten	Indikator mode operasi (bekerja, idle, mati), status komponen (kontak, pintu)
Format Nilai	Nilai Boolean (1/0) atau kode status spesifik

Data dalam skema ini diambil langsung dari perangkat, dengan latensi minimal (biasanya detik). Skema ini dioptimalkan untuk data deret waktu menggunakan TimescaleDB untuk penyimpanan dan pengambilan yang efisien.

Informasi tambahan

Validasi data

Basis data menegakkan integritas data melalui beberapa mekanisme:

• KONSTRAIN CHECK memvalidasi agar nilai berada dalam rentang yang dapat diterima

• Kunci asing memastikan hubungan antar tabel tetap konsisten

• KONSTRAIN NOT NULL menjamin bahwa bidang yang diperlukan selalu memiliki nilai

• Nilai DEFAULT memberikan nilai cadangan ketika data tidak secara eksplisit disediakan

Optimisasi kueri

Tabel diatur dengan strategi pengindeksan tertentu:

• Semua tabel mencakup indeks berbasis waktu pada record_added_at

• Kolom kunci asing memiliki indeks khusus untuk kinerja join

• Kombinasi kolom yang sering digunakan memiliki indeks komposit

• TimescaleDB menyediakan indeks khusus untuk kueri deret waktu

repo struktur data

Skema ini saat ini dalam pengembangan. Jika Anda tertarik akses awal atau memiliki pertanyaan tentang fungsionalitas ini, silakan hubungi [e-mail].

Skema repo skema menyediakan kerangka kerja komprehensif untuk mengelola struktur organisasi, aset, perangkat, dan hubungan mereka dalam lingkungan multi-tenant. Dibangun di atas PostgreSQL 14+ dengan ekstensi ltree, skema ini mendukung organisasi hierarkis, definisi bidang kustom untuk jenis entitas apa pun, kontrol akses berbasis peran dengan pembatasan tingkat objek, dan jejak audit lengkap dengan pelacakan perubahan pada tingkat bidang. Semua entitas dapat diperluas tanpa modifikasi skema, dilokalisasi untuk penyebaran internasional, dan dihubungkan melalui hubungan polimorfik yang fleksibel.

Skema ini mengatasi skenario manajemen data yang kompleks termasuk hierarki aset armada di berbagai tingkat organisasi, platform SaaS multi-tenant yang memerlukan isolasi data, operasi yang didorong kepatuhan dengan persyaratan audit terperinci, dan sistem yang membutuhkan model data dinamis yang dapat disesuaikan melalui bidang kustom daripada migrasi basis data.

Diagram interaktif darirepo skema data tersedia di dbdiagram.io: https://dbdiagram.io/d/Navixy-Repo-data-schema-68ad788c1e7a611967a0930e

Temukan repo rincian skema di bawah.

repo data schema

// ============================================
// Skema DataHub Baru - Perjalanan Pelanggan
// PostgreSQL 14+ dengan ekstensi ltree
// Versi: 2.0 (Konsep)
// ============================================

// ============================================
// TABEL REFERENSI DASAR (hierarki ci_base)
// ============================================

Table ci_base {
  id uuid [primary key]
  code text [not null]
  title_en text [not null]
  order int
  is_system boolean [not null, default: false]
  discriminator text [not null]
  catalog_id uuid
  organization_id uuid
  parent_id uuid
  path ltree
  is_hierarchical boolean [default: false]
  extra jsonb
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  
  indexes {
    (parent_id) [name: 'idx_ci_parent']
    (path) [type: gist, name: 'idx_ci_path_gist']
    (catalog_id) [name: 'idx_ci_catalog']
    (organization_id) [name: 'idx_ci_org']
    (discriminator) [name: 'idx_ci_discriminator']
    (code) [unique, name: 'uq_ci_code_per_type']
    (organization_id, code) [unique, name: 'uq_ci_org_code']
  }
}

Table ci_module {
  id uuid [primary key]
}

Table ci_catalog_category {
  id uuid [primary key]
}

Table ci_country {
  id uuid [primary key]
}

Table ci_role {
  id uuid [primary key]
}

Table ci_entity_type {
  id uuid [primary key]
}

Table ci_device_status {
  id uuid [primary key]
}

Table ci_permission_scope {
  id uuid [primary key]
  module_id uuid
  entity_type_id uuid
  category text
}

Table ci_device_type {
  id uuid [primary key]
}

Table ci_asset_type {
  id uuid [primary key]
  category_id uuid
}

Table ci_asset_type_category {
  id uuid [primary key]
}

Table ci_inventory_type {
  id uuid [primary key]
}

Table ci_organization_type {
  id uuid [primary key]
}

Table ci_user_type {
  id uuid [primary key]
}

Table ci_asset_group_type {
  id uuid [primary key]
  max_items int
  color text
  icon text
  allowed_asset_type_id uuid
}

Table ci_device_relation_type {
  id uuid [primary key]
}

Table ci_tag {
  id uuid [primary key]
  entity_type_id uuid
  color text
}

// ============================================
// ENTITAS DASAR DENGAN DUKUNGAN BIDANG KUSTOM
// ============================================

Table customizable_entity {
  id uuid [primary key]
  entity_type_id uuid [not null]
  cf_data jsonb
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (entity_type_id) [name: 'idx_customizable_entity_type']
  }
}

// ============================================
// ENTITAS BISNIS INTI
// ============================================

Table organization {
  id uuid [primary key]
  parent_id uuid
  path ltree
  organization_type_id uuid [not null]
  title_en text [not null]
  is_active boolean [not null, default: true]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (parent_id) [name: 'idx_org_parent']
    (path) [type: gist, name: 'idx_org_path_gist']
    (organization_type_id) [name: 'idx_org_type']
  }
}

Table catalog {
  id uuid [primary key]
  organization_id uuid [not null]
  module_id uuid
  category_id uuid
  title_en text [not null]
  is_system boolean [not null, default: false]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (organization_id) [name: 'idx_catalog_org']
    (module_id) [name: 'idx_catalog_module']
  }
}

Table user {
  id uuid [primary key]
  organization_id uuid [not null]
  user_type_id uuid [not null]
  identity_provider text [not null]
  identity_provider_id uuid [not null]
  full_name text [not null]
  is_active boolean [not null, default: true]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_user_org']
    (user_type_id) [name: 'idx_user_type']
    (organization_id, identity_provider, identity_provider_id) [unique, name: 'uq_user_org_idp']
  }
}

// ============================================
// KONTROL AKSES (ACL)
// ============================================

Table user_role {
  id uuid [primary key]
  user_id uuid [not null]
  role_id uuid [not null]
  assigned_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  assigned_by uuid
  
  indexes {
    (user_id) [name: 'idx_user_role_user']
    (role_id) [name: 'idx_user_role_role']
    (user_id, role_id) [unique, name: 'uq_user_role']
  }
}

Table acl_role_permission {
  id uuid [primary key]
  role_id uuid [not null]
  permission_scope_id uuid [not null]
  target_entity_id uuid
  actions int [not null]
  granted_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  granted_by uuid
  
  indexes {
    (role_id) [name: 'idx_acl_role_perm_role']
    (permission_scope_id) [name: 'idx_acl_role_perm_scope']
    (role_id, permission_scope_id, target_entity_id) [unique, name: 'uq_acl_role_permission']
  }
}

Table acl_user_scope {
  id uuid [primary key]
  user_id uuid [not null]
  permission_scope_id uuid [not null]
  target_entity_id uuid [not null]
  actions int [not null]
  
  indexes {
    (user_id, permission_scope_id) [name: 'idx_acl_user_scope_user']
    (user_id, permission_scope_id, target_entity_id) [unique, name: 'uq_acl_user_scope']
  }
}

// ============================================
// ENTITAS BISNIS
// ============================================

Table asset {
  id uuid [primary key]
  organization_id uuid [not null]
  asset_type_id uuid [not null]
  label text [not null]
  description text
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_asset_org']
    (asset_type_id) [name: 'idx_asset_type']
  }
}

Table inventory {
  id uuid [primary key]
  organization_id uuid [not null]
  inventory_type_id uuid [not null]
  code text [not null]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_inventory_org']
    (inventory_type_id) [name: 'idx_inventory_type']
    (organization_id, code) [unique, name: 'uq_inventory_org_code']
  }
}

Table device {
  id uuid [primary key]
  organization_id uuid [not null]
  device_type_id uuid [not null]
  status_id uuid [not null]
  hw_id text
  label text [not null]
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_device_org']
    (device_type_id) [name: 'idx_device_type']
    (status_id) [name: 'idx_device_status']
    (hw_id) [name: 'idx_device_hw_id']
  }
}

Table device_asset_link {
  id uuid [primary key]
  device_id uuid [unique, not null]
  asset_id uuid [not null]
  linked_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  linked_by uuid
  
  indexes {
    (device_id) [unique, name: 'idx_device_asset_link_device']
    (asset_id) [name: 'idx_device_asset_link_asset']
  }
}

Table device_inventory_link {
  id uuid [primary key]
  device_id uuid [unique, not null]
  inventory_id uuid [not null]
  linked_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  linked_by uuid
  
  indexes {
    (device_id) [unique, name: 'idx_device_inventory_link_device']
    (inventory_id) [name: 'idx_device_inventory_link_inventory']
  }
}

Table device_relation {
  id uuid [primary key]
  master_id uuid [not null]
  slave_id uuid [not null]
  relation_type_id uuid [not null]
  
  indexes {
    (master_id) [name: 'idx_device_relation_master']
    (slave_id) [name: 'idx_device_relation_slave']
    (master_id, slave_id, relation_type_id) [unique, name: 'uq_device_relation']
  }
}

Table asset_group {
  id uuid [primary key]
  organization_id uuid [not null]
  group_type_id uuid [not null]
  title_en text [not null]
  description text
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  deleted_at timestamptz
  deleted_by uuid
  
  indexes {
    (organization_id) [name: 'idx_asset_group_org']
    (group_type_id) [name: 'idx_asset_group_type']
  }
}

Table asset_group_item {
  id uuid [primary key]
  group_id uuid [not null]
  asset_id uuid [not null]
  attached_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  detached_at timestamptz
  
  indexes {
    (group_id) [name: 'idx_asset_group_item_group']
    (asset_id) [name: 'idx_asset_group_item_asset']
    (group_id, asset_id, detached_at) [unique, name: 'uq_asset_group_item']
  }
}

Table entity_tag {
  id uuid [primary key]
  tag_id uuid [not null]
  entity_id uuid [not null]
  tagged_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (tag_id) [name: 'idx_entity_tag_tag']
    (entity_id) [name: 'idx_entity_tag_entity']
    (tag_id, entity_id) [unique, name: 'uq_entity_tag']
  }
}

// ============================================
// LOKALISASI
// ============================================

Table i18n_text {
  entity_id uuid [pk]
  field_code text [pk]
  locale text [pk]
  text_value text [not null]
  
  indexes {
    (entity_id) [name: 'idx_i18n_entity']
    (locale) [name: 'idx_i18n_locale']
  }
}

// ============================================
// BIDANG KUSTOM - DEFINISI
// ============================================

Table custom_field_def {
  id uuid [primary key]
  organization_id uuid [not null]
  owner_entity_type_id uuid [not null]
  code text [not null]
  title_en text [not null]
  field_type text [not null]
  is_multi boolean [not null, default: false]
  is_required boolean [not null, default: false]
  order int
  ref_entity_type_id uuid
  ref_catalog_id uuid
  created_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  updated_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (organization_id) [name: 'idx_cfd_org']
    (owner_entity_type_id) [name: 'idx_cfd_owner_type']
    (organization_id, owner_entity_type_id, code) [unique, name: 'uq_cfd_org_type_code']
  }
}

// ============================================
// BIDANG KUSTOM - NILAI (berdasarkan tipe)
// ============================================

Table custom_field_value_text {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value text [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_text_value']
  }
}

Table custom_field_value_number {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value numeric [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_number_value']
  }
}

Table custom_field_value_boolean {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value boolean [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_boolean_value']
  }
}

Table custom_field_value_date {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value date [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_date_value']
  }
}

Table custom_field_value_datetime {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  value timestamptz [not null]
  
  indexes {
    (field_def_id, value) [name: 'idx_cfv_datetime_value']
  }
}

Table custom_field_value_entity {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  ref_entity_id uuid [not null]
  
  indexes {
    (field_def_id, ref_entity_id) [name: 'idx_cfv_entity_value']
  }
}

Table custom_field_value_catalog {
  customizable_entity_id uuid [pk]
  field_def_id uuid [pk]
  value_index smallint [pk]
  ref_item_id uuid [not null]
  
  indexes {
    (field_def_id, ref_item_id) [name: 'idx_cfv_catalog_value']
  }
}

// ============================================
// AUDIT
// ============================================

Table audit_event {
  id uuid [primary key]
  event_category text [not null]
  user_id uuid
  identity_provider_id uuid
  ip_address inet
  user_agent text
  aggregate_type text
  aggregate_id uuid
  event_type text [not null]
  event_data jsonb
  occurred_at timestamptz [not null, default: `CURRENT_TIMESTAMP`]
  
  indexes {
    (user_id, occurred_at) [name: 'idx_audit_event_user']
    (aggregate_type, aggregate_id, occurred_at) [name: 'idx_audit_event_aggregate']
    (event_category, occurred_at) [name: 'idx_audit_event_category']
    (event_type, occurred_at) [name: 'idx_audit_event_type']
  }
}

// ============================================
// HUBUNGAN
// ============================================

Ref: ci_base.catalog_id > catalog.id
Ref: ci_base.organization_id > organization.id
Ref: ci_base.parent_id > ci_base.id

Ref: ci_module.id - ci_base.id
Ref: ci_catalog_category.id - ci_base.id
Ref: ci_country.id - ci_base.id
Ref: ci_role.id - ci_base.id
Ref: ci_entity_type.id - ci_base.id
Ref: ci_device_status.id - ci_base.id
Ref: ci_permission_scope.id - ci_base.id
Ref: ci_device_type.id - ci_entity_type.id
Ref: ci_asset_type.id - ci_entity_type.id
Ref: ci_asset_type_category.id - ci_base.id
Ref: ci_inventory_type.id - ci_entity_type.id
Ref: ci_organization_type.id - ci_entity_type.id
Ref: ci_user_type.id - ci_entity_type.id
Ref: ci_asset_group_type.id - ci_entity_type.id
Ref: ci_device_relation_type.id - ci_base.id
Ref: ci_tag.id - ci_base.id

Ref: ci_permission_scope.module_id > ci_module.id
Ref: ci_permission_scope.entity_type_id > ci_entity_type.id
Ref: ci_asset_type.category_id > ci_asset_type_category.id
Ref: ci_asset_group_type.allowed_asset_type_id > ci_asset_type.id
Ref: ci_tag.entity_type_id > ci_entity_type.id

Ref: customizable_entity.entity_type_id > ci_entity_type.id

Ref: organization.id - customizable_entity.id
Ref: organization.parent_id > organization.id
Ref: organization.organization_type_id > ci_organization_type.id
Ref: organization.deleted_by > user.id

Ref: catalog.organization_id > organization.id
Ref: catalog.module_id > ci_module.id
Ref: catalog.category_id > ci_catalog_category.id

Ref: user.id - customizable_entity.id
Ref: user.organization_id > organization.id
Ref: user.user_type_id > ci_user_type.id
Ref: user.deleted_by > user.id

Ref: user_role.user_id > user.id
Ref: user_role.role_id > ci_role.id
Ref: user_role.assigned_by > user.id

Ref: acl_role_permission.role_id > ci_role.id
Ref: acl_role_permission.permission_scope_id > ci_permission_scope.id
Ref: acl_role_permission.granted_by > user.id

Ref: acl_user_scope.user_id > user.id
Ref: acl_user_scope.permission_scope_id > ci_permission_scope.id

Ref: asset.id - customizable_entity.id
Ref: asset.organization_id > organization.id
Ref: asset.asset_type_id > ci_asset_type.id
Ref: asset.deleted_by > user.id

Ref: inventory.id - customizable_entity.id
Ref: inventory.organization_id > organization.id
Ref: inventory.inventory_type_id > ci_inventory_type.id
Ref: inventory.deleted_by > user.id

Ref: device.id - customizable_entity.id
Ref: device.organization_id > organization.id
Ref: device.device_type_id > ci_device_type.id
Ref: device.status_id > ci_device_status.id
Ref: device.deleted_by > user.id

Ref: device_asset_link.device_id - device.id
Ref: device_asset_link.asset_id > asset.id
Ref: device_asset_link.linked_by > user.id

Ref: device_inventory_link.device_id - device.id
Ref: device_inventory_link.inventory_id > inventory.id
Ref: device_inventory_link.linked_by > user.id

Ref: device_relation.master_id > device.id
Ref: device_relation.slave_id > device.id
Ref: device_relation.relation_type_id > ci_device_relation_type.id

Ref: asset_group.id - customizable_entity.id
Ref: asset_group.organization_id > organization.id
Ref: asset_group.group_type_id > ci_asset_group_type.id
Ref: asset_group.deleted_by > user.id

Ref: asset_group_item.group_id > asset_group.id
Ref: asset_group_item.asset_id > asset.id

Ref: entity_tag.tag_id > ci_tag.id

Ref: custom_field_def.organization_id > organization.id
Ref: custom_field_def.owner_entity_type_id > ci_entity_type.id
Ref: custom_field_def.ref_entity_type_id > ci_entity_type.id
Ref: custom_field_def.ref_catalog_id > catalog.id

Ref: custom_field_value_text.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_text.field_def_id > custom_field_def.id

Ref: custom_field_value_number.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_number.field_def_id > custom_field_def.id

Ref: custom_field_value_boolean.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_boolean.field_def_id > custom_field_def.id

Ref: custom_field_value_date.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_date.field_def_id > custom_field_def.id

Ref: custom_field_value_datetime.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_datetime.field_def_id > custom_field_def.id

Ref: custom_field_value_entity.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_entity.field_def_id > custom_field_def.id
Ref: custom_field_value_entity.ref_entity_id > customizable_entity.id

Ref: custom_field_value_catalog.customizable_entity_id > customizable_entity.id
Ref: custom_field_value_catalog.field_def_id > custom_field_def.id
Ref: custom_field_value_catalog.ref_item_id > ci_base.id

Ref: audit_event.user_id > user.id

Frekuensi pembaruan

Data dalam repo skema disinkronkan secara real-time dengan sistem sumber. Pembaruan terjadi segera saat perubahan terjadi, dengan jejak audit yang menangkap semua modifikasi untuk kepatuhan dan analisis historis.

ci_base

Skema repo skema menggunakan pola Single Table Inheritance untuk semua data referensi melalui ci_base tabel:

Skema repo skema menggunakan Single Table Inheritance pola untuk semua data referensi melalui ci_base tabel. Desain ini mengkonsolidasikan kamus sistem, klasifikasi, dan item referensi yang didefinisikan pengguna ke dalam satu struktur terpadu, memberikan konsistensi dan fleksibilitas di seluruh skema.

Arsitektur:

Skema ci_base tabel berfungsi sebagai dasar untuk semua data referensi, menggunakan discriminator bidang untuk mengidentifikasi tipe referensi spesifik. Setiap tipe referensi memiliki tabel terkait (seperti ci_device_type, ci_asset_type) yang berbagi id sebagai ci_base, menciptakan hubungan pewarisan yang tipe-aman.

Bagaimana entitas bisnis terhubung ke ci_base:

Semua entitas bisnis dalam repo skema merujuk ci_base subtipe untuk mendefinisikan klasifikasi dan perilaku mereka:

• organization → merujuk ci_organization_type (yang mewarisi dari ci_entity_type → ci_base)

• user → merujuk ci_user_type (yang mewarisi dari ci_entity_type → ci_base)

• device → merujuk ci_device_type dan ci_device_status (keduanya mewarisi dari ci_base)

• asset → merujuk ci_asset_type (yang mewarisi dari ci_entity_type → ci_base)

• inventory → merujuk ci_inventory_type (yang mewarisi dari ci_entity_type → ci_base)

• asset_group → merujuk ci_asset_group_type (yang mewarisi dari ci_entity_type → ci_base)

Kategori tipe referensi:

Kategori	Tabel	Tujuan
Konfigurasi sistem	ci_module, ci_country, ci_role	Menetapkan modul sistem, referensi geografis, dan peran pengguna
Definisi tipe entitas	ci_entity_type, ci_device_type, ci_asset_type, ci_inventory_type, ci_organization_type, ci_user_type, ci_asset_group_type	Mengklasifikasikan semua entitas bisnis berdasarkan tipe
Status dan klasifikasi	ci_device_status, ci_asset_type_category	Melacak status entitas dan mengelompokkan tipe ke dalam kategori
Kontrol akses	ci_permission_scope	Menentukan izin apa yang dapat diberikan (terhubung ke ci_module dan ci_entity_type)
Hubungan	ci_device_relation_type	Menetapkan tipe hubungan antar perangkat (master-slave, cadangan, dll.)
Kategorisasi	ci_tag, ci_catalog_category	Memungkinkan penandaan yang fleksibel dan organisasi katalog

Contoh pola kueri

-- Dapatkan semua tipe perangkat untuk sebuah organisasi (sistem + kustom)
SELECT cb.id, cb.code, cb.title_en, cb.is_system
FROM repo.ci_base cb
JOIN repo.ci_device_type dt ON dt.id = cb.id
WHERE cb.discriminator = 'device_type'
  AND (cb.is_system = true OR cb.organization_id = $org_id)
  AND cb.deleted_at IS NULL;

-- Dapatkan tipe aset dengan kategorinya
SELECT 
  cb.code as asset_type_code,
  cb.title_en as asset_type_name,
  cat_cb.title_en as category_name
FROM repo.ci_base cb
JOIN repo.ci_asset_type at ON at.id = cb.id
LEFT JOIN repo.ci_asset_type_category cat ON cat.id = at.category_id
LEFT JOIN repo.ci_base cat_cb ON cat_cb.id = cat.id
WHERE cb.discriminator = 'asset_type'
  AND cb.deleted_at IS NULL;

-- Dapatkan struktur tag hierarkis
SELECT cb.id, cb.code, cb.title_en, cb.path, cb.parent_id
FROM repo.ci_base cb
JOIN repo.ci_tag t ON t.id = cb.id
WHERE cb.discriminator = 'tag'
  AND cb.deleted_at IS NULL
ORDER BY cb.path;

Tabel kunci menurut kategori

Tabel dalam repo skema disusun ke dalam kategori fungsional. Deskripsi di bawah merangkum tabel paling penting berdasarkan tujuan bisnisnya.

organization

Tujuan: Manajemen organisasi hirarkis

Atribut	Rincian
Bidang kunci	id, parent_id, path, organization_type_id, title_en, is_active, deleted_at
Pengindeksan	Indeks GiST pada path untuk kueri hirarkis, indeks pada parent_id dan organization_type_id
Catatan khusus	Menggunakan ltree untuk hirarki multi-level, mewarisi dari customizable_entity untuk dukungan bidang kustom

user

Tujuan: Akun pengguna dan autentikasi

Atribut	Rincian
Bidang kunci	id, organization_id, user_type_id, identity_provider, identity_provider_id, full_name, is_active
Pengindeksan	Indeks unik pada (organization_id, identity_provider, identity_provider_id)
Catatan khusus	Integrasi penyedia identitas eksternal (Keycloak, Auth0, Okta), mewarisi dari customizable_entity

device

Tujuan: Perangkat pelacakan fisik

Atribut	Rincian
Bidang kunci	id, organization_id, device_type_id, status_id, hw_id, label
Pengindeksan	Indeks pada organization_id, device_type_id, status_id, hw_id
Catatan khusus	Pengidentifikasi perangkat keras untuk pelacakan perangkat, mewarisi dari customizable_entity untuk bidang kustom

asset

Tujuan: Aset fisik atau virtual

Atribut	Rincian
Bidang kunci	id, organization_id, asset_type_id, label, description
Pengindeksan	Indeks pada organization_id dan asset_type_id
Catatan khusus	Mewarisi dari customizable_entity, terhubung ke perangkat melalui device_asset_link

inventory

Tujuan: Catatan inventaris dan gudang

Atribut	Rincian
Bidang kunci	id, organization_id, inventory_type_id, code
Pengindeksan	Indeks unik pada (organization_id, code)
Catatan khusus	Kode unik dalam organisasi, terhubung ke perangkat melalui device_inventory_link

asset_group

Tujuan: Pengelompokan aset dengan pelacakan historis

Atribut	Rincian
Bidang kunci	id, organization_id, group_type_id, title_en, description
Hubungan	FROM repo.asset_group AS ag JOIN repo.asset_group_item AS agi ON agi.group_id = ag.id JOIN repo.asset AS a ON a.id = agi.asset_id WHERE agi.detached_at IS NULL
Catatan khusus	Keanggotaan berbasis waktu melalui asset_group_item, kueri anggota saat ini dengan WHERE detached_at IS NULL

custom_field_def

Tujuan: Definisi bidang kustom dan metadata

Atribut	Rincian
Bidang kunci	id, organization_id, owner_entity_type_id, code, field_type, is_multi, is_required
Konten	Tipe bidang termasuk teks, angka, boolean, tanggal, datetime, entity_ref, catalog_item_ref
Catatan khusus	Memungkinkan bidang kustom yang fleksibel untuk setiap tipe entitas, nilai disimpan dalam tipe-spesifik custom_field_value_* tabel

acl_role_permission

Tujuan: Manajemen izin berbasis peran

Atribut	Rincian
Bidang kunci	id, role_id, permission_scope_id, target_entity_id, actions
Konten	Bitmask aksi (READ=1, UPDATE=2, DELETE=4, CREATE=8), izin spesifik target atau luas untuk tipe entitas
Hubungan	FROM repo.user_role AS ur JOIN repo.acl_role_permission AS rp ON rp.role_id = ur.role_id WHERE ur.user_id = $user_id
Catatan khusus	Bekerja dengan user_role dan acl_user_scope untuk menentukan izin akhir pengguna

audit_event

Tujuan: Log audit terpadu untuk semua perubahan sistem

Atribut	Rincian
Bidang kunci	id, event_category, user_id, aggregate_type, aggregate_id, event_type, event_data, occurred_at
Pengindeksan	Indeks pada (user_id, occurred_at), (aggregate_type, aggregate_id, occurred_at), (event_category, occurred_at)
Catatan khusus	Dipartisi berdasarkan occurred_at (bulanan), dua kategori: auth (otentikasi) dan domain (peristiwa bisnis), menyimpan delta perubahan tingkat bidang dalam event_data JSONB

Hubungan data

Skema repo skema menerapkan pola hubungan canggih untuk pemodelan data yang fleksibel:

Struktur hirarkis

• Organisasi menggunakan path ltree untuk kueri pohon yang efisien

• Item referensi (ci_base) mendukung hirarki opsional

• Pemeliharaan path otomatis melalui trigger basis data

Pola pewarisan

• Pewarisan tabel: customizable_entity → entitas bisnis (organization, user, device, asset, inventory, asset_group)

• Pewarisan ID: ci_base → tabel tipe referensi

• Diskriminasi tipe melalui entity_type_id dan discriminator fields

Hubungan polimorfik

Beberapa tabel menggunakan referensi polimorfik tanpa constraint kunci asing untuk fleksibilitas maksimum:

• acl_role_permission.target_entity_id → apa pun customizable_entity

• acl_user_scope.target_entity_id → apa pun customizable_entity

• entity_tag.entity_id → apa pun customizable_entity

Hubungan ini divalidasi pada tingkat aplikasi.

Informasi tambahan

Validasi data

Skema repo skema menegakkan integritas data melalui beberapa mekanisme:

Kendala basis data

• Kendala UNIQUE dengan dukungan soft delete (indeks parsial WHERE deleted_at IS NULL)

• Kendala CHECK (mis., device_relation menjamin master_id ≠ slave_id)

• Kendala NOT NULL pada bidang yang diwajibkan

• Nilai DEFAULT untuk timestamp dan flag boolean

Validasi tingkat aplikasi

• Validasi tipe entitas untuk referensi polimorfik

• Validasi katalog untuk referensi bidang kustom

• Validasi tipe bidang kustom

• Manajemen array bidang multi-nilai

Optimisasi kueri

Tabel diatur dengan strategi pengindeksan tertentu:

Indeks standar:

• Semua foreign key memiliki indeks khusus

• Indeks berbasis waktu pada created_at, updated_at, deleted_at

• Indeks komposit untuk kolom yang sering dijoin

Indeks khusus:

• Indeks GiST pada path ltree untuk kueri hirarkis

• Indeks unik parsial yang mendukung soft delete

• Indeks nilai bidang kustom untuk penyaringan dan pengurutan

• Indeks event audit pada waktu + entitas untuk pencarian yang efisien

Pertimbangan performa:

• Disarankan pooling koneksi (PgBouncer)

• Perawatan VACUUM rutin untuk tabel besar

• Kemungkinan partisi di masa depan untuk device tabel berdasarkan organization_id

• View materialized untuk perhitungan kontrol akses yang kompleks