Quick Start - luckydeva03/barbershop_app GitHub Wiki

πŸš€ Quick Start Guide

Panduan cepat untuk mulai menggunakan sistem manajemen barbershop setelah instalasi.

πŸ“‹ Prerequisites

Pastikan Anda telah menyelesaikan Installation Guide terlebih dahulu.

⚑ 5-Minute Quick Start

1. Start Development Server

cd barbershop_app
php artisan serve

Akses aplikasi di: http://localhost:8000

2. Login sebagai Admin

3. Explore Admin Dashboard

Setelah login admin, Anda dapat:

  • βœ… Lihat dashboard analitik
  • βœ… Kelola data customer
  • βœ… Buat kode redeem
  • βœ… Monitor activity logs

4. Test Customer Portal

5. Test Key Features

  • βœ… Redeem kode point
  • βœ… Lihat history transaksi
  • βœ… Browse store listings
  • βœ… Submit review

🎯 First Steps Checklist

Admin Setup

  • Change Default Password: Ganti password admin default
  • Add Store Data: Tambahkan data toko/barbershop
  • Create Redeem Codes: Buat beberapa kode redeem untuk testing
  • Configure Settings: Sesuaikan konfigurasi aplikasi

Customer Experience

  • Test Registration: Coba daftar customer baru
  • Test Point System: Redeem kode untuk dapat poin
  • Browse Stores: Lihat daftar barbershop
  • Submit Review: Berikan review pada toko

Integration Testing

  • Google OAuth: Test login dengan Google (jika dikonfigurasi)
  • WhatsApp: Test booking via WhatsApp (jika dikonfigurasi)
  • Maps Integration: Cek Google Maps pada store detail

πŸ“± Key Features Overview

πŸ” Authentication System

Admin Portal    β†’ /admin ([email protected])
Customer Portal β†’ /login ([email protected])
Google OAuth    β†’ /auth/google
Logout          β†’ /logout

πŸ’Ž Point System Workflow

  1. Admin membuat kode redeem
  2. Customer memasukkan kode
  3. System menambah poin ke akun customer
  4. Customer dapat melihat history poin

πŸͺ Store Management

  1. Admin mengelola data store via kode/seeder
  2. Customer browse store di halaman publik
  3. Google Maps integration untuk lokasi
  4. WhatsApp integration untuk booking

⭐ Review System

  1. Customer memberikan rating 1-5 bintang
  2. Customer menulis komentar review
  3. Review tampil di halaman store detail
  4. Admin dapat monitor semua review

🎨 User Interface Tour

Admin Dashboard (/admin)

  • πŸ“Š Analytics Cards: Total users, codes, points
  • πŸ“ˆ Charts: Visual data representation
  • πŸ“‹ Quick Actions: Shortcut ke fitur utama
  • πŸ”” Notifications: System alerts & updates

Customer Portal (/dashboard)

  • πŸ‘€ Profile Section: Info personal & foto
  • πŸ’Ž Points Display: Current points balance
  • πŸ“± Redeem Interface: Input kode redeem
  • πŸ“Š History Table: Transaksi poin history

Public Store Page (/stores)

  • πŸ—ΊοΈ Interactive Map: Google Maps dengan marker
  • πŸ“‹ Store List: Grid layout dengan info detail
  • ⭐ Ratings: Average rating dengan bintang
  • πŸ“± WhatsApp Button: Direct booking link

πŸ”§ Configuration Quick Setup

1. Database Seeding

# Tambah sample data
php artisan db:seed --class=StoreSeeder
php artisan db:seed --class=UserSeeder
php artisan db:seed --class=AdminSeeder

2. Create Sample Redeem Codes

# Via Tinker
php artisan tinker

# Buat kode redeem
App\Models\ReedemCode::create([
    'code' => 'WELCOME50',
    'points' => 50,
    'description' => 'Welcome bonus untuk member baru',
    'expires_at' => now()->addDays(30),
    'max_uses' => 100,
    'is_active' => true
]);

3. Add Store Data

# Via Tinker
App\Models\Store::create([
    'name' => 'Barbershop Central',
    'description' => 'Premium barbershop di pusat kota',
    'address' => 'Jl. Sudirman No. 123, Jakarta',
    'phone' => '021-1234567',
    'latitude' => -6.2088,
    'longitude' => 106.8456
]);

πŸ“Š Testing Different Scenarios

Customer Journey Testing

  1. New Registration

    /register β†’ Fill form β†’ Email verification β†’ Login

  2. Point Earning

    /dashboard β†’ Input WELCOME50 β†’ +50 points β†’ View history

  3. Store Discovery

    /stores β†’ Browse list β†’ View detail β†’ See reviews β†’ WhatsApp booking

  4. Review Submission

    Store detail β†’ Write review β†’ Submit β†’ View in review list

Admin Workflow Testing

  1. User Management

    /admin β†’ Users β†’ View list β†’ User detail β†’ Activity log

  2. Code Management

    /admin β†’ Codes β†’ Create new β†’ Set expiry β†’ Activate

  3. Analytics Review

    /admin β†’ Dashboard β†’ View metrics β†’ Export reports

🎯 Common First-Time Use Cases

Scenario 1: Beauty Salon Owner

Goal: Setup sistem untuk salon dengan 3 lokasi
Steps:
1. Login admin β†’ Add 3 stores
2. Create welcome codes untuk new customer
3. Share registration link ke existing customer
4. Monitor analytics untuk growth

Scenario 2: Barbershop Chain

Goal: Loyalty program untuk multiple outlet
Steps:
1. Configure store data untuk semua outlet
2. Setup redeem codes dengan tier benefits
3. Enable Google Maps untuk store locator
4. Setup WhatsApp booking untuk each outlet

Scenario 3: Independent Barber

Goal: Simple customer management
Steps:
1. Add single store info
2. Create basic redeem codes
3. Encourage customer registration
4. Use review system untuk testimonial

πŸš€ Next Steps

Setelah quick start, lanjutkan dengan:

  1. Configuration: Setup detail untuk production
  2. Admin Dashboard Guide: Panduan lengkap admin
  3. Customer Portal Guide: Panduan customer
  4. Google OAuth Setup: Konfigurasi Google login
  5. WhatsApp Integration: Setup WhatsApp booking

πŸ“ž Need Help?

Selamat! Anda siap menggunakan Barbershop Management System! πŸŽ‰