Explore

Draft Roadmap

MODUL 1 Hazard Classification (TBC/PSPP/GR Classifier)

Modul otomatis yang mengolah laporan hazard sebelum masuk evaluasi,melakukan pemrosesan awal terhadap seluruh laporan hazard yang masuk dengan cara memberikan label klasifikasi otomatis (TBC/PSPP/GR), confidence score, reasoning, dan menentukan prioritas laporan sebelum diteruskan ke proses evaluasi manual.

EPIC 1.1 Classification Overview

Definisi Epic

Epic ini menyediakan gambaran menyeluruh tentang kondisi proses klasifikasi hazard yang sedang berlangsung secara real-time. Berfungsi untuk memonitor jumlah laporan dalam setiap tahap klasifikasi, termasuk gagal proses.

Feature 1.1.1 Classification Summary Cards

Definisi Feature

Menampilkan kumpulan kartu ringkasan (summary cards) yang menunjukkan status global proses klasifikasi.

Sub-feature: Menunggu Klasifikasi

Definisi Jumlah laporan yang belum masuk proses batch pemrosesan classifier.

DoD

Sistem menghitung laporan berstatus PENDING.

Angka ditampilkan akurat dan diperbarui otomatis.

Sub-feature: Sedang Diklasifikasi

Definisi Jumlah laporan yang sedang diproses oleh batch aktif.

DoD

Status berubah ketika laporan masuk batch.

Tampilan konsisten dengan progress batch.

⁠

Sub-feature: Klasifikasi Gagal

Definisi Jumlah laporan yang gagal diproses oleh classifier.

DoD

Error tercatat di log.

Laporan otomatis menunggu batch retry.

Sub-feature: Batch Klasifikasi Hari Ini

Definisi Jumlah batch klasifikasi yang telah dibentuk dan diproses hari tersebut.

DoD

Sistem menghitung batch berdasarkan konfigurasi harian.

Status batch ditampilkan (running/complete/failed).

⁠

EPIC 1.2 Batch Classification Management

Definisi Epic

Mengatur seluruh proses batching, dari pembentukan batch, pemantauan, hingga penyelesaian dan retry.

Feature 1.2.1 Batch List

Definisi Feature

Daftar batch klasifikasi yang dibuat pada hari berjalan.

Sub-feature: Tabel Batch Harian

DoD

Menampilkan semua batch dengan ID dan waktu pembentukan.

Sub-feature: Status Batch

DoD

Status muncul benar: Menunggu, Sedang Diproses, Selesai, Gagal.

Sub-feature: Progress Bar

DoD

Progress dihitung berdasarkan laporan selesai vs total dalam batch.

Sub-feature: Sorting & Filtering Batch

DoD

Sort berdasarkan waktu mulai dan jumlah laporan.

Filter status bekerja tanpa reload.

Feature 1.2.2 Batch Detail

Definisi Feature

Menampilkan rincian isi batch dan status tiap laporan.

Sub-feature: Daftar Laporan dalam Batch

DoD

Menampilkan ID laporan, lokasi, status, confidence jika ada.

Sub-feature: Status Laporan

DoD

Status tiap laporan sinkron dengan proses classifier.

Sub-feature: Ringkasan Batch

DoD

Total laporan, selesai, gagal, durasi batch ditampilkan.

Sub-feature: Log Proses

DoD

Log tersedia: waktu mulai, selesai, error yang terjadi.

⁠

Feature 1.2.3 Batch Retry

Definisi Feature

Mengulang batch gagal agar laporan dapat diproses ulang.

Sub-feature: Retry Batch Gagal

DoD

Tombol retry muncul hanya pada batch gagal.

Sub-feature: Nama Batch Retry

DoD

Penandaan batch jelas: “Batch 09:00 (Retry 1)”.

Sub-feature: Error Mapping ke Batch Baru

DoD

Hanya laporan gagal yang dimasukkan batch retry.

⁠

EPIC 1.3 Classification Queue

Definisi Epic

Mengatur daftar laporan yang menunggu, sedang diproses, atau gagal diproses oleh classifier.

Feature 1.3.1 Queue Table

Definisi Feature

Tabel seluruh laporan dalam antrian klasifikasi.

Sub-feature: ID Laporan / Pelapor / Lokasi / Batch / ETA / Status

DoD

Semua kolom tampil lengkap dan dapat di-sort.

Feature 1.3.2 Queue Filtering

Definisi Feature

Fasilitas pencarian dan penyaringan antrian klasifikasi.

Sub-feature & DoD

Filter by status → hanya laporan dengan status tertentu ditampilkan.

Filter by batch → menampilkan laporan dalam batch tertentu.

Search → pencarian berdasarkan ID/pelapor/lokasi.

Pagination skala besar → mampu memuat ribuan laporan.

⁠

Feature 1.3.3 Queue Detail (Readonly)

Definisi Feature

Detail laporan yang belum selesai diklasifikasi.

DoD

Panel detail muncul saat laporan diklik.

Indikator “Belum diklasifikasi” tampil jelas.

EPIC 1.4 Auto-Sync to Evaluation

Definisi Epic

Epic untuk memindahkan laporan dari modul klasifikasi ke modul evaluasi secara otomatis.

Feature 1.4.1 Status Transition Engine

Definisi Feature

Mesin logika yang menentukan kapan laporan berpindah ke modul evaluasi.

DoD

Jika classification_status = done, laporan pindah otomatis ke Evaluation Queue.

Feature 1.4.2 Backend Tagging

Definisi Feature

Penandaan status backend untuk sinkronisasi antar modul.

Sub-feature & DoD

classification_status → valid values: pending, processing, done, failed.

evaluation_status → auto-set menjadi BELUM_DIEVALUASI.

⁠

MODUL 2 Hazard Evaluation (Manual Review)

Modul yang digunakan evaluator untuk mereview hasil klasifikasi, memvalidasi isi laporan, memeriksa bukti foto, mengonfirmasi jenis hazard, memberikan tindakan pengendalian, dan menyelesaikan laporan.

EPIC 2.1 Evaluator Workflow Overview

Feature 2.1.1 Evaluation Summary Cards

Definisi Feature

Menampilkan rangkuman status laporan di modul evaluasi.

Sub-feature & DoD

Total laporan → menghitung semua laporan masuk modul evaluasi.

Siap Dievaluasi → berdasarkan status evaluation = pending.

Dalam Evaluasi → berubah saat evaluator membuka laporan.

Selesai → bertambah setelah submit.

Pain Points → indikator laporan berisiko tinggi.

⁠

Feature 2.1.2 Special Alerts

Definisi Feature

Notifikasi untuk laporan khusus.

Sub-feature & DoD

Review ulang → tampil jika evaluator meminta re-evaluasi.

SLA lewat batas → warna merah/oranye sesuai kondisi SLA.

⁠

EPIC 2.2 Evaluation Queue (Siap Dievaluasi)

Feature 2.2.1 Evaluation Table

Definisi Feature

Tabel laporan yang siap diuji secara manual oleh evaluator.

Sub-feature & DoD

Label TBC/PSPP/GR → tampil sebagai chip.

Confidence → angka persentase.

ID pelapor / lokasi / jenis hazard → tampil lengkap.

Status evaluasi → pending, in_progress, done.

SLA → indikator warna.

Action Evaluasi → membuka detail laporan.

⁠

Feature 2.2.2 Filtering & Search

Sub-feature & DoD

Filter label → multi-select.

Filter SLA → kategori SLA.

Filter site → filter lokasi kerja.

Search → pencarian granular.

⁠

EPIC 2.3 Report Evaluation Panel (Detail Evaluation View)

Feature 2.3.1 Evaluation Status Header

Definisi Feature

Bagian header status pada halaman detail evaluasi.

DoD

Status berubah otomatis.

SLA due date tampil.

Tombol Next/Prev berfungsi.

Feature 2.3.2 Report Metadata

DoD

Menampilkan ID laporan, pelapor, site, lokasi, waktu dibuat.

⁠

Feature 2.3.3 AI Output (Final Classification)

DoD

Label hazard final muncul.

Confidence score akurat.

Subkategori hazard tampil.

⁠

Feature 2.3.4 Object Description & Hazard Context

DoD

Ketidaksesuaian & sub-ketidaksesuaian tampil.

Quick action tampil.

Deskripsi temuan tampil lengkap.

⁠

Feature 2.3.5 Evidence View

DoD

Foto tampil jelas.

Bisa zoom.

Metadata foto ada jika tersedia.

Feature 2.3.6 Similar Reports (Retrieval)

DoD

Daftar laporan serupa tampil.

Similarity score konsisten.

Thinking process dapat dibuka.

EPIC 2.4 Reasoning Deep Dive

Menampilkan reasoning AI secara mendalam (TBC, PSPP, GR) agar evaluator dapat melakukan validasi kualitas reasoning, kesesuaian dengan evidence, dan referensi terhadap SOP/aturan keselamatan. Dalam modul ini, evaluator dapat melihat detail reasoning, citation, dan dokumen pendukung seperti SOP, PSPP guidelines, dan Golden Rules.

Outcome: Evaluator dapat memahami logika AI, mengecek kesesuaian reasoning dengan fakta laporan, memvalidasi chunk/citation, serta mengakses dokumen resmi sebagai referensi keputusan.

Feature 2.4.1 TBC Reasoning Card

Definisi:

Card yang berisi reasoning AI untuk kategori TBC (To Be Concern Hazard) lengkap dengan confidence, subkategori, dan logika pendukung AI.

Sub-feature:

2.4.1.a TBC Category Header

Menampilkan label TBC + warna identitas

Menampilkan sub-kategori TBC (mis. “1. Deviasi Pengoperasian Unit”)

Menampilkan confidence score

2.4.1.b Core Reasoning Block

Penjelasan naratif tentang alasan AI memilih kategori TBC

Ditulis dalam bahasa manusia, mudah dibaca

2.4.1.c Citation & Evidence Mapping

AI menampilkan kutipan kalimat atau frasa dari deskripsi temuan yang menjadi dasar reasoning

Highlight text atau bullet list yang menunjukkan evidence relevan

Mapping ke elemen gambar (jika ada image tagging)

2.4.1.d Chunk Reference (AI Source Traceability)

Menampilkan chunk/dokumen internal yang digunakan AI

Format:

Feature 2.4.2 PSPP Reasoning Card

Definisi:

Card yang menampilkan reasoning AI untuk kategori PSPP (Peraturan Sanksi Pelanggaran Prosedur).

Sub-feature:

2.4.2.a PSPP Category Header

Label PSPP dengan warna kuning/amber

Sub-kategori PSPP (mis. “4. Pelanggaran Prosedur Keselamatan”)

Confidence score

2.4.2.b Core Reasoning Block

Penjelasan mengapa temuan dianggap tidak sesuai prosedur

Menjelaskan hubungan temuan → pelanggaran SOP → risiko

2.4.2.c Procedural Citation Mapping

Identifikasi kalimat atau elemen temuan yang melanggar SOP

Bullet list:

“Tidak menggunakan APD”

“Tidak mengikuti jalur aman”

dll

2.4.2.d Chunk Reference (Regulation Segments)

AI menampilkan potongan regulasi yang relevan, misal:

Feature 2.4.3 — GR Reasoning Card

Definisi:

Card reasoning untuk GR (Golden Rules) yang menghubungkan temuan dengan pelanggaran prinsip keselamatan utama perusahaan.

Sub-feature:

2.4.3.a — GR Category Header

Label GR dengan warna hijau/teal

Sub-kategori GR (mis. “2. Pengoperasian Kendaraan & Unit”)

Confidence score

2.4.3.b — Core Reasoning Block

Narasi mengapa temuan melanggar aturan Golden Rules

Penjelasan risiko yang terjadi bila GR tidak dipatuhi

2.4.3.c — Golden Rule Related Evidence

Point-point temuan yang relevan

Highlight kalimat deskripsi temuan

2.4.3.d — Chunk Reference (Golden Rules Library)

Potongan referensi GR yang dipakai AI

⁠

Feature 2.4.4 — Document References (SOP / PSPP / Golden Rules)

Definisi:

Section yang menampilkan dokumen rujukan resmi yang digunakan AI dalam reasoning dan dapat diakses evaluator untuk verifikasi.

Sub-feature:

2.4.4.a — Document List Panel

Daftar dokumen:

SOP TBC (PDF)

PSPP Guidelines

Golden Rules Handbook

Tautan untuk membuka dokumen (preview popup atau tab baru)

2.4.4.b Document → Reasoning Cross-link

Setiap reasoning card memiliki link ke bagian dokumen yang relevan

Jika reasoning mengutip Section 3.2 PSPP, evaluator bisa klik untuk membuka langsung Section tersebut

2.4.4.c Citation Viewer

Memperlihatkan referensi teks yang dipakai reasoning

Format:

2.4.4.d Chunk Evidence Browser

Menampilkan chunk yang digunakan AI untuk reasoning

Dapat dipilih untuk membuka preview chunk

Menampilkan metadata chunk (dokumen sumber, halaman, topik)

Want to print your doc?
This is not the way.

Try clicking the ··· in the right corner or using a keyboard shortcut (

CtrlP

) instead.