menu_book Dokumentasi Sistem Flowta

v2.0.26

Dokumentasi Sistem Flowta

Panduan lengkap aplikasi manajemen produksi digital — mulai dari konsep Kanban Board, Quality Control, hingga analitik dan pelaporan. Dokumen ini ditujukan untuk Manajemen, Supervisor, Staf, dan Developer.

infoTentang Sistem routeAlur Produksi widgetsModul

tocDaftar Isi

chevron_right1. Deskripsi Sistem chevron_right2. Arsitektur & Teknologi chevron_right3. Alur Produksi Utama chevron_right4. Detail Modul Sistem chevron_right5. Peran & Hak Akses chevron_right6. Sistem Token & Billing chevron_right7. Skema Data (localStorage) chevron_right8. FAQ

1Deskripsi Sistem

Flowta adalah sistem manajemen produksi digital yang dirancang untuk membantu tim internal mengelola alur kerja produksi secara terstruktur, transparan, dan efisien. Sistem ini menggunakan konsep Kanban Board untuk memvisualisasikan setiap tahapan produksi.

visibility

Transparansi

Semua tahap produksi terlihat real-time oleh seluruh tim.

verified

Quality Control

Inspeksi 3 tahap: Pra Produksi, Produksi, dan Hasil Akhir.

link

Tracker Publik

Konsumen memantau status produk via link unik tanpa login.

2Arsitektur & Teknologi

Frontend Stack

check_circleTailwind CSS — Utility-first styling (via CDN)
check_circleVanilla JavaScript — Logika tanpa framework
check_circleMaterial Symbols — Ikon konsisten
check_circleChart.js — Visualisasi grafik QC
check_circleSortableJS — Drag & drop fase/kanban
check_circleSheetJS (XLSX) — Export laporan ke Excel

Penyimpanan Data

Seluruh data tersimpan di localStorage browser dengan isolasi per departemen. Script auth.js menghook getItem/setItem agar setiap departemen hanya melihat datanya sendiri.

Otentikasi

3Alur Produksi Utama

Diagram berikut menggambarkan siklus hidup sebuah SPK (Surat Perintah Kerja) dari awal hingga akhir.

schemaDiagram Alur SPK

add_taskBuat SPK
kanban.html

arrow_forward

view_kanbanKanban Board
Drag & Drop

arrow_forward

fact_checkQuality Control
3 Tahap QC

arrow_forward

task_altSelesai
Produksi Tuntas

arrow_forward

linkTracker
Link Konsumen

arrow_forward

reviewsReview
Umpan Balik

Input SPK Baru

Dari halaman Kanban, klik tombol + SPK Baru. Isi nama klien, uraian pekerjaan, jenis project, dan target selesai (tanggal & jam). Token akan dipotong sesuai tarif.

Proses Produksi

Kartu SPK muncul di kolom fase pertama. Drag & drop kartu ke fase berikutnya seiring progres pekerjaan. Setiap perpindahan tercatat di log histori beserta timestamp dan user.

QC & Penyelesaian

Lakukan inspeksi QC 3 tahap (Pra Produksi, Produksi, Hasil Akhir) di halaman detail produk. Setelah lulus QC, tandai SPK sebagai SELESAI. Kirim link tracker ke konsumen.

4Detail Modul Sistem

grid_view

Dasbor

index.html

Buka →

Ringkasan KPI produksi: Total SPK aktif, selesai, terlambat. Daftar order prioritas kritis (15 teratas), dan feed aktivitas produksi (20 log terbaru). Menyediakan pencarian global untuk mencari SPK di seluruh sistem.

view_kanban

Kanban Board

kanban.html

Modul Inti

Papan kerja visual berbasis kolom fase. Fitur utama: Buat SPK Baru (modal form lengkap), Drag & Drop kartu antar fase (menggunakan SortableJS), indikator warna deadline (hijau/kuning/merah). Klik kartu untuk masuk ke halaman Detail Produk.

inventory_2

Detail Produk / Produk

product-detail.html / products.html

product-detail.html: Halaman lengkap per SPK — informasi klien, uraian, edit produk, input QC (3 tahap), log komentar, histori aktivitas, tombol selesai/batal, cetak label, dan Link Tracker untuk konsumen. products.html: Tabel ringkasan seluruh SPK dengan filter periode dan status, serta opsi export Excel/PDF.

fact_check

Quality Control

qc.html

Dashboard analitik QC. Donut chart distribusi status (Sudah QC / Sebagian / Belum), bar chart kelengkapan per tahap, progress ring per stage, dan tabel detail per SPK. Filter berdasarkan periode (Hari Ini, Minggu Ini, Bulan Ini, Semua, atau Range Kustom).

3 Tahap Inspeksi QC:

1. Pra Produksi 2. Produksi 3. Hasil Akhir

schema

Manajemen Fase

phase.html

Pemilik Saja

Kelola kolom-kolom Kanban (fase produksi). Tambah, edit, hapus, dan drag-and-drop untuk mengubah urutan fase. Setiap fase memiliki ikon, warna, dan deskripsi. Perubahan urutan langsung mempengaruhi tampilan papan Kanban.

link

Tracker Konsumen

tracker.html

Publik

Halaman publik tanpa login. Konsumen mengakses via link unik (mengandung ID SPK), lalu melihat detail pesanan, riwayat aktivitas produksi, dan hasil QC. Link dibuat dari halaman Detail Produk.

reviews

Review Konsumen

reviews.html

Laporan umpan balik konsumen. Menampilkan rating bintang, komentar, dan statistik kepuasan. Data review disimpan di flowta_reviews.

history

Histori Aktivitas

Log semua aktivitas: create, move, complete, cancel, QC, comment. Filter periode & tipe. Export CSV. Timeline visual.

history.html

engineering

User Productivity

Heatmap aktivitas, distribusi peran, tabel performa per user dengan skor produktivitas (weighted: complete=40, move=30, qc=20, create=10).

productivity.html

summarize

Laporan Produksi

Calendar heatmap kepadatan produksi + tabel SPK dikelompokkan per fase & kategori (Administrasi, Produksi, QC, Customer). Export Excel via SheetJS.

laporan-produksi.html

settings_applications

Manajemen Sistem

4 tab: Departemen (CRUD), Pengguna (CRUD + filter role), Data SPK (view + hapus + export CSV), Token & Tarif (saldo, top-up, riwayat, atur tarif).

sistem.html

5Peran & Hak Akses

Peran	Akses Utama	Batasan
Pemilik Sistem	Semua modul, semua departemen, fase, pengguna, token	Tidak ada batasan
Supervisor	Kanban, QC, Produk, Histori, Laporan, Detail	Tidak bisa akses Fase, departemen terkunci
Staf	Kanban (drag), Detail Produk (view), Histori	Tidak bisa QC, batal SPK, akses Fase

6Sistem Token & Billing

Setiap aksi penting dalam sistem memerlukan token departemen. Jika token habis, user non-Pemilik akan dilogout otomatis. Pemilik Sistem dapat melakukan top-up melalui halaman Sistem → Token & Tarif.

Drag Kanban

Simpan SPK

Edit Produk

Simpan QC

Selesai SPK

Pencarian

Download

7Skema Data (localStorage)

Key	Tipe	Deskripsi
flowta_kanban_cards	Array	Semua kartu SPK (id, title, type, phaseId, status, dueDate, dll)
flowta_phases	Array	Daftar fase/kolom kanban (id, title, icon, colorClass, order)
flowta_history	Array	Log aktivitas (create, move, complete, cancel, qc, comment)
flowta_qc	Array	Record QC per SPK (cardId, type, timestamp, user, notes, result)
flowta_reviews	Array	Ulasan/rating konsumen per SPK
flowta_users	Array	Akun pengguna (id, name, username, password, role, deptId)
flowta_departments	Array	Departemen (id, name, token, phone, wa, email, dll)
flowta_token_history	Array	Riwayat penggunaan/topup token
flowta_token_rates	Object	Tarif token per aktivitas (key-value)
flowta_currentUser	String	ID user yang sedang login
flowta_active_dept	String	ID departemen aktif (untuk Pemilik Sistem)

8Pertanyaan Umum (FAQ)

Bagaimana cara membuat SPK baru? expand_more

Buka halaman Kanban, klik tombol + SPK Baru di pojok kanan atas. Isi semua field: nama klien, uraian pekerjaan, jenis project, dan target selesai. Klik Simpan. Kartu SPK akan muncul di kolom fase pertama.

Bagaimana cara membatalkan atau menghapus SPK? expand_more

Klik kartu SPK di Kanban untuk masuk ke halaman Detail Produk. Di bagian bawah halaman, ada tombol Batalkan SPK. SPK yang dibatalkan tetap tersimpan di histori namun tidak muncul di papan aktif. Penghapusan permanen hanya bisa dilakukan Pemilik Sistem melalui halaman Sistem → Data SPK.

Apakah data aman jika browser ditutup? expand_more

Ya. Flowta menggunakan localStorage yang menyimpan data secara persisten di browser. Data tetap ada meski browser ditutup. Namun, data akan hilang jika cache browser dihapus. Disarankan untuk rutin melakukan export data via fitur Export CSV/Excel.

Bagaimana cara mengirim link tracker ke konsumen? expand_more

Di halaman Detail Produk, klik tombol Link Tracker. Link unik akan otomatis tersalin ke clipboard. Kirimkan link tersebut ke konsumen via WhatsApp atau email. Konsumen dapat melihat progress tanpa login.

Apa yang terjadi jika token departemen habis? expand_more

User Supervisor dan Staf akan otomatis logout dengan peringatan. Pemilik Sistem harus melakukan top-up token melalui halaman Sistem → Token & Tarif. Saldo default departemen baru adalah 999 token.

Bagaimana cara mengubah urutan fase produksi? expand_more

Hanya Pemilik Sistem yang bisa mengakses halaman Fase. Di sana, drag & drop kartu fase untuk mengubah urutan. Perubahan langsung tercermin di tampilan Kanban Board.

Sistem Flowta — Dokumentasi Resmi v2.0.26