Dokumen, Markdown, dan Pemulihan Konversi¶
StaraTrace menyimpan file source sebagai bukti utama. Hasil Markdown adalah teks bantu untuk pencarian, diff, dan konteks AI. Kegagalan membaca file tidak menghapus source.
Yang terjadi setelah upload¶
- Sistem memvalidasi project, jenis file, dan duplikasi.
- Source file disimpan bersama metadata versi atau evidence.
- Isi dokumen dibaca untuk menghasilkan Markdown.
- Hasil dipakai untuk diff, pencarian, dan Tanya AI bila tersedia.
Status yang dilihat pengguna¶
| Status | Arti | Tindakan pengguna |
|---|---|---|
| Pending / Menunggu | Dokumen masih menunggu diproses | Tunggu beberapa saat; laporkan bila tidak bergerak. |
| Processing / Sedang dibaca | Sistem sedang membaca source | Jangan upload ulang file yang sama. |
| OK / Siap | Markdown aktif tersedia | Buka diff atau unduh Markdown bila diperlukan. |
| Failed / Gagal | Source tersimpan, tetapi hasil belum dapat dibuat | Baca pesan error, perbaiki penyebab, lalu retry. |
| Perlu password | Source terenkripsi atau tidak dapat dibuka | Isi password di UI yang aman atau minta Manager. |
| Perlu review | Hasil/saran tidak cukup pasti | Verifikasi source sebelum melanjutkan. |
Jika proses tidak selesai, status akan menjadi gagal agar dapat diulang. Hasil yang sebelumnya tersedia tetap dipertahankan sampai hasil baru berhasil.
Cara menangani kegagalan¶
- Pastikan file source dapat dibuka dan bukan hasil download yang rusak.
- Periksa apakah file Office terenkripsi. Masukkan password hanya melalui field password yang disediakan; jangan kirim password melalui note atau email.
- Periksa bahwa format file didukung sebagai dokumen versioned atau standalone.
- Pilih Retry Conversion pada versi terkait setelah penyebab diperbaiki.
- Untuk banyak item, buka daftar kegagalan ekstraksi, filter menurut project dan status, pilih item yang setara, lalu gunakan Retry Selected.
- Jika tetap gagal, simpan source sebagai bukti dan gunakan Allow failed conversion hanya setelah review karena diff/pencarian isi belum tersedia.
Bulk retry membuat job per item dan mencatat audit trail. Sebagian item dapat berhasil sementara item lain gagal; periksa hasil setiap batch.
Unduh source dan Markdown¶
Download Source dipakai ketika Anda perlu file asli dengan format, layout, atau formula lengkap. Download Markdown dipakai untuk meninjau teks hasil ekstraksi, membantu review diff, atau memperbaiki masalah pencarian. Markdown bukan pengganti file source dan tidak boleh dianggap sebagai salinan visual yang identik, terutama untuk tabel kompleks, PDF scan, dan presentasi.
Keterbatasan yang perlu diketahui¶
- File scan/gambar memerlukan OCR yang diaktifkan administrator agar teks dapat dibaca.
- Tabel, formula spreadsheet, layout PDF, dan slide presentasi dapat kehilangan struktur saat menjadi Markdown. Selalu buka source untuk verifikasi keputusan penting.
- Format yang dapat diunggah tidak selalu dapat dijadikan versioned document atau menghasilkan diff. File dapat tetap disimpan sebagai standalone evidence.
- Tidak ada koneksi GitLab dalam rilis ini.