> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quinnsambal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

<style>
  {`
    [class*="max-w-none"][class*="table"] {
      display: block !important;
      overflow-x: auto !important;
      max-width: 100% !important;
      width: 100% !important;
      flex-grow: 0 !important;
    }
    [class*="max-w-none"][class*="table"] > table {
      width: 100% !important;
      max-width: 100% !important;
      table-layout: fixed !important;
    }
    .mermaid {
      max-width: 100% !important;
      overflow-x: auto !important;
    }
    article svg[role="img"] {
      max-width: 100% !important;
      height: auto !important;
    }
    article img, .prose img {
      max-width: 100% !important;
      height: auto !important;
    }
    img[src*="LOGO"], img[src*="logo"] {
      max-width: 120px !important;
      max-height: 40px !important;
      width: auto !important;
      height: auto !important;
      object-fit: contain !important;
    }
    `}
</style>

***

title: "Quick Start"
description: "Panduan cepat memulai Quinn of Spicy ERP - Setup, login, navigasi, dan first steps"
-------------------------------------------------------------------------------------------------

# Quick Start

Panduan lengkap untuk memulai menggunakan **Quinn of Spicy ERP** dalam 15 menit. Dari setup awal hingga transaksi pertama Anda.

## Prasyarat

Sebelum memulai, pastikan Anda memiliki:

* ✅ **Browser modern**: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
* ✅ **Koneksi internet**: Minimal 1 Mbps (untuk offline mode, bisa lebih rendah)
* ✅ **Akun email**: Untuk registrasi dan login
* ✅ **Perusahaan terdaftar**: Atau buat baru saat onboarding

## Step 1: Akses Aplikasi

### Opsi A: Web Browser (Recommended)

Buka browser dan kunjungi:

```
https://app.quinnsambal.com
```

### Opsi B: Install sebagai PWA

**Android (Chrome)**:

1. Buka `https://app.quinnsambal.com` di Chrome
2. Tap menu (⋮) → "Install app" atau "Add to Home screen"
3. Confirm installation
4. App akan muncul di home screen

**iOS (Safari)**:

1. Buka `https://app.quinnsambal.com` di Safari
2. Tap Share button (️)
3. Scroll dan tap "Add to Home Screen"
4. Name your app → Tap "Add"

**Desktop (Chrome/Edge)**:

1. Buka `https://app.quinnsambal.com`
2. Look for install icon di address bar (⊕)
3. Click "Install"
4. App akan terbuka di window terpisah

**Benefits of PWA**:

* 🚀 Faster loading (cached assets)
* 📱 Full-screen experience
* 🔔 Push notifications
* Offline capability
* 💾 Works like native app

## Step 2: Registrasi Akun

### Untuk Perusahaan Baru

1. **Buka halaman registrasi**:
   ```
   https://app.quinnsambal.com/signup
   ```

2. **Isi form registrasi**:
   * Nama lengkap
   * Email perusahaan
   * Password (min. 8 karakter, uppercase, lowercase, number)
   * Nama perusahaan
   * Jenis bisnis (F\&B, Retail, Manufacturing, etc.)
   * Nomor telepon

3. **Verifikasi email**:
   * Check inbox email Anda
   * Click verification link
   * Email akan diverifikasi dalam 24 jam

4. **Complete onboarding**:
   * Isi profil perusahaan
   * Upload logo (optional)
   * Pilih paket subscription
   * Invite team members (optional)

### Untuk Undangan Tim

Jika Anda diinvite oleh admin perusahaan:

1. **Check email** untuk invitation link
2. **Click link** dalam email
3. **Create account** atau login dengan akun existing
4. **Accept invitation** untuk join perusahaan

## Step 3: Login

### Metode Login

**Email & Password**:

1. Buka `https://app.quinnsambal.com/signin`
2. Masukkan email dan password
3. Click "Sign In"
4. Complete 2FA jika diaktifkan

**Google OAuth**:

1. Click "Sign in with Google"
2. Pilih akun Google
3. Authorize aplikasi
4. Auto-redirect ke dashboard

**Phone Number** (Coming Soon):

1. Masukkan nomor telepon
2. Receive OTP via SMS/WhatsApp
3. Enter OTP code
4. Login successful

### First Login Experience

Setelah login pertama, Anda akan melihat:

1. **Welcome Modal**: Introduction ke sistem
2. **Onboarding Tour**: Interactive guide (optional skip)
3. **Dashboard**: Executive overview bisnis Anda
4. **Setup Checklist**: Langkah-langkah setup penting

## Step 4: Setup Awal

### Checklist Setup Perusahaan

Sebelum mulai transaksi, complete setup berikut:

#### ✅ 1. Company Profile

* [ ] Upload company logo
* [ ] Set business type (F\&B, Retail, etc.)
* [ ] Configure currency (IDR default)
* [ ] Set timezone (WIB/WITA/WIT)
* [ ] Add company address
* [ ] Add contact information

**Navigate**: Settings → Company Settings

#### ✅ 2. User & Roles

* [ ] Invite team members via email
* [ ] Assign roles (Owner, Manager, Cashier, etc.)
* [ ] Configure permissions per role
* [ ] Set up approval workflows

**Navigate**: Settings → Team Management

#### ✅ 3. Products & Categories

* [ ] Create product categories
* [ ] Add products dengan detail lengkap
* [ ] Set pricing (cost, price, margin)
* [ ] Upload product images
* [ ] Configure stock levels
* [ ] Set low stock alerts

**Navigate**: Inventory → Products

#### ✅ 4. POS Configuration

* [ ] Configure payment methods
* [ ] Set up receipt template
* [ ] Connect Bluetooth printer (optional)
* [ ] Configure tax settings
* [ ] Set discount rules
* [ ] Configure order channels

**Navigate**: POS → Settings

#### ✅ 5. Bank Accounts

* [ ] Add company bank accounts
* [ ] Configure payment gateways
* [ ] Set up auto-reconciliation rules

**Navigate**: Finance → Bank Accounts

#### ✅ 6. Warehouse Locations

* [ ] Define warehouse/store locations
* [ ] Set up stock transfer rules
* [ ] Configure location-based permissions

**Navigate**: Inventory → Locations

## Step 5: Navigasi Sistem

### Main Navigation

Sistem menggunakan **sidebar navigation** dengan struktur:

```
📊 Dashboard & Core
   ├── Dashboard (Executive view)
   ├── Home (Personal view)
   ├── Workspace
   ├── Settings
   └── Company Settings

🛒 POS & Kasir
   ├── POS Overview
   ├── Kasir (Cashier interface)
   ├── Company POS
   ├── Orders
   ├── Order Queue
   ├── Members
   ├── Reports
   └── Payments

📦 Inventori
   ├── Overview
   ├── Stock Management
   ├── Products
   ├── Stock Opname
   ├── Multi-Location
   ├── Barcode
   └── Suppliers

🏭 Manufaktur
   ├── Overview
   ├── Production Orders
   ├── Bill of Materials
   ├── Quality Control
   └── HACCP

 Keuangan
   ├── Overview
   ├── Invoices
   ├── Expenses
   ├── Bank Accounts
   ├── General Ledger
   ├── Reports
   └── Budget

👥 SDM & Kehadiran
   ├── Overview
   ├── Attendance
   ├── Payroll
   ├── Performance
   └── Recruitment

🤝 CRM & Pelanggan
   ├── Overview
   ├── Customers
   ├── Membership
   ── Sales Pipeline

🤖 AI & Analitik
   ├── AI Assistant
   ├── AI Agents
   ├── Forecasting
   └── Content Studio
```

### Quick Navigation Tips

**Keyboard Shortcuts**:

* `Ctrl+K` or `Cmd+K`: Open command palette
* `Ctrl+/`: Toggle sidebar
* `Esc`: Close modals/drawers
* `Tab`: Navigate between fields

**Search**:

* Use search bar di top navigation
* Search products, customers, invoices, etc.
* Filter by date, status, category

**Bookmarks**:

* Star frequently used pages
* Access from sidebar "Favorites" section

## Step 6: Transaksi Pertama

### Contoh: Transaksi POS

Mari buat transaksi POS pertama Anda:

#### 1. Buka Kasir Interface

```
Navigate: POS & Kasir → Kasir
URL: /companyposcashier
```

#### 2. Pilih Channel

* Dine-in
* Takeaway
* Delivery
* GoFood/GrabFood/ShopeeFood

#### 3. Tambah Produk

* **Scan barcode**: Use barcode scanner
* **Search**: Type product name/SKU
* **Browse**: Tap category → select product
* **Quick add**: Tap product card

#### 4. Configure Order

* Adjust quantity
* Add notes/special requests
* Apply discount (if applicable)
* Select customer (for loyalty points)

#### 5. Process Payment

* Tap "Checkout" button
* Select payment method:
  * Cash
  * QRIS
  * Debit/Credit Card
  * E-wallet (GoPay, OVO, Dana, etc.)
  * Bank Transfer
* Enter amount received (for cash)
* Confirm payment

#### 6. Print Receipt

* Receipt auto-generate
* Print via Bluetooth printer
* Or send via WhatsApp/email
* Customer receives digital receipt

#### 7. View Transaction

* Transaction saved automatically
* View in Orders list
* Track in Reports
* Update inventory automatically

### Contoh: Stock Opname

#### 1. Navigate to Stock Opname

```
Navigate: Inventori → Stock Opname
URL: /stock-opname
```

#### 2. Create New Opname

* Tap "Create Opname" button
* Select location/warehouse
* Select products to count
* Set count date
* Assign counter staff

#### 3. Count Products

* Scan barcode atau select product
* Enter actual quantity
* System shows expected quantity
* Note discrepancies
* Add notes if needed

#### 4. Submit for Approval

* Review all counts
* Tap "Submit"
* Manager receives notification
* Manager approves/rejects

#### 5. Adjust Stock

* If approved, stock auto-adjust
* Discrepancy logged in audit trail
* Inventory updated in real-time

## Step 7: Laporan & Analytics

### Dashboard Metrics

Setelah beberapa transaksi, dashboard akan menampilkan:

**Sales Metrics**:

* Total penjualan hari ini
* Penjualan minggu ini vs minggu lalu
* Penjualan bulan ini vs bulan lalu
* Top selling products
* Sales by channel

**Inventory Metrics**:

* Total products
* Low stock alerts
* Stock value
* Recent stock movements

**Financial Metrics**:

* Revenue today/week/month
* Expenses breakdown
* Profit margin
* Cash flow status

**Customer Metrics**:

* Total customers
* New customers this month
* Membership signups
* Customer retention rate

### Generate Reports

**Sales Report**:

```
Navigate: POS → Reports
Filter: Date range, channel, product
Export: PDF, Excel, CSV
```

**Inventory Report**:

```
Navigate: Inventori → Reports
Filter: Location, category, date
Export: PDF, Excel
```

**Financial Report**:

```
Navigate: Keuangan → Reports
Types: P&L, Balance Sheet, Cash Flow
Period: Daily, Weekly, Monthly, Yearly
Export: PDF, Excel
```

## Step 8: AI Features

### AI Assistant

Tanya AI tentang bisnis Anda:

**Contoh Pertanyaan**:

* "Berapa penjualan hari ini?"
* "Produk apa yang paling laku minggu ini?"
* "Stok apa yang mau habis?"
* "Bandingkan penjualan bulan ini vs bulan lalu"
* "Forecast penjualan minggu depan"

**Cara Pakai**:

1. Click AI Assistant icon (bottom-right)
2. Type pertanyaan dalam bahasa natural
3. AI akan analyze data dan jawab
4. Follow-up questions welcome

### AI Agents

Setup AI agents untuk automasi:

**Contoh Agents**:

* **Daily Sales Reporter**: Kirim laporan penjualan setiap sore
* **Low Stock Alert**: Notifikasi ketika stok mau habis
* **Customer Follow-up**: Follow-up customer setelah 7 hari
* **Invoice Reminder**: Reminder invoice yang belum dibayar

**Setup**:

1. Navigate: AI & Analitik → AI Agents
2. Click "Create Agent"
3. Define trigger & action
4. Set schedule (if applicable)
5. Activate agent

## Tips & Best Practices

### Daily Workflow

**Pagi Hari**:

1. Check dashboard untuk overview
2. Review low stock alerts
3. Check pending orders
4. Review today's schedule

**Siang Hari**:
5\. Process transactions (POS)
6\. Monitor order queue
7\. Handle customer inquiries
8\. Update inventory if needed

**Sore Hari**:
9\. Review daily sales report
10\. Check financial summary
11\. Plan for tomorrow
12\. Generate end-of-day report

### Data Entry Best Practices

**Products**:

* ✅ Use consistent naming convention
* ✅ Add high-quality images
* ✅ Fill all fields completely
* ✅ Set accurate cost & price
* ✅ Configure low stock threshold

**Transactions**:

* ✅ Always select correct channel
* ✅ Add customer for loyalty tracking
* ✅ Include notes for special orders
* ✅ Verify payment before confirm
* ✅ Print/send receipt immediately

**Inventory**:

* ✅ Do stock opname regularly (weekly/monthly)
* ✅ Record all stock movements
* ✅ Investigate discrepancies
* ✅ Update locations after transfer
* ✅ Review slow-moving products

### Security Best Practices

**Passwords**:

* ✅ Use strong, unique passwords
* ✅ Enable 2FA if available
* ✅ Change password every 90 days
* Never share credentials

**Access Control**:

* ✅ Assign minimal required permissions
* ✅ Review user access quarterly
* ✅ Deactivate ex-employee accounts immediately
* ✅ Use role-based access

**Data Backup**:

* ✅ System auto-backup daily
* ✅ Export critical reports monthly
* ✅ Keep local copies of financial data
* ✅ Test restore procedure annually

## Troubleshooting

### Common Issues

**Cannot Login**:

* Check email & password
* Clear browser cache
* Try different browser
* Reset password if needed
* Contact support if locked out

**Slow Performance**:

* Check internet connection
* Clear browser cache
* Close unused tabs
* Try PWA instead of browser
* Contact support if persistent

**POS Not Working**:

* Check internet connection
* Verify products have stock
* Check payment gateway status
* Restart browser/app
* Contact support for errors

**Inventory Discrepancy**:

* Review stock movement history
* Check for unrecorded transactions
* Verify stock opname data
* Investigate potential theft/loss
* Adjust with proper approval

### Getting Help

**Documentation**:

* 📚 Full docs: [https://quinnofspicy.mintlify.site](https://quinnofspicy.mintlify.site)
* 🔍 Search docs for specific topics
* 📖 Module-specific guides available

**Support Channels**:

* 📧 Email: [support@quinnsambal.com](mailto:support@quinnsambal.com)
* 📱 WhatsApp: +62 812-3456-7890
* 💬 In-app chat (bottom-right)
* Submit ticket via dashboard

**Response Times**:

* Critical issues: \< 1 hour
* High priority: \< 4 hours
* Normal: \< 24 hours
* Low priority: \< 48 hours

## Next Steps

Setelah complete quick start:

1. **Explore Modules**: Jelajahi setiap modul secara detail
2. **Invite Team**: Tambahkan team members
3. **Configure Workflows**: Setup approval workflows
4. **Setup Integrations**: Connect payment, WhatsApp, etc.
5. **Train Staff**: Training untuk semua users
6. **Go Live**: Mulai gunakan untuk operasional
7. **Monitor & Optimize**: Review reports & improve

## Video Tutorials

Coming soon:

* [ ] Setup perusahaan (5 min)
* [ ] First POS transaction (3 min)
* [ ] Stock management (7 min)
* [ ] Financial reports (10 min)
* [ ] AI features overview (8 min)

## Checklist Complete

* [x] Akses aplikasi (web/PWA)
* [x] Registrasi akun
* [x] Login ke sistem
* [x] Setup company profile
* [x] Configure users & roles
* [x] Add products
* [x] Setup POS
* [x] First transaction
* [x] View reports
* [x] Explore AI features

**Selamat! Anda siap menggunakan Quinn of Spicy ERP.**

***

**Butuh Bantuan Lebih Lanjut?**

* 📚 Baca dokumentasi lengkap per modul
* 🎥 Tonton video tutorials (coming soon)
* 💬 Chat dengan support team
* 📧 Email: [support@quinnsambal.com](mailto:support@quinnsambal.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.