Dokumentasi HubLink QIA System

🔐 Autentikasi & Otorisasi

Sistem keamanan berlapis dengan Role-Based Access Control (RBAC).

• Login dengan verifikasi email
• Registrasi pengguna baru dengan approval admin
• Reset password
• Multi-role system (10+ roles)
• Permission-based access

👤 Manajemen Profil

• Edit profil pengguna
• Upload foto profil
• Perubahan email dengan approval admin
• Ganti password
• Hapus akun

🔍 Global Search

Pencarian cepat di seluruh sistem untuk data yang relevan dengan role pengguna.

• Pencarian quotations, PO, purchase requests
• Pencarian equipment dan inventory
• Pencarian employee dan vendors
• Filter berdasarkan status dan tanggal

💬 Feedback System

Sistem feedback untuk meningkatkan kualitas layanan.

• Submit feedback dari semua pengguna
• Admin dapat melihat dan mengelola feedback
• Status tracking (pending, read, resolved)
• Response system

📜 Changelog

Riwayat pembaruan sistem yang dapat diakses oleh semua pengguna.

👥 User Management

• Approve/Reject User: Approval pengguna baru yang mendaftar
• Assign Roles: Menugaskan role ke pengguna (multi-role supported)
• Remove Roles: Menghapus role dari pengguna
• Email Change Approval: Approve/reject perubahan email pengguna
• Delete Users: Hapus pengguna dari sistem
• View User Details: Melihat detail lengkap pengguna

📋 Available Roles

🔧 Equipment Management

Admin memiliki akses penuh untuk mengelola master data equipment.

• Create, edit, delete equipment
• Import equipment dari CSV/Excel
• Delete all equipment (bulk delete)
• Generate barcode untuk equipment

🏢 Vendor Management

• CRUD operations untuk vendor
• Import/export vendor data
• Bulk delete vendors
• Vendor search dan filter

📄 PDF Template Management

• Edit template PDF untuk quotation
• Customize header, footer, dan layout
• Preview template
• API untuk get template

📱 WhatsApp Integration Settings

• Configure WhatsApp API credentials
• Test WhatsApp connection
• Send test messages

📝 Quotation Management

Sistem pengelolaan penawaran harga yang lengkap dan terintegrasi.

• Input Penawaran: Buat penawaran baru dengan detail lengkap
• Daftar Penawaran: View semua penawaran dengan filter dan search
• Edit Quotation: Update quotation yang sudah ada
• Delete Quotation: Hapus single atau multiple quotations
• Duplicate Quotation: Duplikasi quotation untuk mempercepat input
• Export PDF: Generate PDF quotation dengan template custom
• Upload PO: Upload file PO dari customer
• Search & Filter: Pencarian advanced dengan multiple criteria

📋 Draft System

• Save draft quotation (auto-save)
• Load draft untuk melanjutkan input
• Delete draft
• List all drafts

🗂️ Purchase Order Management

• Daftar PO dari quotations
• Upload PO files (PDF, images)
• Upload PO from SAP
• Delete PO files
• Track PO status

🛒 Purchase Request

Sales dapat membuat purchase request untuk material/equipment yang dibutuhkan.

• Create purchase request
• List purchase requests
• View detail purchase request
• Delete purchase request
• Track approval status

🤖 AI Chatbot Assistant

Asisten AI untuk membantu sales dalam proses input dan pencarian data.

📅 Scheduler & Calendar

• Calendar view untuk jadwal teknisi
• Create, edit, delete events
• Drag & drop scheduling
• Color-coded events
• API untuk events management

👷 Personil Teknisi Management

• CRUD operations untuk personil teknisi
• View detail personil
• Track availability
• API untuk get list personil

🔍 Equipment Check Form

• Form pengecekan alat
• Checklist items
• Status kondisi alat
• Upload foto kondisi
• History pengecekan

🎯 Demo Items Management (Alat Demo)

• List alat demo
• Create demo item dengan accessories
• View detail demo item
• Track demo item location
• Search API untuk borrowing integration

🏗️ Equipment Inventory Management

• Master data equipment (inventaris)
• Create, edit, delete equipment
• Repair status management
• Export inventory to Excel
• Import equipment from CSV/Excel
• Generate dan view barcode
• Barcode scanner integration
• Search by barcode

📦 Equipment Loan Management

Sistem peminjaman equipment dengan tracking lengkap.

• Create loan request
• Loan history dengan filter
• Generate receipt (bukti peminjaman)
• Return equipment form
• Track kondisi saat dikembalikan
• Penalty calculation (jika terlambat)

📦 Equipment Management

• CRUD operations untuk equipment
• Stock tracking
• Equipment details dengan specifications
• Generate barcodes bulk

🏷️ Jenis Barang (Equipment Types)

• CRUD operations untuk jenis barang
• Kategorisasi equipment
• View items by type

📏 Satuan (Units)

• CRUD operations untuk satuan
• Unit management (pcs, set, box, dll)

📥 Barang Masuk (Stock In)

• Record incoming stock
• CRUD operations untuk barang masuk
• View detail transaksi masuk
• Auto update stock quantity
• Supplier information

📤 Barang Keluar (Stock Out)

• Record outgoing stock
• CRUD operations untuk barang keluar
• Barcode scanning untuk stock out
• Auto update stock quantity
• Destination tracking

🏷️ Barcode System

• Generate barcodes untuk equipment
• Scan barcode untuk stock out
• Print barcode labels

📊 SAP Data Entry

• View daftar penawaran untuk SAP entry
• Input penawaran ke sistem SAP
• Update SAP number untuk quotations
• Draft system untuk penawaran

📋 PO Management

• View daftar PO
• Upload PO untuk quotation
• Update PO status
• Delete PO files

🔍 Quotation Details

• View detail quotation
• Access vendor information
• Access equipment information

🤖 AI Chatbot Assistant

Asisten AI untuk membantu dalam proses input SAP.

📝 SPK Management

• View daftar penawaran untuk SPK
• Input SPK (Surat Perintah Kerja)
• Store SPK data
• View quotation details
• View SPK details

🔗 Integration

• Access vendor search API
• Access equipment search API
• Integration dengan quotation system

🛒 Purchase Request Management

• View all purchase requests
• Update status purchase request
• Approve/reject purchase requests
• Track request history

📋 Quotation & PO Access

• View daftar penawaran
• View daftar PO
• Monitor quotation to PO conversion

📊 Dashboard

• Overview purchase requests
• Pending approvals
• Statistics dan analytics

👥 Employee Management

• CRUD operations untuk employees
• Employee profiles dengan foto
• Employee details (position, department, salary, dll)
• Employment history
• View employee by department

📅 Attendance Management

• CRUD operations untuk attendance
• Daily attendance tracking
• Late/early tracking
• Overtime tracking
• Monthly attendance reports

🏖️ Leave Management

• CRUD operations untuk leave requests
• Approve/reject leave requests
• Leave balance tracking
• Leave types (annual, sick, emergency, dll)
• Leave history

📄 Document Management

• CRUD operations untuk employee documents
• Upload dan store documents (KTP, NPWP, dll)
• Document expiry tracking
• Secure document storage

📋 Contract Management

• CRUD operations untuk employee contracts
• Contract expiry alerts
• Contract renewal tracking
• Contract types (permanent, contract, probation)

📊 HR Dashboard

• Employee statistics
• Attendance overview
• Leave requests pending
• Contract expiry alerts

📊 Service Dashboard

• Overview service operations
• Statistics dan analytics

📋 Quotation & PO Access

• View daftar penawaran
• View daftar PO
• Monitor service orders

🔗 Integration

• Access vendor search API
• Access equipment search API

💰 Billing Dashboard

• Overview billing operations
• Outstanding invoices
• Payment tracking
• Statistics dan analytics

📋 Quotation & PO Monitoring

• View daftar penawaran
• View daftar PO
• Track quotation to invoice

💰 Budget Management

• View all budgets
• Create budget plan (by purchasing, admin gudang, HR)
• Update budget
• Approve budget (admin only)
• Activate budget (admin only)
• Close budget (admin only)
• Budget utilization tracking

📊 General Ledger

• View ledger entries (admin & inputer SAP)
• Transaction history
• Account balances
• Filter by date and account

💸 Cash Flow Analysis

• Cash flow reports (admin & admin penagihan)
• Incoming vs outgoing
• Period comparison
• Visual charts dan graphs

📈 Profitability Analysis

• Profit margin calculation (admin & admin penagihan)
• Revenue vs expenses
• Per-project profitability
• Trend analysis

📤 Export Financial Data

• Export to Excel
• Export to PDF
• Custom date range

🧾 Invoice Management

• View all invoices
• View invoice details
• Edit invoice (admin, admin penagihan, sales, purchasing)
• Update invoice status
• Generate PDF invoice

📧 Invoice Delivery

• Send invoice via email (admin, admin penagihan, sales)
• Auto-attach PDF invoice
• Email tracking

💳 Payment Recording

• Record payment (admin, admin penagihan, inputer SAP)
• Partial payment support
• Multiple payment methods
• Confirm payment (admin, admin penagihan)
• Payment history

🔄 Invoice Generation

• Create invoice from PO
• Create invoice from quotation
• Auto-populate invoice items

📊 Invoice Reports

• Aging report (admin, admin penagihan, sales)
• Outstanding invoices
• Paid invoices summary
• Overdue tracking

⚡ Bulk Operations

• Bulk action for invoices (admin, admin penagihan)
• Bulk email sending
• Bulk status update

📊 Inventory Overview

• Real-time stock levels
• Stock value calculation
• Category-wise inventory
• Visual analytics

⚠️ Low Stock Management

• Low stock alerts
• Reorder point tracking
• Critical items list
• Auto-notification system

🔧 Stock Adjustments

• View adjustment history
• Record adjustments (admin, admin gudang, inputer SAP)
• Adjustment reasons (damaged, lost, expired, dll)
• Approval workflow

💰 Valuation Reports

• Inventory valuation (admin, admin gudang, inputer SAP)
• FIFO/LIFO methods
• Cost of goods calculation
• Period comparison

📈 Turnover Analysis

• Inventory turnover report (admin, admin gudang, purchasing)
• Fast vs slow-moving items
• Stock aging analysis
• Optimization suggestions

🔔 Alert Management

• Manage stock alerts (admin, admin gudang)
• Setup custom alerts per item
• Update alert thresholds
• Delete alerts
• Email/push notifications

📤 Export

• Export inventory data
• Custom reports
• Excel dan PDF formats

📝 Material Request Management

Semua pengguna yang terautentikasi dapat membuat dan mengelola material request.

• Create material request dengan multiple items
• View all material requests
• View detail material request
• Edit material request (jika belum diapprove)
• Delete material request
• Auto-generated request ID (YYYYMMDD-XXX)

✅ Approval Workflow

• Approve material request
• Reject material request dengan alasan
• Status tracking (pending, approved, rejected)
• Approval notifications

📄 PDF Generation

• Generate PDF material request
• Include all items dan details
• Professional format
• Download atau print

🤖 AI Chatbot (Sales & SAP)

Chatbot AI khusus untuk membantu Sales dan Inputer SAP.

• Natural language processing
• Contextual conversations
• Data lookup assistance
• Quick answers untuk pertanyaan umum
• Form filling assistance

🧠 AI Chat (Gemini Integration)

AI chat general untuk semua pengguna yang terautentikasi.

• Powered by Google Gemini
• General purpose AI assistant
• Business insights
• Data analysis help
• Documentation assistance

🔔 Real-time Notifications

• Real-time push notifications
• In-app notification center
• Email notifications
• Mark as read functionality
• Mark all as read
• View all notifications

📨 Notification Types

• Quotation created/updated notifications
• PO upload notifications
• Purchase request status updates
• Material request approvals
• Invoice updates
• Payment confirmations
• Leave request approvals
• Stock alerts
• Contract expiry reminders
• System announcements

📱 WhatsApp Integration

• WhatsApp notifications untuk events penting
• Custom WhatsApp templates
• Test WhatsApp connection
• Admin configuration

📊 Role-Based Dashboards

Setiap role memiliki dashboard khusus dengan data yang relevan.

• Admin Dashboard: Overview seluruh sistem
• Sales Dashboard: Quotations, PO, dan sales metrics
• Teknisi Dashboard: Schedule, equipment, dan tasks
• Warehouse Dashboard: Inventory levels, stock movements
• HR Dashboard: Employee stats, attendance, leaves
• Purchasing Dashboard: Purchase requests, vendor data
• Billing Dashboard: Invoices, payments, outstanding
• SAP Dashboard: SAP entries, quotation tracking

📈 Analytics Features

• Interactive charts dan graphs
• Real-time data updates
• Custom date range filters
• Export dashboard data
• Customizable widgets
• KPI tracking

📉 Chart Types

• Line charts untuk trends
• Bar charts untuk comparisons
• Pie charts untuk distributions
• Area charts untuk cumulative data
• Donut charts untuk percentages

🎯 Key Metrics

• Total users, quotations, POs
• Revenue dan profit margins
• Inventory value
• Employee attendance rate
• Outstanding invoices
• Purchase request status
• Equipment utilization

🔗 Internal APIs

• Vendor search API
• Equipment search API
• Quotation detail API
• PDF template API
• Personil teknisi API
• Demo items search API
• Global search API

📡 External Integrations

• WhatsApp API: Untuk notifications
• Google Gemini AI: AI chatbot
• Email Service: Laravel Mail
• Pusher/Reverb: Real-time notifications
• DomPDF: PDF generation
• Maatwebsite Excel: Import/export

📤 Import/Export

• Import equipment dari CSV/Excel
• Import vendors dari CSV/Excel
• Export quotations ke PDF
• Export inventory ke Excel
• Export financial reports
• Export purchase requests

🔐 Authentication & Authorization

• Email verification untuk registrasi
• Secure password hashing (bcrypt)
• Session management
• CSRF protection
• Role-Based Access Control (RBAC)
• Permission-based actions
• Middleware protection

🛡️ Data Protection

• Database encryption
• Secure file storage
• API rate limiting
• XSS protection
• SQL injection prevention
• Input validation dan sanitization

📝 Audit Trail

• User activity logging
• Change tracking
• Creation/update timestamps
• User attribution untuk semua actions

🔒 User Approval System

• Admin approval untuk new users
• Email change approval
• Multi-level approval workflows
• Rejection dengan alasan

❓ Bagaimana cara mendaftar sebagai user baru?

Klik tombol "Sign Up" di halaman utama, isi form registrasi, verifikasi email Anda, kemudian tunggu approval dari admin. Setelah diapprove dan mendapat role, Anda dapat login dan mengakses sistem.

❓ Apa perbedaan antara role-role yang ada?

Setiap role memiliki akses dan fungsi yang berbeda. Admin memiliki akses penuh, Sales untuk penawaran dan penjualan, Teknisi untuk equipment dan scheduling, Admin Gudang untuk inventory, dll. Lihat detail masing-masing modul di atas.

❓ Bagaimana cara menggunakan barcode scanner?

Akses menu Equipment Scanner (untuk Teknisi) atau gunakan fitur scan barcode di Stock Out (untuk Admin Gudang). Izinkan akses kamera, arahkan ke barcode, dan sistem akan otomatis mendeteksi dan menampilkan data equipment.

❓ Apakah sistem mendukung multi-role?

Ya, satu user dapat memiliki multiple roles. Admin dapat assign beberapa role ke satu user sesuai kebutuhan.

❓ Bagaimana cara export data?

Hampir semua modul memiliki fitur export. Cari tombol "Export" atau "Download" di halaman yang ingin Anda export. Data dapat diexport ke format Excel atau PDF tergantung fitur yang tersedia.

❓ Apakah notifikasi real-time?

Ya, sistem menggunakan Laravel Reverb/Pusher untuk real-time notifications. Anda akan menerima notifikasi instant ketika ada update yang relevan dengan role Anda.

❓ Bagaimana cara menggunakan AI Chatbot?

Untuk Sales dan Inputer SAP, klik icon chatbot di interface. Untuk AI Chat umum (Gemini), akses melalui menu AI Chat. Ketik pertanyaan atau request Anda dan AI akan membantu.

❓ Bagaimana cara melaporkan bug atau memberikan feedback?

Gunakan fitur Feedback yang tersedia di dashboard Anda. Submit feedback dengan detail masalah atau saran, dan admin akan meninjau serta merespons.