Panduan Berdasarkan Peran¶
Hak akses StaraTrace mengikuti project membership. Sebuah jabatan organisasi tidak otomatis memberi akses ke project. Superuser memiliki akses lintas project untuk administrasi, tetapi penggunaannya perlu dibatasi dan dapat diaudit.
Viewer / Reviewer¶
Viewer dipakai untuk orang yang perlu membaca konteks tanpa mengubah dokumen dan routing.
- Buka project, document, versi, diff, Case, pencarian, dan Tanya AI yang diizinkan.
- Verifikasi sumber, tanggal,
doc_key, change summary, serta perbedaan antarversi. - Laporkan mapping yang salah atau konversi yang meragukan kepada Editor atau Manager.
- Jangan memakai Viewer sebagai pengganti proses approval formal organisasi.
Editor / Contributor¶
Editor menjalankan intake dan pembentukan hubungan bukti sehari-hari.
- Upload document, menambah version, dan mengisi change summary.
- Mereview evidence email miliknya, import ke Inbox, dan memetakan attachment.
- Membuat Case dan menghubungkan evidence sesuai scope project.
- Menjalankan retry pada item yang dapat diakses setelah penyebabnya diperbaiki.
Editor perlu memeriksa hasil sebelum meneruskan pekerjaan: file source tersedia, project/module benar, dedupe ditangani, dan hasil konversi/diff masuk akal. Editor tidak mengatur anggota, integrasi project, atau password Key Bank untuk seluruh project.
Manager / Team Lead¶
Manager mengelola ruang kerja project dan mengambil keputusan yang berdampak pada anggota atau evidence. Gunakan menu Projects → Kelola agar pengaturan project tidak bercampur dengan pekerjaan harian.
Pengaturan project¶
Manager dapat mengatur nama/scope project, module, dan aturan kerja yang tersedia di halaman project. Periksa dampak perubahan pada daftar dokumen dan email sebelum menyimpan.
Anggota project¶
Gunakan Anggota untuk memberi role viewer, editor, atau manager.
Untuk banyak anggota, masukkan satu baris username,role, pilih Preview Batch, periksa role lama dan tindakan yang akan dilakukan, lalu terapkan. Maksimal 100 baris per batch. Sistem melindungi manager aktif terakhir agar project tidak kehilangan pengelola.
Bukti dan keputusan¶
- Periksa dan approve versi atau kirim permintaan perubahan dengan alasan yang jelas.
- Gunakan Case untuk mengelompokkan evidence isu; ekspor paket evidence hanya setelah memastikan relasi dan aksesnya benar.
- Gunakan Key Bank/Locked Files sesuai prosedur organisasi untuk file terenkripsi. Password tidak boleh disalin ke note, export, atau tiket.
- Gunakan bulk retry Markdown hanya setelah daftar difilter menurut project dan penyebab error.
Admin Aplikasi¶
Admin Aplikasi mengelola pengguna global, group/permission, dan data operasional yang terlihat melalui aplikasi. Admin tidak perlu menjadi Manager setiap project untuk pekerjaan teknis; pengelolaan scope bisnis tetap sebaiknya dilakukan Team Lead.
| Area | Tanggung jawab |
|---|---|
| Akun dan permission | Buat/nonaktifkan akun, reset password melalui prosedur organisasi, dan berikan akses minimal. |
| Status Sistem | Baca status layanan dan antrean untuk mengetahui apakah pekerjaan pengguna tertunda. |
| Antrean proses | Arahkan pengguna untuk memperbaiki source atau password lalu mengulang proses pada item yang tepat. |
| Data dan audit | Gunakan Django Admin untuk inspeksi bila tindakan yang sama tidak ada di UI operasional. |
Admin sebaiknya memakai halaman operasional aplikasi terlebih dahulu dan Django Admin untuk inspeksi data bila tindakan yang sama tidak tersedia di UI. Jangan mengubah source, hash, atau artefak secara langsung.
Integrasi dan pemiliknya¶
| Integrasi | Pemilik | Cara pakai | Status |
|---|---|---|---|
| Classic Outlook Local Sync | User/perangkat | Agent lokal mengirim raw email scoped | Tersedia |
| Outlook Add-in | User | User memilih email lalu mengunggah melalui taskpane | Tersedia |
| IMAP | Pemilik mailbox | Server membaca folder secara read-only dan menaruh hasil ke staging | Tersedia |
| External source | Manager | Manager menyimpan tautan sumber resmi sesuai kebijakan project | Opsional |
| Tanya AI | User dengan akses project | Jawaban memakai sumber yang diizinkan dalam project | Tersedia bila diaktifkan untuk organisasi |
| OCR | Pengguna | Hasil teks scan tersedia bila organisasi mengaktifkannya | Tergantung instalasi |
| GitLab | — | Tidak ada integrasi dalam rilis ini | Tidak tersedia |
Prinsip pemisahan tugas¶
Orang yang mengunggah revisi sebaiknya tidak menjadi satu-satunya pihak yang menyetujui perubahan penting. Untuk dokumen kritis, gunakan Editor sebagai maker dan Manager berbeda sebagai checker. Gunakan History dan paket evidence untuk membuktikan proses tersebut.